Digital PDFs

EK-9000C-CD-001

May 1990

379 pages

Original

8.9MB

view download

OCR Version

10MB

view download

Document:	VAX 9000 Family Console Command Description
Order Number:	EK-9000C-CD
Revision:	001
Pages:	379
Original Filename:

OCR Text

VAX 9000 Family
Console Command Description
Order Number

EK-9000C-CD-001

digital equipment corporation
maynard, massachusetts

First Edition, May 1990
The information in this document is subject to change without notice and should not
be construed as a commitment by Digital Equipment Corporation. Digital Equipment
Corporation assumes no responsibility for any errors that may appear in this document.
The software described in this document is furnished under a license and may be used or
copied only in accordance with the terms of such license.
No responsibility is assumed for the use or reliability of software on equipment that is not
supplied by Digital Equipment Corporation or its affiliated companies.

Restricted Rights: Use, duplication, or disclosure by the U. S. Government is subject to
restrictions as set forth in subparagraph (c¢) (1) (ii) of the Rights in Technical Data and
Computer Software clause at DFARS 252.227-7013.
Copyright ©

Digital Equipment Corporation

1990

The postpaid Reader’s Comment Card included in this document requests the user’s
critical evaluation to assist in preparing future documentation.

FCC NOTICE: The equipment described in this manual generates, uses, and may emit
radio frequency energy. The equipment has been type tested and found to comply with
the limits for a Class A computing device pursuant to Subpart J of Part 15 of FCC
Rules, which are designed to provide reasonable protection against such radio frequency
interference when operated in a commercial environment. Operation of this equipment in
a residential area may cause interference, in which case the user at his own expense may
be required to take measures to correct the interference.
The following are trademarks of Digital Equipment Corporation:

BI
CI
DEC
DECmate
DECUS
DECwriter

KLESI
LA
MASSBUS
MicroVAX
NI
PDP

RSTS
RSX
RT
RV20
RV64
TA

VAX
FORTRAN
VAX MACRO
VAXBI
VAXCcluster
VAXELN

DHB32

P/OS

VMS

DIBOL
DRB32
EDT

Professional
RA
Rainbow

ULTRIX
UNIBUS
VAX

VT
Work
Processor

KDB50
KDM

VAX C

XMI

clilgliltall|

This document was prepared and published by Educational Services Development and
Publishing, Digital Equipment Corporation.

Contents
About This Manual
1

Console Command Language

Command Syntax...............cciiiiiiirinennnn.n.

1.1.1

Command Qualifiers

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

1-1
1-3

1.1.1.1

QualifierEntry. .. ....... .. ... .. ..

1-3

1.1.1.2

Qualifier Values . . .........
... ...
...

1.1.1.3

CPUand SCUQualifier.........................

1.1.14

Confirmation Qualifier . . ... .....................

1-5

1.1.15

/ALL Qualifiers

.............. ...,

1-5

In-LineHelp..........
.
..

1-5

Special Keys..........c.iiiiiiiiiiiiiiiiinn.

1-7

Predefined Keys .. ........ ... ... ...

1-7

1.3.1
132

UserDefinedKeys ............. ...

1-8

MessageFormat..............
... ... .. .. .. .. . ...

1-8

1.5

TheRadixof Numbers..............................

1-9

1.6

ExXpressions .............uiuiiiiitnnennnenneeennens

1-10

161

Typesofexpressions................couuiivunnene...

1-10

1.6.2

Data Types....... ..ot

1-12

Console Command Descriptions
ALLOCATE........ e

2-2

=(Assign String) . ....... ...
e

2-3

=(Assign Symbol) . ....... ...

2-5

... e,

@ (Execute Procedure). ..............
... . ... .. .. ...

2-7

BOOT ...
e

2-9

CALL .. e
e

2-11

Contents

CLOSE .. ..
e et
e
e

2-12

CONTINUE

i it

2-14

COPY .
e e e e

2-16

CREATE . ...

2-18

..... ...

.. e
e

CREATE/DIRECTORY ............
... .
...

2-20

CREATE/WINDOW . . ... ... ...ttt

2-21

DEALLOCATE ..... ...

... i

2-24

i it

2-25

DEASSIGN . ...

DEBUG. . ...
e
i

2-27

DEFINE . ... ...

2-28

DEFINE/KEY . ...ttt

2-30

DELETE . ... ...

i i

2-32

DELETE/PATTERN ....... ... ... ..

2-34

DELETE/SYMBOL . ........ ...

i iiiiiinnn.

2-36

. ... ... .. . . i

2-38

DELETE/TRACE

DELETE/WATCH ........ ...

... ...

240

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

242

DEPOSIT . ..... ... i

243

DELETE/WINDOW

DIRECTORY....... ...,

2-53

DISMOUNT .. ...

i it

2-56

o e

2-57

EDIT. ...

EVALUATE . ...

EXAMINE.

...

i ittt

2-60

2-62

EXIT ..o

. ...

2-73

FIND

...
e
i

2-74

GOTO ...
e
e

2-76

HALT ...
e
e

2-77

HELP ...

2-78

2-80

INITIALIZE . ...... ... ..t

2-81

INQUIRE .. ... ...

2-85

LABEL .. ...

2-87

LOAD . ..o
e e e e e

2-88

LOGOUT

2-91

T
I

...

2-92

Contents

i e iiiiiieaenan

2-95

2-96

e e e e
e
ON o
e e e
i
i
..
OPEN ...

2-98

MOUNT ...
NEXT ...

PURGE . ........c

it
ittt

i e

2-99

i it 2-100

i i 2-102
READ .........t
i it e i e 2-104
i
i
REBOOT . ...
it i aaaaan 2-105
i
i
...
.
RECALL
RENAME . ... .

ittt i e 2-107

i e 2-109
REPEAT ... ...
e 2-110
i i
i
RESET ...
RESTORE ... ...ttt 2-111
i it 2-112
RETURN. ...

s e e 2-113
i i .
RUN ..
e 2-115
e
SAVE . .
i it 2-116
SCROLL . ......ci it
SELECT . ......0i ittt iiiiiienanianaenan 2-118
e 2-120
e
SEND ............. e
e e 2-121
SENSE .. ...
ittt 2-122
SENSE CLOCK . .........

SENSE CPU ........ ittt 2-123
it iiiiiiiiiiaaannan 2-124
SENSE IO. .......ci
SENSEPOWER ........ .. 2-125
it iiie e 2-126
i i
SENSE SCU . ... .o
SENSE SYSTEM . ........c0itiiiiiiiiiiiiaiannennn 2-127
] 7 PP 2-128
SET ATTN_ACTION . . .. ..ottt 2-129
i, 2-130
SET AUTOBOOT ........cciiiiiiiiiiiiii
SETBIDEVICES ........ .0t iiiiiiiiiinnnnn.. 2-131
SET BOOTFLAGS .........ttt 2-132

i 2-133
SETBOOTSET . .......c0iiiiiiiiiiiiiiiii
ittt it 2-135
SETCLOCK . .....0i
SETCOLD_START . ....... ...t 2-139

it 2-140
.
it
SETCOMMAND. .. ..
t 2-141
ittt iiiiieaneeen
SET CPU ... .. itt
SETCYCLE ....... ...ttt ittt 2-142

Contents

SETDEFAULT . ..........

i, 2-144

SET ERROR_HANDLING .......................... 2-145

SET FAULT ACTION . ............c
SET ISOLATION .............

i, 2-146
i, 2-147

SETKEEP_ALIVE ... ... ... .. .. 2-148

SETLABELS . ........ ... it 2-149
SETLOGGING....... ..., 2-150
SETMESSAGE

........ ... .. . . ... 2-152

SET PATTERN ........ ...

...

. ... 2-154

SET PERSONAL_NAME ............ e 2-157
SETPOWER. ...... .. .

i 2-158

SETPROMPT........
. ...
i, 2-161

SETRADIX ...... ... .
SETREMOTE

i, 2-162

..........
... . ..., 2-163

SET REVISION ........ ...t 2-164
SET SCI . ...
i
e 2-165

SET SCM .. ...

SETSCOPE ....... ... .

e 2-169
i 2-171

SETSCREEN . ....... ... .0 i, 2-172
SETSERIAL. ........ ...
SET SNAPSHOT

i, 2-173

..........
...
... 2-175

SETSOURCE ... ... ...ttt

i 2-177

SETSTEP. ...... .00
i i i 2-178
SETTERMINAL. .. ...
SETTIME

...

.. ...

SETTRACE . ....... .

i i, 2-179

i it 2-182
i i 2-183

SET VERIFY . ... ... .. e, 2-187

SET WARM_START ..........
... ... 2-188
SETWATCH . ...... ...

i i 2-189

SETXMIDEVICES ....... ... ... i, 2-192
SHOW . ...
e et i e i i i e 2-193

SHOW ATTN_ACTION .. ...

... it 2-194

SHOW AUTOBOOT ..........
... ... 2-195
SHOW AVAILABLE ............
... .. ..., 2-196
SHOWBATCH ..... ... ... i, 2-197
SHOW BBU ....... ... ittt 2-198

Contents ‘vii

SHOW BLDEVICES

.. ..ottt 2-199

SHOW BOOTFLAGS - .«

eoeoe ettt 2-200

SHOW BOOTSET . . . o oo oeee e e 2-201

SHOW CLOCK . . . ettt 2202

SHOW CONFIGURATION . ... .oooeneeeeaneann. 2-203
SHOW CPU . ..t ote
SHOW CYCLE - . e

e e 2-207

v vttt e

e e, 2209

SHOW DEFAULT .. ...oooveennnn.. P 2210
SHOW DEVICE . .ottt 2-211

SHOW ENVIRONMENT

... .ooreneee

., 2-213

SHOW ERROR_HANDLING .. .....oouvinennannnnn., 2-214
SHOW FAULT ACTION . . .o oottt 2215

SHOW FLAGS - . o vt ottt

e e 2216

SHOW HISTORY ... vvee et 2217

SHOW ISOLATION . ..ot

e 2-219

SHOW KEEP_ALIVE . .. ..ottt 2-220
SHOW KEY . . .o oe oot et e

SHOW LOGGING . .«

e e 2221

e oot et 2-223

SHOW LOGICAL .. ..o oee

e e 2-224

SHOW MEMORY . .. .. eee

et et 2225

SHOW MESSAGE . . ..o veeee el 2-226
12001 Y (0)
)

2227

SHOW NODE . .. oottt
e e 2-228
SHOW PATTERN . .. oottt 2-229
SHOW PERSONAL

. ... .vooeeeee

el 2-231

SHOW POWER . . . . oot et 2-232
SHOW PROCESS . . . . oottt

et 2-235

15001 7N
)b
QI 2-236

SHOW REMOTE .. ..ottt

et 2-237

SHOW SCI . . o oot

e e e 2238

SHOW SCM . . oot

e e e 2-239

SHOW SCOPE . . . e

ee et et 2243

SHOW SCU . . oo ettt

e e

e e 2244

SHOW STA . . o eeeee et

e e, 2-245

SHOW SOURCE . . . . o oottt 2-246

SHOW STEP. ....... .. e 2-247

viii

Contents

SHOW STRUCTURE ........ .. ... ...

.. ... 2-248

SHOWSWITCHES . .......
... ...
.....
... 2-250
SHOWSYMBOL. ....... ... ..., 2-251
SHOWSYSTEM . ......... ..., 2-252

SHOW TERMINAL. ........ ... .. 2-253
SHOWTHRESHOLD ............. ..., 2-255

SHOWTIME

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

... .. 2-256

SHOWTRACE ....... .. ...

. .. 2-257

SHOWUSERS ......... ... 2-258

SHOW VERSION ....... ... ..., 2-259
SHOWWATCH ... ......... .

.. 2-261

SHOW WINDOW . ... ... ... .. 2-262
SHOWXMI DEVICES ......
... ...
.... 2-263
SHOWZONE ....... ... ittt 2-264

START . ...

2-265

STOP ..
e
.
e
e 2-267
SUBMIT . ...

i e 2-268

TALK .. ...
e
e 2-269
TYPE ... .

2-270

UNJAM. ...

e 2-272

VERIFY ... .

WAIT

2-273

..
e
e 2-275

WRITE . ... i
e
2-276
/2 2-277

ASCII . ..

3-2

BITVECTOR . . ... ... i
i

3-3

CLOCK . ..

e et e

3-5

CONFIG . . ...

CPU ..

3-6

3-8

3-9

FILL . .o
e
e e

3-10

INFORMATION . ...... ..ttt

3-11

EXTRACT .. ...
FIELD. . ...

i
i

Contents

LENGTH

...... ... i,

3-14

LOCATE . .. ...ttt
eee

3-15

LOGICAL . . ...

3-16

MCU . .
e
e
e

3-17

MEMORY . ... e
e

3-18

PARSE .. ...

. e
e

3-19

. ... e

3-21

PART

POWER

. ... . e
e

3-22

RADIX ...
e e

3-23

REVISION . ... . e

3-24

3-25

SCU e

3-26

SEARCH. . ...

3-27

SERIAL

. i
e i e

3-28

. ...

S 1

3-29

SIGNAL . ...
e

3-30

STRING .. ...
e

3-31

SWITCH . .. ..
e e i
i

3-32

TIME

.. e
e

3-33

UPC .
e
e
e

3-34

VERIFY ... .

3-35

Command Quick Reference

Lexical Function Quick Reference

Index

Contents

Examples
1-1

Console Command Format...........................

1-1

1-2

COPY Command Format ............................

1-2

1-3

SET Command Format .............................

1-3

In-LineHelp..........
..
...

1-6

1-5

Message Format...............
... ... ... .. ... . .....

1-9

1-6

ExpressionUsage..............cciuiiiiinnnennnn..

1-11

Tables
1-1

CPU Qualifier Arguments ...........................

1-2

Confirmation Responses . . . ..........................

1-5

1-3

Predefined Keys ............ ...

1-7

1-4

User-DefinedKeys .............
...
...,

1-8

2-1

Window Location Keywords ..........................

2-22

2-2

MCM Register Mnemonics . . ...........covvvivennn...

2-45

2-3

PEM Register Mnemonics .................ccuuuvuunn.

2-45

2—-4

PEM Address Space Qualifiers. .......................

246

2-5

RIC Register Mnemonics ................ccvuunn....

247

2-6

RIC Address Space Qualifiers

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

247

2-7

SCC Register Mnemonics . . ................couuuvu...

247

2-8

SJA Register Mnemonics . . ...........ououeeeennnnn.

248

2-9

DEPOSIT Special Operators .........................

2-50

2-10

GPR and PSL Register Mnemonics ....................

2-50

2-11

IPR Register Mnemonics ...............ccouveunn...

2-51

2-12

EXAMINE Special Operators. ........................

2-70

2-13

System Power Buses ............... ..., 2-158

2-14

System I/OBuses............. ... 2-159

2-15

System Cabinets

2-16

Structure Names ..................

2-17

Operator Control Panel Switches . .. ... ................ 2-250

..................
. ...
i, 2-159
.. 2-248

About This Manual
This manual describes the commands implemented by the VAX 9000
family service processor unit (SPU), commonly called the console, in
console I/O (CIO) mode. Most of the information in this manual is also
available on-line (in CIO mode) from the service processor operating
system HELP library, through the console HELP command.

Intended Audience
This manual is written for system operators, Digital Customer Services
personnel, and other console interface users. This manual assumes the
reader is familiar with the VAX 9000 family architecture and the Digital
command language (DCL).

Manual Structure
This manual has three chapters, two appendixes, and an index.

Chapter 1 provides generic information about the console command
language.

Chapter 2 describes the console commands.

Chapter 3 describes the lexical functions.

Appendix A is an alphabetical quick reference list of console

Appendix B is an alphabetical quick reference list of lexical functions.

commands.

xii

About This Manual

Manual Conventions
This manual uses the following conventions:

Convention

Meaning

COMMAND argument

In command description format sections,
command verbs are uppercase; usersupplied arguments (qualifiers, object

argl
COMMAND arg2

arg3

parameters, and so on) are lowercase.

Stacked arguments indicate several
different argument formats. Only one
argument is to be entered.

COMMAND [argument]

Brackets ([]) enclose optional arguments.

COMMAND [arg[, ... 1]

The , . .. (comma,ellipsis) indicates a list
of similar arguments.

COMMAND [argll, . .. argn]]

Indicates a limited list, form 1 through n,
of similar arguments.

COMMAND {argl | arg2}
COMMAND [argl | arg2]

The vertical bar ( | ) separates argument
choices; only one choice is to be entered.
Braces ({}) enclose a required argument;
brackets ([]) enclose an optional

LEXICAL (argument)

Lexical function arguments, when used,
are enclosed in parentheses (()).

LEXICAL [(argument)]

The lexical function argument is optional.

argument.

LEXICAL ([argument])

One of several lexical function arguments
is required.

Default.

[mm:nn]

Indicates the field or set, mm through nn.
Replaces <mm:nn>.

1
Console Command Language
The console, or SPU, command language merges the standard VAX
console command language with basic file-system commands to access
the entire SPU operating system from one level. Unlike previous
VAX systems, the VAX 9000 family console command language is not
implemented as a program running under another operating system.
The console command language resembles the Digital command language
(DCL) in its use of lexical functions, command files, symbols, and logical
names. While this provides a high degree of familiarity for the majority of
VAX 9000 family users, it should be noted that the two languages are not
identical.

1.1

Command Syntax

Example 1-1 shows the general format for console commands.
>>> VERB

[/qualifiers]

o
Example 1-1

object

[parameters]

Console Command Format

©® The verb is the command name and indicates the command action.

® Qualifiers modify the command action and always begin with a slash

