Digital PDFs

AV-5570C-TC

May 1979

63 pages

Original

1.5MB

Document:	RSX-11M Mini-Reference
Order Number:	AV-5570C-TC
Revision:	0
Pages:	63
Original Filename:	http://bitsavers.org/pdf/dec/pdp11/rsx11m_s/RSX11M_V3.2_Jun79/AV-5570C-TC_RSX11-M_3.2_MiniRef_197905.pdf

OCR Text

RSX-11M
Mini-Reference
Order No. AV-5570C-TC

RSX-11 M Version 3.2

To order additional copies of this document, contact the Software Distribution
Center. Digital Equipment Corporation, Maynard, Massachusetts 01754

digital equipment corporation · maynard, massachusetts

Revised, May 1979

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
only be used or copied 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 or its affiliated companies.

The following are trademarks of Digital Equipment Corporation:

DIGITAL
DEC
PDP
DEC US
UNIBUS
COMPUTER LABS
COMTEX
DDT
DECCOMM
ASSIST-11
VAX
DECnet
DATATRIEVE

DECsystem-10
DECtape
DIBOL
EDUSYSTEM
FLIP CHIP
FOCAL
INDAC
LAB-8
DECSYSTEM-20
RTS-8
VMS
!AS
TRAX

MASSBUS
OMNIBUS
OS/8
PHA
RSTS
RSX
TYPESET-8
TYPESET-11
TMS-11
ITPS-10
SB!
PDT

INTRODUCTION
This handbook is intended as a convenient, easy-to-use reference for RSX-11 M
system users. Included are summaries of the commands for the following
systems and facilities:
Page
3
Monitor Console Routine (MCR) Commands
Line Text Editor (EDI) Commands

DEC Standard Editor (EDT) Commands

Peripheral Interchange Program (PIP) Commands

On-Line Debugging Tool (ODT) Commands

Error Logging

1/0 Error Codes

Directive Error Codes

Task Builder (TKB) Switches and Options

ASCII Character Set

Radix-50 Conversion Table

Octal/Decimal Conversion Table

Standard File Types

In addition, the following documentation conventions are used in this handbook:
Lowercase letters designate a variable whose value is determined when
the command is entered.
Uppercase letters designate a command line element that must be
entered as shown.
Square brackets ([]) enclose optional parameters, except for UIC
specifications which always require brackets.
Numeric -values in commands can be octal ur decimal, unless the com·
mand description specifies otherwise.

INTRODUCTION

Braces ({ }) indicate that the user can choose any one of the items that are
enclosed.
A one- to three-character symbol indicates that you press a
key on the terminal, for example, @) or ~ .
The symbol ~ indicates that you press the key labeled
CTRL while you press another key, for example ~ ,
<§ili) . (§12) .

LB~

LBR [~,10] ~- ~60 I LE.

R/f\S

