Digital PDFs

AV-H435C-TC

November 2000

232 pages

Original

35MB

view download

OCR Version

13MB

view download

Document:	RSX-11M-PLUS Mini Reference Version 2.1
Order Number:	AV-H435C-TC
Revision:	0
Pages:	232
Original Filename:

OCR Text

RSX-11M-PLUS
Mini-Reference
,

Order No. AV-H435C-TC

RSX-11M-PLUS Version 2.1

digital equipment corporation - maynard, massachusetts

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

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.

The following are trademarks of Digital Equipment Corporation:
DEC

DIBOL
EduSystem

DEC/CMS

DEC/MMS

IAS

DECnet

MASSBUS
PDP
PDT

DECsystem-10
DECSYSTEM-20

DECUS

VAX

RSTS

DECwriter

RSX
UNIBUS

VMS
vT
|

Mn@nan
ZK2384

HOW TO ORDER ADDITIONAL DOCUMENTATION
In Continental USA and Puerto Rico call

800-258-1710

In New Hampshire, Alaska, and Hawali call
In Canada call

603-884-8660

613-234.7726 (Oftawa-Hull)

B800-267-6146 (all other Canadian)

DIRECT MAIL ORDERS (USA & PUERTO RICO)"
Digital Equipment Corporation
P.0O. Box C52008
Nashua, New Hampshire 03061

DIRECT MAIL ORDERS (CANADA)

Digital Equipment of Canada Lid.

840 Beifast Road

Ottawa, Ontario K1G 4C2

Attn: ASSG Business Manager

DIRECT MAIL ORDERS (INTERNATIONAL)
Digital Equipment Corporation
A&SG Business Manager
c/o Digital's local subsidiary or
approved distributor

"Any prepaid order from Puerto Rico must be placed
with the local Digital subsidiary (809-754-7575)

internal orders should be placed through the Software Distribution Center (SDC), Digital Equipment

Corporation, Northboro, Massachusetts 01532

Contents
Page

PREFACE

. ... .

...

.....

ON-LINE HELP FILES . . . . . . . . e
UTILITIES

e e

e e e e e

BAD Command Summary . . . . . . . e e e
BRU Command Summary . . . . . . . . . « «
CMP Command Summary . . . . . . . . . . e
DMP Command Summary . . . . . . . . .«
DSC Command Summary. . . . . . . . . . .«
Line Text Editor (EDI) Commands . . . . . . .
DIGITAL Standard Editor (EDT) Commands . .
FLX Command Summary. . . . . . . . . . .«
FMT Command Summary . . . . . . .. . ..
LBR Command Summary. . . . . . . . . . . .

e e e v

e e e e e e e 1

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

e
e e e 3
v v v 0 v 5
e e e e 9
o v 13
0. 17
. .. .. 19
. . . . . 27
v o v v 39
e e e 43
v o . 45

SLP Command Summary. . . . . . . . . « . « v v v v v o v« 47
PAT Command Summary. . . . . . . . . . . . . .«
o o
.. 49
Peripheral Interchange Program (PIP) Commands . . .
51
Queue Manager Commands . . . . . . . . . . . .. ..
... 59
ZAP Command and Switch Summary . . . . . . . . . . ... .. 63
COMMAND LINE INTERPRETERS
Monitor Console Routine (MCR) Commands. . . . . . . . . . .. 67
DIGITAL Command Language (DCL) Commands . . . . . . . . . 81
SYSTEM MANAGEMENT TOOLS
Error Logging System. . . . . . . . . . . . . . ... C e e . 119
Procedure for Halting a Job in a Print Queue . . . . . . . . . .. 125
PROGRAMMING TOOLS
On-Line Debugging Tool (ODT) Commands . . . . . . . . . . .. 127
Task Builder (TKB) Switches and Options. . . . . . . . . . . .. 133
RMS-11
RMSBCK Utility Summary . . . . . . . . . . . .« .«
. 143
RMSCNYV Utility Summary. . . . . . . e e e e e e e e e 145
RMSDES Utility Summary . . . . . . . . . . . . . .
. .. 147
RMSDSP Utility Summary . . . . . . . . . . . . . . . ... . 153
RMSIFL Utility Summary . . . . . . . . . . . . . .
... 155
RMSRST Utility Summary . . . . . . . . . .. e
e e e e e 157
RMS-11 Completion Codes and Fatal Error Codes . . . . . . . . . 159

Contents

REFERENCE INFORMATION
ASCII Character Set .
I/O Error Codes

Directive Error Codes.

.....

Executive Directive Summary.
RADIX-50 Conversion Table

......

»»»»»»

. 169

Octal/Decimal Conversion Table.
Standard File Types .
.

Notes

uuuuuu

.....

-------

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, com-

mand 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
¢ Bad Block Locator Utility (BAD)
* Backup and Restore Utility (BRU)
¢ File Compare Utility (CMP)
* File Dump Utility (DMP)
¢ Disk Save and Compress Utility (DSC)

¢ Line Text Editor (EDI)
¢ DEC Standard Editor (EDT)
¢ File Transfer Program (FLX)

* Disk Volume Formatter (FMT)

¢ Librarian Utility (LBR)

* Source Language Input Program (SLP)
¢ Object Module Patch Utility (PAT)
* Peripheral Interchange Program (PIP)

* Queue Manager
— Print and Queue Utility (QMG)
¢ Task Image File Patch (ZAP)

Preface

Command Line Interpreters
* Monitor Console Routine (MCR)
* Digital Command Language (DCL)

System Management Tools
e Error Logging System
¢ Procedure for Halting a Job in a Print Queue

Programming Tools
¢ On-Line Debugging Tool (ODT)
¢ Task Builder (TKB)

Reference Information
¢ ASCII Character Set
¢ Directive Error Codes

* Executive Directive Summary in Alphabetical Order by Macro Call

* I/O Error Codes
* RADIX-50 Conversion Table
* Octal/Decimal Conversion Table
¢ Standard File Types
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.

ON-LINE HELP FILES
Extensive help files for the utilities, MCR, DCL, and many other system components are available to you at your terminal.

For help in logging in to the system, type HELP HELLO (from MCR) or HELP

RSX-11M-PLUS systems have two major command languages or CLIs. These

are MCR and DCL. Once you log in, your terminal is set to either MCR or DCL.
All terminals are set to MCR prior to logging in.
From an MCR terminal, type HELP LIST for information on available help.

From a logged-on DCL terminal, type HELP for information on available help.

The general form of the HELP command is:
>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 on terminal.

If you do not include a CLI qualifier to the HELP command, the default is the
name of the CLI to which your terminal is set.

Except for /OUT[PUT], each of the following qualifiers has the effect of specify-

ing a file where help can be found. The MCR form of these qualifiers is limited to
the first three characters. The DCL form includes the entire qualifier name.
>HELP/LOCI|AL] [param[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.

>HELP/CLI:cliname [param]s]]

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.

On-Line HELP Files

>HELP/MCR [param|s]]

Specifies that the HELP text begins in the file LB:[1,2IMCR.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,2]DCL.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,2]filename
HLP.
>HELP/xxx [param]|s]]

Specifies that the HELP text is located in the file LB:[1,2]xxx.
HLP, where xxx is
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 transferred, filespec is the particular file or category of file to be backed up or re-

stored, and outdevice(s) are the output devices to which data is being transferred.

BRU qualifiers are:

/APPEND
Appends new backup data to a 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 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 Command 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 tape reads
during a restore operation before automatically terminating execution. The

default is 25(decimal) errors.

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

/EXTEND: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 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 vou 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.

/OUTVOLUME:name
Specifies the volume label of the output disk. The label can be up to 12(10)
characters long.

/POSITION:

BEGINNING

MIDDLE

END
BLOCK:number

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

BRU Command Summary

/PROTECTION:

SYSTEM:value
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 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 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 vqlume.

/VERIFY

Copies data from the input volume to the output volume, compares the
volumes, and reports any differences.
N

/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...=]infilel,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 TI: 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:
'
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 included 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 exclama-

tion 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 semicolon) in compare processing. /CO is the default switch.
DIFFERENCES

[outfile]/[-]Dl=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

FORM-FEED

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

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 you specify /SL (below), /LN is unnecessary.

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 processing. However, all spaces and tabs are printed in the output listing. /MB is
the default switch.
SLP FILE

outfile/SL[:aul=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

w}w 4

W@&;g

”"‘%%

necessary to make infilel identical to infile2. If a 1- to 8-character alphanu-

meric 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 optionally 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 print spooler task (RSX-11M) or
the Queue Manager (RSX-11M/M-PLUS) installed.

CMP Command Summary

TRAILING BLANKS

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

Specifies that CMP include all trailing blanks on a line in compare processing. If you specify /~TB, CMP ignores all blanks following the last
nonblank character on a line. When you specify /~-CO and /-TB together,

blanks that precede 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 character
code. For example, you can specify /VB:174 for a vertical bar (if your

printer is capable of printing the vertical bar character). /VB:041 (for the
exclamation mark) is the default switch.

DMP COMMAND SUMMARY
Command lines for the file dump utility (DMP) use the following 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=infile/AS

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

outfile/BA:n:m=infile

Specifies a 2-word base block address.
BLOCK

outfile=infile/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

outfile/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

outfile=infile/FI:fil

ber

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

outfile=infile/HD:F
outfile=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.

HEADER FILES-11

outfile=infile/HF

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

DMP Command Summary

HEXIDECIMAL

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

27y

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

tiguous indication for the file to be displayed.

LOWERCASE

outfile=infile/LC

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 specified
tape. You can use the /RW switch at any time to reposition a tape at
beginning-of-tape (BOT).

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 (n) or backwards (-n)

on a tape.

DMP Command Summary

SPACE FILES

outfile=infile/SF:[~]n

Specifies the number of end-of-file (EOF) marks DMP spaces forward (n)
or backward (-n) on a tape.

SPOOL

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 outdevs]:[labelll/switch[es]]=indev(s]:[label][/switch]
In this command line, outdev(s] is the physical volume or volumes to which data
is copied, label identifies the volume id of the output or input device, switchles]
are the command switches described below, and indev(s] is the physical volume
or volumes from which data is copied.
DSC switches are:

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/TM02=nn=indev

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

o,
'

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

pr—
!

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 Control 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.
ADD

A string

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

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

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.
CONCATENATION CHARACTER

CC [letter]

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

RL/Z

Closes all open files and terminates the editing session.
DELETE

D[n]

D|[-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 n is 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

[E5C

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

Transfers the remaining lines in the block buffer and input file to the
output file. Closes files, renames the output 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.
MACRO CALL

MC|;n]

Retrieves a macro definition stored in the file MCALL:n.

MACRO EXECUTE

[n]Mx [a]

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.
NEXT AND PRINT

NP[n]

NP[-n]

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

OP filespec

Opens the specified secondary input file.

OUTPUT ON/OFF

OU ON

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

tain 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

RET

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
SEARCH AND CHANGE

SAVE. TMP.

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

TA ON

TA OFF

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.
TOP OF FILE

TOF

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

TY [n]

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

Line Text Editor (EDI) Commands

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 VI'52 and
VT100 terminals and nokeypad editing for all other terminals. EDT puts

the cursor ahead of the location you specify as range.
Entering a €fU2) returns you to line mode.
CLEAR

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

tion 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, !, %,

‘string ’

°, and ".

One or more nokeypad commands used to redefine the key.

DEFINE MACRO

DEF M macroname

Assigns a name to a sequence of editor commands stored in the file macroname.

DELETE

D [rangel]|/qualifier]

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
EXIT

Verifies each line to be deleted

EX [filespec]i/qualifier(s)]

Ends an editing session and moves the main text buffer to the output file
specified. You can define the name of the output file in 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 be-

tween numbers,
SA[VE]

Saves the journal file created during
the editing session.

FIND

F range
Locates the line or lines specified by range.

HELP

H [topic|subtopic]]

Displays information on requested topics or subtopics.

28
TM

DIGITAL Standard Editor (EDT) Commands

INCLUDE

INC filespec [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

| [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 (Implied TYPE)

[range|&ED

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

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.
AQualifier:
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
ENTITY {WORD | SENTENCE | PARAGRAPH | PAGE} “string’

Sets user-definable entities for character editing.

7’,,;«‘“" i

’%&

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.

[NOJNUMBERS
Determines whether EDT displays line numbers in line editing. De-

fault: NUMBERS
[NOJQUIET

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

memm%%

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 ni:NOTAB|

Sets the number of spaces for the first tab stop in keypad editing.
Remaining tabs are unchanged. Default: 8
TERMINAL {HCPY :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: TRUN-

CATE
[NOJVERIFY

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

[NOJWRAP n

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 i 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
string-1. The default for n is 10.

QIUERY]
NOT[TYPE]

EDT prompts you to verify each line of range-1 to be moved.
EDT does not display the lines on which it makes substitutions.

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

default for n is 10.
S[TAY]

EDT does not change the cursor position.

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

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/C

Ab(}rts the current command and returns EDT to keypad edit-

Mfi

CTRL/A

Computes tab level
ing

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

NONKEYPAD 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
M&a

ADVANCE

[-]ADV

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

[+ =)lcount]APPENDJ + ! -]] 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 buffer is
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.

CuT

[+ i=Hrep]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-Jirep]D]+ : ~}lentity-count]|+ | —]entity|=buffer]

Deletes a specified number of entities.
DEFINE KEY

DEFK

Defines the keystrokes used in keypad 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][
+ | -]entity[=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.
NULL

[+ =)[rep)+ | ~)[entity-count][
+ | -][entity]|=buffer]

Moves the cursor the specified number of entities.
PASTE

PASTE
[+ i=}rep]PASTE[+ | -]|entity-count]]+ : —]entity[=buffer]

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

QuIT

QUIT

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

R
[+ i=)irep]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 €RI2).
REFRESH

REF

EDT refreshes the entire screen.

SUBSTITUTE

[+ i-]lcount]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

[+ ! =])icount]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 substitutions,

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

[+1=]){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]lUNDW

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

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
the specified range.

[range]-[number]

The line that is the specified number of lines before

BEGIN

The first line in the text buffer.

END

An empty line following the last line in the text
buffer.

LAST

The last line in the most recent text buffer before the
current text buffer.

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

the specified range.

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

[rangel#number !
[range]FOR number

The specified number of lines beginning with range,
where range is any single line range 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] :

When you use a buffer without a range specification,

[BUFFER buffer][range]

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
Output volume

DOS-11
FILES-11

FLX switches are:
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

outfile/CO=infile

Specifies that the output file is to be contiguous.
DELETE

outfile/DE=infile[/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 initializing 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/ [-[RW=infile[/RW]

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

SPOOL

outfile/SP=infile

Specifies that the converted file is 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.

VERIFY

outfile/VE=infile

Verifies each record written to a cassette.

FLX Command Summary

ZERO

outfile/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.

,,«v‘*“'w

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

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

porsomy,

FMT Command Summary

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/swi[,listfile]=infilel[,infile2,...infilen]{/sw]
LBR switches are:
COMPRESS

outfile/CO:size:ept:mnt=infile

Compresses a library file by physically deleting logically deleted records,
putting the free space at the end of the file, and making the free space

available for new library module inserts.
CREATE

outfile/CR:size:ept:mnt:libtype:def.ext=infiletype

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

outfile/DE:module1|:module2...:modulen

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|:giobal2:...:globaln]

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[:modulename1:...:modulenamen]

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

LBR Command Summary
o

INSERT

iy,

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

outfile=infile/IN:name:op:op:op:op

(universal)

Inserts library modules into a library file.
LIST

outfile[,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 en-

/FU

Lists all modules in the library file and provides a full module

try points.

description

that

includes

the

size,

date

of insertion,

and

module-dependent information.

MODIFY HEADERS

outfile/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...,infilenj(universal/global format)
outfile=infile1/RP:name:op:op:op:op|,infile2...,infilen](universal/local format)

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

outfile,listfile/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|,infile2[/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.

46
. "“‘%5{

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

outfile[/switch,listfile/SP or /~-SP]=infilel/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/ [-]AU=infile

outfile=infile/ [-]JAU

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

outfile/ [-]BF=infile
outfile=infile/ [-]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=infile

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 lines in 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 SLLP would normally use

mode

as operators

PAT COMMAND SUMMARY
PAT command lines use the following format:
loutfilel=infile[/CS[:number]],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:

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

outfile

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.
If the command does not specify file name, file type, or version number, the default is *.*;*,

infile

subswitches:

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

/BL:n[.]

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

/NOCO

Specifies a contiguous or noncontiguous output file.

/FO

File ownership (output file UFD).

/NV

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
i

M%)

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

Defines the block size for magnetic tape.
CREATION DATE outfile/CD
= infile(,s)
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.)
DATE

/DA:startdate:enddate

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

outfile
= /Fl:file

ber:sequencenumber

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 available 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 [listfile = Jinfile(s)/LI[/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 subswitches determine what type of report is displayed.
/LI/BR

or /BR

Brief report.

/L1

Limited report.

/LI/FU:n

or /FU:n
‘

Full report (n specifies the decimal characters per line; the
default is device buffer size).

/LI/TB

or /TB

Total blocks report.

/L1 & /TD
or

/TD/LI

Files created on current day. The /TD switch alone does not
generate a directory listing.

MERGE outfile = infile(,s)/ME[/subswitch(es)]

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

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

Ju—

Peripheral Interchange Program (PIP) Commands
5 g

/GO, /-CO,
or

/NOCO

Specifies a contiguous or noncontiguous output file.

/FO

File ownership (output file UFD).

/NV

Forces the output version number of the copied file to be 1

/SU

Copies the output file, superseding an existing output file.

higher than the current highest version.

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

Causes certain PIP error messages not to be displayed: for example, the
message

switch are:

NO SUCH FILE(S). The switches that can be used with the NM

/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]]|/WO[:RWED]][/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:
System = /SY:RWED
Owner = /OW:RWED
Group = /GR:RWED
World = /WO:RWED

The symbolic codes are:
R
W

write

E
D

delete

read

extend

\"",,

Peripheral interchange Program (PiP) Commands

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

Class

Privilege

System

E
D

1
2

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

Octal Code

Bit

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

Deletes a specified range of versions of a file (but does not delete the latest
version). Specification of a file version number is not necessary. Wildcards
are valid for file name and file type.

Vi
*'

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.

Peripheral Interchange Program (PIP) Commands
:N«W

RENAME outfile = infile(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-

sponding field in the input file.
infile

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

/NV

See COPY.

REWIND outfile/RW = infile

outfile = infile /RW

outfile
infile

Causes the tape on the specified unit to be rewound and
erased.
'
Causes the tape on the specified unit to be rewound before

the input file is opened.
SELECTIVE DELETE infile(s)/SD

Prompts for user response before deleting files.
SHARED READING infile(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 infile(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 Manager is not recommended.

TRUNCATE

infile(s)/TR

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

Ko W%’

Peripheral Interchange Program (PIP) Commands

USER FILE DIRECTORY ENTRY outfile(s)/UF[/FO] = infile(s)
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.
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-11M. 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]]

Queue Manager
—

DCL Command Qualifiers

MCR Job Switches

/JOBCOUNT:n

/CO:n

/QUEUE:queuename

queuename:

/UPPERCASE

/NOLO

/LOWERCASE

/LO

/[NOJHOLD

/[NOJHO

/PAGE_COUNT:n

/PA:Nn

/NAME:jobname

jobname=

/PRIORITY:n

/PRIO:n

/FORMS:n

/FO:n

/LENGTH:n

/LE:n

/[NO]JRESTART

/[NO]RES

/INOJFLAG__PAGE

/[NOJFL

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

gueuename:

/NOJOBPAGE

/NOJO

DCL File Qualifiers

MCR File Switches

/[INO]DELETE

/[NO]DEL

/COPIES:n

/CO:n

SET QUEUE

Modifies attributes given to print jobs, batch jobs, or files that compose jobs in

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

DCL Qualifiers

MCR Switches

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

/CO:n

/FORMS:n

/FO:n

/LENGTH:n

/LE:N

/LOWERCASE

/LO

/PAGE_COUNT:n

/PA:n

/PRIORITY:n

/PRIO:n

/[NOJRESTART

/[NO]JRE

/UPPERCASE

/NOLO

“»”M

Queue Manager

File Format

DCL>SET QUEUE/ENTRY:nnn/FILE__POSITION:n/qualifier[/qualifier[s]]
DCL>SET

QUEUE

queuename

_
jobname/FILE

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

MCR Switches

/COPIES:n

/CO:n

/[NO]DELETE

/[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

processorname:]
/PRINT or /DEVICE

/LI:DEV

/INPUT or /CARD__READER

/LI:DEV:I

/LI:DEV:P

SHOW QUEUE

SHOW QUEUE displays information about QMG print jobs.
Format

DCL>SHOW QUEUE [queuename]/qualifier[s]
MCR>QUE [gueuename:][[uic]][jobname]/switch[s]
DCL Qualifiers

MCR Switches

/FULL

/FU

/FILES

/LI

/BRIEF

/BR

/DEVICE

/LIP

JENTRY:nnn

/EN:nnn

/FORMSI:n]

/FO[:n]

/NAME:jobname

jobname

FOWNER__UIC:uic

fuic]

/PRINT

/LIP

ey,

ZAP COMMAND AND SWITCH SUMMARY
Invoke ZAP before you enter the ZAP command line, using the following format:
ddnn:[ufd]filename,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.
ddnn:filespec/LI

LIST

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

(circumflex 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 CLI.
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.

Sets the value of a Relocation Register.

s,g

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. 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:]j=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.
ASSIGN

ASN ppn:=linn: [/keyword]

Keywords:

GBL
LOGIN
TERM=TTnn:

Defines, displays, or deletes logical device assignments as follows:
Local assign operations
ASN ppn:=linn:

ASN ppn:=linn:/TERM=TTnn:

(P)

(P)
ASN ppn:=linn:/LOGIN/TERM = TTnn:

Global assign operations
ASN ppn:=linn:/GBL

(P)

Local display operations
ASN

(P)

Global display operations
ASN /GBL

(P)

Local delete operations

ASN

=linn:

(P)

Monitor Console Routine (MCR) Commands

=/LOGIN

ASN

=/LOGIN/TERM=TTnn:

(P)

ASN

=/TERM=TTnn:

ASN

= /linn:/TERM=TTnn:

ASN

= /IInn:/LOGIN

ASN

= /linn:/LOGIN/TERM=TTnn:

(P)

(P)
(P)

Global delete operations
ASN

=/GBL

ASN

=Ilinn:/GBL

BLOCK

(P)
(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.
BOOT

BOO [filespec]

(P)

Bootstraps a system that exists as a task image file on a Files-11 volume.
BREAKPOINT TO XTD

(P)

BRK

Passes control to the Executive Debugging Tool (XDT).
BROADCAST

BRO TTnn: message
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

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.

Monitor Console Routine (MCR) Commands
TM

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:

CLI /keyword=cliname

DISABLE=cliname
ELIM=cliname or ELIM="*

ENABLE=cliname
INIT=cliname[/subkeyword(s)]

Subkeywords: CPR="string"
DISABLE
DPR="string"

LGO

MESSAGE
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

CLQJUEUE]

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.

Monitor Console Routine (MCR) Commands

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.
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.
DIGITAL COMMAND LANGUAGE

DCL

command-line

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

DMO ddnn:[["]label["]]I/keyword(s)]
DMO /USER|/keyword(s)]

Keywords:

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.
FIX IN MEMORY
Keywords:

(P)

FIX taskname [/keyword]

/REG
/RON

Loads and locks a task or a common task region into its partition.
GROUP GLOBAL EVENT FLAGS
Keywords:

FLA[GS][[gggl/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.

Monitor Console Routine (MCR) Commands

HELLO/LOGIN

HEL [uic|/password]]
HEL [username|/password]]

LOG [uic|/password]]

LOG [username|/password]]

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