(/). Qualifiers are usually optional, as indicated by enclosing them in
brackets ([1).

required parameter unless a default object parameter is defined for
the command.
Optional parameters (enclosed in brackets) provide additional
command modifiers.
Most commands are not executed until Return is pressed. (Examples
of command usage do not show the
key symbol.)

1—2

Console Command Language

As Examples 1-2 and 1-3 show, the general command format is usually
modified to fit specific command requirements.
Example 1-2 shows the COPY command format and a typical COPY
command.

>>>

COPY

[/qualifiers]

COPY

/NOCONFIRM

Example 1-2

input-file-spec

INPUT.DAT

output-file-spec

OUTPUT.DAT

COPY Command Format

©® COPY is the command verb.
@® /NOCONFIRM is an optional qualifier specifying that the file is copied
as soon as the command is entered; that is, without confirmation
(Section 1.1.1.4).

® OUTPUT.DAT is the second of two required object parameters, and

specifies the duplicate file. There are no optional parameters for this
command.

Example 1-3 shows the SET command format and a typical SET
command. Note that in SET and SHOW commands, the qualifier follows
the object parameter.

Console Command Language

>>>

SET

object

[/qualifiers]

SET

BOOTSET

/PRIMARY=1

Example 1-3

1-3

[parameters]

0,1,2

SET Command Format

@® SET is the command verb.
(2 BOOTSET is the object parameter.

(2 The 0, 1, and 2 are required and optional parameters that specify the
boot set includes CPUO, CPU1, and CPU2.

1.1.1

Command Qualifiers

Sections 1.1.1.1 through 1.1.1.4 describe several qualifier attributes that
apply to many of the console commands.
1.1.1.1 Qualifier Entry
Command qualifiers are always prefixed with a slash (/), as follows:
COMMAND /qualifier

Most commands allow qualifiers to be entered in any sequence following
the command verb and before or after the object and optional parameters.
Note that the following command/qualifier sequences are fixed but can be
followed by additional parameters:

CREATE/DIRECTORY
CREATE/WINDOW
DEFINE/KEY
DELETE/PATTERN
DELETE/SYMBOL
DELETE/TRACE
DELETE/WATCH
DELETE/WINDOW
Additionally, some commands (such as LOAD, SHOW STRUCTURE,
TEST, and VERIFY) have two sets of qualifiers.
The format section of each command description (Chapter 2) indicates the
position of qualifiers and other required and optional command elements.

1—4

Console Command Language

1.1.1.2 Qualifier Values

Many qualifiers have optional, required, and/or default values. A qualifier
value is specified by following the qualifier with a colon (:) or equals (=)
character and then the value (Example 1-3). Depending on the command
and/or qualifier, the value can be a quoted string, keyword, or numeric
value.

1.1.1.3 CPU and SCU Qualifier

Many commands accept a /CPU=cpu-id qualifier to specify a CPU or
CPUs other than the current default. The argument, cpu-id, can be an
integer value or one of the symbolic names listed in Table 1-1. Generally,

if the qualifier is not used (that is, a CPU is not specified), the default
CPU is selected. (To specify a CPU as the default, see the SET CPU
command description in Chapter 2.)
Table 1-1

CPU Qualifier Arguments

Argument

Description

0,1,2,0r3
ALL

An integer value. Some commands accept a list; for example:

/CPU=(0,1).

All CPUs. In some commands /CPU=ALL is similar to

/CPU=(0,1,2,3) except that ALL does not detect an error if a
CPU does not exist.

AVAILABLE

All CPUs in the available set. CPUs in the available set are
permanently allocated to the operating system and cannot
be modified by the operator while the operating system is

executing. The available set is copied from the boot set when
the system is booted.

BOOTPRIMARY

The CPU that will be the primary CPU when the system is

BOOTSET

All CPUs in the boot set. The boot set is all CPUs that have

PRIMARY

The first CPU to boot in an SMP environment. The primary

next bootstrapped.

passed self-test and are enabled. The boot set CPUs are
made available to the operating system to execute in the
symmetrical multiprocessing (SMP) environment.

CPU controls the booting of the other CPUs in the boot set.

Many of the same commands that accept the CPU qualifier also accept
the SCU qualifier. Generally, these commands treat the SCU qualifier as
if it were another argument to the CPU qualifier. That is, the command
has the same affect on the SCU that it has on the specified CPU.

Console Command Language

1-5

1.1.1.4 Confirmation Qualifier

Many commands accept the /CONFIRM qualifier to specify selectively
whether a command is to be executed. For example, this qualifier is
frequently used in file operations where defaults or wildcard characters
are used to specify the same operation for more than one file. Specifying
confirmation causes the command to display a prompt requesting an
affirmative response for each file to be processed.
The valid responses to the confirmation prompt are listed in Table 1-2.
Table 1-2

Confirmation Responses

Response

Result

Y (yes)

Execute the command.

T (true)

Execute the command.

N (no)

Do not execute the command.

F (false)

Do not execute the command.

Q (quit)

Abort command processing.

Responses can be upper or lowercase. The first character of the response
is checked for Y, T, or Q. Any response other than Y, T, N, F, or Q is
interpreted as N or F.

1.1.1.5 /ALL Qualifiers

In most cases, commands that offer an /ALL qualifier also offer one or
more specific object parameters. The two are mutually exclusive; that is,
the /ALL qualifier and a specific object parameter cannot be specified in
the same command line.

1.2

In-Line Help

In addition to the HELP command, the SPU software provides multilevel
in-line help for console commands. As Example 1-4 shows, typing a
question mark (?) at some point in the console command line invokes the
in-line help facility for that level.

1—6

Console Command Language

>>> ? ‘. Command, one of the following:
ALLOCATE

BOOT

CONTINUE

COPY

CREATE

DEALLOCATE

DEASSIGN

DEBUG

DEFINE

DELETE

DEPOSIT

DIRECTORY

DISMOUNT

EDIT

EVALUATE

EXAMINE

EXIT

FIND

HALT

HELP

INITIALIZE

INQUIRE

LOAD

LOGOUT

MAIL

MICROSTEP

MOUNT

OPEN

PURGE

READ

REBOOT

RECALL

RENAME

REPEAT

RESET

RESTORE

RUN

SAVE

SCROLL

SELECT

SEND

SENSE

SET

SHOW

START

STOP

SUBMIT

TALK

TEST

TYPE

UNJAM

VERIFY

WAIT

WRITE

or External

command,

ERF

Symbol

or Command

one of the

DUMP

following:

DIFFERENCES

name

file

identifier,

"@"

>>> SET ? @ Parameter, one of the following:
ATTN ACTION

AUTOBOOT

BI DEVICES

BOOTFLAGS

BOOTSET

CLOCK

COLD_START

COMMAND

CPU

CYCLE

DEFAULT

ERROR HANDLING

FAULT

KEEP_ALIVE

LABELS

LOGGING

MESSAGE

PATTERN

PERSONAL NAME

ACTION

ISOLATION

POWER

PROMPT

RADIX

REMOTE

REVISION

SCOPE

SCM

SCI

SCREEN

SERIAL

SJA

SOURCE

SPU_UPDATE

SNAPSHOT

STEP

TERMINAL

TIME

TRACE

VERIFY

WARM START

WATCH

XMI

DEVICES

XMI UPDATE

>>> SET TERMINAL ? @ Terminal qualifier, one of the following:
/ [(NO]BROADCAST

/CPU:

/DEVICE:

/ [NO]ECHO

/ [NOJEIGHTBIT

/ [NOJESCAPE

/KEYPAD:

/PAGE:

/ [NO]JPROGRAM /PIO PORT:

/[NO]TALK_MODE

/WIDTH:

or Terminal name,
or

confirm with

carriage

return

>>> set terminal /keypad:? o Option, one of the following:
APPLICATION

Example 14

NUMERIC

In-Line Help

Typing a question markin response to the console prompt displays a
list of console commands.
Typing a question mark after a SET command displays a list of SET
command parameters or options.
Typing a question mark after a SET command parameter dlsplays a
list of command qualifiers.
Typing a question mark after a SET command parameter qualifier
displays a list of qualifier options.

Console Command Language

1.3

1-7

Special Keys

The console command language interprets LK201 keyboard keys for
command recall, command editing, and special functions.

1.3.1

Predefined Keys

Table 1-3 lists the keys defined by the console software.

Table 1-3

Predefined Keys

Keys

Action

Ctrl/A

Switch between insert and overstrike edit mode.

Ctrl/B

Display previous command in recall buffer. Same as Up
Arrow.

Ctrl/C

Cancel command processing. Same as Ctrl/Y.

Ctrl/D

Move cursor one character to the left. Same as Left Arrow.

CtrI/E

Move cursor to end of line.

Ctrl/F

Move cursor one character to the right. Same as Right
Arrow.

CtrI/H

Move cursor to beginning of line.

Ctrl/Q

Resume screen output.

Ctrli/S

Hold screen output.

Ctr/U

Delete line.

Ctrl/W

Redraw the screen.

Ctrl/’Y

Cancel command processing. Same as Ctrl/C.

Ctrl/Z

End of file.

Same as Return key.

Help

Invokes HELP utility.

Invokes in-line help. See Section 1.2.

Down Arrow

Display next command in recall buffer.

Left Arrow

Move cursor one character to the left. Same as Ctrl/D.

Right Arrow

Move cursor one character to the right. Same as Ctrl/F.

Up Arrow

Display previous command in recall buffer. Same as Ctrl/B.

1-8

Console Command Language

1.3.2 User-Defined Keys
In addition to the predefined keys, the user can define function keys,
editing keypad keys (except arrows), and numeric keypad keys. To
implement user-defined keypad keys, set the keypad mode to application.
Table 14 lists the keys that the user can define. See the DEFINE/KEY
and SET TERMINAIL/KEYPAD command descriptions in Chapter 2 for
more information.
Table 14

User-Defined Keys

Key Name

Key'

Editing Keypad
El

Find

Insert Here

Remove

E4
E5
E6

Select
Prev Screen
Next Screen

Function Keys
F6-F14
Do

F6-F14
F15

F17-F20

Help

F16

Numeric Keypad
PF1-PF4

KP0-KP9
PERIOD

COMMA
MINUS
ENTER

PF1-PF4

0-9
.

,
Enter

1To implement user-defined keypad keys, set the keypad mode to application.

1.4

Message Format

The console command language uses the DCL format for messages. All
messages begin with a percent character (%) in column 1. If the message
continues to more than one line, the continuation line(s) begin with
a minus character (-) in column 1. Example 1-5 shows the message
format.

Console Command Language

$Facility-Severity-Ident,
-Facility-Severity-Ident,

Example 1-5

(3]

1-9

Text
Text

Message Format

@ Facility is a 3-character identification code for the SPU operatingsystem subsystem that produced the message. For example, CLI is
the code for the command language interpreter.

@® Severity is a 1-character code for the message severity, as follows:
S = Success
I = Informational

E = Error
F = Fatal error

® Ident is a variable-length, message-unique field. It is usually an
acronym for the message.

® Text is a brief error description and possible remedy.

1.5

The Radix of Numbers

The console command language uses numbers for VAX data, loop counts,

file versions, frequencies, and so on. Normally, the radix is hexadecimal
for all VAX data and numbers related to VAX data; and the radix is
decimal for all file-related numbers, test numbers, bit numbers, and so on.
The user can specify the radix for all VAX data and numbers related to
VAX data. All numbers that are not hexadecimal and do not have a fixed
radix are displayed with a radix identifier prefixed to the number. For
example:

Decimal numbers are displayed as %D123.
Octal numbers are displayed as %0173.
Binary numbers are displayed as %B1111011.

More specifically, the following data types are decimal values:
Loop count (except /NEXT) and cycle count
Data size
Bit number
Time value

Voltage, current, and frequency values
Test number

File system numbers (generation number, count, keep count)

1-10

Console Command Language

The following data types are represented in the user-specified radix:
All VAX data and addresses
EVALUATE expressions
CPUID
RIC ID
XMI node and BI node IDs
All numbers input, except file generation numbers, accept the following
radix specifiers:

%D (decimal)
%B (binary)

%0 (octal)

%X (hexadecimal)

For example:
>>>

DEPOSIT

%D10

deposits 10;¢ in VAX register RO.
NOTE
Decimal quantities are limited to a value that can be stored in
32 bits. In other words, if the radix is specified as %D, the value
cannot exceed 2147483647 (signed) or 4294967295 (unsigned).

1.6

Expressions

The parameters of many commands are defined as an expression. This
section describes the kinds of expressions and expression operators,
including lexical functions.

1.6.1
¢

Types of expressions

Numeric expressions

Numeric expressions can have any elements that evaluate to a
numeric result.

String expressions

String expressions can have any elements that yield a string result.
*

Mixed expressions

Mixed expressions can have either numeric expressions, string
expressions, or both.

Console Command Language

1-11

Lexical functions

The command language interpreter (CLI) also provides lexical
functions that give string or numeric results (for example, the
contents of a register) based on a predetermined operation. Lexical
functions are used primarily in command files to allow symbol
assignment to CPU data. For a description of the lexical functions,
see Chapter 3.
¢

Arithmetic operators

The supported arithmetic expression operators are:
+

Relational operators

The following relational integer operators yield 0 or 1 to reflect false
and true expressions:

EQ.

NE.

.GE.

.LE.

.GT

The following relational string operators yield 0 or 1 to reflect false
and true expressions:

.EQS.
¢

.NES.

.GES.

.LES.

.GTS.

.LTS.

Boolean operators

Boolean operators .AND. and .OR. are provided for data manipulation.
They are not relational operators; their precedence is higher than
relational operators. The unary operator .NOT. is also provided.

Example 1-6 gives several examples of how expressions are used.
DEPOSIT RO

EXAMINE/NEXT:10
EVALUATE
SAVE

START

$X100

@
+

($X45

= RO

@PC

REPEAT IF SIGNAL ("UPC")
IF P1_.EQS. ""

Example 16

THEN

.NE.

INQUIRE

%$X1B00
P1

Expression Usage

THEN MICROSTEP/NOSPACEBAR 1

" What"

1-12

Console Command Language

1.6.2

Data Types

The console command language supports three basic data types: integer,
bitvector, and string. Some commands automatically convert between
data types, for example:
>>>

WRITE

STDOUT

XYz

converts XYZ to a string data type before it is output.

Integer data type
An integer data type is limited to 32 bits in length and is a signed
value. The range of the value is from —2147483648 to 2147483647.
Integers can be used in expressions and all operators accept integer
data types.
Integers can be converted to strings by binary to ASCII translation,
and to bitvectors by truncation or zero fill, depending on the bitvector
size.
Bitvector data type

A bitvector is a 1- to 2048-bit data type. It is used to store large
numbers (scan rings, control store words, and so on). Bitvectors
can be used as an expression but cannot be used as operands of
an expression; that is, the value is accepted and passed, but no
operations are performed on the value. Bitvectors can be manipulated
with lexical functions.
Bitvectors can be converted to strings by binary to ASCII translation,
and to integers by truncation or zero fill, depending on the bitvector
size.

String data type
A string is a 0- to 255-character ASCII string. Strings can be used in
expressions and can be mixed with integers.

Strings can be converted to bitvectors or integers by ASCII to binary
translation.

2
Console Command Descriptions
The command descriptions in this chapter are nearly identical to the
descriptions in the service processor operating system HELP library. In
most cases, the two are distinguished only by minor formatting differences
to accommodate the different media.

2—2

Console Commands
ALLOCATE

ALLOCATE
Locks the specified unit so that only this process can use the unit. This
allows a single process to ensure that no other operations are performed
on the specified unit.

Format
ALLOCATE

object

Parameters
object
Specifies one of the following:
¢

CPU[id] — Allocate the specified CPU; if a CPU is not specified, the
default CPU is allocated. See Section 1.1.1.3 for more information on
specifying a CPU. See the SET CPU command description for more
information on specifying the default CPU.

MCM — Allocate the clock subsystem.

PCS — Allocate the power subsystem.

SCU — Allocate the system control unit, memory, and 1/0.

Example
>>>

ALLOCATE

MCM

Allocates the clock subsystem to the current process.

Console Commands

2-3

:= (Assign String)

:= (Assign String)
Assigns a symbolic name to a character string.
Format

symbol-name :=[=] string
Parameters
symbol-name

The symbol name can contain between 1 and 255 characters. It must

begin with an alphabetic character, underscore (_), or dollar sign ($).

The remaining characters can be any alphanumeric character from the
Digital multinational character set, underscores, or dollar signs.

A single equal sign (:=) in the statement places the symbol in the local
symbol table. Double equal signs (:==) place the symbol in the global
symbol table. The global symbol table is available at the interactive
command level and to command procedure files. Command procedures
(see HELP for the @ command) also have unique local symbol tables.
string

The string can be specified as a string literal consisting of any
alphanumeric or special characters, or as a symbol or lexical function
that evaluates to a string literal.
The := string assignment statement automatically converts lowercase
text to uppercase, removes leading and trailing spaces and tabs, and
compresses multiple spaces and tabs to a single space.

String literals need not be enclosed in quotation marks ("). However, to
preserve case and retain multiple spaces and tabs, place quotation marks
around the string. To use quotation marks in a string, enclose the string
in quotation marks and use a double set of quotation marks within the
string. For example:,
>>> TEST
>>>

SHOW

:=
SYMBOL

TEST = "this

"this

is a ""test""

string"

TEST

is a

"test"TM

string"

To define a symbol as a null string, do not specify a string. For example:
>>>

NULL

2—4

Console Commands
= (Assign String)

To request substitution of a symbol or lexical function, place apostrophes
() around the item. For example:
>>>

"Quoted

>>>

'A’

>>>

SHOW

"Quoted

SYMBOL

string"

Examples

>>> TIME := SHOW TIME
>>>

TIME

10-0CT-1988

16:35:44

The string SHOW TIME is assigned to symbol TIME. Because the
symbol is the first word on the command line, the command interpreter
substitutes its string value and executes the command SHOW TIME.
>>>

STAT

>>>

STAT

@DISKS$SHARD: [CONSOLE]STAT.CMD

This example shows how to define a symbol as a foreign command. The
symbol STAT is equated to a string that begins with the at sign (@)
character (execute command procedure) followed by a file specification.
The symbol STAT can now be used as a synonym for the command:
>>>

@DISKS$SHARD: [CONSOLE]STAT.CMD

When STAT is subsequently entered on the command line, the
command interpreter executes the command procedure file.
>>>

>>>

SHOW

A =

"this

>>>

SHOW

"this

SYMBOL

big

space."

'A'
SYMBOL

big

space."

This example shows how to request symbol substitution with the string
assignment statement. The apostrophes in the definition for symbol B
cause the symbol to take on the value assigned to symbol A instead of the
literal string A.

Console Commands

2-5

= (Assign Symbol)

= (Assign Symbol)
Assigns a symbolic name to a character string or integer value.

Format
symbol-name =[=] expression

Parameters
symbol-name
The symbol name can contain between 1 and 255 characters. It must
begin with an alphabetic character, underscore (_), or dollar sign ($).
The remaining characters can be any alphanumeric character from the
Digital multinational character set, underscores, or dollar signs.
A single equal sign (=) in the statement places the symbol in the local
symbol table. Double equal signs (==) place the symbol in the global
symbol table. The global symbol table is available at the interactive
command level and to command procedure files. Command procedures
(see HELP for the @ command) also have unique local symbol tables.
expression
The expression can be a character string, integer value, symbol, lexical
function, or combination of entities.

If the expression evaluates to a string, the symbol is assigned a string
value. If the expression evaluates to an integer, the symbol is assigned an
integer value. If a symbol is specified in an expression, the value of the
symbol is used in evaluating the expression.
To specify a literal character string in an expression, enclose the string in
quotation marks (").

2-6

Console Commands
= (Assign Symbol)

Examples

>>> LIST == "DIRECTORY"
>>>

LIST

DIRECTORY

DIRECTORY
Lists the contents of a directory or provides information about a file or
group of files that match a given file specification.
Format

DIRECTORY

[/qualifiers] [file-spec]

Qualifiers
/DATE

Lists the creation date of each specified file.
/FULL

Lists the following items for each specified file:
File name, type, and version number
Number of blocks used and allocated
Owner’s user identification code (UIC)
Creation and last revision dates
Expiration and backup dates
File organization and attributes
Record format and attributes
File protection

/OWNER

Lists the owner UIC of each specified file.
/PROTECTION

Lists the file protection of each specified file.
/SIZE

Lists the size in blocks of each specified file.
/TOTAL

Displays only the total number of files and, if /SIZE is specified, the total
number of blocks for all files in the directory.

2-54

Console Commands
DIRECTORY

Parameters
file-spec
The file or files to be listed, according to the following syntax:

Syntax

Action

No file-spec

List all versions of all files in the current
directory.

Device only

Use current directory as a default and list all
versions of all files in that directory of the
specified device.

Device and directory

List all versions of all files in the specified
directory of the specified device.

Device, directory, and file
name, or file name only

List all files of that name in the specified or
current directory of the specified or current
device, regardless of file type and version.

Device, directory, and file
type, or file type only

List all files of that type in the specified or
current directory of the specified or, current
device, regardless of file name and version.

Wildcards

The asterisk (*) and percent sign (%) wildcard
characters can be used in certain fields of the file
specification, as follows:

Field

Valid Wildcard

Name

*or %

Type

* or %

Version

* only

Console Commands

2-55

DIRECTORY

Examples
>>>

DIRECTORY

Lists all versions of all files in the default device and directory.
>>>

DIRECTORY

Lists all types and versions of all files beginning with A in the default
device and directory.
>>>

DIRECTORY

DUAQO: [CONSOLE] *.CMD

Lists all versions of all files with the CMD file type field in device DUAO
directory [CONSOLE].

2-56

Console Commands
DISMOUNT

DISMOUNT
Closes a previously mounted disk or tape volume and deassigns the logical
name, if any, associated with the device. All open files on the volume must
be closed before the device can be dismounted.
Format
DISMOUNT

[//NOJUNLOAD] device-namel:]

Qualifier
/UNLOAD
/NOUNLOAD
Specifies whether a tape is unloaded on dismount.

Parameters
device-name|:]
The name of the device to be dismounted. The device name can be a
physical device name or a logical name assigned to the device.

Example
>>>

MOUNT

DU:

>>>

DISMOUNT

TESTVOL

DISK

DISK:

The MOUNT command mounts disk volume TESTVOL on physical device
DUAO and assigns the logical name DISK to the device. The DISMOUNT
command closes access to the volume, deallocates the device, and deletes
the logical name DISK.

Console Commands

2-57

EDIT

EDIT
Invokes the EDT text editor.

Format
EDIT

[1qualifiers] input-file-spec

Qualifiers
/COMMAND[=command-file] (D)
/NOCOMMAND
.
/COMMAND causes the editor to execute a startup command file. If the
qualifier or command-file specification is omitted, the editor executes a
system- or user-defined default startup command file. To use some other
startup command file, use the command-file specification. For example:
>>>

EDIT/COMMAND=[CONSOLE.TOOLS]XEDTINI

TEST.DAT

Wildcard characters are not allowed, and the default startup command
file type is .EDT.

If / NOCOMMAND is specified or a startup command file does not exist,
the editor begins the editing session in its default state.
/CREATE (D)

/NOCREATE
Determines whether the editor creates a new file if the specified input file
does not exist. If
NOCREATE is specified and the file does not exist, the
editor does not create the file and displays an error message.

/JOURNAL[=journal-file]
/NOJOURNAL
Determines whether the editor records the editing session in a journal
file. The default journal file specification is the input file name with
file type .JOU. To specify a different journal file name or type, use the
/JOURNAL-=journal-file option. Wildcard characters are not allowed. The
journal file allows recovery from an abnormally ended editing session (see
/RECOVER).

/NOJOURNAL prevents the editor from recording the editing session.

2-58

Console Commands
EDIT

/OUTPUT[=output-file]
/NOOUTPUT
Determines whether the editor creates an output file at the end of the
editing session. The default output file specification is the same as the
input file specification. Use the /OUTPUT=output-file option to specify a
different output file specification. Wildcard characters are not allowed in
the file specification.

If you specify /NOOUTPUT on the command line but then decide to save
the editing session, issue the the editor line-mode command WRITE to
output the text to an external file before ending the session.
NOTE
Specifying /NOOUTPUT suppresses the creation of an output file
but not the creation of a journal file.

/RECOVER
Specifies that the editor read a journal file at the start of the editing
session.
If an editing session ends abnormally while journaling is in effect, use
the /RECOVER qualifier to start the next session. When /RECOVER is
specified, the editor processes the commands contained in the journal file
to restore the edits made in the previous session. For example:
>>>

EDIT/RECOVER

TEST.DAT

The default journal file name is the input file name and the default file
type is .JOU. If the journal file name is not the same as the input file
name or the file type is not .JOU, include /RECOVER and /JOURNAL on
the command line. For example:
>>>

EDIT/RECOVER/JOURNAL=SAVE.XXX

TEST.DAT

Console Commands

2-59

EDIT

Parameters
input-file-spec
Specifies the file to be created or edited. Wildcard characters are not
allowed. If the file does not exist, and /NOCREATE is not specified, the
editor creates the file. The editor does not provide a default file type when
creating files. If a file type is not specified, the field is left null. The file
must be a disk file on a Files-11 formatted volume.

Examples
fl

>>> EDIT/OUTPUT=NEWFILE.TXT OLDFILE.TXT
1

This

the

first

line

the

file

OLDFILE.TXT.

The EDIT command opens OLDFILE.TXT for editing and writes the
output to file NEWFILE.TXT when the session ends.
E

>>> EDIT/RECOVER OLDFILE.TXT

The editor opens file OLDFILE.TXT and processes journal file
OLDFILE.JOU to recover from an abnormally ended editing session.
Normal interactive editing can resume after the journal file is processed.

260

Console Commands
EVALUATE

EVALUATE
Evaluates a numeric expression and displays the result on the console
terminal in the current or specified radix. The current radix is set by the
SET RADIX command.

Format
EVALUATE

[/qualifier] expression

Qualifiers
/DISPLAY=radix-spec
Specifies the radix of the result, where radix-spec can be:
HEXADECIMAL
DECIMAL
OCTAL
BINARY
The expression is evaluated in the current radix as specified by the SET
RADIX command.
/RADIX=radix-spec

Overrides the current radix. The expression is evaluated and the result
displayed in the specified radix, where radix-spec can be:
HEXADECIMAL
DECIMAL
OCTAL
BINARY

Console Commands

2-61

EVALUATE

Parameters
expression

The numeric expression to be evaluated. The expression can consist of
integer values, or symbols or lexical functions that evaluate to integers.
An integer value can be prefixed by a radix operator to override the
current radix. The radix operators are:
%X = Hexadecimal
%0 = Octal
%D = Decimal
%B = Binary
NOTE

If the default radix is hexadecimal, the EVALUATE command
interprets the characters A through F (upper or lowercase)
as hexadecimal data and not as symbols. To force symbol
substitution of these characters, enclose them in apostrophes.
Example
>>>

SET

>>>

RADIX

>>>

EVALUATE

HEX

2
A

A’

00000015
>>>

EVALUATE

’'B’

00000003

The first EVALUATE command interprets the characters A and B
as hexadecimal data and computes the sum to be 15;6. The second
EVALUATE command substitutes the values defined for symbols A and B
(1 and 2) and computes the sum to be 3.

262

Console Commands
EXAMINE

EXAMINE
Displays the contents of a location or series of locations specified by an
address expression. A pointer to the location and the context of the data
are saved for subsequent DEPOSIT and EXAMINE commands.
The EXAMINE command can display the contents of locations in memory,
VO space, GPRs, IPRs, control stores, data structures, register structures,
and scan rings.

Format
address-expression

EXAMINE

[fqualifiers] signal
Structure

Qualifiers
/ASCli[=count]
Displays data in ASCII format. For example:
>>>

DEPOSIT/ASCII

1000

>>>

EXAMINE/ASCII

1000

00001000

This

"This

ASCII

string

ASCII

string"

Binary data is converted to ASCII before it is displayed. If the binary
value has no ASCII equivalent, the EXAMINE command displays a period
(.). Count is a hexadecimal number.

When /ASCII is specified, or ASCII mode is the default, the EXAMINE
command uses hexadecimal as the default radix for numeric literals that
are specified on the command line.
/BYTE

Specifies the result is integer data and is to be displayed one byte at
a time. This qualifier is valid only in the context of physical or virtual
address space. Subsequent unqualified references default to this data

type.

/CODE
Specifies program address space. Valid only with /PEM or /RIC.

Console Commands

2-63

EXAMINE

/CPU=cpu-id

The CPU in which a location is to be examined, where cpu-id is one of the
following:
0

ALL

AVAILABLE

BOOTPRIMARY

BOOTSET

PRIMARY

If a CPU is not specified, the location is in the default CPU.

See Section 1.1.1.3 for more information on specifying a CPU. See the
SET CPU command description for more information on specifying the
default CPU.
/D_FLOAT

}

The result is a floating-point number in the specified format.
/ECS
The address-expression specifies an EBox control store location.
/EMEMORY

Specifies external memory address space. Valid only with /PEM or /RIC.
/EREG

The address-expression specifies an EBox register.
/F_FLOAT

The result is a floating-point number in the specified format.
/GENERAL

The address-expression is a general-purpose register (in the range 0 to
15). Subsequent unqualified references default to general-purpose register
address space.
/G_FLOAT
The result is a floating-point number in the specified format.
/AIMEMORY

Specifies internal memory address space. Valid only with /PEM or /RIC.
/INSTRUCTION

The result data type is a VMS macroinstruction. For example:
>>>

DEPOSIT

>>>

EXAMINE/INSTRUCTION

1000

00001000

5150DO

1000

MVL RO,R1

2-64

Console Commands
EXAMINE

/INTERNAL
The address-expression is an internal register (in the range 0 to 255).
Subsequent unqualified references default to internal register address
space.

/JCS
The address-expression specifies a JBox control store location.
/LABEL
Displays a hierarchical list of labels from the current database (CDB) file
in the format:

CPU.MCU: Model = mmm Revision = v
as follows:
EXAMINE/LABEL

Model

DST

Model

DTA

Revision

$CPUO.DTB:

Model

DTB

Revision

%CPUC.FAD:

Model

FAD

Revision

%CPUO.INT:

Model

INT

Revision

$CPUO.MUL:

Model

= MUL

Revision

%$CPUQ.QOPU:

Model

Revision

OPU

$CPUQ.UCS:

Model

UCS

Revision

%CPUO.VAD:

Model

VAD

Revision

%CPUO.VAP:

Model

VAP

Revision

%CPUO.VIC:

Model

= VIC

Revision

$CPUO.VML:

Model

= VML

Revision

%CPUO.VRG:

Model

= VRG

Revision

%CPUO.XBR:

Model

Revision

XBR

O
R

Revision

$CPUQ.DST:
%CPUO.DTA:

Revision

CTU

CTL

Model

%CPUQ.CTU:

%CPUO.CTL:

>>>

/LENGTH-=Dbits
Valid only when /RING is specified. Specifies the number of bits (in the
current radix) to be displayed. If not specified, the command defaults to
the length specified in the current database (CDB) file.
/LOG
/NOLOG
Displays the address and value of each location examined.

Console Commands

2-65

EXAMINE

/LONGWORD (D)
Specifies the result is integer data and is to be examined one longword
at a time. This qualifier is valid only in the context of physical or virtual
address space. Subsequent unqualified references default to this data
type.

/MCM

Specifies a master clock module register. The address-expression specifies
a register address and can be a numeric literal or one of the following
mnemonics:

MCM Register Mnemonics

BURST

CCRO

CCR1

DIVIDER

INTERVAL

POSITION

SERIAL

TRANSFER

FREQUENCY

/NEXT[=count]

Examines the address-expression location and the next [count] location[s].
/OCTAWORD
Specifies the result is integer data and is to be displayed one octaword
at a time. This qualifier is valid only in the context of physical or virtual
address space. Subsequent unqualified references default to this data
type.

/PEM

PEM Register Mnemonics

ASDREG

BBUREG

BSCREG

CSREG

EMEREG

KEYAREG

KEYBREG

MISREG

OCPDISREG

OCPLEDREG

OCPSWREG

POLLREG

PSREG

PWRI1REG

PWR2REG

P1REG

RBDIREG

RBDSREG

RICAVAREG

RTEREG

STCREG

TOFFREG

VSNREG

266

Console Commands
EXAMINE

The following address space qualifiers can also be specified with the /PEM
qualifier:
PEM Address Space Qualifiers

Qualifier

Address Space Specified

/CODE

Program space

/EMEMORY

External memory

IMEMORY

Internal memory

/PORT_REGISTER

Port register

/REGISTER

Internal register

/PHYSICAL
The address-expression is a 32-bit physical address. Subsequent
unqualified references default to physical address space.

/PORT_REGISTER
Specifies port register address space. Valid only with /PEM or /RIC.
/QUADWORD
Specifies the result is integer data and is to be examined one quadword
at a time. This qualifier is valid only in the context of physical or virtual
address space. Subsequent unqualified references default to this data
type.

/REGISTER
Specifies internal register address space. Valid only with /PEM or /RIC.
/RIC=ric-id

RIC Register Mnemonics

ADREG

ASDREG

BIREG

BIXREG

CSREG

DAREG

DLYREG

EMEREG

ESREG

HWSREG

IDREG

LMREG

MGNREG

MUXREG

PFREG

PLREG

PSREG

P1REG

RCREG

RENREG

RSREG

SCSREG

SEREG

VSNREG

XUEREG

Console Commands

2-67

EXAMINE

The following address space qualifiers can also be specified with the /RIC
qualifier:

RIC Address Space Qualifiers

Qualifier

Address Space Specified

/CODE

Program space

/EMEMORY

External memory

/IMEMORY

Internal memory

/PORT_REGISTER

Port register

/REGISTER

Internal register

/RING

Specifies a physical scan ring.
/SCC
Specifies a scan controller register. The address-expression specifies a
register address and can be a numeric literal or one of the following
mnemonics:

SCC Register Mnemonics

ABR

CSR

CCR

DCSR

DMAE

DMAI

DMAM

DMAO

ESR

MSR

RCR

SCR

SDR

SHR

SSR

/Scu
/NOSCU (D)
Specifies a system control unit register.

2—68

Console Commands
EXAMINE

/SJA
Specifies an SPU-to-JBox adapter register. The address-expression
specifies a register address and can be a numeric literal or one of the
following mnemonics:

SJA Register Mnemonics

ADDR

CMND

DATHI

DATLO

DMASK

DXCNT

DXCS

DXMEM

DXSPU

FLAG

RETRD

RXCS

RXDB

RXFCT

RXPAR

RXPRM

SJACS

SJCS

TODR

TXCS

TXDB

TXFCT

TXPRM

XJA

/SPU

Specifies service processor unit memory.
/SYMBOL=name
Primarily used in command procedures, this qualifier assigns a symbol
name to the result and suppresses the display. If the result is less than
32 bits, the data type is integer; otherwise, the data type is bitvector. If
the /INSTRUCTION qualifier is specified, the data type is string.

/VECTOR-=register-number:element-number
Specifies vector register number and element number.
/VIRTUAL

The address-value is a 32-bit virtual address. If the address is in PO or
P1 space, a CPU must be specified (/CPU=cpu-id) to determine process
context. If a CPU is not specified, the default CPU is assumed.
/WINDOW/[=window-name]
Displays data in the specified format in the specified window. If windowname is not specified, data is displayed in the default EXAMINE window.
The window can be scrolled up or down with the SCROLL command.

/WORD
Specifies the result is integer data and is to be displayed one word at
a time. This qualifier is valid only in the context of physical or virtual
address space. Subsequent unqualified references default to this data
type.

Console Commands

269

EXAMINE

Parameters
address-expression

The address of the location or the starting address of a series of locations
to examine. The address can be a numeric literal, symbolic address, or
special operator.
signal-name

Specifies a signal name as listed in the current database (CDB) file in the
format:

%CPUn.label.label.signal<end-bit:start-bit>
%SPU .label.label.signal<end-bit:start-bit>
structure-name

Specifies a control store, register file, data cache, or control structure as
listed in the current database (CDB) file in the format:
%CPUn.structure-name[location]<end-bit:start-bit>
%SPU.structure-namel[location]<end-bit:start-bit>
Expressions
numeric-literals

An address-expression or value-expression can be a numeric value in any
of four radixes determined by one of the following radix operators:
%B = Binary
%D = Decimal

%X = Hexadecimal (D)
%0 = Octal

For example, in the following command the %D operator specifies the
address as decimal:
>>>

EXAMINE

%D100

00000064 A06267D0

The default radix is determined by the SET RAT'TX command.

2-70

Console Commands

EXAMINE

special-operators
The DEPOSIT and EXAMINE commands allow special operators to be
used in place of expressions. The following table lists the operators:
Table 2-12

EXAMINE Special Operators

Operator

Definition

. (period)

Use last referenced location.

* (asterisk)

Use last referenced location.

+ (plus)

Increment last referenced location by current data size (memory
references) or by one (all other references).

— (minus)

Decrement last referenced location by current data size memory
references or by one (all other references).

@ (at)

Use contents of last referenced location as new address (indirect
addressing). Or, use data from last DEPOSIT command as new
deposit data.

/GENERAL or /INTERNAL qualifiers were used. For example:
EXAMINE RO

is equivalent to
EXAMINE/GENERAL 0O

GPR and PSL Register Mnemonics
Mnemonic

Address

Name

Argument pointer

Frame pointer

PC
PSL
RO-R11
SP

15
00
14

Program counter
Processor status longword
GPRs RO to R11
Stack pointer

Console Commands

EXAMINE

IPR Register Mnemonics
Mnemonic

Address

ASTLVL

Asynchronous system trap level

ESP

Executive stack pointer

ICCS
ICR
IPL
ISP

18
1A
12
04

Interval clock control
Interval count
Interrupt priority level
Interrupt stack pointer

KSP

Kernel stack pointer

MAPEN

Memory management enable

NICR

Next interval count

POBR
POLR
P1BR
P1LR
PCBB
PME

08
09
0A
0B
10
3D

PO base register
PO length register
P1 base register
P1 length register
Process control block base
Performance monitor enable

RXCS
RXDB

20
21

Console receiver control and status
Console receiver data buffer

SBR
SCBB
SID
SIRR
SISR
SLR
SSP

0C
11
3E
14
15
oD
02

System base register
System control block base
System identification
Software interrupt request
Software interrupt summary
System length register
Supervisor stack pointer

TBCHK

Translation buffer check

TBIA

TBIS
TODR

3A
1B

TXCS
TXDB

22
23

USP

Translation buffer invalidate all

Translation buffer invalidate single
Time of year

Console transmit control and status
Console transmit data buffer

User stack pointer

2-71

2—-72

Console Commands
EXAMINE

Examples
B

>>> EXAMINE 1000
P

00001000

D05957C0

Displays the contents of address 1000. The default address space is
physical and the default size is longword.
B

>>> EXAMINE/INSTRUCTION
P

00001000

ADDL2

.
R7,R9

The /INSTRUCTION qualifier specifies to display data starting at the
current address as an instruction.
>>>

EXAMINE/LONGWORD/NEXT=2
P

00001000

DO5857CO

00001004

OOOlFF8F

00001008

00005100

1000

The /[LONGWORD qualifier resets the default data size to longword and
/NEXT=2 specifies to display the next two locations in addition to the
starting address.
>>>

EXAMINE/GENERAL

Displays the contents of GPR 4. The default data size is longword.
>>>

EXAMINE

Displays the contents of the stack pointer (GPR 14).
B

>>> EXAMINE POBR

Displays the contents of the PO base register (IPR 08).

Console Commands

2-73

EXIT

EXIT
Terminates processing of the current command procedure. If the
command procedure was called from within another command procedure,
control returns to the calling procedure. Optionally, a return status can
be specified.

Format
EXIT

/qualifiers [status-code]

Qualifiers
/ATTN
Returns CPU attention to the caller. Allows a command procedure that
traps a CPU attention (with ON ATTN, see the ON command description)
to pass the attention to the calling procedure for further processing.
/FAULT

Returns power fault to the caller. Allows a command procedure that traps
a power fault (with ON FAULT, see the ON command description) to pass
the fault to the calling procedure for further processing.

Parameters
status-code
A numeric value representing success or failure of the exiting procedure.
The status code can be an integer or an expression that equates to an
integer value. An odd value indicates failure and an even value indicates
success of the procedure. A status code of %X8000000 causes all command
procedure file levels to exit.
If no status is specified, the default success status is returned, as follows:

Bit 0 set = Success
Bit 0 not set = Warning
Bit 1 set = Error
Bit 2 set = Fatal/severe error

2-74

Console Commands
FIND

FIND
The FIND command does one of the following:

Specifies the CPU in which GPRs are to be modified.

Finds the starting address of a 256-Kbyte block of good main memory.

Finds the starting address of the restart parameter block.

Format
FIND

/qualifier [blocks]

Qualifiers
/CPU=cpu-id
The CPU in which GPRs are to be modified, where cpu-id is one of the
following:
0

ALL

AVAILABLE

BOOTPRIMARY

BOOTSET

PRIMARY

If a CPU is not specified, GPRs in the default CPU are modified.

See Section 1.1.1.3 for more information on specifying a CPU. See the
SET CPU command description for more information on specifying the
default CPU.

Console Commands

2-75

FIND

/MEMORY
Returns the starting address of the first page-aligned, 256-Kbyte block of
main memory. VMB is loaded at this address.

When a number of blocks is specified with FIND/MEMORY, that number
of pages are located, if possible. If that number of pages are located, the
SP contains the base address plus 200,¢.
/RPB

Finds the location of the restart parameter block (RPB) in main memory.
If the RPB is found, the SP is set to the base address plus 2001 and the
PC is set to the address in the RPB.

Parameters
blocks
The number of main memory blocks to be located.

2-76

Console Commands
GOTO

GOTO
Valid only in a command procedure. GOTO transfers control to a specified
label.

Format
GOTO

Jabel

Parameters
label
The first item on a command line. A label cannot contain embedded
blanks. When the GOTO command is executed, control passes to the
command following the label. The label can precede or follow the GOTO
statement in the command procedure.

All labels are procedure-level dependent except for labels that define
subroutine entry points. Subroutine entry point labels are local to the
current command procedure file level and must be unique. Labels must
be terminated with a colon (:).

Console Commands

2-77

HALT

HALT
Stops macroprogram execution in a specified processor. The HALT
command is usually not used for a multiprocessor because it can leave
the multiprocessor in an undefined state.
Format
HALT

[/CPU=cpu-id]

Qualifier
/CPU=cpu-id

The CPU to be halted, where cpu-id is one of the following:
3
2
1
0
ALL

AVAILABLE

BOOTPRIMARY

BOOTSET

PRIMARY

If a CPU is not specified, the default CPU is halted.

See Section 1.1.1.3 for more information on specifying a CPU. See the
SET CPU command description for more information on spec1fy1ng the
default CPU.

2-78

Console Commands
HELP

HELP
The HELP command invokes the SPU HELP facility to display
information about an SPU command or topic. You can abbreviate any
topic name, but ambiguous abbreviations display all matches. In response
to the Topic? prompt, you can:

Type the command, topic, or subtopic on which help is needed.

Type ? (question mark) to display a list of topics or subtopics.

Press Return to exit to the previous topic or SPU command level.

Enter Ctrl/Z to exit to the SPU command level.

IN-LINE HELP
For information on in-line help, see Section 1.2.

Format
HELP

[topic ... ]

Parameters
topic
Specifies a command, topic, or subtopic on which help is needed. A
topic and subtopic, separated by spaces, can be specified. If a topic is
not specified, a list of all commands and topics in the HELP library is
displayed.

Console Commands

2-79

HELP

Examples
n

>>>

HELP

Topic?

Displays information about using the HELP command; lists the
commands and topics for which help is available; returns the Topic?
prompt.

>>> HELP DEFINE

Displays information about all the DEFINE command subtopics.
>>> HELP DEFINE/KEY

Displays information about all the DEFINE/KEY command subtopics.

2-80

Console Commands
IF

IF
Valid only in a command procedure. IF allows commands to be executed
conditionally.

Format
IF

expression THEN command

Parameters
expression
_.
Specifies an expression to be evaluated. See Section 1.6 for details on

expression syntax.

command

Specifies the command to be executed. The command can be any legal
command including GOTO.
The REPEAT command can be used with the IF command to produce
a WHILE command as long as the target command is repeatable. See
HELP REPEAT for repeatable commands.

Console Commands

2-81

INITIALIZE

Initializes various system elements and data structures. When issued

without qualifiers, initializes the boot set.
Format
[/qualifiers]

INITIALIZE

Qualifiers
/BANK_MASK=mask

Valid only with /MEMORY, where mask is a hexadecimal number.
/BRIEF

Valid only with /KERNEL and /SCU. Passes a flag to the
SYS$SYSTEM:INIT.CMD command procedure specifying a brief
initialization. The procedure then skips clock subsystem initialization,
does not load the various structures, and does not save system state.
/CLOCK

Initializes the clock subsystem.
/CPU=cpu-id

The CPU to be initialized, where cpu-id is one of the following:
0

ALL

AVAILABLE

BOOTPRIMARY

BOOTSET

PRIMARY

If a CPU is not specified, the default CPU is initialized. This qualifier can
also be specified with /KERNEL, /MEMORY, /SCAN, and /SCU.
See Section 1.1.1.3 for more information on specifying a CPU. See the
SET CPU command description for more information on specifying the
default CPU.

/DEBUG

/NODEBUG

Used with /SCM and /SJA.
/FIRMWARE-=file-spec

Used with /SCAN or /SCM. Specifies loadable firmware.

2-82

Console Commands
INITIALIZE

/INTERLEAVE=type
Valid only with /MEMORY, where type is one of the following:

1IWAY

2WAY

2WAY_1UNIT

2WAY_2UNIT

4WAY

AO
Initializes the I/O subsystem. INITIALIZE/IO issues a RESET to all
XMI-to-SCU adapters (XJAs) and scans the XMI bus for I/O adapters.
The results are used to configure and load the JBox I/O physical address
memory map (IPAMM).

/KERNEL
Initializes the processor after microcode is loaded and the scan subsystem
is initialized. INITIALIZE/KERNEL should be issued before starting
program execution.
/LOG

/NOLOG

Used with /SCAN, /SCM, and /SJA. Determines whether to display
command results.
/MEMORY
Initializes the memory subsystem. INITIALIZE/MEMORY determines
the preferred memory configuration from self-test results and configures
and loads the JBox memory physical address memory map (MPAMM) and
nonexistent physical address memory map (NPAMM).

NOTE
The /INTERLEAVE qualifier can be used to override the preferred
memory configuration.

/OUTPUT=file-spec
/NOOUTPUT
Valid only with /MEMORY. Determines whether the main memory bad
block list is output to a file. If file-spec is not specified, the default file is

[UCODEIDEFECT_LIST.SYS.
/POWER
Invokes the command procedure [SYSEXE]JPOWER.CMD to initialize the
power subsystem.

/RESET
/NORESET

Used with /SCAN.

Console Commands

2-83

INITIALIZE

/RESTORE-=file-spec

/NORESTORE

Valid only with /MEMORY. Determines whether to restore main memory
bad block information. If file-spec is not specified, the default file is
[UCODEIDEFECT_LIST.SYS.
/SCAN

Invokes the command procedure SCAN.CMD to initialize the scan
subsystem.

/SCM

Initializes the scan control module.
/SCU
/NOSCU

Valid only with /SCAN. Initializes the SCU.
/SIMULATION
/NOSIMULATION

Valid only with /SJA. Specifies whether the SJA driver connects to the
specified CPU or a simulation running on a remote host.
/SJA

Initializes the SPU-to-JBox adapter.
/SUNDANCE
/NOSUNDANCE

Valid only with /SCM. For use only with the MCU tester. Specifies
whether the scan control module is controlling the VAX 9000 scan system
or the MCU tester (which requires different firmware).
/TEST(D)
/NOTEST

Valid only with the /MEMORY qualifier. This qualifier determines
whether test data is used to build the memory bitmap.
/TIMEOUT=seconds

Valid only with /SCM, where seconds is a decimal number.
/VOLUME

Initializes a disk or tape volume.

2-84

Console Commands
INITIALIZE

/WPT_AREA=kbytes

Valid only with /SCM, where kbytes is a decimal number.

Example
>>>

INITIALIZE/KERNEL

[Initializing Master
$CLI-I-KNLREV,

[Initializing memory
[Configured memory
[Initializing
[Waiting

for

[Setting up

Clock Module]

system kernel

IO
self

revision

subsystem]

size

10000000

(256

subsystem]
test

XJA adapter

complete]

>>>

The INITIALIZE/KERNEL command display.

MBytes)]

Console Commands

2-85

INQUIRE

INQUIRE
Valid only in a command procedure. INQUIRE requests input from the
terminal during execution of the procedure and assigns a symbol to the
input string. The symbol is defined in the local symbol table.

Format
B

INQUIRE - [/qualifier]

]

symbol-name

prompt-string

1 oymbol

Qualifiers
/EXPRESSION
/NOEXPRESSION
Specifies whether data input to the prompt-string is to be evaluated as an
expression.

/STRING
/NOSTRING
Specifies whether data input to the prompt-string is to be interpreted as a
string.

Parameters
symbol-name
An alphanumeric name containing from 1 to 255 characters.
prompt-string | prompt-symbol

The prompt displayed when the INQUIRE command is executed.
String values are automatically converted to uppercase, leading and
trailing spaces and tabs are removed, and multiple spaces and tabs are
compressed to a single space.

To prevent case conversion and retain multiple spaces and tabs, place
quotation marks around the string. To use quotation marks in a string,
enclose the string in quotation marks and use a double set of quotation
marks within the string. If the string includes an at sign (@), enclose the
string in quotation marks.

2-86

Console Commands
INQUIRE

If prompt-string is not specified, the command ihterpreter prompts for the
string with:

_PROMPT:

If prompt-symbol is specified, the symbol value is used as the prompt
string.

Console Commands

2-87

LABEL

LABEL
Valid only in a command procedure. A label identifies a point in the
procedure that can be referenced by GOTO and CALL commands.

Format
label:

[command]

Parameters
label:
The first item on a command line. A label cannot contain embedded
blanks. When the command is executed, control passes to the command
following the label. The label can precede or follow the command that
references it in the command procedure.
All labels are procedure-level dependent except for labels that define
subroutine entry points. Subroutine entry point labels are local to the
current command procedure file level and must be unique. Labels must
be terminated with a colon (:).

command
A command, preceded by a space, can follow a label on the same line.

2-88

Console Commands
LOAD

LOAD
Loads the contents of a file into memory or into a control store.
Main memory loading is assumed to be in EXE file format. If the EXE
header is not present, the file is loaded as a binary image file. If the
header is present, it is skipped and the remainder of the file is loaded as
a binary image file.

If a control store qualifier is specified, the contents of the file are loaded
into the specified control store. Data checking is provided for control store
loads and an error is returned if the file format is incorrect.

Format
LOAD

[/structure] [/qualifier] file-spec

Structures
/ABS

Loads a test case in absolute format. The absolute file format is the same
as an EXE file without a header but with an additional block at the end of
the file. This block is loaded into memory and is used to set the program
starting address and the values of all GPRs and IPRs. The default file
type is .CDB.
/CDB

Loads a configuration database. This file describes the system scan rings
and contains the routines to load each structure. The default file type is
EXE.

/MAIN_MEMORY (D)

Loads main memory. This is the default if no other structure is specified.
The file format is assumed to be standard .EXE. The entire file is loaded
as a binary image.
/PEM

Loads the power and environmental monitor firmware. The file format is
assumed to be binary data. The /START qualifier must be used to specify
the start address. The standard address is 80004¢. The default file type
is .BIN.

Console Commands

2-89

LOAD

/RIC=ric-id

Loads the specified regulator intelligence card firmware. The file format is
assumed to be binary data. The /START qualifier must be used to specify
the start address. The standard address is 8000,5. The default file type
is .BIN.
/RING[=ring-id]
Loads fixed patterns into an internal scan ring. The input data file
specifies ring selects, lengths, and data to be moved into a ring. The MCU
broadcast ring (ring 15) can also be loaded. The default file type is .RING.
/STRUCTURE
Loads one or more structures from a binary file. The structure names are
contained in the file. The default file type is .LOD.

/TEXT
Loads a structure from a MICRO2-format ULD file. This file is the same
format as the input file to ULINK. It performs the function as the .LOD
file loaded with /STRUCTURE but is much slower.

/VECTOR

Loads a text file that specifies the elements of the vector registers. Any
register can be loaded and a subset of the elements can be loaded for each
vector.
"

Qualifiers
/CPU=cpu-id
The CPU for nonmemory load, where cpu-id is one of the following:
0

ALL

AVAILABLE

BOOTPRIMARY

BOOTSET

PRIMARY

If a CPU is not specified, the default CPU is loaded.

See Section 1.1.1.8 for more information on specifying a CPU. See the

SET CPU command description for more information on specifying the
default CPU.
/DATA (D)
/NODATA

Specifies whether the structure data is loaded or only the structure
symbol table.

2-90

Console Commands
LOAD

/LOG
/NOLOG

Determines whether load status is displayed.
/REVISION=version

Specifies the version to be compared against the revision information
stored in the .LLOD file for each structure.
/SCU
/NOSCU

Directs the load to the system control unit.
/START=address

Loads the structure, starting at the specified address.
/SYMBOL
/NOSYMBOL

Determines whether to load control store symbols.
/VERIFY
/NOVERIFY

Verifies a scan ring load.

Parameters
file-spec

The file containing the data to be loaded. Data is loaded into the specified
data structure starting at location 0 unless /START is specified.

Console Commands

2-91

LOGOUT

LOGOUT
Deletes the current command language interpreter (CLI) process and
returns the process to the host system. Only remote processes can log out.
Local processes ignore this command.

Format
LOGOUT

[qualifiers]

Qualifiers
/BRIEF
Echoes the LOGOUT command.
/FULL (D)
Displays the logout message, which includes user name and date and time
of logout.

Examples
>>>

LOGOUT/BRIEF

The LOGOUT/BRIEF format.
>>>

LOGOUT

GIBRISH

logged

out

15-APR-1988

The default LOGOUT (/FULL) message format.

14:23:45.30

2-92

Console Commands
MAIL

MAIL
Mails the specified file to the specified recipient.
Format
MAIL

[qualifiers] file-spec

recipientf, . .. ]

@recipient-list

Qualifiers
/FILE=file-spec
The file to send.

/SELF

/NOSELF

Determines whether the sender receives a copy of the mailed file.
/SUBJECT=quoted-string
The subject of the mailed file.

Parameters
file-spec

The file to be mailed.
recipient

Can specify one or more recipients or a list of recipients using the at sign
(@).

Console Commands

2-93

MICROSTEP

MICROSTEP
Issues a specified number of clock cycles to a specified CPU.

Format
MICROSTEP

[/qualifiers] step-count

Qualifiers
/BURST
/NOBURST
Specifies whether to burst the clocks for the number of cycles specified by
step-count.

/CPU=cpu-id
Specifies the CPU to be stepped, where cpu-id is one of the following:
0

ALL

AVAILABLE

BOOTPRIMARY

BOOTSET

PRIMARY

If the cpu-id is BOOTSET, all CPUs and the SCU are stepped tbgether.

The SET STEP BOOTSET command permanently selects this option.
If the cpu-id is ALL, all CPU clocks are stepped.

If a CPU is not specified, the default CPU is stepped.
See Section 1.1.1.3 for more information on specifying a CPU. See the
SET CPU command description for more information on specifying the
default CPU.

/SPACEBAR(D)
/NOSPACEBAR
Determines whether to enter space bar step mode (SBSM) at the end of
the specified step-count.
In SBSM, the prompt changes to sTEp> and one clock cycle is issued each
time the space bar is pressed.
:
SBSM is exited when any other key is pressed.

2-94

Console Commands
MICROSTEP

/SCU
/NOSCU
Specifies whether to step the SCU clocks. When the SCU clocks are
stepped, memory timing is switched from STBY to STEP and one clock
is issued (unless /BURST is specified). Memory timing is switched back
to STBY and any tracepoints set in the SCU are scanned. The process
is repeated for each count in the step-count. On the final count, active
tracepoints are displayed followed by the microPC.

Parameters
step-count
A decimal value specifying the number of clock cycles to issue.

If step-count is nonzero, the SPU enters space bar step mode (SBSM, see
/SPACEBAR) at the end of the specified count.
If step-count is zero, SBSM is not entered after the clock cycle is
generated. This command form is used when a key is defined to step
a processor instead of SBSM.

Console Commands

2-95

MOUNT

MOUNT
Mounts a specified volume on a specified device.

Format
MOUNT

device volume-name

Parameters
device
If the device is not specified, the command prompts for it.
The asterisk (*) wildcard character can be used to specify disk device
labels to mount the disk present. The label is read from the device and

the system logical DISK$label is defined as the name of the disk device.
The tape device label must be specified; the asterisk (*) wildcard

character cannot be used. The system logical name TAPE$label is defined

as the name of the specified tape device. A warning message is issued if
the tape label does not match the tape installed in the drive.
volume-name

The volume to be mounted on the specified device. If the volume is not
installed on the device, an error message is issued. If the volume name is
not specified, the command prompts for it.

2-96

Console Commands
NEXT

NEXT
Executes the specified number of macroinstructions. The processor
executes a HALT after the current instruction completes. The PC points
to the instruction following thé single-stepped instruction.

Format
NEXT

[/qualifiers] [step-count]

Qualifiers
/CPU=cpu-id
Specifies the CPU to be stepped, where cpu-id is one of the following:
0

ALL

AVAILABLE

BOOTPRIMARY

BOOTSET

PRIMARY

/SPACEBAR (D)
/NOSPACEBAR
Determines whether to enter space bar step mode (SBSM) at the end of
the specified step-count.
In SBSM, the prompt changes to NEXT> and one macroinstruction is
executed each time the space bar is pressed.
SBSM is exited when any other key is pressed.

Console Commands

2-97

/VIRTUAL

/NOVIRTUAL
Specifies whether the instruction decode routine uses virtual or physical
memory when decoding and displaying the next instruction.

Parameters
step-count

A decimal value specifying the number of macroinstructions to execute.
If step-count is nonzero, the SPU enters space bar step mode (SBSM, see
/SPACEBAR) at the end of the specified count.
If step-count is zero, SBSM is not entered after the instruction is .
executed. This command form is used when a key is defined to step a
processor instead of SBSM.

2-98

Console Commands
ON

ON
Valid only in a command procedure. Executes a specified command when
a specified condition occurs during procedure execution.

NOTE
The ON command is executed only once and then disables itself.
The ON target command must reexecute the ON command to
reestablish the condition handler.

Format
ON

condition THEN command

Parameters
condition
One of the following:
ATTN

Scan subsystem unhandled attention

ERROR
FAULT

CLI process command error
Power subsystem unhandled exception

SEVERE
WARNING

CLI process command severe error
CLI process command warning

command
Any valid CLI command.

Console Commands

2-99

OPEN

OPEN
Opens a file for command-level reading and/or writing ASCII recordoriented files. Such files can store temporary data or test case results for
later comparison. Files opened with the OPEN command remain open
until closed with the CLOSE command.

Format
OPEN

[/qualifier] logical-name file-spec

Qualifiers
/APPEND
Opens an existing file for write access, starting at the end of the file. The
original file content cannot be modified.

/ERROR=label

On error, transfers control to label. Valid only in a command procedure.

/LOG
/NOLOG
Determines whether to display an informational message when the file is
opened.
/READ(D)

Opens an existing file for read, starting at the beginning of the file.
/WRITE

Creates a new file.

Parameters
logical-name
Specifies a logical name to be assigned to the open file and placed in the
process logical name table.
file-spec

The name of the file or device to be opened for input or output. Wildcard
characters are not allowed in the file specification.

2-100

Console Commands
PURGE

PURGE
Deletes all previous versions of files that match a given file specification.
Format
PURGE

[/qualifiers] [file-spec], . . . ]]

Qualifiers
/CONFIRM
/NOCONFIRM (D)

Determines whether an affirmative response is required before a file is
purged. Valid responses to the confirmation prompt are:
Response

Result

Y (yes)

The file is purged.

T (true)

The file is purged.

N (no)

The file is not purged.

F (false)

The file is not purged.

Q (quit)

Abort command processing.

Responses can be upper or lowercase. The first character of the response
is checked for Y, T, or Q. Any response other than Y, T, N, F, or Q is
interpreted as N or F.
/KEEP=number

Specifies the maximum number of file versions to be retained. If not
specified, only the highest numbered version of the file is kept.
/LOG

/NOLOG (D)

Determines whether file-specs are displayed as each file is deleted.

Console Commands

2-101

PURGE

Parameters
file-spec], . .. ]
Specifies one or more files to be purged. If omitted, all files in the
directory are purged. The version number cannot be specified. Wildcard
characters can be substituted for the directory, name, or type fields or
partial fields.

Examples
>>>

PURGE

Deletes all but the highest numbered version of all files in the default
directory.
>>>

PURGE/KEEP=2

Deletes all but the two highest numbered versions of all the files in the
default directory.
>>>

PURGE/KEEP=2

TAMPA::DISK1: [EXAMPLE]*.LIS

Deletes all but the two highest numbered versions of each file with the
file type .LIS in the directory EXAMPLE on remote node TAMPA.

2-102

Console Commands
READ

READ
Reads a line from a specified file and assigns a symbol to the line.
Format

READ

[/END_OF _FILE=label] logical-name symbol-name

Qualifiers
/END_OF _FILE=label

Control is transferred to label if the end-of-file condition is detected. Valid
only in command procedures.

/ERROR=Ilabel

Control is transferred to label if an error condition is detected. Valid only

in command procedures.

Parameters
logical-name

The logical name assigned by the OPEN command when the file was
opened. STDIN, STDOUT, SYS$INPUT, and SYS$OUTPUT are the
predefined logical names for the terminal or controlling file.
symbol-name

A 1- through 255-character alphanumeric name equated to the contents
of the record being read. The first character must be an alphabetic letter,
underscore (_), or dollar sign ($). The command interpreter places the
symbol name in the local symbol table for the current command level. If
the symbol was previously defined, the READ command redefines it to the
new value being read.

Console Commands

2-103

READ

Example
>>>

OPEN

>>>

LOOP:

>>>

READ/END_OF_FILE=ENDIT

>>>

INFILE

GOTO

>>>

ENDIT:

>>>

NAMES.DAT

INFILE

NAME

LOOP

INFILE

The OPEN command opens the file NAMES.DAT for input and
assigns
it the logical name INFILE. The READ command reads records
from
file INFILE into symbol NAME, and it specifies label ENDIT
to receive
control when the last INFILE record has been read. The procedur
e loops
until all records in the file have been processed.

2-104

Console Commands
REBOOT

REBOOT

Reboots the SPU. The command causes the SPU to enter kernel mode and
execute a HALT instruction. The SPM attempts to reboot if the Startup
switch is set to Boot.
Format

REBOOT

{/CONFIRM [/NOCONFIRM}

Qualifier
/CONFIRM (D)
/NOCONFIRM

Must be specified to avoid accidental execution. Determines whether
an affirmative response is required before the reboot is executed. Valid
responses to the confirmation prompt are:

Response

Result

Y (yes)

Reboot.

T (true)

Reboot.

N (no)

Do not reboot.

F (false)

Do not reboot.

Q (quit)

Abort command processing.

Responses can be upper or lowercase. The first character of the response
is checked for Y, T, or Q. Any response other than Y, T, N, F, or Q is

interpreted as N or F.

Example
>>> REBOOT/NOCONFIRM

The SPU is rebooted without confirmation.

Console Commands

2-105

RECALL

RECALL
Recalls previously entered commands from the command buffer. The
command buffer stores up to 20 commands; the most recently entered
command is number 1. If the qualifier and parameters are omitted, the

most recently entered command (that is, number 1) is recalled. The

RECALL command is not given a number and cannot be recalled.

Format
RECALL

[/ALL] [command |index]

Qualifier
/ALL
Displays all commands in the command buffer with their numbers. If
/ALL is specified, do not specify the command or index parameter.

Parameters
command
The leading substring of the command to be recalled. The leading
substring is the minimum number of characters required to identify
uniquely the wanted command from other commands in the buffer.

index

The recall buffer number of the command to be recalled.

2—-106

Console Commands
RECALL

Example

W oo ~J0

U W

>>> RECALL/ALL

EVE RECALL.SDML

read

help
mail

help

read

help

purge

mail
MAIL

set

mail
WIPEM

11 mail
logout

help

SPELL LOAD.SDML

WIPEM

MAIL

16 mail

help

WIPEM

lexicals

19 mail

20 help lexicals

f$leng

Typical contents of a full command buffer.

Console Commands

2-107

RENAME

RENAME
Changes the directory, file name, file type, or version of an existing file
specification.
NOTE
Files cannot be renamed from one device to another.

Format
RENAME

[fqualifiers] input-file-spec], . . . ] output-file-spec

Qualifiers
/LOG

/NOLOG (D)
Determines whether the file-spec is displayed for each renamed file.

/CONFIRM

/NOCONFIRM (D)
Determines whether an affirmative response is required before a file is
renamed. Valid responses to the confirmation prompt are:
Response

Result

Y (yes)

The file is renamed.

T (true)

The file is renamed.

N (no)

The file is not renamed.

F (false)

The file is not renamed.

Q (quit)

Abort command processing.

Responses can be upper or lowercase. The first character of the response
is checked for Y, T, or Q. Any response other than Y, T, N, F, or Q is
interpreted as N or F.

2-108

Console Commands
RENAME

Parameters

input-file-spec], . . . ]

One or more file specifications that are to be changed. Wildcard
characters are allowed in the directory, file name, file type, or version
number fields of the file specification. All files with specifications that
match the wildcard fields are renamed.
output-file-spec

The new file specification. The device, directory, file name, and file type
of the input-file-spec provide defaults for output-file-spec fields that are
not specified or that contain a wildcard character. Wildcard characters
in corresponding fields of input-file-specs and output-file-specs result in
multiple rename operations.

Version numbers are applied to output-file-specs according to the first of
the following rules that applies:

The output-file-spec specified version number.

The input-file-spec version number if either the input-file-spec or
output-file-spec has an asterisk (*) in the version number field.

3. Version number 1 if the output-file-spec file name and file type fields
do not currently exist.

The highest existing version number +1 if the output-file-spec file
name and file type fields currently exist.

Example
>>> RENAME/LOG PS*.*

[DIAG]ONTHA.*

$CLI-I-RENAMED, DUAO:[TEST]PSN.QT;1 renamed to DUAQO: [DIAG]ONTHA.QT;1

Any file in the default directory having PS as the first two characters of
the file name is renamed to file name ONTHA in directory [DIAG] and
has the same file type as the input file.

Console Commands

2-109

REPEAT

REPEAT
Repeats the execution of a command until Ctrl/C is typed, an error occurs,
or an IF command expression becomes FALSE.
The REPEAT IF command is a special case that performs the same
function as a WHILE command. Loops can be constructed as follows:
>>>

LOOP_COUNT

>>>

REPEAT

LOOP_COUNT.LEQ.100

LOOP_ COUNT=LOOP

COUNT+1

The REPEAT command increments LOOP_COUNT until it reaches 101
and then returns control to the command interpreter.
If the target command of a REPEAT IF command is not repeatable, the
command executes as if REPEAT was not entered.

Format
REPEAT

[/COUNT=number] command

Qualifier
/COUNT=number
The command is repeated the specified number of times. If not specified,
the command is repeated forever.

Parameters
command
The command to be repeated. If the command is not repeatable, execution
terminates after the command is executed once.

2-110

Console Commands

RESET

RESET
Scans the RESET vector from the CDB into the specified CPU. Only
scan latches are affected and all are modified. Then the command file
[SYSEXE]JRESET.CMD is executed. This file can contain any valid SPU
commands.

Format
RESET

/qualifiers

Qualifiers
/CPU=cpu-id
The CPU to be reset, where cpu-id is one of the following:
0

ALL

AVAILABLE

BOOTPRIMARY

BOOTSET

PRIMARY

If a CPU is not specified, the default CPU is reset. All error checking is
turned on.

See Section 1.1.1.3 for more information on specifying a CPU. See the
SET CPU command description for more information on specifying the
default CPU.
/Scu
/NOSCU

Determines whether the SCU is reset. All error checking is turned on and
all ports are turned off.

Console Commands

2-111

RESTORE

RESTORE
Restores previously saved scan state or SPU context information (see the
SAVE command description). A qualifier must be specified; if not, the
command prompts for additional input. The qualifiers allow the saved

component states to be restored at the same time with one RESTORE
command or individually with separate commands. Scan state is restored
on units that are not running. If the system clocks are running on any of
the specified units, an error message reports the running unit(s).

Format
RESTORE

qualifiers

Qualifiers
/CPU=cpu-id
The CPU on which the scan state is to be restored, where cpu-id is one of
the following:
0

ALL

AVAILABLE

BOOTPRIMARY

BOOTSET

PRIMARY

If a CPU is not specified, the default CPU state is restored.

See Section 1.1.1.3 for more information on specifying a CPU. See the
SET CPU command description for more information on specifying the
default CPU.
/SCU

/NOSCU
Specifies whether to restore the SCU scan state.

/SPU
/NOSPU

Specifies whether to restore the SPU context state.

2-112

Console Commands
RETURN

RETURN
Valid only in a command procedure. Returns control to the procedure at
the top of the CALL stack. The stack is decremented.

Format
RETURN

Console Commands

2-113

RUN

RUN
Loads the specified program and creates a job to execute it. The current
terminal is attached to the new job until it completes unless the /DETACH
qualifier is specified. If /DETACH is not specified, the CLI is suspended
until the program completes.

Format
RUN

[/qualifier] file-spec [command-line]

Qualifiers
/DEBUG

/NODEBUG
The /DEBUG qualifier causes the job to enter the debug wait state
before starting execution. If this qualifier is specified without the remote

debugger present, the job hangs. The job must be continued with the

remote debugger.
/DETACHED
/NODETACHED

The /DETACHED qualifier starts a server job to execute the specified
program. The CLI continues after starting the job.
/JOB_PRIORITY=level

Specifies the job priority level, from 1 (high) to 31 (low).
/KERNEL_STACK=size

Specifies the size of the kernel stack as a decimal number. Unlike
the user stack, the kernel stack is not automatically increased when
necessary.

/LOAD

/NOLOAD

The /LOAD qualifier causes the specified program to be unloaded and
reloaded before execution. This ensures that the latest version of the
image file is executed.
/MAXIMUM_MESSAGES=number

Specifies the maximum number (decimal) of messages that can be pending

on the job’s port.

2—-114

Console Commands
RUN

/MODE={KERNEL | USER}
Specifies the initial execution mode.
/PARAMETERS=quoted-string

Passes parameters to the program to be run.

/POWER_RECOVERY
/NOPOWER_RECOVERY

The /POWER_RECOVERY qualifier specifies that the job requires
powerfail restart.
/PROCESS_PRIORITY=number

Specifies the process priority (decimal) for the first process in the job.

/USER_STACK-=size
Specifies the initial size (decimal) of the user stack. If necessary, the user
stack is automatically extended.

Parameters
file-spec
Specifies the program to be loaded and executed.

[command-line]
The command line is passed to the specified program, where it is
interpreted (or ignored).

Console Commands

2-115

SAVE

SAVE
Save scan state or SPU context state. The state is saved in a global area
of SPU memory where it can be referenced by SPU software or restored
(see the RESTORE command description). Scan state is typically saved
as part of the system initialization procedure INIT.CMD to establish
a system reset vector. The SPU uses the vector internally during the
recovery phase of CPU/SCU error handling.
A qualifier must be specified; if not, the command prompts for additional
input. The qualifiers allow the component states to be saved at the same
time with one SAVE command or individually with separate commands.
Scan state is saved on units which are not running. If the system clocks
are running on any of the specified units, an error message reports the
running unit(s).

Format
SAVE

qualifiers

Qualifiers
/CPU=cpu-id
The CPU on which the scan state is to be saved, where cpu-id is one of
the following:
0

ALL

AVAILABLE

BOOTPRIMARY

BOOTSET

PRIMARY

If a CPU is not specified, the default CPU scan state is saved.

See Section 1.1.1.3 for more information on spec?fying a CPU. See the
SET CPU command description for more information on specifying the
default CPU.

/SCU
/NOSCU
Specifies whether to save the SCU scan state.

/SPU
/NOSPU
Specifies whether to save the SPU context state.

2-116

Console Commands

SCROLL

SCROLL
Valid only in screen mode. Scrolls a specified window left, right, up, or
down a specified amount. In addition, microcode windows can be scrolled
to the current, next, or previous microPC, or to a specified microcode
address.

Format
SCROLL

[qualifiers] [window-name]

Qualifiers
/CURRENT
Valid only in microcode and EXAMINE windows. Scrolls the window to
the microcode listing location that corresponds to the current microPC of
the control store associated with the window.

/DOWNI/=lines] (D)
Scrolls the window down (forward). The default is six lines.
/LEFT[=columns]

Valid only in microcode windows. Scrolls the window to the left. The
default is eight columns.
/NEXT][=lines]

Valid only in microcode windows. Scrolls the window forward the
specified number (decimal) of lines. If lines are not specified, scrolls
to the microcode listing lqcation corresponding to the next microPC.

Console Commands

2-117

SCROLL

/PREVIOUS[=lines]
Valid only in microcode windows. Accurate only if the clocks are singlestepped. Scrolls the window backward the specified number (decimal) of
lines. If lines are not specified, scrolls the window to the microcode listing
location corresponding to the previous microPC.
/RIGHT[=columns]

Valid only in microcode windows. Scrolls the window to the right. The
default is eight columns.
/TO=address
Valid only in microcode and EXAMINE windows. Scrolls the window to
the microcode listing location corresponding to the specified hexadecimal
address.

/UP[=lines]
Scrolls the window up (backward). The default is six lines.

Parameters
window-name
The name of a window created by a CREATE/WINDOW command.

If a window is not specified and if the currently selected window type

supports the specified scrolling operation, the currently selected window
is scrolled.

2-118

Console Commands

SELECT

SELECT
Selects and optionally relocates and resizes a window. The command
window is resized as required. If screen mode is suspended (by SET
SCREEN OFF), it is automatically enabled.
NOTE

The command window cannot be selected.

Format
SELECT

[/NEXT] window-name [AT location]

Qualifier
/NEXT

Selects the next least-recently created window.
Parameters
window-name

The window to be selected. The specified window becomes the default
window for the SCROLL command, and the window name is highlighted
in the associated information line.

Console Commands

2-119

SELECT

location
The screen segment the window is to occupy, specified by one of the
following keywords:

Screen

Keyword

Segment

Keyword

Segment

Whole screen

H1
H2

First (upper) (D)
Second (lower)

T1
T2
T3

First (upper)
Second
Third (lower)

Q1
Q2
Q3
Q4

First (upper)
Second
Third
Fourth (lower)

The window is resized to conform to the new location. If the window type
does not support resizing, the command fails.

NOTE
The bottom five lines of the screen are reserved for the command
window.

2-120

Console Commands
SEND

SEND
Broadcasts a message to all terminals or a specified terminal.

Format
SEND

[/qualifier] [terminal-name] string

Qualifiers
/ALL
Broadcasts the message string to all terminals. If /ALL is specified, do
not specify the terminal-name parameter.
/BELL

Sends one bell character with the message.
/OPCOM

Sends the message through VMS to the operator communications
manager.

/URGENT

Appends an urgent header to the message.

Parameters
terminal-name

The terminal to receive the message. If /ALL is specified, do not specify
the terminal-name parameter.
string

The message text. It is limited to one line and is displayed on the line
following the SEND header. The header displays the message source,
urgency, and time.

Console Commands

2-121

SENSE

SENSE
Determines the configuration and current status of various VAX 9000
system components. During system initialization, the command options
determine the appropriate data files and configuration, and whether to

attempt a cold boot, warm boot, or hot boot.4
Format
SENSE

option

4 Command variants, of the form SENSE OPTION, are listed in the table of
contents and described separately on the following pages.

2-122

Console Commands
SENSE CLOCK

SENSE CLOCK
Reads the current state of the clock subsystem and the MCM revision and
serial numbers.

Format
SENSE CLOCK

Console Commands

2-123

SENSE CPU

SENSE CPU
Executes scan hard-core tests:

0 (SCI loopback)
1 (CD loopback)
4 (sense rings)
to determine the revision and configuration of the specified CPU. The
command destroys the state of the CPU scan subsystem and does not
execute if the CPU clocks are running.

Format
SENSE CPU

cpu-id

Parameters
cpu-id
The CPU to be sensed, specified by numeric literal 0, 1, 2, or 3.

2-124

Console Commands
E
SENS10

SENSE 10
Displays information about the I/O subsystem.
Format
SENSE 10

Console Commands

2-125

SENSE POWER

SENSE POWER
Reads the power subsystem status to determine the cabinet configuration,
BBU state, and power status. This information and the front panel
switches determine the power-on action.

Format
SENSE POWER

2-126

Console Commands
SENSE SCU

SENSE SCU
Executes scan hard-core tests:
0 (SCI loopback)
1 (CD loopback)
4 (sense rings)

to determine the revision and configuration of the SCU. This command
destroys the state of the SCU scan subsystem and does not execute if the
SCU clocks are running.

Format
SENSE SCU

Console Commands

2-127

SENSE SYSTEM

SENSE SYSTEM
Executes a SENSE POWER command followed by a SENSE CLOCK
command. This sets up the state of the clock and power subsystems
(which must be known before executing the SENSE CPU and SENSE
SCU commands). Next, each CPU and then the SCU are sensed.

Format
SENSE SYSTEM

/qualifiers

Qualifiers
/COMPARE

Compares the system part and serial number information to the saved
history records. If used with /LOG, any differences will be displayed.
/LOG
/NOLOG

Determines whether to display command results.

2-128

Console Commands

SET

SET
Defines or modifies characteristics of the processors or the service

processor (SPU) subsystem.?
Format
SET

option

> Command variants, of the form SET OPTION, are listed in the table of contents
and described separately on the following pages.

Console Commands

2-129

SET ATTN_ACTION

SET ATTN_ACTION
Defines a command to be executed when the scan subsystem generates an
unhandled scan attention.
Scan attentions are normally serviced by the error handling subsystem.
If an attention is not recognized, or the error handler is disabled, the
attention may be delivered to all CLI processes that have established an
ATTN_ACTION.

Format
SET ATTN_ACTION

command

Parameters
command
The command to be executed following a scan attention.

Example
>>>

SET

ATTN ACTION

@FIX IT

Executes the procedure FIX_IT.CMD following an unhandled scan
attention.

2-130

Console Commands
SET AUTOBOOT

SET AUTOBOOT
Controls the automatic bootstrap flags.
Format

SET AUTOBOOT

{ON/|OFF}

Parameters
ON|OFF

Determines whether automatic bootstrap is enabled (ON) or disabled
(OFF).

Console Commands

2-131

SET BI_DEVICES

SET BI_DEVICES
Loads the BI device names and IDs from the specified file.

Format
SET BI_DEVICES

[parameters]

Parameters
file-spec
Specifies a file that translates BI node IDs into device names. If file-spec
is not specified, the default file is [UCODE]IBI_DEVICES.DAT.

device[, ... ]
Specifies one or more devices. If not specified, the default file

[UCODEIBI_DEVICES.DAT is used.

2-132

Console Commands

SET BOOTFLAGS

SET BOOTFLAGS
Sets the default value of the bootstrap flags in R5.
Format
SET BOOTFLAGS

value

Parameters
value
A hexadecimal value to be loaded into R5.

Console Commands

2-133

SET BOOTSET

SET BOOTSET
Specifies the set of CPUs that operates in an SMP environment when the
system is next bootstrapped.

Format
SET BOOTSET

[qualifiers] cpu-id [, . . . ]

Qualifiers
/ENABLE=(cpu-id [, ... ])
Explicitly includes one or more CPUs in the boot set. To specify more
than one CPU, separate the CPU identifiers with commas and enclose the
list in parentheses.
/DISABLE=(cpu-id [, . .. ])
Explicitly excludes one or more CPUs in the boot set. To specify more
than one CPU, separate the CPU identifiers with commas and enclose the
list in parentheses.
/PRIMARY=cpu-id
Specifies the CPU to become the primary CPU when the system is next
bootstrapped. The specified CPU must be a member of the boot set.

Parameters
cpu-id
Specifies the CPUs that form the boot set. Included CPUs are enabled,
excluded CPUs are disabled.

CPUs are specified by numeric literals 0, 1, 2, and 3. If the primary CPU
is not specified (see /PRIMARY) or the previous primary is not available,
the lowest numbered CPU in the list becomes the primary CPU.

2-134

Console Commands

SET BOOTSET

Examples
>>>

SET

BOOTSET

0,1,2,3

In a quad CPU system, includes all available CPUs in the boot set. CPUO
is the boot primary by default.
>>>

SET

BOOTSET/PRIMARY=1

0,1

Includes CPUO and CPU1 in the boot set and specifies CPU1 as the boot
primary.

Console Commands

2-135

SET CLOCK

SET CLOCK
Modifies the state of the master clock subsystem.

Format
SET CLOCK

[/qualifiers] [ON(D)| OFF]

Qualifiers
/ATTENTION[=attention-name]

/NOATTENTION
Determines whether a clock subsystem fault is reported to the console as
an attention and entered in the error log. The attention-name argument
can be:
e

PHASE_ERROR

Indicates that a clock synchronization error exists between clock
distribution chips on the MCUs.
:
e

UNLOCKED_ERROR
Indicates that the master clock module (MCM) frequency synthesizer
has lost internal synchronization.

Both attentions are enabled by default.

/CPU=cpu-id
Specifies the CPU in which the clock subsystem is to be modified, where
cpu-id is one of the following:
0

ALL

AVAILABLE

BOOTPRIMARY

BOOTSET

PRIMARY

If a CPU is not specified, the default CPU’s clock subsystem is modified.
See Section 1.1.1.3 for more information on specifying a CPU. See the
SET CPU command description for more information on specifying the
default CPU.

2-136

Console Commands
SET CLOCK

/EMULATION
/NOEMULATION

When emulation is specified, MCM control is disabled and SCM driver
loopback functions are enabled for system testing.
/FREQUENCY=value

The frequency, in MHz, of the master clock.

The frequency value must be in the range of 332 to 5801¢. If the value is
not a multiple of four, the frequency is automatically rounded up to the
next higher multiple of four.

/INTERVAL=cycles

The interval, in machine cycles, during which system clocks are turned
off. For example, if cycles is 0, clocks are generated every machine cycle;
if cycles is 1, clocks are generated every other machine cycle.
The interval value must be in the range of 0 to 255,¢.
/LOG

/NOLOG

Determines whether an informational message is displayed when the
command is executed.
/POSITION=value

The position of reference clock relative to master clock. The position value
must be in the range of 0 to 10231¢.
CAUTION

This value is set during initialization and should not need to
be modified. If this value is 0, the MCM may not be able to
synchronize the main and reference clocks.

Console Commands

2-137

SET CLOCK

/SAMPLE_RATE=hertz
The sampling rate, in Hz, of the master-clock-to-reference-clock phase
alignment relationship. The rate argument can be one of the following:

OFF (disable the sample loop)
488

976
1950

The normal sampling rate is 488 Hz.

/SCU

/NOSCU
Specifies the system control unit clock group. Valid only when setting the
clock state on or off.
/SYNCH=synch-option
The control mode for master-clock-to-reference-clock phase alignment.
The synch-option argument can be one of the following:
e

AUTOMATIC

The MCM automatically controls the phase alignment.
¢

MANUAL

The console, through the MCM position register, controls the phase
alignment.
e

NONE

Phase alignment is disabled.

Parameters
ON|OFF
Turns clocks on or off in the specified CPU(s). If not specified, the clocks
are turned on.

2-138

Console Commands
SET CLOCK

Examples
>>>

SET

CLOCK

Starts the clock in the default CPU.
>>>

SET

CLOCK/CPU=ALL ON

Starts the clock in all available CPUs.
>>>

SET

CLOCK/CPU=(0,1)/SCU ON

Starts the clocks in CPUQ and CPU1 and in the SCU.
>>>

SET CLOCK/CPU=(0,1)/SCU OFF

Stops the clocks in CPU0Q and CPU1 and in the SCU.
>>>

SET

CLOCK/FREQUENCY=400

Sets the clock frequency to 400 MHz.
>>>

SET CLOCK/FREQ=401/LOG

$CLI-I-NOTMULT4,

specified frequency has been rounded to 404 MHz

Attempts to set a clock frequency that is not a multiple of 4 MHz. The
CLI displays an informational message and automatically rounds the
frequency up to the next multiple of 4 MHz. Note that /NOLOG would
inhibit the informational message.

Console Commands

2-139

SET COLD_START

SET COLD_START
Sets or clears the cold-start flag for the specified CPU. This command is
used primarily for debug.

Format
SET COLD_START

[/CPU=cpu-id] {ON|OFF}

Qualifier
/CPU=cpu-id
Specifies the CPU in which the cold-start flag is to be set or cleared,
where cpu-id is one of the following:
0

ALL

AVAILABLE

BOOTPRIMARY

BOOTSET

PRIMARY

If a CPU is not specified, the cold-start flag is set or cleared in the default
CPU

See Section 1.1.1.3 for more information on specifying a CPU. See the
SET CPU command description for more information on specifying the
default CPU.

Parameters
ON|OFF
Determines whether the cold-start flag is set.

2-140

Console Commands

SET COMMAND

SET COMMAND
Adds commands to the process command table.

Format
SET COMMAND

[/qualifiers] file-spec

Qualifiers
/CLEAR
/NOCLEAR
Clears the command tables.
/LOG
/NOLOG (D)
Determines whether to display memory and keyword usage for each new
command.

Parameters
file-spec
Specifies the name of a command definition file. The default file type is
.CLD.

Example
>>>

SET

COMMAND

TEST

Adds the commands in TEST.CLD to the process command table.

Console Commands

2-141

SET CPU

SET CPU
Specifies the default CPU for commands that reference a CPU.
Format

SET CPU

[/[NOJLOG] cpu-id

Qualifier
/LOG
/NOLOG

Determines whether to display command results.
Parameters
cpu-id

The default CPU. The cpu-id can be an integer value or symbolic name,
as follows:

Integer

0,1,2,0r3

BOOTPRIMARY

Next primary processor

PRIMARY

Current primary processor

NOTE

The SET CPU command does not allow a list of processors.
Examples
>>>

SET

CPU

0 .

Specifies CPUOQ as the default CPU.
>>>

SET

CPU

PRIMARY

Specifies the PRIMARY CPU as the default CPU.

2-142

Console Commands

SET CYCLE

SET CYCLE
Modifies the clock cycle counter.

Format
SET CYCLE

[Aqualifiers] count

Qualifiers
/CPU=cpu-id
The CPU in which the clock cycle counter is to be modified, where cpu-id
is one of the following:
0

ALL

AVAILABLE

BOOTPRIMARY

BOOTSET

PRIMARY

If a CPU is not specified, the default CPU’s clock cycle counter is modified.
See Section 1.1.1.3 for more information on specifying a CPU. See the
SET CPU command description for more information on specifying the
default CPU.

/INTERVAL=value
The number of time units per cycle.

/SCU
/NOSCU

Determines whether the system control unit clock cycle counter is
modified.

Console Commands

2-143

SET CYCLE

Parameters
count

The count to be loaded into the clock cycle counter.

The clock cycle counter is the time base for the SET TRACE and SET
PATTERN commands and is incremented each time the clock is stepped.
A null count clears the counter.

Examples
>>>

SET

CYCLE

Clears the clock cycle counter in the default CPU.
>>>

SET CYCLE/CPU=1/INTERVAL=1000

In CPU1, sets the clock cycle counter value to 1 and sets the interval to
1000.

2-144

Console Commands

SET DEFAULT

SET DEFAULT
Changes the default device and/or directory name. The new default is
applied to all subsequent file specifications that do not include a device or
directory name. A fatal message is displayed if the target directory does
not exist.

Format
SET DEFAULT

directory-spec]:]

Parameters
directory-specl:]
Specifies the device and/or directory name to be used as the default device
or directory in file specifications. Terminate a physical device name with
a colon (:). Enclose a directory name in brackets ([]). The relational
directory specifiers [-] or [--] can be specified to set default one level above
the current level. For example:
SET

