Digital PDFs

AV-H435D-TC

2000

260 pages

Original

14MB

view download

OCR Version

10MB

view download

Document:	RSX-11M-PLUS Mini Reference Version 3.0
Order Number:	AV-H435D-TC
Revision:	0
Pages:	260
Original Filename:

OCR Text

MinNi
Reference

soffiore

()¢S

RSX-11M-PLUS
Mini-Reference
Order No. AV-H435D-TC

RSX-11M-PLUS Version 3.0

digital equipment corporation - maynard, massachusetts

First Printing, September 1977
Revised, April 1982
Revised, April 1983

Revised, July 1985

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

poration 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.

responsibility is assumed for the use or reliability of software on equipment that is not
supplied by Digital Equipment Corporation or its affiliated companies.

The following are trademarks of Digital Equipment Corporation:

DATATRIEVE
DEC

Micro/RSTS
Micro/RSX

DECmate

RT
UNIBUS

PDP

VAX

DECnet
DECUS

DECwriter
DIBOL

PDT
.

P/OS

Professional
Q-BUS

FMS-11

Rainbow

MicroPDP-11

RSX

MASSBUS

RSTS

VAXcluster
VMS

vT
Work Processor
i

mflgnau
ZK2551

Contents
Page

PREFACE

ON-LINEHELPFILES . . . .
UTILITIES
BAD Command Summary
BRU Command Summary

.
.
CMP Command Summary .
DMP Command Summary .

e \

. . . .

. ...

... 1

.
.
.
.

.« . o0 3
. « « o v v v v v v 5
v vt v v v v v v v s 9

.
.
.
.

.
.
«
.

. . .
. . .
« « «

. « v v v v v e n ..
DSC Command Summary. . . . . . .+ v v v v v v
e e
Line Text Editor (EDI) Commands . . . . . . . . . . . . . . ..

DIGITAL Standard Editor (EDT) Commands . .
FLX Command Summary. . . . . . . . . . « «
FMT Command Summary . . . . . . . . . « «
LBR Command Summary. . . . . . . . . . . «
SLP Command Summary. . . . . . . . . . . .
PAT Command Summary. . . . . . . . « . « v
Peripheral Interchange Program (PIP) Commands
Queue Manager Commands. . . . . . . . . . .
ZAP Command and Switch Summary . . . . . .
COMMAND LINE INTERPRETERS
Monitor Console Routine (MCR) Commands. . .
DIGITAL Command Language (DCL) Commands
SYSTEM MANAGEMENT TOOLS

Error Logging System.

. . .
« v v
¢« v v
« v v
. .«
v « v
. . .
...
. . .

. . . . . .
v v v v o
o« o« o v
o o v ...
...
v o v v v
. . . . . .
...
. . .. ..

. . .
. . .

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

13
17
19
27
39
43
46
47
49
b1
59
63

67
83

. . . . . . . . .. . .. [ 123

Procedure for Halting a Job in a Print Queue

. . . . . . . . . .. 129

PROGRAMMING TOOLS

On-Line Debugging Tool (ODT) Commands . .
Task Builder (TKB) Switches and Options. . .

. . . . . . . . .. 131
. . . . . . . . .. 137

RMS-11

RMSBCK Utility Summary.
RMSCNYV Utility Summary.
RMSDES Utility Summary .
RMSDSP Utility Summary .

.
.
.
.

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

.
.
.
.

. . . . . . ... 147
. . . . .« .
... 149
. . . . .. .. .. .. 151
. . . . .
.. 157

RMSIFL Utility Summary . . . . . . . . . . . ..
RMSRST Utility Summary . . . . . . . . . . . .. .

... .. 159
. ... 161

RMS-11 Completion Codes and Fatal Error Codes . e e 163

Contents

REFERENCE INFORMATION

ASCII Character Set .
Directive Error Codes.

. 173
. 175

Executive Directive Summary.

I/O Error Codes

. . .

. 177

. .

RADIX-50 Conversion Table

Octal/Decimal Conversion Table.
Standard File Types

. 239

. 241
. 242

PREFACE
Manual Objectives

This manual provides a quick reference guide to using specific parts of the
RSX-11M-PLUS operating system. It describes the commands and procedures

for operating the most commonly used parts of the system: the utilities, command line interpreters, and some other program development tools.

Intended Audience

" This manual is intended as a quick reference for RSX-11M-PLUS users who are

already familiar with the system. It assumes you are already familiar with the
documentation in the manual set for the software you are using.
Structure of This Document

This document consists of sections describing each major component of an
RSX-11M-PLUS system. They are:

‘

On-Line Help Files
Utilities
e Bad Block Locator Utility (BAD)
e Backup and Restore Utility (BRU)
e File Compare Utility (CMP)

e File Dump Utility (DMP)

e Disk Save and Compress Utility (DSC)
e Line Text Editor (EDI)

e DEC Standard Editor (EDT)
e File Transfer Program (FLX)
e Disk Volume Formatter (FMT)

o Librarian Utility (LBR)
e Source Language Input Program (SLP)
o Object Module Patch Utility (PAT)

o Peripheral Interchange Program (PIP)

s Queue Manager — Print and Queue Utility (QMG)
e Task Image File Patch (ZAP)

Preface

Command Line Interpreters
o Monitor Console Routine (MCR)

e Digital Command Language (DCL)

System Management Tools
e Krror Logging System

e Procedure for Halting a Job in a Print Queue

Programming Tools
e On-Line Debugging Tool (ODT)
e Task Builder (TKB)
RMS-11

¢ RMSBCK Utility Summary

e RMSCNYV Utility Summary

e RMSDES Utility Summary
o. RMSDSP Utility Summary

o RMSIFL Utility Summary
o RMSRST Utility Summary

e RMS-11 Completion Codes and Fatal Error Codes

Reference information
e ASCII Character Set

e Directive Error Codes

e Executive Directive Summary in Alphabetical Order by Macro Call
e /O Error Codes

o RADIX-50 Conversion Table

e QOctal/Decimal Conversion Table
e Standard File Types

Preface

The Mini-Reference also includes blank pages in the back for you to make notes
on other system information that you use often. The binder is designed so that
the holes in line printer listings line up with the posts in the binder; therefore,
you can also include your own listings in the book.

vii

ON-LINE HELP FILES
Extensive help files for the utilities, MCR, DCL, and many other system compo-

nents are available to you at your terminal.
For helpin loggingin to the system, type HELP HELLO (from MCR) or HELP
LOGIN (from DCL or MCR). You’ll need a user-ID and ’password to log in.
RSX-11M-PLUS systems have two major command interpreters or CLIs: MCR
and DCL. Once you log in, your terminal is set to either MCR or DCL. All
terminals are set to MCR prior to loggingin.
From an MCR terminal, type HELP LIST for information on available help.
From a logged-in DCL terminal, type HELP for information on available help.

The general form of the HELP commandis as follows:

>HELP[/cli][/OUT[PUT]:filespec] topic [subtopic|s]]
>HELP[/qualifier][/OUT[PUT]:filespec] commandname [switch]
DCL users can also obtain help while entering a command by typing a question
mark ( ?) in response to any DCL prompt. Once the help text has been printed
on the terminal, the prompt returns and you can continue to enter the command.

Normally, HELP text is displayed on your screen, but the /OUT[PUT]:filespec
qualifier permits you to name a file to which the HELP text is to be written from
a logged in terminal.

If you do not include a CLI qualifier to the HELP command the defaultis the
name of the CLI to which your terminalis set.

Except for /OUT[PUTY, each of the following qualifiers has the effect of specifying a file where help can be found. The MCR form of these qualifiers is limited to
the first 3 characters. The DCL form includes the entire qualifier name.
>HELP/LOCI[AL] [parm[s]]
or

>HELP % [param(s]]

Specifies that the HELP text is in the file HELP.HLP in the default directory on
the default volume. HELP/LOC and HELP % are the same.

>HELP/GRO[UP] [param(s]]
Specifies that the HELP text is in the file HELP.HLP in the directory [current

group,1] on the default volume.

On-Line Help Files

>HELP/CLI:cliname [params]]

Specifies that the HELP text begins in the file LB:(1,2]cli__name.HLP. This

qualifier is for installations with alternate CLIs for which HELP is provided.
>HELP/MCR [param(s]]