HELP [/keyword] [qualifier]|qualifier 2][...qualifier 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=block-count

FPRO=[system,owner,group,world]
LRU=directory-count

MXF=file-count
NAME=new-volume-label

OVR

(P)

OWNER=[g,m]
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=block-count

FPRO=[system,owner,group,world]
INDX=index-file-position

INF=initial-index-file-size

LRU=directory-count

Mg,

Monitor Console Routine (MCR) Commands

Keywords:

MXF=file-count
OWNER=[g,m] or OWNER="owner"
PRO=[system,owner,group,world]
UIC=[g,m]
Vi

WIN=retrieval-pointer-count

Produces a Files-11 volume on disk, magnetic tape, or DECtape. On multiuser protection systems, you can initialize volumes only on devices that .
you allocated.

INSTALL

INS [$[filespec|/keyword(s)] (P)

Keywords:

AFF=[CPx,UBy]
CKP=o0ption

CLI=option

INC=size

I0P=0ption

PAR=pname

PMD=option

PRI=number

PRO=[system,owner,group,world]

RON=o0ption

ROPAR=parname
SEC=option

SLV=option

;

SYNC=option
TASK=taskname

TIME=nM
or

TIME=nS

/UIC=[g,m]

XHR=option

‘

Makes a specified task known to the system.

LOAD

LOA dd:[/keyword(s)] (P)

Keywords:

PAR=parname
/CTB=ccal,b...]

SIZE=parsize
HIGH

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

Monitor Console Routine (MCR) Commands
P

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)

DENS=density

EXT=block-count
FOR

FPRO=[system,owner,group,world]
LOCK=option

LRU=directory-count

OVR

(P)

PARM="user parameters"
PRO=option
PUB

[NO]SHARE
UIC=[g,m]

UNL
VI

[NOJWAIT
WIN =option

[NOJWRITE

Files-11 (ANSI) magnetic tape format:

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

ACP=option

(P)

BS=n
CC=option

DENS=density

FOR
FPRO=[system,owner,group,worlid]

[NOJHDR3
[NOJLABEL
LOCK= option

OVR (P)
OVRACC

(P)

Monitor Console Routine (MCR) Commands

Keywords:

OVREXP

(P)

OVRFSID (P)
PARM="user parameters"”
PRO= option

PUB

RS=n
[NOIJSHARE
TR= option

UIC=[g,m]
Vi

VOL-= (list)
[NOJWAIT

[NOJWRITE

OPEN REGISTER

(P)

OPE[N] mem-addr|+/-n][/keyword]
mem-addr /contents [ctri-char][value]term

Keywords:

AFF=[CPx,UBYy]

CPU=CPx
TASK=taskname
TASKD
TASKI
PAR=partitionname
KNL

KNLD
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 iun ddnn:

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

(P)

RED nddnn:=oddnn:

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

Monitor Console Routine (MCR) Commands

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

tion 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]] (P)
RUN taskname atime [/RSI=magu][/UIC=[g,m]] (P)
RUN [ddnn:][$] filespec [/keyword(s)]

Keywords:

CKP=option
CMD="command-line"

e
:

EST=option
INC=size

IOP=o0ption

PAR=pname

PMD=option
PRI=number

(P)

ROPAR=pname

SLV=option
TASK=taskname

—
'

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

Initiates execution of a task, either immediately or at one of several time-

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

Monitor Console Routine (MCR) Commands

SET

SET /keyword=values
Keywords:

ABAUD[=TTnn:]

BRO[=TTnn:]
BUF=ddnn:[size]

CLI=TTnn:[cli]

COLOG
CRT[=TTnn:]
DCL[=TTnn:]
EBC[=TTnn:]

ECHO[=TTnn:]

ESCSEQ[=TTnn:]
FDX[=TTnn:]
FORMFEED[=TTnn:]
HFILL=TTnn:[value]

HHT[=TTnn:]
HOLD[=TTnn:]

LIBUIC[=[uic]]
LINES=TTnn:[value]
LOGON

(P)

LOWER[=ddnn:]
MAIN=pname[:base:size:type]
MAXEXT[=size]

(P)

MAXPKT[=n]
MCR[=TTnn:]

NETUIC[=[g,m]]
NOCEX

OPT[=ddnn:opttyp:fairness-count]
OVLP[=ccn]
PAR=pname[:base:size[:type]]

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

(P)

POOL[=top]
PRIV[=TTnn:]

PUB[=ddnn:]
REMOTE[=TTnn:[speed]]
RNDC[=nn]
RNDH[=nn]

RNDL[=nn]
RPA[=TTnn:]

SECPOL

SERIAL[=TTnn:]
SLAVE[=TTnn:]
SPEED=TTnn:[recv:xmit]
SWPC[=nn]
SWPR[=nn]

Monitor Console Routine (MCR) Commands

Keywords:

SYSUIC[=[g,m]]
TERM=TTnn:[value]
TOP=pname:value

TYPEAHEAD[=TTnn[:size]]
UIC[=[g,m][:TTnn:]]

UIC[=TTnn:]
VFILL[=TTnn:]

WCHK[=ddnn:]
WRAP[=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-label]lg,m][/keyword(s)]

ALLOC=number
PRO=[system,owner,group,worid]

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.

Monitor Console Routine (MCR) Commands

UNBLOCK

UNB [taskname][/keyword]

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.

UNFIX

UNF taskname or UNF region-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[/COMMANDI]|/qualifier{s]] commandname
ABORT/TASK|/qualifier] taskname

Command
Qualifiers:

/COMMAND
/TASK
/[INOJPOSTMORTEM
/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.
APPEND

APPENDJ|/qualifiers]] infile],s] outfile

Command
Qualifiers:

/DATE:dd-mmm-yy
/SINCE:dd-mmm-yy
/THROUGH:dd-mmm-yy

/SINCE:dd-mmm-yy/THROUGH:dd-mmm-yy
/TODAY
/EXCLUDE:filespec

Default:

NONE

Appends to an existing sequential file records from one or more sequential
files. The file specification for the EXCLUDE qualifier can include wildcards. Data range qualifiers, together with the /EXCLUDE qualifier,
are also accepted on the COPY, DELETE, DIRECTORY, PURGE,
RENAME, SET PROTECTION, TYPE, and UNLOCK commands.

DIGITAL Command Language (DCL)

ASSIGN

ASSIGN[/qualifier{s]] ddnn: logical ddnn:

Command

Qualifiers:

/LOCAL
/LOGIN (P)

/GLOBAL (P)
/SYSTEM (P)
/TERMINAL:ttnn: (P)

Default:

/LOCAL

Associates a logical name with a physical device, pseudo device, or other
logical device. All references to the logical name are resolved by the system
to the associated physical device, pseudo device, or logical device.
ASSIGN/QUEUE

(P)

ASSIGN/QUEUE queuename processorname

Establishes a path between a queue and a processor in the Queue Manager
subsystem.
ASSIGN/REDIRECT

(P)

ASSIGN/REDIRECT oldddnn: newddnn:

Redirects output from one physical device to another. You can also redirect
a physical device to a pseudo device, or vice versa.

ASSIGN/TASK

(P)

ASSIGN/TASK:taskname ddnn:

lun

Reassigns an installed task’s Logical Unit Numbers (LUNs) from one phys-

ical device to another. The reassignment overrides the static LUN assign-

ments in the task’s disk image file. You cannot change the LUNs of an

active task.
BACKUP

BACKUP[qualifier[s]] source:[filespec|s]]dest:

Command Qualifiers:
Group 1:

Selective Backup and Restore

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

Use

/BEFORE:(dd-mmm-yy hh:mm)

/MODIFIED.

/CREATED

/EXCLUDE
/IMAGE:arg

SAVE
RESTORE

/MODIFIED
/NEW__VERSION
/[NO]JREPLACE

with

/CREATED

with

DIGITAL Command Language (DCL)

Command Qualifiers:
Initialization

Group 2:

/ACCESSED:n

n is default number of FCBs on

/BADBLOCKS:arg

gach volume

AUTOMATIC
MANUAL

OVERRIDE

/EXTENSION:n

Default is

/FILE_PROTECTION:code

Default is same protection as input

/HEADERS:n

volume

Specifies location of INDEXF.SYS

/INDEX:arg

BEGINNING

on volume; default is same posi-

MIDDLE

tion as involume

END

Logical block n

/[NOJINITIALIZE
/MAXIMUM__FILES:n
/WINDOWS:n

Default is same number of mapping pointers (windows) as input
volume

Group 3:

Tape and Disk Control

/APPEND

/SAVE_SET:name

Default is name of disk volume
being backed up

/DENSITY:arg
800
1600

6250

Default density = 800 bpi (if unit
supports two densities; otherwise
default is density of the particular
unit.)

/ERROR__LIMIT:n

/LABEL:TAPE:volumelabel
JLENGTH:n

Default n = 25

Default n = physical length of the
output tape

/REWIND

Rewinds first tape of tape set before executing the command line;
may use with /APPEND

DIGITAL Command Language (DCL)
e

Command Qualifiers:

Group 4.

Verification

/COMPARE
/VERIFY

Group 5:

Display

/LIST
/[NOJLOG

/LOG goes to TI:; default is
/NOLOG

Group 6:

Disk Processing

/DIRECTORY
/LABEL:arg

INPUT:volumelabel

[OUTPUT:]volumelabel

/LABEL:OUTPUT is default; if the
only volumelabel in command line

is outvolume, /LABEL ;volumelabel
will do
/MOUNTED
/[NO]JPRESERVE

Default /PRESERVE

Backs up and restores Files-11 volumes. Transfers files from a volume to a
backup volume and retrieves files from the backup volume. BACKUP

works through the Backup and Restore Utility (BRU).

BASIC

BASIC[/qualifier]

Command
Qualifiers:

/B11 (BASIC-11)
/BP2 (BASIC-PLUS-2)
/USING:userbasic

Invokes an interpreter or compiler for the BASIC language, if present. The
default is BASIC-PLUS-2.
BROADCAST

BROADCAST ttnn: message
BROADCAST @indirectspec

BROADCAST][/qualifier] message
BROADCAST username message

Command

Qualifiers:

/ALL

(P)

/LOGGED__IN (P)

Displays the specified message at one or more terminals.

DIGITAL Command Language (DCL)

CANCEL

CANCEL taskname

Eliminates entries from the clock queue. CANCEL does not affect a currently executing task, but only the pending entries in the clock queue.
COBOL-81

COBOL|/qualifier|s]] filespec

