Digital PDFs

AA-DO37A-TE

August 1978

196 pages

Original

7.7MB

view download

OCR Version

7.1MB

view download

Document:	VAX-11/RSX-11M User's Guide
Order Number:	AA-DO37A-TE
Revision:	0
Pages:	196
Original Filename:

OCR Text

August 1978
This document provides the information needed to use the VAX/VMS

MCR command language, execute MCR indirect command files, and use
RSX-11M Version 3.1 components under VAX/VMS.

VAX-11/RSX-11M
User’s Guide
Order No. AA-DO37A-TE

SUPERSESSION/UPDATE INFORMATION:

This is a new document for this release.

OPERATING SYSTEM AND VERSION:

VAX/VMS V01

SOFTWARE VERSION:

VAX/VMS V01

To order additional copies of this document, contact the Software Distribution

Center, Digital Equipment Corporation, Maynard, Massachusetts 01754

digital equipment corporation - maynard. massachusetts

First Printing,

August 1978

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 postage-prepaid READER'S COMMENTS form on the last page of this
document requests the user's critical evaluation to assist us in preparing future documentation.

The following are trademarks

of bigital Equipment Corporation:

DIGITAL

DECsystem~10

DEC

DECtape

OMNIBUS

PDP

DIBOL

0s/8

DECUS

EDUSYSTEM

PHA

UNIBUS

FLIP

RSTS

COMPUTER LABS

FOCAL

RSX

COMTEX

INDAC

DDT

ASSIST-11

LAB-8
DECSYSTEM-20
RTS-8

TYPESET-8
TYPESET-11
TMS-11
ITPS-10

VAX

VMS

SBI

DECnet

IAS

DECCOMM

CHIP

6/79-14

MASSBUS

CONTENTS

Page
PREFACE

CHAPTER

vii

INTRODUCTION

1.1

WHAT

1.1.1

1.2

1-1

for

RSX-11M Image

Execution
RSX-11M PROGRAM DEVELOPMENT

WHAT

1-2
TOOLS

AVAILABLE?

1-2

1.3
1.4
1.5
1.6

Standard Utilities and Files Provided
with VAX/VMS
Additional Utilities and Programs
FILES~11
FCS AND RMS-11 UNDER VAX/VMS
SUPPORT OF RSX-11M DIRECTIVES
SUMMARY OF COMMANDS

1-2
1-3
1-3
1-4
1-4
1-4

VAX/VMS

ENVIRONMENT

2-1

2.1

PROCESS

AND

2-1

1.2.2

CHAPTER

RUN?

Requirements

ARE

1.2.1

IMAGES

1-1

IMAGE

2,1.1
2.1.2

Process and Image versus Task
Login Process, Detached Process,

2,1.3

Subprocess
Process Name

2.1.4
2.2

2.2.1
2.2.2

2-1
or
2-2
2=2

Process Identification
USER AUTHORIZATION FILE

VAX/VMS UICs
Privileges

2-2
2-3

and Protection

2-3
2-4

2.2.3
2.3

Process Priority
FILE SPECIFICATIONS

2-5
2-5

2.3.1
2.3.2
2.3.3
2.3.4
2.4

Device Names
Directory Names
Version Numbers
Defaults in File
LOGICAL NAMES

2-6
2-7
2-8
2-8
2-10

2.4.1
2.4.2
2.4.3
2.4.4
2.5
2.5.1

Process Logical Name Table
Group Logical Name Table
System Logical Name Table
System-Defined Logical Names
DEVICE MAPPING
Mapping RSX-11M Pseudo-Device Names

2.5.2

Mapping

Specification

RSX-11M Physical

2.6

TERMINAL FUNCTIONS

2.7
2.7.1

SYNTAX RULES
Continuing

Device

Names

2-15
Commands

on More

than One

Line

2-15

Commenting

Command Lines

2.7.3

Truncating

Command Names

2.7.4
2.7.5

Placement of Keywords
Specifying File Protection

2.8

2-13

2.7.2

2.7.6

2-10
2-10
2-11
2-11
2-12
2-12

Entering Dates and Times
ERROR MESSAGES

and Keywords

2-16
2-16

2-16
2-17

2-18
2-20

iii

CONTENTS

(Cont.)

Execution on RSX-11M

>
W N |- o

o
I
R
S
N
R

WD o e RFHEWOWOSAAUTd

-9

MCR COMMANDS

4.15
4.16

4.17
4.18
4.19
4,20
4,21
4.22
4,22.1
4,22.2
4,23
4.24
4,25
4.26
4.26.1
4.26.2
4.26.3

4.26.4

ALLOCATE DEVICE
APPEND

ASSIGN
BYE

CANCEL

CONT INUE
COPY

DEALLOCATE
DEBUG

DELETE
DEPOSIT

DIRECTORY
DISMOUNT
EXAMINE

EXECUTE PROCEDURE

(@)

EXIT
INITIALIZE

LINK
LOGIN

PROCEDURE

LoGcouT
MOUNT

Building RSX-11M Images on VAX/VMS for

CHAPTER

Using VAX/VMS Components
EXECUTING RSX-11M INDIRECT COMMAND FILES
BUILDING RSX-11lM IMAGES FOR EXECUTION
UNDER VAX/VMS
Task Builder Switches
Task Builder Options
Noncontiguous Image Files

STATEMENT

On Control Y
On Severity-level

PRINT
PURGE
RUN

SET

Set Card Reader
Set Control Y
Set Default
Set Magtape

T
T

Using RSX-11M Components
Using FLX

PROGRAM DEVELOPMENT UNDER VAX/VMS

IMAGES

Selecting a Command Interpreter
LOGIN.CMD File
PREPARING TO RUN AN IMAGE
Allocating Devices
Mounting Volumes
Assigning Logical Names
Installing RSX-11M Images

LOGGING INTO VAX/VMS

RUNNING

HFHEFOYJOOOULB_WNDNDDNDDND
K

USING VAX/VMS MCR

CHAPTER

WWWWwWwWwWwwwwwwww

Page

CONTENTS

Set

Process

(Cont.)

Set Protection
Set

Queue

Set
Set
Set
Set
Set

RMS Default
Terminal
Default UIC
Verify
Working Set

SHOW

Show Daytime
Show Default

Show
Show
Show
Show
Show

Devices
Logical
Magtape
Network
Printer

Show Process

Show
Show
Show
Show

Protection
Queue
RMS Default
Status

Show

Symbols

Show System
Show Terminal
Show Translation

Show Working Set
STOP

SUBMIT
TIME

TYPE

REQUESTING

INDIRECT

SUPPORT

.IFINS,

SUPPORT

.ENABLE AND

UNSUPPORTED
N

FILES

COMMAND

.IFACT,

FILE

AND

.DISABLE

EXECUTION

.IFLOA
ESCAPE

DIRECTIVES

.XQT and .WAIT Alternative
.ONERR Alternative
SWITCHES
SPECIAL

SYMBOLS

NUMERIC

SYMBOLS

LABEL

TABLE

ENTRIES

SYSSINPUT AND
.ASKN

SYSSCOMMAND

DIRECTIVE

.ENABLE

DOLLARS

.PAUSE

DIRECTIVE

.DELAY

DIRECTIVE

NESTING MCR
LEXICAL

DIRECTIVE

INDIRECT

COMMAND

FILES

FUNCTIONS

OPERATIONAL NOTES

5.17.1
5.17.2

COMMAND

RSX~-11M AND RSX-11S SYSTEM GENERATION
Creation of an Unprotected Disk
Pre-System Generation Indirect Command
File

HHEOWOYONNNINOAOO
O

INDIRECT

U101UIU1U'IU1({IU1U'IU1U'IU1(J1(J1
[
I
I
|
[
I
N
O
I

CHAPTER

UFD

CONTENTS

(Cont.)

Page

APPENDIX A

PRIVILEGES

A-1

APPENDIX B

RESOURCE

B-1

QUOTAS AND LIMITS

FIGURES

FIGURE

2-1

3-1

5-1

Format of VAX/VMS UICs
RSX-11M and VAX/VMS Program Development
Cycles Using VAX/VMS MCR
Pre-System Generation Indirect Command

2-3

File

5-15

3-7

HOUE W
WNhHFHWNDH

TABLE

(?JNNIT)NNI-‘

TABLES

Summary of MCR Commands
VAX/VMS Device Types
File Specification Defaults
Default File Types
Mapping of RSX-11M Pseudo-Device Names
Terminal Function Keys
Task Builder Switches Valid for RSX-11M
Images under VAX/VMS
Set Command Options
Default Characteristics for Terminals
SHOW Command Options
Indirect Command Files
Special Symbols

Summary of Lexical Functions

5-12

PREFACE

MANUAL

OBJECTIVES

The VAX-11/RSX-11M User's Guide provides the information needed to use
the
VAX/VMS MCR command language, execute MCR indirect command files,
and use RSX-11M Version 3.1 components (for example, the task builder)
under
VAX/VMS.
The information in this document is intended to allow
RSX-11M users to operate in a familiar environment, while at the
same
time
encourage
Language (DCL),

users
to
make the transition to the
the primary VAX/VMS command language.

DIGITAL

Command

INTENDED AUDIENCE

This manual contains the information that an RSX-11lM user needs to run
existing
RSX-11M
Version
3.1
images and native VAX-1ll images under
VAX/VMS, and to develop both RSX-11lM and native
VAX-1ll
images
using
the VAX/VMS MCR command language.
This document has
two
prerequisites:
a
general
understanding
RSX-11M
and
an understanding of the material presented in either
VAX/VMS Summary Description or the VAX-11/780 Technical Summary.

STRUCTURE OF THIS

Information

of
the

DOCUMENT

this

document

organized

follows.

Chapter 1 describes the
images
under
VAX/VMS
available under VAX/VMS.

Chapter 2 discusses the environment provided by
VAX/VMS,
describes command language features and syntax rules.

Chapter 3 describes how to
1log
into
the
system,
select
a
command
interpreter,
prepare
images for execution, run user
images (both RSX-11lM and VAX-11l), and use RSX-11M and
VAX/VMS
components

for

RSX-11lM

requirements
and
1lists

and

VAX-1ll

Chapter

describes

the VAX/VMS

MCR

Chapter

describes

the

MCR

commands

an RSX-11M/S

Appendix
resource

privileges,
quotas.

vii

directives

information on performing
VAX/VMS as a host system.
A describes user
usage limits and

executing
RSX-11M
RSX-11M
components

and

program development.

VAX/VMS

for
the

detail.
and

provides

system generation

and

Appendix

using

describes

ASSOCIATED DOCUMENTS

The

following additional

documents may also be

useful.

VAX-11]

Information Directory

VAX-11/RSX-11M Programmer's Reference Manual

VAX/VMS Primer

VAX/VMS

Command

Language

User's Guide

Of the documents listed above, the
VAX/VMS
Command
Language
User's
Guide
provides
the
most useful additional information.
The VAX/VMS

MCR command language has many features
in
common
with
the
primary
VAX/VMS
command
language,
DCL.
The
VAX-11/RSX-11
User's
Guide
describes these features to the extent needed to perform
the
VAX/VMS
equivalent
of
normal
RSX-11lM
functions.
You
can
learn
about

additional capabilities available with MCR by reading Part
Command Language User's Guide.

the

VAX/VMS

CONVENTIONS

USED

THIS DOCUMENT

In the command
and
directive
descriptions
in
Chapters
4
and
5,
respectively,
square
brackets
([
})
indicate
optional
syntax.
Brackets that are part of directory names, however,
do
not
indicate
optional
syntax.
1In addition, certain MCR directives use brackets as
part of their required syntax;
these cases are noted in the text.

viii

CHAPTER

INTRODUCTION

VAX/VMS
the

provides

two command

languages you

can

use

interface

with

system:
e

DIGITAL

Primer
®

MCR

command

and

language

the VAX/VMS

command

language,

(DCL),

Command
as

described

this

command

language

consists

Those

that

duplicate

Those

that

provide

VAX/VMS

Because of
range
of

language

1.1

MCR

IMAGES

3.1

two

types

commands:

command

function

using

MCR-like

needed

to
DCL

syntax

a
full
command

functions.

RUN?

MCR provides

Version

RSX-11M

the
VAX/VMS
transition to
and
indirect
system as the

types of commands, MCR
allows
access
functions.
You need not change to the

to perform commonly

WHAT

VAX/VMS

the two
VAX/VMS

VAX/VMS

document

The VAX/VMS MCR command language is an integral part
of
operating
system.
It allows RSX-11lM users to make the
VAX/VMS using a familiar command language.
VAX/VMS MCR
command
file
capability also permit use of the VAX/VMS
host for RSX-11M/S Version 3.1 system generation.
The VAX/VMS

the

Language User's Guide

task

the

tools

images

means

needed

to develop and

run

both

and native VAX-1ll images.
This
applications gradually convert

RSX-11M

capability
to
native

that, as user-written
mode, applications consisting of both RSX-11lM and native images can
handled using one command language.
Both types of images can also
run from one indirect command file using MCR.

VAX/VMS

using

places no restrictions on the native images that you
MCR;
the system manager imposes any restrictions that

a user-by-user
basis.
The
VAX-11/780
processor
and
the
operating
system
impose
restrictions on the RSX-11M images
execute.

are

The

restrictions

described in
summarized below.

the

be
be

can
run
exist on
VAX/VMS

that

can

both the hardware
and
software
levels
VAX-11/RSX~-11M Programmer's Reference Manual and

INTRODUCTION

Requirements for RSX-11lM Image Execution

1.1.1

At the processor level, the requirements for RSX-1lM

image

execution

follows.

are as

The image must execute in user mode.

HALT

instructions;

the

It must not execute any privileged instructions such
RESET.

not

It must

point

floating

FIS

issue

software emulates FPP floating point instructions.

At the software level, the requirements are as follows.

e
e

The image must have been built using the RSX-11M

Version

3.1

It must not depend on environmental features of

RSX-11M

that

task builder to execute in a mapped system.

are

for

VAX/VMS,

available

not

management or significant events.

not

It must

the

overmap

RSX-11M

executive is not present in VAX/VMS.

executive;

It must not overmap the PDP-11 I/O page;

available at user mode.

example,

PLAS

memory

the

RSX-11M

the I/O page is

not

Task images developed under RSX-11D or IAS and compatible with RSX-11M
can execute under VAX/VMS if they meet the requirements listed above.
However, such task images must be rebuilt using the RSX-11M Version
3.1 task builder before they can execute under VAX/VMS.

RSX-11M Version 3.1 task images do not have to be rebuilt to run under
VAX/VMS unless program modification or different task builder options
are required. Rebuilding also is required to take advantage of the
logical name extensions of FCS and RMS-11.

1.2

WHAT RSX-11M PROGRAM DEVELOPMENT TOOLS ARE AVAILABLE?

VAX/VMS provides the RSX-11M utilities needed for the operating system
to function as the host for RSX-11lM program development. These
provide
utilities run in compatibility mode under VAX/VMS and
functions that are identical to the functions they provide in RSX-1l1M.
In addition, VAX/VMS provides copies of the files and libraries needed
for program development.

Standard Utilities and Files Provided with VAX/VMS

1.2.1

VAX/VMS provides the
standard

system.

following

RSX-11M

(MAC)

MACRO-11

Editor

RSX-11M task builder

RSX-11M librarian

(EDI)

(TKB)

(LBR)

utilities

part

the

INTRODUCTION

Peripheral

File

Source

File structure
Level 1 (VFY1)

ZAP

utility

(ZAP)

File

patch

utility

Disk

save and compress utility for

interchange

transfer

program

utility

language

input

(PIP)

(FLX)
program

verification

(SLP)

utility

Files-11

Structure

(PAT)

(DSC1)

File dump

utility

(DMP)-

Bad

locator

utility

RMS-11

block

for

Files-11

Structure Level

(BAD)

Utilities

VAX/VMS also provides the following RSX—llM files and libraries.

With

SYSLIB.OLB

RSXMAC.MLB

ODT.OBJ

the

would
For

utilities

RSX-11lM

example,

for
you

can

using
MACRO-11,
using VAX/VMS as
using ODT can be
RSX-11M

1.2.2
The

images

following

listed

above,

you

can use VAX/VMS

development.

enter

and

developed

Utilities

additional

separate

edit

program

under

and

RSX-11lM

VAX/VMS

using

EDI,

you

assemble

RSX-11M/S

FORTRAN

system

can

execute

are

available

under

RSX-11M.

Programs
facilities

license:

with

VAX/VMS

generation

compiler

FILES-11

Files-1ll
RSX-11M

Files-11
supports

structure

is the file
structure
used
for
disk
volumes
under
both
and
VAX/VMS.
Files-11
provides
two
structure
levels:
Structure Level 1 and Files-11 Structure
Level
2.
RSX-11M
only

structure

levels.

volumes;
however,
it
Thus, structure level 1

and

files

build
it using the RSX-11M task builder, and run it
the host system.
Images
that
are
to
be
debugged
linked with ODT.OBJ.

Additional

under

1.3

task

and

program

VAX/VMS

systems.

1level

default,

whereas

VAX/VMS

can create and
volumes can be

VAX/VMS

creates

supports

structure

both

level

read structure level 1 volumes.
transported among RSX-11,
1IAS,

INTRODUCTION

FCS AND RMS-11 UNDER VAX/VMS

1.4

File Control Services (FCS), RMS-11, and RMS-11K (ISAM) are available
under VAX/VMS, and all run in compatibility mode. The result is that

RSX-11M images that call FCS/RMS-11 interface with the same record
management services that they used in RSX-11M. VAX/VMS converts FCS

VAX/VMS
and RMS-11 requests from the RSX-11M format to their
Manual
Reference
's
Programmer
RSX-11M
VAX-1V
The
format.
equivalent
details the conversion process.

Record locking, however,

is not supported.

SUPPORT OF RSX-11M DIRECTIVES

1.5

The VAX-11/RSX-11M Programmer's Reference Manual describes VAX/VMS
support for RSX-11M task images that issue directives to the RSX-11M
the
executive. The majority of directives are supported by VAX/VMS;
following,

1.6

however,

are not:

PLAS directives because of substantial differences in hardware

memory management techniques

because

SWITCH

VAX-11/780

does

not

have

sense

GET SENSE

CONNECT TO INTERRUPT VECTOR because I/0 drivers do not run

switches

compatibility mode under VAX/VMS.

SUMMARY OF COMMANDS

In addition to the
Table 1-1 summarizes the VAX/VMS MCR commands.
command listed, VAX/VMS MCR recognizes commands that invoke RSX-11M
components, for example, MAC to invoke the MACRO-11] assembler.
Table 1-1
Summary of MCR Commands

Function

Command
Initialization Commands

Allocate

Reserves an unmounted shareable
an

unallocated

nonshareable

exclusive use by the process

deletes

device

logical

for

name

Assign

Defines

Deallocate

Releases a previously allocated device

Dismount

Releases a volume previously specified in a

Initialize

Initializes a Files-11] Structure Level 1 or

assignment

Mount command

disk

volume

(continued on next page)

INTRODUCTION

Table

1-1

Summary

(Cont.)

MCR

Commands

Command

Function

Mount

Makes

volume
Set

Card

Set

Control

Reader

Default

Enables

Default

Set

Magtape

UIC

CTRL/Y

mode

return

a disk and/or directory as
default for file specifications

the

interpreter

Defines

characteristics

the

Requests

Process

Protection

Queue

new

directory

execution

current

process

Defines

the
of

UIC

magnetic

protection

for

job

the
the

characteristics

protection

files,

during
Changes

and

the command interpreter
to
check
error
condition after executing a
or program in an
indirect
command

Defines

default

device

group

Set

volume

translation

file

Set

tape

processing

Establishes

for
an
command

Set

for

Establishes

tape

Set

magnetic

recognition

command

current

Set

available

Defines the default ASCII
for a card reader

the
Set

disk

set

status

establishes

files

created

attributes

entries

the

file

the

default

subsequently

associated

with

one

printer

batch

job

queue

Set

RMS

Default

Provides
counts

default
to

operations;

multiblock
wused

RMS-11

does

defaults
Set

Terminal

Defines operational
terminal

Set

/UIC.

Changes
of

Set

Verify

the

lines

the

1in

executes

Set

Working

Set

Changes

Creates

Files-1ll

for

wuse

and

command

interpreter

command

the

process

indirect

current working

set

directory or

Structure

Level

(continued

2
on

UIC

1limit

subdirectory

display

files

them

the

file

these

characteristics

quota

UFD

multibuffer
RMS

not

default directory

current

Requests

and

VAX-1l1l

disk
next

page)

INTRODUCTION

(Cont.)

Table 1-1

Summary of MCR Commands
Function

Command

Informational Commands
Show Daytime

Displays the current date and time

Show Default

Displays

the

current

default

Show Devices

Displays

the

status

Show Logical

Displays current logical name assignments

Show Magtape

Displays the characteristics of a

Show Network

Displays the availability of network nodes,

Show Process

Displays attributes of the current process,

directory

disk

and

1in

the

devices

system

magnetic

tape device

including the current node

privileges,

including

resource

quotas,

and

accounting

default

protection

priority,

memory

usage,

Show Protection

Displays

the

Show Queue

Displays the status of printer or batch
jobs that have been gqueued but not yet

information

current

applied to files

printed or processed

Show RMS Default

Displays the current default multiblock and
multibuffer counts that VAX-1ll RMS uses for
file operations

Show Status

Displays the status of the current Jjob,
including accumulated CPU time, open file
count, and counts of I/0 operations

Show Symbols

Displays current symbol definitions

Show System

Displays the status of all processes in the

Show Terminal

Displays the device characteristics of your

Show Translation

Displays

Show Working Set

Displays the current working set size limit

Time

Displays the current date and time

system

terminal

the

equivalence

specified logical name
and

name

quota

(continued on next page)

INTRODUCTION

Table
Summary

1-1
of

(Cont.)

MCR

Commands

Command

Process

Function

Control

Commands

Bye

Terminates

Cancel

Cancels

interactive

scheduled

terminal

wakeup

session

requests

process

for

Continue

Resumes execution of an
or indirect command file

interrupted

Exit

Terminates

processing

indirect command
On

Control

Defines

the
CTRL/Y

when
On

severity-level

Defines

taken

of action
pressed

Logout

Terminates

Run

Runs

your
into

Terminates
running jin

Submit

Queues

Invokes

Deposit

Replaces

file

right
it

use

interactive
and,

the

terminal

the

image

job

for

processing

debugger

for

error

system

and

session

subprocesses

taken

optionally,

and

execution
a process

batch

encounters

the content
virtual memory

Examines

Link

creates

currently

Commands

Debug

Examine

current

course of action
command
or
program

processes

Stop

Program Development

images

detached

image

default

indirect command
condition
Verifies
logs you

the

course

the
when

file

the content
virtual memory

Links

native VAX-1ll

interrupted

image

specified

locations

specified

locations

images

File Manipulation Commands
Append

Copy

Adds

the

files

contents

the

Creates new
files

end
files

of an

one

output

from one

(continued

input

file
more

existing

page)

INTRODUCTION

Table 1-1

(Cont.)

Summary of MCR Commands

Command

Function

Delete

printer queues,
Deletes files, entries from queue
s

directory

main
areas
described

below.
Differences in the device field are related to
VAX/VMS's
use
of a letter to designate the controller.
Differences in the directory
field result from differences in Files-11 Structure Levels
1
and
2.

VAX/VMS

file

specifications have

the

following

format.

node::device: [directory] filename.type;ver

node

Node name.
The
node
name - is
a
1lto
6-character
alphanumeric
string
that identifies a location on the
network.
The node name is separated
from
the
device
name by two colons (::).

VAX/VMS ENVIRONMENT

device

Device

name.

following

Device

names

format.

are

specified

1in

the

devcu:

dev is a mnemonic for the device
c
is a controller designation.
u
is the device unit.
The maximum length of
characters.

directory

Directory name.
of

the

following

the

type.

device

name

field

Directory names are specified
formats.

one

[g,m]

[name]
[name.name.name,,,]

Under VAX/VMS, all of the above formats can be used for
structure level 1 and 2 disks;
however, only the [g,m]
format can be used under RSX-11M.
Angle

([])

filename

brackets (<>) can be
wused
instead
to delimit the directory name.

File name.

brackets

A file name consists of

alphanumeric

A file type consists of

alphanumeric

characters.

type

File

type.

characters.

ver

File

version

number.

Version

numbers

numbers
ranging
from
1
through
32767.
either a semicolon (;) or a period (.)
to
file type from a file version number.

are

decimal

You can use
separate
a

File names, file types, and version numbers apply
only
to
files
on
mass
storage
volumes.
Directory
names apply only to files on disk
volumes.
For record-oriented devices, only the device name
field
of
the file specification is required.

You can use wild cards (*) in the file name,
number fields of a file specification.

2.3.1

file

type,

and

version

Device Names

VAX/VMS
device
names
consist
designation, and unit number.

2.3.1.1
Device Mnemonic - The
listed in Table 2-1.

device

device mnemonic

mnemonic,

can be

controller

any one

those

VAX/VMS ENVIRONMENT

Table 2-1
VAX/VMS Device Types

Mnemonic

Device Type

CR
DB

Card reader
RP04, RP05,

RKO6

and

Floppy

RMO3

and RP06
disk

disk

RK07

disk

Line

MT
NET
TT
XM

TE16 magnetic tape
Network communication device
Interactive terminal
DMC11

printer

Devices supported by both VAX/VMS
under both systems.
You need
2-1.

not

load

the

2.3.1.2

Controller

driver

and RSX-11M have

use

Designation

any of

and

the

same

the devices

Unit

listed

Numbers

controller
1is
designated by an alphabetic letter (A
example, MTA designates magnetic tape controller A.

mnemonics

in Table

The

through

device

2Z).

For

Unit numbers
are
decimal
numbers
ranging
from
0
through
65535.
VAX/VMS
unit
numbers start at 0 for each controller;
for example, a
system can have two tape units on two different controllers designated
as MTAO0 and MTBO.
Each is unit 0 on its controller.

2.3.2

Directory Names

Directory names are represented in the [g,m] format
or
by
a
19-character
alphanumeric
string.
Using
subdirectories,
you
specify up to seven directory levels after the main directory name
the following format.

to
can
in

[name.name.name,,,]

When subdirectories are used, the comma in a UFD-format
directory
or
subdirectory name is omitted;
leading zeros are required.
An example
of a
directory
name
is
[122020.MSG].
Directories
are
described
further
You

the VAX/VMS

must use
structure

Command

create

the DCL
level 2

Language
structure

Command

command
volume.

User's

level

Language

CREATE/DIRECTORY

That

command

Guide.

You can
directories.

Any volumes that are to be transported
systems
must
have directories in the

omitted.
systems.

For

example,

User's Guide.

[123050]

and

use

to create
described

the

MCR

directories

UFD

between
VAX/VMS
[g,m] format;
the

[123,050]

are

the

on
VAX/VMS

command

and
RSX-11lM
comma can be

equivalent

both

VAX/VMS ENVIRONMENT

2.3.3

Version Numbers

RSX-11M displays version numbers in octal.
VAX/VMS displays
them
in
decimal.
However,
both
systems maintain version numbers in binary;
version numbers
are
compatible
internally.
To
determine
version
numbers
when
moving files between systems, use PIP on either VAX/VMS
or RSX-11M to list file name and version information as it appears
1in

that system.
The PIP supplied with VAX/VMS has been modified to print
version numbers in decimal.
You can also use
the
Directory
command
under VAX/VMS to display the content of a directory.

2.3.4

Defaults

in File Specification

When a field of a file
specification
is
omitted,
VAX/VMS
defaults.
Table 2-2 lists the defaults for each field.

File

Table 2-2
Specification Defaults

Field

Default

node

Local

device

Disk established as your default by 1)
in
the user authorization file, or 2)

system

a Set Default

The

system disk

is not necessarily the default.

Directory established as your default
entry
in
the
wuser
authorization
execution of a Set Default or Set/UIC

file

None

file type

File type that is the default
for
command
or
component being used.

default

file version

file

For

input

version;

establishing

the same as

files,

that

the

is,

default

those used

system assumes

by
1)
your
file,
or
2)
command.

the
particular
Table 2-3 lists

types.

The rules for
numbers are

your
entry
execution of

command.

directory

name

supplies

file

version

the most

recent

in RSX-11M.

the highest version number.

For output files, the system increases the
version
number
by
1
for
existing
files
and supplies a
version number of 1 for new files.

VAX/VMS ENVIRONMENT

Table 2-3
Default File Types

File Type

File

Content

B2S

Source

input

for

CBL

Source

input

CMD

RSX-11M

indirect

COM

VAX/VMS

command procedures

COR

DAT

Input

DIR

directory

your

the

logical

system

of
the
system

that

log

name

table.

1logical

name

system
disk
program
and

contains

installation

in,

can

system

place

names

VAX/VMS ENVIRONMENT

2.5

DEVICE MAPPING

Device mapping is the technique of equating an RSX-11M device name
with a VAX/VMS device name. VAX/VMS automatically performs device
mapping for two categories of device names:

for example, TI

RSX-11M pseudo-device names,

RSX-11M physical device names, for example, DB2

or when a
Mapping occurs when an image uses an RSX-1lM device name,
command issued either interactively or from an indirect command file
uses an RSX-11M device name.

2.5.1

Mapping RSX-11M Pseudo-Device Names

VAX/VMS maps RSX-11M pseudo-device names to VAX/VMS logical names that
serve similar functions. Table 2-4 shows the correspondence between
RSX-11M pseudo-device names and VAX/VMS logical names.
Table

2-4

Mapping of RSX-11lM Pseudo-Device Names

RSX-11M Pseudo-Device Name
input)