Specifies that the HELP text begins in the file LB:[1,2JMCR.HLP. This is the
default for terminals set to MCR.
>HELP/DCL [param[s]]

Specifies that the HELP text begins in the file LB:{1,2IDCL.HLP. This is the
default for terminals set to DCL.

‘

>HELP/FIL[E]:filespec [param|s]]

Specifies any file where HELP text is located. If you do not give a complete file

specification, the defaults are LB:[1,2ifilename . HLP.
>HELP/xxx [param(s]]

x where xxx is
. HLP,
Specifies that the HELP text is located in the file LB:[1,2]xx
a 3-character file name.

BAD COMMAND SUMMARY
Command lines for the Bad Block Locator (BAD) use the following format:

BAD ddn:[/switchl.../switchn]

In this command line, dd is the abbreviation for the volume on which BAD is

being run and n is the unit number of the volume.
BAD switches are:

ALLOCATE

BAD ddn:/ALO[:volumelabel]

Prompts you for blocks to be allocated to BADBLK.SYS and to be entered
in the bad block descriptor file.
CSR ADDRESS

BAD ddn:/CSR=nnnnn

Specifies the CSR address of a device that is not in a standard location
(stand-alone version of BAD only).
LIST

’

BAD ddn:/LI

Lists bad blocks as they are located.
MANUAL

BAD ddn:/MAN

Allows you to enter bad blocks, which are then included in the bad block
descriptor file.
NOWRITECHECK

’
BAD ddn:/NOWCHK

Negates the effect of /WCHK (see below).
OVERRIDE

BAD ddn:/OVR

Creates the bad block descriptor file on a last-track device.

PATTERN

BAD ddn:/PAT=m:n

Specifies the double-word data pattern used to locate bad blocks.

RETRY

BAD ddn:/RETRY

Recovers soft errors.

UPDATE

BAD ddn:/UPD

Reads the bad block descriptor file and prompts for your entries.

BAD Command Summary

VECTOR

BAD ddn:/VEC=nnn

Specifies the interrupt vector address of a device that is not in a standard

" location (stand-alone version of BAD only).
WRITECHECK

BAD ddn:/WCHK

Causes a write-check operation to take place after each write operation
(stand-alone version of BAD only). The switch is not valid for DT:-, DX:-,
or DY:-type devices.

BRU COMMAND SUMMARY
Command lines for the Backup and Restore utility (BRU) use the following
format:

[/qualifiers] indevl:,...[filespec,...] outdevl:,...[filespec,...]
In this command line, qualifier(s) are any of the command qualifiers listed
below, indevices are the physical device or devices from which data is trans-

ferred, filespec is the particular file or category of file to be backed up or restored, and outdevice(s) are the output devices to which data is being transferred.
BRU qualifiers are as follows:

/APPEND
Appends new backup data to a magnetic tape, or to a disk if you are using
the /IMAGE qualifier.
/BACKUP__SET:name

Specifies the name of the backup set to be placed on magnetib tape or disk.
/BAD:

MANUAL
AUTOMATIC
OVERRIDE

Enters the locations of bad blocks on volumes. The default is /BAD:AUTOMATIC.
/BUFFERS:number

Specifies the default number of directory File Control Blocks (FCBs) kept
by the ACP for the volume.

/COMPARE
Compares the data on the output volume to the data on the input volume
and reports any differences.
/CREATED:

BEFORE:dd-mmm-yy
BEFORE:hh:mm:ss
BEFORE(dd-mmm-yy hh:mm:ss)
AFTER:dd-mmm-yy
AFTER:hh:mm:ss

AFTER:(dd-mmm-yy hh:mm:ss)

Directs BRU to process files created before or after a specified date and/or

time.

BRU Coh\mand Summary

/DENSITY:number

Specifies the data density at which BRU writes to tape.
/DIRECTORY

Displays information (such as backup set names, file names, or volume
number of a tape or disk) for a specified tape or disk volume.

/DISPLAY

Displays at your terminal the UFD and file name of each file being backed
up.

/ERRORS:number

Specifies the number of nonfatal I/O errors BRU tolerates on magnetic tape
reads during a restore operation before automatically terminating execution. The default is 25(decimal) errors.

[EXCLUDE

all files specified
Excludes selectively from a backup or restore operation
on the command line.

JEXTEND:number

Specifies the number of blocks by which a file is extended when that file

has exhausted its allocated space.
[HEADERS:number

Specifies the number of file headers to allocate initially to the index file.
[IMAGE:SAVE
RESTORE

Specifies that you want to do a multiple disk-to-disk backup or restore

operation. Use the SAVE option for backup operations. Use the RESTORE

option for restore operations.
/INITIALIZE

Directs BRU to initialize the output disk before proceeding with the operation.

/INVOLUME:name

Specifies the volume label of the input disk.

BRU Command Summary

/LENGTH:number

Specifies the length of the output magnetic tape in decimal feet.
/MAXIMUM:number

Specifies the maximum number of files that can be placed on a volume as
determined by the number of file headers in the volume’s index file.
/MOUNTED

|
,

Allows you to back up files from a disk that is mounted (with the MCR or
DCL MOUNT commands) as a Files-11 volume.
/NEW_VERSION

Directs BRU to resolve conflicts resulting from files with identical file
specifications by creating a new version of the file.
/NOINITIALIZE

Specifies that you do not want to initialize the output disk because it is
already in Files-11 format.

/NOPRESERVE
Specifies that you do not want to preserve file identifiers.,
/NOSUPERSEDE

Specifies that where files on the input and output volumes have identical
filespecs, the input files will not be transferred and the output files will not
be superseded. The default is /NOSUPERSEDE.

JOUTVOLUME:name

Specifies the volume label of the output disk. The label can be up to
12(decimal) characters long.

/POSITION:
‘

BEGINNING

MiDDLE
END

BLOCK:number

Specifies the location of the index file on the output disk volume.

BRU Command Summary

SYSTEM:value

/PROTECTION:

OWNER:value

GROUP:value

WORLD:value

Specifies the default protection status for all files created on the output

volume being initialized.

/[REVISED:

BEFORE:dd-mmm-yy
BEFORE:hh:mm:ss

BEFORE:(dd-mmm-yy hh:mm:ss)
AFTER:dd-mmm-yy

AFTER:hh:mm:ss

AFTER:(dd-mmm-yy hh:mm:ss)

Directs BRU to process files revised before or after a specified date and/or
time.

/REWIND

Rewinds the first tape of a magnetic tape set before performing the operation.

/SUPERSEDE

Resolves file specification conflicts by deleting the old file on the output

volume and replacing it with the file from the input volume. (The default is

/NOSUPERSEDE.)

[TAPE_LABEL:label

Specifies a 6-character ANSI volume identifier for identifying the magnetic
tape volume.

/UFD

Directs BRU to create UFDs (if they do not already exist) on a mounted
output volume, then copy into them the files from the same UFDs on the
input volume.

/VERIFY

Copies data from the input volume to the output volume, compares the
volumes, and reports any differences.
/WINDOWS:number

Specifies for the output disk the default number of mapping pointers allocated for file windows. The default number is the same as that for the
input disk.

CMP COMMAND SUMMARY
Command lines for the File Compare Utility (CMP) use the following format:

CMP [outfilel/sw...=linfilel,infile2
In this command line, outfile is the file specification for the output file that
contains the comparison, sw is one or more of the CMP switches described

" below, and infiles are the two files being compared.
| If you do not specify an output file, CMP output defaults to TT: and is displayed
. on your terminal. If you specify the equals (=) sign, but no output file, CMP
~displays only the total number of differences it finds in the input files.

CMP switches, which always modify the output file specification or the default
output file specification, are as follows:
BLANK LINES

[outfile]/[-]BL=infile1,infile2

Specifies that blank lines in both files be included in compare processing.

If specified in the form /-BL, blank lines are not inciuded in compare
processing. /~BL is the default switch.
CHANGE BARS

[outfile]/[-]CB=infile1,infile2

Specifies that CMP list infile2 with change bars, in the form of exclamation marks (!), to denote each line that does not have a corresponding line

in infilel. /~-CB is the default switch.
You can change the change bar character from the exclamation mark to

any character you wish by means of the /VB switch, described below.
When a section of lines in infilel has been deleted in infile2 (the output

listing file), the first line after the deleted lines is marked.

COMMENTS

[outfile]/[-]CO=infile1,infile2

Specifies that CMP include comments (that is, text preceded by a semico-

" lon) in compare processing. /CO is the default switch.
DIFFERENCES

[outfile]/[-]Di=infile1,infile2

Specifies that CMP list the differences between the two files (rather than
marking the lines in infile2). /DI is the default switch.

/CB and /DI are mutually exclusive switches. If both are specified, /CB

overrides /DI.

CMP Command Summary

[outfile]/[-]FF=infile1,infile2

FORM-FEED

Specifies that CMP include records consisting of a single form-feed charac-

ter in compare processing. /~FF is the default switch.
LINES

[outfile] / LI:n=infile1,infile2

Specifies that a number (n) of lines must be identical before CMP recognizes a match. If you do not specify this switch, CMP searches for three
identical lines to match (/LI:3).

When it encounters a match, CMP prints all the preceding nonmatching
lines, along with the first line of the matched sequence of lines, to help you
'
find the location in the code where the match occurred.

LINE NUMBER

[outfile] / LN=infile1,infile2

Specifies that lines in the output file be preceded by their line number.
Line numbers are incremented by one for each record read, including blank
lines. /LN is the default switch. If vou specify /SL (below), /LN is unneces'

sary.

MERGE BLANKS

[outfile]/[-]MB=infile1,infile2

Specifies that CMP include all blank and tab characters in a line in compare processing. If you specify /-MB, CMP interprets any sequence of
blank and/or tab characters as a single blank character in compare process-

ing. However, all spaces and tabs are printed in the output listing. /MB is
the default switch.

SLP FILE

outfile/SL[:au=infile1,infile2

Directs CMP to generate an output file suitable for use as SLP command
input. When you specify /SL, CMP generates the SLP command input
necessary to make infilel identical to infile2. If a 1- to 8-character alphanumeric symbol is included (:au), an audit trail is specified for SLP input.

SPOOL

outfile /[-]SP[:n]=infile1,infile2

Specifies that the output file be spooled on the line printer. You can op-

tionally specify the number (in octal or decimal) of files to be spooled. /-SP
is the default switch.

This switch applies only if you have the Queue Manager installed.

CMP Command Summary

TRAILING BLANKS

[outfile]/[-]TB=infile1,infile2

Specifies that CMP include all trailing

blanks on a line in compare pro-

cessing. If you specify /-TB,
CMP ignores all blanks followin
g the last

nonblank character on a line. When

you specify /~CO and /-TB together
,
blanks that f)recede‘ a semicolon (;)
are considered trailing blanks and are
ignored. /TB is the default switch.
VERTICAL BAR

outfile/VB:nnn=infile1,infile2

Specifies an octal character code for

use as a change bar. You use this

switch with the /CB switch. The
value nnn specifies the octal charact
er
code. For example, you can specify
/VB:174 for a vertical bar (if your

printer is capable of printing the vertical
exclamation mark) is the default switch.

bar character). /VB:041 (for the

DMP COMMAND SUMMARY

Command lines for the File Dump Utility (DMP) use the fdllowing format:
[outfile][/switch(es)]=inspecl/switch(es)]
In this command line outfile specifies the output file dump, switch(es) is one or
more of the DMP switches described below, and inspec specifies the input device

and file or input device only.

The command line elements take the following defaults:

ASCII

outfile=inflle/AS

Specifies that data be dumped one byte at a time in ASCII mode.
BASE ADDRESS

outfile/BA:n:m=Inflle

Specifies a 2-word base block address.
BLOCK

outfile=inflle/BL:n:m

Specifies the first and last logical blocks to be dumped.

BYTE

outfile=infile/BY

‘

Specifies that data be dumped in octal byte format.
DECIMAL

outflle/DC=infile

Specifies that data be dumped in decimal word format.

DENSITY

outfile=infile/DENS:n

Specifies density of an input magnetic tape when DMP is in device mode

only. Values for n can be 800, 1600, or 6250.

FILE ID

outflle=infile/FI:fil

Specifies the input file with its file-ID instead of its name (File Mode only).
HEADER

outflle=inflle/HD:F

outflie=infile/HD:U
Includes the file header in the data dumped. “F”, the default, specifies a

formatted Files-11 dump for the header. “U” specifies an unformatted
octal dump.

DMP Command Summary

HEADER FILES-11

outfile=infile/HF

Specifies the format for data blocks that have the Files-11 header structure. Other blocks are dumped &s unformatted octal.
HEXADECIMAL

‘

outfile/HX=infile

Specifies that data be dumped in hexadecimal byte format.
" IDENTIFICATION

/iD

Causes the current version of DMP to be displayed or printed.

LOGICAL BLOCK

outfile=infile/LB

Requests the starting (logical) block number and a contiguous or noncon

tiguous indication for the file to be displayed.
LOWERCASE

outfile=infile/L.C

Specifies that the data should be dumped in lowercase characters. This

switch is valid only if the output device supports lowercase characters.
LONG WORD

outfile=infile/LW

Specifies that data be dumped in hexadecimal double-word format.
MEMORY

outfile/MD:[n]=infile

Controls line number sequencing during a memory image dump.
OCTAL

outfile=infile/OCT

Specifies that the data should be dumped in octal format. If no DMP
format switches are included, the default is octal format.
RECORD

outfile=infile/RC

Dumps one record at a time in the specified format.
REWIND

outfile/RW=infile[/RW]

Issues a rewind command to the tape driver before referencing a specifier

tape. You can use the /RW switch at any time to reposition a tape a.
beginning-of-tape (BOT).

DMP Command Summary

RADIX-50

outfile=infile/R5

Dumps in Radix-50 word format.
SPACE BLOCKS

outfile=infile/SB:[-]n

Specifies the number of blocks DMP spaces forward

on a tape.

SPACE FILES

(n) or backwards (-n)

outfile=Infile/SF:[-]n

Specifies the number of end-of-file (EOF) marks DMP

or backward (-n) on a tape.
SPOOL

spaces forward (n)

outfile/SP=infile

Spools the dump file (the output file) to the line printer.

WORD

outfile=infile/WD

Specifies that data be dumped in hexadecimal word

format.

DSC COMMAND SUMMARY
Command lines for the Disk Save and Compress utility (DSC) use the following
format:

DSC outdevis]:[label][/switch[es]]=indev(s]:[label][/switch]

In this command line, outdevis] is the physical volume or volumes to which data
is copied, label identifies the volume id of the output or input device, switch[es]
are the command switches described below, and indevls] is the physical volume

or volumes from which data is copied.

DSC switches are as follows:
APPEND

outdev:/AP=indev

Appends a DSC file to the first volume of a magnetic tape set that already
contains a DSC file.

BAD

MAN
NOAUTO

outdev:/BAD=MAN:NOAUTO=indev

OVR
MAN:OVR

Allows manual entry of bad block locations; can supplement, override, or
ignore the disk’s own bad block file.

BLOCKS

outdev:/BL=n=indev

Sets the number of 256-word blocks DSC can include in each of its two
buffers.
COMPARE

outdev:/CMP=indev

Compares input and output volumes for differences.
CSR

outdev:/CSR=nnnn=indev

Specifies control status addresses for a specific Status Control Block

(SCB). /CSR is valid only with the stand-alone version of DSC.

DENSITY

outdev:/DENS=nnnn=indev

Overrides the DSC default storage density for magnetic tapes of 800 bpi.
The first form of the switch creates magnetic tapes at 1600 bpi density. The

second form (the split density switch) creates magnetic tapes with volume
header information at 800 bpi and the rest of the tape at 1600 bpi.

DSC Command Summary

REWIND

outdev:/RW=indev

Rewinds all volumes in a magnetic tape set before execution of the current
command line.

TMO2

outdev/T M02=nn=indev

Specifies the physical unit number of the formatter on the RH11/RH70
controller (stand-alone version of DSC only).
UNIT

outdev/UNIT=nn=indev

Specifies the physical unit that will be referenced by the indicated Unit
Control Block (UCB). The /UNIT switch is valid only with-the stand-alone
version of DSC.
VERIFY

outdev/VE=indev

Copies data from the input volume and compares it with the output volume following the data transfer.
VECTOR

outdev/VEC=nnn=indev

Specifies the vector address for a specific Status Cofitrol Block (SCB). The

/VEC switch is valid only with the stand-alone version of DSC.

LINE TEXT EDITOR (EDI) COMMANDS
In this section, the following conventions are used:

‘The asterisk (*) can be used in place of any number in an EDI command. It
is read as 32,767.

An ellipsis (...) can be used in many search strings to identify characters
between the first and last characters of the string.
EDI allows the use of abbreviations in commands.
A string

ADD

Adds the text in the string to the end of the current line.
ADD AND PRINT

AP string

Adds the text in the string to the end of the current line and displays the
entire line on the terminal.
ALTMODE
or

ESC

ESCAPE

In Line Mode, prints previous line and makes it the new current line. In
Block Mode, exits from input mode.

BEGIN

Sets the current line to the line preceding the top line in the file or block
buffer. In Line Mode, creates a copy of the file.
BLOCK ON/OFF

Changes from the EDI Block Mode to Line Mode or from Line Mode to
Block Mode to access text.

BOTTOM

Moves the line pointer to the bottom of the current block (in Block Mode) .
or to the bottom of the file (in Line Mode).
CHANGE

[n]C/string1/string2{/]

Replaces string 1 with string 2 in the current line n times.

Line Text Editor (EDI) Commands

CL [fllespec]

Transfers the remaining lines in the block buffer and input file to the
output file, and closes all files. Renames output files to filespec.

CLOSE AND DELETE

CDL [filespac]

Transfers the remaining lines in the block buffer and the input file to the
output file, closes the output file, and deletes the input file.
CLOSE SECONDARY

CLOSES

Closes the secondary input file.

CC [letter]

CONCATENATION CHARACTER

Changes the concatenation character used to separate EDI commands on
one line to the character specified. (The default concatenation character is
&.)

CTRL/Z

Closes all open files and terminates the editing session.
D{[n]

DELETE

DI[-n]

Deletes the current line and the next n-1 lines if n is a positive number.
Deletes n lines preceding the current line, but not the current line, if nis a
negative number. Negative numbers can only be used in Block Mode.
DELETE AND PRINT

DP [n]

DP [-n]

Deletes lines specified and prints the new current line.
END

Sets the last line in a file or block buffer as the current line.
-ERASE

ERASE [n]

Erases the current line in Line Mode. Erases the current block buffer and
the next n-1 blocks in Block Mode.

ESCAPE

€0

ALTMODE

In Line Mode prints the previous line and makes it the new current line. In
Block Mode, exits from Input Mode.

Line Text Editor (EDI) Commands

EXIT

EX [fllespec]

Transfers the remaining lines in the block buffer and input file to the
output file. Closes files, renames the butput file if specified, and terminates

the editing session.
EXIT AND DELETE

‘
ED [filespec]

Transfers the remaining lines in the block buffer and input file to the
output file, closes files, and renames the output file if specified. Deletes the
input file and terminates the editing session.
FILE

FIL filespec

Transfers lines from the input file to both the output file and the specified
file until a form feed or end-of-file is encountered. The original file remains
intact. This command is only used in Line Mode.
FIND

[n]F string

Finds the line in the current block starting with string, or the nth line,
starting with string. A string must begin in the first column of the line to be
a match.
FORM FEED

Inserts a form feed into the block buffer.
INSERT

IN [string]

Enters the specified string immediately following the current line. If no
string is specified, EDI enters Input Mode.
KILL

KILL

Closes the input and output files and deletes the output file.
LINE CHANGE

[n]LC/string1/string2[/]

Changes all occurrences of string 1 in the current line (and n-1 lines) to
string 2.

LIST ON TERMINAL

Displays on the terminal all lines remaining in the block buffer or input
file, starting with the current line.
LIST ON PSEUDO DEVICE

Displays on the Console Listing Device, CL:, lines remaining in the block
buffer or input file, starting with the current line.

Line Text Editor (EDI) Commands

LOCATE

[n]L string

Locates the nth or next occurrence of the specified string. In Block Mode,
the search stops at the end of the current block.
MACRO

MACRO x definition

Defines the macro number x for the EDI commands in the definition. The
value x can be 1, 2, or 3.

MC[;n]

MACRO CALL

Retrieves a macro definition stored in the file MCALL;n.
[n]Mx [a]

MACRO EXECUTE

Executes macro x n times, while passing numeric argument a to it. The
value x can be 1, 2, or 3.

- MACRO IMMEDIATE

[n] <definition>

Defines and executes a macro n times. Stores it as macro number 1.
NEXT

N[n]

N [-n]

Establishes a new current line n lines away from the current line.
NP[n]

NEXT AND PRINT

NP[-n]

Establishes a new current line and displays it on the terminal.

OP filespec

OPEN SECONDARY

Opens the specified secondary input file.

OU ON

OUTPUT ON/OFF

OU OFF

Continues or discontinues a file transfer to output file in Line Mode.
OVERLAY

O [n]

Deletes n lines, enters Input Mode, and inserts new lines, as typed, in place
of the deleted lines.

PAGE

PAGn

-n

Enters Block Mode. Reads page n into current block buffer. If n is less than
the current page, EDI goes to the top of the file first. Pages are set by form
‘feed characters.

Line Text Editor (EDI) Commands

PAGE FIND

[n]PF string

Searches successive block buffers for the nth occurrence of the string. The
string must begin in the first column of the line.
PAGE LOCATE

[n]PL string

Searches successive blocks for the nth occurrence of the string. The string
can begin anywhere on the line.

PASTE

PA/string1/string2[/]

Searches for all remaining lines in the input file or block buffer that contain string 1 and replaces them with string 2.
PRINT

P [n]

Displays the current line and the next n-1 lines on the terminal. The last
line printed becomes the current line.
‘
READ

REA n

Reads the next n blocks of text into the block buffer. If the buffer already
contains text, the new text is appended to it.
RENEW

REN [n]

Writes the current block to an output file and reads a new block n from an
input file (Block Mode only).
RETURN

®ED

Displays the next line on the terminal and makes it the current line. Exits
from Input Mode if it is entered as the first character of a line.
RETYPE

R string

Replaces the current line with the specified string, or deletes the current
line if no string is specified.

SAVE

SA [n][filespec]

Saves the current line and the next n-1 lines in the specified file. If no file
is specified, saves the lines in SAVE. TMP.
SEARCH AND CHANGE

SC/string1/string2[/]

Locates string 1 and replaces it with string 2.

Line Text Editor (EDI) Commands

SELECT PRIMARY

Reestablishes the primary file as the input file.
SELECT SECONDARY

Selects the secondary file that will be an input file.
SIZE

SIZE n

Specifies the maximum number of lines that can be read into-a block
buffer.

TAON or TA OFF

TAB

Turns automatic tabbing on or off.
TOP

T[OP]

Sets the current line to the line preceding the top line in the file or block

buffer. In Line Mode, creates a copy of the file.
TOF

TOP OF FILE

Returns to the top of the input file in Block Mode and saves all of the
previously edited pages. Reads in a new block after writing the output file.
This command creates a new version of the file each time it is executed in
Line Mode.

TY [n]

TYPE

Displays the next.n lines on the terminal. This command is identical to the
PRINT command in Line Mode. However, in Block Mode, the line pointer
remains at the current line unless EDI reached the end of a block.

UNSAVE

UNS [filespec]

Inserts all lines from the specified file following the current line. If no file
name is used, EDI uses SAVE.TMP.

UPPER CASE

UC ON

UC OFF

Enables or disables conversion of lowercase letters to uppercase letters
when they are entered at a terminal.

Line Text Editor (EDI) Commands

VERIFY

VON

V OFF

Selects whether the operation of the LOCATE and CHANGE commands
will be verified (printed on the terminal) after the line is located or

changed.
WRITE

Writes the contents of the block buffer to the output file and erases the

block buffer.

DIGITAL STANDARD EDITOR (EDT) COMMANDS
EDT lets you edit text in line mode and character mode, using the keypad or
nokeypad functions.
LINE MODE COMMANDS

You can tell EDT is in line mode when you receive an asterisk prompt ( *). You
can then edit the text on a line-by-line basis. Enter a
to exit from EDT.
The following commands work from EDT line mode:
CHANGE

C [range]

Starts either keypad or nokeypad character editing, depending upon the
terminal type. EDT defaults to keypad character editing for VT52 and
VT100 terminals and nokeypad editing for all other terminals. EDT puts
the cursor ahead of the location you specify as range.
Entering a
CLEAR

returns you to line mode.

CL textbuffer

Deletes the contents of a text buffer, but does not delete the buffer itself.
COPY

CO [range-1] TO [range-2][/qualifier(s)]

Copies text from range-1 to the location in front of the line you specify in
range-2. EDT can copy from one buffer to another or from one place to
another within a text buffer.
Qualifiers:

QUERY
DUPLICATE

DEFINE KEY

Verifies each line to be inserted.
Inserts the range of text more than once.

DEF K{{GOLD]{number: CONTROL letter} ! GOLD character}

AS “string”’

Redefines keypad keys in terms of nokeypad commands. The following
table describes the command format:
Braces {}

You must choose one of the options.

OR |

Separates choices.

Brackets ()

You can use GOLD to specify the alternate function of a keypad or control key.

number

Number of the keypad key.

Digital Standard Editor (EDT) Commands

Control letter

Enter CONTROL and a character from A to Z.

GOLD

The GOLD keypad key.

GOLD character

Enter GOLD and any keypad character except

0-9,!, %, ’, and ".

One or more nokeypad commands used to rede-

“string

fine the key.

DEF M macroname

DEFINE MACRO

Assigns a name to a sequence of editor commands stored in the file macro:

name.

D [range][/qualifier]

DELETE

Deletes the lines specified and displays a message stating the number of
lines deleted. When you do not specify a range, deletes the current line.
Qualifier:

QUERY

Verifies each line to be deleted

EX [filespec][/qualifier(s)]

EXIT

Ends an editing session and moves the main text buffer to the output file
specified. You can define the name of the output filein the command line
that invokes EDT or in the EXIT command.
Qualifiers:

SEQ[UENCE][:initial[:increment]] . Assigns integer line numbers before

the text transfer and places them in a
fixed field in the file. You define the

initial number and the increment between numbers.

SA[VE]

Saves the journal file created during
the editing session.

F range

FIND

Locates the line or lines specified by range.
HELP

H [topic[subtopic]]

Displays information on requested topics or subtopics.

Digital Standard Editor (EDT) Commands

INCLUDE

INC fllespec [range]

Copies disk files into text buffers. Filespec is the name of the file you want
to copy. EDT copies the file to the current text buffer in front of the first
line of the range.
INSERT

I [range][;line to be inserted]

Inserts text into a buffer. When you specify a range, EDT inserts the text
before the first line of the range. If you do not specify a range, EDT inserts
the text before the current line.
MOVE

M [range-1] TO [range+n2][/qualifier]

Moves the lines in range-1 to the location preceding range-2. Deletes the
text from range-1.

Qualifier:

QUERY:

EDT prompts you to verify each line of range-1 to be moved.

null (Iimplied TYPE)

[range]GED

Displays the next line of text. You can specify a range of text to be displayed. However, the REST, WHOLE, BEGIN, END, LAST, and ALL
range specifications must be preceded by a percent sign (%).
PRINT

P filespec[range]

Copies text from a text buffer into a file. Range selects a portion of the

buffer to be copied. Without a range, the default is the current text buffer.

QUIT

QUIT[/qualifier]

Ends the current editing session without saving the main text buffer.
Qualifier:

SAVE

Saves the contents of the journal file under the name specified in
the command line to invoke EDT.

REPLACE

R [range][;line to be inserted]

Deletes lines specified in range and inserts new text. EDT inserts the new

text at the first line in the range specification. Without a range, EDT
deletes the current line and inserts the new text in its place.

Digital Standard Editor (EDT) Commands

RESEQUENCE

RES [range][/qualifier]

Assigns new line numbers to the contents of a buffer or the range of lines
specified. Without a range, EDT resequences all lines in the current text
buffer.
Qualifier:

SEQ[UENCE][:initial[:increment]]

Sets the first line resequenced to the

initial value and increments succeeding numbers by the increment specified.

SET

SET parameter

Control the operating characteristics of EDT.
Parameters:

CASE {UPPER:LOWER | NONE}

EDT flags upper- or lowercase characters with a preceding apostrophe. The default is NONE, which does not flag any characters.
,

CURSOR top:bottom

Sets the number of lines over which the cursor moves on the display.
Top is the number of lines for the upper limit and bottom is the
number of lines for the lower limit

: PARAGRAPH | PAGE} “string”
ENTITY {(WORD ! SENTENCE
Sets user-definable entities for character editing.
'

KEYPAD

Allows the keypad to control the character-editing operation.

LINES number

Sets the number of lines that EDT displays on the terminal during
character editing.

MODE (LINE: CHANGE]}

Used in a start-up command file to control the editing mode entered
at the end of the initialization.

[NOINUMBERS

Determines whether EDT displays line numbers in line editing. Default: NUMBERS

[NOJQUIET

Controls the ringing of the terminal bell when an error occurs in
change mode editing. Default: NOQUIET

Digital Standard Editor (EDT) Commands

SCREEN width

Controls the maximum width of the line EDT displays. Default: 80
characters
SEARCH {EXACT
| GENERAL]}
EDT searches for exact comparisons of case or ignores case in

searches. Default: GENERAL
{BOUNDED | UNBOUNDED)]
EDT stops searching at the next page entity marker. Default: UNBOUNDED
{(BEGIN | END}
EDT leaves the cursor at the end of the string when it is found. If the
string is not found, the cursor does not move. Default: BEGIN
{TAB n! NOTAB]

Sets the number of spaces for the first tab stop in keypad editing.
Remaining tabs are unchanged. Default: 8
TERMINAL {HCPY i VT52:VT100}

Determines the type of terminal in use. EDT gets the terminal type
from the operating system and this command overrides that setting.
[NO]JTRUNCATE

Ends display of a line at the value of SET SCREEN. Default: TRUNCATE

[NOJVERIFY

Enables or disables display of commands from command files and
macro commands. Default: NOVERIFY
[NOJWRAP n

rrrrr -

Sets or eliminates a line length limit of n character positions. Default:
NOWRAP
SHOW

SHOW parameter

‘Displays the operating characteristics of EDT.
Parameters:

BUFFER

Lists the buffers in use during the current editing session and the

number of lines of text in each.
CASE

Shows the current case setting.

CURSOR
‘

Shows the current cursor range.

Digital Standard Editor (EDT) Commands

ENTITY (WORD : SENTENCE! PARAGRAPH ! PAGE]}
Shows the current setting for the user-definable entity specified.

KEY {{GOLD]{number!CONTROL letter} ! GOLD character}
Shows the definition of the specified key in change mode.
SCREEN

Shows the current setting for screen width.

SUBSTITUTE

S/string-1/string-2/[range][/qualifier(s)]

Replaces occurrences of string-1 with string-2 within the range specified.

Without a range, EDT replaces the next occurrence of string-1 with
string-2. EDT returns to the first line in the specified range at the end of
the substitution.
Qualifiers:

B[RIEF][:n]

EDT displays the first n characters of the line containing

Q[UERY]

EDT prompts you to verify each line of range-1 to be moved.

NOT[TYPE]

EDT does not display the lines on which it makes substitu-

string-1. The default for n is 10.

tions.

SUBSTITUTE NEXT

[S] N[/string-1/string-2]

EDT searches for the next occurrence of string-1 from the current location
forward. The line on which the substitution is made becomes the current
line.

If you do not specify string-1 or string-2, EDT uses the strings specified in
the last SUBSTITUTE command.

TYPE

T [range][/qualifier(s)]

Displays the specified range of lines, or all the lines in the current text
buffer.

Qualifiers:

B[RIEF][:n]

EDT displays the first n characters of the selected lines. The

S[TAY]

EDT does not change the cursor position.

default for n is 10.

Digital Standard Editor (EDT) Commands

WRITE

WR filespec [range][/qualifier]

Copies the defined range of text from a text buffer to the specified file.
Does not change the contents of the text buffer. Without a range, EDT

copies the contents of the current text buffer to the file.

Qualifiers:

SEQ[UENCE][:initial{:increment]]

EDT writes the line numbers as a part
of the output file.

CHARACTER MODE KEYPAD EDITING COMMANDS

The keypad editing functions are those used when you enter Character Mode
with the EDT CHANGE command and set the terminal to use the keypad keys

with the SET KEYPAD command. You can also use all line mode commands
with the Gold Command keys.
DELETE

Erases the character to the left of the cursor

GOLD integer

Repeats any keypad function except SPECINS, DELETE, and

CTRL/U
LINE FEED

Erases the word to the left of the cursor

CTRL/A

Computes tab level

CTRL/C

Aborts the current command and returns EDT to keypad editing

CTRL/D

Decreases tab level

CTRL/E

Increases tab level

CTRL/K

Defines key

CTRL/T

Adjusts tabs

CTRL/U

Deletes to start of line

CTRL/W

Refreshes screen

CTRL/Z

Returns to line-editing prompt

NOKEYPAD CHANGE MODE COMMANDS
Nokeypad commands have only one format, described below. They can be used

in a series without any delimiter between commands. However, no abbreviations
are allowed.

Digital Standard Editor (EDT) Commands

ADVANCE

[-]IADV

Sets all commands forward (to the right and down from the current cursor
position). [-JADV sets commands backward (to the left and up from the
current cursor position).
APPEND

[+ i -l[count]APPEND[
+ | ~][entity-count]
[+ | ~]entity]=buffer]

Moves the specified entities to another text buffer and deletes the text from

the current buffer. Buffer names the receiving text buffer. If no bufferis
specified, EDT uses the PASTE buffer.

ASCII

[count]ASC

EDT displays an ASCII character when you specify the character’s decimal

number representation.
BACK

BACK

Sets all commands backward (to the left or up from the cursor). Override
with a plus sign preceding another command.
CHANGE CASE

CHGCJ entity]

Changes the case of the characters within an entity.
CuTt

[+ 1 =][rep]CUT[+ | ~][entity-count][+ | —-]entity[=buffer]
Deletes the moved text from the current text buffer and moves it to the
specified text buffer, or to the paste buffer if no other buffer is specified.
Deletes previous contents of the receiving text buffer.

DELETE

[+ i-][rep]D[+ | -][entity-count][+ | -]entity[=buffer]

Deletes a specified number of entities.

DEFINE KEY

DEFK

Defines the keystrokes used in kevpad editing in terms of nokeypad commands.

EXIT

Exits EDT from nokeypad editing back to line editing.
EXTENDED

EXT

Enters line mode commands when EDT is in character mode. Returns to
change mode after executing the command.

Digital Standard Editor (EDT) Commands

FILL

[+ {=][rep]FILL[+ | -][entity-count][+ | ~Jentity[=buffer]
Places the maximum amount of text on each line within the limit determined by the SET WRAP command. Default: 80 characters.

INSERT

Prepares the current text buffer for insertion of text in front of the cursor
position.
)
[+ ! -][rep][+ ! -][entity-count][+ | ~[[entity][=buffer]

NULL

Moves the cursor the specified number of entities.
PASTE

PASTE

[+ ! -l[rep]PASTE[+ ! -][entity-count][+ | ~]entity[=bufter]

Copies the contents of the specified text buffer in front of the current cursor
location.

QuIT

Ends the editing session without saving any edits and returns to the monitor (CLI) prompt.
R

REPLACE

[+ ! =][rep]R[+ ! -][entity-count][+ | -]entity[=buffer]

Deletes the text specified and enters insert mode so that you can replace

the deleted text. To exit from insert mode here, press L2.
REFRESH

REF

EDT refreshes the entire screen.

SUBSTITUTE

[+ !-l[count]S/s1/s2

Replaces one string of characters with another. Count defines the number
of substitutions and minus (-) indicates a backward search. Use any nonalphanumeric character as a delimiter, in place of the /.
SELECT

SEL

Lets you select a range of text by entering SEL at one end and moving the

cursor to the other end. The select range is the text between the cursor and
the position marked by SEL.
SHIFT LEFT

[count]SHL

Shifts the screen image to the left. The amount shifted is equal to the
count you specify times 8 (one tab stop). The default count is 1.

Digital Standard Editor (EDT) Commands

SHIFT RIGHT

[count]SHR

Shifts the screen image to the right. The amount shifted is equal to the
count you specify times 8 (one tab stop).
SUBSTITUTE NXT

[+ !-J[count]SN

Uses the sl and s2 defined in the last substitute command to replace the
next occurrence of s1 with s2. Count defines the number of substltutlons
and a minus (- ) sign indicates a backward search.
TAB

TAB

When no tab size is specified with SET TAB or when the cursor is not at
the beginning of a line, TAB inserts a tab character at the cursor position.:

When a tab size is specified with SET TAB, and the cursor is at the )
beginning of a line, TAB moves the cursor to the column position specified
in the SET TAB command.
TAB ADJUST

[+ i =][rep]TADJ[+ | -][entity-count]

[+ | -]entity[=buffer]

Adjusts the tab level for the selected range of lines.
TAB COMPUTE

Sets the indentation level count to the value obtained by dividing the
current cursor column position by the SET TAB number.
TAB DECREMENT

[count]TD

Decreases the indentation level count.
TAB INCREMENT

[count]TI

Increases the indentation level count.
TOP

TOP

Places the current line at the top of the screen.
UNDELETE CHARACTER

[count]UNDC

Inserts the last character deleted by a DELETE CHARACTER command
into the current text buffer (in front of the cursor).
UNDELETE WORD

[count]UNDW

Inserts the last word deleted by a DELETE WORD command into the
current text buffer (in front of the cursor).

Digital Standard Editor (EDT) Commands

UNDELETE LINE

[count]JUNDL

Inserts the last line deleted by a DELETE LINE command into the current
text buffer (in front of the cursor).
- CIRCUMFLEX

[count]”[A...Z]

Inserts a control character in the text buffer.
LINE RANGES:

Most EDT commands allow you to specify a range of text on which the action of
the command is performed. These ranges are:
Single Line Ranges:

.(period)

Current location of cursor.

number{.decimal]

The line number specified.

- "string " | -"string"

The most recent preceding line containing the string
specified. Without a string specification, EDT uses
the last search string.

[range]+[number]

The line that is the specified number of lines after

[range]-[number]

The line that is the specified number of lines before

the specified range.

BEGIN

The first line in the text buffer.

END

An empty line following the last line in the text

LAST

The last line in the most recent text buffer before the

ORIGINAL number
,

The line numbers assigned to the text in the main
text buffer from the primary input file. You can locate text by its original line number even after it has

buffer.

current text buffer.

been assigned new numbers.
Contiguous Line Ranges:

[range-1]:[range-2]

The set of lines from range-1 through range-2 inclusive. Range-1 and Range-2 are any single line range

[range]#number !
[range]FOR number

The specified number of lines beginning with range,
where range is any single line range specification.

specification.

Digital Standard Editor (EDT) Commands

BEFORE

All lines preceding the current line in the current
buffer.
:

REST

All lines after and including the current line.

WHOLE

The current text buffer.

Noncontiguous Ranges:
[range,range,...]!

All lines specified by each range, which must be

[range AND range...]

single line range.

[range]All “string’

All lines in the range containing the specified string.

Text Buffer Ranges:
[=buffer][range] !

[BUFFER buftfer][range]

When you use a buffer without a range specification,
the default is the entire text buffer and the cursor is
placed at the first line in the text buffer.

FLX COMMAND SUMMARY
Command lines for the File Exchange utility (FLX) use the following format:
outfile/sw=infile(,s)/sw

FLX assumes the following defaults if no switches are specified on the command
line:
Input volume

DOS-11

Output volume

FILES-11

FLX switches are as follows:
BLOCKS

outfile/BL:n[.}=Infile

Specifies the number of contiguous blocks (n) in octal or decimal to be
allocated to the output file.
BLOCK SIZE

outfile/BS:n=infile

Specifies the block size (n) for cassette tape output.
CONTIGUOUS

outflie/CO=infile

Specifies that the output file is to be contiguous.
DELETE

outfile/DE=inflle[/DE]

Deletes files from a DOS-11 or RT-11 (used with the /RT switch) volume.
DIRECTORY

outfile/Di=infile

Causes a directory listing of a cassette or DOS-11 volume or, when used
with the /RT switch, of an RT-11 volume. The directory is placed in the
specified output file.

DENSITY

outfile/DNS:n=infile

Specifies a density of 800, 1600, or 6250 bpi for a magnetic tape volume.

DOS-11

outfile/DO=infile[/DO]

Identifies the volume as a DOS-11 formatted volume.
FORMATTED ASCII

outfile/FA:n=infile

Specifies formatted ASCII transfer mode file format.

FLX Command Summary

FORMATTED BINARY -

outfile/FB:n=infile.

Specifies formatted binary transfer mode file format.
FORTRAN CONTROL

outfile/FC=infile

Specifies that FORTRAN carriage control conventions are to be used.
IDENTIFICATION

/ID

Displays the current version number of FLX.
IMAGE MODE

outfile/IM:n=infile

Specifies image mode (n is in decimal bytes).
LIST

outdevice/Ll

Same as /DI.
NUMBER

outfile/ZE/NU:n[.}=Infile

Used with /ZE and /RT switches; specifies the number of directory blocks
(n)in octal or decimal to allocate when you are 1mt1ahz1ng an RT-11 disk
or DECtape.
‘
:
RSX FORMAT

outfile/RS=infile[/RS]

Identifies the volume as a Files-11 formatted volume. RT FORMAT

outfile/RT=infile[/RT]

Identifies the volume as an RT-11 formatted volume.
REWIND

outfile/ [-JRW=infile[/RW]

Specifies whether a magnetic tape will rewind before FLX begins the file
transfer.

SPOOL

outfile/SP=infile

Specifies that the converted fileis to be spooled by the print spooler or the
Queue Manager.
uiC

outfile/Ul=infile

Specifies that the output file is to have the same UFD as the input file.

FLX Command Summary

VERIFY

outfile/VE=infile

Verifies each record written to a cassette.
ZERO

outflie/ZE=infile/RT

Initializes cassettes or DOS-11 volumes or, when used with the /RT switch,
RT-11 volumes. Initializing erases any files already on the volume.

FMT COMMAND SUMMARY Command lines for the Disk Volume Formatter (FMT) use the following format:
FMT ddn:{/switchl.../switchn]

In this command line, dd is the abbreviation for the volume being formatted and
n is the unit number of the volume.

‘

FMT switches are as follows:
BAD

ddn:/BAD

Runs the Bad Block Locator Utility if it is installed. Note that you can use
this switch only with operating systems that allow spawning of tasks.
RSX-11M provides spawned tasks as a system generation option.

DENSITY

ddn:/DENS=n

Selects high (double) or low (single) density for RX02 floppy diskettes. The
value n can be 800 or 1600.

ERROR LIMIT

ddn:/ERL=n

Determines the maximum number of errors FMT allows on the volume.
MANUAL

ddn:/MAN

Enters manual operating mode and formats the sector or track you specify.
' NOVERIFY

ddn:/-VE

Inhibits the default verification of a successful FMT operation.
OVERRIDE

ddn:/OVR

Overrides or ignores the manufacturer’s bad block sector file (MDBSF).
VERIFY

ddn:/VE

Verities that an FMT operation was successfully completed. This switch is
the default.

WRITE LAST TRACK

ddn:/WLT

Rewrites the MDBSF (on the last track of the device) to add bad sectors
found during an FMT operation.
INDIRECT

ddn:/@Y

Informs FMT that it is receiving input from an indirect command file. User
intervention is not allowed during the operation.

LBR COMMAND SUMMARY
Command lines for the Librarian utility (LBR) use the following format:
outfilel/sw][,listfile]=infile1[,infile2,...infilen][/sw]
LBR switches are as follows:

COMPRESS

outfile/CO:size:ept:mnt=infile

Compresses a library file by physically deleting logically deleted records,
putting the free snace at the end of the file, and making the free space
available for new library module inserts.
CREATE

outfile/CR:size:ept:mnt:libtype:infiletype=infile[s]

Allocates a contiguous library file on a direct access device (for example, a
disk).

DELETE

outfile/DE:module1[:module2

dulen]

Logically deletes library modules and their associated entry points from a
file.
DEFAULT

outfile/DF:type...

/DF:type

Specifies the default library file type.
DELETE GLOBAL

outfile/DG:global1[:global2:...:globain]

Deletes the specified library module entry points from the entry point
table.
ENTRY POINT

outfile[/EP}=Infile[...,infilen]

outfile=infile[/EP][...,infilen[/EP]]

Includes or excludes entries in the entry point table.
EXTRACT

outfile=infile/EX[:modulename1i:....modulenamen]

Reads (extracts) one or more modules from a libréry and writes them into
the specified output file.

LBR Command Summary

INSERT

outfile/IN=infile1[,infile2...,infilen]

outfile=infile/IN

p:op:op:op

(universal)

Inserts library modules into a library file.
LIST

outfille],listfile]/switch(es)

Lists all modules in the library file plus additional information,.depending

on which form of the switch you use:

/LI

Lists all modules in the library file.

/LE

Lists all modules in the library file and their corresponding entry points.

/FU

Lists all modules in the library file and provides a full module
description that includes the size,
module-dependent information.

'MODIFY HEADERS

date

of insertion,

and

outflle/MH:module:op:op:op:op

Modifies the optional user-specified information in the module header of a
universal library.
REPLACE

outfile/RP=infile1[,infile2...,Infilen] (global format)

outfile=infile1/RP{,infile2[/RP]...,Infilen[/RP]] (local format)
outfile/RP:name:op:op:op:op=infile1[,infile2...,infilen)(universal/global format;

outfile=infile1/RP

p:op:op:opf,infile2...,infilen}(universal/local format)

Replaces or, in certain cases, inserts library modules in a library file.

SPOOL

outfile,listflie/SP

Spools the listing file for printing. This is the default setting; use /-SP to
prevent the file from being printed.
SELECTIVE

outfile=infile1/SS[,inflle2[/SS]...,infilen[/SS]]

Sets the selective search attribute bit in the object module header.
SQUEEZE

outfile/SZ=infile1[,infile2...,infilen] (global format)

outfile=infile1/SZ[,infile2[/SZ]...,infilen[/SZ]] (local format)

Reduces the size of macro definitions by removing comments, blank lines,
and trailing blanks and tabs from the macro text.

SLP COMMAND SUMMARY
Command lines for the Source Language Input Program (SLP) use only the
following format:

outfile[/switch,listfile/SP or /-~-SP]=infile[/switch]
SLP switches have the same effect and can be used on either input or output file

~
-

specifications, except for the /SP switch, which can only modify the listfile.
These switches are:

' AUDIT TRAIL outfile/ [-]JAU=infile
outfile=infile/[-]AU

Enables or disables the audit trail, which indicates the changes made
during the most recent editing session.
BLANK FILL

outfile/ [-]BF=inflle

outfile=Iinfile/ [-]BF

Enables or disables blank fill (right-justification) for an audit trail.
COMPRESS

outfile/ [-]CM=infile
outfile=infile/[-]CM

Deletes the audit trail and any trailing spaces or tabs, and truncates the
text at the specified horizontal position.
CHECKSUM

outfile/CS[:n]=infile

outfile=infile/CS[:n]

Calculates the checksum value for the edit commands.
DOUBLESPACE

outfile/ [-]DB=infile

outfile=infile/ [-]DB
Enables or disables double-spaced listings. /~-DB is the default switch.
NO SEQUENCE

outfile/NS=inflle
outfile=infile/NS

Does not sequence lines in the output file. New lines are indicated by the

audit trail (if specified). This switch overrides the /RS and /SQ switches.
RESEQUENCE

outfile/RS=infile
outfile=Infile/RS

Resequences the lines in the output file so that the line numbers are incremented for each line written to the output file.

SLP Command Summary

SPOOL

outfile,listfile/ [-]SP=infile

Enables or disables the spooling of listing files to a line printer. This switch

_ applies only if the print spooler task (RSX-11M) or the Queue Manager
(RSX-11M/M-PLUS)is installed.

SEQUENCE

outfile/SQ=infile
outfile=infile/SQ

Sequences the linesin the output file so that the numbers reflect the line
numbers of the original input file.
TRUNCATE

outfile/TR=infile

outfile=infile/TR

Specifies that a diagnostic error message occurs when lines are truncated

by the audit trail.

SLP uses the following special operators, in edit mode, to perform specific

functions:

Operator
-

Function
Identifies the dash as the first character of a SLP edit command

line
\

Suppresses audit trail processing

Reenables audit trail processing

Invokes an indirect file for SLP processing

Terminates the SLP edit session and returns to SLP command

Allows characters in the input file that SLP would normally use

mode

as operators

- PAT COMMAND SUMMARY
PAT command lines use the following format:

[outfile)=infile[/CS[:numberl],correctfile[/CS[:number]]
In this command line, outfile is the file specification for the output file, infile is
the file specification for the input file containing one or more concatenated

object modules, and correctfile is the specification for the correction file containing updates to be applied to one module in the input file.

The only PAT switch is the following:
CHECKSUM

[outfile]}=infile/CS[:n],correctfile[/CS[:n]]

Directs PAT to calculate the checksum for all the binary data that constitutes the module. PAT displays this checksum in octal.

PERIPHERAL INTERCHANGE PROGRAM
(PIP) COMMANDS
Default Operation

The default PIP operation (with no switches) is to copy the specified files, using
the following format:
outfile = infile(,s)[/subswitches]

PIP allows the following parameters for this command:

outfile

If the command does not specify a file name, file type, or
version number, PIP uses the input name and type and the
next highest version number.
If the command specifies a file name, file type, or version
number, no other field can be a wildcard and the command
line can only specify one input file.

“infile

If the command does not specify file name, file type, or version number, the default is *.*;*.

subswitches:

/BL:n[.]

Specifies the number of contiguous blocks allocated for the
output file, where n is octal or decimal.

If n is decimal, it is followed by a period (n.).
/CO, /-CO,

/NOCO

/FO

/NV

Specifies a contiguous or noncontiguous output file.
File ownership (output file UFD).

Forces the output version number of the copied file to be 1
‘higher than the current highest version.

/SU
APPEND

Copies the output file, superseding an existing file.
outfile[/FO] = infile(s)/AP[/FO]

Opens an existing file and appends the input files, infile(s), to the end of it.
PIP allows the following parameters for this command:

outfile

Explicit file name and file type.

infile(s)

Explicit file parameters; wildcard by default.

/FO

File ownership is the output file UFD; without /FO, ownership is the UIC of the user running PIP.

Peripheral Interchange Program (PIP) Commands

BLOCKSIZE outfile/BS:n = infile(,s)

Defines the block size for magnetic tape.
D
= infile(,s)
CREATION DATE outfile/C
outfile = infile/CD

Gives the output file the creation date of the input file rather than the date

of the file transfer. (This switch cannot be used with the merge switch or
with a magnetic tape as an output device.)
/DD:startdate:enddate

DATE

Restricts file searches to files created during the specified period of time.
DELETE infile(s)/DE[/LD]

- Deletes files. /LD is a subswitch that causes PIP to list the files it deletes.
DEFAULT [ddn:J[JUFD]/DF

Changes the default device and/or UFD for the current PIP task.
END-OF-FILE infile/EOF[:block:byte]

Specifies the end-of-file pointers for a file. If values for block and byte are
not entered, PIP places EOF at the last byte of the last block in the file.
ENTER outfile = infile(s)/EN[/NV]

Enters a synonym for a file in a directory on the same device, with an
option to force the version number of the output file to 1 greater than the
latest version for the file.

outfile

The file name, file type, or file version can be explicit, a

wildcard, or null. A field that is a wildcard or null assumes a
corresponding input field.

infile

Default for the file name, file type, and file version is *.*;*.

/NV

Forces a new version of the file.

EXCLUDE

filespec/EX

Excludes one file specification during a search.
FILE ID

= /Fl:fil
outfile

Accesses a file by its file identification number (file ID).

Peripheral Interchange Program (PIP) Commands

FREE [ddn:] /FR

Displays on the terminal the amount of space available on a volume, the
largest block of contiguous space, the number of avaxlable file headers, and
the number of headers used.
IDENTIFICATION /ID

Identifies the version number of PIP currently in use and whether PIP is
linked to ANSFCS.

{ LIST [listflle = Jinfile(s)/LIi[/subswitch]
Lists the contents of one or more UFDs, with an option to specify formats
for output directories.

outfile

Listing file specifier; defaults to TI:.

infile

Default is *.%;*.

The following subswitches determine what type of report is displayed.
/LI/BR
or /BR
/LI

Brief report.
~

Limited report.

/LI/FU:n
or /FU:n

Full report (n specifies the decimal characters per hne, the

defaultis device buffer size).
/LI/TB
or /TB

Total blocks report.

/LI & /TD
or

/TD/LI

Files created on current day. The /TD switch alone does not

generate a directory listing.
MERGE outtlle
= inflle(,s)/ME[/subswitch(es)]

Creates one file by concatenating two or more files. The legal subswitches
are as follows:
subswitches:

/BL:n[.]

Specifies the number of contiguous blocks allocated for the
output file, where n is octal or decimal.
If n is decimal, it is followed by a period (n.).

Peripheral Interchange Program (PIP) Commands

/CO, /-CO,

or /INOCO

Specifies a contiguous or noncontiguous output file.

/FO

File ownership (output file UFD).

/NV

Forces the output version number of the copled file to be 1
higher than the current highest version.

/SU

Copies the output file, superseding an existing output file.

NO MESSAGE infile(s)/NM[/sw]

Causes certain PIP error messages not to be displayed: for example, the
message NO SUCH FILE(S). The switches that can be used with the NM
switch are as follows:
/L1

Lists directory.

/DE

Deletes file(s).

/PU

Purges file(s).

/UN

Unlocks .file(s) .

You can also use any subswitches of these switches.

PROTECTION SYMBOLIC:

infile/PR[/SY[:RWED][/OW[:RWED]]

[/GR[:RWED]J[/WO[:RWED]J[/FO]

Alters the file protection for the file specified. The file name and file type
must be explicit.
Symbolic protection codes assign privilege merely by their presence, using
the following:
System =/SY:RWED
Owner = /OW:RWED
Group =/GR:RWED
World = /WO:RWED

The symbolic codes are as follows:
R

read

write

extend

delete

Numeric protection denies privilege by setting bits in a protection status
word. Add octal values from the following list to deny privilege.

Peripheral Interchange Program (PIP) Commands

User

Octal Code

:
Bit

Class

Privilege

System

E
D

100
200

6
7

Group

R
\\'
E
D

400
1000
2000
4000

8
9
10
11

World

R
W
E
D

10000
20000
40000
100000

12
13
14
15

Owner

PURGE infile(s) /PU[:n][/LD]

Deletes a specified range of versions of a file (bfit does not delete the latest

version). Specification of a file version number is not necessary. Wildcards
are valid for file name and file type.

When :n is specified, PIP deletes all but the n latest consecutively
numbered versions. Without :n, PIP deletes all but the latest version.
REMOVE infile(s) /RM

Removes an entry from a UFD, but does not delete the file.
RENAME outfile = inflle(s)/RE[/NV]

Changes the name of the file specified. Used with the /NV switch, /RE
creates an output file with a version number 1 higher than the latest
version of the file.
outfile

A wildcard (*) or null field assumes the value of the corre-

infile

Null file name, file type, and file version default to *.*;*,

/NV

See COPY.

sponding field in the input file.

Peripheral Interchange Program (PIP) Commands

REWIND outfile/RW = infile
outfile = Infile /RW

outfile

Causes the magnetic tape on the specified unit to be rewound

infile

" Causes the magnetic tape on the specified unit to be rewound

and erased.

before the input fileis opened.

SELECTIVE DELETE infile(s)/SD

Prompts for user response before deleting files.
SHARED READING Iinfile(s)/SR

Allows shared reading of a file that has already been opened for writing.
SPAN BLOCKS outdsk:outfile/SB = inmag:infile

Allows output file records to cross block boundaries when ANSI tapes are
being copied to Files-11 volumes.

SPOOL Iinfile(s)/SP[:n]

Specifies a list of files to be printed on a line printer. n is the number of
copies. This switch applies only if you have the Serial Despooler or ‘the
Queue Manager. However, using it with the Queue Manageris not recom-

mended.

TRUNCATE

inflle(s)/TR

Truncates files to their logical end-of-file point.

= Infile(s)
' USER FILE DIRECTORY ENTRY outfile(s)/UF[/FO]

Creates a User File Directory entry in the Master File Directory on a
volume.

outfile

Specifies the UIC as [*,*] to transfer multiple infile UICs.

/FO

See APPEND.

UNLOCK infile(s)/UN

Unlocks a file that was locked as a result of being closed improperly.

Peripheral interchange Program (PIP) Commands

UPDATE FILE outfile — infile(s)/UP[/FO]

Opens an existing file and writes new data (infile) in it, from the beginning.
outfile

Must be explicitly identified.

infile

Null parameters default to *.*;*. Input file(s) replace the
current contents of output files.

QUEUE MANAGER
This section describes the Queue Manager commands for RSX-1IM-PLUS. It
includes syntax to use the commands from either DCL or MCR.
DELETE

Deletes queues or QMG jobs by name or by the job’s unique entry number.
Format

DCL>DELETE/JOB queuename jobname[FILE_POSITION:n]
DCL>DELETE/ENTRY:nnn[/FILE_POSITION:n]
MCR>QUE queuename:jobname/Fl:n/DEL
MCR>QUE /EN:nnn/Fl:n/DEL
HOLD AND RELEASE

You can specify that a job be held when you issue your PRINT or SUBMIT
command. You can also hold jobs with the HOLD command and release such

jobs with the RELEASE command.

HOLD (QUE /HO) blocks a job in its queue until it is explicitly released.
RELEASE (QUE /RE) unblocks a job that has been held in queue.
Format

DCL>HOLD/JOB queuename jobname
DCL>HOLD/ENTRY:nnn
MCR>QUE queuename:jobname/HO
MCR>QUE /EN:nnn/HO
DCL>RELEASE/JOB queuename jobname
DCL>RELEASE/ENTRY:nnn
MCR>QUE queuename:jobname/REL
MCR>QUE /EN:nnn/REL
PRINT

Queues files for printing on a line printer or use on other output devices.

Format

DCL>PRINT/commandqualifier[s] file[s]/filequalifier[s]
MCR>PRI! [queuename:][jobname][/jobswitch][=]file[s][/fileswitch[s]]
DCL Command Qualifiers

= MCR Job Switches

/JOBCOUNT:n

/CO:n

/QUEUE:queuename

queuename:

/UPPERCASE
/LOWERCASE

/NOLO
/LO

Queue Manager

/[NOJHOLD
/PAGE_COUNT:n
/NAME:jobname
/PRIORITY:n
/FORMS:n

/[NOJHO
/PA:n
jobname=
/PRIO:n
/FO:n

/LENGTH:n
/[NOJRESTART
/[NOJFLAG__PAGE

/LE:n
/[NO]JRES
/[NO]FL

/DEVICE:ddnn:
/NOJOBPAGE

gueuename:
/NOJO

DCL File Qualifiers

MCR File Switches

/AFTER:(dd-mmm-yy hh:mm) /AF:hh:mm:dd-mmm-yy

/[NO]DELETE
/COPIES:n

/[NO]DEL
/CO:n

SET QUEUE

Modifies attributes given to print jobs, batch jobs, or files that compose jobsin
queues. Such jobs and files have been entered in queues by the PRINT command.

Job Format

DCL>SET QUEUE queuename:jobname/qualifier[/qualifier[s]]
DCL>SET QUEUE /ENTRY:nnn/qualifier[/qualifier[s]]
MCR>QUE queuename:jobname/MOD/switch[/switch(s]]
MCR>QUE /EN:nnn/MOD/switch/[/switch[s]]

MCR Switches
DCL Qualifiers
/AFTER:(hh:mm dd-mmm-yy) /AF:hh:mm:dd-mmm-yy
/JOBCOUNT:n
/FORMS:n
/LENGTH:n
/LOWERCASE
/PAGE__COUNT:n
/PRIORITY:n
/[NOJRESTART
/UPPERCASE

/CO:n
/FO:n
/LE:N
/LO
/PA:N
/PRIO:n
/[NO]RE
/NOLO

File Format

DCL>SET QUEUE/ENTRY:nnn/FILE_POSITION:n/qualifier[/qualifier[s]]
jobname/FILE__
queuename
QUEUE
DCL>SET
POSITION:n/qualifier[/qualifier[s]]

MCR>QUE /EN:nnn/MOD/Fl:n/switch{/switch[s]]

MCR>QUE queuename:jobname/MOD/Fl:n/switch[/switch[s]]

Queue Manager

DCL Qualifiers

MCR Switches

/COPIES:n

/CO:n

/ [NO]JDELETE

/[NO]DEL

SHOW PROCESSOR

Displays information about the initialized characteristics printers, and other
devices under control of the Queue Manager.
Format
DCL>SHOW PROCESSOR/qualifier

MCR>QUE [processorname:}/switch
DCL Qualifiers

MCR Switches

processornamef:]

/LI:DEV

/PRINT or /DEVICE

/LI:DEV:P

/INPUT or /CARD__READER

/LI:DEV:I

SHOW QUEUE

SHOW QUEUE displays information about QMG print jobs.
Format

DCL>SHOW QUEUE [queuename]/qualifier(s]

MCR>QUE [queuename:][[uic]][jobname]/switch[s]
DCL Qualifiers

MCR Switches

/FULL

/FU

/FILES

/LI

/BRIEF

/BR

/DEVICE

/LI:P

/ENTRY:nnn

/EN:nnn

/FORMSI:n]

/FO[:n]

/NAME:jobname

jobname

/OWNER__UIC:uic

[uic]

/PRINT

/LIP

ZAP COMMAND AND SWITCH SUMMARY
Invoke ZAP before you enter the ZAP command line, using the following format:

" ddnn: [ufdifilename,filetype;version[/sw...]
You cannot enter a file specification on the command line when you invoke ZAP.
In this command, the file specification is the task image file to be examined or
modified. The default file type is .TSK and the default version is the latest one.
ZAP command lines use the following switches:
ABSOLUTE

ddnn:filespec/AB

Specifies absolute mode.
LIST

ddnn:filespec/L]

Displays the overlay segment table for an overlaid task image file.
READ-ONLY

ddnn:filespec/RO

Specifies read-only mode.
ZAP Open/Close Commands

ZAP uses the following commands to examine or modify a task image file:

/ (slash)

Opens a location, displays its contents in octal, and stores the contents of

the location in the Quantity Register (Q). If the location is odd, it is opened
as a byte.
" (quotation mark)
Opens a location, displays the contents of the location as two ASCII characters, and stores the contents of the location in the Quantity Register (Q).

% (percent sign)
-

Opens a location, displays the contents of the location in Radix-50 format,

and stores the contents of the location in the Quantity Register (Q).

\ (backslash)

{

Opens a location as a byte, displays the contents of the location in octal,
and stores the contents of the location in the Quantity Register (Q).

ZAP Command and Switch Summary

" (apostrophe)

Opens a location, displays the contents as one ASCII character, and stores
the contents of the location in the Quantity Register (Q).

<RET> (RETURN key)

Closes the current location as modified and opens the next sequential
location if no other values or commands are on the command line. ZAP
commands take effect only after you press the RETURN key.

T or

(circumfiex or up arrow)

Closes the currently open location as modified and opens the preceding
location.

__ (underscore)

Closes the currently open location as modified, uses the contents of the
location, as an offset from the current location, and opens the new location.

@ (at sign)

Closes the currently open location as modified, uses the contents of the
location as an absolute address, and opens that location.

> (right angle bracket)

Closes the currently open location as modified, interprets the low-order
byte of the contents of the location as the relative branch offset, and opens
the target location of the branch.

< (left angle bracket)

Closes the currently open location as modified, returns to the location from
which the last series of underscore (), at sign (@), and/or right angle
bracket (>) commands began, and opens the next sequential location.

General-Purpose Commands
X

Exits from ZAP and returns control to the CLIL.
K

Calculates the offset in bytes between an address and the value contained
in a Relocation Register, displays the offset value, and stores it in the
Quantity Register (Q).

ZAP Command and Switch Summary

Displays the jump and branch displacements from the current location to a
target location.

Displays in octal the value of the expression to the left of the equal sign.
\'

Verifies the contents of the current location.
R

Sets the value of a Relocation Register.

MONITOR CONSOLE ROUTINE (MCR) COMMANDS
In this section, (P) indicates that a command format or keyword is privileged.
ABORT

ABO taskname [/keyword]

Keywords:

/PMD
/TERM=TTnnn:

Terminates execution of the specified task from the issuing terminal, or
from another terminal if the /TERM keyword is used by a privileged user.
You can request a Postmortem Dump with the /PMD keyword.
ACTIVE

ACT [/keyword]

Keywords:

/ALL
/TERM=TTnn:

Displays on the terminal all tasks issued from that terminal, all tasks
active in the system, or all tasks issued from a specified terminal.
ACTIVE TASK LIST

ATL

[taskname]

Displays the name and status of all active tasks in the system, or the status
of the particular task specified.
ALLOCATE
Keywords:

‘

ALL dd[nn:][=linn:][/keyword]
/TERM=TTnn:
/TYPE=dev

Establishes the specified device as the user’s private device on multiuser
protection systems. Privileged users can allocate a device to any terminal,
using the /TERM keyword, but nonprivileged users can only allocate devices to their own terminals.

Specifying dd allocates the first logical unit of the dd-type device (for
example, DM1:). Specifying the /TYPE keyword allocates the first available dev-type device (for example, RK07). Specifying =llnn: creates a logical device name and assigns it to the physical device being allocated.
ALLOCATE CHECKPOINT SPACE

(P)

ACS ddnn:/BLKS=n.

Allocates or discontinues a checkpoint file on disk for systems that support
the dynamic allocation of checkpoint space. The /BLKS keyword specifies
the number of blocks to be allocated to the checkpoint file. Use n=0 to
discontinue use of a checkpoint file.

Monitor Console Routine (MCR) Commands

ALTER

ALT taskname[/keyword]

Keywords:

(P)

/PRi=static and running priority
/RPRI=running priority only

/TERM=TTnn: = task priority from a specified terminal

Changes the static or running priority of an installed task.
ACD function

ANCILLARY CONTROL DRIVER

Functions (Privileged):

INSTALL filename AS NUMBER n [ASSIGN

logicalname] -

REMOVE NUMBER n [logicalname]

Loads and unloads character translation routines so terminals that conform to other standards can use the DIGITAL Multinational Character Set
(MCS).

Functions (Nonprivileged):

LINK ttnn: TO NUMBER n [logicalname]
UNLINK ttnn:

Links or unlinks the specified routine to the specified terminal.
ASSIGN

ASN ppn:=linn: [/keyword]

Keywords:

/GR (P)
/FINAL (P)
/GBL (P)
/LOGIN

/TERM=TTnn:

Assigns, displays, or deletes logical name assignments if extended logical
name support was selected during system generation or logical device assignments, as specified in the following list.

Note that ppn: is the physical device name or equivalence string, and linn
is the logical name being assigned.

Local assign operations'
ASN ppn:=linn:

ASN ppn:=linn:/TERM=TTnn:

(P)

Login assign operations
ASN ppn:=linn:/LOGIN (P)
ASN ppn:=linn:/LOGIN/TERM =TTnn:
Group assign operations
ASN ppn:=linn:/GR (P)

(P)

Monitor Console Routine (MCR) Commands

Global assign operations
ASN ppn:=linn:/GBL

(P)

Local display operations
ASN
Login display operations
ASN /TERM=TTnn:

(P)

Group display operations
ASN /GR (P)

Global display operations
ASN /GBL

(P)

Local delete operations

ASN

=lInn:

=/LOGIN

ASN

=/LOGIN/TERM=TTnn:

(P)

ASN

=/TERM=TTnn:

ASN

=/lIInn:/TERM=TTnn:

ASN

=/linn:/LOGIN

ASN

=/linn:/LOGIN/TERM=TTnn:

(P)

(P)
(P)

Group delete operations
ASN=/GR (P)
Global delete operations
ASN

=/GBL

(P)

ASN =lInn:/GBL
BLOCK

(P)

BLK [taskname][/TERM=TTnn:]

Declares that the specified task is ineligible to execute or to compete for
memory resources. Nonprivileged users can block only tasks running from

their own terminals. Privileged users can block any task. However, ACP
tasks, CLI tasks, tasks being aborted, and halted tasks cannot be blocked.

Monitor Console Routine (MCR) Commands

BOO [filespec]

BOOT

(P)

Bootstraps a system that exists as a task image fileon a Files-11 volume.
BREAKPOINT TO XDT (P)

BRK

Passes control to the Executive Debugging Tool (XDT).
BRO TTnn: message

BROADCAST

BRO @filespec

BRO ALL:message (P)
BRO LOG:message (P)
BRO user-name message

Displays the specified message at one terminal for a nonprivileged user, or
at a number of terminals for a privileged user.

BYE [/keyword]

Keyword:

/[NOJHOLD

Logs the user out of a multiuser protection system, optionally specifying
that the full-duplex terminal driver not hang up a remote line or that
DECnet not break the connection.

CANCEL

CAN taskname

Cancels time-based initiation of a task. Privileged users can cancel any
task, but nonprivileged users can cancel only tasks that they initiated.

COMMON BLOCK DIRECTORY
Keyword:

CBD [common-region-name[/keyword]]

/TASKS

Displays information about all entries or a specific entry in the Common
Block Directory. Also, CBD with the /TASKS keyword displays the name
of each task attached to a specific common region and the number of times
the task has mapped to the region.

COMMAND LINE INTERPRETER
Keywords:

CL! /keyword=cliname

/DISABLE=cliname
/ELIM=cliname or ELIM=+
/ENABLE=cliname

/INIT=cliname[/subkeyword(s)]
Subkeywords: /CPR="string"
/DISABLE

/DPR="string"
/LGO

/MESSAGE

Monitor Console Routine (MCR) Commands

Subkeywords: /NULL
/PRIV
/PROMPT
/QUIET

/RESTRICT
/SNGL

/TASK=taskname

/MESSAGE=cliname:"message-text"
/SHOW
/UNOVR

Sets up for use a command line interpreter other than MCR, such as DCL
or a user-written CLI.
CLOCK QUEUE

CLQ[UEUE]

Displays on the entering terminal information about tasks currently in the
clock queue.
DEALLOCATE

DEA [ddnn:]

Releases a private (allocated) device where ddnn: is the device name and
unit number. Privileged users can deallocate any device, but nonprivileged
users can only deallocate devices that they have allocated. If no device is
specified, the command deallocates all of the user’s allocated devices.
DEBUG

DEB [taskname]

Allows you to debug a task by forcing the task to trap to a debugging aid.

Nonprivileged users can debug only tasks that they initiated. Privileged
users can debug any task.

DEFINE LOGICALS

DFL keyword

Defines, deletes, or displays logical name assignments.
Keywords:

/ALL
/FINAL (P)
/GBL or SYSTEM (P)
/TERM=TTnn: (P)

Local define operations
DFL ppn:=linn: (P)
DFL ppn:=linn:/TERM=TTnn: (P)
Group define operations
DFL ppn:=linn:/GR (P)

Monitor Console Routine (MCR) Commands

Global define operations
DFL ppn:=linn:/GBL (P)
DFL ppn:=linn:/SYSTEM (P)

Local display operations
DFL
DFL /ALL

Group display operations
DFL /GR (P)

Global display operations

DFL /GBL or /SYSTEM (P)
Local delete operations
DFL =

Group delete operations
DFL =/GR (P)

Global delete operations

DFL =/GBL or /SYSTEM

DEVICES

DEV [/keyword]
DEV dd:

DEV ddnn:

Keyword:

/LOG

Displays symbolic names of all devices or of all devices of a particular type,

or the name of a_specific device. The /LOG keyword displays all of the
logged-in terminals as well as device characteristics.

DIGITAL COMMAND LANGUAGE

DCL command-line

Allows you to issue DCL commands from a terminal that is set to MCR.

DISMOUNT
Keywords:

DMO ddnn:[["]IabeI["]][/keyword(s)]
DMO /USER[/keyword(s)]
/DEV (P)
/TERM=TTnn: (P)
/LOCK=option

Tells the file system to mark the volume for dismount and to release the

control blocks. Privileged users can dismount any volume, but nonprivileged users can dismount only devices that they have mounted.

Monitor Console Routine (MCR) Commands

FiX IN MEMORY
Keywords:

(P)

FIX taskname [/keyword]

/REG
/RON

Loads and locks a task or a common task region into its memory (or
partition memory).
GROUP GLOBAL EVENT FLAGS

Keywords:

FLA[GS][[gga}keyword]

/CRE
/ELIM

For privileged users, creates or eliminates global event flags for any group.
For nonprivileged users, creates or eliminates group global flags only for

their own login group. Any user can display all of the group global event
flags.
HELLO/LOGIN

HEL [uic[/password]]}
HEL [username[/password]]

LOG [ulc|/password]]
LOG [username|/password]]

Logs you in on a terminal to access a multiuser system.
HELP

HELP [/keyword] [qualifier][qualifier 2][...qualifler 9]
HELP % [qualifier}[qualifier 2][...qualifier 9]

Keywords:

/CLl:cliname
/DCL

/FIL:[filespec)
/GRO

/LOC
/MCR

/OUT:filespec

Displays the contents of a help file on the issuing terminal.
HOME

HOM ddnn:volume-label/keyword(s)

Keywords:

/DENS=density
/EXT=Dblock-count
/FPRO=[system,owner,group,worid]
/LRU=directory-count
/MXF=file-count

/NAME=new-volume-label

/OVR

(P)

/OWNER=[g,m)

Monitor Console Routine (MCR) Commands

Keywords:

/POS
/PRO=[system,owner,group,world}]
/UIC=[g,m]
/VI

/WiN=retrieval-pointer-count

Modifies certain fields in the home block of a Files-11 disk volume.

INITIALIZE VOLUME
Keywords:

INI ddnn:["Jvolume-label["] [/keyword(s)]

/ACCESS="character"
/BAD=[option]

/DENS=density
/EXT=Dblock-count

/FPRO=[system,owner,group,world]
/INDX=index-file-position
/INF=initial-index-file-size
/LRU=directory-count

/MXF=file-count

/OWNER=[g,m] or OWNER="owner"
/POS

/PRO=[system,owner,group,worid]
/UIC=[g,m]
/VI

/WIN=retrieval-pointer-count

Produces a Files-11 volume on disk, magnetic tape, or DECtape. On mul-

tiuser protection systems, you can initialize volumes only on devices that
you allocated.

INSTALL

INS [$lfilespec|[/keyword(s)]

Keywords:

(P)

/AFF=[CPx,UBy]
/CKP=option
/CLI=option
/INC=size
/10P=option
/PAR=pname
/PMD=option

/PRI=number

/PRO=[system,owner,group,world]
/RON=o0ption
/ROPAR=parname
/SEC=option
/SLV=option

/SYNC=option
/TASK=taskname

Monitor Console Routine (MCR) Commands

Keywords:

/TIME=nM
or

/TIME=nS

/UIC=[g,m]

/WB=option
/XHR=option

Makes a specified task known to the system.

LOAD

LOA dd:[/keyword(s)]

Keywords: /PAR=parname

(P)

/CTB=ccal,b...]

/SIZE=parsize
/HIGH

/VEC

Reads a nonresident device driver into memory and constructs the linkages
required to allow access to the device.
LOGICAL UNIT NUMBERS

LUN[S] taskname

Displays the static LUN assignments for a specified task.
MOUNT
Allows the file system software access to a physical device.
Files-11 disk or DECtape format:

MOU ddnn:[label][/keyword(s)]

Keywords:

/ACP=option

(P)

/CACHE=o0ption

/DENS=density
/EXT=block-count
/FOR
/FPRO=[system,owner,group,worid]
/LOCK=option
/LRU=directory-count
/OVR

(P)

/PARM="user parameters"
/PRO=o0ption
- /PUB
/[NO]JSHARE
/UIC=[g,m]

/UNL

/VI

Monitor Console Routine (MCR) Commands

Keywords:

/[NOJWAIT
/WIN =option

/[NOJWRITE

Files-11 (ANSI) magnetic tape format:

MOU device-list:[file-set-ID][/keyword(s)]

Keywords:

/ACP=option

(P)

/BS=n

/CC=option

/DENS=density
/FOR

/FPRO=[system,owner,group,world]
/[NOJHDR3
/[NOJLABEL

/LOCK= option

/OVR

(P)
/OVRACC (P)
/OVREXP (P)
/OVRFSID (P)
/PARM="user parameters"
/PRO= option
/PUB
/RS=n

/[INOJSHARE
/TR= option
/UIC=[g,m]
/VI
/VOL= (list)

~/[NOJWAIT

/[NO]WRITE

OPEN REGISTER

(P)

OPE[N] mem-addr{+/-n][/keyword]
mem-addr /contents [ctri-char]{valuejterm

Keywords:

/AFF=[CPx,UBy]
/CPU=CPx

/TASK=taskname
/TASKD
/TASKI
/PAR=partitionname
/KNL

/KNLD

Monitor Console Routine (MCR) Commands

Keywords:

/KNLI
/DRV=dd:

/REG=region-name

~ Allows examination and optional modification of a register in memory.
PARTITION DEFINITIONS

PAR[TITIONS]

Displays a description of each memory partition in the system.
REASSIGN

(P)

REA taskname lun ddnn:

Reassigns a task’s static logical unit numbers from one device to another.
REDIRECT

(P)

RED nddnn:=oddnn:

Redirects all I/0 requests from one physical device unit to another (from 0
to n).
REMOVE

(P)

REM [ddnn:] taskname or REM region-name/keyword

Keyword:

/REG

Deletes an entry (task name) from the System Task Directory (STD) and

thereby removes the task from the system. The optional device specification indicates the device from which the task was installed. The /REG
keyword removes regions from the CBD.
RESUME

RES taskname [/keyword]

Keyword:

/TERM=TTnn:

(P)

Allows nonprivileged users to continue execution of a suspended task that
was initiated from the entering terminal. Privileged users can resume any

suspended task.
RUN

RUN taskname [/UIC=[g,m]]

(/UIC privileged keyword)

RUN taskname dtime [/RSI=magu][/UIC=[g,m]]

(P)

RUN taskname sync [dtime][/RSI=magu][/UIC=[g,m]]
RUN taskname atime [/RSl=magu][/UIC=[g,m]]

(P)

RUN [ddnn:][$] filespec [/keyword(s)]

Keywords:

/CKP=option
/CMD="command-line"
/EST=option

/INC=size
/10P=option
/PAR=pname

/PMD=option

Monitor Console Routine (MCR) Commands

Keywords:

/PRl=number

(P)

/ROPAR=pname
/SLV=option
/TASK=taskname

/TIME=nM or TIME=nS
/UIC=[g,m]

Initiates execution of a task, either immediatelv or at one of several fimedependent intervals.

SAVE

(P)

SAV [/keyword(s)]

Keywords:

/WB

/MOU="string"

/SFILE="filespec"
/CSR=x

Copies the current system image into the system image file from which the
current system was booted.

SET

SET /keywérd:values
Keywords:
.

/[NOJABAUD[=TTnn:]
/[NOJANSI[=TTnn:]
/[NOJAVOI[=TTnn:]
/[NO]BLKMOD[=TTnn]
/[NO]BOT=pname:value
/[NO]BRO[=TTnn:}
/BUF=ddnn:[size]

/[NO]JCACHE=option
/CLI=TTnn:[cli]

/COLOG

/CRASHDEV and CRASH__DEVICE:ddnn:[CSRaddr]
/[NOJCRT[=TTnn:]
/DCL[=TTnn:]

/[NO]DEC[TTnn:]

/DEF[="(ddnn:][[directory]]]
/[NO]DPRO[=protection codes]
/[NO]JEBC[=TTnn:]
/[NOJECHO[=TTnn:]
/[NOJEDIT[=TTnn:]
/[NO]JESCSEQ[=TTnn:]
/[NOJFDX[=TTnn:]

/[NOJFORMFEED[=TTnn:]
/HFILL=TTnn:[value]
/INOJHHT[=TTnn]

/[NOJHOLD[=TTnn:]

Monitor Console Routine (MCR) Commands

Keywords:

/HOST[=node[::]
/[NOJHSYNC[=TTnn:]
/INQUIRE

/LIBUIC[=[uic]]

/LINES=TTnn:[value]
/[NOJLOGON

(P)

/[NOJLOWER[=ddnn:]
/[NO]MAIN=pname|[:base:size: type]
/NOPAR=pname

/MAXEXT[=size]

(P)

/MAXPKT{[=n]
/MCR[=TTnn:]
/[INO]JNAMED

/NETUIC[=[g,m]]

/NOCEX

/NOMAIN=pname (P)

/[NO]JOPT[=ddnn:opttyp:fairness-count]
/[NOJOVLP[=ccn]

/PAR=pname|[:base:size[:type]]
/[NOJPARITY

/PASSWORD

/[NOJPASTHRU[=TTnn:]

/PLCTL[=high][:[low][:[frsiz][:basep]]]]

(P)

/POOL[=top]

/POOLSIZE=size

/[NOJPRINTER_PORT[=TTnn: ]
/[NO]JPRIV[=TTnn:]
/[NOJPUB[=ddnn:]
/[NOJREGIS[=TTnn:]

/[INOJREMOTE([=TTnn:[speed]]
/RNDC[=nn]
/RNDH[=nn]

/RNDL[=nn]
/[NOJRPA[=TTnn:]
/SECPOL
/[NOJSERIAL[=TTnn:]

/[NO]JSLAVE[=TTnn:]

/[NOJSOFT[=TTnn:]
/SPEED=TTnn:[recv:xmit]
/SWPC[=nn]

/SWPR[=nn]
/SYSUIC[=[g,m]]
/TERM=TTnn:[value]

/TOP=pname:value

/[NOJTTSYNC[=TTnn:]

Monitor Console Routine (MCR) Commands

Keywords: /[NOJTYPEAHEAD([=TTnn[:size]]
/UIC[=[g,m][:TTnn:]]

/UIC[=TTnn:]

/[NO]JVFILL[=TTnn:]
/[NO]JWCHK[=ddnn:]
/INOJWRAP[=TTnn:]

Affects characteristics of the system, tasks, and devices. Privileged users
can alter the characteristics of any device or task, but nonprivileged users

can alter only characteristics for devices and tasks allocated to them. All
'

users can display information.

SYSTEM SERVICE MESSAGE (P)

SSM message

Inserts text into the error log file.
TASKLIST - ATL

TAL [taskname]

Displays the names and status of all tasks installed in the system or of a
specific task.

TASKLIST

TAS [taskname][/DEV=ddnn:]

Describes each task installed in the system, a specific task, or one or more
tasks installed from a specific device.
TIME

TIM [hrs:mins[:secs]] [m1/day/year]

[hrs:mins[:secs]] [day-m2-year]

For privileged users, sets and displays the date and time for the system.
For nonprivileged users, only displays them.

USER FILE DIRECTORY
Keywords:

UFD ddnn:[volume-iabel}{g,m][/keyword(s)]

/ALLOC=number
/PRO={[system,owner,group,world]

Creates a User File Directory (UFD) on a Files-11 volume and enters its

name into the Master File Directory (MFD). Privileged users can create

UFDs on any mounted volume, but nonprivileged users can create UFDs
only on a volume mounted on a device that they have allocated.

UNBLOCK
Keyword:

UNB [taskname][/keyword]
/TERM=TTnn:

(P)

Continues the execution of a previously blocked task. Nonprivileged users
can unblock only tasks running from their own terminals. Privileged users
can unblock any task.

Monitor Console Routine (MCR) Commands

UNFIX

UNF taskname or UNF reglon-name /keyword

Keywords:

(P)

/REG
/RON

Frees a fixed task or common task region from memory.
UNLOAD

UNL dd:

(P)

Removes a loadable device driver from memory.
UNS[TOP] taskname[/keyword]
Keyword:

/TERM=TTnn:

(P)

Continues execution of a task previously stopped internally by the Executive. Nonprivileged users can unstop only tasks running from their own

terminals. Privileged users can unstop any task.

DIGITAL COMMAND LANGUAGE (DCL)
In this section, (P) indicates that a command format or keyword is privileged.
ABORT

ABORT[/COMMAND][/qualifier[s]] commandname
ABORT/TASK[/qualifier] taskname

Command

Qualifiers:

/COMMAND
/TASK

/[NO]JPOSTMORTEM
/TERMINAL:ttnn:

Default:

(P)

/COMMAND

Forces an orderly end to a running task or to the action of a specific
command.
ALLOCATE

ALLOCATE[/qualifier[s]] dd[nn:] [logicalname]

Command
Qualifiers:

/TERMINAL:ttnn:

(P)

/TYPE:devicetype

Default:

NONE

Declares a specified device to be a private device. You can allocate devices
by logical name or physical name. If you omit the unit number and colon,
the first available device of that class is allocated.
ANALYZE/CRASH__DUMP

ANALYZE/CRASH__DUMP

[/qualifier[s]lfilespec]/qualifier[s]]
Command
Qualifiers:

/LIST[:listfilespec[/qualifiers]]
/ERROR__LIMIT
/PAGE__COUNT
/PAGE_LENGTH
/[NO]JPRINTER
/EXIT:n

/LIMIT:n
/LINES:n
/[-]SP

/BINARY:binaryfilespec

/MEMORY_SIZE:n

/SYMBOLS:symbolfilespec

DIGITAL Command Language (DCL)

Filespec

Qualifiers:

/ACTIVE:(arg(,...])
DEVICES
TASKS
/ALL

/DEVICES
/TASKS

/BLOCK:n

/CLOCK__QUEUE
/CONTROLLERS
/DENSITY:n

/DATA_STRUCTURES:(arg[....])
. COMMAND_PARSER
DEVICE

PARTITION

STATUS
TASK
UNIT

/DUMP[:(START:n,END:n[ADDRESS:n])]
/HEADERS

/KERNEL:(argl,...])

DATA:(START:n,END:n)
INSTRUCTION:(START:n,END:n)
REGISTERS

/PARTITION
/POOL:(START:n,END:n)

/SECONDARY__POOL[:(START:n,END:n])
/[NO]JSYSTEM

/TASKS:(arg|....])