MTY: 03lOOO:,. Bl(P = [3~'1G1 ~. ~ i,
RST DN O: [3~01 61 k-. ~ = MTl..f: 03l0oex;. Qk'P
D5P IV\TY ·. 03?,G006. Bk'P/Sp

~<J<

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

Nonprivlleged MCR Commands
The commands described below can be issued by any user.
ABO[Rll taskname [/keyword]

Keywords:

PMD

Terminates execution of the specified task. All users can generate a
Postmortem Dump with the PMD keyword.
ACT(IVE) [/keyword)

Keywords:

ALL

Displays on the terminal all tasks issued from that terminal or all tasks
active in the system.
ALL[OCATE] ddn: [keyword]

Keywords:

= LLnn:
TERM=Tinn:

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. The LLnn: keyword allows the
user to equate a physical device with a logical device. Specifying the command with only a 2-character abbreviation allocates the first free device
of the type specified.
Assign

Keywords:

ASN ppn: = LLnn: [/keyword]

GBL
LOGIN
TERM=Tinn:

Defines, displays, or deletes logical device assignments as follows:
Local assign operations

ASN ppn: = LLnn:
ASN ppn: = LLnn:/TERM =Tinn:

(P)

MONITOR CONSOLE ROUTINE (MCR) COMMANDS

(P)

Global assign operations
ASN ppn: = LLnn:/GBL

(P)

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

(P)

Global display operations
ASN /GBL

(P)

Local delete operations
ASN
ASN = LLnn:
Login delete operations
ASN =/LOGIN (P)
ASN =/LOGIN/TERM =TTnn: (P)
ASN =!TERM =TTnn: (P)
ASN = /LLnn:/TERM = TTnn: (P)
Global delete operations
ASN =/GBL
ASN = LLnn:/GBL

(P)

Active Task List ATL [taskname)
Displays on the entering terminal the name and status of all active tasks
in the system or the status of the particular task specified.

BRO[ADCAST) TTn:message
BRO[ADCAST] @filespec
BRO[ADCASTJ ALL:message(P)
BRO[ADCAST) LOG:message(P)

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

MONITOR CONSOLE ROUTINE (MGR) COMMANDS

BYE
Logs the user off a multiuser protection system.
CAN[CEL) taskname

Cancels time-based initiation of a task. Privileged users can cancel any
task but nonprivileged users can only cancel tasks that they initiated.
DEA(ALLOCATE) [ddn:)

Releases a private (allocated) device when ddn: 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.
DEV[ICES) Ukeyword)

Keywords:

dd:
/LOG

Displays symbolic names of all devices or of all devices of a particular
type known to the system. The LOG keyword displays logged-in terminals.
Dismount

Keywords:

OMO ddn:[label)[/keyword(s))

[)ft'IO

DEV(P)

USER
TERM= TTnn:(P)

Mt :/OEV

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 only dismount devices that they have mounted.
Group Global Event Flags

Keywords:

FLA[GS)[gggUkeyword])

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 group.
HEL[LO) UIC/PASSWORD

Logs a user on a terminal to access a multiuser system.

MONITOR CONSOLE ROUTINE (MGR) COMMANDS

HELP [qualllier)[qualifler 2)[ ... qualifier 9)
HELP %[qualllier)[qualllier 2)[ ... qualifier 9)

Displays the contents of [l,2]HELP.TXT or the contents of a user help
file on the issuing terminal.
INl[TVOLUME] ddn:volumelabel [/keyword(s)]

Keywords:

BAD= [option]
CHA= [characteristics]
DENS= density selection
EXT= block-count
FPRO = [system,owner,group,world]
INDX =index-file-position
INF= initial-index-file-size
LRU = directory-preaccess-count
MXF =file-count
PRO= [system,owner,group,world)
UIC =[group.member]
WIN= retrieval-pointer-count
VI= keyword list

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

LUN[S] [taskname]

Displays at the entering terminal the static LUN assignments for a
specified task.

MONITOR CONSOLE ROUTINE (MCR) COMMANDS

MOUNT
Files·11 disk or DECtape format
MOU[NT) ddn:[volumelabel)Ukeyword(s))
Keywords:

ACP = taskname
EXT= block-count
FOR= acpname
FPRO = [system,owner,group,world]
LRU = FCB-count
OVR (override)
PARM= user parameters
UIC=[uic]
UNL
VI (volume information)
WIN= retrieval-pointer-count

Creates the Volume Control Block (VCB) and declares the volume logi·
cally online for access by a file system.
Files-11 (ANSI) magnetic tape format
MOU[NT) device(s):volume{s):Ukeyword(s))
Keywords:

ACP = taskname
BYPASS
DENS= tape-density
FPRO = [system,owner,group,world]
NO LAB
OVR (override)
OVRFSID
OVREXP
UIC = [uic]/VI
VI (volume information)

Allocates the Volume Set Control Block (VSCB) and mounted and unmounted volume lists. Devices are specified as device(s), and volumes are
specified as volume(s).
PARTITION DEFINITIONS

PAR[TITIONS)

Displays on the entering terminal a description of each memory partition
in the system.

MONITOR CONSOLE ROUTINE (MCR) COMMANDS

RES(UMEJ taskname
Allows nonprivileged users to continue execution of a suspended task
that was initiated from the entering terminal. Privileged users can direct
the Resume command to any suspended task.

RUN taskname VRSI = maguVUIC = [ulcD
RUN taskname dtlme VRSI = megu)VUIC = [ulcD
RUN taskname sync [dtlmaJVRSI = magu)VUIC = [ulcD
RUN taskname atlma VRSI = maguJVUIC[ulcD
RUN [ddn:][SJ lilespec Vkeyword(s)J
Keywords:

CKP =option
INC=slze
PAR=pname
PRl=number
SLV=option
TASK= taskname
UIC=[g,m]

Initiates execution of a task, either immediately or at one of several timedependent intervals.

SET /keywords= values
Keywords:

BUF = dev:[size]
CRn=rrnn:J
EBC[ = TTnn:]
ECHO[= TTnn:]
ESCSEQ[ = TTnn:]
FOX[= TTnn:]
FORM FEED[= TTnn:]
HFILL=TTnn:[value]
HHn=TTnn:J
HOLD[= TTnn:]
LA30S[ = TTnn:]
LIN ES= TTnn:[value]
LOGON (P)
LOWER= [TTnn:]
MAIN (P)
MAXEXT (P)
MAXPKT (P)
POOL

PRIV[ = TTnn:]

..euer
=~ev:J
REMOTE[= TTnn:]
RPA[ = TTnn:]
SLAVE[= TTnn:]
SPEED= TTnn:[recv:xmit]
SYSUIC[ = uic] (P)
TERM= TTnn:[value]
TYPEAHEAD[= TTnn:]
UIC{ = uic:[TTnn:]]
UIC[ = TTnn:]
VFILL[ = TTnn:]
VT05B
WCHK[ = dev:]
WRAP[= TTnn:]

Establishes device characteristics for the device specified. Privileged
users can alter device characteristics for all of the devices on the system,
but nonprivileged users can only alter and observe characteristics for
devices allocated to them.

MONITOR CONSOLE ROUTINE (MCR) COMMANDS

Stop

STP /keyword

Keywords:

taskname
TERM=TTnn:

Declares that the task specified is no longer eligible to execute or com·
pete for memory resources.
Task List

TAL [taskname)

Displays the names and status of all tasks installed on the system or of
tasks of a particular task name.
Tasklist

TAS

Describes each task installed on the system.
Time

TIM [dd·mon·yr)[hh:mm:ss)
[mon/dd/yr)

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

Keywords:

UFO ddn:[volabel)[g,m)Ukeyword(s))

ALLOC = num-entries
PRO= [s,o,g,w]

Creates a User File Directory (UFD) on a Files·ll volume and enters its
name onto the Master File Directory (MFD). Privileged users can create
UFDs on any volume, but nonprivileged users can create UFDs only on a
volume mounted on a device that they have allocated.
UNS[TOP) [/keyword)

Keywords:

taskname
TERM=Tinn:

Continues execution of a previously stopped task.

Privileged MCR Commands
Allocate Checkpoint Space

ACS ddn:/BLKS = n

Allocates or discontinues a checkpoint file on disk for systems that sup·
port the dynamic allocation of checkpoint space.

MONITOR CONSOLE ROUTINE (MCR) COMMANDS

AL T[ER] taskname[/keyword]

Keywords:

PRI =running and static priority
RPRI =running priority only

Changes the static or running priority of an installed task.
BOO[T] lilespec

Bootstraps a system that exists as a task image file on a Files-11 volume.
Breakpoint to XTO

BRK

Passes control to the Executive Debugging Tool (XDT).
CLQ[UEUE]

Displays on the entering terminal information about tasks currently in
the clock queue, or about tasks activated by either a Run command or a
RUN$ directive that specified a time-based option.
Fix-in-Memory

FIX taskname

Loads and locks a task into its partition.
INS[TALL] [$]filespec[/keyword(s)]

Keywords:

CKP =option
EST=option
INC=size
PAR=pname
PMD=option
PRI =number
SLV=option
TASK= taskname
UIC=[g,m]

Makes a specified task known to the system.
LOA{DJ dd:[/keyword(s)]

Keywords:

PAR= parname
SIZE= parsize
HIGH

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

MONITOR CONSOLE ROUTINE (MGR) COMMANDS

Open Register

Keywords:

OPE[N) mem-addr[ +I - nJUkeyword)(mem-addr)
(contents·addr)llvalue) <line-terminator>

TASK= taskname
PAR= partition name
KNL
DRV=dd:

Allows examination and optional modification of a word of memory.
REA(SSIGN) taskname lun ddn:

Reassigns a task's static logical unit numbers from one physical device
to another.
RED[IRECT] nddn: =oddn:

Redirects all I/O requests from one physical device unit to another (from
o ton).
REM[OVE) taskname

Deletes an entry (task name) from the System Task Directory (STD) and
thereby removes the task from the system.
SAV[E) [/keyword(s))

Keywords:

MOU= "string"
SFILE ="string"
Copies the current system image into the system image file from which
the current system was booted.
System Service Message

SSM messagetext

Inserts text into the error log reports.
UNF[IXJ taskname [/keyword)

Keywords:

RG
RI

Frees a fixed task from memory.
UNL[OAD) dd:

Removes a loadable device driver from memory.

DMP ruiRCL
/A$~~
I ey .Q ~ l?J:Jt&
/Oc. ~~
/HX Jkn'll.'~~(~ nk-~-~)
/LW

Jkix·A-~~~

/Rs

11-0-tlJJ'X - 5\J ~

/WD f4tt_-{:},~0~ ~d_
/e.L:':;:lo

1~ ,t;v~ ~ S·IO

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. Square brackets
enclose optional command text.
ADD string

A string

Adds the character string indicated to the end of the current line.
ADD AND PRINT

AP string

Adds the character string indicated to the end of the current line and
prints the entire line on the terminal.
BEGIN

B[EGIN)

Sets the current line to the line preceding the top line in the file or block
buffer. This command creates a copy of the file when it is invoked in Line
Mode.
BLOCK ON/OFF BL[OCK) [ON) or
BL[OCK) [OFF)

Changes to and from the EDI Block Mode of accessing text.
BOTTOM

BO[TTOM)

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[HANG E] /string1/string2[/]

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

CL[OSE] [fllespec]

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

LINE TEXT EDITOR (EDI) COMMANDS

CLOSE AND DELETE

COL [fllespec)

Transfers the remaining lines in the block buffer and the input files 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 to the character specified. (The
default is &.)
CT RUZ

Closes files and terminates the editing session.
DELETE

D[ELETE) [n) or
D[ELETEJ [·n)

Deletes the current line(s) as specified above and n-1 lines if n is a
positive number. Deletes n lines preceding the current line if n is a
negative number. Negative numbers can only be used in Block Mode.
DELETE AND PRINT

DP [n) or DP [·n)

Deletes the current line and prints the new current line.
E[ND)

END

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

ERASE [n)

Erases the current line in Line Mode.
ESCAPE
or
ALTMODE

Prints the previous line and makes it the new current line.
EXIT

EXIT [lllespec)

Transfers the remaining lines in the block buffer and input file to the out·
put file. Closes files, renames the output file if specified, and terminates
the editing session.

LINE TEXT EDITOR (EDI) COMMANDS

ED [filespec]

EXIT AND DELETE

Transfers the remaining lines in the block buffer and input file to the output file, closes files, renames the output file, and deletes the input file.
FILE

FIL[E] fllespec

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. This command is only
legal in Line Mode.
FIND

[n]F[IND] string

Searches the current block or input file, beginning at the line following
the current line, for the nth occurrence of the string specified. (If n is not
specified, EDI searches for the next occurrence of the string.) Sets the
line pointer to the line it finds. 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[SERT] [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/strlng1/strlng2[/]

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

Ll[ST]

Prints on the terminal all of the lines remaining in the block buffer or input file.
LOCATE

[n]L[OCATE] string

Locates the nth 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.

LINE TEXT EDITOR (EDI) COMMANDS

MACRO CALL

MC[CALL];[n]

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

MACRO EXECUTE

Executes macro x n times, while passing numeric argument a. 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[EXT] [n] or
N[EXT] [·n]

Establishes a new current line n lines away from the current line.
NEXT AND PRINT

NP[n] or
NP[·n]

Establishes and prints a new current line.
OPEN SECONDARY

OP[ENS] filespec

Opens the specified secondary file.
OUTPUT ON/OFF

OU[TPUT] ON or
OU[TPUT] OFF

Enables or disables a file transfer to an output file in Line Mode.
OVERLAY

O[VERLAY] [n]

Deletes n lines, enters Input Mode, and inserts new line(s), as typed, in
place of the deleted lines.
PAGE

PAG[E] n or ·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.
PAGE FIND

[n]PF(IN DJ string

Searches successive blocks for the nth occurrence of the string. A string
must begin in the first column of the line to be a match.
PAGE LOCATE

[n]PL[OCATE] string

Searches successive blocks for the nth occurrence of the string.

LINE TEXT EDITOR (EDI) COMMANDS

PASTE

PA[STE] /string1/string2[/]

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

P[RINT] [n]

Prints the current line and the next n-1 lines on the user's terminal. The
last line printed becomes the new current line.
READ

REA[D] 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[EW] [n]

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

(BIT!

Prints the next line on the terminal and makes it the new current line.
This command also exits from Input Mode if it is typed as the first
character of a line.
RETYPE

R[ETYPE] string

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

SA[VE] [n] [lllespec]

Saves the current line and the next n-1 lines in the specified file.
SEARCH AND CHANGE

SC/strlng1/string2[/]

Locates string 1 and replaces it with string 2.
SELECT PRIMARY

Reestablishes the primary file as an input file.
SELECT SECONDARY

Selects an open secondary file as an input file.
SIZE

SIZEn

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

LINE TEXT EDITOR (EDI) COMMANDS

TA(B] ON or
TA[B] OFF

TAB

Turns automatic tabbing on or off.
T[OP]

TOP

Moves the line pointer to the line preceding the top line of the current
block in Block Mode or to the top of the file in Line Mode. The TOP command creates a new version of the file each time it is executed in Line
Mode.
TOP OF FILE

TOF

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

TY[PE] [n)

Prints 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[AVE) [lilespec]

Inserts all lines from the specified file following the current line. If no file
name is used, EDI looks for a file called SAVE.TMP.
UPPER CASE

UC ON or
UC OFF

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

V[ERIFY] ON or
V[ERIFY] OFF

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

W[RITE]

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

DEC STANDARD EDITOR (EDT) COMMANDS
C[HANGE] [range) [/NL)

Invokes EDT Character Editing Mode, which can be used only on a video
display terminal. (The terminal must also be set to CRT to permit the use
of Character Mode.)
Character Mode allows the following subcommands which, except for
Exit, work the same as they do in Command Mode:
D[ELETE] [range) [/keyword)

Deletes the specified text from a buffer.
E(XITJ [/keyword)

Terminates Character Mode and returns to Command Mode.
l[NSERTJ [range) [/keyword)

Inserts text into the buffer.
QUIT

Terminates EDT operation without creating or modifying any files.
R(EPLACE] [range) [/keyword)

Removes specified text and goes into Insert Mode so replacement text
can be entered.
S(UBSTITUTE/strlng1/strlng2

Replaces the first string of characters with the second.
CTRUZ

Terminates an insert. Returns to Character or Command Mode.
CO[PYJ range-1 %TO range-2 [/keyword)
Keywords:

QUERY
SEQuence:lnitnum:lncr
UNsequenced

Transfers lines from one location to another, at the same time retaining
the lines in their original location.

DEC STANDARD EDITOR (EDT) COMMANDS

D[ELETE] [range) [keyword)

Keywords:

QUERY

'l/t<J/Q./fi(f&.)

Deletes the specified lines from the buffer being edited.
EX[IT] [/keyword)

Keywords:

RE[NAME] filename
SEQ[UENCE]:initnum:incr
UN[SEQUENCED]

Terminates EDT operation and saves the contents of the Main Text
Buffer.
FIND range

Moves the line pointer to the beginning of the specified line.
INC[LUDEJ [range) /Fl:fllename [range) [/keyword)

Keywords:

[SEQ[UENCE]:initnum:incr

Locates a file and copies it into the specified text buffer at the specified
range.
l[NSERT) [range) [/keyword)

Keywords:

SEQ[UENCE]initnum:incr
UN[SEQUENCED]

Places the text that is typed at the terminal into a text buffer.
M[OVE) range-1 % TO range-2 [/keyword)

Keywords:

Q[UERY]
SEQ[UENCE]:initnum:incr

Transfers lines from one location to another and deletes them from the
original location.
PR[INT) [range) /Fl:fllename

Creates a file from the contents of a text buffer. The new file includes as
part of the text the EDT line numbers in the original buffer.
QUIT

Terminates EDT and does not save the contents of any text buffer.

• WJ"UUACt
/'f\ IV\

%IJ/I..( ,.J&J
%rt\~)

%~(W.)

~~) %~~· %,~ '8"I

%Q(li\d)

DEC STANDARD EDITOR (EDT) COMMANDS

R[EPLACE] [range] Ukeyword]

Keywords:

SEQ[UENCE]:initnum:incr
UN[SEQUENCED]

Deletes lines specified and enters Insert Mode so that the lines can be
replaced.
RES[EQUENCE] [range] [/keyword]

Keywords:

SEQ[UENCE]:initnum:incr
UN[SEQUENCED]

Assigns new line numbers to the lines in the current text buffer.
REST[ORE]/Fl:fllename

Locates the file created by an EDT Save command and uses the file to recreate the status of all files and text buffers as they were preserved with
the EDT Save command.
SA[VE]/Fl:filename

Preserves the contents of text buffers and the status of all files used during an EDT editing session in a file which the user names (using the form
filename.SA V).

CA[SE]

{l'~EEld}]
NONE

EXACT Ukeyword]

{ CASE}
NONE
TE[RMINAL] Ukeyword]

SET

{ ~~~~J
VT50
VT52
VT55
VT61
LA30
LA36

Establishes criteria used by other EDT commands to flag upper- or
lowercase characters and to set parameters for the terminal being used.

~
t~s

ljY

~1-¥/fl.Mt~

I cA. tf

DEC STANDARD EDITOR (EDT) COMMANDS

SHOW [/keyword)

Keywords:

BU[FFERS]
CA[SE]
EXACT
TE[RMINAL]
VE[RSION]

Displays buffer and software version information and options established by the SET command.
S[UBSTITUTE)/string1/string2/[range)[/keyword)

Keywords:

BR[IEFJ
O[UERYJ
-T[YPE]

s/01-D

I NfWl%WH
I.

Changes characters within lines of the text buffer.
S[UBSTITUTE] Next

&peats the substitution carried out in the SUBSTITUTE command it
follows.
[TYPE] range

Displays lines of text at the terminal.
WR[ITE] [range)[/keyword]

Keywords:

Fl:filename
SEQ[UENCE]:initnum:incr
UN[SEQUENCED]

Creates a file from the contents of a text buffer.
XEQ range

Executes a sequence of EIYr commands that were previously entered and
stored in a buffer.

PERIPHERAL INTERCHANGE PROGRAM
(PIP) COMMANDS
The default PIP operation (with no switches specified) is to copy files, using
the following format:
outflle =lnflle{s)/subswitches

Creates a copy of a file on the same or another volume.
PIP allows the following parameters for this command:
outfile

If file name, file type, or file version is null or specified by

wildcards, PIP uses input parameters unless it is overruled
by the New Version (/NV) or Successor (/SU) switches.
If the file name, file type, or file version is defined, no other
field can be a wildcard and only one input file can be
specified.

infile

If file name, file type, or file version is null, the default is

•.•;•.

subswitches:
/BL:n

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

/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
more than the current highest version.

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

/SU
APPEND

Copies the output file, superseding the existing output file.
outflle(IFO) = lnflle(s)IAP[/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, owner·
ship is the UIC of the user running PIP.

PERIPHERAL INTERCHANGE PROGRAM
(PIP) COMMANDS

BLOCKSIZE outfile[/BS:n] = infile[/BS:n]

Defines the block size for 7- and 9-track magnetic tape.
CREATION DATE outfile/CD = infile

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.)
DEFAULT [ddn:][g,m]/DF

Changes the PIP default device and/or UFD.
DELETE infile(s)IDE[/LD]

Deletes files. /LD is a subswitch that causes PIP to list the files it deletes.
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 outtile = inlile(s)/EN[/NV]

Enters a synonym for a file in a directory 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

See COPY.

FILE ID /Fl:lilenumber.sequencenumber

Accesses a file by its file identification number (File ID).
FREE [ddn:] /FR

Prints on the terminal the amount of space available on a volume and the

largest block of contiguous space.
IDENTIFICATION /ID

Causes the version number of PIP currently in use to be displayed on the
terminal.

PERIPHERAL INTERCHANGE PROGRAM
(PIP) COMMANDS

LIST llstllle

=lnllle(s)ILl[/subswltch)

Lists the contents of one or more User File Directories, with an option to
specify formats for output directories.
outlile

Listing file specifier; defaults to TI:.

infile

Default is *. *; *.

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

Brief report.

/LI

Limited report.

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

MERGE (CONCATENATE) outlile = infiles/ME[/subswltches)

Creates one file by concatenating two or more files. The fields and
subswitches are the same as for the PIP COPY operation.
NO MESSAGE lnfile(s)INM[/SW)

Causes certain PIP error messages not to be printed, for example, the
message NO SUCH FILE(S). The switches that can be used with the No
Message switch are:
/LI

Lists directory.

/DE

Deletes file(s).

/PU

Purges files.

Any subswitches of these switches can also be used.
PROTECTION symbolic:

inllle/PR:syml>ollc[/FO)
numeric: lnllle/PR:octal value[/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
Owner
Group
World

/SY:RWED
/OW:RWED
/GR:RWED
/WO:RWED

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

PERIPHERAL INTERCHANGE PROGRAM
(PIP) COMMANDS

User Class
System

Owner

Group

World

Prlvllege

w
E
D
R

w
E
D

Octal Code
1
2
4
10
20
40
100
200
400
1000
2000
4000
10000
20000
40000
100000

Bit
0
1
2
3
4
5
6
7

8
9
10
11
12
13
14
15

PURGE lnfile(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.
When :n is specified, PIP deletes all but n latest consecutively numbered
versions. Without :n, PIP deletes all but the latest version.
REMOVE inflle(s) /RM

Removes an entry from a directory file (the opposite of ENTER).
RENAME oulflle

=lnflle(s)IRE{INV]

Changes the name of the file specified. Used with the New Version(/NV)
switch, RENAME creates an output file with a version number 1 higher
than the last version of the file.
outfile

A wildcard (*) or null field assumes the value of the cor·
responding field in the input file.

infile

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

/NV

See COPY.

PERIPHERAL INTERCHANGE PROGRAM
(PIP) COMMANDS

REWIND outfile[/RW]

=inlile[/RW]

outfile

Causes the tape on the specified unit to be erased.

inti le

Causes the tape on the specified unit to be rewound before
the input file is opened.

SELECTIVE DELETE infile(s)ISD

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 outdskvolume:outlile/SB

=inmagvolume:infile

Allows output file records to cross block boundaries when ANSI tapes
are being copied to Files-11 volumes.
SPOOL infile(s)ISP[:n]

Specifies a list of files to be printed (n is the number of copies). This
switch applies only if the user has the Serial Despooler or the Queue
Manager. However. its use with the Queue Manager is not recommended.
SUPERSEDE outfile

=inlile(s)/SU

Copies an input file, superseding an existing output file of the same name
and version number.
USER FILE DIRECTORY ENTRY outlile(s)IUF[/FO] = infile(s)

Creates a User 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. Lets
the user know that the data contained in the file may have been corrupted.
UPDATE FILE outfile = infile(s)IUP[/FO]
Opens an existing file and writes it, from the beginning, into the output
file.
outfile

Must be explicitly identified.

infile

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

lf${V) MSIC..

INFO

~ D.. (-1) ~

~~Q(o) ~
flVw.t..w.. JY\a.AJJJ ~/ ~
~ ~$ (IJ-?)1'¢ 11 clhi.U.(IS)j ~ ~

!({)1~~A?d pi_uJt :j'lJ)vlA I) ;M,OJ.c
/PP 1' ""co~

ON·LINE DEBUGGING TOOL (ODn 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
Relocatable 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)

I
%

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 lif so
directed). The terminators are:
Return

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

Opens the next sequential location and prints its contents.

ON-LINE DEBUGGING TOOL (ODT) COMMANDS

Circumflex (A) or up-arrow ( t)

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

•

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
relocatable base address for the applicable program section or object
module. 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 (SF) 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 is taken as 0 when an offset is established. The
registers initially contain -1, the nonactive state.

ON-LINE DEBUGGING TOOL (ODTI COMMANDS

Establishing Relocatable Address Offsets

value;nR

Value replaces current contents of relocation register n.

n,value;nR

Value is added to (subtracted from) current contents of
relocation register n.

$nR/

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

r,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. (SB 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 gpecified address.
Removing Breakpoints
B

Removes all inserted breakpoints.

Removes only breakpoint n.

Moving Breakpoints

r,address;nB Moves breakpoint n to new address, overriding previous
address.
Report of Breakpoint Occurrence

nB:r,address Reports address at which breakpoint n suspended task
execution.

ON-LINE DEBUGGING TOOL !ODT) COMMANDS

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

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 suspension, and continues to a breakpoint or completion.

Resumes task execution from current breakpoint suspension, 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
nS

Executes PC-addressed instruction, suspends task, and
prints address of next instruction.
Executes next n instructions, suspends task, and prints ad-

dress of next instruction.
BB:r,address Specifies the next instruction's address.

ON-LINE DEBUGGING TOOL (ODT) COMMANDS

FILL MEMORY BLOCK· 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.
The following sequence establishes the address reference, which can be in
relative or absolute form:
$L (or $H)/contents new-address terminator
value F

Places a value in search argument register ($A) and/or
enters 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.

LIST MEMORY BLOCK· L COMMAND
L

Prints memory locations within specified address limits on
console listing device (CL:).

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

a;L

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

a;kL

Uses address values a and k as beginning and ending addresses and initiates listing operation.

n;a;kL

All listing control arguments are specified in a single listing
command; n is the L UN register containing the address of
the listing device.

CALCULATING OFFSETS· 0 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 Sp11clfied Addresses
address;addressO pc-rel> branch
Example: 16126;161340 000004 >000002

ON-LINE DEBUGGING TOOL (ODT) COMMANDS

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. $Cl prints current contents.
New value typed before !Brn replaces contents.
Q Quantity Register

Always contains the last value printed for reference as "Q" in address or
new value expressions.
PROCESSOR STATUS WORD
$SI

Displays the task Processor Status Word (PSW). The new value typed
before the terminator replaces the old PSW contents.
DIRECTIVE STATUS WORD
SW/

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.
Equals address of the last explicitly opened location.
Calculates the 16-bit value (positive or 2's complement) of
the preceding argument string, prints it as 6 octal digits,
and stores it in Q. Arguments can be signed or unsigned oc·
tal values, or relocatable address expressions, or any valid

ODT expression.
TERMINATING ODT SESSION

Terminates ODT and returns control to the system
monitor.

For additional information, refer to the IASIRSX-11 ODT Reference Manual

ERROR LOGGING
The error logging subsystem formats and generates reports on hardware
reliability and the system configuration for an RSX-UM system. Error logging must be generated into the system before the user can invoke any of the
error logging tasks (ERRLOG, PSE, SYE, or ERF). After error logging is activated, its operation is transparent to the system user until the reports it
generates are needed.
In this section, red type indicates user input.
Tb activate error logging, enter the following commands from a privileged ter-

minal:
>INS $ERL
>RUN ERRLOG

To install and run the preformatter task (PSE), enter the following command
from a privileged terminal:
INS $PSE

Then enter the following commands from any terminal:
>PSE
PSE>~

The defaults are:
SY:[1,6]ERROR.SYS = SY:[1,6]ERROR.TMP;•

or
PSE > outdev:[UFD]filename.filetype = inputfile
(assumes input file is [1,6] ERROR.TMP;•)
PSE > (CTRL/Z)

Note that PSE cannot be run with the RUN $PSE command format.
To install and run SYE, type the following command from any terminal:
>RUN $SYE
SYE > outdev:[UFD]filnam.type = indev:[UFD]filnam.type/options

The defaults are:
SY:[user UIC] ERRLOG.LST=SY:[1,6] ERROR.SYS/-RP

ERROR LOGGING

Report options allow the user to select additional error reports to supplement
the summary reports (SYE always produces summary error reports) and to
specify a time frame for the report.
Report Option
Switch

/RP[:class]

Description
Requests individual error reports; the class parameter
is used to specify a general classification of errors to be
reported. If no class parameter is specified with the RP
switch, SYE reports on all classes.

Class has one of the following values:
null

All classes.
SYS[:type]

All system entries (including error logging start
up and PSE entries), which are significant to
DIG ITAL service groups, such as Field Service
or Software Support.
Type is one of the following:
NULL
PSE
STA
MOU
TIM
MSG

All types of system entries
Entries from PSE operation
Error logging start up
Device mounts and dismounts
System time changes
System Service Message

HOW[:type]

All hardware errors. When class is HDW, an
additional parameter can be specified, further
defining the errors to be reported. This parameter takes the form:
/RP:HOW[:type]

Type is one of the following:
NULL
OSK
MAG
M EM

All types of hardware errors
All disk errors
All magnetic tape and DECtape errors
All cache and main memory parity errors

TMO/[:type]

Interrupt timeout errors from disks and tapes.
Type is one of the following:
OSK
MAG

Disk information only
Magnetic tape information only

ERROR LOGGING

Report Option
Switch

Description

/SU

Creates summary report

/QU

Creates short (quick) summary report

/·RP or /NORP

Does not include individual error reports. SYE pro·
duces a summary report only. /·RP is the default.

/DV:dev[n]

Includes in the report only those errors that occurred
on a specified device type or on a specified device unit.

/BEG:time-and·date

Includes in the report only errors logged after the
specified time and date. The format of the time-and·
date parameter is:
dd·mon-yr:hr:mi:se

All the numbers are decimal and leading zeros are not
required. Null equals zero. The field terminator(:) must
be entered for a null field. The hours (hr) field is based
on a 24-hour clock.
/END:time-and-date

Includes in the report only errors logged prior to the
specified time and date. The format of the time and
date parameter is:
dd·mon-yr:hr:mi:se

All the numbers are decimal and leading zeros are not
required. Null equals zero. The field terminator(:) must
be entered for a null field. The hours (hr) field is based
on a 24-hour clock.
/HELP

Causes SYE to display SYE operating instructions. To
obtain this information, the user specifies /HELP in
response to the SYE prompt as follows:
SYE>!HELP

/SP

001

Spools the output file. This is the default SYE
operation.

To terminate Error Logging, run the Error Log Finish (ERF) task by entering

the following command from a privileged terminal:
>INS $ERF
>ERF 001

001

For additional information, refer to the RSX-llMIM-PLUS Error Logging
Reference Manual.
37

1/0 ERROR CODES
The table below lists RSX-UM 1/0 error codes. Partial abbreviations are
listed; the complete abbreviation is IE.xxx. The octal number listed is the loworder byte of the complete word value (2' s complement of the decimal number).

Abbreviation

.BAD
.IFC
.DNA
.VER
.ONP
.SPC
.DNA
.DAA
.DUN
.EOF
.EOV
.WLK
.DAO
.SAE
.ABO
.PAI
.RSU
.OVA
.BYT
.BLK
.MOD
.CON
.NOD
.DFU
.IFU
.NSF
.LCK
.HFU
.WAC
.CKS
.WAT
.REA

Error
Decimal

Number
Octal

- 1
- 2
- 3
- 4
- 5
. 6
• 7
• 8
. 9
·10
-11
·12
-13
-14
·15
-16

377
376
375
374
373
372
371
370
367
366
365
384
363
362
361
360
357
356
355
354
353
352
351
350
347
346
345
344
343
342
341
340

·17
-18
-19
-20
-21
·22
-23
-24
-25
-26
-27
·28
-29
-30

-31
-32

Meaning

Bad parameters
Invalid function code
Device not ready
Parity error on device
Hardware option not present
Illegal user buffer
Device not attached
Device already attached
Device not attachable
End-of-file detected
End-of-volume detected
Write attempted to locked unit
Data overrun
Send/receive failure
Request terminated
Privilege violation
Shareable resource in use
Illegal overlay request
Odd byte count (or virtual address)
Logical Block Number too large
Invalid UDC module number
UDC connect error
System dynamic memory
Device full
Index file full
No such file
Locked from read/write access
File beader full
Accessed for write
File header checksum failure
Attribute control list format error
File processor device read error

IIO ERROR CODES

Error
Decimal

Number
Octal
337
336
335
334
333
332
331
330

File processor device write error

.NLN
.CLO
.NBF
.RBG

-33
-34
-35
-36
-37
-38
-39
-40

.NBK
.ILL

-41
-42

327
326

.BTP
.RAC
.RAT
.RCN
.ICE
.2DV

-43
-44
-45
-46
-47
-48

325
324
323
322
321
320

File exceeds space allocated, no blocks
Illegal operation on file descriptor
block
Bad record type
Illegal record access bits set
Illegal record attribute bits set
Illegal record number-too large

.FEX

-49

317

.BDR
.RNM
.BDI
.FOP
.BNM
.BDV
.BBE

-50
-51
-52
-53
-54
-55
-56

316
315
314
313
312
311
310

.DUP
.STK
.FHE
.NFI
.ISO
.EOT
.BVR
.BHD
.OFL
.BCC
.ONL
.NNN
.NFW
.BLB
.TMM
.NDR

-57
-58
-59
-60
-61
-62
-63
-64

307
306
305
304
303
302
301
300

-65
-66
-67
-68
-69
-70
-71
-72

277
276
275
274
273
272
271
270

Abbreviation

.WER
.ALN
.SNC

.soc

Meaning

File already accessed on L UN
File ID, file number check
File ID, sequence number check
No file accessed on L UN
File was not properly closed
No buffer space available for file
Illegal record size

Internal consistency error

Rename-2 different devices
Rename-a new file name already in
use
Bad directory file
Cannot rename old file system
Bad directory syntax
File already open
Bad file name
Bad device name
Bad block on device
Enter-duplicate entry in directory
Not enough stack space (FCS or FCP)
Fatal hardware error on device

File ID was not specified
Illegal sequential operation
End-of-tape detected
Bad version number

Bad file header
Device offline
Block check, CRC, or framing error
Device online
No such node
Path lost to partner
Bad logical buffer
Too many outstanding messages
No dynamic space available

110 ERROR CODES

Abbreviation

Error
Decimal

Number
Octal

.BTF
.NNC
.NNL
.NLK

-76
-77
-78
-79

264
263
262
261

.NST
.AST

-80
-80

260
260

.FLN

-81

257

.IES
.PES
.ALC
.ULK
.WCK

-82
-83
-84
-85
-86

256
255
254
253
252

Meaning

Bad tape format
Not ANSI "D" format byte count
Not a network LUN
Task not linked to specified ICS/ICR
interrupts
Specified task not installed
No AST specified in connect
Device offline when offline request was
issued
Invalid escape sequence
Partial escape sequence
Allocation failure
Unlock error
Write check failure

For additional information, refer to the IASIRSX-11 110 Operations Reference
Manual.

DIRECTIVE ERROR CODES
Directives in the directive statns word ($DSW) return the following error
codes. The complete abbreviation for these codes is IE.xxx. Only partial abbreviations (xxx) are included on this list. The octal error number listed is the
low-order byte of the complete word value (2's complement of the decimal).

Abbreviation

.UPN
.INS
.PTS
.UNS
.ULN
.HWR
.ACT
.ITS
.FIX
.CKP
.TCH

.RBS
.PRI
.RSU
.NSW
.ILV

Error
Decimal

Number
Octal

1
2
3
4
5
6
7
8
9
·10
-11
-12

377
376
375
374
373
372
371
370
367
366
365

-14
-15
·16
·17
·18
-19

.ITP
.IBS

.79
-80
·81
·82
-83
·84
-85
-86
-87
-88
-89

.LNL
.IUI

-90
-91

.AST
.MAP
.IOP
.ALG

.wov
.NVR
.NVW

Meaning

Insufficient dynamic storage
Specified task not installed
Partition too small for task
Insufficient dynamic storage for send
Unassigned LUN
Device driver not resident
Task not active
Directive inconsistent with task state
Task already fixed/unfixed
Issuing task not checkpointable
Task is checkpointable
(reserved)

361
320
357
356
355

(reserved)
Receive buffer is too small
Privilege violation
Resource in use
No swap space available
Illegal vector specified

260
257
256
255
254
253
252

(reserved)
Directive issuedlnot issued from AST
Illegal mapping specified
(reserved)
Window has I/O in progress
Alignment error
Address window allocation overflow
Invalid region ID

251

Invalid address window ID

250
247

Invalid TI parameter
Invalid send buffer size (greater than
255)
LUN locked in use
Invalid UIC

246
245

DIRECTIVE ERROR CODES

Abbreviation

Error
Decimal

Number
Octal

.IDU
.ITI
.PNS
.IPR
.ILU
.IEF
.ADP
.SDP

-92
-93
-94
-95
-96
-97
-98
-99

244
243
242
241
240
237
236
235

Meaning

Invalid device or unit
Invalid time parameters
Partition/region not in system
Invalid priority (greater than 250)
Invalid LUN
Invalid event flag (greater than 64)
Part of DPB out of user's space
DIC or DPB size invalid

For additional information, refer to the RSX-llMIM-PLUS Executive
Reference Manual.

TASK BUILDER (TKB) SWITCHES AND OPTIONS
In this section, red type indicates user input.
The format for Task Builder commands is:
>TKB
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:
TKB >option name= argument(s)
TKB >II (to end Task Builder operation)
or
TKB >/(if you have another task to build)

The Task Builder file specification is:
filespec = dev:[g,m]filename.typ; version/switch(es)
defaults= SY: [uic]filename.typ;n/switch

The Task Builder uses the following default file types for the files named:
Task Image File
Memory Allocation File
Symbol Definition File
Object Module
Overlay Description
Indirect Command
Object Module Library

.TSK
.MAP
.STB
.OBJ
.ODL
.CMD
.OLB

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.

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.
[T]
[M]
[S]
[I]

Task Image
Task Builder Map
Symbol Definition
Input

(.TSK)
(.MAP)
(.STB)

(.OBJ, .OLB, .ODL, .CMD)

The default value for switches is negative (·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 checkpoint 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 over·
rides /CC if it is applied to the same file. (Default is /CC.) [T]
/CM

Specifies a compatability mode resident overlay structure. (Overlay
segments are aligned on 256-word physical boundaries.) [T]
/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 IAL.) [T]
/CR

Appends a global cross-reference listing to the 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]

TASK BUIWER (TKB) SWITCHES AND OPTIONS

/DL

Specifies a default library file 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]
/EA

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

Specifies that the task used 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]
/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-l:mod-2 .....] TKB inserts only the modules
named in the command into the task image. [I]
/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

Specifies that the system has memory management hardware. (Defaults
to /MM if host system has memory management, or to /-MM if it does
not.) [T]

TASK BUILDER (TKB) SWITCHES AND OPTIONS

/MP

Specifies that the input file describes the task's overlay (tree) structure.
[I]

/Pl
Specifies that only position-independent code or data is in the shareable
global area. [T, S]
/PM

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

/PR:n
Specifies that the task has privileged access. I 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 (IMP). (Default is /RO.) [T]
/SE

Specifies that the task can receive messages by means of the Executive
SEND directive. (Default is /SE.) [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]

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/O 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. [I]
/TR

Specifies that the task can be traced. [T]

/WI
Lists the memory-allocation file in 132-column (wide) format. (Default is
/WI.) [M]
/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
[H]

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

Option is of interest to MACR0-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 $).
ABORT=n

Terminates the current task-build operation and restarts the Task
Builder for another. (Then satisfies the option syntax; it means nothing.)
[H,M]

TASK BUILDER (TKB) SWITCHES AND OPTIONS

ABSPAT = segname:address:value1 ...:values

Patches the task image from its absolute address through 8 words. [M]
ACTFIL = fllemax (decimal Integer)

Specifies the number of files that a task can have open simultaneously
(the default is 4). [HJ
ASG = devicename:un1 ...:un8

Assigns logical unit numberis) in decimal to specified physical device(s).
[H,M]
COMMON = name:access-code[:apr]

Declares that the task will access a system-owned resident common area.
[H,M]

CMPRT=name

Identifies the completion routine in a supervisor-mode library. [M]
EXTSCT = psectname:extension

If the program section has the concatenated attribute, this option ex·

tends the size of the named program section by the number of octal bytes
specified in the extension. If the program section has the overlay at·
tribute, it is extended only if the extension value exceeds the length of
the section. [H, M]
EXTTSK=n

Extends the task memory allocation by the length n (in decimal words)
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 for·
mat 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]

TASK BUILDER (TKB) SWITCHES AND OPTIONS

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 8 words. All values are octal.
[M]·
G BLREF = symbol-name:symbol-value

Declares the named symbol as a global symbol reference originating in
the root segment of the task. [H, M]
GBLXCL = symbolname:symbolname: ... :symbolname

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

Declares that the task will access a system-owned resident library. [H, M]
MAXBU F =max-record

Specifies the maximum allowable record buffer size (in decimal bytes) in
any file processed by the task. [H]
ODTV = symbol·name:vector·length

Declares the named global symbol to be the address of the 0 DT syn·
chronous 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 im·
plies a user-controlled partition. Base and length do not have to be ex·
pressed 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 = fllespec/access·code[:apr]

Declares that the task will access a user·owned resident common. [H, M]

TASK BUILDER (TKB) SWITCHES AND OPTIONS

RESLIB = filespec/access-code[:apr]

Declares that the task will access a user·owned resident library. [H, M]
RESSUP = filespec/[·]SV[:apr]

Specifies that the task will access a resident supervisor-mode library.
[H,M]
ROPAR = parname

Specifies the partition in which the read·only portion of a multiuser task
resides. [H, M]
STACK =stack-size

Establishes the maximum size of the stack available to the task. The
default is 256 bytes. [H, M]
SUPLIB = name:[·]SV[:apr]

Specifies that the task will access a system-owned resident supervisormode library. [H, M]
TASK= taskname

Names the task. [H, M]
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]

TASK BUILDER (TKBJ SWITCHES AND OPTIONS

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 the task will use. [H, M]

ASCII CHARACTER SET
Octal
Octal
Code Character Code Character
040
SP
NUL
000
041
SOH
001
042
STX
002
ETX
043
#
003
EOT
044
$
004
045
%
ENO
005
046
ACK
&
006
047
BEL
007
050
010
BS
HT
051
011
LF
052
012
VT
053
013
+
FF
054
014
CR
055
015
016
so
056
SI_
057
017
I
OLE
060
0
020
DC1
061
1
021
062
2
022
DC2
DC3
063
3
023
DC4
064
4
024
NAK
065
5
025
SYN
066
6
026
7
027
ETB
067
070
CAN
8
030
071
031
EM
9
072
SUB
032
ESC
073
033
074
FS
034
<
GS
075
035
RS
076
036
>
?
037
us
077

Octal
Octal
Code Character Code Character
100
101
102
103
104
105
106
107
110
111
112
113
114
115
116
117
120
121
122
123
124
125
126
127
130
131
132
133
134
135
136
137

A
B

c
D
E
F
G
H
I
J
K
L
M
N

0
p
Q
R

s
T

v
w
x
y
z
[
\

140
141
142
143
144
145
146
147
150
151
152
153
154
155
156
157
160
161
162
163
164
165
166
167
170
171
172
173
174
175
176
177

b
c
d
e

I
g
h

j
k
I
m
n
0

p
q
r

s
t
u
v
w
x
y

z
{

I
}

DEL

*Equivalent to the Radix-50 character set.

RADIX-50 CONVERSION TABLE
To convert one to three characters to their Radix-50, 6-digit octal equivalent,
add the appropriate octal codes from the following table, based on the positions of the characters in the string (that is, first, second, or third).

Character
Set

Space
A
B

D
E

F
G

H
I

J
K
L
M
N

0
p
Q

s
T

w
x
y

z
$

Unused

0
1
2

First
Character
Code

Second
Character
Code

Third
Character
Code

000000
003100
006200
011300
014400
017500
022600
025700
031000
034100
037200
042300
045400
050500
053600
056700
062000
065100
070200
073300
076400
101500
104600
107700
113000
116100
121200
124300
127400

000000
000050
000120
000170
000240
000310
000360
000430
000500
000550
000620
000670
000740
001010
001060
001130
001200
001250
001320
001370
001440
001510
001560
001630
001700
001750
002020
002070
002140

000000
000001
000002
000003
000004
000005
000006
000007
000010
000011
000012
000013
000014
000015
000016
000017
000020
000021
000022
000023
000024
000025
000026
000027
000030
000031
000032
000033
000034

132500
135600
140700
144000

002210
002260
002330
002400

000035
000036
000037
000040
57

RADIX-50 CONVERSION TABLE

Character
Set

First
Character
Code

Second
Character
Code

Third
Character
Code

3
4
5
6
7
8
9

147100
152200
155300
160400
163500
166600
171700

002450
002520
002570
002640
002710
002760
003030

000041
000042
000043
000044
000045
000046
000047

OCTAL/DECIMAL CONVERSION TABLE
Bits

Octal

Decimal

100000
0
70000
60000
50000
40000
30000
20000
10000
0
7000
6000
5000
4000
3000
2000
1000
0
700
600
500
400
300
200
100
0
70
60
50
40
30
20
10
0
7
6
5
4
3
2
1
0

32768
0
28672
24576
20480
16384
12288
8192
4096
0
3584
3072
2560
2048
1536
1024
512
0
448
384
328
256
192
128
64
0
56
48
40
32
24
16
8
0
7
6
5
4
3
2
1
0

14
13
12

11
10
9

8
7
6

5
4
3

2
1
0

Octal to Decimal

For each position of the octal value,
locate the octal digit and its decimal
equivalent in the conversion table. Add
the decimal equivalents to obtain the
decimal value.
Exall)ple:
53702(8) = ?(10)
n(8)
n(10)
50000
= 20480
3000
1536
700
488
00
00
2
=-----1
53702(8) = 22466(10)

Decimal to Octal

Locate in the conversion table the
~cimal value closest to, hut not exceeding, the decimal value to be converted. Record the octal equivalent.
Subtract the table decimal value from
the decimal value to be converted.
Repeat the process until the subtraction balance equals 0. Add the octal
equivalents to obtain the octal value.
Example:

22466(10) =
n(10) =

20480

50000

1536

3000

448
__
2_
22466(10) =

700
__
2_
53702(8) =

?(8)
n(8)
22466
-20480
1986
-1536
450
-448
2

-----=1
0

STANDARD FILE TYPES
RSX-HM uses the standard 3-letter file types used by all DIGITAL-supplied
software. These names indicate the actual contents of the files. Although any
combination of three letters can be used, DIGITAL recommends that the
standard 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

Fiie Contents

.BAS
.B2S
.CBL
.CMD
.COR
.DAT

A BASIC-11 language source program
A BASIC-PLUS-II language source program
A COBOL language source program
MCR or task commands (an indirect command file)
A SLP correction file
Data (as opposed to a program)
A directory (for example, a User File Directory)
A RUNOFF output file
A FORTRAN-IV PLUS language source program
A FORTRAN-IV language source program
A listing file
A MACR0-11 source program
A Task Builder memory allocation map
A macro library
A FORTRAN run-time error message file
An object program (output from either the MACR0-11 Assembler
or a compiler)
A Task Builder overlay descriptor
An object module library
A RUNOFF input file
The system macro library
A bootable system image
A temporary file
A task image file
A text file
A universal file library

.DIR

.DOC
.F4P
.FTN

.LST
.MAC
.MAP
.MLB
.MSG
.OBJ
.ODL
.OLB
.ANO

.SML
.SYS

.TMP
.TSK
.TXT
.ULB