(for

(for output)

VAX/VMS Logical Name
SYSSINPUT

SYSSOUTPUT

Cco

SYSSCOMMAND

SYSSERROR

SYSSDISK

Device assigned by VAX/VMS

Device containing image file

system manager

Devices TI, CO, and CL have permanently open files associated with
An RSX-11M image interacts with the process-permanent files by
them.
issuing I/0 requests on TI, CO, and CL that VAX/VMS automatically
converts to requests on SYSSINPUT, SYSSOUTPUT, SYSSCOMMAND, and
SYSSERROR.

VAX/VMS

2.5.2
You

Mapping

can

RSX-11M

control

the

Physical

association

ENVIRONMENT

Device Names
of

RSX-11lM

physical

device

name

with
an actual VAX/VMS device, or VAX/VMS can perform the
association
automatically.
To associate an RSX-11M device name
with
a
specific
VAX/VMS
device
wunit, issue an Assign or Mount command that specifies
the RSX-11M device name
as
the
1logical
name
for
the
device,
as
described in Chapter 3.
If

you

not

wuse

1logical

wunit

number

names,

VAX/VMS

automatically

maps

the

RSX-11M
device
name
to a VAX/VMS device name.
VAX/VMS performs the
mapping by retaining the device type (for example, MT) and
converting
the

RSX-11M

letter

and

unit

into

the

number.

corresponding

VAX/VMS

controller

VAX/VMS performs the mapping to a physical device
by
converting
the
RSX-11M
wunit
number
to
decimal
and dividing by 16 (decimal).
The
quotient is added to the ASCII
value
representing
the
character
A
(65).
The result is the controller letter.
The remainder becomes the
VAX/VMS unit number.
For example, RSX-11M devices TTO0 and DB22 become
VAX/VMS devices TTAO and DBB2, respectively, as follows.
TTO

TTAO:

Controller

DB22

and

unit

A +

0
6

A+

=
=

65 =
unit

with

remainder

controller
number

DBB2:

Controller

and

unit

= A

+ 18 =
16

A+

VAX/VMS

performs

RSX-11M

image.

2.6

TERMINAL

this

1
2

A +

with

remainder

=66 =B = controller
= unit number

conversion when

assigning

I/0 device

for

FUNCTIONS

Table 2-5 lists
the
terminal
control
key
sequences
recognizes.
With
the exception of CTRL/Y and CTRL/X,

that
VAX/VMS
these terminal
functions are essentially the same as those available
under
RSX-11M.
CTRL/Y
always
causes
a
return
to the command interpreter.
CTRL/X
cancels the current line and deletes data in
the
type~ahead
buffer.

Under

VAX/VMS,

you

not

have

terminate before typing the next
stored in the type-ahead buffer.

wait

request.

for

one

command

Unprocessed

program

commands

are

VAX/VMS ENVIRONMENT

Table

2-5

Terminal Function Keys

RETURN

(Carriage return) Transmits the current
line to the system for processing.

Before a terminal session, initiates login
sequence.

Control characters

Define functions to be performed when the
CTRL key and another key are pressed
All CTRL/x key sequences
simultaneously.

are echoed on the terminal as “X.

CTRL/C

Before a terminal session, initiates login
sequence.

During command entry, cancels command
processing.

Certain system and user programs provide

special routines to handle CTRL/C
If CTRL/C is pressed to
interrupts.
interrupt a program that does not handle
CTRL/C, CTRL/C has the same effect as
CTRL/Y and echoes as "Y.

CTRL/I

Duplicates the function of the TAB key.

CTRL/K

Advances the current line to the next

CTRL/L

Requests form feed.

CTRL/O

Alternately suppresses and continues
display of data at the terminal.

CTRL/Q

Restarts terminal output that was suspended

CTRL/R

Retypes the current line during input and
leaves the cursor positioned at the end of

vertical

tab stop.

by CTRL/S.

the

line.

CTRL/S

Suspends terminal output until you press

CTRL/U

Cancels the current line and discards it.

CTRL/Y

Interrupts command or program execution and
returns control to the command interpreter.

CTRL/X

Cancels current line and deletes data in

CTRL/Z

Signals end-of-file for data entered from

CTRL/Q.

the type-ahead buffer.

the

terminal.

(continued on next page)

VAX/VMS ENVIRONMENT

Table 2-5 (Cont.)
Terminal Function Keys

TAB

Moves

the

printing

terminal to the
terminal.
Most
every
DELETE

character

Deletes

element

cursor

next tab stop on the
terminals have tab stops
positions

the

last

character

special

uses

the

line.

entered

the

terminal and backspaces over it.
On some
terminals, this key is labeled RUBOUT.
ESCAPE

Has

programs,

2.7

but

particular

generally

function

RETURN.

this

labeled ALTMODE.

key

commands

performs

the

same

some -terminals,

SYNTAX RULES

VAX/VMS

MCR commands have

the

command [/cmd-keywords]

The

rules

same

those

for

separating
for

least

one

syntax:

parameter [/keywords...][...]

items

RSX-11M,

parameter,

following general

that

space

must

and

a VAX/VMS

command

string

command

from

are

is:
separate
least

the

one

space

must

the

first

Separate

each

additional parameter from the
previous
parameter.
Multiple
blanks
and
tabs
are
permitted
in all cases where a single
blank is required.
®

2.7.1
You

Each

keyword must
spaces, including

preceded by a slash
(/).
zero, can precede the slash.

Continuing Commands

can

enter

command

on More

string

continuation
character,
a hyphen
as in the following example.
>
>_
>_

number

wusing

the

than One Line
more

(~),

than

one

the

1line

last

element

line,

COPY

/LOG OUTFIL.DAT

/CONTIGUOUS
INFIL1.DAT,INFIL2.DAT

restriction

command

Any

placed

the

string.

After
each
continued
additional input (>_).

1line,

number

the

command

2-15

1lines

used

interpreter

enter

prompts

for

VAX/VMS ENVIRONMENT

2.7.2 \Commenting Command Lines

VAX/VMS MCR distinguishes command lines from comments using
conventions as RSX-11lM uses, that is:

A semicolon (;) as the first significant character on

An exclamation mark (!) indicates the beginning of

indicates that the entire line is a comment.

the

same

line

comment

in a command line.

Truncating Command Names and Keywords

2.7.3

You can truncate any item in a command that appears in uppercase
letters in the individual command descriptions in Chapter 4.
A1l command names can be truncated to their first three characters.
You can truncate command names to fewer than three characters as long
as the name remains unique. For example, because the Type command is
the only command beginning with the letters TY, it has a minimum
truncation of two letters. For convenience, the following frequently
used commands can be truncated to one letter even though other
commands start with the same letter:
e

Continue

Deposit

Examine

Run

All other portions of
keyword values) can

a command 1line (for example, keywords and
be truncated to four letters, or fewer if they

remain unique within the command.

2.7.4

Placement of Keywords

VAX/VMS MCR is considerably more flexible than RSX-11M MCR about where
The command
keywords in the command string.
place
can
you
file
from
keywords
command
separate
4
Chapter
in
descriptions
Command keywords have the same meaning
specification keywords.
regardless of whether they appear following the command name oOr
For example, the following two
following a command parameter.
commands are identical.

> RUN /UIC=[200,230]

DOTS.TSK

> RUN DOTS.TSK /UIC=[200,230]

different
File specification keywords, on the other hand, have string.
If
command
the
in
placed
are
meanings depending on where they
only
affect
they
ation,
specific
file
a
g
followin
ely
immediat
d
specifie
If specified following the command name,
the file thus qualified.
as parameters. For example, the first
d
specifie
files
all
affect
they
printing of two copies of both files,
the
command below results in

VAX/VMS ENVIRONMENT

whereas
the
SANDPIPER.MAP

Some

PRINT/COPIES=2

file

2.7.5

YELLOWLEG.MAP

keywords

keyword descriptions

and

two

copies

are

not

valid

indicate

command

keywords.

any restrictions.

File Protection

volumes have protection codes that
restrict
access
This
protection
1is
assigned
when
the volume is

can be

reassigned when

a volume

volumes, each file on the volume,
a different protection associated

Files potentially can be
®

printing

YELLOWLEG.MAP

and tape
volume.

disk
have

the

YELLOWLEG.MAP.

SANDPIPER.MAP,

Specifying

disk
the

SANDPIPER.MAP/COPIES=2,

specification

initialized,
For
can

results

copy

one

Individual

All
to

second

and

SYSTEM -- all
(octal)
and

(generally,

is mounted.

including
with it.

accessed by users

four

directory

file,

categories:

users who have group numbers
of
1
through
10
wusers with physical I/O or logical I/0 privilege
system
managers,
system
programmers,
and

operators)

OWNER -owns the

the UIC of the
volume or file

GROUP -- all users who have the
UICs as the owner of the file

WORLD

all

users

person

who

not

user

who

created

and,

same

group

number

fall

into

any

therefore,

their

the

other

three

denied

categories
Each of these
categories
following types of access:
®

READ
on a

the

right

can

examine,

allowed

print,

copy

file

the

files

volume

WRITE -volume

the

EXECUTE -- the right to execute files that contain
executable
program
images (when applying protection to an entire volume,
this field is interpreted as the right to create files on
the
volume)

DELETE

Any combination

the

right

access

modify

the

delete

types

can

file

the

file

to write

specified

files

for

files

any

the

volume

category

user.

When you
types

specify

protection
user

one

types

category,

protection

character;

code,
you

you

can

must

specify

in any order.

you

omit

that

user

category

abbreviate
the

user

a protection

denied

that

protection

directory

VAX/VMS
form or

wuses
your
a directory

Because

FLX

does

from

default
name.

not

file

VAX/VMS

depends
on
the
device
mapping
automatically.
Device mapping is
If you specify a device name
VAX/VMS, FLX issues an error
the device.
Before
drive.
The
>

using

following

FLX

are

with

device

can

for

names,

your

that
the operating
described in Section

disk

either

use

file,

the

[g,m]

FLX

system performs
2.5.2.

that does not map to a physical device on
message indicating that it could not find
)

magnetic

examples

a
file
file

tape,

FLX

you

command

must

allocate

the

tape

device

DBAO.

lines.

DBO:[120,30]=MT17:8SYS1.MAC/RT

VAX/VMS
maps
>

FLX

specification

directory.

maps

device

the device
name

MT17

name DBO

device

MTB1.

physical

FLX

FLX>

DR3:=DM0:[133,10]MYFIL.MAC/DO

VAX/VMS

DMAOQ.
file.

maps

The

device

name DR3

to physical

device

wuser's default directory on DRA3

DRA3

and

contains

DMO

the output

USING VAX/VMS MCR

Using VAX/VMS Components

3.4.3

From the VAX/VMS MCR

command

interface,

following native VAX/VMS components:

you

can

also

1invoke

the

MCR

(MAR)

VAX-11 MACRO

Standard VAX/VMS editor

VAX/VMS Librarian

VAX-1l1l Linker

Various VAX/VMS utilities available through

(SOS)

(LIB)

(Link command)

language (for example, Print, Submit, Set, and Show)

command

To request any of these components, type one of the following:
e The component name or the component name followed by a

wvalid

command line for that component

the

The command that invokes the particular component

The information

parentheses

the

1list

appropriate means of requesting each component.

above

Subsequent operation of the requested component is
appropriate VAX/VMS document;

indicates

the

described

see the VAX-11 Information Directory to

determine the documents required.

3.5

EXECUTING RSX-11M INDIRECT COMMAND FILES

as
RSX-11M indirect command files have the same uses under VAX/VMS
for
file
command
indirect
an
specify
can
you
is,
That
RSX-11M.
under
command file
processing by VAX/VMS MCR or you can specify an indirect
1In
in a command to an RSX-11M component executing under VAX/VMS.
the
of
cation
specifi
file
the
s
precede
either case, an at sign (@)
indirect file just as it does under RSX-11M.

(for example,
Indirect files specified for use by RSX-1lM components
RSX-11M.
under
used
those
to
al
identic
are
task builder and MACRO-11)
ves
directi
or
process
file
t
indirec
MCR
the
es
describ
5
Chapter
about
tion
informa
nal
additio
s
provide
and
available under VAX/VMS
Section 4.15 describes the
running MCR indirect command files.
Execute procedure

3.6

(@).

BUILDING RSX-11M IMAGES FOR EXECUTION UNDER VAX/VMS

ng existing
The VAX/VMS system can serve as the host for 1)S ormodifyi
ping new
develo
2)
VAX/VM
under
execute
RSX-11M images so that they
modified
being
image
the
When
.
RSX-11M
or
S
VAX/VM
under
run
to
images
it with
build
should
you
,
VAX/VMS
under
or developed is to execute
ns for
eratio
consid
e
describ
s
section
ng
followi
The
mind.
in
fact
that
.
building RSX-11M images to execute under VAX/VMS

3-10

USING VAX/VMS MCR

3.6.1
You

Task

can

use

Builder

Switches

most

the

switches

defined

for

the

RSX-11M

when
building
an image for execution under VAX/VMS.
you cannot use is ~MM (unmapped system);
that is, the
built to execute on a mapped system.

task

builder

The only switch
image
must
be

Table
the

and

3-1 lists the switches that are effective under
VAX/VMS.
With
exception
of -MM, unlisted switches have no effect under VAX/VMS
do not cause an error when the image executes under VAX/VMS.
As a

general
treats

the

rule,

the

switches

that

during

execution

image

Task

Builder

Switch

CcC

are

intended

are

checkpointable.

ignored,

Table 3-1
Switches Valid for RSX-11M

affect
for

Images

Option

the

way

under

Function

Input

file consists of concatenated

Image

Specified

contains

debugging

library

system object

module

object

Task

floating

uses

the

All

co-tree

for

overlay

matching

modules
library

replacement

point

Image

includes

Input

file

Memory

System

has

run

either

library

from

searched

object

management;

when

module

Image
1is
separated
nonshareable portions

Image

Post-mortem

Short

memory

Spool

map

contains

position

includes

for

must

image

present

by default

Input

dump

are

reference

file

VAX/VMS,

(FPP

file

explicitly or
file

processor

output

the

memory

under

the

header

allocation

information

for

segments

definition

from
the
default
are being processed

aid

library

only)
FU

whether

VAX/VMS

modules

RSX-11M

example,

overlay
into

description

shareable

and

independent

requested

allocation

file

requested

output

(continued

page)

USING VAX/VMS MCR

Table

3-1

(Cont.)

Task Builder Switches Valid for RSX-11M Images under VAX/VMS

Function

Switch or Option

are

program—-sections

Image

Selective search for global symbols

Image is to be traced

Memory allocation

XT:n

Task builder exits after n diagnostics

sequentially

width of

Defaults and the use of a
identical to RSX-11M.

minus

132

file

characters

sign

for

RSX-11lM

3.6.2

VAX/VMS

space.

images.

printed

negate

(-)

Use of overlays can be avoided to take advantage
address

allocated

are

switches

VAX/VMS

virtual

provides 65K bytes of virtual address space

Task Builder Options

You can specify any of the RSX-11M task builder options for RSX-11M
images that are to run under VAX/VMS. The options that specify UIC,
UIC and priority are
priority, and partition have no effect;
associated with the user running the image in VAX/VMS, and partitions
do not exist. Two options, TASK and ASG, may be required for RSX-11M
images to run successfully under VAX/VMS, as described below.

RSX-11M images that use common event flags (that is, specifying

numbers

flag

greater

than

33),

that

are

event

the target of directive

requests, or that issue RECEIVE DATA and RECEIVE DATA OR EXIT
directives must have a name assigned using the TASK option. The first
character of the name must be alphabetic.

task

name

VAX/VMS uses

the

presence

the image label block as an indication that the

image requires special initialization.

RSX-11M images that do not associate LUNs with either a physical or
logical device name within the program must be built using the ASG
option to make the required association.

VAX/VMS MCR does not support

the Reassign command.

3.6.3

Noncontiguous Image Files

The task builder issues an informational message if it produces an
image file that 1is not contiguous. VAX/VMS, however, allows you to
run images contained in noncontiguous files.

3.6.4

Building RSX-11M Images on VAX/VMS for Execution on RSX-11M

You also can use the VAX/VMS system to build RSX-11lM images that are
1In this case, VAX/VMS imposes no restrictions
to run under RSX-11M.
on the switches and options that you can specify.

CHAPTER 4
MCR COMMANDS

ALLOCATE
4.1

ALLOCATE

The

DEVICE

Allocate

Device command reserves an unmounted shareable device
unallocated
nonshareable
device
as
a
private
device
for

process.

After

name

the

allocated

the

device

allocated,

SYS$SOUTPUT.

MCR

Other

displays

users

cannot

device.

the

gain

or
the

physical

access

Format:

ALLOCATE

device~namel[:]

device-name

Specifies the physical or logical
name
of
the
device
to
be
allocated.
If
you
specify
a
physical
device
name,
it
can
be
either
a
complete
example

name
TT.

discussion of

or
See

generic
Section

generic device

device

name,

for

3.2.1.1

for

names.

Examples:
>

ALL

TTH7

_TTH7:

ALLOCATED

This command
command

requests allocation of device

responds

reserved for the
the
displayed

translation
allocated.
>

ASN

MTA2:=MTO0:

ALL

MTO

_MTA2:

indicating

that

the

TTH7.

The

requested

device

actual

physical

Allocate

has been
requesting process.
The
underscore
preceding
device
name
indicates
that
no
further
name

required

determine

the

device

ALLOCATED

The Assign command defines
MTO0
as
the
logical
name
physical
device
unit
MTA2.
The Allocate command then
that device using its logical name.

for

the

reserves

MCR COMMANDS

Notes:

The Assign command can be used

define

logical

device

name.

Assigning an I/0 channel (LUN) to a nonshareable device causes
the
device to be implicitly allocated.
Opening a file causes
a

channel

to be assigned.

File-oriented devices
allocated

(magnetic

they are mounted.

tape

and

disks)

cannot

If you do not specify the device
controller
designation
and
the Allocate command selects an
VAX/VMS,
under
number
unit

available device.

The

controller A and unit 0.

selected

device

1is

not

necessarily

MCR COMMANDS

APPEND
4.2
The

APPEND
Append

files

command

the end

adds

the

contents

specified

output

one

file.

specified

input

Format:

APPEND

[keywords]

=
keywords

output~-file~spec

input-file-spec

[keywords]
[keywords]

F 2L
AR J

/ALLOCATION=n