Command Qualifiers:
/[NOJANSI_FORMAT

Source in conventional

format

/[NOJCHECK:arg

Default is check

[NOIBOUNDS
[NOIPERFORM
ALL

NONE
/CODE:[NO]CIS

Use CIS in object code

/[NOJCROSS_REFERENCE

/[NO]DEBUG

Default is NODEBUG

/[NO]DIAGNOSTICS[:filespec]

Default is NODIAGNOSTICS

/[NOJLIST

Default is NOLIST

/INAMES:xx

Use 2 characters to specify
PSECT kernel

/[NOJOBJECT

Default is object

/[NOJOVERLAY__DESCRIPTION

Default is NOOVERLAY__
DESCRIPTION

/[NO]SHOW:[NO]MAP

Default is NOSHOW

/[NO]SKELETON

Default is SKELETON

/[NO]JSUBPROGRAM

Default is NOSUBPROGRAM

/TEMPORARY:device

Stores temporary work files

/USING:usercompiler

Default is COBOL-81

/[NOJWARNINGS:[NO]JINFORMATIONAL

Default is WARNINGS

Invokes COBOL-81 compiler, if present.
COBOL/C11

COBOL/C11]/qualifier[s]] filespec

Command Qualifiers:

/[NO]LIST[:filespec]
/[NO]JOBJECT(:filespec]
/[INOJANSI__FORMAT
/[NO]JCHECK

Default is NOLIST
Default is OBJECT
Source in conventional format
No bounds checking

/[NO]CM6

No COMPUTATIONAL-6

/INOJCROSS__REFERENCE

/LARGE_SYMBOL__TABLE[:n]
/INAMES:xx

Default n=1;
2-character kernel (xx) for program
section names.

DIGITAL Command Language (DCL)
ey

Command Qualifiers:
/NEST:n

Depth of nested

performs; default

n=10

/[NOJOVERLAY
/[NOJPOOL__LITERALS

/[NOJREADONLY

Default is NOREAD__ONLY

/INO]SHOW:(arg|,s])
COPY__LIST

Specifies additions to listings
Source satements from library

MAP

Special map

VERB._LOCATION
/[INO]SKELETON

Location of each program verb

/[INOJSUBPROGRAM

Create SKL file
Treat source file as subprogram

/TEMP:ddnn:

Store temporary work files

/WARNINGS

Warning and fatal diagnostics

/NOWARNINGS

Only fatal diagnostics printed

oTM

printed

Invokes the PDP-11 COBOL (COBOL/C11) compiler, if present.
CONTINUE

CONTINUE[/qualifier] [taskname]

Command
Qualifier:

.’
/TERMINAL:ttnn:

(P)

CONTINUE resumes execution of a previously suspended task. Taskname
defaults to TTnn.

CONVERT

CONVERT|/qualifier{s] infile outfile

Command

Qualifiers:

/[NOJAPPEND

/BLOCK__SIZE:n
/INOJFIXED__CONTROL

Default is 512

Default is NOFIXED__

CONTROL
/[INOJIDENTIFICATION
/INDEXED

Default is NOIDENTIFICATION
Outfile is indexed

/KEY[:n]

Default=1

/[NOJLOG__FILE[:filespec]

NOLOG__FILE is default.

/INOJMASS__INSERT
/MERGE

/PAD[:[#]arg]

Pad infile records to outfile
length. Default pad character

is blank.

DIGITAL Command Language (DCL)

Command
Qualifiers:

/RELATIVE
/[INOJREPLACE
/SEQUENTIAL

Default is NOTRUNCATE

/[INO]JTRUNCATE

Invokes the RMSCNYV utility which moves records from one file to another.

RMSCNYV reads records from an input file and writes them to an output

file. The action of RMSCNYV depends on the organization - sequential,
relative, or indexed — of the two files, and on the qualifiers you include in
the CONVERT command. See the main text and the RMS-11 documentation supplied with your system for more information.

COPY

COPY infile[s] outfile[s]

Command

n is octal unless terminated

Qualifiers: /BLOCK__SIZE:n

with decimal point

/[NOJCONTIGUOUS
/OWN

Makes outfile UIC owner
of copy

/REPLACE

/[NOJSPAN__BLOCKS

Copies files. Unless specified otherwise, COPY preserves the file organization of the input file: that is, indexed files are copied as indexed files, and
so forth. See also the CONVERT command. See APPEND command description for other qualifiers.

CORAL 66

CORAL][/qualifier[s] filespec]|,s]

Command Qualifiers:

/INOJCHECK
/CODE:arg

Default is /NOCHECK

Choose instruction set

EIS
FIS
FPP

PIC

/INOJEXTEND_SOURCE

/[NO]JLIST[:filespec]

/INOJMACHINE__CODE
INAMES:xx

/[NOJOBJECT
/[INOJOPTIMIZE[:LEVEL:n]

Extended instruction set
Floating point instruction set

Floating point processor

Position-independent

Default is EXTEND__SOURCE
Default is NOLIST

Default is NOMACHINE__CODE
Default is OBJECT
Default is OPTIMIZE

DIGITAL Command Language (DCL)
-

Command Qualifiers:

/READ__ONLY[:arg]

Alters READ__ONLY or READ/WRITE
attribute

ALL
NONE
PURE__DATA
/[NOJSHOWI[:arg[,s])]

Default is PURE__DATA

—

ALL

EXPANSIONS
NONE

OVERRIDE

—

SOURCE
STATISTICS

SYMBOLS
/[INO]JSTANDARD
/TEST[:n]

Default is NOSTANDARD
Default is TEST:0

/[NO]JTRACEBACK

Default is NOTRACEBACK

/WIDTH:n

CREATE

Default is SHOW STATISTICS

e’

Default is WIDTH:132

CREATE filespec

Creates a sequential file in a directory on a file-structured device. After you
issue the CREATE command, you can immediately enter text. If you want

an empty file, enter a CTRL/Z.

CREATE/DIRECTORY

CREATE/DIRECTORY]/qualifier] [ddnn:] [g.m]

Command

Qualifiers:

/ALLOCATION:n

Entries for n files

/PROTECTION:code

—

/LABEL:volumelabel

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

name in the volume’'s Master File Directory (MFD). Nonprivileged users
can create directories on mounted volumes only on their own private (allocated) devices.

DEALLOCATE

DEALLOCATE[/qualifier] [ddnn:]

Command

Qualifiers:

/ALL

Frees all devices
allocated by Ti

/DEVICE

/TERMINAL:ttnn:

(P)

Counteracts ALLOCATE and frees a private device for access by others.

—

DIGITAL Command Language (DCL)

DEASSIGN

DEASSIGN]/qualifier|s]] logicalddnn:

Command

Qualifiers:

/ALL

Combine with any other qualifier

/LOCAL

Default

/LOGIN
/GLOBAL

(P)

/SYSTEM

(P)

Synonym for global

/TERMINAL:ttnn: (P)

Deletes logical-device assignments. DEASSIGN disassociates logical
names from physical device names, pseudo device names, or logical device
names created by ASSIGN.
'
DEASSIGN/QUEUE (P)

DEASSIGN/QUEUE queuename processorname

Counteracts ASSIGN/QUEUE. It is used to eliminate the path from a
queue to a processor in the Queue Manager subsystem.
DEBUG

DEBUG|taskname]

Forces a task to trap to a debugger by setting the T-bit in the task’s
Processor Status Word. The task must have been built using the /DEBUG
qualifier to the LINK command, or have issued an Executive directive
specifying a debugger. Nonprivileged users can use this command only for
nonprivileged tasks running from their own terminals. Privileged users can
name any task, but the command must be issued from the terminal the
task was run from. The default taskname is TTnn.
DELETE

DELETE]|/qualifier{s]]

Command

Qualifiers:

/[NOJLOG

Lists deleted files on Tl:

/[NOJQUERY

Deletes specified versions of files and releases the storage space that the
files occupy. See APPEND command description for other qualifiers.
DEBUG
DELETE/ENTRY

DELETE/ENTRY:n|/qualifier]

Command

Qualifier:

/FILE_POSITION:n

Deletes QMG jobs by entry number.

DIGITAL Command Language (DCL)

DELETE/JOB

DELETE/JOBJ[/qualifier] queuename [[g,m]]jobname

Command

Qualifier:

/FILE_POSITION:n

Deletes QMG jobs by queue name and job name.
DELETE/PROCESSOR (P)

Qualifiers:

DELETE/qualifiers processorname

APPLICATIONS_PROCESSOR
BATCH__PROCESSOR

CARD__READER

Synonym for input

DEVICE

Synonym for printer

INPUT

Synonym for cardreader

PRINTER

Synonym for device

PROCESSOR

Deletes print processors, output despoolers, or batch processors from the
Queue Manager subsystem by processor name or device name. This com-

mand also sets the device unspooled.
DELETE/QUEUE (P)

DELETE/QUEUE queuename/ERASE

Deletes queues in the Queue Manager subsystem by name. See DELETE/JOB and DELETE/ENTRY to delete jobs from queues.
DIFFERENCES

DIFFERENCES infile1 infile2

Command

Qualifiers:

/CHANGE__BAR[:n]

n is alternative octal
ASCII code of change-

bar character.
Default is 041 ()

/IGNORE:arg
BLANK__LINES

COMMENTS

Comments begin with

FORM__FEEDS

SPACING

any group of tabs and
blanks equals one blank

TRAILING__BLANKS
/LINES:n

The n lines specified must

be the same for a match.

DIGITAL Command Language (DCL)

Command

Qualifiers:

/[NOJNUMBERS

Line numbers in output
file

/OUTPUT filespec

Names output file; Tl: is
default.

/SLP[:audittrail]

Compares two ASCII (text) files line by line to determine if parallel records
(lines) are identical, and produces a listing of the differences, if any, between the files.

DIRECTORY

Command
Qualifiers:

DIRECTORY[/format]/destination]jotherqual[s]]ifilespec|s]]
Format

/ATTRIBUTES

/FREE [ddnn:]
/FULL

/SUMMARY

RMS-11 attributes

Free blocks on volume;
default volume is SY:

Blocks used and allocated

Destination

/OUTPUT[ filespec]
/PRINTER

Names output file; Tl: is default
Qutput to printer

Other qualifiers
/DATE:dd-mmm-yy

/SINCE:dd-mmm-yy

/THROUGH:dd-mmm-yy

/SINCE:dd-mmm-yy/THROUGH:dd-mmm-yy
/TODAY
/EXCLUDE:filespec

Displays information on files in directories (UFDs). See APPEND command description for other qualifiers.

DIGITAL Command Language (DCL)

DISMOUNT

DISMOUNT ddnn: [label]

Command

Qualifiers:

/ALL

Dismount all devices mounted
by user

/PUBLIC (P)

Dismount all users

- from volume

/SAVE (P)

Disk keeps spinning

/INOJUNLOAD

Affects DB and DM
devices only.

/SYSTEM

Synonym for /PUBLIC

Marks the volume mounted on the specified device as logically off line and

disconnected from the file system.
EDIT

EDIT[/qualifier] [edit-input]

Command
Qualifier:

/EDI

Line text editor

/KED

Unbundled KED editor

/K52

VT52 version of KED

{MAKE

Unsupported TECO editor

/MUNG

Unsupported TECO editor

/OUTPUT filespec

Use with KED and K52

/CREATE

Use with KED and K52
Unsupported Son of Stopgap

/S08
/TECO

Unsupported Text Editor and

Corrector
/USING:yyy

Unsupported user editor

Invokes an editor. See also EDIT/EDT and EDIT/SLP for those editors.
EDIT/EDT

EDIT/EDT]|/qualifier|s]] filespec

Command
Qualifiers:

/[NOJCOMMANDI:filespec]

Default is COMMAND:
EDTINLEDT

/[INOJCREATE

Default is CREATE

/[NOJJOURNAL[:filespec]
/[NOJOUTPUT[:filespec]

/[NOJREAD_ONLY

/[NO]JRECOVER

Default is NOREAD__ONLY

‘

Default is NORECOVER

Invokes EDT, the DEC Standard Editor, and the default editor.

DIGITAL Command Language (DCL)

EDIT/SLP

EDIT/SLP[/qualifier|s] filespec

Command

Qualifiers:

/[NO]JAUDIT[:(arg[s]})]

Default is /AUDIT:
(POS:80:512Z:8)

POSITION:n

n<=132.

SIZE:n

n<=14.

/CHECKSUMI:n]
/[NO]JLIST[:filespec]
/INOJOUTPUT[ filespec]

/[NOJREPORT

Report truncation lines

by audit trail

/[NO]JTAB

Right-justify with tabs
or spaces. Default is NOTAB

/[NOJTRUNCATE[:n]

Deletes audit trails and

trailing characters

Invokes the Source Language Input Program (SLP), a program-maintenance editor.
FIX

(P)

FIX taskname [/qualifier(s)]

Qualifiers:

/READONLY_SEGMENT
/REGION

Causes an installed task or region to be loaded and locked into memory.
FORTRAN

FORTRAN]|/qualifier{s]] filespec]|s]

Command
Qualifiers:

/[NOJCHECK
/CODE:arg
EAE

F4P and F77
FOR; arguments are mutually
exclusive

EIS
FIS
THREADED

/CONTINUATIONS:n

F4P and F77; n=0-99
continuation lines

/[NO]DLINES

Compile D-lines

/[INOJEXTEND_SOURCE FOR; accepts 72 columns
/FOR

FORTRAN-IV

/F4P

FORTRAN-IV-PLUS

/[NOJF77

FORTRAN-77; NOF77 is

/IDENTIFICATION

Compiler and version number

/[NO]JI4

14 is 2-word variables; default is

FORTRAN-IV-PLUS

NOIi4

DIGITAL Command Language (DCL)

Command
Qualifiers:

/[NO]LINE_NUMBERS
/[NO]JLIST[:filespec]

Default is NOLIST

/MACHINE__CODE
/MAP

/[INOJOBJECT([ filespec]

Default is OBJECT

/[INOJSHAREABLE

F4P and F77. Multiuser task

/SOURCE

/[INOJSTANDARD:arg

F77; default is NOSTANDARD

ALL
NONE

SOURCE
SYNTAX
/[NO]TRACEBACK:arg
ALL

F4P and F77

Same as LINES

BLOCKS
LINES

Same as ALL

NAMES
NONE

/USING:usercompiler
/[NOJVECTORS

FOR; default is /VECTORS

/INO]JWARNINGS

FOR; default is WARNINGS

/WORK__FILES:n

F4P and F77; n is maximum

number of temporary files.

Invokes a FORTRAN compiler, if present. The default is FORTRAN-IV.
HELP

HELP[/qualifier[s]] [%] [parameteri] [...parameter9)]

Command
Qualifiers:

/OUTPUT:filespec

Default is /OUTPUT:TI:

/LOCAL

Help file is in default UFD;

/GROUP

Help file is in [g,1]; g is

/CLl:cliname

your group number

/MCR

Default for MCR terminals

/DCL

Default for DCL terminals

/FILE:filespec

Names file containing help text
Defaults to LB:[1,2]filename.HLP

/filename

Displays information about your system. Help for MCR, DCL, and most
utilities is supplied with the system. Your system may also have help for an
alternate CLI, as well as local, group, or other special help.

P Wi,

DIGITAL Command Language (DCL)

HOLD/ENTRY:n

HOLD/ENTRY

Holds a QMG job in its queue by entry number.
HOLD/JOB

HOLD/JOB queuename [[g,m]] jobname

Holds a QMG job in its queue by queue name and job name.
INITIALIZE

INITIALIZE[/qualifier[s]] ddnn: volumelabel

Command

Qualifiers:

/ACCESSED:n

Number of UFDs accessed
simultaneously

/BAD_BLOCKS:arg
AUTOMATIC
MANUAL

OVERRIDE
/DENSITY:arg
800
1600

6250

/EXTENSION:n

Extend files by n blocks;
default n=5.

/FILE_PROTECTION:(code)
/HEADERS:n

/INDEX:arg

BEGINNING

Locates index file on volume
Default for tapes & DEC tapes

MIDDLE

Default for disks

END

Logical block n

/MAXIMUM__FILES:n

/[NO]JSHOW
/OWNER:[g,m]

Default is NOSHOW
Specifies owner of volume

/PROTECTION:code
/[NOJLOG
/WINDOWS:n

Displays volume information
Default n=7.

Produces a volume in Files-11 format. See also INITIALIZE/UPDATE.
You must mount the volume /FOREIGN. Nonprivileged users must allocate the device.

DIGITAL Command Language (DCL)

INITIALIZE PROCESSOR

INITIALIZE/qualifiers
processorname/parameter qualifier

Command

Qualifiers:

PROCESSOR
CARD_READER
INPUT

Parameter
Qualifiers:

/BATCH__QUEUE:queuename
/CONSOLE:ddnn:
/PRINTER__QUEUE:queuename

INITIALIZE/QUEUE

INITIALIZE/QUEUE queuename

(P)

Command

Qualifiers:

/BATCH
/PRINTER

/QUEUE/[NO]WARNING

INITIALIZE/QUEUE creates, names, and starts a queue
in the Queue
Manager subsystem.
INITIALIZE/UPDATE

iNITIALIZE/UPDATE[/qualmer[s]] ddnn:

volumelabel

Command
Qualifiers:

/ACCESSED:n
/DENSITY:arg
800
1600

6250
/EXTENSION:n
/FILE_PROTECTION:code

Extend full files by n

blocks

/OWNER:[g,m]
/MAXIMUM__FILES:n

/PROTECTICN:code

/[NO]JSHOW

Default is SHOW

/VOLUME__LABEL:newvolumelabel

/WINDOWS:n

Mapping pointers to file
windows; default is 7.

Invokes the HOME utility to alter values in the Volume
Home Block
without affecting the other data on the volume. INITIALIZE
/UPDATE is
only for disks and DECtapes in Files-11 format. You must
mount the
volume /FOREIGN.
i

DIGITAL Command Language (DCL)

INSTALL

INSTALL|/qualifier{s]] [$]filespec (P)

Command
Qualifiers:

/[NO]JCHECKPOINT
/COMMAND:"taskcommand"
/EXTENSION:n

n (octal) additional
words of address
space

/MULTIUSER__PARTITION:parname Read-only portion
/PARTITION:parname
/[NOJPOSTMORTEM

/PRIORITY:n

0-250

/READONLY_COMMON

/[NOJSLAVE
,
/TASK_NAME:taskname

Default is NOSLAVE
1-6 characters

/UIC:[g,m]

Includes a task in the System Task Directory, thus making it known to the
system.

LIBRARY

LIBRARY|/operation]|/qualifier|s]]
LIBRARY @filespec

Creates and maintains user-written library files. The command has eight
functions, each listed here as a separate command. See main text for more
details on all functions and qualifiers.

LIBRARY/COMPRESS

LIBRARY/COMPRESS]:(arg[,s])] lib[newlib]

Arguments: GLOBAL:n
MODULES:n
BLOCKS:n

Entry point table entries
Module name table entries
Size in 256-word blocks.

Physically deletes modules that have been logically deleted through
LIBRARY/DELETE. You can rename the resulting compressed library.
You can also use this command to copy a library and rename it.
LIBRARY/CREATE

LIBRARY/CREATE[:(arg|,s])ll/qualifier{s]liblinfile[s]]

Arguments: GLOBAL:n
MODULES:n
BLOCKS:n

Entry point table entries
Module name table entries
Size in 256-word blocks

e
TM

DIGITAL Command Language (DCL)
g

Command
Qualifiers:

/[NO]JGLOBALS
/MACRO

/OBJECT

Identifies object library; default

/SELECTIVE_SEARCH

/SQUEEZE
/UNIVERSAL

Creates a library and optionally inserts one or more modules into it.
LIBRARY/DELETE

LIBRARY/DELETE libspec module[,module[,s]

Deletes object modules from a library. See LIBRARY/REMOVE for removing global symbols (entry points) from a library.
LIBRARY/EXTRACT

LIBRARY/EXTRACT][/qualifier] libspec module[,s]

Command
Qualifier:

/OUTPUT[:filespec]

Reads one or more modules from a library and writes them to a specified

output file. You can extract up to eight modules with a single command. If
you extract more than one module, the modules are concatenated in the

output file. Default output file is TI:
LIBRARY/INSERT

LIBRARY/INSERT libspec filespec|s]

Command

Qualifiers:

/[NO]JGLOBALS
/SELECTIVE__SEARCH
/SQUEEZE

Inserts modules from one or more files into a library.
LIBRARY/LIST

LIBRARY/LIST[:filespec] libspec

Command

Qualifiers:

/BRIEF
/FULL
/[NOJNAMES

Names and global entry points

Lists the names of all modules in a library on your terminal or in an output
file.
LIBRARY/REMOVE

LIBRARY/REMOVE libspec global[,globall,s]

Removes global symbols (entry points) from a library. See LIBRARY/DE-

LETE for deleting object modules from a library.

DIGITAL Command Language (DCL)

LIBRARY/REPLACE
Command

Qualifiers:

LIBRARY/REPLACE libspec filespec|s]

/[NO]GLOBALS
/SELECTIVE_SEARCH
/SQUEEZE

Replaces a module in a library with a new modules of the same name and
deletes the old module.

LINK

LINK[/qualifier{s]] filespec|/qualifier{s]}[ ,filespec[s]]
Command

Qualifiers: /ANCILLARY__PROCESSORI:n]
/BASIC

/[INOJCHECKPOINT:arg

SYSTEM

Checkpoints to [1,2]

TASK

Checkpoints to task

CORIMG.SYS
image file

/CODE:(arg[s])
DATA__SPACE
EAE
FPP

PIC

—
Same as POSITION
INDEPENDENT

Same as PIC

POSITION__INDEPENDENT
/COMPATIBLE
/[NOJCROSS__REFERENCE

/[INO]DEBUGI:filespec]
/INOJEXECUTABLE:filespec

/[NOJEXTERNAL

/ERROR__LIMIT:n

Detfault is ODT
Same as /TASK

Stops task build after n
errors

/FAST

/FULL_SEARCH
/[NOJHEADER
/10_PAGE

/LONG
/MAP/[ filespec]

Long map

/[NOJMEMORY_MANAGEMENT[:n]

Default is MEM

/OPTIONS

/OVERLAY__DESCRIPTION
/POSTMORTEM

/[NO]JPRIVILEGED

Default is NOPRIV

DIGITAL Command Language (DCL)

Command
Qualifiers:

/[NOJRECEIVE
/[NOJRESIDENT__OVERLAYS

/SAVE

Saves indirect file

/SELECTIVE_SEARCH
/INOJSEGREGATE

Default is NOSEG

/SEQUENTIAL
/SHAREABLE[:arg]

Multiuser; default
argument is TASK

COMMON
LIBRARY

TASK
/SLAVE

/SLOW
/SYMBOL__TABLE[:filespec]

/[NOJSYSTEM__LIBRARY__DISPLAY

Default is NOSYS
Same as /EXECUTABLE

/[NO]TASK[:filespec]

/TKB

Default is TKB

/TRACE

/INO]JWARNINGS

Default is WARNINGS

/WIDE

File
Qualifiers:

/[NO]JCONCATENATE
/DEFAULT _LIBRARY

Names file to replace
[1,1]1 SYSLIB.OLB

/[NO]JGLOBALS

Default is GLOBALS

/LIBRARY

/INCLUDE:(module1...,modulen)
/OVERLAY__DESCRIPTION
/SELECTIVE_SEARCH

Invokes the Task Builder, which l‘inks object modules and routines from
user and system libraries to form an executable task. See also LINK/C81.

LINK/C81

LINK/C81[/qualifier|s]] filespec],s]

LINK/COBOL[/qualifier[s]] filespec],s]

Command

Qualifiers:

/[NO]JFMS
/FMS:NORESIDENT

/OTS:[NOJRESIDENT
/[NOIMAP
/[INO]JRMS:[NO]JRESIDENT

- /[NO]DEBUG

Default is NOFMS
Same as /FMS

Default is OTS:NORESIDENT
Default is NOMAP

Default is NODEBUG

Invokes the Task Builder, which links COBOL-81 object files to produce
task image (.\TSK file).

DIGITAL Command Language (DCL)

Grants access to a multiuser protection system and establishes your privileges as a system user.

LOGOUT

LOGOUT[/qualifier]

Command

Qualifier:

/[NOJHOLD

Holds remote line after
logout; default is NOHOLD

Counteracts LOGIN. LOGOUT also aborts any nonprivileged tasks running from the terminal, and dismounts any volumes and deallocates any
private devices allocated from the terminal.
MCR

MCR mcrcommand

Enters an MCR command from a DCL terminal without leaving DCL.
MACRO

MACRO[/qualifier|s]] filespec|/qualifier{s]] ,filespec]s]]

Command

Qualifiers:

/[NOJCROSS_REFERENCE

Default is NOCROSS

/DISABLE:(parameter[,parameter(s]])
ABSOLUTE
BINARY

CARD_FORMAT
GLOBAL
LOCAL

LOWER__CASE
REGISTER_DEFINITIONS
TRUNCATION

/ENABLE:(parameter[,parameter|[s]])
ABSOLUTE
BINARY
CARD_FORMAT

GLOBAL
LOCAL

LOWER__CASE

REGISTER__DEFINITIONS
TRUNCATION

/[NO]LIST[:filespec]
Default is NOLIST
/[NO]JOBJECT[:filespec]
Default is OBJECT
/[NO]SHOW][:(parameter[,parameter(s]])]
ALL

BINARY

CALLS
COMMENTS

101

DIGITAL Command Language (DCL)

Command

Qualifiers:

CONDITIONALS
CONTENTS

COUNTER
DEFINITIONS
EXPANSIONS

EXTENSIONS
LISTING__DIRECTIVES

OBJECT_BINARY
SEQUENCE_NUMBERS

SOURCE
SYMBOLS
/[NOJWIDE

File

Qualifiers:

/LIBRARY
/PASS:n

File is macro library
Assemble on pass 1 or 2

Invokes the MACRO-11 Relocatable Assembler, which assembles one or
more MACRO-11 source files into a single relocatable object module suitable for processing by the Task Builder.

MOUNT

MOUNT][/qualifier{s]] ddnn: volumelabel
(Disks and other random-addressable devices)
MOUNT][/qualifier[s]] ddnn:[,ddnn:...] fileset-ID

(magnetic tapes)

Command Qualifiers for Both Disks and Tapes:
/DEFAULT:arg

SAVE
NOUNLOAD

UNLOAD
/FILE_PROTECTION:(code)

Protection for files created
during mount

/FOREIGN

/OVERRIDE:IDENTIFICATION (P)
/PARAMETERS:"user parameters"

/PROCESSOR:arg
acpname

UNIQUE[:acpname]
/PROTECTION:(code)
/PUBLIC

(P)

/[NO]JSHAREABLE

/[NOJLOG

/SYSTEM

/[NOJWAIT
/[NOIWRITE

102

Deallocates and sets device public

Displays volume information on TI

Default is /NOWAIT

DIGITAL Command Language (DCL)

Command Qualifiers for Disks and Other Files-11 Devices:
/ACCESSED:n

n is number of File Control Blocks

/EXTENSION:n

Extend full files by n blocks

/OWNER:[uic]

/UNLOCK
/WINDOW:arg
n

(USER:n,INDEX:n)

Command Qualifiers for ANSI and Unlabelled Tapes:
/BLOCK_SIZE:n

/CARRIAGE_CONTROL:arg
FORTRAN

LIST
NONE
/DENSITY:arg
800
1600

6250
/[NOJHDR3
/[NO]JLABEL

/OVERRIDE:arg

ACCESSIBILITY
EXPIRATION_DATE

SET_IDENTIFICATION
/RECORD__SIZE:n
/TRANSLATE:arg

EBCDIC
NONE

UT1

uT2
uT3

/NOLUME__IDENTIFICATION:(volume-ID[,volume-ID[s])

Declares a volume to be logically known to the system, on line, and available for use. Some qualifiers can be used with any MOUNT command;
some are limited to mounting disks (and other random-addressable devices) and others are limited to mounting magnetic tapes.

PRINT]/qualifier|s] filespec|/qualifier{s]],filespec|s]]

Command

Qualifiers:

/AFTER:(dd-mmm-yy hh:mm)
/COPIES:n
/INO]DELETE

103

DIGITAL Command Language (DCL)

Command
Qualifiers:

/DEVICE:ddnn:
/[NOJFLAG__PAGE

Flag page on each file;
default is NOFLAG

/FORMS:n

n can be 0 through 256; default

is 0

/[NOJHOLD

Default is NOHOLD

/JOB__COUNT

/[NOJJOB__PAGE

Flag page on job; default
is JOB.PAGE

/LENGTH:n

/[INOJLOWERCASE

/NAME:jobname

1-9 characters

/[NO]TRANSFER

/PAGE_COUNT:n
/PRIORITY:n

nis 1 through 150 nonprivileged

1 through 250 privileged
Default is 50

/QUEUE:queuename
/[INO]JRESTART
/[INOJUPPERCASE

File

Qualifiers:

/COPIES:n
/[NO]DELETE

/[NO]JTRANSFER

Queues files for printing on a line printer. PRINT can

other output devices.
PURGE

also queue jobs for

PURGE[/qualifier|s]] filespec|s]

Command
Qualifiers:

/KEEP:n
/INOJLOG

Lists files on Tl as deleted

Deletes all but the latest versions of files, and releases
the storage space
that the deleted files occupy. See APPEND command
description for other
qualifiers.
RELEASE/ENTRY

RELEASE/ENTRY:n

Releases by entry number a print or batch job
that has

queue. The variable n is the QMG entry number.

104

been held in its

DIGITAL Command Language (DCL)

RELEASE/JOB

RELEASE/JOB queuename [[g,m]]jobname

Releases by queue name and job name a print or batch job that has been
held in its queue.
REMOVE

REMOVE[/qualifier] taskname

Qualifier:

/REGION

(P)

Counteracts INSTALL. REMOVE takes a task name out of the System
Task Directory.
RENAME

RENAME]|/qualifier[s]] oldfilespec newfilespec

Changes the name, type, or version number of an existing file. See
APPEND command description for other qualifiers.
REQUEST

REQUEST message

Sends a message to the operator’s console (CO:).
RUN uninstalledtask

RUN][/qualifier|{s]] [$]filespec

Command
Qualifiers:

/[NOJCHECKPOINT
/COMMAND:"taskcommand"
/EXTENSION:n

/PARTITION:parname
/[NO]JPOSTMORTEM

/PRIORITY:n

(P)

/STATUS:arg

TASK
COMMAND
/TASK_NAME:taskname
/TIME__LIMIT:n[u]
/UIC:[g,m]

(P)

When used to run an uninstalled task from a task image file, RUN is a
combination command, encompassing INSTALL, RUN, and REMOVE,
RUN installedtask

RUN[/qualifier|s]] taskname

Command

Qualifiers:

/DELAY:nu (P)
/INTERVAL:nu (P)
/SCHEDULE:hh:mm:ss

(P)

105

DIGITAL Command Language (DCL)

Command
Qualifiers:

/STATUS:arg
COMMAND
TASK

/SYNCHRONIZE:u
/UIC:[g,m]

(P)

Initiates the execution of installed tasks. Privileged users can use RUN to

initiate the execution of installed tasks on a schedule by creating entries in
the sytem clock queue.

SET [DAYITIME

(P)

SET [DAY]TIME:[dd-mmm-yy] [hh:mm]

Sets the system date and time.
SET DEFAULT

SET DEFAULT[:ddnn:] [[g,m]]

Establishes your default device or UFD, or both. With no arguments, SET

DEFAULT returns a nonprivileged user to login device and UIC.
SET DEVICE

(P)

SET DEVICE:ddnn:/qualifier|s]

Command
Qualifiers:

/[NOJCHECKPOINT__FILE[:n]

number of deci-

mal blocks
in [0,0] CORIMG.SYS
/[INOJLOWERCASE

/[NOJPUBLIC
/WIDTH:n (Nonprivileged for TI:)

Default is NOPUBLIC

Establishes certain device attributes.
SET GROUPFLAGS

SET GROUPFLAGS:n[/qualifier]

Command
Qualifiers:

/CREATE

Default is CREATE

/DELETE

Creates and deletes group global event flags. Nonprivileged users can use

the command for their own group. The variable n is the group number.

SET LIBRARY/DIRECTORY

(P)

SET LIBRARY/DIRECTORY:[g,m]|

Establishes the directory where the system utilities and other nonprivileged system tasks are kept.

106

Iy,

DIGITAL Command Language (DCL)

SET [NOJPARTITION (P)
Command
Qualifiers:

SET [NOJPARTITION:parname/qualifier{s]

/BASE:n
/COMMON

/DEVICE

Device common

/SIZE:n

/[NOJSUBPARTITION:subparname
/SYSTEM
/TASK
/TOP

Creates or eliminates a partition.

SET PRIORITY

(P)

SET PRIORITY:n. taskname

Alters the priority of an active task.

SET PROTECTION

SET PROTECTION:code|/qualifier{s]] filespec]|s]

Establishes the protection status of files. Default is SY:RWED,
OW:RWED,GR:RWED,W:R. See APPEND command description for
other qualifiers.

SET QUEUE/ENTRY
Command
Qualifiers:

SET QUEUE/ENTRY:n[/qualifier]

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

/COPIES:n
/[NO]DELETE

/FILE__POSITION:n
/FORMS:n

/HOLD

Same as HOLD/QUEUE

/LENGTH:n
/[NOJLOWERCASE
/PAGE__COUNT:n

/PRIORITY:n

n is 1 through 150 nonprivileged;
1 through 250 privileged

/RELEASE

Same as RELEASE/QUEUE

Default is 50.

/[NO]JRESTART

/[NOJUPPERCASE

Modifies by entry number some attributes of print or batch jobs once they
are in a queue. See SET QUEUE/JOB to modify by job name.

107

DIGITAL Command Language (DCL)

SET QUEUE/JOB

SET QUEUE/JOBJ[/qualifier] queue [lg,m]jjobname

Command

Qualifiers:

/AFTER:(ddd-mmm-yy hh:mm)
/COPIES:n

/[NO]DELETE

/FILE_POSITION:n
/FORMS:n
/HOLD

Same as HOLD/QUEUE

/LENGTH:n

Ve "

/[NOJLOWERCASE
/PAGE_COUNT:n

/PRIORITY:n

nis 1 through 150 nonprivileged;

1 through 250 privileged

Default is 50.

/RELEASE

Same as RELEASE/QUEUE

/[INOJRESTART

/[NOJUPPERCASE

Modifies by job name some attributes of print or batch
jobs once they are
in a queue. See previous command to modify by entry
number.
SET SYSTEM (P)

SET SYSTEM/qualifier

£,

Command

Qualifiers:

/DIRECTORY:[g,m]

Sets UFD where system tasks
are kept

/EXTENSION LIMIT:n

Maximum size a task can be
extended

/[NOJLOGINS

/PACKETS:n
/POOL:top:max:total

nis 0 through 15
Increases pool size

Establishes certain characteristics of the system.
SET TERMINAL

SET TERMINAL]:ttnn:)/qualifier|s]

Command

Qualifiers:
Group 1:

Common Use

/[NOJAUTOBAUD
/[NO]BROADCAST

/CLl:cliname
/DCL

/[NOJHOLD__SCREEN

/INOJLOWERCASE

NOLOWER is default. Same as UPPER

DIGITAL Command Language (DCL)

Command
Qualifiers:
/MCR

/PAGE_LENGTH:n

Default is terminal hardware setting

/[NOJUPPERCASE

Same as LOWER

/[NO]PRIVILEGED (P)
/SPEED:(transmit,receive)
/WIDTH:n

Group 2:

Terminal Setup

/ASR33
/ASR35

/CRFILL:n

n is 0 through 7.

/[NOJFORM__FEED
/[NOJHARDCOPY
/KSR33
/LA12

/LA24

/LA30P
/LA30S

/LA34
/LA36
/LA38

/LA100
/LA120

/LA180S
/LFFILL

/[NOJSCOPE
/[NO]JTAB
/MODEL:arg
/INTO5

/NT50
/INT52

/NT55

/INTB1
/NT100
/NT101

/NT102
/VT105

/INT125
/NT131
/NT132

109

DIGITAL Command Language (DCL)
P

Command
Qualifiers:

Group 3: Task Setup
/[NOJECHO

/[NOJEIGHT__BIT
/[INOJESCAPE

/[NOJFULL__DUPLEX

/INOJINTERACTIVE
/INOJLOCAL

/[NOJPASSALL
/[NO]JREMOTE

/[NOJSERIAL

/[NOJTYPE_AHEAD
/[INOJWRAP

SET TERMINAL sets various attributes of your terminal.

can set attributes for any terminal.

SHOW ACCOUNTING

Privileged users

SHOW ACCOUNTING/qualifier

Command

Qualifiers:

/INFORMATION
/TRANSACTIONT[:infile] outfile

Displays current information on your terminal session
for nonprivileged
users. Privileged users can display information about any
terminal session.
SHOW ASSIGNMENTS

SHOW ASSIGNMENTS|:ttnn:}/qualifier

Command
Qualifiers:

/GLOBAL (P)
/LOCAL
/LOGIN (P)

/SYSTEM (P)

Default is LOCAL

Same as /GLOBAL

Displays at your terminal all local and login logical-devi
ce assignments.
Privileged users can display assignments from other
terminals and global
assignments.

SHOW CLOCK_QUEUE

SHOW CLOCK__QUEUE

Displays information about tasks currently in the clock
mation consists of the task names, the next time each

each task’s reschedule interval, if any.

110

queue. This infortask is to be run, and

DIGITAL Command Language (DCL)

SHOW COMMON([:name][/qualifier]

SHOW COMMON
Command
Qualifier:

/TASK

Displays the name of resident commons installed in the system, their PCB
addresses, the number of attached tasks, and the status of the common.
SHOW [DAY]TIME

SHOW [DAY|TIME

Displays the system time and date setting.
SHOW DEFAULT

SHOW DEFAULT

Displays the current default device and UFD for your terminal, along with
your terminal number.

SHOW DEVICES
Command

Qualifiers:

SHOW DEVICES[:dd][/qualifier]
/[NOJPUBLIC
/WIDTH

Displays information about the devices included in the system.
SHOW GROUPFLAGS

SHOW GROUPFLAGS

Displays the group global event flags currently in the system.
SHOW LIBRARY

SHOW LIBRARY

Displays the current library UFD. This is the UFD where nonprivileged
system utilities are kept.

SHOW MEMORY

Invokes the Resource Monitoring Display (RMDEMO), a dynamic display
of the system’s activities in memory.

SHOW PARTITIONS

SHOW PARTITIONS[:name]

Displays address and content information about the partitions in the sys-

tem. You can display information about all partitions or about a single
partition.

111

DIGITAL Command Language (DCL)

SHOW PROCESSOR

SHOW PROC‘ESSOH[processur-name{larg]]

Arguments: BATCH
CARD__READER

DEVICE

INPUT
PRINTER

Same as INPUT

Output processor; same as printer

Same as CARD__READER
Same as DEVICE

Displays information about the batch processors,
printers, card readers,
and other devices under control of the Queue
Manager.
SHOW QUEUE

SHOW QUEUE[/qualifier] [queuename]

Command
Qualifiers:

/ALL
/BATCH

All entries in all queues

/BRIEF

/DEVICE
/PRINTER
/ENTRY:n

/FILES
/FORMS:n

Same as /PRINTER; all queues
Same as /DEVICE

Files in each job; shorter than FULL

/FULL

/NAME:jobname
/OWNER__UIC:[[g,m]]

/PRINTER

Same as device

Displays information about print jobs in queues.
SHOW SYSTEM

SHOW SYSTEM[/qualifier]

Command

Qualifiers:

/CLI
/DIRECTORY

Default; displays system UFD
/EXTENSION__LIMIT
/PACKETS

/POOL

Displays information about the current system.
SHOW TASKS

SHOW TASKS]:taskname}/qualifier|s]

Command

Qualifiers:

/ACTIVE[:ttnn:]
/INSTALLED
/LOGICAL_UNITS

112

DIGITAL Command Language (DCL)

Command
Qualifiers:

/BRIEF
/FULL
/ALL

Displays information about active or installed tasks.
SHOW TASKS/DYNAMIC

Format to display task header:

SHOW TASK:taskname/DYNAMIC[/qualifier]
Command Qualifier:

/RATE:n

Format to display Active Task List:

SHOW TASKS/ACTIVE/DYNAMIC[/qualifier[s]]
Command

Qualifiers: /OWNER:ddnn:
/ALL

/PRIORITY:n

/RATE:n

Default is /ALL
Default for n is 250

Rate in seconds for display change,
Default is 1.

Invokes RMD to display on a video terminal continuing changes to either a
single task header or to all or part of the Active Task List. On a hard-copy
terminal, SHOW TASKS/DYNAMIC provides a snapshot display.
SHOW TERMINAL
Command

Qualifiers:

SHOW TERMINAL[:ttnn:}[/qualifier]

/[NOJAUTOBAUD
/[NOJASR33
/[NO]JASR35

/[NO]BROADCAST
{CLl:cliname

/[NO]JCRFILL
/DCL

/[NOJECHO
/[NOJEIGHT__BIT
/[NO]JESCAPE
/[NOJFORM__FEED
/[INOJFULL__DUPLEX
/[NOJHARDCOPY
/[INOJHOLD__SCREEN

113

DIGITAL Command Language (DCL)
s

Command

Qualifiers:

/HT

/[NOJINTERACTIVE
/[NO]KSR33

/[NO]JLA12
/[NO]JLA24
/[NO]JLA30S
/[NOJLA30P

/[NOJLA34
/[NO]LA36

/[NO]JLA38

/[NO]JLA100

/[NOJLA120
/[NOJLA180S
/[NO]JLFFILL

/[NOJLOCAL

/[NOJLOWERCASE
/MCR
/MODEL

/PAGE_LENGTH
/[NO]JPASSALL
/[NO]PRIVILEGE
/[NO]JREMOTE
/[NO]JSCOPE

/[NO]JSERIAL
/[NO]JSLAVE

/SPEED

/[NO]JTAB
/Tl:
/TT

/[INOJTYPE_AHEAD
/[NOJUPPERCASE

INT

/[NO]JVTO05
/[NOJVT50
/[NO)VT52

/[NOJVT55
/[INOIVT61

/[NO]VT100
/[NOJVT101
/[NOJVT102

/[NOJVT105

/[NOJVT125
/[NOJVT131

114

DIGITAL Command Language (DCL)

Command

Qualifiers:

/[NOJVT132
/WIDTH

/[INOJWRAP

Displays information about your terminal and other terminals on your
system.

SHOW USERS

Displays all currently logged-in terminals, including DECnet host termi
nals and virtual terminals, with the default UFD and login UIC for each.
SORT [/KEY:(abm.n[abm.n])][/qualifier[s]] infile[/qualjoutfile/FORMAT:(arg)
Command

Qualifiers:

/ALLOCATION:n

Infile or outfile

/BLOCK__SIZE:n

/BUCKET_SIZE:n
/[NOJCONTIGUOUS
/DEVICE:ddnn:

/PROCESS:type

ADDRESS__ROUTING
INDEX

RECORD
TAG
/SIZE:n

/SPECIFICATION:filespec
/WORK__FILES:n
File

Qualifiers: /FORMAT:(format,[n])
FIXED

STREAM

Required on infile

Optional on outfile; n is size
in bytes.

UNKNOWN
VARIABLE

/INDEXED:n
/RELATIVE
/SEQUENTIAL

Infile
Qutfile
Qutfile

Invokes the SORT-11 utility, if present.

START

START[/qualifier] [taskname]

Command

Qualifier:

/TERMINAL:ttnn:

(P)

Resumes execution of a task stopped by a STOP$S directive. Taskname

defaults to TTnn.

115

DIGITAL Command Language (DCL)

START PROCESSORNAME (P) START/qu

alifier processorname/qualifier

Qualifiers:

APPLICATIONS__PROCESSOR

BATCH_PROCESSOR
CARD_READER

Same as INPUT
Same as PRINTER

DEVICE
INPUT

Same as CARD__READER

PRINTER

Same as DEVICE

PROCESSOR

Parameter

Qualifiers:

/FORMS:n

Overrides initialization value
Default is CONTINUE

/CONTINUE
/RESTART
/NEXT

/TOP_OF__FILE

/BACKSPACE:n
/FORWARDSPACE:n
/PAGE:n

/ALIGN

Starts an output processor or cardread

er processor,

START/QUEUE (P)

START/QUEUE queuename

Starts a queue.
START/QUEUE/MANAGER (P)

START/QUEUE/MANAGER

w.w@*“"”‘”w"wmn

Starts the Queue Manager.

START/UNBLOCK

START/UNBLOCK[quaHfler]l‘task‘name]‘

Command

Qualifier:

/TERMINAL:ttnn:

(P)

Continues the execution of a task blocked
by the STOP/BLOCK com-

mand. Nonprivileged users can unblock
any task running from their own
terminals. Privileged users can unblock
any task.

STOP/ABORT

STOP/ABORT printer|:]

Stops the current job on a line printer

immediately. Privileged users can

stop any job. Nonprivileged users
can stop only

116

their own jobs.

DIGITAL Command Language (DCL)

STOP/BLOCK [taskname]

STOP/BLOCK
Command

Qualifier:

/TERMINAL:ttnn: (P)

or competes
Blocks an installed running task. The task no longer executes
for memory. Nonprivileged users can block tasks running from their own
terminals. Privileged users can block any task.

STOP PROCESSORNAME (P) STOP/qualifier processorname/qualifier
Qualifiers: APPLICATIONS__PROCESSOR
BATCH__PROCESSOR

CARD_READER
DEVICE

Same as INPUT
Same as PRINTER

PRINTER

Same as DEVICE

INPUT

Same as CARD__READER

PROCESSOR

Parameter

Qualifiers: /ABORT

/FILE_END
/JOB__END
/PAUSE

Stops a batch processor, card-reader processor, printer, or other output
processor.

STOP/QUEUE queuename

STOP/QUEUE (P)
Stops queues.

STOP/QUEUE/MANAGER (P)
Command
Qualifier:

STOP/QUEUE/MANAGER

/ABORT

Stops the Queue Manager after the current job. /ABORT stops the Queue
Manager immediately.

SUBMIT

SUBMIT|/qualifier|s]] filespec|s]

Command

Qualifiers: /AFTER:(dd-mmm-yy hh:mm)
Deletes batch file
/[NO]DELETE

after run; command or

filespec qualifier

117

DIGITAL Command Langua

ge (DCL)

Command
Qualifiers:

/[NOJHOLD

Default is NOHOLD:;

/HOLD has same effect
as HOLD command.

/INOJLOG__FILE
/NAME:jobname
/[NO]PHINTEH[:queuename]
/PRIORITY:n

1-9 characters; default
is first filename
Optionally name queue
for log print job
n is 1 through 150 nonprivi-

leged;

1 through 250 privileged:
default n=50.

/QUEUE:queuename

/[NOJRESTART

/[NOJTRANSFER

Queues QMG batch jobs consist
ing of one or more user batch jobs
for

processing by a batch process
or.

TYPE

TYPE filespec[s]

Prints selected files on your termina

l. See APPEND command descrip

for other qualifiers.

UNFIX

tion

UNFIX[/qualifier] taskname

Command

Qualifiers:

/REGION
/READONLY_SEGMENT

Frees a fixed task or region from
name.

UNLOCK

memory. Taskname can also be

a region

UNLOCK filespec|s]

Unlocks locked files. Locked
files are files that have been
improperly
closed. They are identified by an
L in the directory listing. See APPEN
D
command
description for other qualifie

rs.

118

ERROR LOGGING SYSTEM
The Error Logging System records information about errors and events that
occur on system hardware for immediate action or later analysis and reporting.

The system consists of four tasks:
¢ The Error Logger (ERRLOG)

¢ The Error Log Interface (ELI)
* The Report Generator (RPT)
* The Control File Language Compiler (CFL)
This section describes the ELI commands that run ERRLOG and the RPT
commands that generate error log reports.

ELI COMMANDS
The general format for an ELI command is:
[filespec]/switch1[/...switchn]
filespec

A device mnemonic or the name of an error log file, backup file, or file
to append to the current error log file.
switches

Switches to set, change, or display ERRLOG operation. You must
specify at least one switch on each ELI command line.
Using ELI Defaults:
ELI /LOG

This command starts ERRLOG, using LB:[1,6]LOG.ERR as the error log file
and LB:[1,6]BACKUP.ERR as the backup file. It also starts error limiting on the
error log devices.
Switches:
APPEND

filespec/AP

Appends a previous log file to the current error log file. Logging must be
active for this switch to work.
BACKUP

filespec/BA

Sets the name for a backup file to the next highest version of the file
‘named. This file is used if the primary error log file becomes unusable.

119

Error Logging System

HARD ERROR LIMIT

device(s)/HL:n

Sets limit (n) for hard (unrecoverable) errors on a device or devices. If
limiting is turned on and the hard error limit is reached, logging of hard
errors for that device stops.
LIMITING

/LIM

Starts the use of error limiting, using either default limits or those set with
ELI switches.
LOGGING

[filespec]/LOG

Begins error logger operation, turns on error limiting, and, if you specify a
file

name,

overrides

the

default

name

the

error

log

file

(LB:(1,6]LOG.ERR).
NOLIMITING

/NOLIM /-LIM

Stops the use of error limiting.

NOLOGGING

/INOLOG /-LOG

Stops error logger operation and turns off error limiting.

RESET

device(s)/RE

Resets the QIO and error counts on the specified devices to 0. You may
specify up to 14 devices.

SHOW

[device(s)]/SH

Displays error logging information for the specified devices or, if you do not
specify device names, for all error logging devices on the system. Also
displays information about the current operating status of the error logging
system.

SOFT ERROR LIMIT

device(s)/SL:n

Sets limits (n) for soft (recoverable) errors on a device or devices. If limiting is turned on and the soft error limit is reached, logging of soft errors for

that device stops.
SWITCH

filespec/SW

Copies the current error log file to the file specified and begins logging in
that file.

120

Error Logging System

RPT COMMANDS
The general format for an RPT command is:
[reportfile][/switch(es)]=[inputfile][/switches]
reportfile

The name of the listing file that contains the Error Log Report.
switches

Optional switches to control how RPT selects and formats information from the error log file. You can use the switches with either the
output report file specification or the input file specification.
Default:
RPT =@ED

The default command line selects the following RPT switches:
/F[ORMAT]:B[RIEF]
/TIYPEJ:A[LL]

/DA[TE]:RANGE:*:*
/P[ACKET]:*:*

/D[EVICE]:ALL
/W[IDTH]:W[IDE]

Switches:
DATE

/DA:qualifier

Qualifiers:

P[REVIOUS]:ndays
R[ANGE]:start:end
T[ODAY]
Y[ESTERDAY]

Allows you to select packets based on the time of their occurrence.
DEVICE

/DE:qualifier

Qualifiers:

(devicename(s))
A[LL]

Allows you to select packets for peripheral errors based on device or controller name.

121

Error Logging System

FORMAT

F:qualifier

Qualifiers:

B[RIEF]
FIULL]
N[ONE]

R[EGISTERS]

Allows you to specify the desired format for the packet-by-packet report.
PACKET NUMBER

/PA:bbbb.xxx(:bbbb.xxx)

Allows you to select a packet or range of packets by specifying the packet
identification number. bbbb is the block number and xxx is the record
number. A packet specified as * indicates open ended.
REPORT

/R:qualifier

Qualifiers:

D[AY]
MONTH
WEEK

SYSTEM
userstring

Invokes a predefined string of switches for RPT to use. The qualifier can be
one of the DIGITAL-defined strings or a user-defined switch string.

The DIGITAL-defined strings and their switches are:
SYSTEM
WEEK

/FO:BR/TY:A/DA:RA:*:*/PA:*:*/WL:WI/SU:(H,E)
/FO:BR/TY:A/DA:PRE:7/WL:WI/SU:(H,E)

MONTH

/FO:BR/TY:A/DA:PRE:31/WL:WI/SU:(H,E)

DAY

/FO:FULL/TY:A/DA:TODAY/WL:WI/SU:ALL

SERIAL NUMBER

Qualifiers:

/SE:qualifier

D[RIVE]:number and/or
P[ACK]:number

Selects packets based on drive or pack serial number.

122

Error Logging System

SUMMARY

/SU:summary__type

Qualifiers:

HISTORY
ERROR

GEOMETRY
ALL

NONE

Allows you to select the type of summary reports that RPT generates. You
cannot use the multiple summary syntax to specify more than one keyword
if one of the keywords is ALL or NONE. That is, /SU:(ALL) is legal but
/SU:(ALL,ERROR) is not. The default is /SU:NONE.
TYPE

[T:qualifier

Qualifiers:

AlLL]
C[ONTROL]
E[RRORS]
M[EMORY]
PE[RIPHERAL]

PR[OCESSOR]

S[YSTEM__INFO]

Selects packets based on packet type or types.
VOLUME LABEL

/V:volumelabel

Selects packets based on volume label.
WIDTH

/W:qualifier

Qualifiers:

N[ARROW]
WIIDE]

Selects the width of the report RPT creates (80 or 132 characters).
Many RPT switches accept lists of qualifiers. The format for these lists is:
/switch:(qualifier 1, qualifier 2...)

123

PROCEDURE FOR HALTING A JOB IN A PRINT
QUEUE

The following section describes the commands to stop a job on a print processor
without actually disabling the processor or queue manager. The procedure is
useful when you accidentally queue a large job that should not be printed.
STOP/ABORT (/KIL) deletes the active job on a given processor.

Privileged users can delete any job; nonprivileged users can delete their own
jobs. You do not need to know the queue name or job name, but rather the name
of the processor to delete the job.
Format

DCL>STOP/ABORT processorname
MCR>QUE processorname:/KIL
processorname

Specifies the processor whose active job you wish to delete. Note that the
MCR command format requires a colon ( : ) after the processor name.
You can stop jobs running on any processor under the control of QMG.
Examples
DCL>STOP/ABORT
Processor? LPO

This example shows how to stop a print job on line printer LPO:. The
currently active job is deleted from the queue and the next eligible job is
queued up.
Notes

Use this command to stop a processor fast, such as a line printer printing
nothing but form feeds.

As soon as the active job is deleted, QMG passes the next eligible job to the
processor. The processor has not been aborted or killed, but only the active
job on that processor.

You can also delete the active job on a card-reader processor with this
command.

125

L iy

ON-LINE DEBUGGING TOOL (ODT) COMMANDS
OPEN/DISPLAY/MODIFY TASK LOCATIONS
address mode-symbol contents new-value terminator
address (a)

Specifies the effective address of the location (word or byte) to be opened.
The address can be expressed absolutely or in relative form (see Relocata-

ble Address). An odd address forces byte mode.
mode-symbol

Specifies the mode in which the location is to be opened or displayed. If the
address is not specified, the last opened location is opened and displayed.

Symbol
/
\

Open/Display Location As:
6-digit octal word
3-digit octal byte

2 ASCII characters (word)

’

1 ASCII character (byte)

3 Radix-50 characters (word)

contents

Specifies the current contents of the opened location.
new-value [k]

Specifies the optional value to replace the current contents upon termination of the command line.
terminator

Closes the currently open location, replacing the current contents (if so
directed). The terminators are:

Return

Terminates the current sequence, displays the ODT prompt (), and
waits for the next command.
Line feed

03]

Opens the next sequential location and prints its contents.

127

On-Line Debugging Tool (ODT) Commands
A

Circumfiex (") or up-arrow (1)

Opens the preceding location in the current mode. If typed as an ODT
prompt rather than as a terminator, opens the location that precedes
the last-opened location in the same mode.
Underline (__) or back-arrow (-)
Opens the PC-relative location. The effective address equals the contents (previous or replaced) of the current location added to its address plus 2. Mode is the same, except that odd effective addresses

force byte mode.
At sign (@)

Opens the location addressed absolutely by the contents (previous or
replaced) of the current location. Mode is the same, except that odd
effective addresses force byte mode.
Right angle bracket (>)

Opens the PC-relative branch-offset location. The effective-address
calculation involves the low-order byte of the contents (previous or
replaced) of the just-closed location. Byte, as a signed value, is multiplied by 2 and added to its effective address plus 2. Mode remains the
same as when the location was opened.
Left angle bracket (<)

Reopens the location most recently opened by a /, <LF>, or ". If the
currently open location was not opened by a __, @ or >, then < closes
and reopens the current location.

COMMAND INPUT ERRORS
Individual characters in a command line cannot be corrected. In general,

typing an illegal character or command (such as 8 or 9) causes ODT to
ignore the input, print the question mark error indicator (?), and wait for a
valid command.
RELOCATABLE ADDRESS

An effective address can be entered as an explicit value relative to (plus)
the contents of a relocation register; typically the register contains the

128
i

On-Line Debugging Tool (ODT) Commands

relocatable base address for the applicable program section or object mod-

ule. ODT displays task addresses in relative form if a relocation register
contains an address-offset value equal to or less than the address to be

displayed; if the Format Register (3F) contains 0, ODT also displays the
register’s initialized state. Otherwise, ODT displays addresses in absolute
form. The relocation registers are identified as OR through 7R; a null value

M
;
"

is taken as 0 when an offset is established. The registers initially contain
-1, the nonactive state.

value;nR

Value replaces current contents of relocation register n.

n,value;nR

Value is added to (subtracted from) current contents of relo-

Establishing Relocatable Address Offsets

cation register n.

$nR/
P

Displays current contents of relocation register n. New value
is typed before terminator replaces current contents.

Inhibiting Relocatable Addressing

Sets all active relocation registers to -1, the nonactive state.

Sets relocation register n to -1, the nonactive state.

Entering or Displaying Relative Address

Effective address is address relative to (plus) the current

contents of relocation register r.
BREAKPOINTS
A breakpoint must be set in the first word of an instruction. Breakpoints

are identified as OB through 7B. (8B is reserved for use with single step

execution.) A breakpoint address can be entered in absolute or in relative
form (see Relocatable Address).
Inserting Breakpoints

r.address;nB

Inserts breakpoint n at specified address.

r.address;B

Inserts next unset breakpoint at specified address.

Removing Breakpoints
B

Removes all inserted breakpoints.

Removes only breakpoint n.

129

On-Line Debugging Tool (ODT) Commands

Moving Breakpoints
r.address;nB

Moves breakpoint n to new address, overriding previous ad-

dress.
Report of Breakpoint Occurrence
nB:r,address

Reports address at which breakpoint n suspended task exe-

cution.
Displaying Breakpoint Position

$nB/

Displays current absolute address

(or inactive state) of

breakpoint n. Entering a replacement value alters the current contents of the breakpoint register.

CONTROL OF TASK EXECUTION
Go Command
G

Initiates task at entry address.

r.address G

Initiates task at specified address (address must be even).

Execution continues to a breakpoint or to completion.
Proceed Command

Resumes task execution from current breakpoint suspen-

sion, and continues to a breakpoint or completion.
nP

Resumes task execution from current breakpoint suspen-

sion, and does not recognize this breakpoint again until its
nth occurrence.

$nC

Displays current contents of the proceed-count register associated with breakpoint n. New value typed before terminator replaces current contents.

Single-Instruction Command
S

Executes

PC-addressed

instruction,

suspends

task,

and

prints address of next instruction.
nS

Executes next n instructions, suspends task, and prints ad-

dress of next instruction.
8B:r,address

Specifies the next instruction’s address.

FILL MEMORY BLOCK -

MMW%

F COMMAND

The memory-limit registers, low ($L) and high ($H), must contain the

address boundaries of the affected memory area. Both contain 0 initially.

130
e

On-Line Debugging Tool (ODT) Commands

The following sequence establishes the address reference, which can be in
relative or absolute form:

SL (or $H)/contents new-address terminator
—

value F

Places a value in search argument register ($A), and/or en-

ters the current contents of ($A) in all memory locations
from low limit ($L) through high limit ($H) in the same

mode as the last-opened location.
P

LIST MEMORY BLOCK - L COMMAND
L

Prints memory locations within specified address limits on

console listing device (CL:).
kL
M

a;l

Uses address value a as a beginning location and initiates
listing operation.

akL

Uses address values a and k as beginning and ending ad-

n;a;kL

All listing control arguments are specified in a single listing

Uses address value k as ending location and initiates listing
operation.

dresses and initiates listing operation.

command; n is the LUN register containing the address of
the listing device.
CALCULATING OFFSETS -

O COMMAND

Calculates positive or negative (2’s complement) PC-relative and branch
offsets between even (word) addresses.
From Open Location
address/contents/addressO pc-rel>branch
Example: 16126/001402/161340 000004 > 000002

Between Two Specified Addresses
address;addressO pc-rel>branch
Example: 16126;161340 000004 >000002

GENERAL PURPOSE REGISTERS

C Constant Register
Contains user-specified 16-bit value (unsigned, absolute) for reference as
“C” in any address or new-value expressions. $C/ prints current contents.
New value typed before @D replaces contents.

131

On-Line Debugging Tool (ODT) Commands

Q Quantity Register

Always contains the last value printed for reference as “Q” in address or

new value expressions.

PROCESSOR STATUS WORD

$S/
Displays the task Processor Status Word (PSW). The new value typed
before the terminator replaces the old PSW contents.

DIRECTIVE STATUS WORD

sSwy/
Displays a task’s Directive Status Word ($DSW). The new value typed
before the terminator replaces the old contents.
MISCELLANEOUS SYMBOLS AND OPERATORS
+ Or space

Sums contiguous arguments.

Subtracts the following argument from the preceding one.

Calculates the 16-bit value (positive or 2’s complement) of

Equals address of the last explicitly opened location.
the preceding argument string, prints it as 6 octal digits,
and stores it in Q. Arguments can be signed or unsigned
octal values, relocatable address expressions, or any valid

ODT expression.
TERMINATING ODT SESSION
X

Terminates ODT and returns control to the system monitor.

For additional information, refer to the IAS/RSX-11 ODT Reference Manual.

132

TASK BUILDER (TKB) SWITCHES AND OPTIONS
The format for Task Builder commands is:
TKB>taskimagefile,memallocfile,symdeffile = inputfile(s)

For example, to task-build a program called Zebra, type:
;

>TKB
TKB>ZEBRA.TSK,ZEBRA.MAP,ZEBRA.STB = ZEBRA.OBJ....
TKB>/

ENTER OPTIONS:
27,

TKB> optionname = argument(s)

TKB>//(to end Task Builder operation)
or

TKB>/(if you have another task to build)

The Task Builder file specification is:

filespec = dev:[g,mlfilename.typ; version/switch(es)
defaults = SY: [uiclfilename.typ;n/switch

The Task Builder uses the following default file types for the files named:
Task Image File

.TSK

Memory Allocation File

.MAP

Symbol Definition File

STB

Overlay Description
Indirect Command

.ODL
.CMD

Object Module Library

.OLB

Object Module

.0OBJ

In the file specification above, n is the latest version number for an input file and
the latest version plus 1 for an output file.

133

Task Builder (TKB) Switches and Options

SWITCHES
The following key is used in the description below to designate which input and
output files can use the Task Builder switch specified:

[C]
[T}
(M)

Common or Library
Task Image
Task Builder Map

(.TSK)*
(.TSK)
(.MAP)

[S]

Symbol Definition

(.STB)

(1]

Input

(.0BJ,.OLB,.ODL,.CMD)

" Commons or libraries are specified with the /-HD switch, which produces a .TSK file
without a header.

The default value for switches is negfltive( (-sw) unless otherwise specified.
/AC:n
Specifies that the task is an Ancillary Control Processor (ACP); n specifies
the base relocation register (allowable registers are 0, 4, or 5; default register is 5). Overrides /PR if applied to the same file. [T]

/AL
Makes the task image file checkpointable and allocates checkpoint space
in the task image file. (Do not use with /CP in the same command line.) [T]

/CC
Specifies that the input file contains more than one object module. /-CC
task-builds only the first object module, The LB (library) switch overrides

/CC if it is applied to the same file. (Default is /CC.) [T)

/CM
Specifies a compatibility mode resident overlay structure. (Overlay segments are aligned on 256-word physical boundaries.) [T]

/CO
Causes the Task Builder to build a shared common. [C)

/CP
Makes the task image checkpointable and allows the task to be checkpointed to system checkpoint space. (Do not use in the same command line
with /AL.) [T}

134

Task Bullder (TKB) Switches and Options

/CR
Appends a global cross-reference listing to }he memory-allocation file. (M]

/DA
Includes a debugging aid in the task image (ODT) for a task image (output) file or a user-supplied debugging program (for an input file). [T,I]

/DL
Specifies a default library file (replacing SYSLIB.OLB) for global references that remain undefined after user-specified library files have been
searched. (Can be applied to only one input file per task.) [I]

JEA
Specifies that the task uses the extended arithmetic element. (/FP overrides /EA if applied to the same file.) [T)

/EL
Specifies the maximum possible size for the library, according to the size
specified in the PAR option.

smaller.)

(The actual size of the library may be

/FP
Specifies that the task uses the floating-point processor. (Overrides /EA if

applied to the same file.) [T]
/FU

Specifies a full search of all co-tree segments for a matching definition or
reference when processing modules from the default object module library.

[T]
/HD
Includes a header in the task image. (Default is /HD; /-HD is used with
common blocks, resident libraries, loadable drivers, and system images.)

[T,S]

/ID
This switch directs TKB to mark your task as one that uses I-space APRs
and D-space APRs in user mode. TKB separates I-PSECTs from DPSECTs.

135

Task Builder (TKB) Switches and Options

/\P

;KMMWMWA

Allows the Task Builder to inform INSTALL that the privileged task purposely overmaps the I/O page. Conversely, /-IP informs INSTALL that the

privileged task is over 12K and does not map the I/O page. [T]
/LB
Without arguments: TKB uses the input file as a library of relocatable

object modules and searches to resolve undefined global references. Includes in task image any modules found in the library that resolve the
undefined references. [I]

With arguments: [/LB:mod-1mod-2.....] TKB inserts only the modules
named in the command, regardless of references, into the task image. (1)

/LI
Causes the Task Builder to build a library shared region. Use the /-HD
switch with /LI.

/MA
Includes information from the input file in the memory allocation listing
(when applied to an input file) or controls the display of information about
the default library and shared regions (when applied to a memory allocation file). (Default is /MA for input file or /-MA for a memory allocation
file.) [M,I]

/MM[:n]
Specifies that the system on which the task is to run has memory manage-

ment hardware. (Defaults to /MM if host system has memory management, or to /-MM if it does not.) [T}
n

with /-MM to specify the highest physical address in K-words of the

task or system being built. Specify as decimal numbers 28. or 30.

/MP
Specifies that the input file describes the task’s overlay (tree) structure;
the input file is an .ODL file. (I}

/MU
The /MU switch specifies to TKB that the task is a multiuser task.

/NM
Tells the Task Builder not to print diagnostic messages. [T]

136

Task Builder (TKB) Switches and Options

/Pl

Specifies that only position-independent code or data is in the shared

region. [T,S]

/PM
roon

Produces a Postmortem Dump if the task is terminated with an SST abort.

/PR:n
Specifies that the task has privileged access. /AC overrides /PR:n if applied
to the same file; n specifies base relocation register (0, 4, or 5; default is 5).

[T}

/RO
Enables recognition of the memory-resident overlay operator (!) in the
overlay descriptor file (/MP]. (Default is /RO.) [T]

/SE
Specifies that the task can receive messages by means of the Executive
SEND directive. (Default is /SE.). [T}

/SG

Allocates task program sections alphabetically by access code (RW followed by RO). [T}

/SH

Produces a short form of the memory-allocation file without the file contents section. [M]

/SL
Specifies that the task is slaved to an initiating task. Slave task runs under
the UIC and TI: of the sending task. (Applies only to systems with multiuser protection.) [T}

/SP
Lists the memory-allocation file on the printer via the spooler. (Default is

/SP.) [M]

137

Task Builder (TKB) Switches and Options

/SQ
Builds program sections in the task image in the order in which they are

named, rather than in alphabetical order. (Cannot be used with FORTRAN I/0O handling modules or FCS modules from SYSLIB.) (T)

/SS
Extracts a global symbol definition from the input file if the global symbol
table has a matching undefined reference. (1]

/TR
Specifies that the task can be traced. [T]

Lists the memory-allocation file in 132-column (wide) format. (Default is

/WI.) (M}
/~-XH
The /XH switch informs TKB that the task is to have an external header.
/XT:n

Terminates the building of the task after n error diagnostics are detected; n
can be octal or decimal (decimal must be specified with a decimal point,
for example, 8.).

OPTIONS
TM

[H]
Option is of interest to high-level language programmers.
[M]

Option is of interest to MACRO-11 programmers.

(H,M]
Option is of interest to both high-level language and MACRO programmers,

Names used for option input can be 6 characters long, from the Radix-50 character set (A-Z, 0-9, and §).

138

Task Builder (TKB) Switches and Options

ABORT =n

Terminates the current task-build operation and restarts the Task Builder
for another. (The n satisfies the option syntax; it means nothing.) [H,M]
ABSPAT = segname:address:value1l...:value8

Patches the task image from a base address. Also patches the I-space part

of an I- and D-space task. Eight values may be specified. [M]
ACTFIL = filemax (decimal integer)

Specifies the number of files that a task can have open simultaneously (the
default is 4). [H]

ASG = devicename:unt...:un8
Assigns logical unit number(s) in decimal to specified physical device(s).

[H,M]
CLSTR = library__1 library__2,... library__n:switch:apr
Declares a cluster or group of system-owned resident libraries or commons

(from two to six) to be accessed by the task and all residing at the same
virtual address space in the task. [H, M]

Switch

Read-only or read-write access for the task (RO or RW)

APR

Which APR is to be used as the starting APR for the task

CMPRT

Declares completion routine for supervisor-mode library [H,M]
COMMON = name:access-code|:apr]
Declares that the task accesses a system-owned resident common area.
Causes the common to be mapped with D-space APRs. The common can
contain only data when linked to I- and D-space tasks. (H,M]

DSPPAT = segname:address:valuel...:value8

Patches the task image from a base address. Also patches the D-space part
of an I- and D-space task. Eight values may be specified.
EXTSCT = psectname:extension
If the program section has the concatenated attribute, this option extends
the size of the named program section by the number of octal bytes specified in the extension. If the program section has the overlay attribute, it is

extended only if the extension value exceeds the length of the section.

(H,M]

139

Task Builder (TKB) Switches and Options

EXTTSK =n

Extends the D-space portion of an I- and D-space task. Extends the task
memory

allocation

the

length n

(in

decimal

words in

the range

0<n<65,535.) when it is installed in a system-controlled partition. The
extension is rounded to the closest 32-word boundary. The default is the

extension to the total task size as specified by the PAR option length
parameter. [H,M]

FMTBUF = max-format (decimal integer)

Specifies the number of characters (in decimal bytes) in the longest format
specification to be compiled at run time. The default is 132. [M]

GBLDEF = symbol-name:symbol-value
Defines the named global symbol as having a value in the range of 0

through 177777 (octal). [M]
GBLINC = symbolname,symbolname...,symbolname

Specifies the symbols to be included as undefined references in the symbol
table file of a shared resident library. [M]
GBLPAT = segname:symname| +/-offset]:val1...:val8

Patches the task image from the location addressed by the global symbol
plus or minus the octal offset value through eight words. All values are

octal. [M]

GBLREF = symbol-name:symbol-value
Declares the named symbol as a global symbol reference originating in the

root segment of the task. [H,M]

Specifies the symbols that are to be excluded from the symbol definition
file of a resident library. (H,M]
LIBR = name:access-code|:apr]

Declares that the task accesses a system-owned resident library. Causes

the library to be mapped with both I-space and D-space APRs when linked
to an I- and D-space task. ([H,M]

MAXBUF = max-record
Specifies the maximum allowable record buffer size (in decimal bytes) in
any file processed by the task. [H]

140

Task Builder (TKB) Switches and Options

ODTV = symbol-name:vector-length

Declares the named global symbol to be the address of the ODT synchronous system trap vector (SST). The global symbol must be defined in the
main root segment. [M]
PAR = name|:base:length]

Identifies the partition for which the task is built. For a mapped system, a
size of 0 implies a system-controlled partition, and a nonzero size implies a

user-controlled partition. Base and length do not have to be expressed if
the partition resides on the host system. The default is PAR = GEN. [H,M]
PRI = priority

Sets the priority at which the task executes; can be overridden when the
task is installed. The priority is a decimal integer between 1 and 250. (H,M]
RESCOM - filespec/access-code|:apr]

Declares that the task accesses a user-owned resident common. Causes the
common to be mapped with D-space APRs. When linked to I- and D-space
tasks, the common can contain data only. [H,M]
RESLIB = filespec/access-code|:apr]

Declares that the task accesses a user-owned resident library. Causes the
library to be mapped with both I-space and D-space APRs when linked to
an I- and D-space task. [H,M]
RESSUP

Declares task’s intention to access a resident supervisor-mode library.
[H,M]

ROPAR

Declares partition in which read-only portion of multiuser task is to reside.
[H,M]

SUPLIB

Declares task’s intention to access a system-owned supervisor-mode library.
TASK =taskname

Names the task. [H,M]

Task Builder (TKB) Switches and Options

TSKV = symbol-name:vector-length

Declares a global symbol to be the address of the task synchronous system
trap vector (SST). [M]

UIC =[g,m]
Declares the UIC for time-based initiation of a task. The default is the UIC
under which the Task Builder is running. [H,M]
UNITS = max-units

Declares the number of logical units used by the task (a decimal number in
the range of 0 through 250). The default is 6. [H,M]

VSECT = psectname:base:window|:physical-length]

Specifies the virtual base address, length of virtual memory address space
(window), and length of physical memory allocated to the named program
section. [H,M]

WNDWS =n

Declares the number (0 through 7) of extra address windows required by

the task. The number specified equals the number of simultaneously
mapped regions that the task will use. [H,M]

142

"D,

RMSBCK UTILITY SUMMARY
The RMS-11 File Back-Up Utility (RMSBCK) transfers the contents of an
RMS-11 file to another file, on another device, to maintain the file should the
original file be lost or damaged.
The command line for the RMSBCK utility is:
outfile[/switch...]=infile[/switch...][,infile[/switch...]...]

Type HELP or ? for a help message. See the RMS-11 Utilities manual for more
information.
The RMSBCK switches are listed below.

Global Switches
/1D
Identifies the current version. Default: Provides no identification.
/INOJQU

Enables or disables query mode. Default: Enables query mode.

/SL|:file-spec]
Provides summary listing to terminal or in file, if specified. Default: Provides no summary.

Output File Switches
/RA

Performs read-after-write data integrity checking. Default: Does no readafter-write checking.

/RC
Performs check-after-writing data integrity checking. Default: Does no
check-after-writing.

/RW
Rewinds magnetic tape before writing. Default: Does not rewind magtape.

/SU
Supersedes existing file. Default: Does not supersede file.

143

RMSBCK Utility Summary

Input File Switches
/CD:dd—-mmm-yy][:v]
Backs up files based on creation date: specify v as A to back up all files
created after the date specified or as B to back up all files created before
the date specified. If v is not specified, all files created on the date specified
will be backed up. Default: Performs no date checking.

/RD:dd-mmm-yy|[:v]
Backs up files based on revision date: specify v as A to back up all files
revised after the date specified or as B to back up all files revised before the

date specified. If v is not specified, all files revised on the date specified
will be backed up. Default: Performs no date checking.

144

RMSCNV UTILITY SUMMARY
The RMS-11 File Conversion Utility (RMSCNV) reads records from an RMS-11

file of any organization and loads them into another RMS-11 file of any organization.

The command line for the RMSCNYV utility is:
[outfile[/switch...]=]infile[/switch...]

Type HELP or ? for a help message. See the RMS-11 Utilities manual for more
information.

The RMSCNYV switches are listed below.

Global Switches
/AP
Appends records to an existing sequential file. Default: Does not append.

/BL:[n]
Sets magnetic tape block size. Default: Uses 512 bytes.

/CA:[file-spec]
Creates an output file with the attributes of the existing input file. Default:
Output file must exist or RMSCNYV creates a sequential file.

/EO

|
Converts CTRL/Z EOF character in an ASCII stream file to null and pads
the file with nulls to the physical EOF. Default: Assumes null-filled stream
file.

/FO:x

Sets output file organization; where x is S, R, or I. Default: Uses

sequential (S) organization.

/ID
Identifies the current version. Default: Provides no identification.

/IM
Processes files in block mode. Default: Uses standard RMS-11 access
modes.

145

RMSCNYV Utility Summary

/KN:["]keyname]["]
Reads an indexed file using the key of reference specified by keyname.
Default: Reads file using primary key.
/KR:n

Reads an indexed file using the key of reference specified by n. Default:
Reads file using primary key (0).

/LO

Honors bucket fill size when filling buckets in an indexed file. Default:
Fills buckets to capacity.

/MA

Uses mass-insertion mode and sequential PUT operations. Default: No
mass insertion; uses random PUT operations.

/ML:n

Explicitly sets limit of buffer allocation. Default: RMSCNV calculates the
amount of memory available for allocation.

/PDL:[ # 1" Ix"]
Pads input records to output record length, if necessary. Default: Does not
pad records.

/SL]:file-spec]

Provides summary listing to terminal or in file, if specified. Default: Does
not provide summary.

/SU

Supersedes existing sequential file. Default: Does not supersede existing
file.

/TR

Truncates input records to output record length, if necessary. Default:
Does not truncate records.

/WF

Writes or reads fixed-control area. Default: Ignores fixed-control area.

146

RMSDES UTILITY SUMMARY
The RMS-11 File Design Utility (RMSDES) allows you to design and create
sequential, relative, and indexed files.

The command line for the RMSDES utility is:
DES filename[.typ] [kind]

See the RMS-11 Utilities manual for more information.
The following sections list the RMSDES attribute settings and commands.

ATTRIBUTE SETTINGS
Section

Attribute Keyword

Keyword

and Variable

System

TARGET" argument

Default

argument must be one of:
RSX

User’s system

RSTS

File

SOURCE!*

User’s system

FILE PLACEMENT! logical

NAME string

FILE.DAT

ORGANIZATION argument
argument must be one of:

SEQUENTIAL

RELATIVE
INDEXED

CLUSTER_SIZE number

0 blocks

ALLOCATION number

0 blocks

EXTENSION number

0 blocks

BUCKET_SIZE number

1 block

PROTECTION string

System protection

Informational attribute.

Not user settable; RMSDES automatically notes the user’s source system.

147

RMSDES Utility Summary

Section

Keyword

Attribute Keyword

and Variable
OWNER string

Default
User’s UIC

MAGTAPE_BLOCK__SIZE number 512 bytes
MAGTAPE__REWIND logical

MAX_RECORD_NUMBER number 0 records

Record

CONTIGUOUS logical

SUPERSEDE logical

SIZE number

0 bytes

FORMAT argument

argument must be one of:
VARIABLE

VARIABLE

STREAM
FIXED

VFC

Record

CONTROL__FIELD__SIZE number

2 bytes

BLOCK__SPAN logical

YES

CARRIAGE_CONTROL argument

argument must be one of:

CARRIAGE_RETURN

FORTRAN
PRINT

NONE

Key n®

NAME string

No name

TYPE argument

argument must be one of:
STRING

STRING

BIN2
BIN4

INT2
INTH4

DECIMAL
3. You must specify a number (n) for each key, key segment, and/or area that you define.

148

<WWM“’Q

RMSDES Utility Summary

Section

Attribute Keyword

Keyword

and Variable
NULL__KEY logical

Default
NO

NULL__VALUE argument
argument must be one of:

An ASCII character

" (space)

A decimal number
DUPLICATES logical

NO (primary key)

YES (alternate key)

Key n’

Area n?

SEGn__POSITION? number

Byte 0

SEGn__LENGTH?® number

0 bytes

CHANGES logical

YES (alternate key)

DATA__FILL number

100

DATA__AREA number

Area 0

INDEX__FILL number

100

LEVEL1._INDEX__AREA number

Area 0

INDEX__AREA number

Area 0

ALLOCATION number

0 blocks

EXTENSION number

0 blocks

BUCKET__SIZE number

1 block

CONTIGUOUS logical

POSITION argument
argument must be one of:

NONE

VIRTUAL number

LOGICAL number
EXACT__POSITIONING logical

3. You must specify a number (n) for each key, key segment, and/or area that you define.

149

RMSDES Utility Summary

COMMANDS
CLEAR ALL

Restores all attribute values in all sections to their default values.
CLEAR section ALL

Restores all attribute values in the specified section to their default values.
CLEAR section attribute

Restores the specified attribute value in the specified section to its default
value.
CREATE [filename].typ]]

Creates an empty data file that has the attribute values specified in the

design buffer. For indexed files in which areas are not defined, RMSDES
prompts for whether areas are to be defined by default.

If you do not specify a file name and type, the file will have those specified
in the design buffer. If you did not specify a file name and type in the
design buffer, the file will be created as FILE.DAT.
<CTRL/Z>

Terminates RMSDES without saving the design or creating an empty data
file.

<ESC>
In response to any prompt, returns the RMSDES utility prompt and preserves all attribute values in the design buffer.
EXIT filename|.typ]

Stores the file design in the description file specified in the command line
and terminates RMSDES. The default file type is .DES.
GET filename|.typ] [kind]

Reads the file design specified in a description file, and sets the appropriate attribute values in the design buffer. Reads the attribute values of a

data file, and sets the appropriate attribute values in the design buffer.
The default file type is .DES. If the file is a data file, kind (DAT) must be
specified.

150

RMSDES Utility Summary

HELP
Lists all available help topics and gives instructions for displaying the text.

HELP command
Displays help text for the specified command.
HELP COMMANDS

Lists all valid commands.
HELP SECTIONS
Lists all available help topics for all sections and gives instructions for
displaying the text.
HELP section
Displays help text for the specified section and lists all available help
topics for all attributes in the specified section.
HELP section attribute
Displays help text for the specified attribute in the specified section.
?

Displays help text for the section, attribute, or value for which you are
being prompted. Note also that you can type ? instead of HELP for any
form of the HELP command.

QUIT
Terminates RMSDES, without storing the design or creating an empty

data file.
SAVE filename|.typ]

Stores the file design in the description file specified in the command line.
The default file type is .DES.

SET ALL
Prompts for setting all attribute values in all sections. For indexed files in
which areas are not defined, prompts for whether areas are to be defined by

default.

151

RMSDES Utility Summary

SET section ALL
Prompts for setting all attribute values in the specified section.
SET section attribute value
Sets the specified attribute value in the specified section.
SHOW ALL

Displays all attribute values in all sections.

SHOW section ALL
Displays all attribute values in the specified section.

SHOW section attribute
Displays the specified attribute value in the specified section.

SHOW ID
Identifies the current level and patch version of RMSDES.

152

RMSDSP UTILITY SUMMARY
The RMS-11 File Display Utility (RMSDSP) produces a concise description of
any RMS-11 file, including back-up files.

The command line for the RMSDSP utility is:
[outfile=]infile[/switch...][,infile[/switch...]...]

Type HELP or ? for a help message. See the RMS-11 Utilities manual for more
information.

The RMSDSP switches are listed below.

Global Switches
/BP
Lists contents of back-up files. Default: Provides basic display only.

/FU
Provides detailed display for indexed files or back-up files. Default: Provides basic display only.

/1D
Identifies the current version. Default: Provides no identification.

153

WWW‘%%

RMSIFL UTILITY SUMMARY
The RMS-11 Indexed File Load Utility (RMSIFL) reads records from an

RMS-11 file of any organization and loads them into an indexed file.
The command line for the RMSIFL utility is:
outfile[/switch...]=infile[/switch...]

Type HELP or ? for a help message. See the RMS-11 Utilities manual for more
information.

The RMSIFL switches are listed below.

Global Switch
/D
Identifies the current version. Default: Provides no identification.

Output File Switches
/ER[:file-spec]
Writes primary keys of exception records to terminal if no file-spec; or
writes exception records to the specified file. Default: Writes primary keys
of exception records to terminal.

/NOER]:S]
Stops processing if input record is incompatible. Default: Writes primary
keys of exception records to terminal.

/LO
Honors bucket fill size. Default: Fills buckets to capacity.

# Ix]
/PD[:[
Pads input records to output record length. Default: Handles input records
as exception records if different lengths.

/TR
Truncates input records to output record length. Default: Handles input

records as exception records if different lengths.

155

RMSIFL Utility Summary

Input File Switches
/DE:dvn1:[dvn2:...dvn5:]
Reassigns devices for sort work files. Default: Creates and uses sort work
files on SY:.

/KR:n
Uses key of reference number. Default: Uses primary key (0).

INOSO
Does not sort records before loading. Default: Sorts records in input file

before loading.

156

RMSRST UTILITY SUMMARY
The RMS-11 File Restoration Utility (RMSRST) restores files that were backed
up using RMSBCK and produces standard RMS-11 files as output, so your
programs can access them.

The command line for the RMSRST utility is:
outfile[/switch...]=infile[/switch...][,infile[/switch...]...]

Type HELP or ? for a help message. See the RMS-11 Utilities manual for more
information.

The RMSRST switches are listed below.

Global Switches
/ID
Identifies the current version. Default: Provides no identification.

/[NOJCV
Enables or disables file version number conversion. Default: For RMSBCK

V2.0 or later,

conversion is enabled and /NOCV will disable it. For
RMSBCK tapes prior to V2.0, conversion is disabled and /CV will enable
it.

NOJQU

Enables or disables query mode. Default: Enables query mode.

/SL[:file-spec]
Provides summary listing to terminal or in file, if specified. Default: Provides no summary.

Output File Switches
/FR
Changes protection code. Default: Uses original protection.

/RA
Performs read-after-writing data integrity checking. Default: Performs no
read-after-writing checking.

157

RMSRST Utility Summary

/RC
Performs check-after-writing data integrity checking. Default: Performs no

check-after-writing checking.

/SU
Supersedes existing files. Default: Does not supersede existing files.

Input File Switches
/BD:dd-mmm-yy
Restores disk files based on back-up date.

Default:

Performs no date

checking.

/OA:[uic]
Restores files based on original account (UIC). Note that in this case, the
square brackets are required syntax. Default: Applies no account criterion.

/SE:file-spec or
/SE:(file-spec1 file-spec2[,...,file-spec10])
Restores specified files from container file. Default: Restores all files on
container file.

RMS-11 COMPLETION CODES AND FATAL ERROR
CODES
The following sections list completions that are returned in the STS and STV

fields of FABs and RABs, and fatal error completions.

For more information on these codes, see Appendix A of the RMS-11 Macro

Programmer’s Guide.

COMPLETION CODES
SU$SUC

Operation succeeded

Octal:

000001

Decimal:

SUSDUP

Inserted record has duplicate key

SUSIDX

Error updating index

ERSACC

File access error

ERSACT

Activity precludes operation

ERSAID

Bad value in AID field

ERSALN

Bad mask in ALN field

ER$ALQ

Bad value in ALQ field

ER$ANI

Bad ANSI-format magtape file

ERSAOP

Bad mask in AOP field

ER$ATR

Error reading attributes

ERSATW

Error writing attributes

ER$BKS

Bad value in BKS field

Octal:

Decimal:

Octal:
Decimal:
Octal:

Decimal:

Octal:
Decimal:
Octal:

Decimal:

Octal:
Decimal:

Octal:
Decimal:
Octal:
Decimal:

Octal:
Decimal:
Octal:

Decimal:
Octal:

Decimal:

000002

000003
3
177740

-32
177720

~48
177700

-64
177660

-80

177640
-96
177620

-112
177600
~-128

177540
-160
177520

-176
177500

-192

159

RMS-11 Completion Codes and Fatal Error Codes

ER$BKZ

Bad value in BKZ field

Octal:
Decimal:

ER$BOF

Beginning-of-file found

Octal:

Decimal:
ER$SBPA

Bad address in BPA field

ER$BPS

Bad value in BPS field

ER$CCR

RAB already in use

ER$CHG

Illegal record key change

ER$CHK

Bad bucket header

ER3CLS

File processor error

ER$COD

Bad code in COD field

ER3CRE

File processor error

ER$CUR

Undefined current-record context

ER$SDAN

Bad value in DAN field

ER$DEL

Record having RFA deleted

ER$DEV

Bad device specification

ERSDFW

File processor error

ER$DIR

Bad directory specification

ER$DME

Pool exhausted

Octal:

Decimal:
Octal:

Decimal:
Octal:
Decimal:

Octal:
Decimal:
Octal:

Decimal:
Octal:
Decimal:

Octal:
Decimal:

Octal:
Decimal:
Octal:

Decimal:
Octal:
Decimal:

Octal:
Decimal:

Octal:
Decimal:
Octal:
Decimal:

160

177460
-208
177430

-232

177420
~-240
177400

~256
177340

~288
177320

-304
177300

-320
177260

~-336
177240

-352

177220
-368
177200
-384
177140

-416
177120

-432

177100
~-448

177070

-456
177060
~-464

177040
-480

RMS-11 Completion Codes and Fatal Error Codes

ER$DNA

Bad address in DNA field

Octal:
Decimal:

ER$DNF

ER$DNR

Device not ready

ER$DPE

Device positioning error

ER$DTP

Bad code in DTP field

ER$DUP

Duplicate key not allowed

ERSENT

File processor error

ERSENV

Feature not in selected RMS-11 environment

ERSEOF

End-of-file reached

ER$ESA

Bad address in ESA field

ER$ESL

Bad value in ESL field

ER$ESS

ESS field value too small

ERSEXP

File expiration date not yet reached

ERSEXT

File processor error

ER$FAC

FAC field forbids operation

ER$FAL

Operation not supported by remote node

ER$FEX

File already exists

such directory

Octal:

Decimal:

Octal:
Decimal:
Octal:
Decimal:

Octal:
Decimal:

Octal:
Decimal:
Octal:

Decimal:
Octal:
Decimal:

Octal:

Decimal:
Octal:
Decimal:

Octal:
Decimal:

Octal;
Decimal:

Octal:
Decimal:

177030

-488
177020

~-496
177000
-512
176770

-520
176760

~-528

176740
-544

176720

-560

176700
-576

176660
~-592
176650

-600

176644
-604

176640
~-608
176630

-616
176620

-624
176560

~-656
176550

-664
176540

~-672

161

RMS-11 Completion Codes and Fatal Error Codes

ERS$FID

Bad value in FID field

Octal:

Decimal:
ERS$FLG

Bad mask in FLG field

ER$FLK

File locked by another task

ER$FNA

Bad address in FNA field

ER$FND

File processor error

ER$FNF

File not found

ER$FNM

Bad file name

ER$FOP

Bad mask in FOP field

ERS$SFUL

Device or file full

ERS$IAN

Bad value in IAN field

ER$IDX

Index not initialized

ERSIFI

Bad value in IFT field

ERSIMX

Too many XABs of same type

ERS$IOP

Illegal operation for file

ERS$IRC

Illegal record found in sequential file

ERS$ISI

Bad value in ISI field

ER$KBF

Bad address in KBF field

Octal:
Decimal:

Octal:

Decimal:
Octal:
Decimal:
Octal:
Decimal:
Octal:
Decimal:

Octal:
Decimal;

Octal:
Decimal:

Octal:

Decimal:
Octal:
Decimal:

Octal:
Decimal:
Octal:
Decimal:

Octal:
Decimal:

Octal:

Decimal:

162

177530
~-680

176520
-688

176500

~704
176470
-712
176460

~720
176440

-736
176420

-752
176400

-768
176360

~784
176340

-800
176320
-816
176300

-832
176260
-848

176220
-880
176200

-896
176160
-912

176140

-928

RMS-11 Completion Codes and Fatal Error Codes

ERSKEY

Bad key

Octal:

Decimal:
ERSKRF

Bad value in KRF field

ER$KSZ

Bad value in KSZ field

ERSLAN

Bad value in LAN field

ERSLBL

Bad magtape label

ERSLBY

Logical channel busy

ERSLCH

Bad value in LCH field

ERSLEX

Extension not needed

ER$LOC

Bad value in LOC field

ER$MEM

Memory address rollover

ERSMKD

File processor error

ER$MRN

Bad value in MRN field or bad record number

ER$MRS

Bad value in MRS field

ERSNAE

Unmappable network access error

ER$NAM

Bad address in NAM field

ERSNEF

Context not end-of-file

ERSNET

Network link lost

Octal:
Decimal:

Octal:

176120
-944
176100

-960
176060

-976
176040

-992
176020

Decimal:

-1008

Octal:

176000

Decimal:

~-1024

Octal:

175760

Decimal:

-1040

Octal:

175750

Decimal:

-1048

Octal:

175740

Decimal;

-1056

Octal:

175710

Decimal:

-1080

Octal:

175700

Decimal:

-1088

Octal:

175660

Decimal:

-1104

Octal:

175640

Decimal:

-1120

Octal:

175630

Decimal:

-1128

Octal:

175620

Decimal:

-1136

Octal:

175600

Decimal:

-1152

Octal:

175670

Decimal:

-1160

163

RMS-11 Completion Codes and Fatal Error Codes

ERSNMF

ER$SNOD

No more matching files

Bad node name

ER$NPK

No primary key for indexed file

ER$ORD

Ordering of XABs illegal

ER$ORG

Bad mask in ORG field

ER$PLG

Error reading file prologue

ER$PLV

File prologue version level unsupported

ER$POS

Bad value in POS field

Octal:

175554

Decimal:

~1172

Octal:

175550

Decimal:

~-1176

Octal:

175540

Decimal;

~1184

Octal:

175500

Decimal:

-1216

Octal:

175460

Decimal:

-1232

Octal:

175440

Decimal:

~-1248

Octal:

175430

Decimal;

-1256

Octal:

175420

Decimal:

~-1264

Octal:

175400

ER$PRM

Bad file date read

ER$PRV

Privilege violation

ER$RAC

Bad mask in RAC field

Decimal:

-1328

ERSRAT

Bad mask in RAT field

Octal:

175300

Decimal;

-1344

ER$RBF

Bad address in RBF field

Octal:

175260

ER$RER

File processor error

ERSREX

Record already exists

ER$RFA

Bad value in RFA field

ER$RFM

Bad code in RFM field

164

Decimal:

~-1280

Octal:

175360

Decimal:

-1296

Octal:

175320

‘Decimal:

~-1360

Octal:

175240

Decimal:

-1376

Octal:

175220

Decimal;

-1392

Octal:

175200

Decimal:

-1408

Octal:

175160

Decimal;

-1424

"y,

&WMMM

RMS-11 Completion Codes and Fatal Error Codes

ER$SRLK

Record locked

ER$RMV

File processor error

ER$RNF

No such record

ER$RNL

Record not locked

ER$ROP

Bad mask in ROP field

ERSRPL

File processor error

ERSRRV

Bad internal pointer

ER$RSL

Bad vaylue‘ in RSL field

ER$RSS

Bad value in RSS field

ERSRST

Bad address in RSA field

ER$RSZ

Bad value in RSZ field

ERSRTB

Record too big for user buffer

ER$RVU

Internal pointer corrupted

ER$SEQ

Sequential insertion records not in order

ER$SHR

Bad mask in SHR field

ER$SIZ

Bad value in SIZ field

ER$SUP

Operation not supported over network

Octal:

175140

Decimal:

-1440

Octal:

175120

Decimal:

~-1456

Octal:

175100

Decimal:

-1472

Octal:

175060

Decimal:

-1488

Octal:

175040

Decimal:

-1504

Octal:

175020

Decimal:

~1520

Octal:

175000

Decimal:

~-1536

Octal:

174754

Decimal:

-1556

Octal:

174750

Decimal:

-1560

Octal:

174744

Decimal:

-1564

Octal:

174740

Decimal:

-1568

Octal:

174720

Decimal:
Octal:

~-1584
174710

Decimal:

-1592

Octal:

174700

Decimal:

~1600

Octal:

174660

Decimal:

-1616

Octal:

174640

Decimal:

~-1632

Octal:

174610

Decimal:

-1656

165

RMS-~-11 Completion Codes and Fatal Error Codes

ER$SYS

System error

ER$TRE

Index error

ER$TYP

Bad file extension

ERSUBF

Bad address in UBF field

ER$UIN

Field value rejected by FAL

ER$USZ

Bad value in USZ field

ER$VER

Bad file version number

ER$WCD

Illegal wildcard in merged string

ER$WER

File processor error

ERSWLK

Device write-locked

ERSWPL

File processor error

ER$XAB

Bad address in XAB field

ER$XTR

Extraneous data in file specification

Octal:

174600

Decimal:

~1664

Octal:

174560

Decimal:

-1680

Octal:

174540

Decimal:

~1696

Octal:

174520

Decimal:

1712

Octal:

174510

Decimal:

1720

Octal:

174500

Decimal:

-1728

Octal:

174460

Decimal;

-1744

Octal:

174430

Decimal:

-1768

Octal:

174420

Decimal:

-1776

Octal:

174410

Decimal:

-1784

Octal:

174400

Decimal:

-1792

Octal:

174360

Decimal:

-1808

Octal:

174340

Decimal:

~-1824

RMS-11 Completion Codes and Fatal Error Codes

FATAL ERROR CODES
ER$SACT

Illegal concurrent operation

Octal:

Decimal:

ER$AST

Illegal operation at AST level

ER$BUG

Error in RMS-11 internal data

ER$CPB

Bad parameter block

ER$FAB

Bad FAB

ER$LIB

Resident library not available

ERSMAP

Error in internal buffer mapping data

ERSRAB

Bad RAB

Octal:

Decimal:
Octal:

Decimal:

Octal:
Decimal:

Octal:

177720
-48
177560
-144

177360
-272

177230

-360
176600
-640
175744

Decimal:

~-10562

Octal:

175720

Decimal:

-1072

Octal:

175340

Decimal:

-1312

167

ASCIl CHARACTER SET

Octal
Code Character

Octal

Code Character

Code

Character

000
001
002
003
004

040
041
042

SP
!
"

100
101
102

@
A
B

043

103

044

104

144

045

105

145

046
047

&
!

106

107

146
147

BS
HT
LF

050

(

110

150

051

)

111

151

052

112

152

053

01
012
013
014

SOH
STX
ETX
EOT
ENQ
ACK
BEL

Code Character
140
141
142
143

113

1563

054

114

154

015

016

017
020
021

Sl
DLE
DCH1
DC2

055
056
057

.
/

115
116
117

M
N
O

155
156
157

060
061
062

0
1
2

120
121
122

P
Q
R

160
161
162

063
064
065
066
067

3
4
5
6
7

123
124
125
126
127

S
U
\
W

163
164
165
166
167

070

130

170

071

131

171

072

132

172

073
074
075
076
077

:
<
=

133
134
135
136
137

[
\
]

173
174
175
176
177

022

023
024
025
026
027
030
031
032
033
034
035
036
037

DC3

DC4
NAK

SYN
ETB
CAN
EM
sSuB
ESC
FS
GS
RS
us

>
?

A
—

l~—"~ N Xg<C~0"Q0UVO3IJ~X"~"JTQ *"0Qa0T®

005
006
007
010

NUL

Octal

DEL

*Equivalent to the Radix-50 character set.

169

/O ERROR CODES
The table below lists RSX-11M I/O error codes. Only partial abbreviations (xxx)
are listed; the complete abbreviation is [E.xxx. The octal number listed is the
low-order byte of the complete word value (2’s complement of the decimal num-

ber).
Number

Octal

.DAA

Oo~NOObs
WD -

Error
Decimal

.DUN

©C

Abbreviation
.BAD

AFC
.DNR

.DNA

Meaning
Bad parameters

376

Invalid function code

375

Device not ready

374

Parity error on device

371

Device not attached

370

Device already attached

367

Device not attachable
End-of-file detected

End-of-volume detected

366

.EOV

365

WLK

-12

364

Write attempted to locked unit

.DAO

-13

363

Data overrun

SRE

-14

362

Send/receive failure

.ABO

-15

361

Request terminated

.PRI

-16

360

Privilege violation

Shareable resource in use
Illegal overlay request

]

Illegal user buffer

Hardware option not present

372

373

—h

.EOF

.SPC

[

.VER
.ONP

377

.RSU

-17

357

.OVR

-18

356

BYT

-19

355

Odd byte count (or virtual address)

.BLK

-20

354

Logical Block Number too large
Invalid UDC module number

.MOD

-21

353

.CON

-22

352

.NOD

-23

351

UDC connect error
Caller’s nodes exhausted

.DFU

-24

350

Device full

AFU

-25

347

Index file full

.NSF

-26

346

No such file

.LCK

-27

345

.HFU

-28

344

WAC

-29

343

.CKS

-30

342

Accessed for write
File header checksum failure

WAT

-31

341

Attribute control list format error

.RER

-32

340

File processor device read error

Locked from read/write access
File header full

Mg,

I/O Error Codes

Error

Number

Abbreviation

Decimal

Octal

.WER

-33

337

Meaning
File processor device write error

.ALN

-34

336

File already accessed on LUN

.SNC

-35

335

File ID, file number check

.SQC

-36

334

File ID, sequence number check

.NLN

-37

333

.CLO

-38

332

File was not properly closed

.NBF

-39

331

No buffer space available for file

.RBG

-40

330

Illegal record size

NBK

-41

327

File exceeds space allocated, no blocks

JLL

-42

326

lllegal operation on file descriptor block

No file accessed on LUN

.BTP

-43

.RAC

-44

324

lllegal record access bits set

.RAT

-45

323

Illegal record attribute bits set

.RCN

-46

322

Illegal record number-too large

Internal consistency error

325

Bad record type

ACE

-47

321

.2DV

-48

320

Rename-two different devices

.FEX

-49

317

Rename-a new file name already in use

.BDR

-50

316

Bad directory file

.RNM

-51

315

Cannot rename old file system

.BDI

-52

314

Bad directory syntax

.FOP

-53

313

File already open

- .BNM

-54

312

Bad file name

.BDV

-55

311

Bad device name

.BBE

-56

310

Bad block on device

.DUP

-57

Enter-duplicate entry in directory
Not enough stack space (FCS or FCP)

STK

-58

307
306

.FHE

-59

305

Fatal hardware error on device

.NFI|

-60

304

File ID was not specified

18Q

172

-61

303

Illegal sequential operation

.EOT.

-62

302

End-of-tape detected

.BVR

-63

301

Bad version number

.BHD

-64

300

Bad file header

.OFL

-65

277

Device off line

.BCC

-66

276

Block check, CRC, or framing error

ONL

-67

275

Device on line

.NNN

-68

274

No such node

.NFW

-69

273

Path lost to partner

.DIS

-69

273

Path lost to partner

.BLB

-70

272

Bad logical buffer

TMM

-71

271

Too many outstanding messages

.NDR

-72

270

No dynamic space available

O Error Codes

Error

Number

Decimal

Octal

URJ

-73

267

Connection rejected by user

.NRJ

-74

266

Connection rejected by network

EXP

-75

265

File expiration date not reached

BTF

-76

264

Bad tape format

.NNC

-77

263

Not ANSI “D” format byte count

.NDA

-78

262

NLK

-79

261

No data available
Task not linked to specified ICS/ICR in-

Abbreviation

Meaning

terrupts

Specified task not installed
No AST specified in connect

NST

-80

260

AST

-80

260

FLN

-81

257

Device off line when off-line request was
issued

AES

-82

256

Invalid escape sequence

.PES

-83

255

Partial escape sequence

ALC

-84

254

Allocation failure

ULK

-85

253

Unlock error

WCK

-86

252

Write check failure

NTR

-87

251

Task not triggered

.REJ

-88

250

Transfer rejected by receiving CPU

FLG

-89

247

Event flag already specified

.DSQ

-90

246

Disk quota exceeded

-91

245

.RES

-92

244

Circuit reset during operation

TML

-93

243

Too many links to task

Inconsistent qualifier usage

NNT

.94

242

Not a network task

.TMO

-95

241

Timeout on request

.CNR

-96

240

Connection rejected

UKN

-97

237

Unknown name

SZE

-98

236

Unable to size device

Mil

-99

235

Media inserted incorrectly

.SPI

-100

234

Spindown ignored

For additional information, refer to the IAS/RSX-11 I/O Operations Reference
Manual.

173

DIRECTIVE ERROR CODES
Directives in the Directive Status Word ($DSW) return the following error
codes. The complete abbreviation for these codes is IE.xxx. Only partial abbreviations (xxx) are included in this list. The octal error number listed is the loworder byte of the complete word value (2’s complement of the decimal).

Abbreviation

Error

Number

Decimal

Octal

Meaning

UPN

377

Insufficient dynamic storage

INS

376

PTS

375

Specified task not installed
Partition too small for task

.UNS

374

Insufficient
send

.ULN

373

Unassigned LUN

dynamic

storage

.HWR

372

Device driver not resident

ACT

371

Task not active

370

Directive

inconsistent

with

for

task

state

FIX

367

.CKP

366

365

.TCH
-12

Task already fixed/unfixed
Issuing task not checkpointable
Task is checkpointable
(reserved)

.RBS

-15

361

(reserved)
Receive buffer too small

-14

.PRI

-16

360

Privilege violation

.RSU

-17

357

Resource in use

.NSW

-18

356

No swap space available

-19

355

Illegal vector specified

ATN

-20

354

Invalid table number

.LNF

-21

353

Logical name not found

260

Directive

(reserved)

-79

AST

-80

issued/not

issued

from

AST
.MAP

-81

257

Illegal mapping specified

-82

256

-83

255

251

(reserved)
Window has I/O in progress
Alignment error
Address window allocation overflow
Invalid region ID
Invalid address window ID

250

Invalid TI parameter

10OP
ALG

-84

254

WOV

-85

253

NVR

-86

NVW

-87
-88

ATP

252

175

Directive Error Codes

Abbreviation

Error

Number

Decimal

Octal

Meaning

.IBS

-89

247

.LNL

Invalid send
than 255)

-90

246

AUI

LUN locked in use

-91

245

.IDU

Invalid UIC

-92

244

Invalid device or unit
Invalid time parameters
Partition/region not in system
Invalid priority (greater than 250)

ATI

-93

243

.PNS

-94

242

-95

241

buffer

size

(greater
'J,}wfi“

ALU

-96

240

AEF

Invalid LUN

-97

237

.ADP

-98

Invalid event flag (greater than 64)

236

.SDP

-99

235

Part of DPB out of user’s space
DIC or DPB size invalid

For additional information,
Reference Manual.

refer

the

RSX-11M/M-PLUS

M&;},‘}%

Executive

176

EXECUTIVE DIRECTIVE SUMMARY IN
ALPHABETICAL ORDER BY MACRO CALL
Abort Task

ABRTS

FORTRAN Call:
CALL ABORT (tsk(,ids])

tsk

Name of task to be aborted (Radix-50)

ids

Directive status

Macro Call:
ABRTS

tsk

Name of task to be aborted (Radix-50)

Alter Priority

ALTPS

FORTRAN Call:

CALL ALTPRI ([tsk],liprill,ids])
tsk

Active task name

ipri

A l-word integer value equal to the new priority, from 1 to 250

ids

(decimal)
Directive status

Macro Call:
ALTP$

[tskil,pri]

tsk

Active task name

pri

New priority, from 1 to 250 (decimal)

Assign LUN

ALUNS

FORTRAN Call:
CALL ASNLUN (lun,dev,unt(,ids])
lun

Logical unit number

dev

Device name (format: 1A2)

unt

Device unit number

ids

Directive status

177

Executive Directive Summary in Alphabetical Order by Macro Call

Macro Call:
ALUNS$

lun,dev,unt

lun

Logical unit number

dev

Device name (two characters)

unt

Device unit number

AST Service Exit ($S form recommended)

ASTX$S

FORTRAN Call:

Neither the FORTRAN language nor the ISA standard permits direct linking
to system-trapping mechanisms; therefore, this directive is not available to

FORTRAN tasks.

Macro Call:
ASTXS$S
err

[err]

Error routine address

Attach Region

ATRGS

FORTRAN Call:

CALL ATRG (irdbl,ids])
irdb

An 8-word integer array containing a Region Definition Block

ids

Directive status

(see Section 3.5.1.2)

Macro Call:
ATRGS$

rdb

Region Definition Block address

Connect To Interrupt Vector

CINTS

FORTRAN Call:

Not supported
Macro Call:

CINT$
vec

vec,base,isr,edir,pri,ast
=

Interrupt vector address — Must be in the range 60(8) to highest vector specified during SYSGEN, inclusive, and must be a

multiple of 4

178

Executive Directive Summary in Alphabetical Order by Macro Call

base

Virtual base address for kernel APR 5 mapping of the ISR, and

isr

edir

Virtual address of the enable/disable interrupt routine

pri

Initial priority at which the ISR is to execute

ast

Virtual address of an AST routine to be entered after the forklevel routine queues an AST

enable/disable interrupt routines

Virtual address of the ISR, or 0 to disconnect from the interrupt vector

Clear Event Flag

CLEF$

FORTRAN Call:
CALL CLREF (efn[,ids])

efn

Event flag number

ids

Directive status

Macro Call:
CLEF$

efn

[Event flag number

Cancel Mark Time Requests

CMKTS

FORTRAN Call:

CALL CANMT (lefn][,ids])
efn

Event flag number

ids

Directive status

Macro Call:

CMKTS$

[efn,ast,err]

efn

Event flag number

ast

Mark time AST address

err

Error routine address

Connect

CNCTS$

FORTRAN Call:

CALL CNCT (rtname,liefn],[iast],[iesb],[iparm](,ids])

rtname

Name (Radix-50) of the offspring task to be connected

179

Executive Directive Summary in Alphabetical Order by Macro Call

iefn

Event flag to be set when the offspring task exits or emits
status

1ast

Name of an AST routine to be called when the offspring task
exits or emits status

iesh

”

Name of an 8-word status block to be written when the
offspring task exits or emits status

Word

0 — Offspring task exit status

Word 1-7 — Reserved
iparm

Name of a word to receive the status block address when an

AST occurs
ids

Integer to receive the Directive Status Word

Macro Call:

CNCT$

tname, [efn],[east],[esb]

tname

Name (Radix-50) of the offspring task to be connected

efn

The event flag to be cleared on issuance and set when the

east

Address of an AST routine to be called when the offspring

esb

Address of an 8-word status block to be written when the

offspring task exits or emits status

task exits or emits status

offspring task exits or emits status

Word

0 — Offspring task exit status

Word 1-7 — Reserved
Checkpoint Common Region

CPCRS$

FORTRAN Call:

CALL CPCR (namel,ids])
name

Name (Radix-50) of the common region to be checkpointed

ids

Directive status

Macro Call:
CPCR$ name
name

180

Name of the common region to be checkpointed

Executive Directive Summary in Alphabetical Order by Macro Call

Create Address Window

CRAWS

FORTRAN Call:

CALL CRAW (iwdbl,ids])
iwdb

An 8-word integer array containing a Window Definition Block

ids

Directive status

(see Section 3.5.2.2)

Macro Call:

CRAWS$

wdb

Window Definition Block address

Create Group Global Event Flags

CRGF$

FORTRAN Call:
CALL CRGF ((group]l,ids])
group

Group number for the flags to be created — If not specified,

the task’s protection UIC (H.CUIC+1) in the task’s header is
used
ids

Integer to receive the Directive Status Word

Macro Call:
CRGF$

[group]

group

Group number for the flags to be created — If not specified,
the task’s protection UIC (H.CUIC+1) in the task’s header is

used
Create Region

CRRGS$

FORTRAN Call:

CALL CRRG (irdbl,ids])
irdb

An 8-word integer array containing a Region Definition Block

ids

Directive status

(see Section 3.5.1.2)

Macro Call:

CRRG$

rdb

Region Definition Block address

181

Executive Directive Summary in Alphabetical Order by Macro Call
L

Create Virtual Terminal

CRVTS

FORTRAN Call:

CALL CRVT (liiast],lioast],[iaast],[imlen],iparm{,ids])
ilast

ioast

AST address at which input requests from offspring tasks are
serviced

AST address at which output requests from offspring tasks
are serviced

laast

AST address at which the parent task may be notified of the
completion of successful offspring attach and detach requests
to the virtual terminal unit

imlen

iparm

Maximum buffer length allowed for offspring I/0 requests

Address of 3-word buffer to receive information from the
stack when an AST occurs

ids

Integer to receive the Directive Status Word

Macro Call:
CRVTS liast], [oast],[aast],[mlen]
iast

AST address at which input requests from offspring tasks are
serviced

oast

AST address at which output requests from offspring tasks are

serviced
aast

AST address at which the parent task may be notified of the
completion of successful offspring attach and detach requests
to the virtual terminal unit (If this parameter is not specified,
no notification of attaches and detaches are returned to the
parent task.)

mlen

Maximum buffer length allowed for offspring I/0 requests

Cancel Time-Based Initiation Requests

CSRQ$

FORTRAN Call:
CALL CANALL (tskl(,ids])
tsk

Task name

ids

Directive status

Macro Call:
CSRQ$
tsk

182

tsk
=

Task name

r flmmm%

Executive Directive Summary in Alphabetical Order by Macro Call

Declare Significant Event ($S form recommended)

DECLS$S

FORTRAN Call:
CALL DECLAR (l,ids])
ids

Directive status

Macro Call:
DECLS$S

err

[err]

Error routine address

Disable AST Recognition ($S form recommended)

DSARS$S

FORTRAN Call:
CALL DSASTR [(ids)]
ids

Directive status

Macro Call:
DSARS$S

err

[err]

Error routine address

Disable Checkpointing ($S form recommended)

DSCP$S

FORTRAN Call:
CALL DISCKP ((ids)]
ids

Directive status

Macro Call:
DSCP$S

err

[err]

Error routine address
DTRGS

Detach Region

FORTRAN Call:
CALL DTRG (irdbl,ids])

irdb

An 8-word integer array containing a Region Definition Block

ids

Directive status

(see Section 3.5.1.2)

Macro Call:

DTRG$

rdb

Region Definition Block address

183

Executive Directive Summary in Alphabetical Order by Macro Call

Eliminate Address Window

ELAWS
0

FORTRAN Call:

CALL ELAW (iwdbl,ids])

iwdbi

An 8-word integer array containing a Window Definition
Block (see Section 3.5.2.2)

ids

Directive status

Macro Call:

ELAWS

wdb

Window Definition Block address

Eliminate Group Global Event Flags

ELGF$

FORTRAN Call:

CALL ELGF ([groupll,ids])
group

Group number of flags to be eliminated

ids

Integer to receive the Directive Status Word

Macro Call:
ELGF$
group

(group]
=

Group number of flags to be eliminated
B My,

Eliminate Virtual Terminal

ELVTS

FORTRAN Call:

CALL ELVT (iunuml,ids])
iunum

Virtual terminal unit number

ids

Integer to receive the Directive Status Word

Macro Call:

ELVT$ unum
unum

Unit number of the virtual terminal to be eliminated

Emit Status

EMSTS

FORTRAN Call:

CALL EMST ([rtname],istat/(,ids])
rtname

Name of task connected to issuing task to which the status

is to be emitted

184
I,

Executive Directive Summary in Alphabetical Order by Macro Call

istat

A 16-bit quantity to be returned to the connected task

ids

Integer to receive the Directive Status Word

Macro Call:
EMSTS$

[tname],status

tname

Name of a task connected to the issuing task to which the
status is to be emitted

status

A 16-bit quantity to be returned to the connected task

Enable AST Recognition ($S form recommended)

ENARSS

FORTRAN Call:
CALL ENASTR [(ids)]
ids

Directive status

Macro Call:
ENARS$S
err

[err]

Error routine address

Enable Checkpointing ($S form recommended)

ENCPS$S

FORTRAN Call:
CALL ENACKP [(ids)]
ids

Directive status

Macro Call:
ENCP$S

err

[err]

Krror routine address

Exit If

EXIF$

FORTRAN Call:
CALL EXITIF (efnl,ids])

efn

Event flag number

ids

Directive status

Macro Call:
EXIF$

efn

Event flag number

185

Executive Directive Summary in Alphabetical Order by Macro Call
iy,

Task Exit ($S form recommended)

EXITSS

FORTRAN Call:

Fortran tasks that terminate with the STOP statement result in a message

that includes task name, a statement causing the task to stop, and an optional character string specified in the STOP statement. CALL EXIT terminates with the message STOP THIS FORTRAN TASK.

Macro Call:
EXIT$S
err

[err]
=

KError routine address

Exit With Status

EXSTS

FORTRAN Call:
CALL EXST (istat)

istat

A 16-bit quantity to be returned to parent task

Macro Call:
EXST$

status

A 16-bit quantity to be returned to parent task

Extend Task

EXTKS

FORTRAN Call:
CALL EXTTSK ([inc][,ids])
inc

A positive or negative number equal to the number of 32-word

blocks by which the task size is to be extended or reduced (If
omitted, task size defaults to installed task size.)

ids

Directive status

Macro Call:
EXTKS$
inc

[inc]
=

A positive or negative number equal to the number of 32-word

blocks by which the task is to be extended or reduced (If omit-

ted, task size defaults to installed task size.)

Get Command for Command Interpreter

Fortran Call:
CALL GTCMCI (icbf,icbfl, [iibuf],[iibfl],
liaddr], lincp](,ids])
icbf

186

Name of a byte to receive the command

GCCI$

Executive Directive Summary in Alphabetical Order by Macro Call

ichfl

Integer containing the size of the icbf array in bytes

itbuf

Name of an integer containing the length of the optional information buffer

iibfl

Name of an integer containing the length of the optional information buffer

iaddr

Name of an integer that contains the address in pool of the
command desired (This address was obtained by a previous
call to GTCMCI with GC.CND specified.)

incp

Name of an integer containing a value indicating the action to
take if there is no command queued

ids

Integer to receive the directive status word

Macro Call:

GCCI$ cbuf,cbfl,[ibufl,[ibfl],[addr],[ncp]

cbuf

Address of buffer to receive command string

cbfl

Length of buffer. Maximum buffer size is 84. for RSX-11M

ibuf

Address of buffer to receive information on the issuing termi-

and 259. for RSX-11M-PLUS.
nal

ibfl

Length of buffer to receive information

addr

Address of command

ncp

Action to take if no command buffer is present

GC.CCS (000)

—

Return with carry set (default)

GC.CEX (001) —

Force CLI to exit instead of returning

GC.CST (002)

Force CLI to stop instead of return-

—

ing

GC.CND (200) —

Copy command into buffer but do
not dequeue it from the list

Get Command Interpreter Information

GCIl$

FORTRAN Call:

CALL GETCII (ibuf,ibfl,licli],[idev],[iunit][,ids]
ibuf

Name of an integer array to receive the CLI information

ibfl

Length in bytes of the integer array to receive the CLI information

187

Executive Directive Summary in Alphabetical Order by Macro Call

icli

Name of a two-word array element containing the RAD50
name of the CLI

idev.

iunit

Name of an integer containing the ASCII name of terminal
(default = TI:)
Name of an integer containing the octal unit number of terminal

ids

Directive status

Macro Call:

;

GCII$ buf,bufl,cli,[dev], [unit)
buf

Address of buffer to receive information

bufl

Length of information buffer

cli

Name in RAD50 of the CLI that information is requested on

dev

ASCII name of terminal whose CLI should be used

unit

Octal unit number of terminal

Get LUN Information

GLUNS

FORTRAN Call:

CALL GETLUN (lun,datl[,ids])
lun

Logical unit number

dat

A 6-word integer array to receive LUN information

ids

Directive status

Macro Call:

GLUNS$

lun,buf

lun

Logical unit number

buf

Address of 6-word buffer that will receive the LUN information

Get MCR Command Line
FORTRAN Call:

CALL GETMCR (bufl,ids])
buf

An 80-byte array to receive command line

ids

Directive status

Macro Call:

GMCRS$

188

GMCRS$

Executive Directive Summary in Alphabetical Order by Macro Call

Get Mapping Context

GMCX$

FORTRAN Call:

CALL GMCX (imexl[,ids])

imcx

An integer array to receive the mapping context. The size of
the array is 8*n+1, where n is the number of window blocks in
the task’s header (The maximum size is 8*8+1=65 on
RSX-11M systems. The maximum size is 8*24+1=193 on
RSX-11M-PLUS systems.)

ids

Directive status

Macro Call:
GMCX$

wvec

The address of a vector of n Window Definition Blocks; n is the
number of window blocks in the task’s header.

Get Partition Parameters

GPRT$

FORTRAN Call:
CALL GETPAR ([prt],bufl,ids})
prt

Partition name

buf

A 3-word integer array to receive partition parameters

ids

Directive status

Macro Call:

GPRT$

[prt],buf

prt

Partition name

buf

Address of 3-word buffer

Get Region Parameters

GREGS

FORTRAN Call:
CALL GETREG ([rid],bufl,ids})
rid

Region id

buf

A 3-word integer array to receive region parameters

ids

Directive status

189

Executive Directive Summary in Alphabetical Order by Macro Call

Macro Call:

GREGS$

[rid],buf

rid

Region ID

buf

Address of 3-word buffer

Get Sense Switches ($S form recommended)

GSSWSS

FORTRAN Call:

CALL READSW (isw)
isw

Integer to receive the console switch settings

The following FORTRAN call allows a program to read the state of a single
switch:

CALL SWITCH (ibt,ist)
ibt

ist

The switch to be tested (0 to 15)
Test results where:
1

switch on

switch off

Macro Call:
GSSW$S
err

[err]

Error routine address

Get Time Parameters

GTIMS

FORTRAN Call:

CALL GETTIM (ibfl[,ids])
ibfl

An 8-word integer array

ids

Directive status

Macro Call:

GTIM$

buf

Address of 8-word buffer

Get Task Parameters

FORTRAN Call:
CALL GETTSK (bufl,ids])

buf

190

A 16-word integer array to receive the task parameters

GTSK$

Executive Directive Summary in Alphabetical Order by Macro Call

ids

Directive status

Macro Call:
GTSKS$

buf

Address of 16-word buffer

Inhibit AST Recognition ($S form recommended)

IHARSS

FORTRAN Call:
CALL INASTR
ids

[(ids)]

Directive status

Macro Call:
IHARS$S
err

[err]
=

KError routine address

Map Address Window

MAPS

FORTRAN Call:

CALL MAP (iwdbl,ids])
iwdb

An 8-word integer array containing a Window Definition Block

ids

Directive status

(see Section 3.5.2.2)

Macro Call:

MAP$

wdb

Window Definition Block address

Mark Time

MRKTS$

FORTRAN Call:
CALL MARK (efn,tmg,tntl,ids])

efn

Event flag number

tmg

Time interval magnitude

tnt

Time interval unit

ids

Directive status

191

Executive Directive Summary in Alphabetical Order by Macro Call

The ISA standard call for delaying a task for a specified time interval is also
included:
CALL WAIT (tmg,tnt,ids)
tmg

Time interval magnitude

tnt

Time interval unit

ids

Directive status

Macro Call:
MRKT$

[efn],tmg,tnt[,ast]

efn

Event flag number

tmg

Time interval magnitude

tnt

Time interval unit

ast

AST entry point address

Map Supervisor D-Space to Supervisor |-Space

MSDS$

FORTRAN Call:

Not supported
Macro Call:

MSDS$ mask
mask

A 7-bit mask with one bit corresponding to each APR. If the

bit is set, the APR is mapped to supervisor-mode I-space. If

the bit is clear, the APR is mapped to user-mode D-space. The
7 bits are specified in bits 8 through 14 of the mask word.

‘Move to/from User/Supervisor I/D-Space
FORTRAN Call:

Not supported

192

MVTS$

Executive Directive Summary in Alphabetical Order by Macro Cail

Macro Call:

MVTS$/ action,addr,val

buff

action

One of the following:

MV.TUI — Move to user I-space
MV.TUD — Move to user D-space

MV.TSI — Move to supervisor I-space
MV.TSD — Move to supervisor D-space

MV.FUI — Move from user I-space

MV.FUD — Move from user D-space

‘

MV.FSI — Move from supervisor I-space
MV.FSD — Move from supervisor D-space

addr

Address of the location in the task

buf

Buffer to receive the value fetched, for the move from opera-

val

tions

777

Value to be stored in the location, for the move to operations

Queue I/O Request

Qlo$

FORTRAN Call:
CALL QIO (fnc,lun,lefn],[pril,lisb], [prl]{,ids])
A~

fuc

1/O function code

lun

Logical unit number

efn

Event flag number

pri

Priority; ignored, but must be present

isb

A 2-word integer array to receive final I/O status

prl

A 6-word integer array containing device-dependent parameters

“

to be placed in parameter words 1 through 6 of the Directive
Parameter Block (DPB). Fill in this array by using the

GETADR routine (see Section 1.5.1.4).
ids

Directive status

193

Executive Directive Summary in Alphabetical Order by Macro Call

Macro Call:
QIO$

fne,lun,(efn],[pri],lisb], [ast],[prl]

fnc

I/O function code

lun

Logical unit number

efn

Event flag number

pri

Priority; ignored, but must be present

isb

Address of I/O status block

ast

Address of AST service routine entry point

prl

Parameter list of the form <pl,...p6>

Queue 1/0 Request And Wait

,fi“’”’“fl' B WW

QIOWS

FORTRAN Call:
CALL WTQIO (fnc,lun,lefn],[pril,lisb],[prll[,ids])
fnc

lun

Logical unit number

efn

Event flag number

pri

Priority; ignored, but must be present

isb

A 2-word integer array to receive final I/O status

prl

A 6-word integer array containing device dependent parameters

ids

Directive status

I/0 function code

to be placed in parameter words 1 through 6 of the DPB

Macro Call:
QIOWS

194

fnc,lun,lefn],[pril,lisb],[ast](,prl]

fnc

I/O function code

Jun

Logical unit number

efn

Event flag number

pri

Priority; ignored, but must be present
Address of I/O status block

isb

ast

Address of AST service routine entry point

prl

Parameter list of the form <pl,...p6>

Executive Directive Summary in Alphabetical Order by Macro Call

Receive Data Or Stop

RCSTS

FORTRAN Call:

CALL RCST ([rtnamel],ibufl,ids])
rtname

ibuf

ids

Sender task name (If not specified, data may be received
from any task.)

Address of 15-word buffer to receive the sender task name
and data
Integer to receive the Directive Status Word

Macro Call:
RCST$

[tname],buf

tname

buf

Sender Task name (If not specified, data may be received
from any task.)

Address of a 15-word buffer to receive the sender task name
and data

Receive Data

RCVD$

FORTRAN Call:
CALL RECEIV ([tsk],bufl,,ids])
tsk

Sender task name (If not specified, data may be received from

buf

A 15-word integer array for received data

ids

Directive status

any task.)

Macro Call:
RCVD$

(tsk],buf

tsk

Sender task name (If not specified, data may be received from

buf

Address of 15-word buffer

any task.)

Receive Data Or Exit

RCVX$

FORTRAN Call:
CALL RECOEX ([tsk],bufl,,ids])

tsk

Sender task name (If not specified, data may be received from
any task.)

195

Executive Directive Summary in Alphabetical Order by Macro Call

buf

A 15-word integer array for received data

ids

Directive status

Macro Call:

RCVXS$ (tsk],buf
tsk

Sender task name (If not specified, data may be received from
any task.)

buf

Address of 15-word buffer

Read All Event Flags

RDAFS$

FORTRAN Call:
A FORTRAN task can only read a single event flag. The call is:

CALL READEF (efnl,ids])
efn

Event flag number (1-64.)

ids

Directive status

Macro Call:

RDAF$

buf

Address of 4-word buffer

Read Event Flag

RDEFS$

FORTRAN Call:

CALL READEF

(iefnl,ids])

iefn

Integer containing an event flag number

ids

Integer variable to receive the Directive Status Word

Macro Call:

RDEF$
efn

efn
=

Event flag number

Read Extended Event Flags
FORTRAN Call:
A FORTRAN task can read only a single event flag. The call is:

CALL READEF (efnl,ids])

196

efn

Event flag number (1-96.)

ids

Directive status

RDXF$

Executive Directive Summary in Alphabetical Order by Macro Call

Macro Call:
RDXF$

buf

Address of 6-word buffer

Remove Affinity ($S form recommended)

RMAFS$S

FORTRAN Call:
CALL RMAF

ids

[(ids)]

Integer to receive the Directive Status Word

Macro Call:
RMAF$S

Request and Pass Oftspring Information

RPOIS$

FORTRAN Call:

CALL RPOI (tname,iugc],liumc],[iparen],[ibuf], [ibfl],[isc],
[idnam], [iunit],[itask],[locbad]l,ids])
tname