DEFAULT

[-.FILES]

The device and directory can also be specified as a logical name. For
example:
SET

DEFAULT

SYSS$LOGIN

Examples
n

>>>

SET DEFAULT

[UCODE]

Changes the default directory to [UCODE]. The default device does not
change.
>>>

SET

DEFAULT

DISK2:

Changes the default device to DISK2. The default directory does not
change.
>>>

SET

DEFAULT

DISKO: [TEST]

Changes the default device to DISKO and the default directory to [TEST!.

Console Commands

2-145

SET ERROR_HANDLING

SET ERROR_HANDLING
Sets the state of the CPU/SCU error handling system.

Format
SET ERROR_HANDLING

[/qualifiers] {ON | OFF}

Qualifiers
/MATCH

/NOMATCH
Determines whether macroPC, microPC, and physical address match
handling for the CPUs is on or off. If /MATCH is specified and a match
condition is detected, the error handling system signals a match exception
to the CLI. If /NOMATCH is specified, detected match conditions are
treated as errors.
/RECOVERY
/NORECOVERY

Determines whether error recovery for the CPUs and SCU is enabled. If
/RECOVERY is specified, the error handling system attempts to recover
from any errors that occur. If
NORECOVERY is specified, error recovery
is not attempted and errors are signaled to the CLI.
/REPORTING
/NOREPORTING

Determines whether error log entries are generated for all recovered and
nonrecovered CPU and SCU errors.

Parameters
ON|OFF
Determines whether the CPU/SCU error handling system is on or off. If
error handling is ON, errors are reported as specified by the qualifiers. If
error handling is OFF, errors are reported to the CLI.

2-146

Console Commands
SET FAULT_ACTION

SET FAULT_ACTION
Specifies a command to be executed when an unhandled exception is
detected in the power subsystem.

Format
SET FAULT_ACTION

command

Parameters
command
Specifies the command to be executed following a power exception.

Power subsystem exceptions are normally serviced by the error handling
subsystem. If the error handler fails to recognize an exception or is
disabled, all CLI processes that established a POWER FAULT action are
notified.

Console Commands

2-147

SET ISOLATION

SET ISOLATION
Loads isolation data for the MCU tester.
Format

SET ISOLATION

[/qualifiers] file-spec

Qualifiers
/CPU=cpu-id

Specifies the CPU, where cpu-id is one of the following:

ALL

AVAILABLE

BOOTPRIMARY

BOOTSET

PRIMARY

If a CPU is not specified, the default CPU is selected.

See Section 1.1.1.3 for more information on specifying a CPU. See the
SET CPU command description for more information on specifying the
default CPU.
/LOG

Displays command results.
/SYBIL

Specifies isolation for SYBIL patterns.

Parameters
file-spec

The file containing the isolation data.

2-148

Console Commands

SET KEEP_ALIVE

SET KEEP_ALIVE
Controls the state of the SPU keep-alive monitor.

Format
SET KEEP_ALIVE

[/CPU=cpu-id] {ON | OFF | MANUAL}

Qualifier
/CPU=cpu-id
Specifies the CPU, where cpu-id is one of the following:
0

ALL

AVAILABLE

BOOTPRIMARY

BOOTSET

PRIMARY

If a CPU is not specified, the default CPU is selected.

See Section 1.1.1.3 for more information on specifying a CPU. See the
SET CPU command description for more information on specifying the
default CPU.

Parameters
ON|OFF | MANUAL
Determines whether the keep-alive monitors in the CPUs are enabled and
how the SCM polls the monitors.
If a keep-alive failureis detected when MANUALis enabled, the file

SYS$SYSTEM:KAF.CMDis executed.

If a keep-alive failureis detected when ON is enabled, the CLI handles
the failure internally by logging the error and rebooting the CPU.

Examples
>>>

SET

KEEP

ALIVE

Turns the keep-alive monitor on.
>>>

SET

KEEP_ ALIVE

OFF

Turns the keep-alive monitor off.

Console Commands

2-149

SET LABELS

SET LABELS
Appends bit-range labels to each line of data displayed by the SPU.

Format
SET LABELS

{ON/|/OFF}

Parameters
ON|OFF
Determines whether bit-range labels are displayed.

Example
>>>

SET

>>>

EXAMINE

LABELS

ECS([0]

%$CPUO.ECS[0]<145:0> = F9007702
>>>

SET

>>>

EXAMINE

LABELS

03621800

08601F00

0206942E

Bit

127:0

2C3F3

Bit

145:128

OFF

ECS[0]

%$CPUO.ECS[0]1<145:0> = F9007702

03621800

08601F00

0206942E
2C3F3

The labels indicate that the first line of data shows the value of bits 127
through 0, and the second line bits 145 through 128.

2-150

Console Commands

SET LOGGING

SET LOGGING
Opens a specified file and copies all terminal output to the file. Up to five
logging files can be open at the same time. The command does not affect
normal terminal output. All terminal output does not go to the logging
file. For example:
>>>

WRITE

SYS$SOUTPUT

"FOO"

will not go to the logging file.

Format

SET LOGGING

[/qualifiers] {ON|OFF}

Qualifiers
/ALL
Specifies that the command affects all log files.
/DISABLE

Temporarily disables output logging to the specified file(s). The file
remains open.

/ENABLE

Reenables output logging to the specified file(s).
/FILE][=file-spec]

The log file. If file-spec is not specified, the default is CONSOLE.LOG in
the current directory.
If /FILE is not specified, the output is sent to the printer port. SET
LOGGING ON enables the printer port and SET LOGGING OFF disables
the printer port.

Console Commands

2-151

SET LOGGING

Parameters
ON|OFF
Turns terminal output logging on and off. To turn off logging to a file, the
file must be specified exactly as it was when logging was enabled.

Examples
>>>

SET

LOGGING

Copies terminal output to remote printer port.
>>>

SET

LOGGING/FILE=[UCODE]UCODE.LOG

Copies terminal output to [UCODEJUCODE.LOG.

2-152

Console Commands

SET MESSAGE

SET MESSAGE
Determines the format for error, warning, and informational messages.
NOTE

At least one message field must be displayed. Specifying
/NOFACILITY/NOSEVERITY/NOIDENT/NOTEXT
displays all fields.
Format
SET MESSAGE

/qualifiers [file-spec]

Message Format
All messages from the SPU command language start with either a percent
sign (%) or a minus (-) in column 1. The percent sign denotes the start
of a message, the minus indicates message continuation. The message
format is:
$Facility-Severity-Ident,

Text

-Facility-Severity-Ident,

Text

where:
Field

Description

Facility

Three-character identification code for the facility that produced
the message. For example, CLI is the code for the command
language interpreter.

Severity

Single-character code for the message severity, as follows:
S = Success
I = Informational
W = Warning
E = Error
F = Fatal error

Ident

A variable-length, message-unique field. It is usually an acronym
for the message.

Text

A brief error description and possible remedy.

Console Commands
SET MESSAGE

Qualifiers
/FACILITY

/NOFACILITY
Determines whether the facility name prefix is displayed.
/ADENT

/NOIDENT
Determines whether the identification prefix is displayed.

/SEVERITY
/NOSEVERITY
Determines whether the severity level is displayed.

/TEXT

/NOTEXT
Determines whether the message text is displayed.

Parameters
file-spec
The current message file.

2-153

2-154

Console Commands
SET PATTERN

SET PATTERN
Specifies a set of signals that is driven by patterns in a file.
Format
[/qualifiers] pattern-name

SET PATTERN

[/qualifiers] signal-list

[/qualifiers] @file-name

/SYBIL pattern-name

Qualifiers
/ABSOLUTE

Sets absolute times. The time field is controlled by the count variable (see
SET CYCLE) and can specify an absolute or a relative count. Absolute
counts specify the time at which the pattern should be applied. Absolute
times less than the current count are discarded.
/ALL

Select all patterns. If /ALL is specified, do not specify the pattern-name
parameter.

/CPU=cpu-id

Specifies the CPU to which patterns are applied, where cpu-id is one of

the following:
0

ALL

AVAILABLE

BOOTPRIMARY

BOOTSET

PRIMARY

If a CPU is not specified, patterns are applied to the default CPU.
See Section 1.1.1.3 for more information on specifying a CPU. See the
SET CPU command description for more information on specifying the
default CPU.
/DISABLE

Disable the pattern. Patterns can be disabled to prevent signals from
being driven. The pattern definition is maintained and is resumed when
the pattern is enabled.

Console Commands

2-155

SET PATTERN

/ENABLE

Enable the pattern. When a pattern is enabled, patterns that appear
before the current time are discarded.
/FILE=file-name
The pattern file file-name.
/LOG
/NOLOG
Determines whether changes are displayed.
/NAME=pattern-name
Sets a pattern point name.

/ODOMETER[=window-name]
Displays changes in an odometer window.
/RELATIVE

Sets relative time. The time field is controlled by the count variable (see
SET CYCLE) and can specify an absolute or a relative count. Relative
counts are added to the current count to determine at which time the
pattern should be applied.
/SCU

/NOSCU

Determines whether pattern points apply to the system control unit.
/SYBIL

Remote patterns can be executed using the /SYBIL qualifier. The
SET/SYBIL command creates a network link to the node defined by
logical name SYBIL$NODE.
/VERIFY
/NOVERIFY

Determines whether to display a message when patterns are applied.

2-156

Console Commands
SET PATTERN

Parameters
signal-list
The signals to be driven. To specify more than 1 (up to 256) signal,
separate the signal names with commas, as follows:
>>>

SET

PATTERN

[/qualifiers]

signal-spec|[,signal-spec...]

The asterisk (*) wildcard character can be used to specify several likenamed signals. For example:
>>>

SET

PATTERN

[/qualifiers]

file-name

E3.*

The file containing the pattern.
pattern-name

The default pattern-name format is PATTERNdd, where dd is a decimal
number to make the name unique. The pattern can also be explicitly
named with the /NAME qualifier. When the pattern is established, it
must be referenced by its assigned name.
For SYBIL patterns, the pattern-name is part of the name of the file that
contains the patterns.

Description
The pattern file format is shown below:
!

Comments

Time

Signal

States

11100111111

11000111111

A pattern deletes itself when no more activity is scheduled.

Console Commands
SET PERSONAL_NAME

SET PERSONAL_NAME
Sets the user’s personal name for use with the MAIL command.

Format
SET PERSONAL_NAME

Parameters
quoted-string
A user-specified string.

quoted-string

2—-157

2-158

Console Commands
SET POWER

SET POWER
Modifies the state of the power subsystem.
The power subsystem is partitioned into voltage buses in processor
cabinets. The cabinets can be selected as a set to modify all voltage
groups within a cabinet, or each individual voltage can be modified.
Only the local CLI process can execute the SET POWER command.

Format
SET POWER

[qqualifiers] [ON| OFF]

Qualifiers
/BUS=bus-name
Specifies the power or I/0 buses affected by the command, as follows:
Table 2-13

System Power Buses

Bus

Model 200

Model 400

Name

Volts

Cabinet

Tester

+5.0

SCU

MCM

+5.0

BBU

None

-3.4

SCU/CPA

SCU

None

-5.2

SCU/CPA

SCU

None

-3.4

CPB

None

-5.2

CPB

None

-3.4

None

CPA

UNIT 0

-5.2

None

CPA

UNIT 0

-3.4

None

CPB

UNIT 1

-5.2

None

CPB

UNIT 1

Console Commands

2-159

SET POWER

Table 2-14

System I/O Buses

Bus Name

XMIA_7214A

XMIB_7214A

XMIA_7214B

XMIB_7214B

XMIA_7215A

XMIB_7215A

XMIA_7215B

XMIB_7215B

/CABINET=cabinet-id

The cabinets to which the command applies. The cabinet-ids represent

the buses that supply the cabinet (see /BUS).
Table 2-15

System Cabinets

Cabinet
ID

Model 200 Buses

Model 400 Buses

Tester
Buses

SCU

A,B,C D

A B, C,D

None

CPA

C,D

J, K

None

CPB

E,F

M, N

None

UNIT_0

None

J, K

UNIT_1

None

M, N

5VOLT

None

A B

/COUNTERS

Clears the counters in the power subsystem driver.

/A0

Modify the state of the I/O power supplies.

2-160

Console Commands

SET POWER

/MARGIN=margin-keyword
/NOMARGIN
Determines the voltage conditions for checking system operation. Margin
keywords are as follows:
HIGH
LOW
NOMINAL
NONE

Parameters
ON(D)| OFF
Turns power on or off. If not specified, the default is ON.

Console Commands

2-161

SET PROMPT

SET PROMPT
Defines a new string for the CLI command prompt.

Format
SET PROMPT

[prompt-string]

Parameters
prompt-string
Specifies the string to replace the default CLI prompt (>>>). The string
can consist of one or more ASCII characters. Any ASCII character can be
used in the string.
To include spaces or lowercase letters in the string, enclose the string
in quotation marks. Otherwise, letters are automatically converted to
uppercase, and leading and trailing spaces are removed.
If no string is specified, the default prompt is restored.
NOTE
The default prompt is required by some external utilities.

Example
>>>

What

SET

PROMPT

now?>

SHOW

18-MAR-1989

"What

now?>

TIME

10:29:15

The SET PROMPT command replaces >>> with what now?>.

2-162

Console Commands
SET RADIX

SET RADIX
Specifies a default radix for parsing numeric literals.
Format
SET RADIX

radix-name

Parameters

radix-name
The new default radix is specified by one of the following keywords:
HEXADECIMAL
DECIMAL
OCTAL
BINARY

The default radix is command-specific. In general, numbers that are
values for processor variables are hexadecimal and expression numbers
are decimal.

The default radix can be overridden on the command line by preceding
the numeric value with one of the following radix operators:
%D (decimal)
%0 (octal)
%B (binary)
%X (hexadecimal)

If the radix is other than hexadecimal, the specifier precedes displayed
numbers.

Console Commands

2-163

SET REMOTE

SET REMOTE
Controls access by the remote port. Only the local CLI process can
execute this command.

Format
SET REMOTE

[[NOJPASSWORD] [ON | OFF]

Qualifier
/PASSWORD=string
/NOPASSWORD
Determines whether a password is needed for remote port access.
The console software maintains one password for remote port access. The
password can be set only by the local CLI process and must be entered
before the remote port is allowed access to the CLI process. The password
is not displayed.

Parameters
ON|OFF
Enables or disables access by the remote port.

2-164

Console Commands

SET REVISION

SET REVISION
Sets the revision level of the operating system or planar.

Format
SET REVISION

[/qualifiers] revision-string

Qualifiers
/CPU=cpu-id

Valid only with /PLANAR. Specifies the CPU, where cpu-id is one of the
following:
0

ALL

AVAILABLE

BOOTPRIMARY

BOOTSET

PRIMARY

Specifies that the operating system’s revision is to be set.

/PLANAR

Specifies that the planar’s revision is to be set.
/SCcU

Valid only with /PLANAR. Specifies the SCU.

Parameters
revision-string
The operating system or planar revision level. For the planar, a single
letter in the range A to Z.

Console Commands

2-165

SET SCI

SET SCI
Sets the state of the scan control interconnect of a specific port.
The primary use of the SET SCI command is for debugging solid faults
in the scan distribution subsystem. Note that any intervening scan
commands, including SHOW CLOCK, potentially alter the state of the
SCI. If the SET SCI or SHOW SCI commands are in use, no other scan
activity should be allowed.

Format
SET SCI

[Qqualifiers]

Qualifiers
/BROADCAST={0]1}
/NOBROADCAST
Sets the SCI BDCST line to 1 to select all MCUs on a port for a specified
operation. Sets the SCI BDCST line to 0 to use the address on the SCI
SELECT lines.
/BYPASS={0/[1}

/NOBYPASS
Determines whether the port is in bypass mode. Sets the SCI BYPASS to
1 to bypass the extra latches in the data path or to 0 to use the latches.

If the port is not in bypass mode (/BYPASS=0), the command issues two
extra B-phase clocks to ensure that data is propagated to the output of
the two-stage delay in the SCM module. The two clocks are issued before
any specified clock options. For example:
>>>

SET

SCI/DATA=1/CLOCK=STEP
A

will cause the following sequence:
1.

Set data out to 1.

Issue two B-phase clocks.

Issue one A-phase clock.

Note that /CLOCK=FORCE_B will defeat this propagation and data out is
unpredictable.

2-166

Console Commands
SET SCi

Data in is latched by the two B-phase clocks and is reported as the latched
value, not the actual value of the line. Except when performing manual
port loopback tests, this command is expected, and highly recommended,
to be used with the port in bypass mode.

/CDS={0]1}

/NOCDS

Sets the SCI CDS line to 0 to hold the address on the SCD SCI SELECT
lines; sets the SCI CDS line to 1 to load the address.
/CLOCK=state

Sets the SCI clock to one of the following states for the current SCI
command. The clock function is always executed after any B-phase clocks

required to propagate data to the I/O pins.
State

Description

[NOJFORCE_A

[Clear or] set the SCI A CLK line.

[NOJFORCE_B

[Clear or] set the SCI B CLK line.

RUN

Free run both SCI CLK lines.

STEP

Step one cycle of both SCI CLK lines.

STEP_A

Step one cycle of the SCI A CLK line.

STEP_B

Step one cycle of the SCI B CLK line.

STOP

)

/DATA={0] 1}

Stop both SCI CLK lines.

Specifies the value on the SCI DATA IN line (this is data from the
SCM module). A two-stage timing delay in the SCI data path can be
disabled with the SCI BYPASS. To ensure that the data set with the
/DATA qualifier is propagated to the SCI pin, the SCM module issues two
B-phase clocks if SCI BYPASS is not asserted (see /BYPASS).

Console Commands

2-167

SET SCI

/DEFAULT
Overrides the value set with any other qualifier and sets the following
SCI lines to the state indicated:

SCI Line

State

SCI BDCST H, L

0,1

SCI BYPASS H, L

0,1

SCICDS H, L

0,1

SCIFCT1H,L

0,1

SCIFCTOH, L

0,1

SCI SEL 3 H, L

0,1

SCI SEL 2 H, L

0,1

SCISEL 1 H, L

0,1

SCISEL O H, L

0,1

SCIACLKH, L

0,1

SCIBCLKH, L

0,1

/FUNCTION=state
Sets the SCI FCT[1:0] lines to the specified state, as follows:

State

Description

NOP

Set FCT lines to 0 (NOP).

SCAN

Set FCT lines to 1 (SCAN).

STRAM_LOAD

Set FCT lines to 2 (STRAM_LOAD).

SCAN_LOAD

Set FCT lines to 3 (SCAN_LOAD).

2-168

Console Commands
SET SCI

/PORT=port-id

Specifies the port affected by the command where port-id is the port name
or number, as follows:
Port Name

Port Number

CPUO

CPU1

CPU2

CPU3

SCU

MCM

/SELECT={0|1}

Sets the SCI SELECT [3:0] lines to the specified value.

Console Commands

2-169

SET SCM

SET SCM
Controls operation of the scan control module.

Format
SET SCM

[qqualifiers]

Qualifiers
/ATTENTIONS=mask

/NOATTENTIONS
Allows the SCM to determine whether CPU and SCU attentions are
enabled. Mask bit 4 is for the SCU and bits [3:0] are for CPU3 through
CPUO. The INIT.CMD procedure sets up and controls the mask. This
qualifier does not control MCU attention enable bits and does not affect
MCM attentions.
/Bl_VERIFY
/NOBI_VERIFY

Determines whether the SCM verifies Bl transfers by comparing the
source and destination buffers after the transfer is complete. Verification

is normally disabled.

/BYPASS

/NOBYPASS (D)

Determines whether the SCI normal mode latches are enabled. Normally,
the latches are not bypassed. Bypass mode is only for diagnostic use, and
scan rates faster than 400 ns are not reliable in bypass mode.
/CACHE
/NOCACHE

Determines whether the SCM internal scan ring cache is enabled. When
/CACHE is specified, the SCM caches scan data to minimize scan 1/O
operations and to improve performance of error handling software and
initialization procedures. The cache is automatically swept when the
system clocks are started or when the cache is disabled.

2-170

Console Commands

SET SCM

/RATE=scan-rate
One of the following:
100NS (D)

200NS

300NS

800NS

1600NS

3200NS

400NS

EXTERNAL

The SCAN.CMD procedure selects the 100 ns default scan rate, which
should not be changed.

/SCAN_VERIFY
/NOSCAN_VERIFY
Determines whether the SCM verifies scan operations by performing a
pattern test on the target ring before applying scan-write data or after
reading scan-read data. Normally this feature is enabled.

/VECTOR_PROCESSOR=mask

/NOVECTOR_PROCESSOR
The mask indicates to the SCM which optional vector processor units are
present.

/VERIFY

/NOVERIFY
Controls the /SCAN_VERIFY and /BI_VERIFY qualifiers as a pair.

Console Commands

2-171

SET SCOPE

SET SCOPE
Sets the default scope for labels.

Format
SET SCOPE

/[NOJLOG label-spec

Qualifier
/LOG

/NOLOG
Determines whether to display command results.

Parameters
label-spec
Specifies a label name in the current model (current scope) or an absolute
label reference. A label specification can have one of the following forms:

Type

Format

Specifies a Label:

Absolute

%NET!].1abell.label]]