/ [NO]CONTIGUOUS
/EXTENSION=n
/FILE_MAXIMUM=n
/ [NO]LOG
/ [NO]NEW
/PROTECTION=code
/ [NO]READ CHECK
/ [NOJWRITE CHECK
output-file-spec

Is the name of the output file.
You must specify
at
least
one
field
of
the
output
file
specification.
For
fields
that
you
do
not
specify,
the
Append
command
the related
uses
field of the input file specification.
If you specify a wild card in
output
file
specification,
uses
the
related
field
of

any

field
the
Append command
the
file
the
input

specification(s).
If you specify
only
the
portions
of
the
output
Append

file

input-file~spec

command

uses

device
and
directory
file specification, the

fields

Specifies the name of a file
you
specify
more
than one

to be
input

the file specifications with
or a plus sign (+).

either

You can use a
name,
type,

that

the

input

specification.

satisfy

appended.

appended.
If
file, separate
a

wild card
1in
place
of
or
version field.
Then,

the

remaining

comma

(,)

the

file

all

files

components

are

MCR COMMANDS

Command Keyword:

/LOG
/NOLOG
(default)

Indicates
that
the Append command is to display
the
file
specifications
of
each
output
file
created
and
each
input
file
copied
1in
the
following format.
CREATING

NEW

FILE

input-file COPIED TO

output-file

(nn RECORDS)

When the Append
command
1is
creating
output
file from multiple input files,
message is followed by messages in the
format.
input-file APPENDED TO

output-file

a
single
the first
following

(nn BLOCKS)

The Append

command displays either the number
of
records
or the number of blocks copied depending
on
whether
the
file
is
copied
on
a
record-by~record or block-by-block basis.

At the end
of
command
processing,
the
Append
command displays the number of new files created,
which is always one or zero.

File Keywords:
/ALLOCATION=n

Forces the initial
file to the number

allocation of the
new
output
of blocks specified by n.

/ALLOCATION
implies
/NEW;
allocation
values
are
applied
output file is actually created.
/CONTIGUOUS
/NOCONTIGUOUS

that
only

is,
if

the
a new

Indicates
whether
the
output
file
1is
contiguous;
that
1is,
whether
it
must
consecutive physical disk blocks.

to
be
occupy

By default,

output

the

Append

command

creates

file
in
the
same
format
as the related input
file.
If
multiple
1input
files
of
different
formats are appended to a single output file, the
output file may or may
not
be
contiguous.
To
ensure
that
the
output file is contiguous, use
the
/ALLOCATION
and
/CONTIGUOUS
keywords
and
create a new output file.
/EXTENSION=n

Specifies the number of blocks to be added
new output file each time it is extended.

the

/EXTENSION implies /NEW;
that is, the allocation
values
are
applied only if a new output file is
actually created.

/FILE_MAXIMUM=n

Specifies the maximum number of
1logical
records
that the output file can contain.
This qualifier
is valid only for relative files.

/NEW
/NONEW

Requests
(default)

not

that,

already

exist,

the

specified output file does

the Append

command

create

one.

MCR COMMANDS

/PROTECTION=code

Defines

the

protection

output
file.
The
following the standard
Set

Protection

attributes

/READ_CHECK
/NOREAD CHECK
(default)

applied

command.

specified

Any

the

specified
with
the
protection

the

Indicates
whether
the Append command is to
the
specified input file(s) twice to verify

read
that

all

protection

records

/WRITE_ CHECK

Indicates

/NOWRITE CHECK

the

(default)

from

current

not

protection
1is
rules, described

have

taken

output

file.

correctly

read.

the Append command

file

after

has

the

file

has

been

that

appended

the

been

whether

output

verify

are

and

that

the

output

is to read

been written

successfully

file

can

read

without error.
Examples:
>

APPEND

[HICKS]EDWARD.OBJ

[DAVIS]JOSEPH.OBJ

This command appends the file
to
the
file
EDWARD.OBJ
1in
device.
>

APPEND

/LOG/NEW

from
directory
[HICKS]
on the

[DAVIS]
default

THEEIGHT.DAT

= HENRI.DAT+LUKS.DAT+SLOAN.DAT
DBBl: [PAINT]THEEIGHT.DAT;1l created

¥APPEND~I~CREATED,
$APPEND~S~COPIED,

JOSEPH.OBJ
directory

DBBl: [PAINT]HENRI.DAT;2

THEEIGHT.DAT;1

(10
$APPEND~S~-APPENDED,

copied

records)
DBBl: [PAINT]LUKS.DAT;5

DBBl: [PAINT]

appended

DBBl: [PAINT]

THEEIGHT.DAT;1

(8 records)
3APPEND~S~-APPENDED, DBBl: [PAINT]SLOAN.DAT;12

DBBl: [PAINT]THEEIGHT.DAT;1
¥APPEND-S-NEWFILES,

This

command

file

(22

a
on

created

concatenates

SLOAN.DAT
into
output files are

appended

records)

the

files

HENRI.DAT,

LUKS.DAT,

new
file
named THEEIGHT.DAT.
The
the default device and directory.

input

and
and

Notes:

RSX-11M

The

When you
Level
1

does

Append

not

support

command

use use
files,

the

Append

variation

command.

the

Copy

command.

wild cards to concatenate Files-11
Structure
the input files are copied to the output file

in random order.
When
you
use
wild
cards
to
concatenate
Files-11
Structure
Level
2 files, the Append command copies
files in alphanumeric order.
When wild cards are used in
the
version

number;
with the

field,

files

are

copied

that is, files with the
highest version number.

descending

same

Additional examples of appending files
VAX/VMS Command Language User's Guide.

name

are

order

are

by version

copied

provided

starting

1in

the

MCR COMMANDS

ASN
4.3

ASSIGN

The Assign command defines or deletes a logical name a ssignment for
device
in
one
of
three
1logical
name
tables:
process, group,

a
or

system.

Format for Assigning a Logical Name:
ASN

[keywords]

ppnn:=llnn:

Format for Deleting a Logical Name:
ASN =1llnn:

keywords

[keywords]

/GBL
/GROUP
/TERM

Indicates

the

equivalence

(physical,

logical,

pseudo~device)
name
to
which the logical name
assigned.
The
equivalence
name
can
be
up

is to be
to
15

characters.

Specifies

the device

unit number.

Specifies a logical name of

up to

char acters.

Command Keywords:

/GBL

occur

the

Indicates that the requested action is to

occur

the

occur
1in
Indicates that the requested action is to
process logical name table.
/TERM is the default.

the

Indicates that the requested
system logical name table.

/GROUP

group

/TERM

logical

name

action

table.

Examples:
>

ASN

MTB2:=MTO:

This command assigns the string
MTO0
as
the
device MTB2 in the process logical name table.
>

SHOW

MT0

LOGICAL

= MTB2:

1logical

name

for

MTO

(PROCESS)

This command requests that the
logical name MTO be displayed.

equivalence name

4-6

associated

with

MCR COMMANDS

Notes:

The

equal
sign
(=)
between
the
two
optional;
if
you
do
not
specify the
leave a space between the two parameters.
RSX-11M does

not

VAX/VMS does not
Privilege
the
The

group or

three

the

/GROUP

parameters

sign,

system

command

tables.

assign

logical
can

name
be

is
you must

keyword.

support the /LOGIN and /TERM:ttn

required

Show Logical

the

support

name
equal

and delete

keywords.

1logical

names

tables.
used

display

logical

names

MCR COMMANDS

4.4

BYE

The Bye command
terminates
an
interactive
terminal
session.
The
system
displays
a
termination
message
and
performs any necessary
cleanup operations, such as
terminating
the
current
image
if
one
exists,
dismounting
any
private
volumes
that
remain mounted, and
deallocating
devices.
Finally,
it
deletes
your
process
and
subprocesses,

any.

Format:
BYE

Example:
>

BYE

MURPHY

logged out at 4-APR-1978

13:33:26.57

Note:

The Logout command performs
command.

the

same

function

the

Bye

MCR COMMANDS

CANCEL
4.5
The

CANCEL
Cancel

specified
A wake

command

requests

the

system

cancel

wake

request

for

process.

request

can

the

result

The

RUNS

directive

The

Schedule Wakeup

Any

RUN

commands

the

any

(see Notes
system

the

following:

below)

service

time-synchronized

forms

Cancel does not affect the execution of an
removes time-based requests from the timer

either

active
queue.

the

MCR

process;

DCL

only

which

wake

Format:

CANCEL

[keyword]

[process~name]

keyword

/IDENTIFICATION=pid

process—name

Specifies

the

name

requests

are

names

are

number,

can

for

Because

process

qualified

UIC

group

requests

only

for

process

cancel

group by

process

canceled.

implicitly

you

within your
Command

the

specifying

a process

name.

Keyword:

/IDENTIFICATION=pid Specifies

the

process

for

canceled.

which

1If

you

specify

identification,

the

process

name.

requests

for

your

identification
wake

requests

both

Cancel
you

process

command

specify

current process

of
are

the
to

ignores

neither,

are

be
and

name

the
wake

canceled.

Example:
>

CAN

PROCA

This command

cancels

wake

same

requester.

group

requester's
privilege.

CAN

the

requests

subprocesses,

the

for

1If

the

a process
process

requester

executing
is

must

not

one

have

the

group

/IDENTIFICATION=C0025
This

command
identification

requester's

cancels

group;

wake
(C0025.

requests
for
the
process
It
can
be executing outside

appropriate

privilege

required,

whose
of the

however.

MCR COMMANDS

Notes:

You must have group or world privilege to cancel wake requests
for
another
process.
No privilege is required for a process
to issue a cancel request for one of its subprocesses.

The Stop command can be used to delete a

hibernating

for which all wakeup requests are canceled.

process

You can determine whether a subprocess has completed execution
of
an
1image
by
1issuing
the
Show Process command with the
/SUBPROCESSES

keyword.

VAX/VMS uses the Schedule Wakeup system service to emulate the
RSX-11M
RUNS directive;
for additional information, refer to
the VAX-11/RSX-11M Programmer's Reference Manual.

MCR COMMANDS

4.6
The

CONTINUE
Continue

CONTINUE
command

indirect command
@

Pressing

PAUSE

.PAUSE

When a program
below
can
be
commands cause

resumes

file

CTRL/Y
request

interrupted

command,

by any of

the

program,

following:

CTRL/C

issued

directive

issued

FORTRAN program

indirect

command

file

is interrupted or pauses,
only
those
actions
1listed
taken and still be able to resume execution;
unlisted
termination of the interrupted image:

Examine

Allocate

and

Define

symbol

Assign

and

Set

Show

Display

When an
on
the

execution

that was

and

Deposit

the

logical

default

translation

the

are

name

directory
a

and

default

file

protection

logical name

time

indirect command
commands
that

.PAUSE directive

(.SETx)

delete

show

the

Deallocate

file
you

pauses, VAX/VMS places
can use.
Restrictions

presented

Section

no
restrictions
on the use of the

5.11.

Format:

CONTINUE

Example:
>

RUN

TIME

CONTINUE

TEST

4~-APR-1978

The Run
CTRL/Y
display

14:00:55

command initiates
interrupts
TEST.

execution of
The
Time

the date and time.
The
resumption of TEST at the point

the image TEST.
Pressing
command
causes VAX/VMS to

Continue
command
then
requests
where it was interrupted.

Notes:
®

RSX-11M

For

convenience,

the

single

does

not

support

the

character,

this

Continue

command.

command

can

abbreviated

MCR COMMANDS

COPY
4.7

COPY

files.
The Copy command creates a new file from one or more existing
The Copy command can be used to perform the following functions.
e

Copy one file to another file

Concatenate more than one file into a single output file

Copy a group of files to another group of files

Format:

COPY

[keywords] output-file-spec [keywords]
= input-file-spec [keywords],...

keywords

/ALLOCATION=n
/ [NO] CONCATENATE
/ [NO]CONTIGUOUS
/EXTENSION=n
/FILE_MAXIMUM=n
/ [NO]LOG
/ [NOJOVERLAY
/PROTECTION=code

/ [NOIREAD CHECK
/ [NO]REPLACE
/ [NO]TRUNCATE
/ [NO]WRITE_CHECK

output-file-spec

You must specify
Is the name of the output file.
the output file
of
field
one
least
at
For

specification.

specify,

fields

you

that

not

the Copy command uses the related field

of the input file specification(s).

the
If you specify a wild card in any fields of
file specification, the Copy command uses
output

field
related
the
and
specification(s)

of
does

the
not

file
input
concatenate the

output.

and directory
the device
If you specify only
file specification, the
output
the
portion of
input
the
Copy command uses related fields of
file

the

input-file~spec

specification(s)

and

does not concatenate

output.

Specifies the name of a file to

copied.

than one input file, separate
specify more
you
(,)
the file specifications with either a comma
or

a plus

sign

(+).

file
the
in place of
You can use a wild card
Then, all files
or version field.
type,
name,
that satisfy the remaining components are copied.

4-12

MCR COMMANDS

Command

Keywords:

/LOG
/NOLOG
(default)

Indicates

that

the

Copy command

file specifications
of each
the following format.

input

display

file

input-file COPIED TO output-file

(nn RECORDS)

When

the

Copy

command

creating

the

copied

single

output

file from multiple input files, the first message
is followed by messages in the following format.
input-file APPENDED TO output-file
The

Copy command displays
records
or the number of
on
whether
the
file
record-by~record

the

command

/CONCATENATE
(default)

/NOCONCATENATE

end

the

number

of
depending
on
a

basis.

processing,

number

input
keyword

BLOCKS)

copied
copied

block-by-~block

command

displays

When
multiple
provided, this

either
blocks

(nn

files

the

Copy

created.

file
specifications
are
indicates whether a single

output file
satisfy the

is to
input

By default,
output file

the Copy command
produces
a
single
from multiple input files unless:

One

be created from all
file specification.

wild

output

file

specification.

Only
the

cards

the device and
output
file

provided.

are

files

present

that

the

directory portions of
specification
are

File Keywords:

/ALLOCATION=n

the initial allocation of the output
file
to
the number of blocks specified by n.
If this
keyword is not specified, the initial
allocation
of the output file is determined from the size of
the. input file being copied.

/CONTIGUOUS
/NOCONTIGUOUS

Indicates
whether
contiguous;
that

Forces

consecutive

the
output
file
1is
1is,
whether
it
must
physical disk blocks.

to
be
occupy

By default,

the

output

Copy

file
input

in
the
same
file.
If the

Copy

command

output

file,

output

file

If multiple

input

into

may

not

output

1is

not

files

single
be

«create
report an
contiguous.

does

not

creates

format
as the corresponding
input file is contiguous, the

attempts

but

copied

/CONTIGUOUS

command

different

output

file,

contiguous.

contiguous,

keywords.

a contiguous
error if
the

use

the

formats

are

output

file

ensure

that

the

/ALLOCATION

and

MCR COMMANDS

/CONTIGUOUS
/NOCONTIGUOUS
(Cont.)

to
/CONTIGUOUS has no effect when you copy files
tapes because the size of the
from magnetic
or

a
copy
1If you
input file cannot be determined.
one to
use two Copy commands:
tape,
from
file
a
copy the file from tape, and another to create
contiguous file.

/EXTENSION=n

Specifies the number of blocks
output file each time it is
keyword is not specified, the
the output file
attribute of
the

/FILE_MAXIMUM=n

/OVERLAY
/NOOVERLAY
(default)

to be added to the
1If this
extended.
default extension
is determined from

input file.

records
Specifies the maximum number of logical
This qualifier
that the output file can contain.
is valid only for relative files.
Indicates whether data in the input file is to be
into an existing output file overlaying
copied

shorter
1is
file
If the new
the existing data.
the overlaid file, the file is truncated at
than
the
The new file is in
the end of the new file.
same position as the overlaid file.

/OVERLAY is ignored if the output file is written
to a nonfile~structured device.

/PROTECTION=code

/READ_ CHECK
/NOREAD_CHECK
(default)
/REPLACE
/NOREPLACE
(default)

the
to
Defines the protection to be applied
specified
1is
protection
The
file.
output
following the standard rules, described with the
protection
Any
command.
Protection
Set
the
from
taken
are
attributes not specified
current protection of the input file.
Indicates whether the Copy command is to read the
input file(s) twice to verify that all
specified
records have been correctly read.

Requests that, if a file already exists with the
specification as that entered for the
file
same
file be deleted and
output file, the existing
replaced with the contents of the input file(s).
By

default,

the

Copy

command

creates

version of a file if the file already exists.
/TRUNCATE
/NOTRUNCATE
(default)

new

is to copy all
the command
Indicates whether
blocks allocated to the file or only those blocks
that contain data.

Wwhen copying multiple input files into one output

file, you can save space by specifying /TRUNCATE.
all of
If you do not specify /TRUNCATE,
specified file(s)
the
to
allocated
blocks
copied to the output file(s).

WRITE_CHECK

/NOWRITE_ CHECK
(default)

the
are

Indicates whether the Copy command is to read the
output file after it has been written to verify
that the file has been successfully copied and
that the output file can be read without error.

MCR COMMANDS

Examples:
>

COPY

[HICKS]EDWARD.OBJ

[DAVIS]JOSEPH.OBJ

This command copies the
directory
[HICKS]
on
EDWARD.OBJ
.

COPY ALLSRC.FOR

file JOSEPH.OBJ from directory [DAVIS] to
the
default
device
and
names the file

*_,FOR

This command concatenates the highest
versions
of
source
files
in
the
default
directory
into
a

ALLSRC.FOR.

all
FORTRAN
file
named

Notes:
®

RSX-11M does
VAX/VMS, you

The Append

®¢

When

the

support
use PIP

command

you

Files~1ll

not
can

use

wild

file

variation of

cards

Structure

output

the
Copy
command;
instead of Copy.

Level
in

random

the

Copy

/CONCATENATE

files,

the

order.

however,

under

command.
to

input

files

When

you

concatenate

are

copied

concatenate

Files-1l
Structure
Level
2
files,
the Copy command copies
files in alphanumeric order.
When wild cards are used in
the
version field, files are copied in descending order by version
number;
with the

that is, files with the
highest version number.

The VAX/VMS
examples

Command
the use

same

name

Language User's Guide
of the Copy command.

are

copied

provides

starting

additional

MCR COMMANDS

DEALLOCATE
4.8

DEALLOCATE

The
The Deallocate command releases a previously allocated device.
owner
the
when
devices
allocated
any
s
deallocate
lly
system automatica
logs off.

Format:

DEALLOCATE

[keyword]

[device-name]

keyword

/ALL

device-name

Specifies the physical or logical name assigned of

If you omit the
the device to be deallocated.
a
is
controller designator and unit number
physical device name, they default to controller A
and unit 0,

respectively.

Command Keyword:

Requests that all devices currently

/ALL

your process be deallocated.

allocated

1is

the

If you specify /ALL,

you cannot specify a device name.

Example:
>

DEA MTO

This command deallocates the physical device whose
equivalence for the logical name MTO.

name

MCR COMMANDS

DEBUG
4.9
The

DEBUG
Debug

command

program's

invokes

execution

debugger

pressing

after

you

have

CTRL/C or CTRL/Y.

interrupted

1If the

image is

native, the VAX-11l Symbolic Debugger prompts.
If
it
1is
an
RSX-11M
image that was built with ODT, ODT prints a T-bit exception message.
Format:

DEBUG

Example:
>

RUN COPLEY/NODEBUG

DEBUG

'
DBG>

In the example above, typing CTRL/Y
interrupts
execution
of
a
native
image and causes MCR to prompt.
Typing the Debug command
at this point causes the VAX~1l1l debugger to prompt.
>

RUN

PEALE/NODEBUG

“y
>

DEBUG

TE:011454
In the example above, typing CTRL/Y interrupts
RSX-11M image and causes MCR to prompt.
Typing

this point

causes ODT

execution

the

Debug

of
an
command

prompt.

Notes:

If
no

operation.

image

the

currently

interrupted

executing,

program was

not

the Debug

linked

with

command

the

appropriate

debugging
aid
(VAX-11l Symbolic Debugger for native
ODT for RSX-11lM images), the Debug command causes
a
exception condition.
If

the

image

native

image

that

has

not

performs

images or
software

declared

condition
handler,
or if it is an RSX-11lM image that has not
specified a T-bit SST
routine
address,
this
exception
may
cause termination of the image.
@

For details on the use of the debugger,
Symbolic Debugger Reference Manual.

refer

For

exception

details

refer

condition

the VAX/VMS

handling

and

System Services Reference

the

VAX-1ll

conditions,

Manual.

MCR COMMANDS

DELETE
4.10

DELETE

The Delete command deletes files, entries from a
printer
queue,
entries from a batch job queue, and stops the printing of a file.

and

You

can

You specify /ENTRY to delete a batch or printer queue entry.

keywords to control the deletion of
specify any of the remaining
and /EXPIRED keywords determine
/MODIFIED,
The /CREATED,
files.
be deleted based on their creation date, most
to
are
files
whether
and
The /BEFORE
recently modified date, or planned expiration date.
the selection date
in conjunction with
used
keywords are
/SINCE
Delete
by the
keywords to establish the time span to be considered
command.

Format:

DELETE

[keywords]

keywords

file-spec,...

/BEFORE
[= (abs~time) ]
/ [NO]CONFIRM

/CREATED
/ENTRY=jobid,...
/EXPIRED
/ [NO]LOG
/MODIFIED

/SINCE [=(abs~time) ]

file-spec

Specifies the name of a file to be
deleted.
If
than one file specification,
specify more
you
sign
plus
a
or
separate them with a comma (,)
(+).

file
The first file specification must contain a
You can
version number.
and
type,
file
name,
Subsequent
cards.
specify these fields as wild
specifications can omit any of these fields
file
file
first
the
number ;
version
except
for additional
specification provides defaults
file specifications.

is
If you specify /ENTRY, the file specification
the name of the queue in which a printer or batch

job was entered.

Command Keywords:

that have a
RE Chooses only those specified files
[= (abs-time)]
/BEFO
The
specified date.
selection date before the
/BEFORE [=TODAY]

either as an
specified
be
can
selection date
2.7.6.1
Section
as TODAY.
or
absolute date
explains how to specify an absolute time.
you
If
deletes

command
the
specify /BEFORE,
not
do
specified files regardless of date,
all

unless /SINCE

is specified.

a
supply
not
do
but
/BEFORE
specify
If you
selection date, the Delete command uses TODAY by
files
that is, the command deletes all
default;
created or modified yesterday or before.

MCR COMMANDS

/CONFIRM
/NOCONFIRM

(default)

Requests the command
to display the
file before it is deleted and
wait

name
for

of each
you
to

type
a
confirmation.
If you type Y in response
to the message, the file is deleted.
Any
other
response causes the file to be retained.

/CREATED

Requests that
specified
file
be
selected
for
deletion
based
on
their
<creation
date.
This
keyword is meaningful only when /BEFORE or /SINCE
is specified.
The default selection date is
both
the
date and the most recently modified date.

/ENTRY=jobid,
...

created

Specifies the job identification of the job to be
deleted
from
a
printer or batch job queue.
If
you specify more
than
one
job
identification,
separate
them
with
a comma (,) and enclose the
list in parentheses.
The system assigns a unigue entry number,
called
a
Jjob
identification,
to each spool printer or
batch job in the system.
The job
identification
is
displayed
by
the
Print and Submit commands
when the job is gueued.
You also
can
determine
the
job identification of a queued job using the
Show Queue command.
If you specify /ENTRY,
specified.

/EXPIRED

date

(default)

other.-

keywords

Selects
specified
files
according
planned
expiration
date.
This
meaningful
only
when
/BEFORE
or
specified.
The

/LOG
/NOLOG

default
and

selection

the

most

Determines

whether

file

If
the

date

can

to
their
keyword
is
/SINCE
is

both

the

recently modified

date.

created

the file specification of each
displayed as the file
1is
deleted.

you specify /LOG, the delete
following information:

command

displays

devcu: [dir] filename.type;version deleted

/MODIFIED

Selects specified files according to the date
on
which
they
were
most
recently modified.
This
keyword is the default
and
1is
meaningful
only
when /BEFORE or /SINCE is specified.

/SINCE[=(abs~-time)]
/SINCE [=YESTERDAY]

Chooses
only
selection date

those specified files that
have a
after
the
specified
date.
The
selection
date
can
be
specified
either as an
absolute time or as YESTERDAY.
Section
2.7.6.1
explains how to specify an absolute time.

If you do not specify /SINCE, the
the
specified
files
regardless
/BEFORE is specified.
If
you
specify
/SINCE
but
do
selection date, the Delete command
by default;
that is,
specified files with a

4-19

command deletes
of date, unless

not
supply
a
uses YESTERDAY
the
command
deletes
all
selection date of today.

MCR COMMANDS

Examples:

DELETE /SINCE=(11:30)

INPUT.DAT;*

This command deletes all versions of
or modified after 11:30 today.

DELETE/ENTRY=243

the

file

INPUT.DAT

created

SYSS$PRINT

This command deletes from the printer queue named
SYSS$PRINT
the
print
job
with the identification 243,
1If the job is currently
being printed, printing stops.
>

DELETE/ENTRY=634

SYSSBATCH

This command deletes from the batch
gqueue
batch job with the identification 634.
Note:

RSX-11M

does

not

support

this

command.

named

SYS$BATCH

the

MCR COMMANDS

DEPOSIT
4.11

DEPOSIT

The Deposit command replaces the contents of a specified
1location
virtual memory.
After the contents are replaced, Deposit displays
location and the newly deposited data as follows:
address:

in
the

contents

The Deposit command converts the
placing it in virtual memory.

specified

value

binary

before

If the address specified can be read, but
not
written,
the
current
contents
of
the location are not altered, but are displayed.
If the
address specified cannot be read
or
written,
asterisks
(****)
gare
displayed.
When used with the Examine command, the Deposit command can aid in the
debugging of programs interactively.
It is not necessary to link with
a debugger to use these commands.
Format:

DEPOSIT

[keywords]

address=data

keywords

/ASCII
/BYTE
/DECIMAL
/HEXADECIMAL
/LONGWORD
/OCTAL
/WORD

address

The virtual address
are to be changed.

within the virtual
currently
running
read/write for user

[,...]

of a location
whose
contents
The specified location must be
address
space
of
the
image
in the process, and it must be
access mode.

You can specify the location as
a
symbolic
name
that
has
been
assigned
a value equivalent to a
virtual memory location.

The

arithmetic

operators

+,
~,
*,
and
/
can
be
wused
to
express the
location.
The
value
of
a
symbol
used
1in
an
expression always is interpreted in the radix used
to define it.
Any
numeric
value
used
1in
the
expression is interpreted according
default
radix
of
the
command.
examples

to the
Refer

current
to
the

below.

The Deposit and Examine commands set a pointer
to
the
byte
following
the last byte modified.
You
can refer to this pointer as
"."
for
the
first
location in a subsequent Examine command or as the
deposit location in a subsequent Deposit command.

MCR COMMANDS

Data to be deposited into the specified
1location.
If
you
specify
a
1list
of
data,
the
data is
deposited into consecutive locations beginning
at
the
specified
1location.
By
default,
data
1is
assumed to be in hexadecimal format.

data

The Deposit command converts the
binary
and
writes
it into the
memory location.

specified data to
specified virtual

Command Keywords:

Indicates

/ASCII

that the

data

specified

1is

ASCII

format.

When
ASCII
1is
specified
or
1is
the
default,
hexadecimal
1is
the
default
radix
for
numeric
literals.
The address specified is interpreted as
a hexadecimal address.

/BYTE

Specifies that data is to be deposited one byte at
a
time.
If
the data specified is longer than a
byte, an error message is displayed.

/DECIMAL

Indicates
that
the
default
literals and displayed values

/HEXADECIMAL

Indicates
that
the
default
radix
for
numeric
literals
and
displayed
values
1is
hexadecimal.
This is the initial default of the command;
refer
to

notes

radix
for
is decimal.

numeric

below.

/LONGWORD

Specifies
that
data
longword
at
a time.
of the command;
refer

/OCTAL

Indicates
that
the
default
literals and displayed values

/WORD

Specifies that data
a time.

1is
to
be
deposited
one
This is the initial default
to notes below.

radix
for
is octal.

numeric

to be deposited one word

Examples:
>

RUN

RSXPROG

EXAMINE/OCT/WORD
2332
000004DA:
007402

DEPOSIT

CONTINUE

.
000004DA:

777

000777

CTRL/Y

interrupts execution of the RSX~-11M
image
RSXPROG.
The
Examine
command
establishes
the
radix as octal and the length
unit
as
a
word
and
displays
the
content
of
1location
4DA
(hexadecimal).
The Deposit command then deposits the octal value
777

location

4DA.

4-22

.SETN BASE

MCR COMMANDS

RUN

EXAMINE

%X200

XYZ

BASE:BASE+20

00000200:
00037C02
O0O0O3CFFO0 6D756E20
0000021C:
OF13CBAl
0C07040A
DEPOSIT BASE+16=0723C1DO0

2C726562

646E6520

74697720

39392068

CONTINUE

the

sequence

above,

the

.SETN

directive,

typed

interactively

at
the
terminal,
defines the symbol BASE as being equal to 200
(hexadecimal).
Refer to Section 5.7 for a description of numeric
literals
under
VAX/VMS.
The
Examine
command
displays
the
contents

(hexadecimal).
(hexadecimal).

locations

200

The

command deposits data

In
the
example
therefore,
data
the

default were

location derived

Deposit

(hexadecimal)

above,

hexadecimal
1is
1is deposited at location

octal,

from

the

200

data

would

(hexadecimal)

the

through

220

location

216

default
radix;
(hexadecimal).
If

deposited

plus

the

(octal).

Notes:

The
1initial
default
radix
for
the
Deposit
command
is
hexadecimal.
The
default applies to both the interpretation
of numeric literals in the command line and to the
data.
If
you
use
a
radix
keyword
to modify the command, that radix
becomes
the
default
for
subsequent
Deposit
and
Examine
commands.

The

initial

longword.

default
The

length

Examine

unit

command

for

the

displays

Deposit
data

command

one

longword

time with blanks between longwords.
1If you
use
a
/BYTE
/WORD
keyword
to
modify
the command, that unit becomes
default
®

RSX-11M

the

RSX-11M

For

for

subsequent

images

same
does

start

starting
not

convenience,

single character,

Deposit

the

virtual

address

support

and

this

Deposit

Examine

address

that

or
the

commands.
under

they have

VAX/VMS;

under

this

RSX-11M.

command.
command

can

abbreviated

the

MCR COMMANDS

DIRECTORY
4,12

DIRECTORY

The Directory command provides a list of files or
file or group of

files.

information about

Format:

DIRECTORY

[keywords]

[file-spec,...]

keywords

/BRIEF
/FULL
/OUTPUT=file-spec
/PRINTER

file-spec

Specifies the names of files to
be
listed.
The
syntax
of
a
file
specification determines what
file(s) are listed, as follows:
e

If you do not enter a file
specification,
Directory
command
1lists
all
files
in

the
your

current default directory.

If
you
specify
only
a
device
name,
the
Directory
command
uses your default directory
name.

not
does
specification
file
the
Whenever
include a file name and file type, all versions
of all files in
the
specified
directory
are
listed.

If a file specification contains
a
file
name
and/or
file
type
and
no version number, the
Directory command lists
the
highest
existing
version.

If a file specification contains
only
a
file
name, the Directory command assumes a null file
type;
an unpunctuated item is assumed to be
a
file

name.

If you specify more than one
file,
separate
the
a comma (,) or
either
with
specifications
file
You can use wild cards in place of
plus sign (+).
name, file type, or version
file
directory,
the
files
all
fields of a file specification to list
that satisfy the components you specify.
Command Keywords:
/BRIEF

Lists only the file name,
each file specified.

/FULL

Lists

the

specified

following

files:

Disk

Date and time that the

type,

and

information

version

about

the

command

was

and directory name

DIRECTORY

* ,CMD;
*

DIRECTORY

DBAl:([122,20]

08-JUL-78

05:30

29-FEB-76

COMPILE.CMD;15

04-JAN-78

07:10

COMPILE.CMD;16

04-JAN-78

07:15

This

command
versions
of
directory.

displays

DIRECTORY/FULL

*.CMD

DIRECTORY

:[122,20]

DBAl

08-JUL-78

the
files

directory

file

type

information
for
all
of CMD in the default

(556,22)

1./1.

29-FEB-76

15:36

(6453,13)

[122,20]

4./5.

[RWED,RWED,R,R]

04-JAN-78

07:15

[122,20]

[RWED,RWED,RWED,R]

command displays

version

default
with
a

11:40

This

all

15:36

directory.

all

full

files

directory

with

information

file

type

for
CMD

the
in

the

highest
default

MCR COMMANDS

Notes:

switch

with

PIP

perform

You can use the /LI

RSX-11M does not support the Directory command.

functions as the Directory command.

the

same

MCR COMMANDS

DMOUNT
4.13

DISMOUNT

The Dismount

command

releases

command.

volumes previously specified

Mount

Format:

DMOUNT [keyword]
keyword

device-name[:]
/ [NO] UNLOAD

device-name

Specifies
The

the

device

logical

name

can

the

device

a physical

name.

dismounted.

device

name

If you specify a colon following the device
the command interpreter strips the colon.

name,

Command Keyword:

/UNLOAD (default)
/NOUNLOAD

Indicates
unloaded.
button

the

want

that
the
/UNLOAD is

on the drive to
default action;

the

unit

device
is
equivalent

remain

unload

to be physically
to
pressing
the

the volume.
specify /NOUNLOAD

/UNLOAD

loaded.

you

Example:

MOU/SHARE

DMO

DBA3:PR0OJ123

DISK

The

Mount command requests access to the volume
labeled
PROJ123
DBA3 and places the logical name DISK in the current process's
logical name table.
Because the volume was requested
using
the

/SHARE
other

keyword,

the

users.

volume may or

may not

already be mounted

The

Dismount command releases access to the
volume
PROJ123
for
the
current
process
and removes the name DISK from the process
logical name table.
The actual dismounting does not occur
until
all accessors have issued dismount commands.
Notes:

the

volume

dismounted
it.

has

until

been

mounted

all

used who

Dismounting a volume causes the
volume
by
the
previous Mount

/SHARE,

have mounted

1is

not

it have

actually

dismounted

logical name assigned
to
the
command to be removed from the
The logical
name
is
either
command or the default name of

appropriate logical name table.
the
one specified in the Mount
DISK$volume-label or TAPES$volume-label.

MCR COMMANDS

If a volume is mounted /SYSTEM or /GROUP, a dismount command
causes the volume to be dismounted even if others are
However, dismounting the volume also
currently using it.
results in removing the name from the system or group logical
name table, which requires privilege.

I1f the device has been allocated with an Allocate command,
remains allocated after the volume is dismounted.

If the volume has been mounted using the /NOSHARE keyword, the
system automatically allocates the device at mount time and

deallocates it when the volume is dismounted.
RSX-11M supports the Dismount command.

MCR COMMANDS

EXAMINE
4.14

EXAMINE

The

Examine command displays the contents of
terminal.
It
1is
wused
after
an
RSX-11M
interrupted by
CTRL/Y.
If
you
interrupt
executing,
you
can examine its locations;
execution by issuing a Continue command.

The

information

location:

image with

the

memory
at
the
or native image has been
an
image
while
it
is
then you can resume image

following

format.

content

Information
that
asterisks (***%)

When used
debugging

displayed

virtual

1is

inaccessible

user

mode

displayed

with the Deposit command, the Examine command
can aid in
of programs interactively.
It is not necessary to link

the
the

a debugger

use

these

commands.

Format:

EXAMINE

keywords

[keywords]

location[:location]

/ASCII
/BYTE

/DECIMAL
/HEXADECIMAL
/LONGWORD
/OCTAL
/WORD
location

Specifies the address or
range
virtual
memory to be displayed.
range

addresses

addresses,

with

specified

arithmetic
name

also

you

must

of
If

addresses
in
you specify a

separate

the

two

colon
().
Locations can be
using
expressions
that
contain
the
operators
+, -, *, and /.
A symbolic

can

value
of a
interpreted

used

express

address.

The

symbol used in an expression always is
in the radix used to define
it.
Any
numeric
value
used
in
the
expression
is
interpreted according to the current defaul
t radix
of the command.
Refer to the examples below.
Addresses
radix.
The
the

always

Examine and
last
byte

are

displayed

Deposit commands
examined;
you

set
can

hexadecimal

a pointer
to
refer to this

pointer as "." when specifying the first
location
in
a subsequent Examine command or as the deposi
t
location in a subsequent Deposit command.

MCR COMMANDS

Command Keywords:
/ASCII

is
Indicates that data at the specified location
y
to be displayed in ASCII representation. Binar
are

values that do

not

displayed as periods

When ASCII
hexadecimal
literals.

is
is

have
(.).

ASCII

equivalents

default,
specified or 1is the
numeric
for
radix
lt
defau
the

Indicates that data at the specified

/BYTE

to be displayed one byte at a time.

Indicates that the data
decimal representation

/DECIMAL

location

1is to Dbe displayed 1in
and changes the default

radix for numeric literals.

ayed 1in
Indicates that the data is to be esdispl
default
the
chang
and
tion
senta
repre
l
hexadecima
initial
the
is
This
radix for numeric literals.

/HEXADECIMAL

default of the command;

refer to notes below.

location is
Indicates that data at the specified time.
This is
a
at
to be displayed one longword
to
refer
nd;
comma
the
of
lt
defau
the initial

/LONGWORD

notes below.

ayed in
Indicates that the data is to be displ
lt radix
defau
the
es
chang
and
tion
octal representa

/OCTAL

for numeric literals.

Indicates that data at the specified

/WORD

to be displayed one word at a time.

location

Examples:

> RUN RSXPROG

*
”~

> EXAMINE/WORD/OCT 2677
000005BF:

007402

> CONTINUE

the RSX-11M image RSXPROG.
The RUN command begins execution of CTRL/
Y function interrupts it.
image 1is running, the
the
While
contents of the word
the
that
sts
reque
d
The Examine comman
5BF (hexadecimal) be
ion
virtual memory 1locat
addresses
Continue command
the
y,
displa
the
After
displayed in octal.
causes image execution to be resumed.

MCR COMMANDS

RUN VAXPROG

EXAMINE/LONG/ASC

Y
1C00+50:1C00+7F

00001C50:

FOOLISH
EXA 1C80:1C83

00001C80:

CONSISTENCY

THE

HOBGOBLIN OF

LITTLE

1INDS

While the native image VAXPROG is executing,
it is interrupted by
CTRL/C.
The
Examine command then requests that all the
data in
the
wvirtual
address
range
specified
be
displayed
in
ASCII
representation.

hexadecimal
>

RUN

EXAMINE

BASE

the

addresses

are

expressed

such.

$%X200

BASE:BASE+20

00000200:
0000021C:

143F4D00

1537FF3C

00032479

...

CONTINUE

”~

EXAMINE/WORD/OCTAL

00000200:
>

that

interpreted

.SETN

are

ABC

Note

and

004672

BASE:BASE+20

467013

...

CONTINUE

the

sequence

terminal,

above,

the

defines

.SETN
the

directive,
symbol

(hexadecimal).
The first Examine
of
location
200
(hexadecimal)

contents

the

second

displayed.
the

radix

locations

Examine

the

command

numeric

displays

through

220

content

uses

value

the

(20)

radix

for

equal

200

the
contents
(hexadecimal).
The

current
the

interactively

being

command

displayed.

command,

The Examine
for

are

typed

BASE

locations

radix

expression.

are

(octal)

Notes:
e

The

1initial

hexadecimal.
of
numeric

default

representation

keyword

the

Examine

command

The
default applies to both the
1literals
in
the
command
line
the

data

displayed.

and
you

for

to modify the command, that radix becomes
subsequent Examine and Deposit commands.

The

initial

longword.

default

The

length

Examine

unit

command

for

the

displays

Examine

data

interpretation
to

the

radix

use

the

default

command

one

longword

time with blanks between longwords.
If you
use
a
/BYTE
/WORD
keyword
to
modify
the command, that unit becomes
default for subsequent Examine or Deposit command
s.
®

RSX-11lM

is
®

For

the

images

same

start

starting

convenience,

single

character,

the

virtual

address

that

Examine

command

under

they have
can

VAX/VMS;

under

or
the

this

RSX-11M.

abbreviated

MCR COMMANDS

Execute Procedure (@)
4.15

EXECUTE PROCEDURE

file

(@)

an indirect command
The Execute procedure (@) requests execution of read
subsequent command
requests

the command interpreter to

input from a specified file or device.

Format:

[pl [p2 [...p8]1]]

@file-spec [keyword]
keyword

/OUTPUT=file-spec

file-spec

Specifies the command procedure to be executed,
or the device from which input for the preceding

/DELETE

command

is to be read.

If you do not specify a
command interpreter uses

file type, the MCR
the default file type

CMD.

pl,p2,...p8

Specify from one to eight optional parameters to
The
command file.
indirect
the
to
pass

parameters assign numeric or character string
values to the symbols, Pl, P2, and so on up to P8
in the order of entry. The symbols are local to
Unspecified
file.
command
indirect
the
parameters are set to null strings.
each parameter with one or more blanks.

Separate

parameter

You can specify a numeric value for

using any valid arithmetic expression. You also
can specify a character string value using any
alphanumeric or special characters, with the
following restrictions:

If the first parameter begins with a slash
must enclose the parameter in
you
(/),

quotation marks.

To pass a parameter
place the
blanks,

that contains embedded
parameter in quotation

marks.

To pass a parameter that contains literal
quotation marks, enclose the entire string in
guotation marks and wuse a double set of
the string, for
within
marks
quotation
example:

each

strips

case

the

set

"NEVER

above,

the entire string.

SAY

the

llllDIEllllll

command

interpreter

of quotation marks that enclose

MCR COMMANDS

Command Keyword:
/OUTPUT=file-spec

Requests that all output directed to the
logical
device
SYSSOUTPUT
be
written
to
the
file or
device specified.
System
responses
and
error
messages
to

the

are

written

specified

the

terminal

If you specify /OUTPUT, the keyword
must
the
file
specification
of the indirect
file.

/DELETE

Requests
deleted

that
after

well

file.

the
is

indirect

command

follow
command

file

closed.

Examples:
>

@STDJOB.CMD

This

PAYROL

command

PAYROL.CMD

indirect

FICA

requests
and

command

execution

provides

file

two

contains

the

indirect

parameters,

the

following

PAYROL

command
and

commands.

FICA.

file
The

RUN 'P1
PRINT 'P1'.DAT
RUN 'P2
PRINT 'P2'.DAT
When
are
that

the indirect command file is executed,
the
two
parameters
substituted
into the Run and Print commands.
The result is
the indirect command file runs PAYROL.EXE and
FICA.EXE
and
prints the files PAYROL.DAT and FICA.DAT.

Notes:

You

can

cause

symbol

substitution

enclosing

symbol

single quotation marks.
Refer to the VAX/VMS Command Language
User's
Guide
for
further
information
on
symbols
and
substitution.
®

When an indirect command file
remain open are closed by the

terminates,

any

MCR command

interpreter.

data

files

that

MCR COMMANDS

EXIT
4.16

EXIT

indirect
The Exit command terminates the processing of the current
If the indirect file was executing within another
command file.
indirect command file, control returns to the outer file.
the
The Exit command is used primarily to terminate execution of
current
indirect file and also maintain the status as it was prior to
execution of the Exit command.

Format:

EXIT

[status—-code]

Defines a value for the symbol $STATUS,

status-code

used

higher

return

command

which

|is

code to be tested by the next

level.

If you do not specify a status code,
the
current
$STATUS is not changed and
symbol
the
of
value
control returns to the outer level with the status
of the most recently executed command or program.

The
command
interpreter
uses
numeric
values
returned
by
commands
or
programs to locate and
display error messages.
Each system message has a
unique
value
associated with it.
If you specify
an even numeric value as a
status
code,
it
may
cause the command interpreter to display a message
that you would not expect.

If you specify an odd value for a status code, the
command interpreter does not display a message.
Example:
>QLEVEL

This command requests execution
of
the
indirect
command
file
LEVEL1.CMD.
1It, in turn, contains a command requesting execution
of the indirect command file LEVEL2.CMD.
LEVEL2.CMD contains the
following sequence, which causes a return to LEVEL1.CMD.
ON WARNING

RUN

.GOTO ABEND

LAST

EXIT

.ABEND:

EXIT 7

The LEVEL2 command file contains an

command

that

causes

An error results in
1label ABEND if any error occurs.
to
branch
no
If
7.
of
value
an exit from LEVEL2 with $STATUS having a
the status value supplied by
exits with
LEVEL2
occurs,
error

LAST.

MCR COMMANDS

When LEVELl regains control,
the following command.

.IF

$STATUS EQ

$STATUS

LEVEL2
LEVEL2

is equal

command
commands

EXIT.

that

file,
LEVELl1
continues.

tests

is,

the

value

an error

exits;

$STATUS

occurred

otherwise,

using

execution

the
of

Notes:

Specifying the Exit command is equivalent using a slash
an
RSX-11lM
indirect
file.
VAX/VMS also supports the
slashes in indirect files.

RSX-11M does

not

support

the

Exit

command.

(/)
use

in
of

MCR COMMANDS

INITIALIZE
4.17

The

INITIALIZE

Initialize command

formats and writes a label on

mass

storage

volume.
The
default
format
for disk volumes created using the MCR
command Initialize is Files-11
Structure
Level
1.
The
1Initialize
command
also
can initialize Files-11l Structure Level 2 volumes.
The
default format for magnetic tape volumes is the ANSI standard for tape
labels,

Level

III.

You do not need any special privileges to initialize a blank
disk
or
tape
volume.
If a volume has:'previously been written, however, your
UIC must match the owner UIC on the volume, or you must have the
user
privilege
to
override volume protection.
1In the case of a tape that
has been written, you can initialize the volume
if
you
are
allowed
write access

it,

Format:

INITIALIZE
keywords

[keywords]

device-name:

volume-label

/ACCESSED=n (D)
/BADBLOCKS=1list (D)
/CLUSTER_SIZE=n (D)
/DATA_CHECK[=options,...]
/DENSITY=n

/DIRECTORIES=n (D)
/EXTENSION=n (D)
/FILE_PROTECTION=code
/GROUP (D)
/HEADERS=n (D)
/INDEX=position (D)
/MAXIMUM_FILES=n (D)
/OVERRIDE=options,...
/OWNER_UIC=uic
/PROTECTION=code
/SHARE

(D)

(T)

(D)

(T)

(D)

/STRUCTURE=1level (D)
/SYSTEM (D)
/USER_NAME=string (D)
/ [NO]VERIFIED (D)
/WINDOWS=n (D)

D = applicable to disk only.
T = applicable to tape only.

Keyword descriptions are

categorized

accordingly

below.

device-name

Specifies the name of
the
device
on
which
the
volume
to
be
initialized is physically mounted.
The device does not have to
be
allocated
first;
however,

volume-label

the

recommended practice.

Specifies the label to be written on
the
volume.
For a disk volume, you can specify a maximum of 12
alphanumeric characters;
for a tape
volume,
you
can
specify
a
max imum
of
6
alphanumeric
characters.

MCR COMMANDS

Keywords Applicable

/OWNER_UIC=[g,m]

to Disk

and Tape:

Specifies the user
identification
code
to
be
assigned
ownership
of the volume and of system
files on the volume.
The group (g)
and
member
(m)
range

The

fields
of
0 through

brackets

If you
UIC is

/PROTECTION=code

the
377

are

UIC

can

have

value

the

(octal).

required.

do not specify /OWNER UIC,
your
assigned ownership of the volume.

current

Specifies the protection to be
applied
to
the
volume.
The
protection determines which users
can read files, write files, create directories,
and delete files on the volume.
Specify the protection
code
according
standard
syntax
rules
described
1in
2,7.5.

you

category

specifying
protection,
all accesss,.

that

all

types

wuser

category

when

is denied

The system applies only read
and
write
access
restrictions
for
magnetic
tapes;
create and
delete are meaningless.
1In addition,
both
the
system
and
the
owner are given read and write
access

regardless

protection

what

you

specify

1in

the

code.

Keywords Applicable Only to Disk:
/ACCESSED=n

Specifies
the
number
of
directories
to
be
maintained
in
system
space
for ready access.
The
maximum
value
of
n
1is
255.
Operator
privilege
1is
required
to
use
the
/ACCESSED
keyword.
If you do not specify /ACCESSED, the
command uses a value of 3 by default.

/BADBLOCKS=1list

Specifies those areas on
faulty.
The Initialize
as

allocated

You

can

both

that

specify one
of

the

the
volume
command marks

no data

formats

specify
more
than
one
specifications with a comma
in parentheses.
1bn{:count]

1Initialize

that
are
the areas

written

areas

using

shown

below.

area,
and enclose

them.

either
If

Specifies a logical
block number on the
disk volume and,
optionally, a count

logical blocks
beginning with the
logical block
specified, to be
marked

you

separate
the list

allocated.

MCR COMMANDS

sector.track.cyl[:count]

Specifies a specific
sector, track, and

cylinder
volume

on the disk

and,

optionally, a count of
blocks beginning with
the first block
specified to be marked
allocated.

/BADBLOCKS
Use
of
the
keyword
It is not required for
dependent.

is
device
RK06 and RMO3
that
have
nor is it required for disks
disks;
bad
blocks
using
the
BAD
been
scanned
for
is
described
in
the
which
utility
program,
VAX/VMS Operator's Guide.
/CLUSTER SIZE=n

allocation
unit.
Defines in blocks the default
of n is 1/100 of the volume
The
maximum
value
The minimum value is calculated using the
size.
following formula:
minimum = disk size
255 * 4096
If

you

/CLUSTER_SIZE,
the
not
specify
command uses the following values by

Initialize
default.

Default

Device

4
6
6
11

RP06

You cannot
1

Size

RK06
RKO7
RMO3
RP04/5

level

Cluster

specify /CLUSTER_SIZE

for

structure

volumes.

/DATA_CHECK [=options,...]

/NODATA_CHECK
(default)

default
for
data
check operations
Defines
a
operations
on
following all read and/or
write
the
volume.
You can specify either or both of
the following options:
READ

Performs data
operations

checks

after

all

read

WRITE

Performs data checks
operations

after

all

write

If you

option,
By

specify /DATA CHECK without specifying an
the
system
assumes /DATA CHECK=WRITE.

default,

the

system

performs

data

override
the checking you
checking.
You
can
specify at initialization when you issue a Mount
command for the volume.
You cannot
specify
level 1 volumes.

/DATA_CHECK

for

structure

MCR COMMANDS

/DIRECTORIES=n

Specifies
for
user

the number of
directories.

entries
to
preallocate
The
maximum allowable

value of n is
/DIRECTORIES,
value

/EXTENSION=n

16000.
If
you
the
1Initialize
by default.

do
not
command

specify
uses
a

Specifies the number
of
blocks
to
use
as
a
default
extension
size
for
all
files on the
volume.
The default extension size is used when
a file being updated increases to a size greater
than
1its
initial
allocation.
The
maximum
allowable value of n is 65535,
If

you

the

not

specify

Initialize

/FILE_PROTECTION=code Defines

the

default

command uses

file protection

files on the volume.

size,

applied

all

protection,

Specify the code according

to the standard syntax rules
described in Section 2.7.5.

This

extension

a value

default protection

for

not

used

when

volume is being used on a VAX/VMS system.
used on
RSX-11lM
systems.
VAX/VMS
wuses
default file protection.

/GROUP

Defines

a disk

volume as

owner
number

UIC
of
the volume
of the user issuing

member

number

group

volume.

0.
volume
group.

Specifies the
number
of
file
headers
to
allocated
1initially
for
the
1index
file.
default, the
1Initialize
command
allocates
file headers.
The

minimum allowable

/MAXIMUM FILES
/INDEX=position

The

defaults to the group
the
command
and
a

The
/GROUP
keyword
establishes
the
protection as RWED for system, owner, and

/HEADERS=n

the
It is
your

value

qualifier

specifies

1is

16.

be
By
16

The

the maximum.

Requests that the index file
for
the
volume's
directory
structure
be
placed
in
a specific
location on the volume.
You can specify one
of
the following options:
BEGINNING

Places

the

index

beginning of
MIDDLE

END

Places

the

volume.

the

Places

the
BLOCK:n

the

index

the

index

file

the

volume.
file

the

middle

file

the

end

file

volume.

Places

the

beginning

index

the

logical

the

block

specified.
By default, the Initialize
index file in the middle of

command
places
the volume.

the

MCR COMMANDS

/MAXIMUM_FILES=n

Restricts the maximum number of files
that
the
volume
can
contain.
If
you
do
not specify
/MAXIMUM_FILES, Initialize
wuses
the
following
values

by default.

Device

Default File Maximum
4000
8000
15000
25000
15000
123

RK06 Disk
RKO7
RP04/RP05 Disk
RP06 Disk
RMO3
Floppy

The maximum size you can specify for any
volume
is the volume size in blocks divided by (cluster
factor plus

1).

You cannot change the maximum file
1limit
volume without reinitializing the volume.
/SHARE (default)
/NOSHARE

Defines
a
disk
volume
as
shareable.
protection code for the volume defaults
to
types of access for all categories of user.

a
The
all

Specifying /NOSHARE sets protection to no access
for
/STRUCTURE=1level

group and world.

Indicates the structure level of the volume.
1If
you
do not specify /STRUCTURE=2, the Initialize
Files-11
a
as
volume
command initializes the
Structure Level 1 volume, by default.

If you specify /STRUCTURE=1l,

/CLUSTER_SIZE
/SYSTEM

DATA_CHECK.

you cannot

specify

Defines a disk volume as a system
volume.
The
the volume defaults to [1,1] and
of
UIC
owner
default protection allows all types of access to
the volume

for

all

users.

No user privilege is required to use the /SYSTEM
only users with system UICs
however,
keyword;
can create directories on system volumes.

/USER NAME=string

to
Specifies a user name of up to 12 characters
be
recorded
on
the volume.
If not specified,
the Initialize command uses the user name
under
which you logged

/VERIFIED (default)
/NOVERIFIED

Indicates whether the disk has bad block data on
disks
that
The Initialize command assumes
it.

contain bad block data and uses the data to mark
Use /NOVERIFIED to
the bad blocks as allocated.
to ignore bad block data on
1Initialize
request
the

/WINDOWS=n

in.

disk.

be
to
Specifies the number of mapping pointers
When a file is
for the file windows.
allocated
mapping
the
system uses
file
the
opened,
The
file.
the
in
data
access
to
pointers
is
also
this
default number of pointers is 7;
the
minimum
allowable value of n.
The maximum
value of

80.

MCR COMMANDS

Keywords Applicable Only to Tape:
/DENSITY=n

Specifies the density in bits per inch (bpi)
which
the
tape
1is
to
be
written.
You
specify a density of either 800 or 1600.

at
can

If you do not specify /DENSITY for a blank tape,
the
system
uses a default density of 1600 bpi.
If you do not specify a density for a previously

written
tape,
the
system
uses
which the tape was last written.
/OVERRIDE=options,...

the density at

Requests
that
the
accessibility
or
the
expiration
date
specified
for
the
tape
be
overridden.
One of the following keywords
must
be specified as an option:
ACCESSIBILITY

1Indicates

that

the

accessibility

specified in nonblank header 1
and volume 1 labels of the tape
is to be overridden.
VAX/VMS
never writes in these fields.
EXPIRATION

Requests

the

ignore

the

Initialize

command

expiration date

a tape volume;
the date is
indicated by the expiration date
of the first file on the volume.
You

must be the owner of a tape volume
or
have
the user privilege to override volume protection
to initialize a tape that has
not
reached
its

expiration
field.

date

has

a nonblank

accessibility

If you specify both
keywords
enclose
them
parentheses and separate them with a comma.

1in

Examples:

INITIALIZE/STRUCTURE=1

This

command

structure
>

DBB2:MYVOL

initializes

level

the disk

volume

volume.

device

DBB2

@QCMDFIL.CMD
-

INI

DB2:MYVOL

the

sequence

above,

contains
a command to
format compatible with

the

indirect

command

When the command is executed, VAX/VMS maps
its RSX-11M format to the VAX/VMS physical

this

case DBA2.

file

CMDFIL.CMD

initialize a volume.
This command
the RSX-11M Initvolume command.
the device
device name

name
from
format, in

MCR COMMANDS

Note:

Many of the Initialize command keywords are used

maximize

For information on these parameters,
input/output efficiency.
see the VAX/VMS System Manager's Guide.

MCR COMMANDS

LINK
4.18

LINK

The Link command invokes the VAX-1ll Linker to link one
modules into a program image and defines the execution
of the image.

or more
object
characteristics

Format:

LINK

[keywords]

exe-file-spec

[,map-file-spec][,stb-file-spec]

input-file-spec

[keywords],...

keywords

/BRIEF
/ [NO] CROSS_REFERENCE
/ [NO]DEBUG [=file~spec]
/FULL
/INCLUDE=module-name([,...]
/LIBRARY
/OPTIONS
/SELECTIVE_SEARCH
/SHAREABLE
/ [NO]SYSLIB
/ [NO] SYSSHR
/SYSTEM[=base-address]
/ [NO] TRACEBACK

exe-file-spec

Provides

image

the

file

file.

executable

map-file-spec

Provides

image

the

allocation

specification

default,
with

file

for

the

file

type

specification

map.

the

linker

output

creates

EXE.

for

the

The

memory

file
specification can be
followed by any of the keywords, /BRIEF, /FULL, or
/CROSS_REFERENCE
to
control
the contents of the

map.

the
e

you

not

map contains
All

specify

the

any

the

information

included

listing
@

user-defined

program

A list of
by name

user-defined

global

you

Link
file.

list

not

provide

command

does
omit

1If you

uses

MAP

You

must

use

parameter
present.

the
a

from

not
the

the

keywords,

file

the

brief

sections

symbols

ordered

specification,

the

produce a memory allocation
file type, the Link command

default
comma

these

following.

type.
separate

the

map-file-spec

exe-file-spec
parameter,

MCR COMMANDS

stb-file-spec

Provides the file specification for a symbol table

file containing symbol definitions for all symbols
The symbol table file is in object
in the image.
1in subsequent
It can be used
format.
module

linking operations to provide
to other

images.

symbol

definitions

If you omit the symbol table file specification,
command does not produce a symbol table
the Link
If you omit the file type, the Link command
file.
uses STB by default.

You must use a comma to separate the map-file-spec
stb-file-spec parameter, if
from the
parameter
present.

file,
If you want a symbol table file, but no map
stb-file-spec
exe-file-spec and
the
separate

parameters with two commas:

LINK A.EXE, ,A.STB=A.0OBJ
input-file-spec

files.
input
more
to
object modules

Specifies one or
be
can
files

references,
to be
are
options
an
or
included,
All input to the linker must be

libraries to be searched for external
that
containing modules
libraries

unconditionally
description file.

input
The
linked,
be

code.

native VAX-1l1l

the
If you specify multiple input files, separate
specifications with a comma (,) or plus sign
file
single
1In either case, the linker creates a
(+).
image

file.

If you do not specify a file type in an input file
supplies default file
the 1linker
specification,
All object
types based on the nature of the file.

modules are assumed to have a file type of OBJ.
Command Keywords:
/BRIEF

brief
a
Requests the linker to produce
/BRIEF is
map (memory allocation) file.
specification
file
valid only if a map
brief map file
A
specified.
1is
also
contains the following information.
summary

included

in the

A summary

characteristics

summary

the

image

all

object

modules

image

link-time

performance

statistics

You

cannot

specify

/BRIEF

and

complete

map

/CROSS_REFERENCE.

Specify /FULL to obtain a
file.

MCR COMMANDS

/CROSS_REFERENCE
/NOCROSS_REFERENCE (default)

Controls

whether
the memory allocation
listing contains a global
symbol
cross
reference.
A
symbol
cross
reference
lists each global symbol defined in
the
image, its value, and all modules in the
image that refer to it.

You

cannot

specify /CROSS_REFERENCE

/BRIEF,
/DEBUG[=file-spec]
/NODEBUG (default)

and

Controls whether the
image contains the
VAX-11l debugger.
If the object
modules
contain
symbol
table
or
traceback
information for the
debugger,
you
can
specify
/DEBUG
to
include
the

information

the

symbol

you
absolute
debugging

the

image

module

table

and

The
the

object

does
traceback

well.

not

contain
information,

specify
/DEBUG,
you
hexadecimal
addresses

must
in

commands.

use
all

/DEBUG qualifier optionally
accepts
name of an alternate, user-specified

debugger.
If
vyou
specify
a
file
specification
and it does not contain a
file
type,
the
linker
assumes
the
default file type of OBJ.

/FULL

Requests
map

the

(memory

linker

produce

allocation)

listing
contains
information.
®

All

the

brief

the

information

description

full

following

included

created

image

Detailed descriptions of each
section in the image file

list

full
A

listing

complete

sections

listing.

program

global

symbols

ordered

global

symbols

ordered

name

list

value

/SHAREABLE

Requests

linker

image

executable

image.

have

/SYSLIB (default)
/NOSYSLIB

the

shareable

default

file

Shareable

file

produce

rather

type

than

images

a
an
also

EXE.

Controls
whether
the default
system
library (SYSSLIBRARY:STARLET.OLB) is
to
be searched automatically for unresolved

references.
searches

cannot

input
line.

the
resolve

default,

system

references

files
specified
If
you
specify

linker
does
not
SYSSLIBRARY : VMSRTL
SYSSLIBRARY:STARLET.OLB.

4-45

the

1library

linker

when

using

it
the

in
the command
/NOSYSLIB,
the
search
either
or

MCR COMMANDS

/SYSSHR

(default)

/NOSYSSHR

Controls whether the linker searches the

default system shareable image when it
cannot resolve references in the input
specified.

file(s)

default,

and

then

the

image

shareable

the

searches

linker

the

SYSSLIBRARY:VMSRTL.EXE

default

SYSSLIBRARY:STARLET.OLB

system

when

library

it cannot

input
the
resolve references using
Use the /NOSYSSHR
specified.
file(s)
the
qualifier to request that only
default system library be searched.

/SYSTEM [=base-address]

Requests the linker to produce a system
image and, optionally, defines a base

address for the image. A system image
it
cannot be run using the RUN command;
must be bootstrapped or otherwise loaded
into memory.

The base address specifies the wvirtual
memory location at which the image is to
be loaded. The address can be expressed
in decimal, hexadecimal, or octal, using
or %0,
%X,
the radix operators 8D,
If you do not specify a
respectively.
the
uses
the linker
base address,
default address of %X80000000.

you

specify

/SYSTEM,

you

specify /SHAREABLE or /DEBUG.

cannot

System images are intended for special
purposes, such as stand-alone operating
systems or diagnostics. When the linker
creates a system image, it orders the
program sections alphanumerically and
ignores all program section attributes.

/TRACEBACK

(default)

/NOTRACEBACK

the 1linker includes
Controls whether
traceback information in the image file.
includes
linker
the
default,
By
traceback information so that the system
can

trace

the call stack when an error

If you specify /NOTRACEBACK, no
occurs.
traceback reporting is performed when an
error

occurs.

I1f you

specify

also assumed.

/DEBUG,

/TRACEBACK

File Keywords:

/INCLUDE=module-name[,...]

Indicates that the associated input file
is an object module library, and that
be
to
are
specified
the modules
the
to
input
as
d
include
unconditionally
linker.

If the associated file specification of
the 1library does not include a file
type, the linker uses the default file
type of OLB.

MCR COMMANDS

least

one

specified.
name,

separate

enclose

The

the

You

with

causes

one
and

specify

conditional

and

/INCLUDE.
1library

first input file unless you
the /INCLUDE keyword.
/LIBRARY

than

commas

object modules

combination with

cannot

must

in parentheses.

keyword

name

specify more

them

list

/LIBRARY

inclusion
used

module

If you

can be

also

the

specify

Indicates that the associated input file
is
an
object module library that is to
be
searched
for
modules
resolving
undefined symbols in the input files.
If the associated file specification
of
the
1library
does
not
include
a file

type,
type

the linker
of OLB.

You

can

qualify

case,

the

this

use

uses

both

the

/INCLUDE

file

can

the

appear

explicit

line
with
/INCLUDE and

/OPTIONS

same

than

and

/LIBRARY

inclusion

then
for

file
once

various
/LIBRARY.

1In

the library
unresolved

specification
in

the

command

combinations

Indicates that the associated input file
contains
a
1list
of options to control
linking.
If you
specify
/OPTIONS
and
the
associated
file specification does
not include a file type, the linker uses
the default file type of OPT.
The

/OPTIONS

extend
to

the

provide

link-time

keyword
length

the

can

linker

Link
with

data.

used

command

and

additional

The options
file
1is
detailed
VAX-11 Linker Reference Manual.

/SELECTIVE_SEARCH

file

specification.

modules
occurs first;
is
used
to
search
references.

Likewise,

default

1in

the

Indicates that the associated input
is
an
object
module,
and
that
symbols
defined
in
it
that
are

file
any
not

necessary

references

should

resolve

excluded

outstanding

from

the

symbol
table
of the output image file,
and also from the symbol table
file
if
/SYMBOL_TABLE
is specified.
Any binary
code in
the
object
module
1is
always
included.

MCR COMMANDS

Example:

> LINK MYPROG,MYPROG/FULL=MYPROG

The above command requests the 1linking of the object file
MYPROG.OBJ. It was produced by either the VAX-11 MACRO assembler
or the VAX-11 FORTRAN IV-PLUS compiler. The
executable image file and a full map file.

1linker

creates

> LINK/SHAREABLE BETA=BETA,DELTA

The above command requests the linker to produce a shareable
image file from the object modules BETA and DELTA. An options
file must be used subsequently to link this shareable image with
object modules to produce an executable image.

Notes:

shareable

Use an options file to link

RSX-11M does not support the Link command.

modules to produce an executable image.

image

with

object

MCR COMMANDS

VAX/VMS

does

not have a Login command;
rather, you gain the attention
1login procedure by pressing CTRL/C, CTRL/Y, or RETURN.
Login

the

prompts

for your

user

equivalent

system.

use

the

name

and

password.

the RSX-11M Hello command

The

that

procedure

it verifies your

right

Format:

Username:

user

Password:

password

name

[keywords]

keywords

/CLI=interpreter
/DISK=device—-name

user-name

Is the user
file entry.

password

Is the password stored in your authorization
file
entry.
VAX/VMS does not display the password.

name

stored

in your

user

authorization

Command Keywords:
/CLI=interpreter

Specifies
the
name
of
interpreter.
You
can

an
alternate
command
specify either the DCL or
MCR command interpreter.
If a command interpreter
is not specified, your default command interpreter
is used.

/DISK=device-name

Specifies
the
name
of
a
associated with SYSS$DISK for
If you do not specify /DISK,

named

in your

authorization

disk
device
the terminal
the default

file

to
be
session.
SYSSDISK

used.

Example:

<7Y>
Username:

DUMPTY

/CLI=MCR

Password:

WELCOME

TO VAX/VMS

VERSION

n.nn

CTRL/Y gets the attention of login, which prompts
for
the
user
name.
The
user name is entered followed by keywords requesting
the MCR command interpreter.
After
validating
the
wuser
name,
login prompts for the password.
Notes:

VAX/VMS automatically maps
associated with SYS$DISK.

references

SY0

the

device

When you login with the MCR command interpreter, it
uses
the
login
file specified in your user authorization file entry or
searches your default directory for a
file
named
LOGIN.CMD.
If
one is present, the MCR command interpreter executes it as
an indirect command file.

MCR COMMANDS

LOGOUT
4.20

LOGOUT

The Logout command terminates an interactive
terminal
session.
The
system displays
a
termination message
and
performs any necessary
if one
image
the current
terminating
cleanup operations, such as
dismounting any private volumes that remain mounted, and
exists,
and
process
your
deletes
it
Finally,
deallocating devices.
subprocesses,

if any.

Format:

[keyword]

LOGOUT

/FULL

Requests the long form of the logout message.

/BRIEF

Requests the short form
/BRIEF

the default.

the

1logout

message.

Examples:
>

LOGOUT

LOG/FULL

HUBBARD
BELKNAP

logged out at 23-JAN-1978 17:48:56.73
logged out at 24-JAN-1978 14:23:45.30

Accounting

information:

Buffered I/0 count
Direct I/0 count
Page faults
Elapsed CPU time

31
9
66
0 00:00:00.33

Peak working set size
100
Peak virtual size
300
Mounted volumes
2
Elapsed time
0 00:00:13.27

This command displays a summary of accounting statistics for
terminal

session.

Notes:

RSX-11M does not support the Logout command.

The Bye command is supported by both VAX/VMS and RSX-1lM.

the

MCR COMMANDS

MOUNT
4,21

MOUNT

The

Mount

and

the

Oor

user

command

makes

data

contains

disk

maghetic

available

for

tape

volume

processing

volume

set

system commands

programs.

Format:

MOUNT

[keywords]

keywords

device-name,...

volume-label,...

[logical-name[:]1]

/ACCESSED=n (D)
/BLOCK=n (T)
/DATA CHECK[=option,...]

/DENSITY=n

(T)

/EXTENSION=n (D)
/FOREIGN
/GROUP (D)
/[NOJLABEL (T)
/OVERRIDE=option,...

/OWNER_UIC=[g,m]
/PROCESSOR=0option
/PROTECTION=code
/RECORDS=n (T)
/ [NO]SHARE (D)
/SYSTEM (D)
/UNLOCK (D)
/WINDOWS=n (D)
/ [NOJWRITE
D

applicable
applicable

Keyword

to disk
to tape

descriptions

only.
only.

are

categorized

accordingly

below.

device-name

Specifies the physical device name or logical name
of
the
device
on
which
the
volume
1is
to be
mounted.

When mounting a volume set, you can
specify
more
than
one
device name.
Separate the device names
with either a comma (,) or plus sign (+).
If
vyou
are
mounting
tape
volumes, you can specify more
volume labels than device names.
If

you

name,

volume-label

specify a colon (:)
following
command strips it.

the

device

the

Specifies the
volume
when

alphanumeric label
written
it
was
initialized.
For

Structure

Levels

have
up
can have

to
12
up to 6

specify

you

separate

the

(+). The
and
the
order.

volumes
1labels

and

the

characters;
characters.
more

labels

than

with

must
must

be
be

volume

for

one
comma

tape

label

can

volumes,

volume
(,)

in the same
specified in

on
the
Files-11

label,
plus

sign

volume
set
the correct

MCR COMMANDS

The volume~-label parameter is
not
required
when
you
mount
a
volume with the /FOREIGN qualifier,
nor when you specify /OVERRIDE=IDENTIFICATION.
To
specify
a
logical
name when you enter either of

these qualifiers, type any alphanumeric characters
in the volume label parameter position.

logical-name

Defines a 1- to 63-character
alphanumeric
string
that is the logical name to be associated with the
be
can
The logical name subsequently
device(s).
or volume set in
volume
the
to
refer
to
used
commands

and programs.

If you do not specify a logical
name,
the
command
assigns
the
default
logical
DISKS$Svolume—-label
for
disk
devices
TAPESvolume~-label for tape devices.

Mount
name
or

The Mount command places the logical name
in
the
or
/GROUP
unless
table
name
logical
process
the
cases,
latter
1In the
/SYSTEM is requested.
name is placed in the group or system logical name
tables,

respectively.

logical
a
and
devices
If you specify multiple
to all devices
applies
name
1logical
the
name,
specified.

Keywords Applicable to Disk and Tape:

/DATA_CHECK [=options,...]

Specifies

that

all

read

and

write

operations
to
the
volume
are
to
be
followed by
a
write
check
operation.
The
write
check
compares
the data on
disk with that in memory to ensure
that
You can
successful.
was
transfer
the
specify either or both of the
following
options.

READ
WRITE

checks
Performs
read operations.

following

all

Performs

following

all

checks

write operations.

If
you
specify
/DATA _CHECK
without
including
an
option,
the
default
of
/DATA_CHECK=WRITE is used.

The data check operation is described in
the VAX/VMS

/FOREIGN

I/0 User's Guide.

the
Indicates that the volume is not in
used by VAX/VMS.
format
standard ANSI
the
/FOREIGN,
specify
not
do
If you
in Files-11
be
to
assumed
is
volume
format.

program
the
/FOREIGN,
specify
If you
volume must be able to
the
reads
that
1if
volume,
the
on
process the labels
any.
For
example,
when
you
mount a
DOS-formatted tape, you must use FLX
to
transfer it.

4-52

MCR COMMANDS

The

default

foreign
system

protection

volumes
and

1is

owner.

addition,

read

you

group

applied

and write

for

specify

members

/GROUP

are given

read and write access.
If
you
specify
/SYSTEM
or
/SHARE, group and world are
both given read and write
access.
Any
user

category

access

allowed
access

that

1logical
to

the

protect

has

foreign

read

and

volume

I/0

and

1is

physical

I/0

volume.

foreign

volume,

you

specify the /PROTECTION keyword.
volume is currently in Files-~l1ll
you

must

have

privilege
must

/OVERRIDE=IDENTIFICATION

override

to mount

the

write

also

volume

must

If the
format,

protection

foreign,

you

owner.

Allows you to mount
not
know
what the

a volume when you
volume label is.

do
1If

you
specify
/OVERRIDE=IDENTIFICATION,
you
can
specify
anything
for
the
volume-label
parameter;
the
Mount
command ignores whatever you enter.
The
volume must be mounted /NOSHARE,
either

explicitly or

by default.

Overriding the
volume
affect
the
protection
volume.

label
does
applied
to

not
the

Additional
override
options
are
applicable
only
to
magnetic
tape, as
described below.

/OWNER_UIC=[g,m]

Requests

that

the

specified

UIC

assigned
ownership
of the volume while
it is mounted,
thereby
overriding
the
ownership
recorded
on
the volume.
If
you
are
mounting
a
device /FOREIGN,

/OWNER_UIC
than

your

requests
current

The

brackets

You

must

have

are
the

an owner

UIC other

UIC.
required.
privilege

override

volume
protection to use the /OWNER_UIC
keyword, or you must be the owner of the
volume.

/PROCESSOR=option

Allows you to
has
1its
own

control whether the volume
ACP process and which ACP

image

process

the

following
UNIQUE

options

can

Creates

executes.
be
a

contain a

The

specified.
new

process

copy of

default ACP

image

specified device
controller.

the
for

the

type or

MCR COMMANDS

‘"SAME:device

Requests that the same ACP

file-spec

Creates a new process to
contain the specified ACP
image (for example, a
modified ACP).

process currently being
used by the specified
device be used.

Operator privilege is
required
the /PROCESSOR keyword.

/PROTECTION=code

Specifies

the

protection

code

use

assigned
to
the volume.
All access to
any file on the volume
must
pass
both

the volume protection and the protection

applied to the

individual

file.

Specify
the
code
according
to
the
standard
syntax
rules
for
specifying
Section
in
described
as
protection
2.7.5.

If you do
not
specify
protection,
defaults
to
that
assigned
when
volume was initialized.

it
the

The protection specified by this keyword
takes
precedence
over
the
protection
implied by other keywords, for
example,

/SYSTEM

and /GROUP.

is /NOWRITE.

/WRITE (default)
/NOWRITE

The only exception

Control
whether
the
volume
can
be
written.
By default,
a
volume
is
Specify /NOWRITE
considered read/write.
to provide

read-only access

protect

files.

/NOWRITE

is equivalent to writelocking a

drive.

Keywords Applicable Only to Disk:

/ACCESSED=n

Specifies

the

approximate

directories
that
will
concurrently on the volume.
Operator privilege

number

required

use

/ACCESSED.,

/EXTENSION=n

Specifies the number of blocks by

which

This number can
1is extended.
file
the
program
or
command
be overridden by a
minimum value of n is 0;
The
request.
the maximum

65535.

/EXTENSION,
specify
If you do not
extension
value
defaults
to
specified
when
the
volume
initialized.

the
that
was

MCR COMMANDS

/GROUP

Makes

the

volume

available

any

user

with
the
same
UIC group number as the
user issuing the Mount
command.
These
users
are not required to issue a Mount
command to gain access
to
the
volume.
Volume protection is, however, applied.

The
1logical
name
for
the
device
is
placed
1in the group logical name table.
You must have the appropriate
privilege
to
place
a
name
1in the group logical
name

table.

A volume mounted /GROUP remains
mounted
until
it
1is explicitly dismounted;
it
is not automatically dismounted when its
accessors

log

out

the

system.

If you
issue
a
Mount
command
for
a
volume
that
1is already mounted /GROUP,
you must use the
/SHARE
keyword.
Any
additional keywords are ignored.

/SHARE
/NOSHARE

(default)

Indicates
shareable.

whether
the
If the
volume

volume
1is
has
already

been mounted /SHARE by another user,
you request that it be mounted with
/SHARE
keyword,
any other keywords
specify are ignored.
A volume mounted /SHARE is
dismounted when all of its
out of the system.
By

default, the
that
a
device

allocates
If you
device

/SYSTEM

1is

automatically
accessors log

command

not

assumes
shareable
and

it.

have
and

keyword,

Mount

and
the
you

previously
allocated
the
then
specify
the
/SHARE

the device

deallocated.

Makes the volume available to all
wusers
of
the
system as long as the UIC-based
volume protection
allows
them
access.
These
users are not required to issue a
Mount command
to
gain
access
to
the
volume.
The
1logical
placed in the
You must have
to
place
a
name table.

name
for
the
device
1is
system logical name table.
the appropriate
privilege
name in the system logical

A volume mounted /SYSTEM remains mounted
until
it
1is explicitly dismounted;
it
is not automatically dismounted when its
accessors

log

out

the

system.

If you
1issue
a
Mount
command
for
a
volume
that is already mounted /SYSTEM,
you must use the
/SHARE
keyword.
Any
additional keywords are ignored.

MCR COMMANDS

/UNLOCK

Requests write access to the index
file
on
the
volume.
The /UNLOCK keyword is
allowed only if the
volume
1is
mounted
/NOSHARE
either
explicitly
or
by
default.

/WINDOWS=n

Specifies

the

pointers
files

number

to be used

are

opened

retrieval

in mapping data when

the

volume.

/WINDOWS is not specified, the number of
pointers defaults to the value specified
when the

volume was

initialized.

Operator privilege is
the /WINDOW keyword.

required

use

Keywords Applicable Only to Tape:

/BLOCK=n
/NOBLOCK

Sets
the
default
block
size to the
specified number of bytes per block,
or
requests
using /NOBLOCK that each block
contain one

record.

By default, records are written to
tape
volumes
in
2048-byte
blocks,
unless
/FOREIGN
and
/NOLABEL
are
specified;
then
the
default
block
size
1is
512
bytes.

/DENSITY=n

Specifies the density at which the
tape
is to be written.
The specified density
is used only if /FOREIGN or /NOLABEL
1is
specified
and
the
first
operation
performed on the tape is
a
write.
If
density
1is specified, n can have either
of the following values:
800 or 1600.
If density is not specified,
defaults to 1600 bpi.

the density

If you specify /LABEL, or if
the
first
operation
on
the
tape
1is a read, the
tape is read or written at
the
density
at
which
the first records on the tape
is

/LABEL

(default)

/NOLABEL

recorded.

Indicates

whether

the

tape contains

standard labels.
If you
mount
a
tape
specifying
the
/NOLABEL
keyword,
an
end-of~file condition is returned when a
tape
mark
is
encountered when reading
the

tape.

The
default
protection
for
wunlabeled
tapes
1s
all
access to the system and
owner and no access
to
the
group
and
world.

MCR COMMANDS

/OVERRIDE=option,...

Inhibits the following protection
performed by the Mount command.
ACCESSIBILITY

1Indicates

that

checks

the

accessibility specified
in the header 1 and
volume 1 labels of the
tape is to be overridden
EXPIRATION

Allows

you

write

tape that has not yet
reached its expiration

date.
You must have the
privilege to override
volume
must
SETID

protection or

own

Allows

the

you

volume.

inhibit

the

checking of the volume
set identification when
switching reels in a
multivolume
IDENTIFICATION Allows

you

set.
to

mount

volume when you do not
know that the volume
label
is.
If
you

specify /OVERRIDE=
IDENTIFICATION,

you

specify anything

can

for

the

volume-label parameter;
the Mount command ignores

whatever

you

Overriding
label does
protection
volume.

enter.

the volume
not affect
applied to

If you specify more
than
one
enclose them in parentheses and

them with
/RECORDS=n

Specifies
record.
greater

the
the

keyword,
separate

comma.
the

The
than

number
wvalue

the

of
of

specified

bytes

must

block

size.

Examples:
>

ASN

@RODIN

MOUNT-I-MOUNTED,

DBA1l:=DKO:

MOUNT

DKO:MYVOL

MYVOL

mounted

on _DBAl:

The Assign command defines DBAl as the equivalence name
for
logical name DKO.
When the indirect file RODIN.CMD executes,
command

mount

the

volume

effect,

request

mount

labeled

MYVOL

DBAl.

DKO

becomes,

the
its
in

MCR COMMANDS

> MOUNT DBAl MYVOL DISK

$ MOUNT-I-MOUNTED, MYVOL mounted on _DBAl:

disk

device

that

1is

compatible

This command mounts the volume MYVOL
assigns a logical name of DISK.

DBAl

and

Notes:

The form of the

Mount

command

RSX-11M and VAX/VMS is as follows.

between

MOU llnn:volume-label

is an RSX-11lM physical device name that has been
assigned as the 1logical name for a VAX/VMS

llnn

physical device unit.

volume~label is the volume label.

VAX/VMS and RSX-11lM do not support the same keywords

for

the

Mount command.

VAX/VMS syntax for the Mount command indicates a space between

VAX/VMS accepts either
the device name and the volume label.
a colon or a space as a delimiter between the device name and

volume

label.

MCR COMMANDS

4.22
You

ON
can

STATEMENT
use

the

Action

taken when

returns

Action

RSX-11M does

statement

error

a program,

support

the

following:

command,

status

taken when CTRL/Y

not

control

either

command

is pressed.
form of

the On

statement.

procedure

MCR COMMANDS

ON CONTROLY
On Control Y

4,22.1

The On Control Y statement allows you to specify an action to be taken
when CTRL/Y is pressed and is normally used only within indirect
command files. Once the On Control Y statement has been processed,
the command interpreter reacts to the pressing of CTRL/Y in either of
the following ways:

If an image is active when you press

occurs,

thus

allowing

CTRL/Y,

image

exit

termination handlers, if any, to run;

then the specified action is taken.

is
interpreter
the command
If no image is active (that is,
is taken when the command
specified action
the
executing),

completes.

Once an On Control Y action has been established, it remains until it
is replaced by a subsequent On Control Y statement or canceled by a
It does not have to be re-established each
Set NoControl Y command.
time CTRL/Y

is pressed.

If one level of an indirect command file 1issues an On Control Y
statement and then invokes another level, the default On Control Y
action established for the nested level is as follows:
ON CONTROL_Y THEN EXIT

it
Thus, if you press CTRL/Y while the nested 1level 1is executing,
Pressing
causes a return to the level from which it was invoked.
CTRL/Y again causes the On Control Y action established by the first
to be

level

taken.

Format:

ON CONTROL_Y THEN command

command

specifies the action to be taken.

valid VAX/VMS MCR command.

It can

any

Example:
>

@APPLIC.CMD

ON CONTROL_Y THEN LOGOUT

the |user
Once the indirect command file APPLIC.CMD is started,
Because the On Control Y
can interact only with the application.
statement indicates that the command interpreter is to effect a
logout when CTRL/Y is pressed, the user of the application cannot
return to use the command interpreter.

4-60

MCR COMMANDS

Notes:

The VAX/VMS
handlers.

System Services Reference

Manual

describes

exit

If you wish to run an image that should not be interrupt
ed
by
CTRL/Y,
issue
a
Set NoControl Y command prior to initiating
the image.
When the image exits,
you
can
re-enable
CTRL/Y
handling by issuing the following commands.

ON CONTROL_Y THEN
SET CONTROL_Y

command

MCR COMMANDS

ON severity-level
4.22.2

On Severity-level

action
The On severity-level statement defines the default course anof indirect
to be taken when a command or program executed within
command file encounters an error condition.

The
Return status values in VAX/VMS include a severity-level code.
code groups status returns to indicate success, warning, error, or
severe error. When a command or program is executed, the return
status value is compared with the current severity level to determine
subsequent action.

By
The On severity-level statement is used with the Set On command. have
default, the 1initial state for an indirect command file is to
n
condition recognition disabled (Set NoOn). You can enable conditio
the
in
t
statemen
ON
an
or
command
On
Set
a
g
includin
by
ion
recognit
indirect command file.

Format:

THEN

severity-level

command

Specifies the severity of the condition that is to
cause the indicated action to be taken.
1is represented by one of
severity 1level

The
the

following keywords.

The specified action is to be taken

WARNING

for

warning,

error

returns.

error,

severe

and

The specified action is to be taken

ERROR

for error and severe error

returns;

the default action for warnings

to continue.

SEVERE_ERROR

The specified action is to be taken
severe
for
only
default action for

errors is to continue.

You can truncate these keywords

errors;
warnings
one

the
and

characters.

command

Specifies the action to be taken when errors equal
to or
occur.

greater than the specified level of error
You can specify any valid MCR command line

following the keyword THEN.

If you do not include an On statement in an
indirect command file and a Set On command has
been executed, the command interpreter issues an
EXIT command when errors or severe errors result
from the execution of a command or program.
all other cases, command execution continues.

Once the command in an On statement has been
executed as a result of an error condition, the
It remains
default action, Exit, is reinstated.
red.
encounte
is
command
On
new
a
until
effect
in

MCR COMMANDS

Example:
>

Q@INDFILE
RUN

POMME
.

ERROR THEN

RUN

SQUASH

RUN

PEAS

ON
RUN

CONTINUE

SEVERE_ERROR THEN
TOMATO

RUN

.GOTO

ERR

PEPPER

.ERR:

RUN

MARKET

EXIT

When

execution of

severe

the

indirect

command

warning

causes

than

issue an Exit command
Once

the

first On

statement

file
can
continue
warnings by default
of

the

Continue

the

second

file

1is

allowed

cause

labeled

ERR.

encountered,

the On

statement

starts,

command

the

any

error

interpreter

indirect

command

after
any type of error.
It continues from
and from errors and severe errors as a result

command

Once

errors

by default.

file
the

continue

branch

the

statement.

encountered,

from warnings
portion

the

indirect

and errors,

the

indirect

command

but

severe

command

file

Notes:
®

Once

the

clause

executed,
®

Any

You

can

status
®

You

can

command)

the

effect

control
returned
use

condition

the

recognition

severity-level

overrides
®

(THEN

condition

statement

whether
from

a
set

indirect

statement.

command
with

NoOn

command

the

statement

ERROR

the

Set

commands

recognition.

condition

THEN

command

interpreter
Set
to

checks
command.

temporarily

1is

EXIT.
file

the

disable

MCR COMMANDS

PRINT
4.23

either a
The Print command queues one or more files for printing on The
system
system-defined printer or a device that you specify.
It
job.
a
be
to
command
Print
a
by
considers a file or files queued
assigns a unique job identification to each job in the system.

Format

file-spec[keywords],...

PRINT [keywords]

keywords

/AFTER=absolute-time

file-spec

Provides the file specification of one or more
If you specify multiple
files to be printed.

/BURST
/COPIES=n
/DELETE
/DEVICE=device-name
/ [NO] FEED
/ [NO] FLAG_PAGE
/FORMS=type
/ [NO] HEADER
/ [NO] HOLD
/ [NO] IDENTIFY
/JOB_COUNT=n
/ [NO] LOWERCASE
/NAME=job-name
/PAGE_COUNT=n
/PRIORITY=n
/QUEUE=queue—-name
/SPACE [=n]

files, separate them with either a comma (,) or

(+).

plus sign

You can use wild cards in place of the directory,
file name, type, or version fields of the file
specification.

If you omit a file type, the

LIS

uses

command

by default.

Command Keywords:

/AFTER=absolute-time

Requests that the
specific

time

Jjob

day.

printed

The

time

after

must be

specified in 24-hour format as follows:
hh[:mm]

For example /AFT=17 places a job in a hold
If the time already
status until 5:00 pm.
has passed, the job is printed immediately.

/DEVICE=device-name

Requests that the files specified
to

particular

device.

you

queued

not

files are queued to the
specify /DEVICE,
current default printer. The default device
is SYSSPRINT.

MCR COMMANDS

/FORMS=type

Specifies the
form
type
required
for
the
files
to
be printed.
Specify the form type
using a numeric value or
alphanumeric
code.
Codes
for
form
types
are
installation
defined.

/HOLD
/NOHOLD

Requests
that
the
file(s) be queued
but
not printed.
The file cannot be released for
printing
until
you
issue
the
Set
Queue
command to release it.

(default)

/IDENTIFY (default)
/NOIDENTIFY

Controls
whether the Print
command displays
a message indicating the
job
identification
of
the
print job and the name of the device
to which it has been queued.
By default,

information

JOB

the

following

displays

format.

this

jobid ENTERED ON QUEUE device-name

Requests that the entire
job
be
printed
n
times.
The
value
of n is a decimal number
ranging from 1 through 255.
1If you omit this
keyword, one copy of the job is printed.

/JOB_COUNT=n

/LOWERCASE

/NOLOWERCASE

the Print command

(default)

/NAME=job—-name

Indicates
that
the
specified
file(s)
contain lowercase alphabetic letters and must
be printed
on
a printer that has uppercase
and lowercase capabilities.
Defines
a
1lto
8-character
alphanumeric
string
to identify the job.
The name string
is displayed in response to
the ~Show
Queue
command.

If name is not
specified,
the
name
string
defaults
to
the file name of the first file
in

/PRIORITY=n

the

job.

Specifies the priority of the print job.
The
value
of n must be in the range of 0 through
31;
0 is the lowest priority, and 31 is
the
highest.

By
default,
jobs
are
assigned
the
same
priority
as
your
process.
You can assign
lower priorities to your nonessential jobs so
that
jobs
you want sooner will be processed
first.
Privilege is required to set a priority value
that is higher than your process's priority.
/QUEUE=queue-name

Requests that the
to
a
particular

file(s) specified be queued
device.
The
default
is

SYSSPRINT.

This keyword performs the
/DEVICE.

same

function

MCR COMMANDS

File Keywords:

/BURST
/NOBURST

Indicates
whether
a
burst
page
is
to
precede the file.
A burst
page
1is
printed
before
a
flag
page
and
contains the same
information;
however, it is printed over the
perforation
between
pages
to
make
the
separation of files easier.
This
keyword
overrides
the
installation's
default
established
for
printers when they
are initialized for
spooling.
/NOBURST
is
the default for user-specified devices.
Specifies the number of copies of the file to
be
printed.
The
value
of nn is a decimal
number in the range of 1
through
255,
The
default number of copies is 1.

/COPIES=nn

If you specify /COPIES as a command
keyword,
each file named in the command is printed the
specified number of times.
/DELETE
/NODELETE

(default)

Indicates
whether
after printing.

the

file

be deleted

If you specify
this
keyword
as
a
command
keyword, all files specified are deleted.
/FEED (default)
/NOFEED

Controls
whether
the
Print
command
automatically
inserts
form
feeds
when
it
prints
files
that
do
not
have
carriage
control characters.
By
default,
the
Print
command
inserts
a
form feed when the forms
are within four lines of the end of the form.
On standard 66-line forms, a form feed occurs
after printing 62 lines.

/FLAG_PAGE
/NOFLAG_PAGE

Indicates
whether
printed preceding the

(default)

a
flag
page is to be
file.
If
you
specify
/FLAG
with
a file specification, a separate
flag page is printed preceding the associated
file.
The flag page lists the file name.

If you specify /FLAG with the command verb, a
flag
page
1is
printed
for each file in the
job;
the flag page lists the job name.
/HEADER
/NOHEADER

(default)

/PAGE_COUNT

Controls whether the name
of
the
file
printed at the top of each printed page.

Specifies the number of pages of the file
to
be
printed.
/PAGE_COUNT can be used only as
a file keyword;
it
cannot
be
used
as
a
command keyword.
If .this keyword is omitted,
the entire file is printed.

MCR COMMANDS

Specifies

/SPACES [=n]

the

number

spaces

between
1lines
of
output
in
file.
The value of n indicates
spaces.
It can be a l or a 2.

left

the specified
the number of

If /SPACES is omitted, no
extra
spaces
printed between lines of the file.

are

If /SPACES is specified without a
value
for
n,
one extra space is provided between files
of output;
that is, output is double spaced.
Example:

> PRINT/COPIES=5 THISFILE.DAT/SPACE=2,THATFILE/PAGE_COUNT=4

This command requests the printing of five copies of THISFILE and
THATFILE.

THISFILE

to be double

spaced.

Only

the

first

four

pages of THATFILE are to be printed.
Notes:

RSX-11M does not support the Print command.

You can delete a queue entry using the Delete command with the

/ENTRY

keyword.

You can control the attributes of a print queue using the

Queue

commahd.

Set

MCR COMMANDS

PURGE
4.24

PURGE

The Purge command deletes all but
the
versions of a specified file or files.

highest

numbered

version

Format:

PURGE

[keyword]

file-spec,...

keywords

/KEEP=n

file-spec

Provides the file specification of the
files
to
be
purged.
If you specify more than one
file, separate them with either a
comma
(,)
or a plus sign (+).
Do not specify a version
number.

/LOG

You can
name or

use wild cards in place
file type fields.

the

file

If you do not provide the file name and type,
the
Purge
command
purges
all files in the
directory.
Command Keyword:

/KEEP=n

Specifies the maximum number of
versions
of
the specified files to be retained.
If /KEEP
is not specified, the command deletes all but
the highest numbered version.

/LOG

Specifies
displayed

that
the
as they are

names
of
deleted.

files

Examples:

PURGE

/KEEP=2

*_,DAT

This command requests that all files
having
a file type of DAT be purged
numbered versions remain.
>

PURGE

in
the
default
directory
so that only the two highest

[122020.MSG]

This

command

[122020.MSG]

requests

the purging

all

files

subdirectory

one

version.

RSX-11M does

not

support

You

Purge differs from the operation of PIP/PU in that
the
/KEEP
keyword specifies the actual number of files to be kept rather
than the highest version numbers.

Notes:

can use

the

/PU

the

Purge

switch with PIP

command.
to

purge

files.

MCR COMMANDS

RUN
4.25

RUN

The Run command requests execution of a native or RSX-11M image.
You
can
request
an
image
for execution in your process (the requesting
process), or you can use the Run command to
create
a
subprocess
or
detached process to execute the image.
By default, the image executes
in the requesting process.
If you specify any keywords except /DEBUG with the
Run
command,
the
command
creates
a
separate
process to execute the specified image.
The
command
displays
the
created
process's
identification
on
SYSSOUTPUT.
By
default,
it creates a subprocess with the same UIC,
privileges,
and
priority
as
the
requesting
process
and
deducts
resource
gquotas
from
the
requesting
process to assign them to the
subprocess.

The /UIC
process;

keyword
requests
you must have the

the
Run
command
to
appropriate privilege

create
a
detached
to create a detached

process.

Additional keywords allow you to
resources
and
privileges,
and
hibernate.

schedule the
process,
describe
its
indicate
whether
the process is to

NOTE

The notes at
description
information.
you
intend
keywords.

the

end
of
this
command
contain
important
You should
read
them
if
to
wuse
any
Run
command

Format:

RUN
keywords

[keywords]

file-spec
/ [NO]JACCOUNTING
/AST_LIMIT=limit
/[nolauthorize
/BUFFER_LIMIT=limit
/ [NO]1DEBUG
/DELAY=delta-time
/ERROR=equivalence-name
/FILE_LIMIT=limit
/INPUT=equivalence—-name
/INTERVAL=delta-time
/I10_BUFFERED=limit
/I0_DIRECT=limit
/MAILBOX=mailbox-unit
/MAXIMUM_WORKING_SET=1limit

/OUTPUT=equivalence-name
/PAGE_FILE=limit
/PRIORITY=n
/PRIVILEGES=privilege-list
/PROCESS_NAME=process-—name
/QUEUE_LIMIT=limit
/ [NO] RESOURCE_WAIT
/SCHEDULE=absolute—-time

MCR COMMANDS

/[NO]SERVICE_FAILURE

/SUBPROCESS _LIMIT=limit
/ [NO] SWAPPING

/UIC=[g,m]

/WORKING_SET=default

file-spec

Provides the file specification of the
native
or
RSX-11M
image
to
be
executed.
If
the
file
specification does not include a
file
type,
the
Run command uses EXE by default.

Command Keywords:
/ACCOUNTING (default)
/NOACCOUNTING

Allows
or disallows the created process
to specify, for any
processes
that
it
subsequently
creates,
that the
process can disable accounting.

created

To use this keyword, you must
have
the
user privilege to disable accounting.
/AST_LIMIT=limit

Specifies

the AST queue

number of ASTs that
have outstanding at

for:

The
can

The number of scheduled wake up
requests that the process can have
outstanding at one time

)

If you do not
process has a

This

limit

notes

the process
one time

specify
/AST_LIMIT,
the
limit of 10 by default.

The minimum value

/AUTHORIZE (default)
/NOAUTHORIZE

limit

not deductible;

see

the

below.

Determines whether login
user authorization file.
is
meaningful only when
run is LOGINOUT.EXE.

to check the
This
keyword
the image to be

If
you
specify
/AUTHORIZE,
login
performs
all
the
operations
that
it
performs when you log into the system at
a terminal.
If
you
bypasses

specify
/NOAUTHORIZE,
the
wuser
authorization

checks.

/BUFFER_LIMIT=limit

Specifies
memory

that

bytes
the

the maximum amount of

created

process

can

use

for buffered I/0 operations or temporary
mailboxes.
Mailboxes
are
used
to
emulate RSX-11M send/receive directives;
see

the

notes

If you do not

below.

specify

buffered

1I/0

limit,
the
default value of 4096 bytes
is used;
the
minimum
amount
required
for
any
process
to
execute
1is
1024
bytes.
This limit is
deductible;
see
the notes below.

4-70

MCR COMMANDS

/DEBUG
/NODEBUG

For a native image, controls whether the
image is to be run
with
the
debugger.
If
the image was linked with the VAX-11
Symbolic Debugger and you
do
not
want
the debugger to prompt, use the /NODEBUG
keyword.
If the image was
1linked
with
traceback,
traceback
reporting
is
performed when an error occurs.

This
keyword
1is
not
RSX-11M
1images
built
always prompts when
built with it.

meaningful
with
ODT;

you

run

If you specify /DEBUG,
do
not
any other Run command keywords.
/DELAY=delta-time

Requests

that

the

created

initialized
and
placed
and
awakened
after
a
interval has elapsed.

for
oDT
image

specify

process

1in hibernation
specified
time

If you specify
/INTERVAL
with
/DELAY,
the
first wake request is scheduled for
the
delay
time
specified
and
all
subsequent

wake

according
interval.

requests

the

are

scheduled

specified

time

/ERROR=equivalence-name

Defines a 1- to 63-character equivalence
name
string for the logical device name
SYSSERROR.
The
logical
name
and
equivalence
name
are
placed
1in
the
process
logical
name
table
for
the
created process.

/FILE_LIMIT=limit

Specifies the maximum
that
a
process
can
time.
If
for

you
a

not

specify an

created

process,

the default value of
amount required for a
is 2.

This limit
below.

/INPUT=equivalence-name

Defines a 1name
string

number
of
have
open

files
at one

open

file

the

system

uses
20.
The
minimum
process to execute

deductible;

see

to 63-character
for the logical

the

/INTERVAL=delta-time

notes

equivalence
device name

SYSSINPUT.
The
logical
name
equivalence
name
are
placed
1in
process
logical
name
table
for
created

limit

and
the
the

process.

Requests that
initialized,
awakened
intervals
delta time.

the
created
process
be
placed in hibernation, and
at
regularly
scheduled
as
specified by the value of

MCR COMMANDS

If you specify /DELAY or /SCHEDULE
with
/INTERVAL, the first wake request occurs
at the
delay
time
or
scheduled
time
specified.
All subsequent wake requests
occur at the
specified
interval
time.
If
neither
/DELAY
nor
/SCHEDULE
is
specified, the first wake request occurs
immediately.

/10_BUFFERED=limit

Specifies the limit
on
the
number
of
outstanding
buffered
I/0
operations
permitted for the process.
A
buffered
I/0
operation
1is one in which the data
transfer

takes

place

from

intermediate
buffer in the system pool,
not from a process—specified buffer.
If

you

not

/IO _BUFFERED,

I/0 limit of

The minimum value

This limit is
notes below.

/10 _DIRECT=limit

specify

process has a buffered
default.
of

not deductible;

specify
limit of

The minimum value

see

/IO _DIRECT,
by default.

the

This limit is not deductible;
notes below.

see

the

Specifies the unit number of
a
mailbox
to
receive
a
termination message when
the

/MAXIMUM_WORKING_SET=limit

Specifies the limit
on
the
number
of
outstanding
direct
I/0
operations
permitted for the process.
A direct I/O
operation
1is
an I/0O operation in which
the data transfer takes
place
directly
from a process-specified buffer.
If you do not
process has a

/MAILBOX=mailbox-unit

the

created process

is deleted.

Specifies the maximum size to which
the
image
to be executed in the process can
increase its
working
set
size.
This
keyword
1is applicable only when running
a native image.

The default
working
set
size
1is
150
pages.
The
minimum
working
set size
required for a process to execute is
50
pages.

This limit
notes

/OUTPUT=equivalence-name

is not deductible;

below.

see

the

Defines a 1- to 63-character equivalence
name
string for the logical device name
SYSSOUTPUT.
The
logical
name
and
equivalence
name
are
placed
1in
the
process
logical
name
table
for
the
created process.

4-72

MCR COMMANDS

/PAGE FILE=limit

Specifies

the maximum

number

pages

that can be allocated in the paging file
for

the process.

If you do
not
specify
a
paging
file
limit,
the
system uses a default value
of 40 256-page blocks;
that
is
10000
pages.
The
minimum
number
of
pages
required for a process to execute is one
256-page

block.

This limit

is deductible;

see

the notes

below.

/PRIORITY=nn

Specifies the base priority at which the
executed.
be
to
1is
process
created
VAX/VMS priorities range from 0
through
Priorities 0 through 15
(decimal).
31
priorities.
process
normal
are
Priorities
16
through
31
are
time-critical (real-time) priorities.
privilege
You must have the appropriate
to
set
the
created
process's
base
priority to a
value
higher
than
your

process's base priority.
If you specify
no priority or a
higher
priority
than
allowed,
the system uses your process's
priority by default.

/PRIVILEGE=privilege-list

Defines
process.

privileges
for
the
created
The privilege list consists of

one or more of the privileges listed

Appendix
A.
You
must
have
a
user
create
you
privilege to give a process
any privileges that you do not have.

If you specify multiple privileges, they
must
be
separated
by
commas, and the
list must be enclosed in parentheses.

be
can
1listed
privileges
the
Any of
by NO to deny the process that
preceded
privilege, for example, NOSWAP_MODE.

individual
specifying
than
Rather
either
specify
can
you
privileges,

ALLPRIV indicates that
ALLPRIV or SAME.
all
have
to
is
process
created
the
the
that
indicates
SAME
privileges.
the same
have
to
1is
process
created
you
If
process.
your
as
privileges
the created
/PRIVILEGE=NOSAME,
specify
process has no privileges.

the
/PRIVILEGE,
specify
If you do not
process has the same privileges
created
default
the
that is,
as your process;
is

PRIVILEGE=SAME.

4-73

MCR COMMANDS

/PROCESS=process—name

Defines
a
alphanumeric
process.

The

1name

to
for

process

name

qualified
by
process's UIC;
must be unique
/QUEUE_LIMIT=quota

15-character
the
created
is

implicitly

the
group
number of the
that is,
process
names
only within the group.

Specifies the maximum
number
of
timer
queue
entries
that the created process
can have outstanding at
any
one
time.
This
1limit
includes timer requests and
scheduled
wakeup
requests.
Timer
requests

are

MARK TIME

directives.

used

emulate

RSX-11M

If you do
not
specify
a
timer
queue
entry
quota,
the system uses a default
value of 10.
A process does not require

any

timer

queue

This limit
below.
/RESOURCE_WAIT
(default)
/NORESOURCE_WAIT

execute.

is deductible;

see

the

notes

resource
wait
mode
for the
process.
By
default,
if
a
resource
1s
required
for
a

process

and

resource

the

execute

places

If
you
process
when the

particular

not

the

state
until
available.

resource

the default.

Requests that

the

created

initialized,

placed

awakened

value

becomes

the
code

process

in hibernation,

and

the

a wait

specify
/NORESOURCE_WAIT,
receives
an
error status
resource is not available.

the

function

available,

process

the

/RESOURCE_WAIT

/SERVICE_FAILURE
/NOSERVICE_FAILURE
(default)

Enables
created
system

system

/SCHEDULE=absolute~-time

limit

time of day
absolute time.

specified

Enables
system
service
failure
exception
mode
for
the
created
process.
By default, if an error occurs
when
a
process
calls a system service
either
directly
or
as
a
result
of
RSX-11M
directive
emulation,
a status
code indicating the error is returned.
If

you

error

specify /SERVICE_FAILURE
occurs

system

during

service

the

request,

and

processing
the

an
of

process

receives an exception condition.
Native
images can
declare
condition
handlers
for

such

exception

conditions.

MCR COMMANDS

/SUBPROCESS_LIMIT=quota

Specifies
the
maximum
number
subprocesses that the created process

allowed
If

you

limit,

create.

do
the

not
system

of 8.
A process
subprocess quota

This limit
below.
/SWAPPING (default)
/NOSWAPPING

of
is

specify

uses

default

the

subprocess
value

does
not
require
to execute.

is deductible;

see

the

any

notes

Enables
swapping
for
the
created
process.
By
default,
a
process
is
swapped
from
physical
memory to allow
other processes to execute.
Swapping is
similar
in
function
to
RSX-11M
checkpointing.
You must have the appropriate
to specify /NOSWAPPING.

/UIC=[g,m]

privilege

Defines the user identification code for
the
created
process.
The values of g

and m are numeric strings in
of
0
through
377.
The
interpreted in octal radix.
/WORKING_SET=default

the
range
number
is

Specifies the default working
set
size
for
the
<created process;
that is, the
number of pages in the working
set
for
the image to be executed.
If

you

not

specify

default

working

set
size,
the
system uses the default
value of 150 pages.
The minimum
number
of
pages
required
for
a
process
to
execute
is
50
pages.
The
value
specified
cannot
be
greater
than the
working
set
quota
specified
by
the
/MAXIMUM_WORKING_SET kevword.

This quota

is not deductible.

Examples:
>

RUN

RSXIMAGE.TSK

This
command
activates
the
RSX-11M
requesting
process;
no
subprocess

image
RSXIMAGE
in
or
detached
process

created.

The

for

until

image

the

RUN VAXIMAGE
This

UIC
its

system

does

not

prompt

subsequent

the
is

commands

terminates.

/UIC=[122,20]

command

creates

[122,20]
and
requester.

has

the

detached

process

same privileges

and

that

runs

resource

under

guotas

MCR COMMANDS

>
>

RUN FIRST.TSK /PROCESS=PAYl
RUN SECOND.TSK /PROCESS=PAY2
The

commands

above

create

/DELAY=::10

two

subprocesses

named

PAYl

and

PAY2,

each of which is to execute an RSX-11lM image.
PAYl hibernates as
a result of the /DELAY keyword
on
its
Run
command;
PAY2
is
activated immediately.
The two processes cooperate.
SECOND, the
image executing in PAY2, awakens PAYl by issuing a directive.

The process requesting
accept subsequent user

that the two
commands.

images be

run remains

Both subprocesses have the same privileges
as
their
process.
Resource
quotas
are
subtracted
from the
process's.

free

requesting
requesting

Notes:

Specifying a process name is not sufficient to allow emulation
of
the
RSX-11M
functions
(for
example,
common event flag
clusters and send/receive) that require a
task
name
in
the
image label block.

If you run an RSX-11lM image that has a task name starting with
an
alphabetic
character in the image label block and specify
/PROCESS, the task name becomes the process name;
that is, it
overrides the name specified by /PROCESS.

Mailboxes are virtual devices that can be used by both RSX-11M
and
native images.
VAX/VMS uses mailboxes to emulate RSX-11M
send/receive
directives.
For
further
information
on
mailboxes,
see
the
VAX-11/RSX-11M
Programmer's
Reference

Manual for RSX-11M
1images
or
the
Reference Manual for native images.

VAX/VMS

System

Services

For
RSX-11M
images
1issuing
send/receive
directives,
the
mailboxes
used
1in emulating these directives are not created
until just prior to actual image execution.
Therefore,
using
either
the
/INTERVAL
or
/DELAY
keywords
does
not
cause
creation of the mailboxes when the
command
1is
issued;
you
cannot
assume
that the mailboxes exist until image execution
begins.

For an RSX-1lM image,
the
/INTERVAL
keyword
has
the
same
effect
as
/DELAY;
that is, the process execution occurs at
the designated time, and when the image exits, the process
1is
deleted.
The image is executed only once.

For a native image, /INTERVAL causes the
image
to
hibernate
and
be
re-executed after the specified interval if the image
issues a RET instruction.
The image
exits,
however,
if
it
issues an Exit system service.

The form of the Run command
systems and VAX/VMS systems
RUN

file-spec

that
is:

compatible

between RSX-11M

MCR COMMANDS

Use

the

following

logical

names

keywords

SYSSINPUT

assign

(TI),

equivalence

SYS$SOUTPUT

(TI),

names

and

for

the

SYSSERROR

(CL).
/INPUT
/OUTPUT
/ERROR
Use
for

the following
a process:

keywords

override

the

default

attributes

/ACCOUNTING
/PRIORITY
/PRIVILEGES
/PROCESS_NAME
/SERVICE FAILURE
/SWAPPING
When you issue a Run command to
create
a
process,
you
can
define
1limits
to
restrict
the
amount
of
various
system
resources available to that process.
The
following
resource
limits
are deductible when you create a subprocess;
that is,
the values you specify are deducted from your
current
limits
and given to the subprocess.

/BUFFER_LIMIT
/FILE_LIMIT
/PAGE FILE
/QUEUE_LIMIT
/SUBPROCESS_LIMIT
The limit
deleted.

amounts

are

returned

to you when

the

subprocess

The system defines minimum values for each specifiable
1limit;
if
you
specify
a limit that is below the minimum, or if you
specify a deductible quota that reduces your gquota
below
the

minimum,
the
determine your

Run
command
cannot
current quotas, issue

<create
the
process.
To
the
SHOW
PROCESS/QUOTAS

command.

You also can
not deducted
limits are:

specify limits that
from your process's

affect
performance
but
are
resources.
The nondeductible

/AST_LIMIT
/MAXTMUM_WORKING_SET
/10_BUFFERED
/I0_DIRECT
/WORKING_SET
Hibernation is the VAX/VMS concept
that
RSX-11M concept of a suspended task.

corresponds

the

MCR COMMANDS

Use the following keywords to schedule execution of the image:
/DELAY
/INTERVAL
/SCHEDULE

If you specify any of these keywords,

the Run command

creates

state of hibernation,
in a
it
places
the process,
time.
appropriate
the
for
request
schedules a wake
image until it is wakened.
the
execute
cannot
process
RSX-11M images, /INTERVAL has the same effect as /DELAY.

and
The
For

the

image

requests
wake
cancel
to
command
Issue a Cancel
scheduled for the process but not yet delivered.

that

are

Issue a Stop command to terminate execution of
the

process

and,

if the process is not your current process,

cause the process to be deleted.

When a command accepts a keyword that specifies a time value,
1is either an absolute time or a delta time.
the time value
in
The syntax rules for specifying time values are described
Section 2.7.6 and summarized below.
~- Absolute times have the

format:

[dd-mmm-yyyy[:]] [hh:mm:ss.ss]
——- Delta times have

the

[dd=-] [hh:mm:ss.ss]

format:

MCR COMMANDS

4.26

SET

The

Set command
characteristics
devices.
Table

provides

a number of options that
allow
and
defaults
for
your
process,
3job,
4-1 lists the Set options.

The various Set options
Language
User's
Guide

are

described

and

the

detail

VAX/VMS

you
and

to
set
certain

in the VAX/VMS Command
Operator's
Guide,
as

indicated i1n Table 4-1I.
The commands described in the VAX/VMS Command
Language User's Guide also are summarized in the following sections of
this manual.
The only exception is the
SET /UIC
command,
which
is
detailed in this manual.

Table
Set

4-1

Command

Options

Option

Function

ACCOUNTING!

Initializes the accounting log file

CARD_READER

Defines

card

[NO]CONTROL_Y

Controls
to

DEFAULT

the

default

ASCII

reader

the

whether

command

Establishes
current

default

pressing

translation

mode

CTRL/Y passes

for

control

interpreter.
disk
for

and/or
file

directory

the

specifications

DEVICE !

Defines device characteristics

LOGINS1

Allows or disallows users to log into the system

MAGTAPE

Defines

device

characteristics

magnetic

tape

[NO]ON

Controls whether the command interpreter
checks
for
an
error condition following the execution
of a command in a command procedure

PRINTER 1

Defines characteristics of a printer

PROCESS

Defines

execution

characteristics

the

current

process

PROTECTION

Defines

the

protection

status

file

group

files, or establishes the default protection
to be applied to all files subsequently
created
during the job

This command is described in the VAX/VMS Operator's Guide.
(continued

4-79

next page)

MCR COMMANDS

Table

4-1

(Cont.)

Set Command Options
Function

Option

QUEUE

RMS

DEFAULT

Changes the attributes associated with an
in a printer or batch job queue

entry

multibuffer
and
Provides default multiblock
to be used by VAX-11] RMS for file
count values
operations

operational

TERMINAL

Defines

/UIC

Changes the UIC of

[NO] VERIFY

Controls
displays

executes

WORKING_SET

characteristics

terminal

whether
1in
lines

the current process

interpreter
command
the
it
as
command procedures

them

Changes the current working set limit or quota

MCR COMMANDS

SET CARD_READER
4.26.1

Set Card Reader

The Set Card Reader command defines the translation mode

for

card

reader.
Format:

SET CARD_READER device-name

[keywords]

/026

keywords

/029

Example:

> SET CARD_READER CRAO:

/029

This command establishes the default mode for card
as

029.

reader

input

MCR COMMANDS

SET CONTROL__Y
4.26.2

Set Control

The

Control

Set

command

determines

whether

the

command

interpreter

receives
control
when
you
press
CTRL/Y.
The CTRL/Y function key
provides a general purpose escape;
you
can
press
it
at
any
time
during
an
interactive
terminal
session
to
interrupt
the current
command,
The

command procedure,

Set

NoControl

applications.

When

program

command

the

Set

1is

image.

provided

NoControl

for

use

special

command is executed

in a

system-specific command procedure for a particular user at login, that
user
can
communicate only with the application program that controls
the terminal.
The effect of Set NoControl Y
for all commands and programs
to respond to CTRL/C.

applies
that do

to the CTRL/C function
not have special action

as
well
routines

Format:
SET

CONTROL_Y

Example:
>

SET

NOCONTROL_Y

After

the

system executes

this

command,

the

CTRL/Y

function

disabled.
Note:

If the user authorization
system-specific
indirect
not executed when you log

file
<contains
a
command file, your
into the system.

file
name
of
LOGIN.CMD file

a
is

MCR COMMANDS

SET DEFAULT
4,26.3

Set Default

The Set Default
command
establishes
a
new
default
device
and/or
directory
for
the
current
terminal
session.
The new defaults are
applied to all subsequent file specifications that do
not
explicitly
name the device or directory.
Format:

SET DEFAULT

[device-name[:]] [<directory>]

Examples:
>

SHOW

DEFAULT

DBB1: [MONET]
> SET DEFAULT [RENOIR]

The Show Default command displays the name of
the
default
disk
device
as
DBBl1
and
the directory as [MONET].
The Set Default
command establishes [RENOIR] as the new default directory.
DBB1
remains as the default disk.
>

SET DEFAULT DBB2: [HASSAM]

This command establishes DBB2 as
[HASSAM]

the

the default directory name.

default

disk

device

and

Note:

When a new default disk
device
1is
established,
the
equates
it
with the logical name SYS$DISK.
SYSSDISK
SY0 in that it is applied by default.

system
is like

MCR COMMANDS

SET MAGTAPE
4.26.4

Set Magtape

The

Magtape

Set

command

defines

the

specific magnetic tape device for
tape must be unmounted or mounted

characteristics

all subsequent
/FOREIGN.

associated

file

with

operations.

The

Format:

SET MAGTAPE

keywords

device-name

[keywords]

/DENSITY=density
/REWIND
/UNLOAD

Example:
>

SET MAGTAPE

This
MTB2

MTB2:/DENSITY=800

command sets
to 800 bpi.

the default

density

for

writing

files

using

MCR COMMANDS

SET ON
4.26.5

Set On

The Set On command requests that the command interpreter perform error
checking
following
the
execution of commands in an indirect command
file;
Set NoOn inhibits error
checking.
During
the
execution
of
indirect command files, the command interpreter checks the status code
returned when an MCR command or directive or program image
completes;
it
saves
the
numeric
value
of
the
code
1in the special variable
$STATUS.
The low-order three bits of this value also are saved in the
special symbol S$SEVERITY.

The On command, described in Section 4.22, establishes an action to be
taken
based on the value of the symbol $SEVERITY;
the default action
is to stop the execution of the indirect command file when
errors
or
severe

errors

occur.

Format:

SET

[NO]ON

Example:
SET NOON

DELETE MEANS.*;4
SET ON

The Set NoOn inhibits error checking at the end of a command.
As
a
result,
no
errors
are reported during the delete operation.
The subsequent Set On command re-enables error checking.
Notes:

When Set NoOn is in effect, the command interpreter
continues
to
place
the status code value in the symbol $STATUS and the
severity level in $SEVERITY;
it does
not,
however,
perform
any action based on the value.

The Set NoOn command applies only within the indirect
command
file in which it is executed.
If you use the Set NoOn command
in one indirect command file
that
invokes
another
indirect
command
file,
the default condition of Set On is established
automatically for the second file.

4-85

MCR COMMANDS

SET PROCESS
4.26.6

Set Process

The Set Process command lets you change the priority of a process
and
enable
or
disable resource wait mode or swapping for a process.
You
can specify the process with
either
a
process
name
or
a
process
identification.
If
you
specify neither, the characteristics of the
current process are changed by default.
Format:

SET PROCESS

keywords

[process-name]

/IDENTIFICATION=pid
/PRIORITY=n

/[NO]RESOURCE_WAIT
/ [NO] SWAPPING
Example:
>

SET PROCESS/PRIORITY=7/NOSWAPPING
This command changes the current
process's
priority
to
7
and
disables swapping for the process.
You must have the appropriate
privilege to raise your priority higher than the default priority
contained
1in
your user authorization file entry.
have the appropriate privilege to disable swapping.

You

also

must

MCR COMMANDS

SET PROTECTION
4.26.7

Set Protection

The Set Protection command establishes the protection that is
applied
to
a file or group of files, or it establishes the default protection
for all files subsequently created during the terminal
session.
You
can
specify protection types of read (R), write (W), execute (E), and
delete (D) for the categories system, owner, group, and world.
Format to Set Protection on Files:
SET PROTECTION[=([SYSTEM:prot,]
[OWNER:prot,] [GROUP:prot,]
[WORLD:prot])] file-spec,...[/PROTECTION=...],...
Format

to Set Default Protection:

SET PROTECTION=( [SYSTEM:prot] [OWNER:prot] [GROUP:prot] [WORLD:prot]/DEFAULT
Examples:
> SET PROTECTION=(SYSTEM:RWED,OWNER:RWED,WORLD:R)
> TREEN.DAT /PROTECTION=(GROUP:RW)
,> CHARGER.EXE /PROTECTION=(GROUP:RE)

This command first establishes the protection for both
files
as
read,
write, execute, and delete for the system and owner and as
read-only for the world.
It then specifies that,
for
the
file
TREEN.DAT,
group
members
are allowed read and write access and
that, for file CHARGER.EXE, group members are
allowed
read
and
execute
>

SHOW

EDI

access.

PROTECTION
SYSTEM=RWED, OWNER=RWED,

GROUP=RWED,

WORLD=R

HEREZ.FOR

[CREATING NEW FILE]

INPUT

SET

PROTECTION=(GROUP:R,WORLD)

The
for

HEREZ.FOR

Show Protection command displays the default file
protection
the current process.
When the file HEREZ.FOR is created, the

default protection is given to it.
The
Set
Protection
then modifies the protection for HEREZ.FOR as follows:

Protection

for

Group access

The world

system

and

owner

remain

restricted

read-only

is denied access

the

command

unchanged

file

SET PROTECTION=(SYSTEM:RWED,OWNER:RWED,GROUP:RE,WORLD:R)
/DEFAULT

This command changes the default
of the terminal session.

file protection

for

the duration

MCR COMMANDS

SET QUEUE
4,26.8

Set Queue

The Set Queue command changes
is queued for printing or for

the status or attributes of a file
that
batch job execution but that has not yet
been processed by the system.
The
system
assigns
a
unique
entry
number,
called
a job identification, to each queued printer or batch

job in the system.
The Print and
Submit
commands
display
the
identification when they successfully queue a job for processing.

job

Format:

SET QUEUE/ENTRY=jobid

keywords

[keywords]

[queue-name]

/AFTER=absolute-time
/FORMS=type
/HOLD
/JOB_COUNT=n
/ [NO] LOWERCASE
/NAME=job-name
/PRIORITY=n
/RELEASE

Examples:

PRINT/HOLD RAH.DAT
Job 134 entered on queue

SYSSPRINT

SET QUEUE/ENTRY=134/RELEASE

The Print command requests that the file RAH.DAT be queued to the
system
printer
and
placed
in
a
hold
status.
The Set Queue
command releases the file for printing.
>

SUBMIT

job

MYJOB.COM

210

entered on queue

SYS$BATCH

SET QUEUE/ENTRY=210/HOLD

SYSSBATCH

The Submit command requests that the job MYJOB be placed
in
the
batch
queue.
Before
the
job
starts execution, the Set Queue
command requests that the job be placed in a
hold
status.
The
job
remains
in that status until a subsequent Set Queue command
releases

it.

Notes:

RSX-11M does

not

See Section 2.7.6

support
for

the

Set Queue

command.

a description of

absolute

time.

MCR COMMANDS

SET RMS_DEFAULT
4.26.9

Set RMS Default

The Set RMS Default command defines default values for the multiblock
and multibuffer fields used by VAX-11 RMS during file operations;
it
has no effect on RMS-11 file operations.
You
can
set
defaults
for
sequential or relative files on a process-only or system-wide basis.
Format:

SET RMS_DEFAULT

keywords

[keywords]

/BLOCK_COUNT=count

/BUFFER_COUNT=count
/DISK
/INDEXED
/MAGTAPE
/PROCESS
/RELATIVE
/SEQUENTIAL
/SYSTEM
/UNIT_RECORD

Examples:

> SET RMS_DEFAULT/BUFFER_COUNT=2

This command defines the current
process's
default
multibuffer
count for input/output operations as two.
The default applies to
all sequential file operations, that is, operations on sequential
disk files, magnetic tapes, and unit record devices.
>

SET RMS_DEFAULT/BLOCK_COUNT=4

This command
defines
the
default
multiblock
count
for
this
process
as
four.
The
default is not applied to user programs
that establish explicit multiblock counts.

SET RMS_DEFAULT /RELATIVE

This command indicates
that,
for
the
current
process's
disk
files,
the
default
file
organization
1is
relative.
When you
specify /RELATIVE or /SEQUENTIAL, /DISK is assumed.

MCR COMMANDS

4.26.10

Set Terminal

The Set Terminal
terminal
for
a
characteristics.
generation based

command changes the characteristics
of
a
specified
particular
application
or overrides system default
The default characteristics are
defined
at
system
on the most common type of terminal in use.

Format:

SET

keywords

TERMINAL|[=device-name] [keywords]

/ [NO] BROADCAST
/[NOJCRFILL[=formula]
/ [NO] ECHO
/ [NO]JEIGHTBIT
/ [NO] ESCAPE
/ [NO] HARDCOPY
/ [NO] HOLDSCREEN
/ [NO]JHOSTSYNC
/ [NO] INTERACTIVE
/LA36
/[NO]JLFFILL[=formulal
/ [NO] LOCAL
/ [NO] LOWERCASE
/PAGE=n

/ [NO]PARITY [=option]
/ [NO] PASSALL
/ [NO] READSYNC
/ [NO] REMOTE

/ [NO] SCOPE

/SPEED=rate
/ [NO] TAB
/ [NO] TTSYNC
/ [NO] TYPEAHEAD
/UNKNOWN
/ [NO] UPPERCASE
/VTO05
/VT52
/VT55
/WIDTH=n
/ [NO]WRAP
Table

4-2

shows

terminal

defaults.

MCR COMMANDS

Default

Table 4-2
Characteristics

Terminal

Terminal
Characteristic

Type

for

Terminals

and Qualifier

UNKNOWN

LA36

VTO05

VT5x

/UNKNOWN

/LA36

/VTO05

/VT52
/VT55

WIDTH

132

PAGE

SPEED

BROADCAST

CRFILL

ECHO

yes

EIGHTBIT

ESCAPE

HOLDSCREEN

HOSTSYNC

yes

LFFILL

LOWERCASE

yes

PASSALL

REMOTE

TYPEAHEAD

yes

TAB

yes

TTSYNC

yes

WRAP

yes

The current

setting

not changed by the qualifier.

Examples:

SET TERMINAL /VTO05
This

command

the

sets

its

establishes
characteristics

SET TERMINAL=TTA3

current terminal
that of a VTO05.

VTO05,

and

/NOTYPEAHEAD

This command establishes the terminal named TTA3
as
one
from
which
input
1is
accepted only when a program issues a read to
it;
that is, the terminal's use is dedicated to an application
program.

4-91

MCR COMMANDS

4.26.11

Set Default UIC

The Set Default UIC command
establishes
a
new
directory
as
the
default
and,
if
you
have
Change
Mode
to
Kernel
privilege,
establishes a new user identification code as the default.
Format:

SET /UIC=[g,m]
g

Specifies the UIC group number
through 377 (octal).

Specifies
0 through

the
377

UIC member
(octal).

number

the

range

Examples:
>

SET /UIC={[200,220]}

This command establishes
the issuing process.

the UIC

[200,200]

the

default

Notes:

RSX-11M supports

the

To display your

UIC,

Set Default UIC
use

the

command.

Show Process

command.

for

MCR COMMANDS

SET VERIFY
4.26.12
The

Set Verify

files

are

command

controls

whether

displayed

lines

indirect

command

at the terminal or printed in a batch job log
when the indirect command file is executed.
With verification
off,
only
MCR
commands are displayed or printed.
With verification on,
the
entire
command
stream
is
displayed
or
printed.
String
substitution occurs before lines are displayed or printed.
Format:

SET

[NO]VERIFY

Example:
>
>

SET VERIFY

SET

@TEST.CMD

NOVERIFY

In the sequence above, verification is turned on to test a
new
indirect
command
file.
Each
1line
1in the file is displayed
followed by related error messages,
if
any.
After
TEST.CMD
terminates,
the
Set
No
Verify
command
restores the system
default.
Notes:

By default, the system does not display the command lines at
the
terminal
when it processes indirect command files that
are requested interactively, rather than
queued
for
batch
processing.
System responses and error messages are always
displayed.

The

default

indirect

setting

command

for

file

batch

jobs

appear

the

for

all

batch

lines

job

listing.

the

If any lines displayed as a result
of
Set
Verify
contain
symbol
names that are substituted before command execution,
the command interpreter displays
the
1line
as
it
appears
after substitution.

When you change
effect
for all
execute.

the
verification
setting,
indirect command files that

it
you

remains
in
subsequently

MCR COMMANDS

SET WORKING_SET
4.26.13

Set Working Set

size
set
The Set Working Set command redefines the default working
for the process or sets an upper limit to which the working set size
can be changed by an image that the process executes.

Format:

SET WORKING_SET

[keywords]

/LIMIT=n

keywords

/QUOTA=n

Example:
>

SHOW WORKING_SET

Working Set

/Limit=100

> SET WORKING_SET/LIMIT=90

/Quota= 200

Authorized Quota= 200

In the sequence above, the Show Working
Set
command
displays
the
current working set limit, quota, and authorized quota for
the process.
The Set Working Set command reduces the limit
to
90.
Notes:

RSX-11M does not support the Set Working Set command.

An RSX-11M image cannot affect the working set limit.

MCR COMMANDS

4.27

SHOW

The

Show command provides a number of options
that
characteristics
and
defaults
for
your
process,
Table 4-3 lists the Show options.
The

Show

command.,

command

These

User's Guide

and

options

are

aquivalent

options are detailed

summarized

the

1let
jobs,

options

you

and

display
devices.

the

DCL

SHOW

in the VAX/VMS Command Language

following

sections.

Table 4-3
SHOW Command Options

Option

Displays

[DAY] TIME

The

current date

DEFAULT

The

current

DEVICES

The

status

LOGICAL

Current

MAGTAPE

and

default

disk

devices

logical

Information

time

name

about

and

directory

the

system

assignments

designated

magnetic

unit
NETWORK

The

availability

current
PRINTER

device

network

nodes,

tape

including

Information

about

designated

magnetic

tape

unit
PROCESS

Attributes

the

privileges,
priority, and
The

QUEUE

Printer

not

printed

RMS_DEFAULT

The

STATUS

The

current

default

batch

current
counts used

current

protection

jobs

that

the

time,

files

queued

but

current

job,

including

open

count,

and

file

operations

SYMBOL

Current

SYSTEM

TERMINAL

The

device

characteristics

TRANSLATION

The

result

WORKING_SET

The

current

symbol

been

multiblock
and
multibuffer
by VAX-11 RMS for file operations

CPU

list

have

applied

usage,

default

status

I/0

including

processed

accumulated

process,

resource
quotas,
memory
accounting information

PROTECTION

yet

the

node

all

count

definitions

processes

translating

working

set

the

system

your

logical

size

limit

terminal
name

and

quota

MCR COMMANDS

SHOW DAYTIME
4,.27.1

Show Daytime

The Show Daytime command displays the current date and time of day.
Format:

SHOW

[DAY]TIME

Example:
>

SHOW TIME

31-DEC-1977

00:03:45

Note:

RSX-11M does not support the Show Daytime command;
it does,
however,
support
the Time
command,
which VAX/VMS
also
supports.

MCR COMMANDS

SHOW DEFAULT
4.27.2

Show Default

The Show Default
directory name.

command

displays

the current default

disk

device

and

the

user

Format:
SHOW DEFAULT

Example:
>

SHOW DEFAULT

DBAl:[122,020]
>

SHOW

DEFAULT

DBB2: [CALEB]
Note:

default

disk

authorization
command

and

file

change

directory

entry,

them

are

but

for

the

The

established

you

can

duration

use
a

the

Set Default

terminal

session.

MCR COMMANDS

4,27.3

Show Devices

The Show Devices command displays the status of all devices or
a
set
of
devices
1in
the
system
or the status of a particular device, or
lists the devices that currently have volumes mounted on
them
and/or

are allocated to processes.
Format:

SHOW DEVICES

keywords

[keywords] [device-name]

/ALLOCATED
/BRIEF
/FULL
/MOUNTED

Examples:
>

SHOW DEVICES/MOUNTED
List of Devices
Device
Device
Device
Name
Status
Characteristics
DBAO
on line
MNT
DBA3
on line
MNT

on
Err.
Count
0
0

3-JAN-1978
Volume
Label
SYSTEMVOL
SYSSCR

This command causes the
names
of
all
displayed
with
additional information
volume it contains.
>

SHOW

DEVICES

08:40:41.77
Free
Trans
Blocks
Count
24712
1
7583
27

Mount
Count
1
1

mounted
devices
to
about each device and

be
the

DB:

List of Devices

3-JAN-1978

08:40:41.77

Device

Err.

Volume

Free

Trans

Mount

Name

Status

Characteristics

Count

Label

Blocks

Count

DBAO
DBA3

on
on

line
line

MNT
MNT

This command causes the
drives to be displayed.

0
0

names

SYSTEMVOL
SYSSCR

all

RP04,

24712
7583

RP05,

and

1
27

RP06

disk

MCR COMMANDS

SHOW LOGICAL
4.27.4

Show Logical

The Show Logical command displays all logical names
in
one
or
more
logical name tables, or displays the current equivalence name assigned
to a specified logical name.
By default,
the
Show
Logical
command
displays all logical names in all logical name tables in the following
format.
logical-name

= equivalence

name

(table)

Format:

SHOW LOGICAL

[keywords]

keywords

[logical-name]

/ALL
/GROUP
/PROCESS
/SYSTEM

Examples:
>

SHOW

LOGICAL

MYDISK

DBBl:

This command
MYDISK
and

(Process)

causes the equivalence name
for
the
the
1logical
name
table in which it

1logical
is found

name
to be

1logical

name

displayed.
>

SHOW LOGICAL/PROCESS

Contents

of process

logical

name

table:

SYS$INPUT = _TTE7:
SYS$SOUTPUT = _TTE7:
SYSSERROR = _TTE7:
TT

_TTE7:

SYSSCOMMAND = _TTE7:
SYS$DISK

= DBAl:

MYDISK

DBB1:

This command causes all the entries in the process
table to be displayed with their equivalence names.
Note:

The Show Logical
to 10 times.

command

performs

translation

recursively

MCR COMMANDS

SHOW MAGTAPE
4,27.5

Show Magtape

Show Magtape
command
magnetic tape unit.
The

displays

information

about

designated

Format:

SHOW MAGTAPE

device

name

device-name

Specifies the magnetic tape unit.
If you
omit
the
controller
or
unit
number,
the
command displays
information
for
controller
A
and
unit
0,
respectively, by default.

Example:

SHOW MAGTAPE MTB2
MTB2: UNKNOWN, DENSITY=800, FORMAT=Normal-1ll
End-of-File odd Parity

4-100

MCR COMMANDS

SHOW NETWORK
4.27.6

Show Network

The Show Network command displays the availability of the
1local
node
as
a
member
of
the
network,
and
the names of all nodes that are
currently accessible by
the
1local
node.
If
the
network ACP
is
running,
the
Show Network
command
displays
the
1local node name,
number, and state (ON or
SHUT).
Then,
it
displays
the
names
of
accessible remote nodes and lines on which the nodes are accessed.
Format:

SHOW NETWORK

Example:
>

SHOW NETWORK

NETWORK STATUS AS OF 06-JUN-1978 12:42
LOCAL NODE NAME:
NUMBER:
STATUS:

ACCESSIBLE

VAXI1
3
ON

REMOTE NODES
NODE

LINE

MANILA:

XMAO

CHI:

XMCO

The Show Network command displays the status of
and lists available remote nodes.

4-101

the

1local

node

MCR COMMANDS

SHOW PRINTER
4.27.7
The

Show Printer

Show

Printer

currently defined

command

for

displays

the

system printer.

default

characteristics

Format:

SHOW PRINTER device-name
Example:
>

SHOW

PRINTER LPAO:

LPAO:

This

LPll,

LPAO.

WIDTH=132,

command

requests

PAGE=64,

NOCR,

a display of

4-102

FF,

LOWER

the characteristics

of printer

MCR COMMANDS

SHOW PROCESS
4.27.8

Show Process

The Show

Process

command

displays

information

about

the

current

process.

Format:

SHOW PROCESS

[keywords]

keywords

/ACCOUNTING

/ALL
/PRIVILEGES
/QUOTAS
/SUBPROCESSES

Example:
>

SHOW

PROCESS

3-JAN-1978

08:44:41.67

Pid : 0003002F
Proc. name :
Priority : 5 Default file spec.
Devices

allocated

_TTE7:

FIELDING
:DBB2:[122,020]

TTE7

4-103

User:

UIC

FIELDING

[122,20]

MCR COMMANDS

4.27.9

Show Protection

The
Show
Protection
command
displays
the
current
default
file
protection
that
1is
applied to all files created during the terminal
session;
that is, it indicates which combination
of
the
privileges
read (R),
write (W), execute (E), and delete (D) is to be extended to
system,

owner,

group,

and

world.

Format:

SHOW PROTECTION

Example:
>

SHOW

PROTECTION

SYSTEM=RWED,

OWNER=RWED,

GROUP=RWED,

WORLD=R

This command indicates that the system, the file owner,
and
all
others
in
the
same
group
as the file owner have read, write,
execute, and delete access;
all
other
wusers
have
only
read
access.

4-104

MCR COMMANDS

4,.27.10

Show Queue

The Show Queue command displays the current status of entries
in
the
printer
or
batch
Jjob
queues.
By
default, the Show Queue command
provides a brief listing of information about
3jobs
in
the
specific

queue.

that are

1lists the job currently being processed and all your jobs

in the queue.

Format:

SHOW QUEUE

[keywords] [queue-name]

/ALL
/BATCH
/BRIEF
/DEVICE
/FULL

keywords

Examples:

SHOW QUEUE/DEVICE
* DEVICE QUEUE

"LPAO:"

FORMS=0 GENPRT FLAG

* DEVICE QUEUE

"LPBO:"

FORMS=0 GENPRT FLAG

Current job 138 CRAMER

Pending job 139 HIGGINS
Pending job 140 HIGGINS

* DEVICE QUEUE

"SYSSPRINT"

Holding job 105 HIGGINS

ALPHA

, Pri=4, 12-JAN-1978 14

DOCMASTE,
DOCRUN3 ,

Pri=4,
Pri=4,

12-JAN-1978
12-JAN-1978

15
15

FORMS=0 GENDEV FLAG

DOCRUN2

Pri=4,

COPIES=1l,

12-JAN-1978

The Show Queue command displays the status of the printer queues.
The
first
queue, LPAO, has no entries.
The second queue, LPBO,
is currently processing a job for the user CRAMER.
Two jobs
are
pending for the user HIGGINS (who issued the command).
The third
gueue, named SYS$SPRINT, consists of jobs that are being held.
>

SHOW QUEUE

SYSS$BATCH/FULL

BATCH QUEUE

"SYSSBATCH"

Current job 201 WILSON
Current job 202 HARRIS
Current job 203 HIGGINS

INIPRI=4,

SWAP

BATCHO1
Pri=4,
FORCLG
Pri=4,
ASSEMBLE Pri=4,

12-JAN-1978 14:15
12-JAN-1978 14:20
12-JAN-1978 14:22

DBAl :ASSEMBLE.COM;
3

Pending job 205 HIGGINS
2
DBAL : BACKUP.COM;
DBAl : AVERAGE.COM;
2

BACKUP

12-JAN-1978

14:30

DBA1l :DOCMASTER.COM;
5

The Show Queue command requests a display
of
all
Jjobs
1in
the
batch
job
queue.
The
/FULL
qualifier
requests,
for
Jjobs
submitted by the user typing the command, the file specifications
of

files

the

job.

4-105

MCR COMMANDS

SHOW RMS_DEFAULT
4,27.11

Show RMS Default

The Show RMS Default
command
displays
the
current
multiblock
multibuffer
counts
for
the process and the system.
VAX-1ll RMS
these counts for multiblock and multibuffer file operations.
Format:
SHOW RMS_DEFAULT

Example:
>

SHOW

RMS_DEFAULT

MULTI-

BLOCK
COUNT
Process
0

:
:
:

System

MULTI-BUFFER COUNTS

1Indexed

Relative

0
0

4-106

Sequential
Disk Magtape Unit Record
0
0
0
0

and
uses

MCR COMMANDS

SHOW STATUS
4.27.12

The

Show Status

command displays

the

status

the

current process.

Format:
SHOW STATUS

Example:
>

SHOW

STATUS

Status

3-JAN-1978

Buff. I/0 :
Dir. I/0 :

181
42

08:47:51.09

Cur. ws. :
Phys. Mem :

Elapsed

296
47

CPU:

000:00:12.08

Open Files :
Page faults :

0
185

Note:

you

interrupt

Show

Status

running

command,

you

image
can

by pressing CTRL/Y and
continue

image

execution

the Continue command.
You cannot
continue
execution
interrupted image after using the Show Process command.

4-107

issue
using

MCR COMMANDS

SHOW SYMBOLS
4.27.13

Show Symbols

The Show Symbols command displays the value currently
assigned
to
specified
symbol,
or
displays
all
the symbols and their values
either the local or global symbol tables.

a
in

Format:

SHOW SYMBOLS

[keywords]

[symbol-name]

/ALL
/GLOBAL
/LOCAL

keywords

Examples:

SHOW SYMBOLS/GLOBAL

SSEVERITY = 1

S$SEVERITY

This command displays
>

the value of

the global

symbol

SEVERITY.

SHOW SYMBOLS/LOCAL/ALL
A =1
B =20
MODE

N1l

42,

INTERACTIVE

This command displays all

the entries

in the local

symbol

table.

Notes:

You can define symbols using MCR

Local symbols are available only
at
the
indirect
1level
at
which
they
are defined.
Global symbols are available at all

by equivalent DCL

functions.

.ASKx or

.SETx directives and

levels.

The
of

.ENABLE GLOBAL directive

global

symbols.

is used to allow

4-108

the

definition

MCR COMMANDS

SHOW SYSTEM
4,.27.14
The

Show System

Show System command

the

displays

information

relating

the

activity

system.

Format:

SHOW SYSTEM

Example:
>

SHOW SYSTEM

VAX/VMS Processes
pid

Process Name

3-JAN-1978
UIC

12:26:00.50

State

Pri

00010000
00010001

NULL
SWAPPER

000,000
000,000

COM
HIB

1
17

0
0

CPU
13:35:18.42
00:04:37.98

00070031

YOURJOB

122,020

CUR

00:00:01.56

4-109

Dir.I/0

Page

flts
0
0

384

Ph.Mem

0
0

MCR COMMANDS

SHOW TERMINAL
4,27.15

Show Terminal

The
Show
Terminal
command
displays
the
terminal or of another designated terminal.

characteristics

Format:

SHOW TERMINAL

[device-name]

Example:
>

SHOW TERMINAL

TTE7:

/VT52, WIDTH=80
PAGE=16, OWNER=SELF
SPEED=(2400,2400),
CRFILL=0, LFFILL=0,
NO PARITY
INTERACTIVE,
ECHO, TYPEAHEAD, NOESCAPE, HOSTSYNC, TTSYNC
LOWERCASE,
TAB,
WRAP,
SCOPE,
LOCAL, NOHOLDSCREEN,
NOEIGHTBIT,

BROADCAST,

NOREADSYNC

4-110

your

MCR COMMANDS

SHOW TRANSLATION
4.27.16

Show Translation

The Show Translation command searches the process, group,
and
system
logical
name
tables, in that order, for a specified logical name and
returns
the
equivalence
name
of
the
first
match
found.
The
translation
1is
not recursive;
it is recursive with the Show Logical
command.

You can interrupt an executing image by pressing CTRL/Y, issue a
Show
Translation
command for a logical name and then resume execution with
a Continue command.
You cannot issue a Show Logical command and
then
resume image execution in this way.
Format:

SHOW TRANSLATION

logical—-name

Example:
>

SHOW TRANSLATION

DKO

DBB2:

DKO

(System)

This show command displays the VAX/VMS physical
as the equivalence name for logical name DKO.

4-111

device

name DBB2:

MCR COMMANDS

SHOW WORKING_SET
4.27.17

Show Working Set

The Show Working Set command displays the working set quota and
assigned to the current process.
Format:

SHOW WORKING_SET

Example:
>

SHOW WORKING_SET

Working Set

/Limit=100

/Quota=200

4-112

Authorized Quota=200

1limit

MCR COMMANDS

4,28

STOP

The Stop command

terminates execution of one of

A program or indirect command
CTRL/C or CTRL/Y

A program executing

file

the

that

subprocess or

following:

was

interrupted

detached process

Format:

STOP

[keyword]

[process-name]

keyword

/IDENTIFICATION=pid

process-name

Specifies the name of the
process
or
subprocess
containing the program to be terminated.

Command Keyword:

/IDENTIFICATION=pid

Specifies
the
process
identification
of
the
process or subprocess containing the program to be
terminated.

Examples:
>

@WARHOL.CMD

4
>

STOP

This
sequence
starts
WARHOL.CMD,
interrupts

the
execution
of
the
indirect
file
1its
execution
by
pressing CTRL/Y, and
terminates its execution by typing STOP.
By default,
the
image
in the current process is terminated.

RUN /PROCESS=PRIOR LIMNER.TSK

*
~

STOP

PRIOR

This sequence starts the execution of the
subprocess
named
PRIOR.
Typing
STOP
terminated

and

the

subprocess

4-113

image LIMNER.TSK
causes
the image
be deleted.

in
to

a
be

MCR COMMANDS

Notes:

The current process does not require privilege to stop one
of
its
subprocesses.
The
current
process
must have group or
world privilege to stop any other process.
The Stop command causes
currently
executing;
handling routines, they

When an

image

image
1is
run,
However, in this

execute before

an abnormal termination of
the
image
if
the
1image
has
declared any exit
are not given control.

interrupted by CTRL/Y or

CTRL/C,

the
interrupted
image
1is
case, exit handling routines

the next

When an indirect command
(that is, all levels) is
command interpreter.
Stopping the image
process causes the
be deleteqd.

image

also
are

and

another

terminated.
allowed
to

runs.

file is stopped, the entire procedure
terminated and control returns to the

executing
1in
a
subprocess
or
detached
specified subprocess or detached process to

When you create a subprocess or detached process using the Run
command,
the
command
displays the process identification of
the process created.
The Show

Process

command

displays

subprocesses.

4-114

the

current

status

MCR COMMANDS

SUBMIT
4.29

SUBMIT

The Submit command queues an MCR indirect command file or a DCL
command procedure for execution as a batch job. Your default (not
current) command interpreter determines whether you can submit an
indirect command file or a command procedure as a batch job. If your

default command interpreter is MCR, you can submit MCR indirect
command files for batch processing; if it is DCL, you can submit DCL
command procedures for batch processing. All output from the indirect
command file is queued to the device assigned the logical name
’

SYSSPRINT at the time the job terminates.
Format:

SUBMIT

keywords

file-spec

[keywords]

file-spec

[keyword],...

/AFTER=absolute-time

/ [NO]DELETE
/ [NO]JHOLD
/ [NO] IDENTIFY
/NAME=job-name
/PARAMETERS=parameters
/PRIORITY=n
/QUEUE=queue-name

Specifies the

name

command

procedure

If no file type is
submitted for batch execution.
specified, the Submit command uses the default file
If you specify more than one file, use
type of COM.
to separate file
(+)
either a comma (,) or a plus
Files are processed in the order of
specifications.
specification.

Command Keywords:

/AFTER=absolute-time

Requests that the job be processed after a
Specify the time
specific time of day.
according

absolute times.

the

rules

for

specifying

If the specified time has already passed,
immediate
for
queued
is
job
the

processing.

default,

jobs

are

submitted

immediately.

/HOLD
/NOHOLD (default)

Controls whether the job is to be made
If
available for immediate processing.

you specify /HOLD, the job is not released
Queue /NOHOLD
Set
1issue a
until you
command

for

4-115

it.

MCR COMMANDS

/IDENTIFY (default)
/NOIDENTIFY

Controls

JOB

jobid

Usually,

/NAME=job~name

whether

the

command

interpreter

displays the job
identification
assigned
to
the
job and the name of the device to
which it has been queued, as follows.
ENTERED ON QUEUE
the

device-name

SYSSBATCH.

Defines a 1- to
8-character
alphanumeric
name string to identify the job.
The name
string is displayed
1in
response
to
the

Show Queue
If

you

command.

not

specify

string
defaults
to
first file, truncated
if necessary.

name,

the file
to eight

the

Output files
from
the
indirect
file are named job-name.LOG.

/PARAMETERS=parameters

Specifies

from

parameters

file.
are

equated

the

indirect

eight

optional

indirect

symbols

command

passed

the

The parameters define

are
local
command file.

the

values

Pl,

file.

that

P2,

...

The

symbols

specified

indirect

If you specify more
than
separate them with commas
in parentheses.

one
parameter,
and enclose them

The

the

parameters.

that

contains

commas

specify

delimit

a parameter

characters

/PRIORITY=n

one
be

name

name of the
characters,

delimiters,

enclose

parameter

quotation

marks.

Specifies

the

priority
The value

for the
job
of n must be

submitted.
range

priority,

through

and

31;

special

1is

the

being

the

lowest

the highest.

By default, jobs
are
assigned
the
same
priority
as your process.
You can assign
lower priorities to nonessential
jobs
to
allow
your
other
3jobs
to
be processed
sooner.

Privilege is
value
that
priority.

/QUEUE=queue~-name

Specifies

job
queue
submitted.

4-116

required to
set
a
priority
1is higher than your process's

the

name

which

particular

the

job

1is

batch

MCR COMMANDS

File Keyword:

/DELETE
/NODELETE
(default)

Indicates whether the associated indirect
file is to be deleted after
command
processing. If you specify this keyword
as

a command keyword, all files specified

are deleted after processing.

Examples:

SUBMIT SHEELER

JOB 134 ENTERED ON QUEUE "SYSS$BATCH"

R.CMD for
This command submits the indirect command file SHEELE
134 and
ication
identif
job
the
d
The job is assigne
processing.
placed in the default batch queue, SYSSBATCH.

SUBMIT BURCHFIELD /PARAMETERS="DBA2:[PAINTER]NATURE.DAT"
JOB 123 ENTERED ON QUEUE "SYS$BATCH"

IELD and
This command submits the indirect command filefileBURCHF
ication
specif
the
to
equal
being
as
Pl
defines the symbol
DBA2: [PAINTER]NATURE.DAT.

Notes:

execution, it
e When the indirect command file is dequeued for eter
of the user
interpr
command
default
the
is processed by
who submitted the job. VAX/VMS does not consider the command
interpreter used to submit the job.

The file or files queued for process using the Submit command
The system assigns a wunique job
are considered a Jjob.
You can use the Show Queue
identification to each job.
ication of a queued batch
identif
job
the
ne
determi
to
command
job.

The attributes of a queued job can be changed

using

the

Queue command.

from
You can use the Delete/Entry command to remove a job ed.
batch queue or to delete an entry that is being process

RSX-11M does not support the Submit command.

4-117

Set
a

MCR COMMANDS

TIME
4.30
The

TIME
Time

command

displays

the

current

Format:
TIME

Example:
>

TIM

22-FEB-1978

12:43:12

4-118

date

and

time.

MCR COMMANDS

TYPE
4.31

The

the

TYPE

Type

command displays
terminal.

the

contents

file

group of

files

Format:

TYPE

[/OUTPUT=output-file-spec]

input-file-spec,...

/OUTPUT= output-file-spec
Requests

that

the

output

from

written
to
the
specified
displayed on your terminal.
By
default,
the
requested files at

input-file-spec

Is
the
file
displayed.

(+).

specification

1In either
order

You

can

file

case,

use

wild

file

description

all

files

the

Level

Files-11

that

Files

file

they
can
be
or a plus sign

displayed

type,

the

for

displayed

the

The Type

satisfy

Level

1in

directory,

fields.

order

are

Structure

file

version

alphanumeric

order

omit the
default.

instead

Structure

If you
LIS by

displays
terminal.

specified,
comma (,)
the files are

card

than

type,

displays

for

command

rather

named.

name,

command

Type

file

Type
command
the requesting

If multiple
files
are
separated
with
either

the

file

Files-11

random

Type

command

uses

Example:
>

TYPE

POLLOCK

The

Type command locates POLLOCK.LIS
types it on the terminal.

the

default

directory

and

Notes:

To temporarily halt the output,
after CTRL/S, use CTRL/Q.
To

suppress

the

display

use
CTRL/O.
If
terminates, output
processing.
If

you

wild
only.
file.
To

have

1is
at

than

CTRL/S.

allowing

resume

processing

pressed again before
the
current
point

one

file

continue,

the
in

specification

output

command
command

cards, CTRL/O suppresses the display of the current
Output resumes when the Type command
begins
the

stop

Stop

entered

while

CTRL/O
resumes

use

the display
command.

completely,

4-119

press

CTRL/Y

and

then

use

used

file
next

the

MCR COMMANDS

UFD
4.32

UFD

subdirectory on a
The UFD command creates a user file directory or
Structure Level 1 or 2 volume and enters the name of the UFD
Files-11
The volume must have been
in the volume's master file directory.
initialized and must be mounted before you can define UFDs for it.
To create a user file directory, you must have access to the master
file directory. The protection and UIC for the master file directory
they are the volume
are established during volume initialization;

protection and volume owner UIC.
Format:

UFD devcu: [directory] [/keywords]

keywords

/ALLOC=number-entries
/PRO=[system,owner ,group,world]
/UIC=[g,m]

devcu

Specifies the device, controller, and

[directory]

Specifies the directory or subdirectory name.

the device containing the volume.

create

subdirectory

RSX-11M cannot read

unit

number

you

on a structure level 1 volume,

it.

Command Keywords:

/ALLOC=number-entries

Specifies

the

number

directory

be
to
1is
space
which
for
entries
is
provided
number
The
allocated.
the next multiple of 32
to
up
rounded
(decimal).

the
/ALLOC,
specify
not
do
you
If
command allocates space for 32 directory
entries.

/PRO=[system,owner
group,world]

rights
access
Establishes
Specify
directory file.
codes

for

each

user

category.

the
for
protection

(D)
delete
and
(W),
write
Read (R),
protection are identical when the volume
VAX/VMS
either
is being accessed under
or
RSX-11M.
The
E
field
indicates
under
extend
execute under VAX/VMS and
RSX-11M.

command
If you do not specify /PRO, the
the default protection of the
supplies
directory (MFD, UFD, or subdirectory) in
being
1is
directory
new
the
which
created.

If you omit any one

the

protection

in that category are
wusers
categories,
denied access to the directory.

4-120

MCR COMMANDS

/UIC=[g,m]

Specifies

the

owner

UIC

for

the

If you do
directory or subdirectory.
not specify /UIC, the UFD command by
uses the owner UIC of the
default
directory in which the new directory is
being created.

Example:

> MOU DBB2:MYVOL

> UFD DBB2:[230,222]/PRO=[RWED,RWED,RE,R]

The UFD
d MYVOL.
The first command mounts the volume labele
ory with UIC [230,222]
command requests the creation of a direct
on the volume and establishes the protection for that directory.

Note:

VAX/VMS does not support the /UF
directories.

4-121

switch

for

PIP

create

CHAPTER
INDIRECT

COMMAND

VAX/VMS supports RSX-11M indirect
functions that RSX-11M provides:
@

Indirect command files
and the task builder

MCR

indirect

command

Indirect command files
function
identically
Chapter 3.

Any

MCR

the

RSX~11M,
to

example,

1indirect

execute

command

file

in Table

under

refer

which provides

indirect

command

sequences

executing

MCR

same

MACRO-11

files

directives,

commands

and

described

the VAX/VMS

directives.

at the terminal
indirect command file.

and

VAX/VMS

processor

nested;

both

the

can

directives

5-1

processes

files
files,
within

for

can

interpret

support

provide

commands

directive

existing
existing
checking

MCR

command

(AT.)

components,

are

VAX/VMS

Unlike

VAX/VMS

that

Any

indirect

files

alphabetically

the

command

for

summarized
of

FILES

intended for processing by
RSX-11M
components
under
VAX/VMS
and
RSX-11M,
as
described in

MCR indirect command files
contain the following:
®

test

Chapter

to Section

MCR
a

file

5.14.

processor

command
result,

them without

task

interpreter
you

can

creating

type

and

of
indirect
command
files
is
intended
to
allow
to execute under VAX/VMS.
Because it is intended for
VAX/VMS
does
not
perform
such
stringent
syntax
the
indirect
command
file
as RSX-11lM does.
As a

result, indirect command files
successfully under RSX-11M.

developed

under

VAX/VMS

may

not

execute

INDIRECT COMMAND FILES

QUON

09ds-a113 NIVHD®

Hmcfl¢[]uN8Iw95|OSuPxYSu:"

QUON

[

jewIog
\

QSuUUOoONN

SUON SUON

uorloung

d74dV¥SIqa” ASYOYAMOT

DxvI7A13*Iq:sssss
s
* nuu

9dAIS3rLTTQIaeMgSD0I3Ae3(IaQdeB3pU3ISTNI0TpT3RuIAlMKpJiuOJePOpwuOW1oeijdOIeaddwpsWSnTu9031IT3oAqU1uweOApTsu3oINAOaqSsXS197J1OJ3
QUON
SUON
SuIaO9UMD3I1I3QTqA
S90p WIT-XSY °*II°G UOT098 99¢%

vIvVqQ® [u$] pbuti3ys-3x3

3aSaoaT11rTsygqqgzoeeeTSuus)pIlyisqaddAAiiBi9rej1uiSToyyeeIsorpTpjnqDorusTuIoOodiiSpJosdsMposOupTobJauurordbo9is1iet0aTs3deis1induJseoiauorpsjr3ieo13ls9dl0Tt3q3iaTu0nawubesbdeiovo3idnoaKeariyiedurpouisoedisasuo97d13
INDIRECT COMMAND FILES

s31a0yod3upans

SuJsTo1q3egIoTqeUsToiIuOqTPihs

dTvdV¥SOIsqHad” VdT4IV0S1IAD® NAOTIVN¥ISLISqHAN*S SAYTVITYINT0®d

d90s09*
T®qeT
OLO9D° T°9®T

JdIrTTWdHIVUONNTTY** Td4VddvOOSTsOd
JJATTIIVUYNNITT®* NdOSIYLOYAILMIOLTSINS
LJJ4OI4Y°1(°J[NQls[dNI]sl®ss3s3 s3 3
SNI([N]JI® 3 3 3

3SuUoON

31q®BL 1-g (°3u0) paioubg Aq °*SWA/XVA 9 5
asuodsazx 03 ‘NSV° ‘NJSY° I0 SASY* QSUUOONN
3SuUoON

AJ1°sssdoro11dxs rewnsgJOSWA/XVAaSTySSas(oUurb[TsdqOuRTqgIuetTDweseua3OiIUiq3IaTslgeIyaTglsPT)aa0uTIUaPgqu3oOSosrrDUqnjj1IueInT3iJoUYsOoTiIl3apqalF2uuaIgyaSMYn9dopeBmMsTMPeTWOdiTsBnSJOTol)Oi}3qSST1WBs3EeS3ADqqT0SnorsSsvJb3T1i93e39ys1wAdT0TeoSIIpqsORaue3RY1iDDs3100U1aTddsSSATIOs9eSpssSasIaHay3Su1pAsdlo/eTUdULdaXQO8ssqVaTIyauAId3yy3Ial01Pd1esjauSIydTe§ASAd3er3*0uWm3ZusTTT°eaSnGTm*-hpuiXsaa9S{sq3aYsAeqaT0ei31jddpuRuwpUlouTde
sauiTwiIsailDa(qQgI3YyIy9jaYymMBe1 eI YTSoeq3uldwAisSTSs1TPOTp9IasuTEt3erI3ySaUpT pase{npyauulToidjesau3yaIojySldU)Tsjydseu9em3orSeS3UTxOsTa9A1jup33ee0da9(oiSTsptbue*leZrd°G
INDIRECT COMMAND
FILES

uot3oung

INDIRECT COMMAND FILES

auoN suoN

papeol

QUON SUON QUON

31Laune0apd1u3idonpaos

jeuwriog

-asnvda

JLAS® sssS8S

NS1L4IdSS®°ssSsSsSsddxxos2w1n3us

NAJO® [u#] o9ds-aT13

JAieuowuwns

auoN SUON

SUON

5-5

Ls198sS°s

INDIRECT COMMAND FILES

5.1

REQUESTING

INDIRECT COMMAND FILE

EXECUTION

Under VAX/VMS, you request execution of an indirect
command
file
in
the
same
way
that
you do under RSX-11lM;
that is, by preceding the
file specification of the indirect command file with an at
sign
(@).
However, under VAX/VMS, additional options are available:

You can use the /OUTPUT keyword to request that all output
SYSSOUTPUT be written to the specified file or device.

You can pass parameter values

(Pl

file.

through P8)

to the

indirect

Section 4.15 contains a description of these options.

5.2

SUPPORT OF

.IFINS,

.IFACT,

AND

.IFLOA

The following directives test conditions that are not defined

VAX/VMS

environment:

.IFINS

and

.IFNINS

.IFACT

and

.IFNACT

.IFLOA and

.IFNLOA

VAX/VMS

standard

supports these
responses

Task

directives

them:

installed;

that

is,

always

.IFINS

making

the

1in

the

following

true

and

.IFNINS

1is

false

and

.IFNACT

1is

true

and

.IFNLOA

1is

false.

Task

inactive;

that is,

.IFACT is

is loaded;

that is,

.IFLOA

true.

Driver
false.

Under
VAX/VMS,
users
do
not
1load
determines which drivers are present.

5.3

SUPPORT OF

.ENABLE AND

.DISABLE

drivers.

The

system

manager

ESCAPE

VAX/VMS ignores any
.ENABLE
ESCAPE
or
.DISABLE
ESCAPE
directives
encountered
1in
an indirect command file.
Both the RETURN and ESCAPE
keys always are recognized as valid line
terminators.
Pressing
the
ESCAPE

5.4

key causes

the

symbol

set.

UNSUPPORTED DIRECTIVES

VAX/VMS does not support the following
directives:
e

.XQT

and

.ONERR

.WAIT

indirect command

file processor

INDIRECT COMMAND FILES

All other directives are supported.
differences in directive support.

The following

describe

sections

.XQT and .WAIT Alternative

5.4.1

As an alternative to .XQT and .WAIT, you can use the Run command.
images execute serially in your process, the .WAIT directive
Because
one image must terminate before the next begins.
is not needed;
If you use the Run command to create a subprocess or detached process,

no means of synchronizing image execution from the indirect

there

5.4.2

.ONERR Alternative

command

file.

The VAX/VMS On statement, described in Section 4.22.2, can serve as an
On statement
the
However,
.(ONERR directive.
the
to
alternative
The
.ONERR.
than
provides a more general error handling capability
MCR command interpreter does not restrict use of error handling to the
specific errors associated with the .ONERR directive.

5.5

SWITCHES

defines

RSX-11M

three

for

switches

with

use

indirect

file

specifications:

and /NOTR

/TR

(trace)

/DE

(delete)

/MC

(pass commands to MCR)

and /NODE

The defaults under RSX-11M

are

and /NOMC

/NOTR,

/NODE,

and

/MC.

That

1is,

indirect command files are not traced during execution and not deleted
all
processes
interpreter
the MCR command
and
after processing,
commands.

the /DE
VAX/VMS supports the default case and also allows use of
It does not support the /TR
switch to delete files after processing.
and /MC switches.

No deletion

(/-DE or /NODE)

the
use
can
As an alternative to /TR, you
display command lines as they are processed;

5.6

is the default.

command
Set Verify
see Section 4.26.12.

SPECIAL SYMBOLS

VAX/VMS supports all the special symbols defined
by RSX-11M.
Table
5-2
summarizes
the symbols and provides VAX/VMS-specific information
where appropriate.

INDIRECT

COMMAND

Table

Special

Symbol

FILES

5-2

Symbols

Meaning

VAX/VMS-Specific
Information

True if last query was
answered with a single
escape character

True

.ASKN

answer

was

last

defaulted

True if last string entered
as

answer

.ASKS

tested with .TEST
only alphanumeric

<RAD50>

True
as

last

answer

contains
characters

string
.ASKS

entered

tested with .TEST contains
only Radix-50 characters
<MAPPED>

True

the

image

mapped

the

system on which

and

running

false

is
it

This

symbol

always

true.
is

unmapped

Memory size

in K words

Memory size

is always

32K.
<SYUNIT>

Unit

Length

number
of

last

as answer

tested

.TEST

Device

mnemonic

system device
string

.ASKS

entered

system

The

System

Symbol substitution
the same under both

5.7

Current

NUMERIC

device
<UIC>

Always

directory

The

UIC

for special symbols
RSX-11M and VAX/VMS

and
MCR.

mnemonic

always

SY.
current

directory

is in a
format.

valid

Always

[1,54]

user—-defined

VAX/VMS

symbols

SYMBOLS

Under VAX/VMS a numeric symbol
one of the following radixes:
®

Octal

(default

Decimal

Hexadecimal

radix)

defined

using

.SETN

.ASKN

can

INDIRECT COMMAND FILES

You can specify the
following ways:

radix

numeric

value

either

the

a
or
indicator
Using RSX-11lM conventions, that is, no radix
(#) for octal, and a trailing period for
sign
leading pound
decimal

Using a VAX/VMS radix indicator

is
The percent sign
VAX/VMS radix indicators have the format %rn.
r indicates the radix (O for octal, D for decimal,
required syntax;
Regardless
and n is the value of the symbol.
and X for hexadecimal);
the system stores and
of the method used to specify the radix,
The
implied.
displays the value as a numeric string with the radix
following are examples.

.SETN A 22

.SETN B

%X22

> .SETN C 22.
> .SETN D %007
> SHOW SYMBOLS/ALL
A = 22
B = 22
C = 22
D

You cannot determine the radix

symbol

value

using

Show

the

Symbols command.

5.8

LABEL TABLE ENTRIES

As in RSX-11M, VAX/VMS places any label that
appears
on
a
1line
by
so that, when a label is referred to, the
table
label
a
in
itself

Labels defined on a line
command interpreter can locate it quickly.
that also contains a command or other text are not placed in the label
table but can be specified as the

destination

.GOTO

and

.GOSUB

directives.

for
The VAX/VMS MCR command interpreter establishes a new label table
each 1level of indirect command file. When a nested level exits, the
level.
the next higher
for
current table is emptied to free space
labels defined in an indirect command file must be unique
Therefore,
within

that

file.

Labels passed over as a result of a .GOTO or .GOSUB directive are
not
placed
in
the
1label
table.
The
label table contains only labels
encountered

5.9

in the actual execution stream.

SYS$INPUT AND SYS$SCOMMAND

input:
command
for
files
two process-permanent
VAX/VMS maintains
SYSSINPUT is the prime source of command
SYSSINPUT and SYSSCOMMAND.
user's
the
1is
SYSSINPUT
That is, for an interactive user,
input.
for indirect command file execution, SYSSINPUT is the file
terminal;
SYSSCOMMAND is a secondary input source during
of commands and data.
It remains assigned to the
command file.
indirect
an
execution of
initiating terminal.
You can interrupt the processing of an
indirect
command
file,
issue
a
set of commands by means of SYSSCOMMAND,
continue the indirect command file without altering its SYSSINPUT.

and

INDIRECT COMMAND

All

the

MCR

commands

described

for SYSSINPUT and SYSSOUTPUT.
RSX-11M commands such as PIP,

FILES

Chapter

have

separate

streams

However, to be compatible with RSX-11M,
EDI, TKB, and any other commands invoked
by
typing
their
image
file
name
have
SYS$INPUT
assigned
to
SYS$SCOMMAND.
That is, attempts to read from TI
(SYS$SINPUT)
actually
result
in
reading
from
SYSSCOMMAND.
This
assignment
allows the
indirect command file to obtain information (for example, edits)
from
the terminal, as is often done under RSX-11M.
For

cases

is,

when

you

can

command

in which

the

it expects

use

the Run

file.

For

executing

read

command

example:

image

records

read

from the

request

the

from SYSSINPUT

indirect command
image

the

(that

file),

indirect

RUN SYS$SYSTEM:PIP

5.10

.ASKN DIRECTIVE

When VAX/VMS executes an .ASKN
directive,
it
displays
the
default
radix of the value after the text string that requests the value.
The
default radix is displayed as
[0]
(octal),
([D]
(decimal),
or
[H]
(hexadecimal).
Similarly,
the
response
can
be octal, decimal, or
hexadecimal.
To override the default,
vyou
can
follow
the
RSX-11M
conventions
(a
leading pound sign forces octal and a trailing ‘period
forces decimal), or you can specify a VAX/VMS radix
operator
in
the
format %rn.
No operator is required to specify a value in the default
radix.
The response to the request for a symbol value can be a symbol name or
an
expression.
If
hexadecimal is the default radix and you want to
enter a hexadecimal value that starts with A through F, you must enter

a
leading
hexadecimal

zero
value

or
wuse
the
from a symbol

5.11

(ENABLE DOLLARS

Under

RSX-11M,

MCR

and directives.

radix
name.

operator

distinguish

the

DIRECTIVE

indirect

Under

command

VAX/VMS,

MCR

commands, directives, and data.
can
contain the command to run
that program.

files

can

indirect

contain

command

only

files

commands

can contain

For example, an indirect command file
a program followed by the data read by

The .ENABLE DOLLARS directive indicates to
the
VAX/VMS
MCR
command
interpreter that the indirect command file is to take advantage of the
command
interpreter's
capability
to
distinguish
commands
and

directives
the

two

from
by

data.

checking

The
for

command

interpreter

dollar

signs

($).

distinguishes
Once

recognition
1is
enabled,
you must precede all subsequent
directive lines with a dollar sign, for example, S$RUN.
The

MCR

prevent

indirect
unread

command
user

interpreter
programs

command
after

the

file
user

also

from

and

program

uses

reading

bypass

the

dollar

past

any

terminates.

the

data
That

sign
end

sign

command

convention
of

records
is,

between

dollar

data

and

to
the

that

remain

user

program

does not read all its data, the command interpreter can throw out
the
remaining
data
records
and
start
processing
the
next command or
directive.

INDIRECT COMMAND FILES

The following is an example of a VAX/VMS

MCR

indirect

command

file

containing data.

.ENABLE DOLLARS

STIM
SRUN MYPROG
data to be read by MYPROG

STIM
.DISABLE DOLLARS

By default, dollar sign recognition is disabled at the beginning of an
indirect command file level.

5.12

.PAUSE DIRECTIVE

The .PAUSE directive functions the same way under VAX/VMS as it does
under RSX-11M. That 1is, once the pause starts, you can run other
images and utilities in your process. While in a pause condition, the
process's SYSSINPUT 1is equated to SYSSCOMMAND so that any images run
during the pause can read input from the terminal. To continue from
the pause,

type the Continue command.

If you interrupt image execution using CTRL/Y or CTRL/C during a pause
and then issue a Continue command, the pause is terminated. When the
If you issue a Stop
image exits, the indirect command file resumes.
closes the
interpreter
command
the
image,
the
command to terminate
indirect command file and returns to interactive command level in
addition to terminating the image.

5.13

.DELAY DIRECTIVE

Under VAX/VMS, you can use the .DELAY directive to delay indirect
command file processing for a number of ticks, seconds, or minutes;
you cannot specify a delay of a number of hours. To wait for an hour
or more, specify an equivalent number of minutes, as follows.
.DELAY

90M

This directive above causes a delay of 1 hour and 30 minutes.

If you type a Continue command,
Pressing CTRL/Y interrupts a delay.
A Stop command terminates
indirect command file processing resumes.
indirect command file processing.

5.14

NESTING MCR INDIRECT COMMAND FILES

The VAX/VMS MCR command interpreter allows the nesting of four
indirect command files each having eight subroutines. As the number
allowed
files
the number of nested
of subroutines decreases,
increases,

The number

and vice versa.

nested

indirect

command

files

allowed

RSX-11M

running under VAX/VMS (for example, TKB) is controlled by
components
individual components, and is the same as under RSX-11M.

5-11

INDIRECT COMMAND

5.15

LEXICAL

FUNCTIONS

VAX/VMS provides
about
character
can

use

lexical

parameters,

lexical

FILES

set of
strings
functions

for

lexical functions
and attributes of
in

example,

functions.

MCR directives
.SETN

and

Table
Summary

that
return
information
the current process.
You

that

.SETS.

5-3

expressions

summarizes

the

5-3

Lexical

Functions

Function

'FSDIRECTORY ()

Table

Value Returned

Current default directory
name

'FSEXTRACT (position,length,string)

Substring beginning in
specified position for
length specified of
indicated

string

'FSLENGTH (string)

Length

specified

'FSLOCATE (substring,string)

Starting position of

string

specified substring within
string indicated;
or, the
length of the string if the
substring is not found

'FSLOGICAL (logical-name)

Equivalence

name of
specified logical name
(first match found in

ordered
group,

search
and

name

tables);

name

system

process,
logical

or, logical
match is found

'FSMESSAGE (message-code)

Message string associated
with a system status value

'FSMODE ()

INTERACTIVE or BATCH

'FSPROCESS ()

Current process name

'FSTIME ()

Current date

and

'FSUSER()

Current

identification

'FSVERIFY ()

user

code

(UIC)

TRUE

(that

is,

time

day

a numeric

value of 1) if verification
is set on;
FALSE (that is,
a numeric value of 0) if

verification

The VAX/VMS
explanation
syntax

Command Language User's
of lexical functions;

rules.

set

Guide
provides
a
more
the following paragraphs

off

detailed
summarize

INDIRECT COMMAND FILES

The general format of a lexical function is:
'FSfunction=name([args,...])

that

name

follows.

returned.

All

function

Indicates

function-name

Specifies the function to be

(')

substitution operator

is required.

The

function

You can truncate function names to

names are keywords.

any unique truncation.

The parentheses
Encloses function arguments, if any.
required for all functions including those that do
are

()

not

Specify

ArgsS, ...

arguments.

the

arguments

for

the

function.

can

You

specify arguments using symbol names, numeric literals,
or string literals enclosed in quotation marks.

for
arguments
as
specified
be
cannot
Functions
arguments
as
specified
strings
Literal
functions.
cannot contain embedded symbols.

Section 5.17.2 contains an example of the use of lexical functions.
wuse
for
intended
In the MCR command language, lexical functions are
If they are used in .IF directives,
.SETx directives.
with the
results may not be
as
expected.
To make
full
use of
1lexical
functions,

5.16

you should use DCL rather than MCR.

OPERATIONAL NOTES

The notes below describe operational aspects of indirect command

file

processing under VAX/VMS.

indirect
As in RSX-11lM, all data files are closed when an
command file terminates and returns to the interactive command
level, that is, when MCR prompts for the next command.

interactive
When a command file terminates and returns to the
the global
«clears
interpreter
command
the
level,
command
symbol

table.

are
directives
When lowercase is enabled, responses to .ASKS
that is, the command interpreter
quoted strings;
as
treated
As a result, embedded multiple
does not change what is typed.
tabs or spaces are not compressed.

Under VAX/VMS, you

cannot

press

CTRL/Z

response

the
terminate
to
.ASK)
example,
(for
input
for
request
type CTRL/Y or
however,
You can,
indirect command file.
indirect command file at any point
the
terminate
to
CTRL/C
during processing.

5-13

INDIRECT COMMAND FILES

5.17

RSX-11lM AND RSX-11S SYSTEM GENERATION

VAX/VMS

host

uses

the MCR

system

for

indirect

RSX-1l1lM

command

and

file

RSX-1l1lS

capability

serve

system generation.

The

system generation proceeds as it does under RSX-11M;
however,
must be taken in preparation for a system generation:

few

the

steps

You

must have

the

Change

Mode

Kernel

version

the

privilege,

the

actual

target disk volume must be unprotected.
Change Mode to Kernel
privilege is
required
to
perform
a
SET/UIC
command
that
changes
both
the
default directory and UIC.
Section 5.17.1
describes the creation of an unprotected disk volume.
Because

the

VAX/VMS

RSX-11M

task

builder

produces
image
files
with
a file type of EXE, you must use
RSX-11M's own version of its task builder from a mapped system
to
obtain
files with a type of TSK.
It must be in directory
[1,54].

You must assign equivalence names
for
RSX-11lM
device
names
contained
in the system generation indirect command files and
for TKB and SRD.
Section 5.17.2 provides an indirect
command

file
that
can
assignments.

5.17.1
To

run

make

the necessary

logical

name

Creation of an Unprotected Disk

create

totally

unprotected

disk

volume,

use

the

following

steps:

Initialize the disk volume specifying
read,
write,
execute,
and delete privileges for system, owner, group, and world.
Create on that volume
by
UFD
commands
in

file.
in all

Specify read
directories.

Change

the

and write

protection

read/write
access
following command.
SET

5.17.2
Figure

PROTECTION

5-1

lists

the

This

for

the

all

access

master

for

file

directory

user

created
command
categories

allow

issuing

the

([0,0]000000.DIR;1/PROTECTION=(S:RW,0:RW,G:RW,W:RW)

Pre-System Generation

assignments.

all of the directories normally
the
system generation indirect

command

directives, and also takes
capabilities
and
1lexical
5.15, respectively.

Indirect

file

Command

required

File

make

logical

contains standard MCR commands

advantage
of
VAX/VMS
parameter
functions as described in Sections

name

and

passing
4.15 and

INDIRECT COMMAND FILES

.ENABLE SUBSTITUTION
.1IF

Pl EQ ""

Equates Pl to target device

.ASKS Pl TARGET DEVICE NAME

name

.SETS COLON ":"
.SETN L1 'FSLOCATE (COLON,P1) '

typed by user

Sets L1 equal to the
location of the colon(:),
if any, if string Pl.
Otherwise sets L1 equal to
length of Pl.

.IF L1 EQ 'FSLENGTH(Pl)' .SETS Pl "'P1l''COLON'" ! If Pl does not

ASN
ASN
ASN
ASN
ASN
ASN

ASN

DEFAULT 'Pl
'P1'=SY:
'P1'=SY0:
'Pl'=LB:
'P1'=LBO:
MP:=MPO0:
'P1'[1,54]BIGTKB.TSK=TKB
'P1'[1,54]SRD.TSK=5SRD

Figure

5-1

SET

SHOW SYMBOL Pl

Oum

contain a terminating
colon, sets Pl
equal to target dev:

Sets default to target disk
Assigns SY, SY0, LB, LBO to
target disk

Equates MP0O and MP
Assigns equivalence names
for TKB and SRD

Pre-System Generation Indirect Command File

Image files produced by the task builder referred to in this
command file have a file type of TSK rather than EXE.

indirect

APPENDIX

PRIVILEGES

The following is a list of the privileges defined by VAX/VMS.
for

ACNT

Allow process to suppress accounting messages

ALLSPOOL

Allow process to allocate spooled devices

ALTPRI

Allow process to set priority values

BUGCHK

Allow process to make bug check error log entries

CMEXEC

Allow process to change mode to executive

CMKRNL

Allow process to change mode to kernel and

created processes

change

UICs

DETACH

Allow process to create detached processes

DIAGNOSE

Allow process to issue diagnostic I/O requests

EXQUOTA

Allow process

GROUP

Allow process to control other
same

to exceed

resource gquota

GRPNAM

Allow process to place names in the group

LOG_IO

Allow process to issue logical I/O requests

name

the

processes

group

logical

table

device

Queue

I/0

Request

MOUNT

Allow a process to execute

NETMBX

Allow process to create a network device

OPER

Allow process to have operator privileges

PHY_IO

Allow process to issue physical I/0 requests to

system service to mount a device

device

PRMCEB

Allow process to
flag

create

permanent

common

event

clusters

PRMGBL

Allow process to create permanent global sections

PRMMBX

Allow process to create permanent mailboxes

PSWAPM

Allow process to alter

its swap mode

PRIVILEGES

SETPRV

Allow process

set

SYSGBL

Allow process

create

SYSNAM

Allow process
name table

place

TMPMBX

Allow process

Create

VOLPRO

Allow process

override

WORLD

Allow process
the system

control

other

process's

privileges

system global

names

the

sections

system logical

temporary mailboxes

volume protection
all

other

processes

APPENDIX

RESOURCE QUOTAS AND LIMITS

The following is a list of the resource quotas and limits
VAX/VMS.
ASTLM

AST

limit

quota

BIOLM

Buffered I/0

limit

BYTLM

Buffer

quota

CPULM

CPU

DIOLM

Direct

FILLM

Open

PGFLQUOTA

Paging

PRCLM

Subprocess

TQELM

Timer

WSDEFAULT

Default working

WSQUOTA

Working

space

time

limit

I/0

file

limit
quota

file

queue

set

quota
quota

entry quota

set

size

size quota

defined

INDEX

Commands
Set

Allocate Device command,
Allocating devices, 3-2
<ALPHAN>,

4-1

5-8

Append command, 4-3
.ASKN directive, 5-10
Assign command, 4-6

(Cont.),

Control

Set Magtape,

4-84

Set

On,

Set

Process,

4-85

Set

Queue,

command,

utility),

1-3

Default,

4-93
Set,

command,

4-9

CL, 2-12
co, 2-12
Command interpreter,
selecting a, 3-2
Commands,
Allocate Device, 4-1
Append, 4-3
Assign, 4-6
Bye,

4-96

Show Devices,

4-97
4-98

Show Logical,

4-99

Show Magtape,

4-100

Show Network,

4-101

Show Printer,

4-102

Show Process,

4-103
Protection, 4-104

Show

Show Queue,

4-8

Cancel,

4-95

Show Daytime,
Show Default,

Cancel

4-89

4-90

4-92

Set Verify,
Set Working
Show,

4-8

4-87

4-88

Terminal,

Set /UIC,

Bye

4-86

Set Protection,

Set

(bad block

4-82

4-83

Set RMS

BAD

Set Default,

4-105

Show

RMS

Default,

Show

Status,

Show

Symbols,

Show

System,

4-108
4-109

Show Terminal,

4-9

4-110

Commenting lines, 2-16
Continuation of command
lines, 2-15
Continue, 4-11
Copy., 4-12

Show Translation,
Show Working Set,
Stop, 4-113
Submit, 4-115

Deallocate,

Time,

4-118

Type,

4-119

Summary of,

4-16

Debug,

4-17
Delete, 4-18
Deposit, 4-21
Directory, 4-24
Dismount, 4-27
Examine, 4-29
Execute procedure
Exit, 4-34
Initialize, 4-36
Keyword

Mount,

(@),

Control

Set,
Set

4-60

4-59

4-68

4-79
Reader,

4-81

2-7

D
Dates,

Debug

4-62

4-69
Card

directory),

specifications of,

severity-level,

Run,

1-8

Controller designation,
Copy command, 4-12

Deallocate

Purge,

4-32

2-17

4-49

On statement,
Print, 4-64

file

Continue command, 4-11
Control keys, 2-13 - 2-15

4-50
4-51
Y,

(user

1-4

4-111
4-112

4-120

placement,

Link, 4-43
Login procedure,
Logout,

UFD

4-106

4-107

command,

2-18
4-16

4-17

<DEFAULT>, 5-8
Default file types, 2-9
Defaults in file specifications, 2-8
.DELAY directive, 5-11
Delete command, 4-18
Deposit command, 4-21

Index~1

INDEX

(Cont.)

Device mapping, 2-12, 2-13
Device

names,

generic,

3-3

2-6

Devices,
allocation of,

.IFACT

3-2

Devices supported,

2-7

Directives,

directive,

5-6

.IFINS directive,
.IFLOA directive +

5-6
5-6

definition of,

processor directive,

5-2

Directives (MCR),
summary of, 5-2

noncontiguous,

.DISABLE directive, 5-6
5-10

I ?Z?tibes' -7

pitia.lze command,

Installing

Disk,

(file dump utility),

1-3

1-2

Label table entries,

.ENABLE

DOLLARS directive,
5-10
.ENABLE directive, 5-6

LBR

(RSX-11lM Librarian),

1-2

alternative

4-29

alternative

(@),

4-32

4-34

3-5
assignment

services),

Files-11,

1-3

2-8,

Logout

3-3

RSX-11M

! 2-11

command,

4-50

M
MACRO-11 (MAC),
<MAPPED>, 5-8
<MEMSIZ>,

names,

for

(file transfer utility),
1-3
use under VAX/VMS, 3-9

device

to Redirect,

2-9

FLX

Generic

Reassign,

2-9

Files-11 Structure Levels
and 2, 2-7
File types,
defaults,

group, 2-10
process,
2-10
system,

2-5

for,

Install,

LOG%N.CMé file, 3-2

ipe01flc?tlon of, 2_é7
specifications under

defaults

images, 3-4

VAX/VMS,

3-4

alternative

File protection, 2-4
File

5-12
B-1

3-5

control

1-4

quotas,

command, 4-43
Logging into VAX/VMS, 3-1
Logical names, 2-10, 3-4

2-20

procedure

(file

functions,
and

Link

F
FCS

5-9

2-12

Limits

Exit command,

images,

LB,

Lexical

Execute

RSX-11M

4-36

Error messages,

5-1

3-5

creation of unprotected,
5-14
Dismount command, 4-27

<ESCAPE>, 5-8
Examine command,

3-12

Indirect command files,
execution of, 3-10
nesting of, 5-11

5-6

.DISABLE DOLLARS directive,

EDI,

2-1

Image files,

Images{
running of, 3-6

Directory command, 4-24
Directory names, 2-7

DMP

)

Image,

MCR indirect command file

unsupported,

)

1-2

5-8

Mount command, 4-51
Mounting volumes, 3-3

Noncontiguous
3-12

Index-2

image

files,

INDEX

(Cont.)

5-8

RSX-11M images,

RSX-11M program development
utilities available
under VAX/VMS, 1-2, 1-3

Numerie symbols,

requirements for execution,

ODT.OBJ, 1-3
On Control Y, 4-60
.ONERR directive, 5-7
On severity level, 4-62
On statement, 4-59

RSX-11M/S system generation,
5-14

Run command,

4-69

Running an image (native or
RSX-11M),

2-12

ov,

1-2

1-1,

3-2

P
Password,

3-1

(file patch utility),

PAT

1-3

5-11

.PAUSE directive,

PIP,

1-3

Print command,
Priority,

4-64

2-5

Privileges,

Set Queue,

Process identification,
2-2

Process protection,
Protection,

2-3,

2-4

2-2

2-3, 2-4

file, 2-4
password, 3-1
process, 2-4

Q
Quotas and limits, B-1l

Radix indicator,
<RAD50>, 5-8
1-4

RMS-11 utilities,

5-9

1-3

RSXMAC.MLB, 1-3
RSX-11M components,

use of under VAX/VMS, 3-7
RSX-11M files available
under VAX/VMS,
ODT.OBJ, 1-3
RSXMAC.MLB, 1-3
SYSLIB.OLB, 1-3

4-86

4-88

4-87

Set RMS Default, 4-89
Set Terminal, 4-90
Set /UIC, 4-92
Set Verify, 4-93

Set Working Set,

Show commands,
Show,

4-95

Show Daytime,

setting of, 4-87
Purge command, 4-60

RMS-11,

4-85

Set Protection,

detached, 2-2
login, 2-2
Versus task, 2-1

Process name,

3-2

Set Process,

2-1

definition of,

preter,

Set commands, 4-79
Set Card Reader, 4-81
Set Control Y, 4-82
Set Default, 4-83
Set Magtape, 4-84
Set On,

2-4, A-1l

Process,

Selecting a command inter-

4-95

4-96

Show Default, 4-97
Show Devices, 4-98
Show Logical, 4-99
Show Magtape, 4-100
Show Network, 4-101
Show Printer, 4-102
Show Process, 4-103
Show Protection, 4-104
Show Queue, 4-105
Show RMS Default, 4-106
Show Status, 4-107
Show Symbols, 4-108
Show System, 4-109
Show Terminal, 4-110

Show Translation, 4-111
Show Working Set, 4-112

SLLP

(source language input

SP,

2-12

program), 1-3

Special symbols, 5-8
Stop command, 4-113

<STRLEN>,

5-8

Subdirectories, 2-7
Submit command, 4-115

Index-3

INDEX

Subprocess,

sy,

(Cont.)

2-2

2-12

<SYDISK>, 5-8
Symbols, 5-7

UFD command,

numeric,

Unit numbers,

5-8
special, 5-8
summary of, 5-8
Syntax rules, 2-15
SYSLIB.OLB, 1-3

Unsupported
User

User

3-1
identification code

name,

3-1

'}
VAX/VMS

componen

use of from MC
Version numbers, 2-8
VFY1l (Files-11 Structure

2-11

5-8

Level

verification

utility),

Task,

Volumes,

1 -3

mountin

2-1

Terminal characteristics,
summary of, 4-91
Terminal functions, 2-13

w
-

2-15
T,

.WAIT directive,
2-12

2-12

Time command, 4-118
Times (absolute and delta),
specification of, 2-18,
2-19
TKB (RSX~11M Task Builder),
1-2
image

X
.XQT directive,

command,

4-119

5-7

files,

3-12
options, 3-12
switches, 3-11
Type

5-7

WK,

noncontiguous

5-6

file,

(u1C),

5-14

SYSS$SSYSTEM,

authorization

group number, 2-3
member number, 2-3

<SYSUIC>, 5-8
SYS$SCOMMAND, 2-11, 5-9
SYSSDISK, 2-11
SYSSERROR, 2-11
SYSSINPUT, 2-11, 5-9
SYSSLIBRARY, 2-11
SYssouTpuUuT, 2-11
<SYUNIT>,

2-7

directives,

2-3,

User

System generation,
Pre~generation indirect
command file, 5-14

RSX-11M/S,

4-120

Z
ZAP utility,

Index-4

1-3

VAX-11/RSX-11M
User's Guide
AA-D037A-TE

READER'S COMMENTS

NOTE:

DIGITAL will
This form is for document comments only.
use comments submitted on this form at the company's
If you require a written reply and are
discretion.
eligible to receive one under Software Performance
Report (SPR) service, submit your comments on an SPR
form.

Did you find this manual understandable, usable, and well-organized?

Please make suggestions for improvement.

Did you find errors in this manual?

If so, specify the error and the

page number.

Please indicate the type of reader that you most nearly represent.

Loood

E] Assembly language programmer
Higher-level language programmer

Occasional programmer (experienced)

User with little programming experience
Student programmer

Other

(please specify)

Date

Name
Organization
Street

City.

State

Zip Code
or

Country

—

DoNot
Fold
TearHere and Tape —

—

dlilgliltiall

_——

Necessary

United States

POSTAGE WILL BE PAID BY ADDRESSEE

RT/C SOFTWARE PUBLICATIONS

TW/A14

DIGITAL EQUIPMENT CORPORATION
1925 ANDOVER STREET
TEWKSBURY, MASSACHUSETTS

Do Not Tear - Fold Here

if Mailed in the

FIRST CLASS PERMIT NO.33 MAYNARD MASS.

No Postage

BUSINESS REPLY MAIL

—_

01876