An array containing the actual name of the task to be requested and optionally chained to

iuge

Integer containing the group code number for the UIC of the

iume

iparen

requested target chain task

Integer containing the member code number for the UIC of
the requested target chain task

Array (or I*4 integer) containing the Radix-50 name of the

parent task (This is returned in the information buffer of the
GTCMCI subroutine.)
ibuf

Array that contains the command line text for the chained
task.

ibfl

Integer that contains the number of bytes in the command in

isc

the ibuf array.

Flag byte controlling the actions of this directive request
when executed. The bit definitions of this byte are as follows:

RP.OEX = 128. Force this t:ask to exit on successful execution of the RPOI directive.

RP.OAL =1

Pass all of this task’s OCB’s to the requested task. (Default is none.)

197

Executive Directive Summary in Alphabetical Order by Macro Call

idnam

Integer containing the ASCII device name of the requested
tasks TI:

iunit

Integer containing the unit number of the requested tasks
TI: device

itask

Array which contains the Radix-50 name the requested task

ocbad

Integer containing the internal pool address of the parent

is to run under. (Valid only for CLIs.)

OCB (Only a CLI can specify this argument because the
value can only be obtained in the information buffer of the

GTCMCI subroutine.)

ids

Integer to receive the directive status word

Macro Call;
RPOI$ tname,pn,pr,ugc,ume,parent,bufadr,buflen,sc,dnam,unit,
task,ocbad
Name of task to be chained to