At the top level

Absolute

9%SCU[.label[.label]]

At the top level

Absolute

%CPUO[.1abel[.label]]

At the top level

Absolute

%CPU1][.1abel[.label]]

At the top level

Absolute

%CPU2[.1abel[.label]]

At the top level

Absolute

%CPU3|.1abel[ .label]]

At the top level

Relative

labell.label[.labell]

In this model

Indirect

-[.1abel[.label]]

In the model that contained
this model’s label

Relative and indirect references can appear anywhere in a label-spec (the
label-spec after %nnn is a relative specification). Absolute specifications
can appear only as the first label. Specifying CPUn rather than NET
overrides the default set with SET CPU. Specifying SCU rather than NET
is the only way to examine SCU signals as there is no SET DEFAULT
command for the SCU.

2-172

Console Commands

SET SCREEN

SET SCREEN
Controls the state of screen mode. Use the SHOW WINDOW command to
display the state of the screen.

Format
SET SCREEN

{ON/OFF}

Parameters
ON (D)
If the screen is off, creates the command window and sets it to the entire
screen. If the screen was suspended, it is refreshed.
When screen mode is on, the window manager controls the screen.
Input is restricted to the command window and the output from most
commands is displayed in the window. The command window is created
automatically when the screen is first turned on.
The CREATE/WINDOW command and various SET TRACE commands