tname

Partition name (Not used or supported)

Request priority (Not used or supported)

ugc

Group code for UIC of the requested task

ume

Member code for UIC of the requested task

parent

Name of issuing task’s parent task whose OCB is to be
passed. If not specified, all OCB’s are passed.

bufadr

Address of buffer to be given to the requested task

buflen

Length of buffer to be given to requested task

Flags byte:

RP.OEX — (200) Force issuing task to exit
Pass all OCB’s

RP.OAL — (1)

dnam

unit

Unit number of task TI:

task

Radix-50 name of task to be started

ocbad

Address of OCB to pass (CLIs only)

ASCII device name for TI:

Request Task

RQSTS

FORTRAN Call:

CALL REQUES (tsk,lopt]l,ids])
tsk

198

Task name

Executive Directive Summary in Alphabetical Order by Macro Call

opt

A 4-word integer array

opt(1)

= Partition name first half; ignored, but must be
present

opt(2) = Partition name second half; ignored, but must be
present

Priority; ignored, but must be present

opt(4)

User Identification Code

Directive status

ids

opt(3)

Macro Call:

RQST$

tsk,[prtl,[prill,ugc,umc]

tsk

Task name

prt

—

Partition name; ignored, but must be present

pri

Priority; ignored, but must be present

ugc

UIC group code

umec

UIC member code

Receive By Reference

RREF$

FORTRAN Call:

CALL RREF (iwdb,[isrbl[,ids])

iwdb

An 8-word integer array containing a Window Definition Block

istb

A 10-word integer array to be used as the receive buffer

ids

Directive status

(see Section 3.5.2.2)

Macro Call:

RREF$

wdb

Window Definition Block

RSUMS

Resume Task
FORTRAN Call:

CALL RESUME (tsk[,ids])
tsk

Task name

ids

Directive status

199

Executive Directive Summary in Alphabetical Order by Macro Call

Macro Call:
RSUMS$
tsk

tsk
=

Task name

Run Task

RUNS

FORTRAN Call:

CALL RUN (tsk,[opt],[smg],snt,[rmg],[rnt][,ids])
tsk

Task name

opt

A 4-word integer array

opt(l)

Partition name first half;

ignored,

but must be

present

opt(2)

Partition name second half; ignored, but must be
present

opt(3)

Priority; ignored, but must be present

opt(4)

User Identification Code

smg

Schedule delta magnitude

snt

Schedule delta unit
Reschedule interval magnitude

rmg

rnt

Reschedule interval unit

ids

Directive status

'The ISA standard call for initiating a task is also included:
CALL START (tsk,smg,sntl,ids])
tsk

smg

Schedule delta magnitude

snt

Schedule delta unit

ids

Directive status

Task name

Macro Call:

RUNS$

200

tsk, [prt], [pril],[ugel,[umc],[smg],snt[,rmg,rnt)

tsk

Task name

prt

Partition name; ignored, but must be present

pri

Priority; ignored, but must be present

Executive Directive Summary in Alphabetical Order by Macro Call

uge

UIC group code

umc

UIC member code

smg

Schedule delta magnitude

snt

Schedule delta unit

rmg

Reschedule interval magnitude

Reschedule interval unit

Specify Command Arrival AST

SCAAS

FORTRAN Call:
Not supported

Macro Call:
SCAAS3

[ast]

ast

—

AST service routine entry point; omitting this parameter disables command arrival ASTs for the issuing CLI task until
the directive is specified again.

Supervisor Call ($S form recommended)

SCALSS

FORTRAN Call:
Not supported

Macro Call:

SCALS$S

saddr,caddr

saddr

Address of the called supervisor-mode routine

caddr

Address of the completion routine for return to the caller

Set Command Line Interpreter

SCLIS

FORTRAN Call:

CALL SETCLI (icli,idev,iunit[,ids])

icli

A two word array element containing the name of the CLI to

idev.

Integer containing the ASCII name of the terminal to be set

iunit

Integer containing the unit number of terminal

ids

Directive status

which the terminal is to be set
(default = TI:)

201

Executive Directive Summary in Alphabetical Order by

Macro Call

Macro Call:

SCLIS$ cli,[dev],[unit]

cli

Name of the CLI to which the terminal is to be set

dev.

ASCII name of the terminal to be set (default — TI:)

unit

Unit number of terminal

Send Data

SDATS

FORTRAN Call:
CALL SEND (tsk,buf,efn],ids])
tsk

Task name

buf

A 13-word integer array of data to be sent

efn

Event flag number

ids

Directive status

Macro Call:
SDAT$

tsk,bufl,efn]

tsk

Task name

buf

Address of 13-word data buffer

efn

[Event flag number

Send Data Request and Pass Oftspring Control Block

SDRP$

FORTRAN Call:

CALL SDRP (task,ibuf, [ibfl], liefn], [iflag], liparen], liocbad][,ids])
task

Name of an array (REAL, INTEGER, I*4) that contains the
RADS50 name of target task

ibuf

Integer array containing data to be sent

ibfl

Integer containing number of words (integers) in the array to
be sent (On RSX-11M systems, this argument must be 13.,

and on RSX-11M-PLUS systems, this argument may be

the range of 1 to 255.) (Default = 13.)
iefn

Integer containing the number of the event flag to be set
when this directive is executed successfully

Executive Directive Summary in Alphabetical Order by Macro Call

iflag

Integer containing flags bits controlling the execution. They
are defined as follows:

SD.REX = 128.

Force this task to exit upon successful
execution

SD.RAL =1

Pass all OCBs

iparen

Name of array containing the Radix-50 name of the parent

iocbad

Name of an integer containing internal pool address of the

ids

Integer to receive the contents of the Directive Status Word