turn screen mode on.
OFF
Suspends the screen and resets the scrolling region to the entire screen.
The windows are not deleted. Selecting a window or creating a new
window turns the screen on again.
When the screen is off, the screen scrolls normally, but window definitions
remain. The windows are updated and redisplayed when the screen is
again turned on.

Console Commands

2-173

SET SERIAL

SET SERIAL
Allows manual serial number entry for components that do not have
SPU-readable serial numbers. The SPU operating system saves this
information in data file SYS$SYSTEM:MANUAL.DAT, from which it is
retrieved by the SENSE command.
Format

SET SERIAL

/qualifiers 10-digit-serial-number

Qualifiers
/AIE

Specifies the serial number is for the SPU AIE (T'1034) adapter.

/AIO

Specifies the serial number is for the SPU AIO (T1031) adapter.

/CPU=cpu-id

Valid only with /PLANAR. Specifies the CPU, where cpu-id is one of the
following:

ALL

AVAILABLE

BOOTPRIMARY

BOOTSET

PRIMARY

If a CPU is not specified, the default CPU is selected.

See Section 1.1.1.3 for more information on specifying a CPU. See the
SET CPU command description for more information on specifying the
default CPU.
/DAC

Specifies the serial number is for one of the daughter array cards.

/IDENTIFIER=dac-number

Valid only with /DAC, dac-number is a decimal number in the range 0
through 15.

/PLANAR

Specifies the serial number is for the specified CPU or SCU planar

module.

2-174

Console Commands

SET SERIAL

/SCM
Specifies the serial number is for the SPU SCM (T2050) adapter.

/ScuU
Valid only with /PLANAR. Specifies the SCU.

Parameters
10-digit-serial-number
Specifies the serial number according to DEC STD 012 and as seen on
module serial number tags.

Console Commands

2-175

SET SNAPSHOT

SET SNAPSHOT
Enables or disables the snapshot function when a hardware keep-alive is
detected. The command can also be used to trigger a snapshot for testing
purposes or to enable snapshots to be taken from command procedures.
Format

[/qualifiers] {ON|OFF | TRIGGER}

SET SNAPSHOT
Qualifiers
/CPU=cpu-id

Specifies the CPU, where cpu-id is one of the following:

ALL

AVAILABLE

BOOTPRIMARY

BOOTSET

PRIMARY

If a CPU is not specified, the default CPU is used. See Section 1.1.1.3

for more information on specifying a CPU. See the SET CPU command
description for more information on specifying the default CPU.
/EXCLUDE=section

One of the following:
HISTORY
CONTEXT

LATCH

PCS

MCM

MICRO

PAMM

REVISION

SPU

STACK

/FILENAME-=file-spec

Specifies the name and type for the snapshot data file. The default

file-spec is SNAPSHOT.DAT.
/SELECT=section
One of the following:

CONTEXT

HISTORY

LATCH

MCM

MICRO

PAMM

PCS

REVISION

SPU

STACK

/SCU

/NOSCU

Specifies the system control unit.

2-176

Console Commands

SET SNAPSHOT

Parameters
ON
Enables the snapshot function.

OFF
Disables the snapshot function.
TRIGGER
Enables the snapshot function in command procedures and for testing.

Console Commands

2-177

SET SOURCE

SET SOURCE
Establishes a directory path for the CREATE/WINDOW/ECS command.
The directory path specifies the location of the MCR file for the currently
loaded microcode. It overrides the initial MCR file directory created at
assembly and contained in the microcode LOD file.
Format
SET SOURCE

directory

Parameters
directory

Specifies the location of the MCR file for the currently loaded microcode.

2-178

Console Commands
SET STEP

SET STEP
Sets the step characteristics that control the NEXT (macrostep) command.

Format
SET STEP

parameter

Parameters
INSTRUCTION(D)
NOINSTRUCTION
Determines whether results are to be displayed in assembler notation.

Console Commands

2-179

SET TERMINAL

SET TERMINAL
Specifies the characteristics of the specified terminal.
Format
SET TERMINAL

[/qualifiers] [terminal-name]

Qualifiers
/BROADCAST (D)

/NOBROADCAST
Determines whether the terminal can receive broadcast messages such as
SEND and exception messages.
/CPU=cpu-id

The CPU to which the terminal is logically connected in program I/O
(PIO) mode, where cpu-id is one of the following:
0

ALL

AVAILABLE

BOOTPRIMARY

BOOTSET

PRIMARY

If a CPU is not specified, the terminal is connected to the default CPU.
This qualifier is incompatible with any terminal characteristic qualifier.

See Section 1.1.1.3 for more information on specifying a CPU. See the
SET CPU command description for more information on specifying the
default CPU.

/DEVICE={LA100|VT200}

Specifies the terminal device type to the console software.
/ECHO (D)
/NOECHO

Determines whether the terminal echoes (displays) keyboard input.

2-180

Console Commands

SET TERMINAL

/EIGHTBIT
/NOEIGHTBIT
Determines whether the terminal uses 8-bit or 7-bit ASCII character
codes. If NOEIGHTBIT (7-bit code) is specified, the most significant bit is
forced to zero.
/ESCAPE
/NOESCAPE
Determines whether ANSI standard escape sequences transmitted from
the terminal are handled as a single multiple-character terminator.

If /ESCAPE is specified, the terminal driver checks escape sequences for
syntax before passing them to the program.

/KEYPAD={APPLICATION | NUMERIC)}
Determines the terminal’s keypad mode.
The /KEYPAD=APPLICATION qualifier sets the terminal keypad to
application mode to enable the DEFINE/KEY facility.

/PAGE=lines

Specifies the number of lines in a terminal page.
/PIO_PORT={OPAO|OPA1}
Determines to which port the console terminal is connected. OPAQ is the
normal console port and OPA1 is the remote port.

/PROGRAM
/NOPROGRAM
Causes the process to enter program I/O (PIO) mode. This qualifier is
incompatible with any terminal characteristic qualifier.
/TALK_MODE
/NOTALK_MODE
Determines whether the terminal accepts TALK requests.
/WIDTH=characters

Specifies the number of characters per terminal line.

Console Commands

2-181

SET TERMINAL

Parameters
terminal-name
Specifies the terminal affected by the command. If terminal-name is not
specified, the controlling terminal is affected.

Example
>>>

SET

TERMINAL/DEVICE=LA100

Establishes the console terminal as an LA100 and sets the default
characteristics for that terminal type.

2-182

Console Commands
SET TIME

SET TIME
Resets the system time.

Format
SET TIME

time-string

Parameters
time-string
A string in the format: "DD-MMM-YYYY HH:MM:SS.DD"
The string must be quoted if a new date is entered.

Examples
>>>

SET

TIME

03:21

Sets system time to 03:21. The date is unchanged.
>>>

SET

TIME

"18-Mar-1989

16:30"

Sets system date to 18-MAR-1989 and system time to 16:30.

Console Commands

2-183

SET TRACE

SET TRACE
Establishes, enables, or disables tracepoints for the specified list of scan
signals.
Use DELETE/TRACE to remove tracepoints and SHOW TRACE to
display tracepoint status.

Format
SET TRACE

signal-list
[qualifiers] @signal-file

Qualifiers
/ABSOLUTE
Specifies that times in comparison files (see /COMPARE) are absolute. the
clock cycle count (specified with /FROM) when signal

The /ABSOLUTE and /RELATIVE qualifiers are mutually exclusive.

/ALL

With /ENABLE or /DISABLE, enables or disables all tracepoints. If /ALL
is specified, do not specify /NAME.
/COMPARE

Compares the signals in a signal comparison file to the current machine
state. The signal comparison file is specified with /FILE.
/CPU=cpu-id
The CPU on which signals are to be traced, where cpu-id is one of the
following:
0

ALL

AVAILABLE

BOOTPRIMARY

BOOTSET

PRIMARY

If multiple CPUs are specified, a duplicate tracepoint is established on
each processor. If a CPU is not specified, signals are traced on the default
CPU.

See Section 1.1.1.3 for more information on specifying a CPU. See the
SET CPU command description for more information on specifying the
default CPU.

2-184

Console Commands
SET TRACE

/DISABLE

Temporarily inhibits trace reporting. The tracepoint definition is
maintained, but trace activity is suspended until the tracepoint is enabled.
/NAME specifies the tracepoint to be disabled.
/ENABLE

Enables reporting of a tracepoint.

/NAME specifies the tracepoint to be enabled.
/FILE=file-spec

Specifies the file to which trace results are sent, or a signal comparison

file (see /COMPARE).
/FROM=cycle

Tracing begins when the /FROM cycle count is reached, or immediately if
/FROM is not used. Tracing ends when the /TO count is reached or when
the trace is deleted with DELETE/TRACE.
/LOG
/NOLOG

Displays the result of the trace action.
/NAME-=tracepoint-name

The name assigned to a tracepoint when it is established, or the name of
a tracepoint to be enabled (ENABLE) or disabled (/DISABLE).
If /NAME is not specified when a tracepoint is established, the SET
TRACE command automatically assigns a name. If the name is already
in use, a warning message is issued.

Wildcard characters can be used when enabling or disabling similarly
named tracepoints.

If /ALL is specified, do not specify /NAME.

/ODOMETER[=0dometer-window-name]

Creates an odometer window to display trace activity, or assigns a
previously created window (CREATE/WINDOW/ODOMETER) to the
tracepoint.

If /ODOMETER is specified without a window name, the SET
TRACE/ODOMETER command automatically assigns a name.

Console Commands

2-185

SET TRACE

/RELATIVE
Specifies that times in comparison files (see /COMPARE) are relative (can
be forced by preceding the time with a plus (+).)
/ABSOLUTE and /RELATIVE are mutually exclusive.

/SCU
/NOSCU

Determines whether tracepoints apply to the system control unit.
/TO=cycle
Tracing begins when the /FROM cycle count is reached, or immediately if
/FROM is not used. Tracing ends when the /TO count is reached or when
the trace is deleted with DELETE/TRACE.

/VECTOR
Creates a file and outputs the traced signal values and times to the file.
The file can be used with SET TRACE/COMPARE and SET PATTERN
commands.

Parameters
signal-file
The file that lists the signals to be traced. The at sign (@) is required to
denote a signal-file. For example:
>>>

SET

TRACE

[/qualifiers]

@SIGNALS

signal-list
The signals to be traced. To specify more than 1 (up to 256) signal,
separate the signal names with commas, as follows:
>>>

SET

TRACE

[/qualifiers]

signal-spec|,signal-spec...]

The asterisk (*) wildcard character can be used to specify several like
named signals. For example:
>>>

SET

TRACE

[/qualifiers]

E3.*

2-186

Console Commands
SET TRACE

Description
A single tracepoint can identify up to 256 signals, either directly on the
command line or through a file.
When a tracepoint is established, traced signals are monitored after each
step of the clock in the selected processor(s). Signals that change state
between clock steps are displayed on the terminal.
Tracepoints are evaluated only when the clock is single-stepped as a
result of a MICROSTEP command; MICROSTEP/BURST does not display
signal transitions. The trace action is executed before the completion of
the MICROSTEP command.

The /FROM and /TO qualifiers specify the starting and ending clock cycle
counts between which tracing occurs. See also the SET CYCLE command
description.
Signals can be simultaneously traced (and/or watched) by all users
(tracepoint tables are shared resources).

Console Commands

2-187

SET VERIFY

SET VERIFY
Determines whether command and data lines from command procedures
are displayed at the terminal.
Format

SET VERIFY

{ON/OFF}

Parameters
ON(D) | OFF
Turns verification on and off.

SET VERIFY ON causes commands in command procedures to be
displayed as they are executed. SET VERIFY OFF cancels this action.

2-188

Console Commands
SET WARM_START

SET WARM_START
Sets or clears the warm-start flag for the specified CPU. This command is
used primarily for debug.

Format
SET WARM_START

[/CPU=cpu-id] {ON | OFF}

Qualifier
/CPU=cpu-id
Specifies the CPU in which the warm-start flag is to be set or cleared,
where cpu-id is one of the following:
0

ALL

AVAILABLE

BOOTPRIMARY

BOOTSET

PRIMARY

If a CPU is not specified, the warm-start flag is set or cleared in the
default CPU

See Section 1.1.1.3 for more information on specifying a CPU. See the
SET CPU command description for more information on specifying the
default CPU.

Parameters
ON | OFF
Determines whether the warm-start flag is set.

Console Commands

2-189

SET WATCH

SET WATCH
Establishes, enables, or disables watchpoints for the specified list of scan
signals.

Use DELETE/WATCH to remove watchpoints and SHOW WATCH to
display watchpoint status.

Format

SET WATCH

signal-list
[qqualifiers] @signal-file DO command

Qualifiers
/ALL

With /ENABLE or /DISABLE, enables or disables all watchpoints. If /ALL
is specified, do not specify /NAME.
/CPU=cpu-id

The CPU on which signals are to be watched, where cpu-id is one of the

following:

ALL

AVAILABLE

BOOTPRIMARY

BOOTSET

PRIMARY

If multiple CPUs are specified, a duplicate watchpoint is established on
each processor. If a CPU is not specified, signals are watched on the
default CPU.

See Section 1.1.1.3 for more information on specifying a CPU. See the
SET CPU command description for more information on specifying the
default CPU.

/DISABLE

Temporarily inhibits watch reporting. The watchpoint definition is
maintained, but watch activity is suspended until the watchpoint is
enabled.

/NAME specifies the watchpoint to be disabled.
/ENABLE

Enables reporting of a watchpoint.

/NAME specifies the watchpoint to be enabled.

2-190

Console Commands
SET WATCH

/FROM=cycle
Watching begins when the /FROM cycle count is reached, or immediately
if /FROM is not used. Watching ends when the /TO count is reached or
when the watch is deleted with DELETE/WATCH.

/LOG
/NOLOG
Displays the result of the watch action.
/NAME=watchpoint-name
The name assigned to a watchpoint when it is established, or the name of
a watchpoint to be enabled /(ENABLE) or disabled (/DISABLE).
If /NAME is not specified when a watchpoint is established, the SET
WATCH command automatically assigns a name. If the name is already
in use, a warning message is issued.

Wildcard characters can be used when enabling or disabling similarly
named watchpoints.
If /ALL is specified, do not specify /NAME.

/SCU

/NOSCU
Determines whether watchpoints apply to the system control unit.

/TO=cycle
Watching begins when the /FROM cycle count is reached, or immediately
if /FROM is not used. Watching ends when the /TO count is reached or
when the watch is deleted with DELETE/WATCH.

Parameters
signal-file
The file that lists the signals to be watched. The at sign (@) is required to
denote a signal-file. For example:
>>>

SET

WATCH

[/qualifiers]

Q@SIGNALS

[command]

signal-list
The signals to be watched. To specify more than 1 (up to 256) signal,
separate the signal names with commas, as follows:
>>>

SET

WATCH

[/qualifiers]

signal-spec[,signal-spec...]

[command]

Console Commands

2-191

SET WATCH

Several like-named signals can be specified with the asterisk (*) wildcard
character. For example:
>>>

SET

WATCH

[/qualifiers]

E3.*

[command]

command

A command to be executed following a state transition of any watched
signal. The command can be any single line SPU command, including no
command, or a command procedure.
Description
A single watchpoint can identify up to 256 signals, either directly on the
command line or through a signal-file.
When a watchpoint is established, watched signals are monitored after
each step of the clock in the selected processor(s). Signals that change
state between clock steps cause the command entered on the SET WATCH
command line to be executed.

Watchpoints are evaluated only when the clock is single-stepped as a
result of a MICROSTEP command; MICROSTEP/BURST does not apply
to watchpoints. The watch action is executed immediately after the
MICROSTEP command completes.

/FROM and /TO specify the starting and ending clock cycle counts
between which watch activity is to take place. See also the SET CYCLE
command description.

Signals can be simultaneously watched (and/or traced) by all users
(watchpoint tables are shared resources).

2-192

Console Commands
SET XMI_DEVICES

SET XMI_DEVICES

Loads the XMI device names and IDs from the specified file.
Format
SET XMI_DEVICES

[file-spec]

Parameters
file-spec
Specifies a file that translates XMI node IDs into device names. If filespec is not specified, the default file is [UCODE]XMI_DEVICES.DAT.

Console Commands

2-193

SHOW

SHOW
The SHOW option command displays characteristics of the processors or

the service processor (SPU) subsystem.®
Format
SHOW

options

6 Command variants, of the form SHOW OPTION, are listed in the table of
contents and described separately on the following pages.

2—-194

Console Commands
SHOW ATTN_ACTION

SHOW ATTN_ACTION
Displays the command to be executed when the scan attention interrupt
is delivered to the CLI.
The scan attention interrupt is delivered to the CLI only if error handling
is disabled. For debug purposes, this function provides the means to
execute a command procedure and save system failure data; this function
is not used by the SPU error handling subsystem.

Format
SHOW ATTN_ACTION

Example
>>>

show

attn action

ATTN ACTION

currently

specified

>>>

The SHOW ATTN_ACTION command display.

Console Commands

SHOW AUTOBOOT

SHOW AUTOBOOT
Shows the state of the automatic bootstrap flags.

Format
SHOW AUTOBOOT

Example
>>>

show

autoboot

CPU

Auto

Boot:

ENABLED

CPU

Auto

Boot:

ENABLED

CPU

Auto

Boot:

ENABLED

CPU

Auto

Boot:

ENABLED

>>>

The SHOW AUTOBOOT command display.

2-195

2-196

Console Commands
SHOW AVAILABLE

SHOW AVAILABLE
Displays the set of processors passed to the operating system for inclusion
in the symmetrical multiprocessor (SMP).

Format
SHOW AVAILABLE

Example
>>>

show

available

CPUOC
>>>

The SHOW AVAILABLE command display.

Console Commands
SHOW BATCH

SHOW BATCH
Displays the state of the batch streams.

Format
SHOW BATCH

Example
>>>

SHOW

BATCH

EWBAA

Ratch

20-AUG-1989

Process

Jobs

13:50:12.43

Username

Port

CONSOLE

001100CD

Status

Executing

/LOG=DUA50: [CONSOLE]TEST.LOG
DUA5Q: [CONSOLE]TEST.CMD

The SHOW BATCH display format.

2-197

2-198

Console Commands
SHOW BBU

SHOW BBU
Shows the state of the battery backup unit.
Format
SHOW BBU

Example
>>>

show bbu

BBU 1:

Available,

Charged

BBU

Available,

Charged

>>>

The SHOW BBU command display.

Console Commands

2-199

SHOW BI_DEVICES

SHOW BI_DEVICES
Displays the node names and device types for all devices loaded with the
SET BI_DEVICES command.

Format
SHOW BI_DEVICES

2-200

Console Commands

SHOW BOOTFLAGS

SHOW BOOTFLAGS
Shows the setting of the permanent bootstrap flags.

Format
SHOW BOOTFLAGS

Example
>>>

show

Boot

bootflags

flags:

00000000

>>>

The SHOW BOOTFLAGS command display.

Console Commands

2-201

SHOW BOOTSET

SHOW BOOTSET
Displays the current definition of the boot set.

The boot set is the set of processors that are available to execute the
operating system. The boot set is displayed as a list of CPUs.
Format
SHOW BOOTSET

Example
>>>

SHOW

CPUO,

BOOTSET

CPU1l,

CPU3

>>>

The bootset includes CPU0, CPU1, and CPUS3.

2-202

Console Commands

SHOW CLOCK

SHOW CLOCK
Displays the current state, frequency, and period of the clocks to each
module.

Format
SHOW CLOCK

[/FULL]

Qualifier
/FULL
Displays additional information about the internal state of the clock
module, as follows:
Frequency
Period
Interval
Phase-locked loop (PLL) status
Phase control and current phase register contents

Example
>>>

show

clock

CPUO

CrpU1l

Stop

CPU2

CPU3

SCU

Stop

Run

Frequency

500MHz

Cycle

16.000ns

time

>>>

The SHOW CLOCK command display.

Console Commands

2-203

SHOW CONFIGURATION

SHOW CONFIGURATION
Displays the configuration of various system components. The command
can display the version and type of all components as well as the serial
number for most components.

The configuration of all system components is saved in a history file when
system power is turned on. History file data can be displayed with the

/DATE qualifier.

Format
SHOW CONFIGURATION

/qualifiers

Qualifiers
- /CLOCK
Displays the configuration of the clock subsystem.
/CPU=cpu-id

Displays the configuration of the specified CPU, where cpu-id is one of the
following:
0

ALL

AVAILABLE

BOOTPRIMARY

BOOTSET

PRIMARY

If a CPU is not specified, the default CPU’s configuration is displayed.
See Section 1.1.1.3 for more information on specifying a CPU. See the
SET CPU command description for more information on specifying the
default CPU.

The configuration is displayed in the following format:
MCU

NAME

REVISION

00+

ABC

0000

01+

DEF

0000

02+

XYZ

0000

NOTE

TYPE

SERIAL

A plus (+) following the MCU ID indicates self-test passed; a
minus (-) indicates self-test failed.

2—-204

Console Commands

SHOW CONFIGURATION

/DATE=date

Displays the configuration for the specified date, where dateis a quoted
string or an unquoted field.