task whose OCB should be passed to the target task
OCB to pass

Macro Call:

SDRP$ task,bufadr,buflen,efn,flag,parent,ocbad
Name of task to be chained to

task

bufadr

Address of buffer to be given to the requested task

buflen

Length of buffer to be given to requested task

efn

Event flag

flag

Flags byte (Force exit, pass all OCB’s)

parent

ocbad

Name of issuing task’s parent task whose OCB is to be
passed

Address of OCB to pass (CLI's only)

Send, Request And Connect

SDRC$

FORTRAN Call:

CALL SDRC (rtname,ibuf,[iefn],[iast},[iesb],[iparm][,ids])

rtname

Target task name of the offspring task to be connected

ibuf

Name of 13-word send buffer

iefn

Event flag to be set when the offspring task exits or emits

iast

—

status

Name of an AST routine to be called when the offspring task
exits or emits status

203

Executive Directive Summary in Alphabetical Order by Macro Call

iesb

Name of an 8-word status block to be written when the
offspring task exits or emits status

Word

0 — Offspring task exit status

Word 1-7 — Reserved
iparm

Name of a word to receive the status block address when an
AST occurs

ids

Integer to receive the Directive Status Word

Macro Call:

SDRCS$

tname, buf,[efn], [east], [esb]

tname

Target task name of the offspring task to be connected

buf

Address of a 13-word send buffer

efn

The event flag to be cleared on issuance and when the off-

spring task exits or emits status

Address of an AST routine to be called when the offspring
task exits or emits status

east

esh

Address of an 8-word status block to be written when the

offspring task exits or emits status

Word

0 — Offspring task exit status

Word 1-7 — Reserved

Set Event Flag

SETF$

FORTRAN Call:

CALL SETEF (efnl,ids])
efn