/[
Displays the I/0 configuratlon of all four XMI buses and any BI buses
connected to the XMI bus, in the following format:
XJA

XMI

TYPE

NAME

VERSION

IDENTIFIER

07+

0C04

XWATCH

FFFF

NOT AVAILABLE

OD+

2001

DWMBA/A

0000

NOT AVAILABLE

O0E+

2001

DWMBA/A

0000

NOT AVAILABLE

07+

0C04

XWATCH

FFFF

NOT

0D+

2001

DWMBA/A

0000

NOT AVAILABLE

OE+

2001

DWMBA/A

0000

NOT AVAILABLE

XJA

XMI

TYPE

NAME

VERSION

IDENTIFIER

01+

2107

DWMBA/B

0000

NOT AVAILABLE
NOT AVAILABRLE

S/N

BASE

S/N

BASE

S/N

BASE

S/N

BASE

S/N

BASE

AVAILABLE

06+

410E

TBK50Q

0000

XJA

XMI

TYPE

NAME

VERSION

IDENTIFIER

01+

2107

DWMBA/B

0000

NOT

06+

410E

TBK50

0000

NOT AVAILABLE

XJA

XMI

TYPE

NAME

VERSION

IDENTIFIER

01+

2107

DWMBA/B

0000

NOT AVAILABLE
NOT AVAILABLE

AVAILABLE

06+

410E

TBK50

0000

XJA

XMI

TYPE

NAME

VERSION

IDENTIFIER

01+

2107

DWMBA/B

0000

NOT

AVAILABLE

06+

410E

TBK50

0000

NOT

AVAILABLE

NOTE
A plus (+) following the node or XBI ID indicates self-test passed;
a minus (-) indicates self-test failed.

/KERNEL
Displays kernel configuration.

/MCU=mcu-id
Displays information about the specified MCU.

/MEMORY
Displays memory configuration.

/OUTPUT=file-spec
Outputs the command results to the specified file. The default is the

current terminal name.

Console Commands
SHOW CONFIGURATION

2-205

/POWER

Displays power subsystem configuration in the following format:
NODE
0+
11+
12+
13+
21+
22+
23+

TYPE
....
....
....
....
....
....
....

NAME
PEM
RIC
RIC
RIC
RIC
RIC
RIC

EPROM

EEPROM

VERSION
31
31
31
31
31
31
31

(
(
(
(
(
(
(

49)
49)
49)
49)
49)
49)
49)

VERSION

31 ( 49)
31 ( 49)
31 ( 49)
31 ( 49)
31 ( 49)
31 ( 49)
31 ( 49)

SERIAL NUMBER

ceecieieaeann
c.iieeeeenn.n
i
iceeaeeneenn
e eieieeaaann
.ieeieaeienen
aeeiiieaeean

NOTE

A plus (+) following the RIC ID indicates self-test passed; a minus
(-) indicates self-test failed.

/RINGS

Displays testing and CDB ring lengths.
/SCU

Displays the configuration of the SCU in the following format:
MCU

00+
01+

TYPE

02+

NAME

REVISION

XYZ

0000

ABC
DEF

SERIAL

0000
0000

NOTE

A plus (+) following the MCU ID indicates self-test passed; a
minus (-) indicates self-test failed.
/SPU

Displays the configuration of the installed SPU modules, in the following
format:

NODE
02+
06+
07+
OA+

TYPE
0120
0121
410F
410D

NAME
SPM
SCM
DEBNA
KFBTA

VERSION
0)
0000
55)
0037 (
0248 ( 584)
75)
004B (

IDENTIFIER
T2051-00.A
T2050-00.A
T1034-00.C
T1031-00.A

NOTE

S/N

BASE
20004000
2000C000
2000E000
20014000

A plus (+) following the node ID indicates self-test passed; a
minus (-) indicates self-test failed.

2-206

Console Commands
SHOW CONFIGURATION

/SYSTEM
Displays the system cabinet configuration in the following format:
System

Configuration

System type:

UNKNOWN

CPA Cabinet:

Absent

CPB Cabinet:

Absent

I0OA Cabinet:

Absent

IOB Cabinet:

Absent

SCU Cabinet:

Absent

CPU

Absent

CPU

Absent

CPU 2:

Absent

CPU 3:

Absent

SCuU:

Absent

XJA

Absent

XJA

Absent

XJA 2:

Absent

XJA 3:

Absent

MMU

Absent

MMU

Absent

Summary

/XMi=xmi-id
Displays the configuration of the installed XMI modules, in the following
format:
XJA

XMI

TYPE

NAME

VERSION

IDENTIFIER

S/N

BASE

A plus (+) following the node ID indicates self-test passed; a
minus (-) indicates self-test failed.

Console Commands

2-207

SHOW CPU

Displays the current default CPU or the state of the CPU(s).
Format

SHOW CPU

[/qualifiers] [cpu-id]

Qualifiers
/ALL

Displays the state of all CPUs.
/FULL

Displays the state of the default CPU.
Parameters
cpu-id

Specifies the CPU. If not specified, the default CPU’s state is displayed.
See Section 1.1.1.3 for more information on specifying a CPU. See the
SET CPU command description for more information on specifying the
default CPU.

2-208

Console Commands
SHOW CPU

Examples
fl

>>>

SHOW

CPU

Default

CPU

Displays the default CPU.
>>>

SHOW

CPU

CPU/FULL

present

and has

CDB

file

loaded

Unit

revision:

AQO

Unit

CDB

DUAS50: [UCODE]CPUAOO.CDB

VBOX:

Unit

file:

Available

state

flags:

Power

Not

Broken

Not

Initialized

Clocks

Not

Running

Hard

Core

Pattern

Not

Test

Executed
Not

Executed

Displays the default CPU’s status.

Console Commands

2-209

SHOW CYCLE

SHOW CYCLE
Displays the current cycle counter for the specified CPU. The interval is
multiplied by the cycle count to determine the time. This is used with
TRACE and PATTERN points.

Format
SHOW CYCLE

[qualifiers]

Qualifiers
/CPU=cpu-id
The CPU containing the cycle counter to be displayed, where cpu-id is one
of the following:
0

ALL

AVAILABLE

BOOTPRIMARY

BOOTSET

PRIMARY

If a CPU is not specified, the default CPU’s cycle counter is displayed.
See Section 1.1.1.3 for more information on specifying a CPU. See the
SET CPU command description for more information on specifying the
default CPU.
/SCU
/NOSCU

Determines whether to display the system control unit cycle counter.

Example
>>>

SHOW

Cycle

CYCLE

Interval

1000,

Time

5000

for

CPU

Shows cycle for the default CPU. The cycle count is always a decimal
value.
>>>

SHOW CYCLE/SCU

Cycle

Interval

1000,

Cycle

Interval

Time

=
0

5000
for

Shows cycle for the default CPU and SCU.

for

SCU

CPU

2-210

Console Commands
SHOW DEFAULT

SHOW DEFAULT
Displays the current default directory specification.

Format
SHOW DEFAULT

Example
>>>

SHOW

DEFAULT

DISKSHARD: [SYS4.CONSOLE]

The default directory is the CONSOLE subdirectory of the SYS4 directory

on device DISK$HARD.

Console Commands

2-211

SHOW DEVICE

SHOW DEVICE
Displays the status and interrupt level of devices known to the service
processor operating system.

Format
SHOW DEVICE

[device-name]

Description
Physical device information is not available to the command language
interpreter (CLI). A device is considered off-line if the device driver is
not present or if the device was not configured in the system. A device is
on-line if the driver is present and the device can be accessed.
Network terminal devices (RTA) are considered on-line if the specified
unit is in use. The base device (RTAQ) status is the same as for other
devices.

If the drive is present and mounted, disk volumes are shown as mounted
with the volume name free block count. Tape volumes cannot be displayed
and volume names are not available.

Parameters
device-name
Displays the status and interrupt level of the specified device. The device
name is assumed to end with * (asterisk wildcard). Therefore:
>>>

SHOW

DEVICE

displays information on all devices with names that start with d.

2-212

Console Commands

SHOW DEVICE

Display Format

>>>

SHOW

DEVICE

Device

Driver

Volume

Free

Total

Name

Status

Name

Blocks

DISKS$SHARD

105840

136408

DUAS0

Mounted

DUAS1

Offline

puas2

Offline

Driver

DUAS3

Offline

VMAS0

Online

Device

Driver

Name

Status

IPL

Online

MUA7

Device

Driver

Name

Status

PRINTER

Online

CONSOLE

Online

REMOTE

Online

RTAQ

Online

RTAl

Online

RTA2

Offline

RTA3

Offline

RTA4

Offline

Device
Name

Driver
IPL

Driver
Status

XBA

Online

PCS

Online

SJA

Online

SCM

Online

The devices are displayed in groups, as follows:

Disk devices

Tape devices

Terminal devices

Generic devices

Console Commands

2-213

SHOW ENVIRONMENT

SHOW ENVIRONMENT
Displays the environmental conditions of the system.

Format
SHOW ENVIRONMENT

[fqualifiers]

Qualifiers
/CONTINUOUS
Causes the display to be refreshed every 2 seconds or at intervals specified
with the /INTERVAL qualifier.
/AINTERVAL=seconds
Specifies the continuous display refresh interval in seconds.

/OUTPUT=file-spec
Specifies the file to which the information is to be written.

Display Format

>>>SHOW

ENVIRONMENT

WCUO0

WCU1

AIR

SCU

CrPA

CPB

AIR

INLET

TEMP

STATUS
OUTLET

TEMP

STATUS

22.87C

00.00C

NOM

OPEN

STATUS

OUTLET

TEMP

STATUS

00.00C

28.72C

00.00C

NOM

OPEN

00.00C
OPEN

23.75C

00.00C

WARM

NOM

22.74C

00.00C

WARM

NOM

FLT

AIR

FLOW

RUN

AIR

FLOW

STATUS
WCU

TEMP

23.18C

FAN

TEMP

STATUS

FAN

TEMP

STATUS

NOM

COOLANT
INLET

FAN

TEMP

STATUS
AMBIENT

STATUS

28.10C

00.00C

NOM

OPEN

00.00C
NOM
00.00C

NOM

STATUS

STATE

PUMP

BLOWER A

RUN

AIR FLOW

AIR

FLOW

AIR FLOW

PRESSURE

AIR FLOW

LEVEL

FLOW

DETECT

BLOWER

PAN

Temperature sensors and status information for each cabinet are
displayed.

2-214

Console Commands
SHOW ERROR_HANDLING

SHOW ERROR_HANDLING
Shows the current error handling settings.
Format

SHOW ERROR_HANDLING
Examples
B

>>> show error handling
System Error Handling Statistics
Options

State:

DISABLED

Recovery:

ENABLED

Reporting:

ENABLED

Match Detect:

ENABLED

Error

interval:

Cache

Threshold:

VBOX Threshold:

CPU Threshold:

>>>

The SHOW ERROR_HANDLING command display.

Console Commands
SHOW FAULT_ACTION

SHOW FAULT_ACTION
Displays the command executed when the power fault interrupt is
delivered to the CLI. This function is for debug purposes and is not
used by the SPU error handling subsystem.

Format
SHOW FAULT _ACTION

Example
>>>

show

fault

action

FAULT ACTION

currently

specified

>>>

The SHOW FAULT_ACTION command display.

2-215

2-216

Console Commands

SHOW FLAGS

SHOW FLAGS
Displays the state of the cold-start and warm-start flags for each CPU.
This command is used for debug.

Format
SHOW FLAGS

[/CPU=cpu-id]

Qualifier
/CPU=cpu-id
Displays flags of the specified CPU, where cpu-id is one of the following:
0

ALL

AVAILABLE

BOOTPRIMARY

BOOTSET

PRIMARY

If a CPU is not specified, the default CPU’s flags are displayed.
See Section 1.1.1.3 for more information on specifying a CPU. See the
SET CPU command description for more information on specifying the
default CPU.

Example
>>>

SHOW

CPU

WARM

FLAGS

Boot

Flags

START:

OFF

COLD START:

OFF

Both flags are off.

Console Commands

2-217

SHOW HISTORY

SHOW HISTORY
Displays the contents of the PC history file in the specified EBox.

Format
SHOW HISTORY

[qualifiers]

Qualifiers
/BINARY

/NOBINARY
Determines whether the history buffer is output to a binary file. The

default file is SYS$SLOGIN:HISTORY.DAT.

/CPU=cpu-id

Displays the specified CPU’s history buffer, where cpu-id is one of the
following:
0

ALL

AVAILABLE

BOOTPRIMARY

BOOTSET

PRIMARY

If a CPU is not specified, displays the default CPU’s history buffer.

See Section 1.1.1.3 for more information on specifying a CPU. See the
SET CPU command description for more information on specifying the
default CPU.
/AINSTRUCTION

/NOINSTRUCTION

Specifies whether the contents of memory at the saved address is to be
decoded and displayed in assembler mnemonics.
/MAXIMUM-=locations

Specifies the maximum number of locations to display. The default is the
last 16 locations.
/OUTPUT=file-spec

Saves the history buffer in the specified file rather than displaying it.
/PHYSICAL

Soecifies that history buffer addresses are physical addresses.

2-218

Console Commands

SHOW HISTORY

/SCU
/NOSCU
Determines whether to display the system control unit history buffer.
/VIRTUAL

Specifies that history buffer addresses are virtual addresses. The SPU
assumes that the current process is the process recorded in the history
file.
/WINDOW[=window-name]
Specifies the window in which the history buffer is to be displayed.

Example
>>>

show

history

for

CPU

(starting with

8022DF9B
8022DF
9D
8022DFAD

8022E17E
8022E182
8022E188
8022E18F
8022E1B3

8022E1B8
8022E1BA

8022E1BF
8022E1C5

8022E1CA
8022E1CC

8022E1CE
8022E1D3
>>>

The SHOW HISTORY command display.

oldest

PC)

Console Commands

2-219

SHOW ISOLATION

SHOW ISOLATION
This command is for use with the two-hole tester and the SYBIL process.
It displays the isolation data that has been loaded for each MCU and
CPU. It can also display the isolation data for a specific bit in the
broadcast ring.

Format
SHOW ISOLATION

/qualifiers [broadcast-ring-bit-number]

Qualifiers
/CPU=cpu-id
Specifies the CPU, where cpu-id is one of the following:
0

ALL

AVAILABLE

BOOTPRIMARY

BOOTSET

PRIMARY

If a CPU is not specified, the default CPU is used.

See Section 1.1.1.3 for more information on specifying a CPU. See the
SET CPU command description for more information on specifying the
default CPU.
/MCU=mcu-id

Displays the isolation data that has been loaded for the specified MCU.

/SYBIL
Displays the SYBIL isolation data that has been loaded.

Parameters
broadcast-ring-bit-number
Displays the isolation data for the specified broadcast ring bit. For
example:
>>>

>>>

SHO

ISOLATION

Flex:

FP4.67,

Flex:

FP4.203,

Flex:

FP4.67,

Flex:

FP4.203,

Bit:
Bit:

MCU:

710,

MCU:

710,

MCU:

Unit:
1,

Unit:
0,

Unit:

(SYB4
IO PIN H<92>)
O

(SYBl_IO_PIN_H<80>)

(SYB4
IO PIN H<92>)
O

(SYBl
IO PIN H<80>)

2-220

Console Commands
SHOW KEEP_ALIVE

SHOW KEEP_ALIVE
Displays the state of the keep-alive monitor.

Format
SHOW KEEP_ALIVE

Example
>>>

show

keep alive

Keep Alive Monitor
Options

State

CPU

MANUAL

CPU

MANUAL

CPU

MANUAL

CPU

MANUAL

>>>

Displays state of keep-alive monitor.

Console Commands

2-221

SHOW KEY

SHOW KEY
Displays the DEFINE/KEY definition of the specified key.
Format
SHOW KEY

[/ALL] [key-name]

Qualifiers
/ALL
Displays the definition of all keys defined with the DEFINE/KEY
command. If /ALL is specified, do not specify the key-name parameter.
/FULL

Displays the flags associated with the key definition. For example:
>>>

SHOW

KEY

MINUS =
>>>

MINUS

SC/TO:SIGNAL("CS["

'UPC()’

"]1<11:0>")

'UPC()’"

"]<11:0>")

SHOW KEY/FULL MINUS

MINUS

= SC/TO:SIGNAL("CS["TM

(NOECHO,TERMINAL)

>>>

Parameters
key-name

Displays the DEFINE/KEY definition of the specified key. If /ALL is
specified, do not specify the key-name parameter.

2-222

Console Commands
SHOW KEY

Valid key names are:

Key Name

Key

Editing Keypad

E1l
E2
E3
E4
E5
E6

Find
Insert Here
Remove
Select
Prev Screen
Next Screen

Function Keys
F6-F14
Do

Help

F17-F20

F6-F14
F15

F16

F17-F20

Numeric Keypad
PF1-PF4

KP0-KP9
PERIOD

COMMA
MINUS
ENTER

PF1-PF4

0-9
.

)
Enter

Console Commands
SHOW LOGGING

2-223

SHOW LOGGING

Displays the name and status of the current terminal log files if any exist.
Format

SHOW LOGGING
Example
>>>

show

Current

logging

log file(s)

open:

DUA50: [CROWLEY]ESDP_ 1.LOG
>>>

The SHOW LOGGING command display.

2-224

Console Commands

SHOW LOGICAL

SHOW LOGICAL
Displays the equivalence string assigned to a logical name with the
DEFINE command.

Format
SHOW LOGICAL

[/qualifiers] [logical-name]

Qualifiers
/ALL
Displays definitions for all logical names. If omitted, the command
prompts for the logical-name parameter. If /ALL is specified, do not
specify the logical-name parameter.

/PROCESS

Searches only the process logical name table for the specified logicalname. If logical-name is not specified, displays all the entries in the
process logical name table.
/SYSTEM

Searches only the system logical name table for the specified logical-name.
If logical-name is not specified, displays all the entries in the system
logical name table.

Parameters
logical-name
The logical name for which the definition is to be displayed. If omitted,
the command prompts for the logical-name parameter. If /ALL is
specified, do not specify the logical-name parameter.

Console Commands

2-225

SHOW MEMORY

SHOW MEMORY
Displays the status of main memory.

Format
SHOW MEMORY

Example
>>>

show

Physical

memory

System Memory

Resources

Memory Usage

(pages):

Main Memory

(pages):

Dynamic Memory Usage

Page

Table

Page

Port

Pool

Object

Port

(128

Usage

Table

(blocks):

bytes

per)

(Slots):

Total

7-MAR-1990
Use

Free

L.argest

12838

12784

Use

Free

Largest

13830

4802

3000
Total

(ports):

statistics

>>>

Displays memory resources.

Total
256

09:32:13.90

19930

200

Slots

Usage

Total
18632

System Memory

Kernel

Total

32768

(16.00Mb)

System Memory Usage

Use

Free

902

2098

Use

Free

106

Use

Free

199

2-226

Console Commands
SHOW MESSAGE

SHOW MESSAGE
Displays information about the current message file and message format
settings.

Format
SHOW MESSAGE

[message-id]

Parameters
message-id
Displays the specified message, where message-id is a hexadecimal
number.

Examples
>>>

show

message

Message

file:

Message

flags:

DUA50:[SYSEXE]SYSMSG.EXE

(O0)

/NOFACILITY
/NOSEVERITY
/NOIDENT
/NOTEXT
>>>

The SHOW MESSAGE default command display.
>>>

show

message

$KERNEL-S-SUCCESS,

normal

successful

completion

>>>

The SHOW MESSAGE display of a specified message.

Console Commands

2-227

SHOW MODE

SHOW MODE
Displays the current mode and defaults for the EXAMINE and DEPOSIT
commands.

Format
SHOW MODE

Example
>>>

show mode

Address

Space:

Data Context:

MEMORY

LONGWORD

Default Address: 00000000
Default Radix: HEXADECIMAL
>>>

The SHOW MODE command display.

2-228

Console Commands

SHOW NODE

SHOW NODE
Displays the current network node and address.

Format
SHOW NODE

Example
>>>

SHOW

NODE

Initial

node

name:

Initial

node

address:

MRBONZ

Current

node

name:

Current

node

address:

AA-00-04-00-19-1D

(7.281)

MRBONZ
AA-00-04-00-19~1D

>>>

The SHOW NODE command display.

(7.281)

Console Commands

2-229

SHOW PATTERN

SHOW PATTERN
Displays information about the specified pattern file. The name of the file
and affected signals are displayed with the cycle count of the next event
in the file.

Format
SHOW PATTERN

[/qualifiers] [pattern-name]

Qualifiers
/CPU=cpu-id
The CPU to which the pattern applies, where cpu-id is one of the
following:
0

ALL

AVAILABLE

BOOTPRIMARY

BOOTSET

PRIMARY

If a CPU is not specified, the default CPU is selected.

See Section 1.1.1.3 for more information on specifying a CPU. See the
SET CPU command description for more information on specifying the
default CPU.
/NODE=node-id
Valid only with /SYBIL. Specifies the remote node name or node number
(in the format z.nnn) where the pattern file resides.
/REMOTE
Displays a list of available remote (that is, SYBIL) patterns rather than
listing pattern points.

/SCU

/NOSCU
Determines whether to display system control unit pattern points.

/SYBIL
Specifies SYBIL remote patterns.

2-230

Console Commands
SHOW PATTERN

Parameters
pattern-name

The name of the pattern point; if not specified, all patterns are displayed.

Console Commands

SHOW PERSONAL

SHOW PERSONAL
Shows the user’s personal name.

Format
SHOW PERSONAL

Examples
B

>>>

show personal

No personal

name

set

>>>

The SHOW PERSONAL command display.

2-231

2-232

Console Commands
SHOW POWER

SHOW POWER
Displays various regulator (group) voltage measurements.
Format

SHOW POWER

[qualifier]

Qualifiers
/BUS=bus-name

Specifies the buses affected by the command, as follows:

Bus
Name

Volts

Model 200
Cabinet

Model 400
Cabinet

Tester

+5.0

SCU

MCM

+5.0

BBU

None

-3.4

SCU/CPA

SCU

None

-5.2

SCU/CPA

SCU

None

-3.4

CPB

None

-5.2

CPB

None

-3.4

None

CPA

UNIT 0

-5.2

None

CPA

UNIT 0

-3.4

None

CPB

UNIT 1

-5.2

None

CPB

UNIT 1

Console Commands

2-233

SHOW POWER

/CABINET=cabinet-id

The cabinets to which the command applies. The cabinet-ids represent
the buses that supply the cabinet (see /BUS).
Cabinet

Tester

Model 200 Buses

Model 400 Buses

Buses

SCU

ABCD

AB,C,D

None

CPA

C,D

J, K

None

CPB

E,F

M, N

None

UNIT_0

None

J, K

UNIT_1

None

M,N

5VOLT

None

A B

If a cabinet is not specified, the command applies to all cabinets.
/CONTINUOUS

Causes the display to be refreshed every 2 seconds or at intervals specified
with the /INTERVAL qualifier.
/COUNTERS
Displays the event counters in the power subsystem driver.
/INTERVAL=seconds

Specifies the continuous display refresh interval in seconds.
/N0

Displays the state of the I/O power supplies.
/OUTPUT=file-spec
Logs command output in the specified file.

2-234

Console Commands
SHOW POWER

Example
>>>

SHOW POWER /IO

7214 A

7215 A

OK
OK
OK
OK
OK

REGA

REGB

REGA

REGB

STATUS

REG OK
BIAS O
BIAS 1
BIAS 2
BIAS 3

STATUS

REG OK

STATUS

REG OK

XMIO

XMI1

7214 B

7215 B

OK
OK
OK
OK
OK

REGC

REGD

7214 B

7215 B

7214 A

7215 A

OK
OK
OK
OK
OK

REGC

REGD

REGA

REGB

REGD

REGA

REGB

REGC

REGD

BIO

BI2

REG C

BIl

BI3

SHOW POWER /10 display format.

Console Commands

2-235

SHOW PROCESS

SHOW PROCESS
Displays information about the current CLI process, including allocated
devices and process statistics.

Format
SHOW PROCESS

Display Format

>>>

SHOW

PROCESS

20-AUG-1989

Job

ID:

Priority:
CPU

13:54:05.57

0016

Port

time:

Default
0

RTAl:

ID:

User:

000400B3

Image:

directory:

00:00:02.25

CONSOLE

CLI

DUA50: [CONSOLE]

Pages:

273

PO pages:

Devices

allocated:

Process

Priority

State

Run

00:00:02.16

Wait

00:00:00.06

Wait

00:00:00.00

Wait

00:00:00.00

Wait

00:00:00.03

Wait

00:00:00.00

1073

RTAl:
Run

time

Memory Pages

pages:

2-236

Console Commands

SHOW RADIX

SHOW RADIX
Displays the current radix setting.

Format
SHOW RADIX

Example
>>>

SHOW

Default

RADIX

radix

hex

>>>

The current radix is hexadecimal.

Console Commands
SHOW REMOTE

SHOW REMOTE
Displays the state of the remote port.
Format

SHOW REMOTE

Example
>>>

SHOW

REMOTE

Front panel access: DISABLED
Software controlled access: ENABLED
Remote status: 1 ACTIVE LINK
>>>

The SHOW REMOTE command display.

2-237

2-238

Console Commands

SHOW SCi

SHOW SCI
Displays the current state of the SCI. The value of the SCI DATA IN line
is displayed with the saved state of the SCI output lines (the output lines
cannot be directly read).

NOTE
If the SET SCI/SHOW SCI commands are in use, no other scan
activity should occur. Any intervening scan commands, including
SHOW CLOCK, could change the SCI state.

Format
SHOW SCI

[qualifiers]

Qualifiers
/DATA_ONLY

/NODATA_ONLY
Determines whether only the data is displayed.
/PORT=port-id
Displays SCI state of the specified port, where port-id is the physical port
number;g or port name, as follows:

CPU0

CPU1

CPU2

CPU3

MCM

SCU

Example
>>>

show

sci

Current

SCI

Saved

State

SELECT<3:0>

FUNCTION<1:0>

CDS

BYPASS

BROADCAST

DATA

OUT

Information

for

port

(CPUO)

(NOP)

(from

SCM)

CLOCK A

(NOP)

CLOCK

(NOP)

DATA

(Data

(to

SCM)

>>>

The SHOW SCI command display.

from

latch

SCD

logic)

Console Commands

SHOW SCM

SHOW SCM
Displays information about the scan control module.
Format
SHOW SCM

[/qualifiers]

Qualifiers
/BAD _PAGE_MAP
Displays bad page block, as follows:
>>>

SHOW

SCM

/BAD PAGE MAP

Scan Control Module BAD PAGE BLOCK

00000000
00000000
00000000
00000000
00000000
00000000
00000000
00000000
>>>

00000000
00000000
00000000
00000000
00000000
00000000
00000000
00000000

00000000 :
00000000 :
00000000 :
00000000 :
00000000 :
00000000 :
00000000 :
00000000 :

Page
Page
Page
Page
Page
Page
Page
Page

000:07F
080:0FF
100:17F
180:1FF
200:27F
280:2FF
300:37F
380:3FF

2-239

2-240

Console Commands

SHOW SCM

/ENTRY_BLOCK
Displays last entry block, as follows:
>>>

SHOW

Scan

SCM

/ENTRY

BLOCK

Control

Module

LAST

Valid

flag

ENTRY BLOCK

00000001

00000000

1F830A10

1F817600

00000005

1F8004E8

00000000

1F80103C

00017600

R11

00A3C600

00000001

00000000

0001C602

1F8033F8

1F8033E4

1F802BF0

1F8009AE

00000200

bi stop

PSL

00 (SP)

55000004

04 (SP)

0C1l6EF9E

08 (SP)

D0540000

0C(SP)

ACD05204

10 (SP)

53D45108

14 (SP)

FD8F5191

18(SP)

53D60B13

1C (SP)

5062417E

SCM

FFFFFFBF

CSR

Reserved

115055C0 F88F780C 407E5051 54C05062

Checksum

905E2A3B

>>>

wvalid

Console Commands

SHOW SCM

/ERROR_BLOCK
Displays error block, as follows:
>>>

SHOW

SCM

/ERROR BLOCK

Scan Control Module

LAST ERROR BLOCK

Error Code

00000008

SCB Vector

00000004

DType

04442121

05010806

CSR

BER

00000000

Port

00000006

Port

B8040740

Port

00000001

Port

1F8072D4

00 (SP)

0000000C

04 (SP)

00000080

08 (SP)

9D86B914

0C (SP)

0A00000B

10 (SP)

1F8072D4

14 (SP)

00010000

18 (SP)

00000000

1C(SP)

00000000

SCC

CSR

000040C2

SCC

CLK CTL

40000001

SCC

DMA CSR

00000000

SCC DMA OUT

1F821B10

SCC

DMA

1F822380

SCC

DMA MSK

MACHINE CHECK

no_errors

PCE

1Fr800000

SCC DMA EXP

1F811810

DYRC CSR

00003000

DYRC ADDR

FATAL

00005CCO

BCI3

CSR

FC7F0000

BCI3

EV Sts

00000006

no_errors

BCI3

DM Cnf 1FDECO000
BCI3 BI Adr CO096DA20
BCI3

II Adr DF8223D0

Reserved

04040118

00000004

Checksum

7CE8A9C2

valid

>>>

2-241

2-242

Console Commands
SHOW SCM

/MEMORY
Displays SCM memory statistics, as follows:
>>>

SHOW

ROM

SCM

/MEMORY

Scan

Control

Space

Module

(pages)

Total

Firmware
RAM

Space

Static

Memory
In

256
In

Resources
Use

Free

158

(pages)

Total

Use

Free

Storage

181

Largest

CDB

Storage

795

774

SCC

Buffer

Area

Watchpoint

Area

>>>

Example
>>>

SHOW

Scan

SCM

Control

Revision

Module

levels

SCM Firmware:
Options
Scan
BI

Statistics

V68

SCM

RBD:

Verification:

Signal

Caching:

DISABLED
DISABLED
ENABLED

Attention Polling:

DISABLED

Scan

Mode:

NORMAL

Scan

Clock

Vector

proc

Rate:
mask:

Attention mask:

100NS
01

>>>

Displays scan control module statistics.

V6l

Console Commands

2-243

SHOW SCOPE

SHOW SCOPE
Displays the current default scope for use with the EXAMINE, DEPOSIT,
SET TRACE, SET WATCH, and SET PATTERN commands. The scope
display format (same as EXAMINE/LABEL) is as follows:
Model=Model-name,

Label:

Revision=Model-revision

Format
SHOW SCOPE

Example
>>>

show

scope

Scope = %CPUO,

Model = CPU,

>>>

The SHOW SCOPE command display.

Revision = A

2-244

Console Commands

SHOW SCU

SHOW SCU
Displays the current state of the SCU.

Format
SHOW SCU

Display Format

>>>

SHOW

SCU

Unit

SCU

present

and

revision:

AQOQ
DUAS50: [UCODE]SCUAQO.CDB

Unit

CDB

DAl:

Broken

Unit

state

file:

has

CDB

file

flags:

Power

Not

Broken
.

Not

Initialized

Clocks

Not

Running

Hard

Core

Pattern

Not

Test

Executed
Not

Executed

loaded

Console Commands

2-245

SHOW SJA

SHOW SJA
Displays the current state of the SJA.

Format
SHOW SJA

Example
>>>

SHOW

SJA

SPU/Jbox Adapter
Revision

levels

SJA Array:

Options

Statistics
-

SPM Module:

Memory

type:

Looback:
Primary

DMA mode:

type:

DISABLED
DISABLED, INACTIVE

Simulated 0/S:

STEP

Cur

Debug mode:

DISABLED

CPUCNF

present

Check MMU
Trace

ID:

DISABLED

Memory mode:
MMU

CPU

EMULATED

mask:

hndshk:

mode:

Attentions

Mem

state:

access:

XJA present

ENABLED

Check

DISABLED

Int

enable:

Received ATTNs:

0
CPUO

CPUl1l

CPU2

CPU3

Attention mask:

0000

Hot

0000

check

Clock

mask:

check mask:

>>>

The SHOW SJA command display.

mask:

XJA hndshk:

SCU

EMULATED

STBY

DISABLED
00

ENABLED
DISABLED

2-246

Console Commands
SHOW SOURCE

SHOW SOURCE
Displays the source directory for microcode trace windows.
Format
SHOW SOURCE

Example
>>>

SHOW

SOURCE

DISKSHARD: [SYS4.CONSOLE]

The source directory for the microcode trace windows is the CONSOLE
subdirectory of the SYS4 directory on device DISKSHARD.

Console Commands

2-247

SHOW STEP

SHOW STEP
Displays the current STEP attributes. The INSTRUCTION mode state
and the BOOTSET mode state are displayed.
Format
SHOW STEP

Example
>>>

SHOW

STEP

Instruction
>>>

The SHOW STEP command display.

2-248

Console Commands

SHOW STRUCTURE

SHOW STRUCTURE
Displays the structure current state, version, symbol table state, and
file-spec from which the structure was loaded.
Format

SHOW STRUCTURE

[structure-name] [/qualifiers]

Parameters
structure-name

Specifies one structure. If not specified, all structures are displayed. Valid
structure names are as follows:
Table 2-16

Structure Names

CACHEQ

CACHE1

ECCO

ECC1

ECS

EREG

FRAM

IPAMM

Jcs

MPAMM

NPAMM

PCHB

TAGO

TAG1

TAGRM

TBRAMS

VALIDRAMS

VIC

VICA

VICB

VREG

Qualifiers
/CPU=cpu-id

Specifies the CPU that contains the structure(s), where cpu-id is one of

the following:
0

ALL

AVAILABLE

BOOTPRIMARY

BOOTSET

PRIMARY

If a CPU is not specified, the default CPU structure information is
displayed.

See Section 1.1.1.3 for more information on specifying a CPU. See the
SET CPU command description for more information on specifying the
default CPU.

Console Commands

2-249

SHOW STRUCTURE

/SCU

/NOSCU

Determines whether to display system control unit structure information.

Display Format

>>>

show

Status

structure

Name

Signal name

file

Version

Symbols

NONE

NOT Loaded

NONE

NOT Loaded

NONE

NOT Loaded

NONE

NOT Loaded

NONE

NOT Loaded

A48e*DE

NOT Loaded

NONE

NOT Loaded

DUAS50: [UCODE]VREG.LOD

Initialized
from

EREG
Loaded

CPU

Initialized %CPU.VREG][]
from file

BP
Loaded

State

VREG
Loaded

structures

%$CPU.BP[]

DUASO: [UCODE]BP.LOD

Initialized

%CPU.EREGI[]

from file DUASQO: [UCODE]CONSTANTO.LOD

CACHEO

Initialized

%CPU.CACHEQ[]

Loaded from file DUASO: [UCODE]CACHE(C.LOD

CACHE1
Loaded

Initialized %CPU.CACHE1l][]
from file

FRAM

DUAS50:[UCODE]CACHE1l.LOD

Initialized %CPU.FRAM[]

Loaded from file DUA50:[UCODE]FRAM.LOD
VALIDRAMS

Initialized

Loaded from file

%$CPU.VALIDRAMS]]

DUAS0:[UCODE]VALIDRAMS.LOD

PCHB

Undefined

%CPU.PCHB[]

NONE

NOT

ECCO

Initialized

%$CPU.ECCO{]

NONE

NOT Loaded

NONE

NOT

NONE

NOT Loaded

NONE

NOT Loaded

E272

Loaded

NONE

NOT

Loaded

NONE

NOT

Loaded

NONE

NOT Loaded

NONE

NOT

Loaded from file
ECC1

VICA

Loaded
ECS

TAGO
Loaded

TAG1
Loaded
TBRAMS

DUA50:[UCODE]VICB.LOD

Initialized $%CPU.ECS|[]
DUASO:[UCODE]AQUARIUS.LOD

Initialized %CPU.VIC][]

Loaded from file

DUAS50:[UCODE]VIC.LOD

Initialized %CPU.TAGO[]
from file

DUAS50: [UCODE]TAGO.LOD

Initialized
from file

%CPU.TAGl[]

DUASQ:[UCODE]TAG1.LOD

Initialized

Loaded from file

Loaded

DUAS50:[UCODE]VICA.LOD

Initialized %CPU.VICBI]
from file

Loaded from file
VIC

%CPU.ECC11{]

DUAS50: [UCODE]ECC1.LOD

Initialized %CPU.VICAT]

Loaded from file

VICB

DUA50: [UCODE]ECCO.LOD

Initialized

Loaded from file

Loaded

%CPU.TBRAMS](]

Loaded

DUAS50:[UCODE]TBRAMS.LOD

>>>

Displays information about all the structures for the default CPU (CPUO).

2-250

Console Commands

SHOW SWITCHES

SHOW SWITCHES
Displays the current position of the Startup and Service Processor Access
switches on the operator control panel. The possible values are:
Table 2—17

Operator Control Panel Switches

Startup Switch

Service Processor Access Switch

Positions

BOOT

REMOTE

RESTART_BOOT

REMOTE_DISABLE

RESTART_HALT

LOCAL

HALT

LOCAL_DISABLE

Format
SHOW SWITCHES

Example
>>>

SHOW

Boot

SWITCHES

Switch:

Access

HALT

Switch:

REMOTE

The Boot switch is set to Halt and the Access switch is set to Remote.

Console Commands

2-251

SHOW SYMBOL

SHOW SYMBOL
Displays symbol values defined by the symbol assignment command. If
/ALL or symbol-name are not specified, the command issues the input
prompt:

_SYMBOL:

Format
SHOW SYMBOL

[/qualifiers] [symbol-name]

Qualifiers
/ALL (D)
Displays all symbols in the specified table. If /ALL is specified, do not
specify the symbol-name parameter.
/GLOBAL
Displays only global symbols.
/LOCAL

Displays only local symbols.
/structure_qualifier

Displays the symbols loaded for the specified structure. Valid structure
qualifiers are:

/BP

/CACHEO

/CACHE1

/ECCO

/ECC1

/ECS

/EREG

/FRAM

/IPAMM

/ICS

/MPAMM

/NPAMM

/PCHB

ITAGO

/TAG1

/TAGRM

/TBRAMS

/VALIDRAMS

NIC

/VICA

/VICB

NREG

Parameters
symbol-name
The symbol to be displayed. If omitted, all symbol definitions are
displayed. If symbol-name contains a wildcard character, all matching
symbol definitions are listed. If /ALL is specified, do not specify the
symbol-name parameter.

2-252

Console Commands
SHOW SYSTEM

SHOW SYSTEM
Displays the processes currently defined in the SPU software system.
The memory usage of each process is displayed with the CPU usage. The
display format is similar to the VMS SHOW SYSTEM command.
Format

SHOW SYSTEM