Event flag number

ids

Directive status

Macro Call:

SETF$
efn

g,iy,

efn
=

Event flag number

Specify Floating Point Exception AST
FORTRAN Call:
Not supported

204

SFPAS

Executive Directive Summary in Aiphabetical Order by Macro Call

Macro Call:
SFPA%

ast

[ast]

AST service routine entry point address

Send Message

SMSGS$

FORTRAN Call:

CALL SMSG (itgt,ibuf,ibufl,iprm,iprml,ids)

itgt

Integer containing the target object

ibuf

Integer array containing the data to be inserted into the for-

ibufl

Integer containing length of the ibuf array

iprm

Integer array containing any additional parameters

iprml

Integer containing the number of parameters in the iprm

ids

matted data packet

array

Optional integer to receive the directive status

Macro Call:

SMSG$ tgt,buf,len, <pri,...,prn>
tgt

Target identifier

buf

Address of optional data buffer

len

Length in bytes of optional data buffer

pri,....prn

Target-specific parameter list:

Parameter list for Error Logging

SMSG$ SM.SER,buf,len,typ,sub,lun,mask>
typ

Error Log packet code

sub

Error Log packet subtype code

lun

Logical unit number of device

msk

Control mask word

Send Next Command

SNXC$

FORTRAN Call:

CALL SNXC (lidnam] [,iunit}[,ids])

dnam

Device name (ASCII). If not specified, TI: is used

205

Executive Directive Summary in Alphabetical Order by Macro

iunit

Call

Unit number of the terminal from which the command is to be

sent

ids

Integer to receive the Directive Status Word

Macro Call:
SNXC$ [dnam,] [,unum]
dnam

Device name (ASCII). If not specified, TI: is used

unum

Unit number of the terminal from which the command is to

be sent

Specify Parity Error AST

SPEAS

FORTRAN Call:
Not supported
Macro Call:

SPEAS [ast]
ast

AST services routine entry point address

Suspend ($S form recommended)

SPND$S

FORTRAN Call:

CALL SUSPND
ids

[(ids)]

Directive status

Macro Call:
SPND$S
err

[err]

Error routine address

Specify Power Recovery AST

SPRAS

FORTRAN Call:
EXTERNAL sub

CALL PWRUP (sub)
sub

Name of a subroutine to be executed upon power recovery. The
PWRUP subroutine will effect the following:

CALL sub (no arguments)
The subroutine is called as a result of a power recovery AST,

and therefore the subroutine can be controlled at critical points
by using the DSASTR (or INASTR) and ENASTR subroutine

calls

206

Executive Directive Summary in Alphabetical Order by Macro Call

To Remove an AST:
CALL PWRUP
Macro Call:
SPRAS

ast

[ast]

AST service routine entry point address

SPWNS$

Spawn
FORTRAN Call:

CALL SPAWN (rtname,liugc),liumc],liefn],[iast], liesb],[iparm],icmlin],
licmlen],[iunit],[dnaml](,ids])

rtname

iugc

—

iumc

—

iefn

—

iast

—~

iesb

—

Name (Radix-50) of the offspring task to be spawned
Group code number for the UIC of the offspring task

Member code number for the UIC of the offspring task
Event flag to be set when the offspring task exits or emits
status

Name of an AST routine to be called when the offspring
task exits or emits status

Name of an 8-word status block to be written when the

offspring task exits or emits status

Word

0 — Offspring task exit status

Word 1-7 — Reserved

Name of a word to receive the status block address when the

iparm

—

icmlin

Name of a command line to be queued for the offspring task

icmlen

Length of the command line (79. characters maximum)

iunit

—~

Unit number of terminal to be used as the TI: for the offspring task (If the optional dnam parameter is not specified,

AST occurs

this parameter must be the unit number of a virtual terminal created by the issuing task; if a value of 0 is specified,
the TT: of the issuing task is propagated.)

dnam

—

Device name mnemonic (If not specified, the virtual termi-

ids

—

Integer to receive the Directive Status Word

nal is used as TI:.)

207

Executive Directive Summary in Alphabetic

al Order by Macro Call
,,*‘”“M%V

Macro Call:
SPWN tname,,,[ugc],[umc],[efn],[east],[esb],{cmdlin],

[cmdlenl,[unum],[dnam}

tname

uge

Group code number for the UIC of the offspring

ume

Member code number for the UIC of the offspring

efn

The event flag to be cleared on issuance and set when

east

Address of an AST routine to be called when the

task
task

offspring task exits or emits status

task exits or emits status

esb

Name (Radix-50) of the offspring task to be spawned

”

the

offspring

—

’

Address of an 8-word status block to be written when
the
offspring task exits or emits status
Word

0 — Offspring task exit status

Word 1-7 — Reserved
cmdlin - =

Address of a command line to be queued for the offspring
task

cmdlen

Length of the command line (maximum length is 79.)

unum

Unit number of terminal to be used as the TI: for
the off-

spring task (If the optional dnam parameter is not specified,
this parameter must be the unit number of a virtual termi-

nal created by the issuing task; if a value of 0 is specified,
the TI: of the issuing task is propagated.)

dnam

Device name mnemonic (If not specified, the virtual termi-

nal is used as TI:.)

NOTE
1. If neither unum nor dnam is specified, the TI: of the
issuing task is propagated.

2. If only unum is specified, TI: is a virtual terminal.

Specify Receive Data AST

SRDAS

FORTRAN Call:

Not available to FORTRAN.

Macro Call:

SRDA$
ast

208

[ast]
=

AST service routine entry point address

Executive Directive Summary in Alphabetical Order by Macro Call

Specify Requested Exit AST

SREAS
SREXS$S

FORTRAN Call:

CALL SREA (astl,ids])

ast

Name of the externally declared AST subroutine

ids

Name of an optional integer to receive the Directive Status
Word

CALL SREX (ast,ipblk,ipblkl,[dummy]l,ids])

ast

Name of the externally declared AST subroutine

ipblk

—

Name of an integer array to receive the trap-dependent

ipblkl

Number of parameters to be returned into the ipblk array

dummy

Reserved for future use

ids

parameters

Name of an optional integer to receive the Directive Status
Word

Macro Call:
SREAS [ast]

SREX$ (ast][,dummy]

ast

AST service routine entry point address

dummy

Reserved for future expansion

Send By Reference

SREF$

FORTRAN Call:

CALL SREF (tsk,[efn],iwdb,[isrb}{,ids])
tsk

Receiver task name

efn

Event flag number

iwdb

An 8-word integer array containing a Window Definition Block

isrb

—

An 8-word integer array containing additional information

ids

Directive status

(see Section 3.5.2.2)

209

Executive Directive Summary in Alphabetical Order by Macro

Call

Macro Call:

SREF$

task,wdbl,efn]

task

Receiver task name

wdb

Window Definition Block address

efn

Event flag number

Specify Receive-By-Reference AST

SRRAS

FORTRAN Call:
Not supported

Macro Call:
SRRAS$
ast

[ast]
=

AST service routine entry point address

Set Affinity

STAFS$

FORTRAN Call:

CALL STAF (iaff,ids])
iaff

Affinity mask word

ids

Integer to receive Directive Status Word

Macro Call:
STAFS$ [cp!ub!ub...]
cp

CPU selected (A through D)

UNIBUS run(s) selected (E through T)

Set System Time Directive
FORTRAN Call:

CALL SETTIM (ibufn[,ibufp]l,ids])

210

ibufn

ibufp

An 8-word integer array, previous time buffer

ids

Directive status

An 8-word integer array, new time specification buffer

STIMS

Executive Directive Summary in Alphabetical Order by Macro Call

Macro Call:
STIM$ bufn,[bufpl

bufn

Address of 8-word new time specification buffer

bufp

Address of 8-word buffer to receive the previous system time
parameters

Stop For Logical OR Of Event Flags

STLOS

FORTRAN Call:

CALL STLOR (iefl,ief2,ief3, ... ief(n))

iefl ... ief(n)

List of event flag numbers

Macro Call:

grp, msk

STLO$

grp

Desired group of event flags

msk

A 16-bit mask word

Stop ($S form recommended)

STOPSS

FORTRAN Call:
CALL STOP (lids])

ids

Integer to receive the Directive Status Word

Macro Call:
STOP$S

Stop For Single Event Flag

STSES$

FORTRAN Call:

CALL STOPFR (iefn[,ids])

iefn

Event flag number

ids

Integer to receive Directive Status Word

Macro Call:
STSE$

efn

Event flag number

211

Executive Directive Summary in Alphabetical

Order by Macro Call

Specify SST Vector Table For Debugging Aid

SVDB$

FORTRAN Call:
Not supported

Macro Call:
SVDB$

[adr][,len]

adr

Address of SST vector table

len

Length of (that is, number of entries in) table in words

Specify SST Vector Table For Task

SVTKS$

FORTRAN Call:
Not supported

Macro Call:
SVTKS$

[adri,len]

adr

Address of SST vector table

len

Length of (that is, number of entries in) table in words

Unlock Group Global Event Flags (% form recommen

ded)

ULGF$S

FORTRAN Call:

CALL ULGF (lids))
ids

Directive status

Macro Call:

ULGFS$S [err]
err

Krror routine address

Unmap Address Window

UNMAPS

FORTRAN Call:

CALL UNMAP (iwdbl,ids])
iwdb

An 8-word integer array containing a Window Definition
(see Section 3.5.2.2)

ids

Block

Directive status

212

Executive Directive Summary in Alphabetical Order by Macro Call

Macro Call:
UMAPS$

wdb

Window Definition Block address

Unstop TASK

USTPS

FORTRAN Call:

CALL USTP (rtnamel,ids])

rtname

Name of task to be unstopped

ids

Integer to receive directive status information

Macro Call:
USTP$

tname

Name of task to be unstopped

Variable Receive Data

VRCD$

FORTRAN Call:

CALL VRCD ([task],bufadr,[buflen] [,ids])
Sender task name

task

bufadr

Address of buffer to receive the sender task name and data

buflen

Length of buffer

ids

Integer to receive the Directive Status Word

Macro Call:

VRCD$

[task],bufadr(,buflen]

task

Sender task name

bufadr

Buffer address

buflen

Buffer size in words

Variable Receive Data Or Stop

VRCS$S

FORTRAN Call:

CALL VRCS ([task],bufadr,{buflen][,ids])
task

Sender task name

213

Executive Directive Summary in Alphabetical Order by Macro Call

buf

Address of buffer to receive the sender task name and data

buflen

Length of buffer

ids

Integer to receive the Directive Status Word

Macro Call:
VRCS$ [task],bufadr[,buflen)
task

Sender task name

bufadr

Buffer address

buflen

Buffer size in words

Variable Receive Data Or Exit

VRCX$

FORTRAN Call:
CALL VRCX ([task],bufadr,[buflen][,ids))

task

Sender task name

bufadr

Address of buffer to receive the sender task name and data

buflen

Length of buffer

ids

Integer to receive the Directive Status Word

Macro Call:

VRCXS$ [task],bufadr[,buflen]
task

Sender task name

bufadr

Buffer address

buflen

Buffer size in words

Variable Send Data

VSDAS

FORTRAN Call:

CALL VSDA ([task],bufadr,[buflen], [efn][,ids])

214

task

bufadr

Address of buffer to receive the sender task name and data

buflen

Length of buffer

efn

Event flag number

ids

Integer to receive the Directive Status Word

Receiver task name

Executive Directive Summary in Alphabetical Order by Macro Call

Macro Call:

VSDAS$ [task],bufadr,[buflen](,efn]

task

Receiver task name

bufadr

Buffer address

buflen

Bulffer size in words

efn

Event flag number

Variable Send, Request and Connect

VSRC$

FORTRAN Call:

CALL VSRC (rtname,ibuf,{ibuflenl,[iefn],{iast],[iesb},[iparm]{,idS])
Target task name of the offspring task to be connected
rtname
ibuf

Name of 13-word send buffer

ibuflen

Length of buffer

iefn

Event flag to be set when the offspring task exits or emits
status

1ast

iesb

Name of an AST routine to be called when the offspring task
exits or emits status

Name of an 8-word status block to be written when the

offspring task exits or emits status

Word

0 — Offspring task exit status

Word 1-7 — Reserved
iparm

Name of a word to receive the status block address when an
AST occurs

ids

Integer to receive the Directive Status Word

Macro Call:

VSRC$ tname,bufl,buflen],efn,east,esb
tname

Target task name of the offspring task to be connected

buf

Address of a 13-word send buffer

buflen

Length of buffer

efn

The event flag to be cleared on issuance and set when the
offspring task exits or emits status

215

Executive Directive Summary in Alphabetic

al Order by Macro Call

east

Address of an AST routine to be called
when the offspring

task exits or emits status

esh

Address of an 8-word status block to be written
when the
offspring task exits or emits status

Word

0 — Offspring task exit status

Word 1-7 — Reserved
Wait For Significant Event ($S form recommen

ded)

WSIGSS

FORTRAN Call:

CALL WFSNE
Macro Call:
WSIGS$S
err

[err]

Krror routine address

Wait For Logical OR Of Event Flags

WTLOS$

FORTRAN Call:
CALL WFLOR (efnl,efn2,...efnn)
efn

List of event flag numbers taken as the set of
flags to be specified in the directive

Macro Call:

WTLO$

grp,msk

grp

Desired group of event flags

msk

A 16-bit octal mask word

Wait For Single Event Flag

FORTRAN Call:
CALL WAITFR (efnl,ids])
eftn

Event flag number

ids

Directive status

Macro Call;
WTSES$
efln

216

efn
=

Event flag number

WTSES$

RADIX-50 CONVERSION TABLE
To convert 1 to 3 characters to their Radix-50, 6-digit octal equivalent, add the
appropriate octal codes from the following table, based on the positions (that is,
first, second, or third) of the characters in the string.

Character
Set

Space

000000

B
C
D

006200
011300
014400

—

‘

F
G
H
I

L
M
N

First

Character
Code

P
Q
R
S

u
Vv
W

Second

Character
Code

000000

000120
000170
000240

000002
000003
000004

003100

000050

017500

000310

022600
025700
031000
034100

000360
000430
000500
000550

042300

000670

037200

045400
050500
053600

056700

000620

000740
001010
001060

001130

062000
065100
070200
073300

001200
001250
001320
001370

101500
104600
107700

001510
001560
001630

076400

113000

001440

001700

116100
121200

001750
002020

127400

002140

Unused
0
1
2

132500
135600
140700
144000

002210
002260
002330
002400

Y
Z

124300

Third

Character
Code

002070

000001

000005

000006
000007
000010
000011

000012

000013

000014
000015
000016

000017

000020
000021
000022
000023

000024

000025
000026
000027

000030

000031
000032

000033
000034

000035
000036
000037
000040

217

RADIX-50 Conversion Table
UL .

Character
Set

First
Character

Code
147100

Lo~
O,

152200

218

Second
Character
Code
002450
002520

Third
Character
Code
000041

160400

002570
002640

163500

002710

166600

000042
000043
000044
000045

002760

171700

000046

003030

000047

155300

OCTAL/DECIMAL CONVERSION TABLE
Bits

Octal

28672

equivalent in the conversion table. Add

20480
16384
12288

decimal value.
Example:
.

8
7

| '”’”MR

‘

24576

20000

8192

53702(8) = ?(10)

n(10)

50000

20480

2560

4096

7000
6000

3584
3072

4000

2048

5000
3000

2000
1000

1536
1024
512

56
48

Subtract the table decimal value from
the decimal value to be converted.
Repeat the process until the subtrac-

22466(10)

128
64
0

53702(8) =

Locate in the conversion table the
decimal value closest to, but not exceeding, the decimal value to be con-

192

1536
448

384
328
256

300

70
60

=
=

Decimal to Octal

448

200
100
0

3000
700

700

600
500
400

10
0
7

the decimal equivalents to obtain the

60000

locate the octal digit and its decimal

’

70000

10000

100000
50000
40000
30000

14
13
12

Octal to Decimal

For each position of the octal value,

Decimal

32768

verted. Record the octal equivalent.

tion balance equals 0. Add the octal
equivalents to obtain the octal value.

22466(10) = 7(8)

Example:

n(10) = n(8)

22466

8
0
7

20480

50000

1536

3000

— 20480
1986
— 1536

448

700

— 448

-2

22466(10) = 53702(8) =

450

219

TM ,

STANDARD FILE TYPES

RSX-11M uses the standard 3-letter file types used by all DIGITAL-supplied
any
software. These names indicate the actual contents of the files. Althoughstancombination of three letters can be used, DIGITAL recommends that the
dard types be used whenever possible. (Compilers and other system programs
that refer to these file types look for the standard name as a default. For example, if the command FOR ADD = ADD is issued, the FORTRAN-IV compiler
looks for ADD.FTN, and if the file is named ADD.FOR, the compiler reports
that there is no such file.)
Type

File Contents

.BAS

A BASIC-11 language source program
Batch file (default)

BAT
.BLD

.B2S
.CBL

.CDA

.CFS

.CLB
.CMD

.CNF
.COR

.CRF

.DAT
.DIR
.DMP

.ERR
FTN

HLP

Indirect command files used as input to sysgen
A BASIC-PLUS-II language source program
A COBOL language source program

Crash dump binary file
Error Logging control file string

Indirect Command Processor command library

MCR or task commands (an indirect command file)
An Error Logging language source file
A SLP correction file

Cross reference processor symbol table file
File containing data (as opposed to a program)
Directory File

File Dump Utility output file
Error Logger output file

FORTRAN-IV or FORTRAN-IV PLUS language source file
Help file

ACF

An Error Logging intermediate form file output from

LOG

Batch or console log file

LST

.MAC
MAP
.MLB
.0BJ

.ODL

.OLB
PAT

.PMD

Control File Language compiler
A listing file
A MACRO-11 source program

A Task Builder memory allocation map
A macro library

An object program (output from either the MACRO-11
Assembler or a compiler)
A Task Builder overlay descriptor
An object module library

Correction file used by assembler to create a patched

object module

Postmortem or snapshot dump file

221

Standard File Types

Type
.POB

SML
.STB

SYM
.SYS

.TMP
.TSK
TIXT

.ULB

222

File Contents

Patched object module used by the PAT

The system macro library
Symbol table file
An Error Logging symbol file

utility

A bootable system image or other system
file
A temporary file

A task image file
A text file
A universal file library

—~

NOTES