[[JNOJPROCESS]

Qualifiers
/PROCESS
/NOPROCESS

Specifies whether to display subprocess information for each job in the

system.

Example
>>>

show

system

EWBAA V10.8(332)
on node SPUS18
Pid
Process name State Pri

00020000
00030000
00040000
00050000
00060000
00070000
00080000
O00OB0O0O0O0
000C0000
000D0000
O00EOO000
O00F0000

XBDRIVER
CONSOLE_
31
EDEBUGREM
BUDRIVER
31
MBDRIVER
31
VMDRIVER
FALSERVER
SCMDRIVER
SJADRIVER
PCSDRIVER
RTDRIVER
REMOTE

00100000 PRINTER
00110000 CONTROL
00120000 CLI
00130000 EFM

13-MAR-1990
CPU

19:08:50.90
RW Mem PO Mem Pl Mem

Wait
Wait
Wait
Wait
Wait
Wait
Wait
Wait
Wait
Wait
Wait
Wait

1
2
3
4
4
16
16
5
16
5
4
6

0
0
0
0
0
0
0
0
0
0
0
0

00:00:00.17
00:00:09.15
00:00:00.01
00:00:45.064
00:00:00.04
00:00:00.15
00:00:00.01
00:00:08.48
00:00:00.81
00:00:00.81
00:00:00.00
00:00:00.02

45
19
2
159
52
9
1
566
846
408
4
9

65
43
23
143
36
107
12
127
246
98
43
43

16
50
4
58
24
42
2
54
74
48
2
13

Wait
Wait
Run
Wait

6
12
17
12

0
0
0
0

00:00:00.01
00:00:00.03
00:01:006.67
00:00:00.41

9
42
703
432

42
283
1035
79

13
21
97
10

>>>

The SHOW SYSTEM command display.

Console Commands

2-253

SHOW TERMINAL

SHOW TERMINAL
Displays the current terminal characteristics.
Format

SHOW TERMINAL

[terminal-name:]

Parameters
terminal-name:

Displays the specified terminal characteristics, where terminal-name
must be terminated with a colon (:). For example:
>>>

SHOW TERMINAL

$CMD-W-SYNTAXERR,

CONSOLE

illegal command - check command description

\ CONSOLE\
>>>

SHOW TERMINAL CONSOLE:

Terminal: CONSOLE
Input:

Output:

9600

Connected_to: OPAl

Device type: VT100

LFfill: O
CRfill:

Width:

Length:

Parity: None

Terminal Characteristics
Echo
Escape

No Eightbit
No Passall
Broadcast

Talk Mode
>>>

If not specified, the current terminal characteristics are displayed.

2-254

Console Commands
SHOW TERMINAL

Example
>>>

SHOW

Terminal:

TERMINAL

CONSOLE:

Device type:

VT100

Connected
to: OPAQ

Input:

9600

LFFill:

Width:

Output:

9600

CRFill:

Length:

Terminal

Characteristics

Echo
Escape

Eightbit

Passall

Broadcast
Talk Mode

The current terminal characteristics.

Parity:

None

Console Commands
SHOW THRESHOLD

SHOW THRESHOLD
Displays the current error handling system thresholds.
Format

SHOW THRESHOLD

Example
>>>

show

threshold

Error thresholds
Cache

Set

and current

counts

Cache

1 Vbox CPU

Set

Threshold:
CPU 0:
CPU 1:

0 0
16384

CPU

3584

784

>>>

The SHOW THRESHOLD command display.

2-255

2-256

Console Commands
SHOW TIME

SHOW TIME
Displays the current date and time in the following format:
DD-MMM-YYYY

HH:MM:SS

Format
SHOW TIME

Example
>>>

SHOW

TIME

11-JAN-1990

10:17:49

The current date and time display.

Console Commands

2-257

SHOW TRACE

SHOW TRACE
Displays information about the specified tracepoint.
Format

SHOW TRACE

[/qualifiers] [tracepoint-name]

Qualifiers
/CPU=cpu-id

Specifies the CPU, where cpu-id is one of the following:
0

ALL

AVAILABLE

BOOTPRIMARY

BOOTSET

PRIMARY

If a CPU is not specified, the default CPU is used.

See Section 1.1.1.3 for more information on specifying a CPU. See the
SET CPU command description for more information on specifying the
default CPU.

/SCU

/NOSCU

Determines whether to display system control unit tracepoints.
Parameters
tracepoint-name
The tracepoint to be displayed.

Example
>>>

SHOW

TRACE1

TRACE

TRACEl

/FROM=0

/TO=0

/CPU=0

%CPUO .DECODE_PC<31:0>
$CPUOOX_UPC<11:0>
$CPUO .LOAD UPC<11:0>

Tracepoint TRACE] information display.

(enabled)

USER=0

2-258

Console Commands
SHOW USERS

SHOW USERS
Displays the user name, port ID, and terminal name of processes
currently logged in to the SPU.

Format
SHOW USERS

Example
>>>

SHOW

USERS

SPU/ELN

Interactive

25-AUG-1988

Users

00:00:21.01

Username

Port

CONSOLE

000200EA

CONSOQLE:

MYNAME

000400D7

RTAl:

User information display.

Terminal

Console Commands

2-259

SHOW VERSION

SHOW VERSION
Displays the version of the specified object. Hardware object displays
include the hardware part number and serial number, if available.
Software object displays include the facility or module name.

Format
SHOW VERSION

/object

Objects
/ALL
Valid only with /CLI and /RTL. Displays all data for the subsystem.
/CLI (D)
Displays command language interpreter version.

/CLOCK
Displays the top level clock subsystem revision.

/FACILITY=name
Valid only with /CLI and /RTL. Displays more information about the
module specified by facility-name.
/RTL

Displays the SPU runtime (RTL) library version.

/SCM
Displays the scan control module version.

2-260

Console Commands
SHOW VERSION

Examples

>>> SHOW VERSION
EWBAA X10.7(324)

DEB;47.0 FILE;22.0 MAC;69.0 MAIN;75.0
Built by EVANS on node

SALTON at

SET;62.0

17-FEB-1990

TEST;27.0 WIN;22.0

13:00:17.51

>>>

Displays CLI version information. Note that CLI is the default if no
qualifiers are specified.
>>>

SHOW VERSION

/RTL

SPURTL X10.5(322)

CMD;30.0 CSA;7.0
SCM;35.0

SJA;37.0

ERH;27.0 KNL;47.0 LIB;92.0 PCS;26.0 RMS;8.0
TRM;13.0

Built by EVANS on node SALTON at

17-FEB-1990

>>>

Displays runtime library version information.

11:52:30.90

Console Commands

2-261

SHOW WATCH

SHOW WATCH
Displays information about the specified watchpoint.

Format
SHOW WATCH

[/qualifiers] watchpoint-name

Qualifiers
/CPU=cpu-id
Specifies the CPU, where cpu-id is one of the following:
0

ALL

AVAILABLE

BOOTPRIMARY

BOOTSET

PRIMARY

If a CPU is not specified, the default CPU is used.
See Section 1.1.1.3 for more information on specifying a CPU. See the
SET CPU command description for more information on specifying the
default CPU.

/SCU

/NOSCU
Determines whether to display system control unit watchpoints.

Parameters
watchpoint-name
The watchpoint to be displayed; if omitted, all watchpoints are displayed.

Example
>>>

SHOW

WATCH

WATCH1
Command

WATCH1

/FROM=0

/TO=0

execute

/CPU=0

EXAMINE

$CPUO.DECODE_PC<31:0>
5CPUOOX UPC<11:0>
%CPUO.LOAD

(enabled)

$%CPUQ.*PC*

UPC<11:0>

Watchpoint WATCH1 information display.

USER=0

2-262

Console Commands

SHOW WINDOW

SHOW WINDOW
Displays information about the specified window, including its name, type,
location, visibility, and plane. This information appears in the command
window.

Format

SHOW WINDOW

[window-name]

Display Format

The window information is displayed in the following format:
Type
Examine
Odometer
*Microcode

Name
TEST
NEW
UCODE

Start
2
11
2

End
9
19
)

Visible
N
Y
Y

Partial
N
Y
Y

Update
Y
Y
Y

Plane
1
2
0

The window name was assigned when the window was created. Start and
End are the first and last line numbers of the window. Visible and Partial
indicate (yes or no) whether a complete or partial window is visible. Plane
is the internal window ID.

Parameters
window-name

Specifies the window about which information is to be displayed.

Console Commands

2-263

SHOW XMI_DEVICES

SHOW XMI_DEVICES
Displays the node names and device types for all devices loaded with the
SET XMI_DEVICES command.

Format
SHOW XMI_DEVICES

2-264

Console Commands
SHOW ZONE

SHOW ZONE
Displays information about the memory allocation zone manager.
Format
SHOW ZONE

Example
>>>

SHOW

zone ID:

ZONE

808D8088 Zone type:

Shared User

Extend by 312 page(s)

Maximum of 5000 page(s) in zone
Currently 312 page(s) in zone
No fill on allocation
No fill on deallocation
Area extension

is ENABLED

Area allocated from system pool
Area

list

Block address:
Block size:
Free block list
Block address:

Block size:

808EOQ0CO00
00027000
808EQD78
00026E80

>>>

The SHOW ZONE command display.

Console Commands

2-265

START

START
Begins execution in the specified CPU at the specified address.

Format
START

[/qualifiers] address-expression

Qualifiers
/CPU=cpu-id
The CPU to be started, where cpu-id is one of the following:
0

ALL

AVAILABLE

BOOTPRIMARY

BOOTSET

PRIMARY

If a CPU is not specified, the default CPU is started.
See Section 1.1.1.3 for more information on specifying a CPU. See the
SET CPU command description for more information on specifying the
default CPU.
/LOG

/NOLOG
Determines whether to display command results.
/PIO_MODE(D)
/NOPIO_MODE

Determines whether to enter program I/O (PIO) mode. If PIO mode is
entered, typing Ctrl/P returns the SPU to console I/O (CIO) mode and
displays the following message:
[Entering

Console

IO mode.

Please

type

'CONTINUE’

return.]

/PIO_PORT={OPAO|OPA1}

Determines to which port the console terminal is connected. OPAQ is the
normal console port and OPAL is the remote port.

2-266

Console Commands
START

Parameters

address-expression

The address of a location. The address can be a numeric literal, symbolic
address, special operator, or lexical function. See Section 1.6 for more
information on expressions.

Console Commands

2-267

STOP

STOP
Stops a process on the SPU or scan control module (SCM).

Format
STOP

/qualifier

Qualifiers
/JOB=port-id
The port ID (hexadecimal) of the batch job to be stopped (deleted). The
SHOW BATCH command lists the port ID.
/PROCESS=process-id

The process to be stopped, where process-id is a hexadecimal number.

/SCM
Issues a BI STOP command to the SCM.

2-268

Console Commands
SUBMIT

SUBMIT
Enters the specified command procedure file in a batch job queue.
Format
SUBMIT

[/JNOJLOG] file-spec

Qualifier
/LOG

/NOLOG

Determines whether to display command results.
Parameters
file-spec

The command procedure file to be entered in the batch queue. The default
file type is .CMD.

Console Commands

2-269

TALK

TALK
Enables parallel control/communications between the local terminal and
a remote process. When talk mode is enabled, the following message is
displayed:
$CLI-I-LINK,

terminal

link

established

from xxx

In talk mode, the local and remote terminals act as a single logical
terminal to the remote process, with the characteristics of the remote
terminal. Input from either terminal is echoed on both terminals and is
treated as part of the remote process’s command stream.

Pressing Ctrl/P on the terminal that initiated the link disables talk mode.
When talk mode is disabled, any commands in progress continue.

Format
TALK

terminal-name

Parameters
terminal-name
The name of the remote terminal, for example:
>>>

TALK

RTAl:

$CLI-I-LINK,

terminal

link

established

from RTAl

2-270

Console Commands
TYPE

TYPE
Displays the contents of the specified file(s). The stop (Ctrl/S) and start
(Ctrl/Q) scroll keys suspend and resume screen scrolling.
Format

TYPE

[iqualifiers] file-spec], . . . |

Qualifiers
/CONFIRM
/NOCONFIRM (D)

Determines whether an affirmative response is required before each file is
typed. Valid responses to the confirmation prompt are:
Response

Result

Y (yes)

The file is typed.

T (true)

The file is typed.

N (no)

The file is not typed.

F (false)

The file is not typed.

Q (quit)

Abort command processing.

Responses can be upper or lowercase. The first character of the response
is checked for Y, T, or Q. Any response other than Y, T, N, F, or Q is

interpreted as N or F.
/PAGED
/NOPAGED

Displays the file one screen page at a time.

Console Commands

2-271

TYPE

Parameters
file-specy, . .. ]

The file to be displayed. The default file type is .CMD.

To specify two or more files, separate the file specifications with either
commas or plus signs. The files are displayed in the order listed.
The asterisk (*) wildcard character can be used in place of any whole
or partial field (file name, type, or version) and the percent (%)
wildcard character can be used in place of any single character in the
file specification. The command displays all files that satisfy the file
description.

Examples
>>>

TYPE

COMMON.DAT

Displays the contents of file COMMON.DAT.
>>>

TYPE

TEST

Displays the contents of file TEST.CMD.

2-272

Console Commands

UNJAM

UNJAM
Performs an I/O subsystem reset. The SCU treats this as a power-up
initialization and the XMI interface executes a RESET sequence. This, in
turn, causes a BI RESET, and so on.

Format
UNJAM

[/XJA=xja-id]

Qualifier
/XJA=xja-id
Specifies the hexadecimal number of the XJA to be reset.

Console Commands

2-273

VERIFY

VERIFY
Compares the specified structure data with the specified file-spec data.
Any mismatches cause the mismatched structure and file data to be
displayed.

Format
VERIFY

/structure [/qualifiers] file-spec

Structures
/MAIN_MEMORY
Compares main memory.
/PEM

Compares PEM firmware.
/RIC=ric-id

Compares RIC firmware. The ric-id is a hexadecimal number.

/STRUCTURE
Compares structure microcode.

Qualifiers
/CPU=cpu-id
Specifies the CPU that contains the structure, where cpu-id is one of the
following:
0

ALL

AVAILABLE

BOOTPRIMARY

BOOTSET

If a CPU is not specified, the default CPU is used.
/END=address

Specifies the address (hexadecimal) where the comparison ends.
/LOG
/NOLOG

The /LOG qualifier displays the structure and file names.

PRIMARY

2-274

Console Commands
VERIFY

/START=address
Specifies the structure starting address (hexadecimal), not the position in
the file, where the comparison starts.

Parameters
file-spec
Specifies the file that contains the data to be compared.

Console Commands

2-275

WAIT

WAIT
Pauses the current CLI process for the specified time. The command can
be interrupted (the wait canceled) by typing Ctrl/P.
Format
WAIT

time

Parameters
time

The wait time can be relative or absolute. Relative time is specified as a
quoted string in the following format:
>>>

wait

HH:MM:SS"

or in seconds as an unquoted integer. For example, a five second wait:
>>>

wait

Absolute time is specified as a quoted string as follows:
>>>

wait

"DD-MMM-YYYY

HH:MM:SS"

Examples
>>>

WAIT

00:00:05"

Wait 5 seconds (relative time format).
>>>

WAIT

Wait 5 seconds (relative time format).
>>>

WAIT

"12:44:16"

Wait until 12:44:16 (absolute time format).
>>>

WAIT

"11-JAN-1990

00:00:15"

Wait until January 11, 1990, 00:00:15 (absolute time format).

2—-276

Console Commands
WRITE

WRITE
Writes the string-expression to the specified file.

Format
WRITE

[/NOCRLF] logical-name string-expression

Qualifier
/NOCRLF
Allows strings to be appended to each other in the output file record by
not terminating the record with a carriage return.

Parameters
logical-name
The logical name assigned by the OPEN command when the file was
opened. The predefined logical names STDOUT and SYS$OUTPUT can
also be used.
string-expression
An expression containing any elements that result in a string.

Console Commands

2-277

y4
Establishes the XMI XCOM (default) or BI RXCD communication protocol
with the specified node. Commands can then be passed to the node and
results displayed.

Format
Z

[/qualifier] [node]

Qualifiers
/Bl=node
Specifies the BI RXCD protocol. The node argument specifies the XBI
node and the node parameter is not used.

/SPU=node

Specifies an SPU BI node and the BI RXCD protocol (the /BI qualifier
should not be used). The node argument specifies the BI node and the
node parameter is not used.

Parameters
node
:
A two-digit number with the most significant digit is the XJA number and
the least significant digit is the node number. For example:
>>>

specifies XJA3 node 4.

3
Lexical Function Description
The lexical function descriptions in this chapter are nearly identical to the
descriptions in the service processor operating system HELP library. In
most cases, the two are distinguished only by minor formatting differences
to accommodate the different media.
Lexical functions return numeric or string results and can be used
anywhere numeric or string expressions are valid. The supported lexical
functions are listed below and are described on the following pages:
ASCII

BITVECTOR

CLOCK

CONFIG

CPU

EXTRACT

FIELD

FILL

INFORMATION

INTEGER

LENGTH

LOCATE

LOGICAL

MCU

MEMORY

PARSE

PART

POWER

RADIX

REVISION

SCI

SCU

SERIAL

SID

SIGNAL

STRING

SWITCH

TIME

UPC

VERIFY

3-2

Console Lexicals
ASCII

ASCII

Returns the ASCII character for the specified number or keyword. The
number is assumed to be in the default radix (usually hexadecimal).
Format
ASCIl

¢ number

keyword )

Return Value

The ASCII character for the specified number or keyword.
Arguments
number

A number in the default radix (usually hexadecimal).
keyword

One of the following:
BACKSPACE
BELL
ESCAPE
FORMFEED
LINEFEED
NEWLINE
RETURN
TAB
VERTICAL_TAB

Console Lexicals

3-3

BITVECTOR

BITVECTOR
Evaluates the specified expression and returns a bitvector data type. The
expression must yield a numeric result.

Format
BITVECTOR

(expression [, length])

Return Value
A bitvector data type of the specified length or fewest bytes that can hold
the expression result.

Arguments
expression
The expression to be evaluated.

length

The number of bits in the returned bitvector. If the length value exceeds
the number of bits in the result, the fewest bytes that can hold the result
are returned.

Console Lexicals
CLOCK

CLOCK
Returns information about the clock subsystem.
Format
CLOCK

(item)

Return Value

See the item argument description for returned values.
Arguments
item

item

Returned Value

DISABL

DISABL bit state.

EMULATION

TRUE if clock emulation is enabled.

FREQUENCY

Frequency register.

INTERVAL

Interval register.

POSITION

Position (delay) register.

SYNCH

SYNCH bit state.

Console Lexicals

CONFIG

CONFIG
Returns system configuration information.

Format
CONFIG

(item)

Return Value
See the item argument description for returned values.

Arguments
item

item

Returned Value

ICU

A mask of ICUs present as a number.

ICUO0

TRUE/FALSE.

ICU1

TRUE/FALSE.

MMU

A mask of MMUs present as a number.

MMUO

TRUE/FALSE.

MMU1

TRUE/FALSE.

XJA

A mask of XJAs present as a number.

XJAO

TRUE/FALSE.

XJA1l

TRUE/FALSE.

XJA2

TRUE/FALSE.

XJA3

TRUE/FALSE.

3-5

3-6

Console Lexicals
CPU

CPU
Returns information about the default or specified CPU. See also the SCU
lexical.

Format
CPU

(item, [cpu-id])

Return Value

See the item argument description for returned values.
Arguments
item

item

Returned Value

ALLOCATED

User who allocated CPU or " " (null) if not allocated.

AVAILABLE

TRUE if this unit is in available set.

BOOT_SET

TRUE if unit is in boot set.

BROKE

TRUE if the unit is broken.

CDB

CDB file name.

CLOCK

TRUE if unit’s clock is running.

COLD_START

State of COLD_START flag.

DEFAULT

Default CPU as a string.

HARD

TRUE if the unit has passed the hard-core tests.

INITIALIZED

TRUE if unit is initialized.

POWER

TRUE if the unit has power.

PRESENT

TRUE if unit is present.

REVISION

Revision string for this unit.

RUN

TRUE if the unit is running.

Console Lexicals
CPU

item

Returned Value

SENSE

TRUE if this unit has been SENSED.

STATE

The UCB state bits as a number.

WARM_START

State of WARM_START flag.

cpu-id

Specifies the CPU, where cpu-id is one of the following integers or
strings:

CPUO

CPU1

If not specified, the default CPU.

CPU2Z

CPU3

3-7

3-8

Console Lexicals
EXTRACT

EXTRACT
Extracts a substring from a string based on the start position and length
information.

Format
EXTRACT

(start, length, string)

Return Value

A character substring delimited by the start and length arguments.
If the start argument is greater than or equal to the length of the string,
a null string (" ") is returned.

Arguments
start
An integer expression representing the offset of the extracted substring.
Offset is the position of a string character or a substring relative to the
leftmost string character. The leftmost, or first, character in a string is
position 0.

length
The number of characters to be extracted. If the length value exceeds the
number of characters in the string from the start position to the end of
the string, the characters from the start position to the end of the string
are returned.

string
The string from which the substring is to be extracted.

Example
>>>

NAME

"JOHN

>>>

LAST

EXTRACT

>>>

SHOW

SYMBOL

LAST

PUBLIC"
(8, 6,NAME)

LAST

"PUBLIC"

The last six characters are extracted from the character string assigned to
symbol NAME, and assigned to symbol LAST.

Console Lexicals

3-9

FIELD

FIELD
Extracts a bitvector from the specified expression based on the specified
start and length.

Format
FIELD

(start, length, expression)

Return Value

A bitvector based on the specified start and length arguments. If the
length of the returned data is less than 32 bits, an integer is returned,
otherwise, a bitvector is returned.

Arguments
start

An integer value representing the offset of the field. Offset is the position
of the field relative to the leftmost bit in the expression.
length

The number of bits in the extracted bitvector.
expression

The bitvector or integer from which the field is to he extracted.

3—10

Console Lexicals
FILL

FILL
Inserts the specified fill pattern into an integer or bitvector data type
at the specified offset. The pattern is repeated the number of times
necessary to fill the length argument.

Format
FILL

(start, length, pattern, size, expression)

Arguments
start
Specifies the offset of the fill pattern in the expression. Offset is the
position of the pattern relative to the leftmost bit in the expression.

length

Specifies the total length of the inserted data.
pattern

The bit pattern to be inserted and repeated as necessary to fill the length
argument.

size

The number of bits in the pattern.
expression
The integer or bitvector into which the pattern is to be inserted.

Console Lexicals

3-11

INFORMATION

INFORMATION
Returns information about various subsystems.

Format
INFORMATION

(subsystem [, item [, select]])

Arguments
subsystem [, item [, select]]

Returned
subsystem

[, item

[, select]]

Value

BOOT_PRIMARY

The boot
primary
number as
string.

CLOCK

DISABL

State of
DISABL bit.

CLOCK

FREQUENCY

Master clock
frequency.

CLOCK

INTERVAL

Clock interval
count.

CLOCK

POSITION

CLOCK

SYNCH

Position
register.

Synch flag
value.

CPU

AVAILABLE

cpu-id or

TRUE if CPU

null (D)

is in available
set.

CPU

BOOTSET

cpu-id or
null (D)

TRUE if CPU
1s in boot set.

CPU

CDB

cpu-id or
null (D)

CDB file name.

3—-12

Console Lexicals
INFORMATION

subsystem

[, item

CPU

INITIALIZED

CPU
CPU

PRESENT
REVISION

Returned

[, select]]

Value

cpu-id or

Initialized

null (D)

state flag.

cpu-id or

Present state

null (D)

flag.

cpu-id or

CPU revision.

null (D)
CPU

STATE

cpu-id or
null (D)

state.

Current CPU

DEFAULT

Default CPU.

ENVIRONMENT

FAULT

monitor-name

Fault flag.

ENVIRONMENT

STATE

monitor-name

Current state.

MODE

BATCH or
INTERACTIVE.

POWER

FAULT

voltage-name

Group fault
flag.

POWER

MARGIN

voltage-name
'

Group margin
flag.

POWER

STATE

voltage-name

Group state.

PRIMARY

Primary unit
number as a
string.

SCOPE

Default scope
as string.

SIMULATION

TRUE if the
default unit
is DECSIM
simulation.

SYSTEM

System type
(AQUARIUS,
ARIDUS,
TESTER,
UNKNOWN).

TERMINAL

—

TTY name.

Console Lexicals

3-13

INTEGER

INTEGER
Converts a string to an integer based on the optional radix. The default
radix is decimal.

Format
INTEGER

(string [, radix])

Return Value

An integer value, in the specified radix, that is equivalent to the specified
string expression.

Arguments
string
The string expression to be converted.
radix
Controls integer interpretation, and can be one of the following:
DECIMAL

If not specified, the current default radix.

Example
>>>

"3"

>>>

INTEGER("5"TM

>>>

SHOW

SYMBOL

HEXADECIMAL)

First, the string literal "5" is concatenated with the string literal "3".
(Note that the value of symbol A is automatically substituted in a string
expression and the plus (+) is a string concatenation operator.) After the
string expression is evaluated, the character string "53" is converted to
integer value 35,6 and assigned to symbol B.

3-14

Console Lexicals
LENGTH

LENGTH
Returns the length of a string.

Format
LENGTH

(string)

Return Value

An integer value for the length of the string.

Arguments
string
The character string of which the length is to be determined.

Example
>>>

MESSAGE

>>>

STRING

>>>

SHOW

"exceeded

LENGTH

SYMBOL

STRING_LENGTH

quota"

LENGTH (MESSAGE)

STRING

LENGTH

The LENGTH function returns the length of the character string assigned
to the symbol MESSAGE, and assigns the value, 14, to the symbol
STRING_LENGTH. Note that quotation marks are not used around
symbols (for example, MESSAGE) in character string expressions.

Console Lexicals

3-15

LOCATE

LOCATE
Returns the offset of a substring within a string. Returns the length of
the string if the substring is not part of the string.

Format
LOCATE

(substring, string)

Return Value
An integer value representing the offset of the substring argument from
the first character in the string. The first character in a string is the
leftmost character and is position 0. If the substring argument is not
found, the length of the string is returned.

Arguments
substring
The string of characters to be located in the specified string. Specify the
substring as a character string expression.
string
The string in which the specified substring is to be found. Specify the
string as a character string expression.

Example
>>>

NAME

>>>

NO _LAST

>>>

SHOW

NO_LAST

"JOHN

SYMBOL

PUBLIC"

LOCATE (".",NAME)
NO_LAST

The LOCATE function returns the position of the period in the string with
respect to the beginning of the string. The period is in offset position 6,
and that value is assigned to symbol NO_LAST.

The period character is the substring argument and is specified as a string
literal (in quotation marks). The string argument NAME is a symbol and
is not placed in quotation marks. NAME is automatically replaced by its
current value.

3-16

Console Lexicals
LOGICAL

LOGICAL
Returns the translation of a logical name.
Format

LOGICAL

(logical-name)

Return Value

An equivalence string for the specified logical name. The LOGICAL
function searches process, job, group, and system logical name tables, in
that order, for the first match. If no match is found, LOGICAL returns a
null string.

Arguments
logical-name

The logical name is passed as a string expression.

Console Lexicals

3-17

MCU

MCU
Returns information about the specified MCU.

Format
MCU

(number, item [, ring])

Return Value

See the item argument description for returned values.

Arguments
number
The MCU number.

item

Returned Value

PRESENT

TRUE if MCU is present in system.

REVISION

The revision field.

RING_LENGTH

Specified CDB ring length or broadcast ring length
if ring is not specified.

SERIAL

The serial number (as a number).

STATE

MCU state (GOOD/BROKEN).

TESTED_LENGTH

Specified tested ring length or broadcast ring length
if ring is not specified.

TYPE

The type field.

VARIATION

The variation field.

ring

Optionally specifies the ring for the RING_LENGTH and
TESTED_LENGTH items. If not specified, the broadcast ring is the
default.

3-18

Console Lexicals
MEMORY

MEMORY

Returns information about the memory subsystem.
Format
MEMORY

(item)

Return Value

See the item argument description for returned values.
Arguments
item

item

Returned Value

ALLOCATED

The user name who allocated memory; otherwise, " " (null).
Currently always returns " " as there is no way to allocate

mermory.

INITIALIZED

TRUE if the memory have been initialized; otherwise,

SIZE

The highest location in main memory.

FALSE.

Console Lexicals

3-19

PARSE

PARSE
Parses a file name and extracts a specified field.

Format
PARSE

(file-spec [, default-spec] [, field])

Return Value
A character string containing the expanded file specification or the
specified field.

Arguments
file-spec
The file specification to be parsed, specified as a character string

expression. Wildcard characters can be used; if used, they appear in

the returned file specification.

default-spec
A default file specification, specified as a character string expression.
Fields in the default file specification are substituted in the output string
for missing fields in the file-spec argument.
field
The name of a field in a file specification, specified as a character
string expression. This argument returns a specific portion of the file
specification. The field name can be abbreviated. Valid keywords for the
field name are as follows:

Keyword

Field Returned

NODE

Node name

DIRECTORY

Directory name

DEVICE

NAME
TYPE
VERSION

Device name

File name
File extension
File version

NOTE
No punctuation is returned with the type and version fields.

3-20

Console Lexicals
PARSE

Examples
]

>>> SET DEF DUAO: [CONSOLE]
>>> DIAG = PARSE("TEST1.CMD"," [PROCS]")
>>>

SHOW

SYMBOL

>>> DIAG =

DIAG

"DUAOQ: [PROCS]TEST1.CMD;"

The default device and directory are DUAQ:[CONSOLE]. Because the
directory name [PROCS] is specified as the default-spec argument in the
assignment statement, it is used as the directory name in the output
string. Note that the default device returned in the output string is
DUAO and the default version number for the file is null. The arguments
TEST1.CMD and [PROCS] are placed in quotes because they are string
literals.

>>> SET DEFAULT DUAQ: [CONSOLE]
>>> DIAG = PARSE("TEST1.CMD",, "DIRECTORY")
>>>

SHOW

>>> DIAG

SYMBOL

DIAG

"[CONSOLE]"

PARSE returns the directory name of file TEST1.CMD. Note that the
default-spec argument’s place in the argument list is delimited by a
comma when the argument is omitted.

>>> DIAG = PARSE ("SERE::DUAQO: [CONSOLE]TEST1.CMD",, "DEVICE")
>>>

SHOW

SYMBOL

>>>

DIAG

"DUAQ:"

A file specification containing a node name is parsed for the DEVICE field
and returns DUAO:.

Console Lexicals

3-21

PART

PART
Returns the specified element’s part identifier as a string. See also the
SERIAL and REVISION lexicals.

Format
PART

(

element

element, arg

)

Return Value
The specified element’s part identifier as a string.

Arguments
element

element

arg

AIE

None.

AIO

None.

DAC

Specifies which DAC.

MAC

Specifies which MAC.

MCM

None.

MCU

MCU name or number (for example, VAP or 4).

PEM

None.

PLANAR

Specifies CPUn or SCU. If not specified, default scope unit is used.

RIC

Specifies which RIC, as in 0x52, and so on. This includes CPRIC
and IORICs.

SCM

None.

SPM

None.

arg

See the element argument table.

3-22

Console Lexicals
POWER

POWER
Returns information about system power.
Format

POWER

(item, [bus/cabinet])

Return Value

See the item argument description for returned values.
Arguments
item

item

Returned Value

ALLOCATED

User who allocated PCS or " " (null) if not allocated.

FAULT

FAULT state.

MARGIN

HI/LO/NOMINAL.

STATE

TRUE/FALSE.

bus/cabinet

The bus argument is one of the following:
AB,C,D,E,FG H,Iord

Valid bus arguments depend on system configuration.
The cabinet argument is one of the following:
CPA, CPB, SCU, IOA, or IOB

If bus/cabinet are not specified, the returned value is the ORed result of
all the buses.

Console Lexicals
RADIX

RADIX
Returns the string name of the current radix.

Format
RADIX

()

Return Value
The current radix is returned as one of the following strings:
BINARY
DECIMAL
HEXADECIMAL
OCTAL

3-23

3—-24

Console Lexicals
REVISION

REVISION
Returns the specified element’s revision string. This is the part of the
string following the part number. For example, if the part number is
nn-nnnnn-nn./lnn, Il is returned. See also the PART lexical.

Format

REVISION ( element,
Slement arg )
Return Value

The specified element’s revision string.

Arguments
element

element

arg

MCU

MCU name or number (for example, VAP or 4).

KERNEL

None.

arg

Specifies which MCU.

Console Lexicals

SCI

SCI
Returns an integer data type with the value of the specified SCI line.

Format
(line, port)

SCIl

Return Value

The last value set with the SET SCI command on the specified line.

Arguments
line
Specifies one of the following SCI lines:

BROADCAST
BYPASS
CDS
DATA_IN
DATA_OUT
FUNCTION
SELECT
port

Specifies one of the following SCI ports:
CPUO
CPU1
CPU2
CPU3
SCU
MEM

3-25

3-26

Console Lexicals
SCU

SCU
Returns information about the SCU. See also the CPU lexical.

Format
SCU

(item)

Return Value

See the item argument description for returned values.

Arguments
item

item

Returned Value

ALLOCATED

User who allocated SCU or " " (null) if not allocated.

BROKE

TRUE if the unit is broken.

CDB

CDB file name.

CLOCK

TRUE if unit’s clock is running.

DEFAULT

Default CPU as a string.

HARD

TRUE if the unit has passed the hard-core tests.

INITIALIZED

TRUE if unit is initialized.

POWER

TRUE if the unit has power.

REVISION

Revision string for this unit.

RUN

TRUE if the unit is running.

SENSE

TRUE if this unit has been SENSED.

STATE

The UCB state bits as a number.

Console Lexicals

3-27

SEARCH
Scans a directory and returns expanded file names that match the input
file-spec.

Format
SEARCH

(file-spec)

Return Value
A character string containing the expanded file specification for the filespec argument. Each time the SEARCH lexical is called with the same
file-spec argument, it returns the next expanded file specification that
matches the argument. After the last file-spec match or if the file is not
found in the directory, a null string is returned.

Arguments
file-spec
The file specification to be searched for, specified as a character string
expression. If not specified, default device and directory are used.
Defaults are not supplied for file name or type. If the version number
is not specified, the file specification with the highest version number is
returned. Wildcards can be used.

Example
$

START:

FILE

SHOW SYMBOL FILE

GOTO START

FILE

SEARCH("SYSSSYSTEM:*
,EXE")

.EQL.

THEN EXIT

This command procedure displays the file-specs of the latest version of
all .EXE files in the SYS$SYSTEM directory. (Only the latest version
is returned because a wildcard is not used as the version number.) The
file-spec argument SYS$SYSTEM:*
. EXE is a character string expression
and is placed in quotation marks.

3-28

Console Lexicals
SERIAL

SERIAL

Returns the specified element’s serial number as a string. See also the
PART lexical.

Format

SERIAL

( element
element, arg

)

Return Value

The specified element’s serial number as a string.
Arguments
element

element

arg

AlIE

None.

AIO

None.

DAC

Specifies which DAC.

MAC

Specifies which MAC.

MCM

None.

MCU

MCU name or number (for example, VAP or 4).

PEM

None.

PLANAR

CPU or SCU or null to use default scope unit.

RIC

Specifies which RIC, as in 0x52, and so on. This includes CPRIC

SCM

None.

SPM

None.

and IORICs.

arg

See the element argument table.

Console Lexicals
SID

SID
Returns the system ID.

Format
SID

(fitem])

Return Value
See the item argument description for returned values.

Arguments
item

item

Returned Value

SIDEX

SPM SIDEX register.

SPM

SPM system ID register.

SYSTEM

System ID (default if item is not specified).

3-29

3-30

Console Lexicals

SIGNAL

SIGNAL
Returns the value of a signal.

Format
SIGNAL

(signal-name)

Return Value

The value of the specified signal.

Arguments
signal-name
A string expression that is a valid signal name.

Console Lexicals

3-31

STRING

STRING
Converts an integer expression to a string.

Format
STRING

(expression [, radix])

Return Value
A character string that is equivalent to the specified expressi

on.

Arguments
expression

The expression to be evaluated using the specified radix.
Leading zeros
are dropped, and a minus (-) is placed at the beginni
ng of the string

representation of a negative number.

radix

Controls integer interpretation, and can be one of the

following:

DECIMAL (D)
HEXADECIMAL
OCTAL

Example
>>>

>>>

STRING (-2

>>>

SHOW

n3w

SYMBOIL

"A’)

First, the expression (-2 + *a’) is evaluated. Note that 5, the
value of
symbol A, is automatically substituted when the integer
expression is
evaluated. Next, the resulting integer, 3, is converted
to the string "3"
and assigned to symbol B.

NOTE
Assuming the default radix is hexadecimal, symbol
A must be
enclosed in quotes to distinguish it from Asq.

3-32

Console Lexicals
SWITCH

SWITCH

Returns information about the operator control panel switches.
Format

SWITCH

(item)

Return Value

See the item argument description for returned values.
Arguments
item

item

Returned Value

BOOT

Boot switch state.

ACCESS

Access switch state.

Console Lexicals
TIME

TIME
Returns the current date and time string.

Format
TIME

()

Return Value
The current date and time string.

3-33

Console Lexicals

3-34

UPC

Returns the current microPC of the specified control store.
Format

UPC

([control-store])

Return Value

The current microPC of the specified control store.
Arguments
control-store
One of the following:

ECS = EBox control store
JCS = JBox control store

If not specified, the control store of the selected window. (See the SELECT
command description in Chapter 2.)

Console Lexicals

3-35

VERIFY

VERIFY
Returns an integer value indicating whether the procedure verification
flag is currently on or off. If used with arguments, the procedure
verification flag can be turned on or off.

Format
VERIFY

[(expression)]

Return Value
The integer O if the procedure verification flag is off, or the integer 1 if the
procedure verification flag is on.

Arguments
expression
An integer expression with a value of 0 to turn the procedure verification
flag off, or 1 to turn it on. When specified, the VERIFY function first
displays the current flag state, then turns procedure verification on (1) or
off (0) as specified by the argument.

When procedure verification is on, each command line in the procedure is
displayed.

A
Command Quick Reference
General Syntax:

VERB [/qualifiers] object [parameters]
(D) = default

symbol-name :=[=] string
symbol-name =[=] expression

@ file-spec [p1 [p2 [ ... p8IlI

ALLOCATE

CPU=cpu-id
MCM

PCS

SCU
[ /Bl=node-id

/NODE=node-id
/INOJPIO_MODE(D)

BOOT | /R3=register-data
/R5=boot-flags
/INOISTART(D)

| /XMI=xmi-id

[device]

]

CALL label
CLOSE logical-name

/CPU=cpu-id
/INOILOG

CONTINUE | /NOIPIO. MODE(D

)

/PIO_PORT={OPAO | OPA1}

A-2

Command Quick Reference

/INO(D)ICONFIRM

COPY | /CONTIGUOUS

input-file-spec output-file-spec

/INO(D)ILOG

CREATE [/INO(D)ILOG] file-spec

CREATE/DIRECTORY [/[INO(D)JLOG] directory-spec
W

" /CPU=cpu-id

/ECS

CREATE/WINDOW | /jCS

H1 ... H2

/EXAMINE
/ODOMETER
/INOJUPDATE(D)

window-name | AT 4

Q..

“""mg

L /VIEWONLY

CPU=cpu-id
MCM

DEALLOCATE PCS

SCU

DEASSIGN [/PROCESS(D) ] [logical-name]
/ALL

/SYSTEM

DEBUG [/[INOJCONFIRM(D)]
/[INOJLOG(D)
DEFINE [/PROCESS(D) logical-namel:] equivalence-string
/SYSTEM

El1... E6
F6 ... F14
Help
Do

DEFINE/KEY [/LOG

/INOJECHO(D)

/INO(D)ITERMINAL

F17 ... F20
] PF1 ... PF4 equivalence-string

KPO ... KP9
PERIOD
COMMA
MINUS
ENTER

Command Quick Reference

/INO(D)ICONFIRM

DELETE | INODILOG

] file-spec

/ALL
/CPU=cpu-id
DELETE/PATTERN | /[NOD)ILOG | [pattern-name]
/RESET
/INOISCU
/ALL

DELETE/SYMBOL E(I)'gELA(]f))

[symbol-name]

INOD)ILOG
/ALL
/CPU=cpu-id
DELETE/TRACE | /INO(D)ILOG | [tracepoint-name]
/RESET
/INO]ISCU
/ALL
/CPU=cpu-id
DELETE/WATCH | /INO(D)ILOG | [watchpoint-name]
/RESET
/[INOISCU

DELETE/WINDOW [(fiifif{ow-name ]

A-3

A—4

Command Quick Reference

" /PHYSICAL
/SPU
/VIRTUAL
/ECS
/EREG
/GENERAL
/INTERNAL
/JCS
/VECTOR-=register:element
/ASCII
/BYTE
/D_FLOAT
/F_FLOAT
/G_FLOAT
/LONGWORD(D)
/OCTAWORD
/QUADWORD
/WORD
DEPOSIT

/LENGTH-=bits
/RING
/NEXT[=count]
/CPU=cpu-id
/INO(D)ISCU
/INOJLOG
/INOIJVERIFY
/MCM
/PEM
/RIC=ric-id
/SCC
/SJA

/CODE
/EMEMORY
/IMEMORY
/PORT_REGISTER
L/REGISTER

address-expression value-expression

Command Quick Reference

" /DATE
/FULL
/OWNER
DIRECTORY
/PROTECTION

[file-spec]

/SIZE
L /TOTAL

DISMOUNT [/[INOJUNLOADY] device-name[:]

/INOICOMMAND(D)[=command-file]
/INOICREATE(D)

EDIT | /INOJJOURNAL[=journal-file]

input-file-spec

/INOJOUTPUT[=output-file]
/RECOVER

EVALUATE

/DISPLAY=radix-spec
/RADIX=radix-spec

expression

A-5

A-6

Command Quick Reference

- /PHYSICAL
/SPU
/VIRTUAL

/ECS
/EREG
/GENERAL
/INTERNAL
/JCS
/VNECTOR-=register:element

/ASCII[=count]
/BYTE
/D_FLOAT
/F_FLOAT
/G_FLOAT
/INSTRUCTION
/LONGWORD(D)
/OCTAWORD
/QUADWORD
/WORD

EXAMINE

/LABEL

address-expression
signal-name

/LENGTH=Dbits
/RING

structure-name

/NEXT[=count]

/CPU=cpu-id
/INO(D)ISCU
/INOJLOG
/SYMBOL=name
/WINDOW[=window-name]
/MCM
/PEM
/RIC=ric-id
/SCC
/SJA

/CODE
/EMEMORY
/IMEMORY
/PORT_REGISTER
L/REGISTER

Command Quick Reference

/FAULT

FIND

[status-code]

/CPU=cpu-id
/MEMORY

/RPB

[blocks]

GOTO label
HALT [/CPU=cpu-id]

HELP [topic . oo ]
IF expression THEN command

!' /CLOCK

/CPU=cpu-id
/10
/KERNEL [/BRIEF]

/BANK_MASK=mask
/INTERLEAVE=type
/MEMORY | /INOJOUTPUT=file-spec
/INOJRESTORE-=file-spec
/INOITEST(D)

/POWER
/FIRMWARE-=file-spec
/[INOILOG

INITIALIZE

/SCAN | NOIRESET

/SCU [/BRIEF]

- /INOIDEBUG

/FIRMWARE-=file-spec
/INOILOG

/SCM | /SUNDANCE

/TIMEOUT=seconds
I /WPT_AREA:kbytes

/INOIDEBUG
/SJA | INOILOG

/INOJSIMULATION

| /VOLUME

A-7

A-8

Command Quick Reference

/INOJEXPRESSION

INQUIRE [ [NOISTRING

prompt-string

| Symbol-name. poopecvmbol
)

LABEL: [command]

/MAIN_MEMORY(D)
LOAD | /RIC=ricid

| 1 /cPU=cpu-id

oG TM
ffi(‘)’]lsségm"ersmn
/START=address

/RING{=ring-id]
CTURE
/STRU
/TEXT

eSTOR

file-spec

/INOISYMBOL

LANOIVERIFY

LoGoUT [ 2T, |
/BRIEF

/FILE=file-spec

recipient]

MAIL | /INOJSELF

/SUBJECT="string"

MICROSTEP

file-spec gocipient-list

/INOIBURST
/CPU=cpu-id

/INOISCU

step-count

/INOISPACEBAR(D)

MOUNT device volume-name
/CPU=cpu-id

NEXT | /INOJSPACEBAR(D) | [step-count]
/INOIVIRTUAL

ATTN
ERROR

ON FAULT

THEN command

SEVERE
WARNING

/APPEND
/ERROR=label

OPEN | /[NOILOG
/READ(D)
/WRITE

logical-name file-spec

Command Quick Reference

PURGE [/KEEP:number

/INO(D)ICONFIRM

/INOD)ILOG

A-9

} [file-specl, . .. Il
_

e
/END_OF_FILE-=label ] logical-name
READ [ /ERROR=Iabel
symbol-name
REBOOT /INOIJCONFIRM(D)
RECALL [/ALL | command | index]

RENAME [ ;{ggggg}gggl?IRM ] input-file-spec[, . . . ] output-file-spec
REPEAT [/COUNT=number] command

/CPU=cpu-id ]

RESET | /05sa0
RESTORE

/CPU=cpu-id
/NOJSCU
/INOISPU

RETURN

r INOIDEBUG
/INOIDETACHED
/JOB_PRIORITY=level
/KERNEL_STACK=size
/INOJLOAD
RUN | /MAXIMUM_MESSAGES=number | file-spec [command-line]
/MODE={KERNEL | USER}
/PARAMETERS="string"
/INOJPOWER_RECOVERY
/PROCESS_PRIORITY=number
L /[USER_STACK=size

SAVE

/CPU=cpu-id
/[NOJSCU
/INOISPU

SCROLL

" /CURRENT
/DOWN[=lines](D)
/LEFT[=columns]
/NEXT[=lines]
/PREVIOUS[=lines]
/RIGHT[=columns]
/TO=address
| /UP[=lines]
i

[window-name]

A-10

Command Quick Reference

w1
H1l... H2

SELECT [/NEXT] | window-name | AT T1 ..

Ql... Q4
/ALL

SEND

.
—y
[terminal-name] string

L
/BEL
JOPCOM
/URGENT

CLOCK
CPU=cpu-id
SENSE

10
POWER

SYSTEM | /060G ]
/COMPARE

SET ATTN_ACTION command

SET AUTOBOOT {ON | OFF}

}
SET BI_DEVICES [ file-spec
devicel, . .. ]
SET BOOTFLAGS value
/ENABLE=(cpu-id [, ... D

SET BOOTSET | /DISABLE=(cpu-id [, ... ]) ] cpu-id [, ... ]
/PRIMARY=cpu-id

" [NOJATTENTION(D)=attention-name ]

/CPU=cpu-id
/INOJEMULATION
/FREQUENCY=value
/INTERVAL=cycles
SET CLOCK
/INOILOG
/POSITION=value
/SAMPLE_RATE=hertz
/INOISCU
| /SYNCH-=synch-option

SET COLD_START [/CPU=cpu-id] {ON | OFF}

oG ] file-spec
SET COMMAND | /-0
/CLEAR

[ON(D) | OFF]

Command Quick Reference

SET CPU [/[NOILOG(D)]

0...3
BOOTPRIMARY
PRIMARY

/CPU=cpu-id
SET CYCLE | /INTERVAL=value | count
/INOISCU

SET DEFAULT directory-spec]:]
/INOIMATCH
SET ERROR_HANDLING | /NOJRECOVERY
/INOJREPORTING

] {ON | OFF}

SET FAULT _ACTION command
/CPU=cpu-id
SET ISOLATION { /LLOG

/SYBIL

] file-spec

SET KEEP_ALIVE [/CPU=cpu-id] {ON | OFF | MANUAL}
SET LABELS {ON | OFF}

SET LOGGING

/ALL
/DISABLE
/ENABLE
/FILE=[file-spec]
/INOJFACILITY
/[NOJIDENT

SET MESSAGE 00 SEVERITY

{ON | OFF}

[file-spec]

/INOITEXT

SET PATTERN

[ /ABSOLUTE
/ALL
/CPU=cpu-id
/DISABLE
/ENABLE
/FILE=file-name
/INOILOG
/NAME=pattern-name
/ODOMETER[=window-name]
/RELATIVE
/INOISCU
/SYBIL
L [INO]JVERIFY
[/SYBIL pattern-name)

@file-name
pattern-name

signal-list

A-11

A-12

Command Quick Reference

SET PERSONAL_NAME "string"
r [INOJATTENTION=classl, . . . ]
/BUS=bus-name

SET POWER

/CABINET=cabinet-id

[ON(D) | OFF]

JCOUNTERS

b[NO]MARGIN:margin-keyword .
10O

SET PROMPT [prompt-string]
HEXADECIMAL
DECIMAL
SET RADIX OCTAL
BINARY

SET REMOTE [/[INOJPASSWORD-=string} {ON | OFF}
/0S

SION
ET REVISI
SET

. ]
AR [ /CPU=cpu-id

i
ision-str
tring
revision-s

/SCU

" INOIBROADCAST={0 1 1} ]
/NOIBYPASS={0 | 1}

/INOICDS={0 | 1}
/CLOCK=state
SET SCI | /DATA={0 I 1}
/DEFAULT
/FUNCTION=state
/PORT=port-id

| /SSELECT={0 | 1}

- INOJATTENTIONS=mask

SET SCM

/INOJBI_VERIFY
/INOIBYPASS
/INOICACHE
/RATE=scan-rate

/INOJSCAN_VERIFY

[[NOIVECTOR_PROCESSOR=mask

| INOIVERIFY

SET SCOPE [/[NOILOG] label-spec
SET SCREEN {ON(D) | OFF}

Command Quick Reference

A-13

/AIE
/ATIO

SET SERIAL /DAC /IDENTIFIER=dac-number]

LAN

/SCM

AR [/SCU

/CPU=cpu-id

]

10 gigit-serial-number

/CPU=cpu-id
SET SNAPSHOT | /FILENAME=file-spec | {ON | OFF | TRIGGER
}
/INOISCU

SET SOURCE directory
SET STEP {INSTRUCTION(D) | NOINSTRUCTION}
" INOIBROADCAST(D)
/CPU=cpu-id
/DEVICE={LA100 | VT200)
/INOIECHO(D)
/NOIEIGHTBIT

/INOJESCAPE
.
SET TERMINAL |/pYPAD_{APPLICATION | NUMERIC) | [ferminal-name]
/PAGE-=lines
/PIO_PORT={OPAO | OPA1]
INOTPROGRAM
JINOITALK MODE
L /WIDTH=characters

SET TIME time-string
[ /ABSOLUTE

/ALL
/COMPARE
/CPU=cpu-id
/DISABLE
/ENABLE
/FILE=file-spec
SET TRACE | /FROM=cycle
/INOILOG
/NAME-=tracepoint-name
/ODOMETER|[=0odometer-window-name]
/RELATIVE
/INOISCU
/TO=cycle

| VECTOR

SET VERIFY {ON(D) | OFF}

SET WARM_START [/CPU=cpu-id] {ON | OFF)}

signal-list
@signal-file

A-14 Command Quick Reference

" /ALL

/CPU=cpu-id
/DISABLE
/ENABLE
/FROM=cycle
SET WATCH
/INOILOG
/NAME=watchpoint-name
/INOISCU
| /TO=cycle

signal-list
@signal-file

SET XMI_DEVICES [file-spec]
SHOW ATTN_ACTION
SHOW AUTOBOOT
SHOW AVAILABLE
SHOW BATCH

SHOW BBU

SHOW BI_DEVICES
SHOW BOOTFLAGS
SHOW BOOTSET

SHOW CLOCK [/FULL]
" /CLOCK
/CPU=cpu-id
/DATE=date
/KERNEL

SHOW CONFIGURATION

/MCU=mcu-id
/MEMORY
/OUTPUT<=file-spec
/POWER
/RINGS
/SCU
/SPU
/SYSTEM

| /XMI=xmi-id

DO command

Command Quick Reference

SHOW CPU [ /ALL

/FULL ] lepu-id]

SHOW CYCLE [/CPU=cpu-id ]
/INOISCU

SHOW DEFAULT

SHOW DEVICE [device-name]

/CONTINUOUS

]

SHOW ENVIRONMENT [ /INTERVAL=seconds
/OUTPUT=file-spec

SHOW ERROR_HANDLING
SHOW FAULT_ACTION

SHOW FLAGS [/CPU=cpu-id]
[ [INOIBINARY
/CPU=cpu-id
/INOJIINSTRUCTION
/MAXIMUM-=locations
SHOW HISTORY
/OUTPUT=file-spec
/PHYSICAL
/INOJSCU
/VIRTUAL
| /WINDOW[=window-name]

SHOW ISOLATION [ /MCU=mcu-id

/CPU=cpu-id

/SYBIL

SHOW KEEP_ALIVE

SHOW KEY

/ALL
El1...E6
F6 ... Fl14
Help
Do
F17 ... F20
PF1... PF4
KPO ... KP9

[broadcast-ring-bit-number]

A-15

A-16

Command Quick Reference

SHOW LOGGING
/ALL

/PROCESS | [logical-namel]

SHOW LOGICAL

/SYSTEM

SHOW MEMORY

SHOW MESSAGE [message-id]
SHOW MODE

SHOW NODE

/CPU=cpu-id
/NODE=node-id

SHOW PATTERN | /REMOTE

[pattern-name]

/INOISCU
/SYBIL

SHOW PERSONAL
r /BUS=bus-name

/CABINET=cabinet-id
/CONTINUOUS
SHOW POWER | /COUNTERS
/INTERVAL=seconds
/10

| /OUTPUT=file-spec

SHOW PROCESS
SHOW RADIX
SHOW REMOTE

/INOIDATA_ONLY

SHOW SCI | /poRT=port-id

/BAD_PAGE_MAP
/ENTRY_BLOCK

SHOW SCM /ERROR_BLOCK
/MEMORY

Command Quick Reference

SHOW SCOPE
SHOW SCU
SHOW SJA

SHOW SOURCE

SHOW STEP

SHOW STRUCTURE | MPAMM

SHOW SWITCHES

[;g&i;&%kid |

A-17

A-18

Command Quick Reference

" /ALL(D)
/GLOBAL
/LOCAL

/BP
/CACHEO
/CACHE1
/ECCO
/ECC1
/ECS
/EREG
/FRAM

SHOW SYMBOL | /ZiMM
/MPAMM
/NPAMM
/PCHB
/TAGO
/TAG1
/TAGRM
/TBRAMS
/VALIDRAMS
IVIC
/VICA
/VICB
| VREG

[symbol-name]

SHOW SYSTEM [/INOJPROCESS]
SHOW TERMINAL [terminal-name:]
SHOW THRESHOLD
SHOW TIME

SHOW TRACE [;g&g‘gg’ld ] [tracepoint-name]
SHOW USERS
/ALL

/CLI(D) /FACILITY=name]
SHOW VERSION | /CLOCK
/RTL [/FACILITY=name]
/SCM

Command Quick Reference

SHOW WATCH [;g&;‘g’gld ] [watchpoint-name]
SHOW WINDOW [window-name]

SHOW XMI_DEVICES

SHOW ZONE
/CPU=cpu-id
/INOILOG
/INOIPIO_MODE(D)
/PIO_PORT={OPAO | OPA1}

START

STOP

/JOB=port-id
/PROCESS=process-id
/SCM

address-expression

process-name

SUBMIT [/LOG] command-procedure-file
TALK terminal-name

/NO(D)ICONFIRM
TYPE [ INOIPAGE
D
] file-specl, . . . ]

UNJAM [/XJA=xja-id]

/MAIN_MEMORY
/PEM

VERIFY | p1Ceric.id

/STRUCTURE

/CPU=cpu-id
/END=address

/INOJLOG

/START=address

WAIT time
WRITE [/NOCRLF] logical-name string-expression

X address count

/Bl=node

Z | /SPU=node
node

]

file-spec

A-19

Lexical Function Quick Reference
VERB (argument [, optional-argument], ... )
(D) = default
ARG1

General Syntax: { ARGn }: Select one required argument.
ARG1 )
.os
= Select one optional argument.
ARGn |

[ number

)

BACKSPACE
BELL
ESCAPE
FORMFEED

ASCII( { LINEFEE

(

NEWLINE
RETURN
TAB

| VERTICAL_TAB

BITVECTOR (expression [, length])

- DISABL
EMULATION
FREQUENCY

CLOCK (| INTERNAL
POSITION

| SYNCH

2
)

B—1

B-2

Lexical Function Quick Reference

r ICU

CONFIG ( fi

L XJA2
XJA3

ALLOCATED
AVAILABLE
BOOT_SET
BROKE
CDB
CLOCK
COLD_START
DEFAULT
HARD
INITIALIZED
POWER
PRESENT
REVISION
RUN
SENSE
STATE
L WARM_START

TM~

CPU (

)

ICU0
ICU1
MMU
MMUO
MMU1
XJA
XJAO
XJA1

L [, cpu-id] )

EXTRACT (start, length, string)
FIELD (start, length, expression)

FILL (start, length, pattern, size, expression)

Lexical Function Quick Reference

[

BOOT_PRIMARY

[

INFORMATION ( 1«

B-3

DISABLE
FREQUENCY

CLOCK

CPU

AVAILABLE
BOOTSET
CDB
INITTALIZED
PRESENT
REVISION
STATE

INTERVAL
POSITION
SYNCH

cpu-id’
null(D)

DEFAULT

FAULT
ENVIRONMENT [ , STATE

][, monitor-name]

MODE

POWER [ , MARGIN ] [, voltage-name]
FAULT

STATE

PRIMARY
SCOPE
SIMULATION
SYSTEM
\ TERMINAL

HEXADECIMAL

INTEGER (string | ,

DECIMAL
ObraL
BINARY

LENGTH (string)

LOCATE (substring, string)

LOGICAL (logical-name)

)

B—4

Lexical Function Quick Reference

( PRESENT
REVISION
RING_LENGTH [, ring]
SERIAL
MCU( number, ?
STATE
TESTED_LENGTH [, ring]
TYPE

| VARIATION

MEMORY ( { INITIALIZED b
ALLOCATED
SIZE

DEVICE
DIRECTORY

PARSE (file-spec [, default-spec]

PART ( T

NAME
NODE
TYPE

VERSION

AIE
AIO
DAC, dac-id
MAC, mac-id
MCM
MCU, mcu-id
PEM
CPU

PLANAR [,

SCU

]

RIC, ric-id
SCM
L SPM

POWER ( fi

STATE | ,

“ETOEEBOOQW
>

( ALLOCATED
FAULT
MARGIN

CPA

I0A
IOB
SCU

)

Lexical Function Quick Reference

RADI()
X

REVISION ( { FERNEL

MCU, mcu-id

BROADCAST )
( BVPASS

( CPUO )

oDS

DATA_OUT

FUNCTION

( ALLOCATED
BROKE
CDB
CLOCK
DEFAULT
HARD

fifi

CPU1

SCI( { DATA_IN
| SELECT

811;33

})

MEM

| scn

)

SCU( 5 INITIALIZED })
POWER
REVISION
RUN
SENSE

| STATE

)

SEARCH (file-spec)

( AIE
AIO
DAC, dac-id
MAC, mac-id
MCM

‘

SERIAL( { MCU, mcu-id

RIC, ric-id
SCM

[ SPM

)

B-5

B—6

Lexical Function Quick Reference

SIDEX
SID ( { SPM
SYSTEM

)

SIGNAL (signal-name)
HEXADECIMAL

STRING (expression | , DECIMAL(D)
OCTAL

SWITCH( { ACCESS
855155
1)
TIME ()

null
UPC({ ECS
JCS

¢)

VERIFY [(expression)]

)

Index
AIE, SET SERIAL,

2-173

AIO, SET SERIAL,

2-173

ALLOCATE,

2-2

and DEALLOCATE,

ALL qualifier,

2-24

1-5

Arithmetic operators,

1-11

ASCII

Address

ASCII lexical,

mnemonics

DEPOSIT,

2-50

EXAMINE,

2-70

space qualifier,

2-67

/CODE,

2-46, 247, 2-65,

2-46, 2-47, 2-65,

2-67

/EMEMORY,

2-46, 2-47,

2-65, 2-67
external memory,

2-46,
2-47, 2-65, 2-67

/IMEMORY,

3-2

string

2-46, 2-47,

DEPOSIT,

2-43

EXAMINE,

2-62

Assign
string (:=),

2-3

symbol (=),

2-5

and DELETE/SYMBOL,
2-36
At (@, execute procedure),
Available set,

2-7

1-4

SHOW AVAILABLE,

2-196

2-65, 2-67

internal
memory,

2-46, 2-47,

2-65, 2-67
register,

2-46, 247,

2-65, 2-67

physical,

2-46, 2-66

port register,

2-46, 2-47,
2-65, 2-67

/PORT_REGISTER,

2-46,

247, 2-65, 2-67
program,

2-46, 2—47, 2-65,

2-67

DEPOSIT,

243

EXAMINE,

2-62

/REGISTER,

2-46, 247,

2-65, 2-67

virtual,

2-48, 2-68

Batch, SHOW BATCH, 2-197
BBU (battery backup unit), SHOW
BBU, 2-198
BI

BOOT,

2-9

device
SET BI_DEVICES, 2-131
SHOW BI_DEVICES, 2-199
node, Z, 2-277
protocol, Z,

2-277

Bitvector

BITVECTOR lexical,

data type,

3-3

1-12

FIELD lexical,

3-9

Index

Boolean operators, 1-11
Boot

BOOT, 2-9

and REBOOT, 2-104

primary

CPU,

SET CPU, 2-141

set, 14
SET

AUTOBOOT, 2-130
BOOTFLAGS, 2-132
BOOTSET, 2-133

SHOW

AUTOBOOT, 2-195
BOOTFLAGS, 2-200
BOOTSET, 2-201

Bus

I/O, table, 2-159
power, table, 2-158

C
Cabinet. See System, cabinet power
Cache threshold

SHOW THRESHOLD, 2-255

CALL, 2-11

CDB (configuration database), 2—44
LOAD, 2-88

CIO (console I/0), xi, 2-265
CLI (command language
interpreter), 1-9
Clock

CLOCK lexical, 3—4

cycle count

SET CYCLE, 2-142
SHOW CYCLE, 2-208

emulation, SET CLOCK, 2-136
frequency, SET CLOCK, 2-136
INITIALIZE, 2-81
interval

SET CLOCK, 2-136
SET CYCLE, 2-142

MCM

ALLOCATE, 2-2

Clock

MCM (cont’d.)

DEALLOCATE, 2-24
DEPOSIT, 2-45
EXAMINE, 2-65

OFF, SET CLOCK, 2-137
ON, SET CLOCK, 2-137

position, SET CLOCK, 2-136

sample rate, SET CLOCK, 2—-137
SCI, SET SCI, 2-166
SCU

MICROSTEP, 2-94
SET CLOCK, 2-137

SENSE CLOCK, 2-122
SET CLOCK, 2-135
SHOW
CLOCK, 2-202

CONFIGURATION, 2-203
synch, SET CLOCK, 2-137

CLOSE, 2-12
and OPEN, 2-99
Cold-start

flags, SHOW FLAGS, 2-216
SET COLD_START, 2-139

Command

language interpreter. See CLI
confirmation, 1-5
responses, 1-5
format, 1-1
object, 1-1
parameter, 1-1

qualifier, 1-1, 1-3
See also Qualifier
/ALL,

1-5

confirmation, 1-5

/CPU, 14