Digital PDFs

AA-H235A-TC

June 1979

38 pages

Original

1.4MB

Document:	RMS-11 Installation Guide
Order Number:	AA-H235A-TC
Revision:	0
Pages:	38
Original Filename:	http://bitsavers.org/pdf/dec/pdp11/rsx11m_s/RSX11M_V3.2_Jun79/5B_FileMgmt_IO/AA-H235A-TC_RMS-11_V1.8_Installation_Guide_197906.pdf

OCR Text

June 1979

This guide describes the procedures for installing RMS-11 and RMS-11 K V1 .8
on PDP-11 and VAX-11 computers.

RMS-11 Installation Guide
Order No. AA-H235A-TC

SOFTWARE VERSION:

RMS-11 V1 .8
RMS-11 K V1 .8

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

digit.al equipment corporation · maynard, massachusetts

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-paid 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 Digital Equipment Corporation:
DEC
DECnet
DECsystem-10
DECSYSTEM-20
DECtape
DECUS
DIBOL
DIGITAL

FOCAL
IAS
MAS SB US
PDP
RSX
RSTS
UNIBUS
VAX
VMS

Contents
Page

Cha1pter 1 Introduction
1.1

System Requirements
Software. . .
Configuration
Disk Storage Requirements .

. 1-2
. 1-2
. 1-2

Installation Medium Contents
Documentation Conventions . . . .
After Installation . . . . . . . . .
Undocumented Features and Restrictions .

. 1-2
. 1-4
. 1-4
. 1-6

1.1.l
1.1.2
1.1.3
1.2
1.3
1.4
1.5

. 1-2

Chapter 2 Installing RMS-11 (K) on an IAS System
2.1

Preparation . . . . . . . . . . . . . . . .
2.1.l
2.1.2
2.1.3
2.1.4
2.1.fi

2.2

Installing COBOL and RMS-ll(K) .
Effect on SYSLIB . . . . . . . . .
RMS-ll(K) Resident Libraries . . .
Modifying the RMS-ll(K) Prototype ODL File
Increase in Task Size.

Instructions . . . . . . . . . . . . . . . . .

. 2-1
. 2-2
. 2-2
. 2-2
. 2-3
. 2-3
. 2-3

Chapter 3 Installing RMS-11 K on a RSTS/E System
3.1

Preparation . . . . . . . . . . . . .

. 3-1

Effect on SYSLIB . . . . . .
RMS-llK Resident Libraries.
Increase in Task Size.

. 3-2
. 3-2
. 3-3

Instructions . . . . . . . . . . . . .

. 3-3

3.1.1
3.1.2
3.1.3
3.2

Cha1:>ter 4 Installing RMS-11 (K) on an RSX-11 M or RSX-11 M-PLUS System
4.1

Preparation . . . . . . . . . . . . . . . .

. 4-1

Installing COBOL and RMS-ll(K) .
Effect on SYSLIB . . . . . . . . .
RMS-11 (K) Resident Libraries . . .
Modifying the RMS-ll(K) Prototype ODL File
Increase in Task Size.

. 4-2
. 4-2
. 4-2
. 4-2
. 4-3

4.2

Instructions . . . . . . . . . . . . . . . . . . . . .

. 4-3

1-1

RMS-ll(K) Installation Medium Contents . . . . . . . . . . . . . . . 1-2

4.1.1
4.1.2
4.1.3
4.1.4
4.1.5

Table

!commercial Engineering Publications typeset this manual using DIGITAL's
l_rMS-11 Text Management System.
2000ALL

Chapter 1
Introduction
This document is a guide to the installation of the RMS-11 (K) software on
the following operating systems:
IAS
RSTS/E
RSX--llM
RSX-llM-PLUS

NOTE TO VAX USERS
Install RMS-llK as you do all software optional to the VAXNMS system.
See the VAX-11 Software Installation Guide about installing optional
software.
However, you should also read Section 1.5 and Sections 4.1.1 through
4.1.5.
On IAS and RSX-llM systems, two RMS-11 installation kits are available:
Kit

Software Contents

RMS-11

Object library, utilities, and Resident Library that support the Sequential
and Relative file organizations

RMS-HK

Object library, utilities, and Resident Libraries that support the Sequential,
Relative, and Indexed file organizations

The installation procedure is identical for both kits; therefore, this guide
serves both.

NOTE
If you have both kits (RMS-11 and RMS-llK), install only the
RMS-llK software.

On RSTS/E and RSX-llM-PLUS systems, only the RMS-llK kit is available.
This guide complements the system generation procedures for the operating
systems. Your system generation manual tells you when to install optional
software: at that time, use this guide and the RMS-ll(K) medium.

1-1

1.1

System Requirements
1.1.1 Software
Each system-specific chapter lists the system software components required
to install RMS-11 (K).

1.1.2 Configuration
To install RMS-11, you should have the minimum hardware configuration
specified in your operating system's Software Product Description.
To install RMS-llK, you should have the minimum hardware configuration
specified in your Software Product Description for RMS- llK.

1.1.3 Disk Storage Requirements
You should have at least 2450 blocks available on your system and library
devices for use by the installation command file. For further breakdown of
storage requirements (file sizes), see Table 1-1.

1.2 Installation Medium Contents
Each RMS-ll(K) installation medium contains the files shown in Table 1-1.

Table 1-1: RMS-ll(K) Installation Medium Contents
(* = RMS-HK only)

File Name

Approx.
Size
(blocks)

BCKBLD.CMD
CNVBLD.CMD
DEFBLD.CMD
DFNBLD.CMD
DSPBLD.CMD
IFLBLD.CMD*
MAKRMSODL.CMD
RMSll.CMD
RMSRTS.CMD
RMSRES.CMD*
RMSSEQ.CMD
RSTBLD.CMD
RMSll.CTL
RMS RES.LIB*
RMSSEQ.LIB
RMSBCK.MAP
RMSCNV.MAP
RMSDEF.MAP
RMSDFN.MAP
RMSDSP.MAP

1
1
1
1
1
1
90
13
1
2
1
1
13
19
19
180
182
123
143
154

IAS

Destination
Account Number
RSTS/E

SY:[ll,31
SY:[ll,3J
SY:[ll,3J
SY:[ll,3J
SY:[ll,3J
SY:[ll,3J
LB:[l,lJ
SY:[200,200J

on medium
on medium
on medium
on medium
on medium
on medium

NIA

NIA
NIA
NIA

LB:
on medium
on medium
on medium
on medium
SY:[O,ll
SY:[O,lJ

on medium
on medium
on medium
on medium
on medium

NIA
NIA
NIA
NIA
NIA

SY:[ll,3]
SY:[ll,3J
SY:[ll,31

NIA
NIA

RSX-llM
SY:[l,241
SY:[l,241
SY:[l,241
SY:[l,241
SY:[l,241
SY:[l,241
LB:[l,lJ
LB: [200,200]

NIA
SY:[l,24]
SY:[l,241
LB:[l,241

NIA
NIA
NIA
on medium
on medium
on medium
on medium
on medium
(Continued on next page)

1-2

Introduction

Table 1-1: RMS-ll(K) Installation Medium Contents (Cont.)
(* = RMS-llK only)

File Name

RMSIFL.MAP*
RMSRES.MAP*
RMSRST.MAP
RMS SEQ.MAP
RMSMAC.MLB
RMSFUN.OBJ
BCKBLD.ODL
CNVBLD.ODL
DEFBLD.ODL
DFNBLD.ODL
DSPBLD.ODL
IFLBLD.ODL*
IFLIAS.ODL*
IFLRST.ODL*
IFLRSX.ODL*
RMSll.ODL
RMSllS.ODL
RMS11X.ODL*
RMS12R.ODL
RMS1.2X.ODL*
RMSCNV.ODL
RMSODL.ODL
RMSRES.ODL*
RMSRLS.ODL
RMSRLX.ODL *
RMSRTS.ODL
RMSRTX.ODL
RMSSEQ.ODL
RMSUTL.ODL
RTSBLD.ODL
RSTBLD.ODL
RMSIFL.OLB*
RMSLIB.OLB
RMSll .RTS
RMSUTL.OLB
RMSll .STB
RMSRES.STB*
RMSSEQ.STB
RMSll.TSK
RMSBCK.TSK
RMSCNV.TSK
RMSDEF.TSK
RMSDFN.TSK
RMSDSP.TSK
RMSIFL. TSK *
RMSRES.TSK*
RMSRST.TSK
RMSSEQ.TSK

Approx.
Size
(blocks)

127
80
208
13
177
8
8
9
2
2
2
6
40
40
40
63
7
10

19
10

23
24
11

1
1
38
38
3
4
10

1
281
212
515
19
3
23
9
18
172
222
204
139
156
198
95
188
16

IAS

Destination
Account Number
RSTS/E

RSX-llM

on medium
on medium
on medium
on medium

NIA
NIA
NIA
NIA

on medium
on medium
on medium
on medium

LB:[l,lJ
LB:[l,lJ
SY:[ll,3J
SY:[ll,3J
SY:[ll,31
SY:[ll,3J
SY:[ll,31
SY:[ll,31
SY:[ll,31

LB:
on medium
on medium
on medium
on medium
on medium
on medium
on medium

LB:[l,lJ
LB:[l,lJ
SY:[l,201
SY:[l,201
SY:[l,201
SY:[l,201
SY:[l,201
SY:[l,201

NIA
NIA

on medium

LB:[l,lJ
LB:[l,lJ
LB:[l,ll
LB:[l,ll
LB:[l,ll
SY:[ll,31
SY:[ll,31
SY:[ll,31
LB:[l,ll
LB:[l,ll

LB:
LB:
LB:
LB:
LB:

NIA
NIA

on medium
on medium
on medium

NIA
NIA

LB:
LB:
LB:
LB:

SY:[ll,31
SY:[ll,31
SY:[ll,31

on medium
on medium
on medium

NIA
NIA
SY:[l,201
LB:[l,lJ
LB:[l,lJ
LB:[l,lJ
LB: [l, lJ
LB:[l,lJ
LB:[l,20]
LB:[l,20]
SY:[l,241
LB: [1, ll
LB:[l,lJ

NIA
NIA
SY:[l,241
LB:[l,20]
LB:[l,201

NIA

LB:

NIA

SY:[ll,31
LB:[l,ll
SY:[ll,3J

on medium

SY:[l,201
LB: [l, 1J
SY:[l,201

NIA
NIA

SY:[O,lJ
LB:
LB:
LB:
LB:
SY:[l,21
SY:[l,21
SY:[l,21
SY:[l,21
SY:[l,21
SY:[l,21
LB:
SY:[l,21
LB:

LB:[l,lJ
LB:[l,lJ

NIA
LB:[ll,ll
LB:[ll,lJ
LB:[ll,ll
LB:[ll,ll
LB:[ll,ll
LB:[ll,ll
LB:[l,ll
LB:[ll,ll
LB:[l,ll

LB:
on medium

NIA
NIA
LB:[l,lJ
LB: [1, ll

NIA
LB:[l,541
LB:[l,541
LB:[l,54]
LB:[l,54]
LB:[l,541
LB:[l,541
LB:[l,ll
LB:[l,541
LB: [1,lJ

Introduction

1-3

1.3 Documentation Conventions
Symbol or Term

Represents

RMS-U(K)

Description applies to both RMS-U and
RMS-UK installations.

Current RMS-U(K) users

Indicates those systems that have a version of
RMS-U(K) already installed

New RMS-U(K) users

Indicates those systems that have no version
of RMS-U(K) already installed

(CTRL/c)

Simultaneously press the CTRL key and
another key.
Examples

(CTRL/z), (CTRL/c)

(8D)

Press the RETURN key.

(ill

Press the LINE FEED key.

Red

Where the instructions contain your input
and system output, you type the characters
in RED; the software prints the characters in
BLACK.

1.4 After Installation
The installation process:
• on IAS, RSX-UM, and RSX-UM-PLUS systems, gives you the option of
copying the following files to your system disk. You may reject this option if
you need the disk space for more immediate projects--as long as you retain a
copy of the installation medium.
• on RSTS/E systems, leaves the following files on the installation medium.
You need these files to patch and rebuild the RMS-U(K) utilities and
Resident Libraries.
BCKBLD.CMD
CNVBLD.CMD
DEFBLD.CMD
DFNBLD.CMD
DSPBLD.CMD
IFLBLD.CMD (RMS-llK only)
RSTBLD.CMD
RMSUTL.ODL
RMSCNV.ODL
IFLRST.ODL (RMS-llK only)
RMSUTL.OLB
RMSRES.CMD (RMS-llK only)
RMSSEQ.CMD
RMSFUN.OBJ

1-4

Introduction

BCKBLD.ODL
CNVBLD.ODL
DEFBLD.ODL
DFNBLD.ODL
DSPBLD.ODL
IFLBLD.ODL (RMS-llK only)
RSTBLD.ODL
RMSODL.ODL
IFLIAS.ODL (RMS-llK only)
IFLRSX.ODI, (RMS-llK only)
RMSIFL.OLB (RMS-llK only)
RMSRES.ODL (RMS-llK only)
RMSSEQ.ODL

When you are advised that a patch is necessary, you should follow these
instructions:
1.

Perform the patch procedure.

Rebuild tasks as follows:
If you patched RMSUTL.OLB, you changed one or more modules in the
RMS-ll(K) utilities. The patch instructions tell you which one. You must
now rebuild that utility with the following command: TKB @utlBLD

where
utl is the three-character mnemonic for the utility.
Example To build the RMSBCK utility, you type the command:

TKB @BCKBLD

• If you patched RMSLIB.OLB, you changed one or more modules in the
RMS-ll(K) routines built into the RMS-ll(K) utilities, your tasks,
and the RMS-ll(K) Resident Libraries. To benefit from this patch, you
must rebuild those tasks:

You rebuild the utilities as described in the preceding paragraph.
You should rebuild all utilities installed on your system.

You rebuild each of your tasks by supplying the Task Builder with
the appropriate command file.

You rebuild the RMS-ll(K) Resident Libraries with the following
commands:
For RMSSEQ:
TKB @RMSSEQ
For RMSRES (RMS·-llK only):
TKB @RMSRES

• If you patched RMSIFL.OLB (RMS-llK only), you changed one or
more modules in the RMSIFL utility. You must now rebuild that utility
with the following command:

TKB @IFLBLD

Introduction

1-5

1.5 Undocumented Features and Restrictions
• Add the following note to the RMS-11 User's Guide, Section 9.5.2.

NOTE
Any records containing duplicate key values can lose their
input order. This note applies to:
• duplicate Primary Keys where RMSIFL sorts the input
file
• all duplicate Alternate Keys
RMS-11 routines maintain a first-in, first-out (FIFO) ordering of records containing duplicate key values. When
RMSIFL sorts records, this order can change unpredictably,
depending on how the records occur in the sort work files
when the work files are merged.
• Delete the following block of text from page 9-62 of the RMS-11 User's
Guide:
• The output file must not have a bucket size greater than five blocks.
Otherwise, RMSIFL prints the message:
?IFL

THERE IS NOT ENOUGH IFL MEMORY FOR THE CURRENT COMMAND LINE

• Add the following note to the end of Section 9.5.4.1:

NOTE
RMSIFL dynamically allocates virtual address space to
accomodate the requirements of input and output files.
Therefore, the utility does not specifically limit the bucket sizes
of input or output file or the sizes of records in either file.
However, the combination of unusually large bucket and
record sizes, especially if RMSIFL must sort the input file
can cause RMSIFL to terminate execution of the command
line.
Normally, the utility terminates after printing the message:
? I FL

- -

THERE IS NOT ENOUGH I FL MEMORY FOR THE CURRENT COMMAND LI NE

RMSIFL can also terminate abnormally with a memory protection or other system-level error.
If either of these situations occurs:

1. Submit a Software Performance Report with all details of
the situation including input and output file bucket sizes,
input file Maximum Record Size, size of the largest record actually in the input file, and terminal display when
RMSIFL aborted.
1

1-6

Introduction

2. Recover using one of the following methods:
• Reduce input file bucket or maximum record size or
both, and restart RMSIFL.
• Populate the output file using RMSCNV.

• When you install RMS-ll(K) Vl.8, the following capabilities of PDP-11
COBOL V4.0 become available:
You can qualify the file specification used in the ASSIGN clause or the
VALUE OF ID clause with the following switches:
/DW

activates the RMS-llK Deferred Write 1/0 technique. RMS-llK
writes 1/0 buffers to disk only when they are full, in contrast to the
default technique where every write operation causes a physical 1/0
operation. This option is effective only for files that are not writeshared. Deferred Write should have some effect during Mass Insert
operations even if the file is write-shared, if you provide one or more
extra 1/0 buffers.

/Ml

activates the RMS- llK Mass Insert 1/0 technique. This technique
optimizes the insertion (into an Indexed file) of records sorted in
order of ascending Primary Key value; the lowest Primary Key
value in the series must also be greater than any Primary Key value
already in the file. Mass Insert eliminates following the index for
subsequent write operations.

'"-"
Introduction

1-7

Chapter 2
Installing RMS-11(K) on an IAS System
.,.._,

The RMS-ll(K) installation procedure involves an MCR indirect command
file named RMS 11. CMD. The file asks questions concerning the installation
medium and the system configuration and generates messages that fully document installation actions as they are ·automatically initiated.

2.1

Preparation
Before beginning the installation procedure in Section 2 .2:
1.

Boot your system, bringing it to its initial state as generated. This step is
necessary because the RMS-ll(K) installation process replaces the
RMSCNV and RMSDFN task images. Since your system's boot procedure is tightly bound to the task images available when it was created,
you must update that procedure after the RMS-ll(K) installation to prevent error messages every time you boot the system. You update that
procedure by saving the system after the RMS-ll(K) installation is complete. The boot immediately before the installation prevents nonstandard
installations and other configurations from being saved also.

Ensure that the following software is available:
PIP
FLX (magnetic tape kit only)
REM
INS
LBR

If PIP, LBR, and/or FLX are not installed, the installation command file
attempts to install them from LB: [11, 1].

8. Ensure that the following directories exist on your system. If they do not
exist, create them.
SY:[ll,31
LB:[l,ll
LB:[ll,ll

2-1

4. Ensure that IND.TSK is installed from your system disk. If it is not,
install it. IND.TSK executes indirect files. Refer to the !AS User's Guide
for a description of the indirect file facility.
5.

Current RMS-ll(K) users: If you don't want your copies of the following
files deleted and replaced, move or rename them. Some of these files are
new with Vl.8.
All files in SY:[ll,3]
LB: [11, lJRMSBCK. TSK
LB: (11, lJRMSDFN .TSK
LB: [11, lJRMSRST.TSK
LB: (1, lJRMSLIB. OLB
LB:[l,lJRMSll.ODL
LB: [1, 1JRMS12X.ODL
LB: (1, lJRMSRES.TSK
LB: [1,lJRMSSEQ.TSK

2.1.1

LB:[ll,lJRMSCNV.TSK LB:[ll,lJRMSDEF.TSK
LB:[ll,lJRMSDSP.TSK LB:[ll,lJRMSIFL.TSK
LB: [l, lJRMSMAC.MLB LB: [1,lJRMSFUN .OBJ
LB: (1, lJRMSllS.ODL
LB: (1, lJRMSllX.ODL
LB: [1, lJRMSRLX.ODL LB: (1, lJRMSRLS.ODL
LB: [1, lJRMSRES.STB
LB: (1, lJRMSSEQ.STB
LB: [l,lJRMSllR.ODL

Installing COBOL and RMS-11 (K)

If you are installing PDP-11 COBOL V4.0 as well as RMS-ll(K):

1.. Install RMS-11 (K) first.

2. Use the file CBLV40.CMD on the RMS-ll(K) installation medium as
your COBOL installation command file instead of the file provided on
your COBOL installation medium.

...,

The CBLV40.CMD command file ensures that you have the latest versions of
the RMS-ll(K) ODL files after both installations are complete.

2.1.2 Effect on SYSLI B
This installation updates your system's SYSLIB.OLB and provides the Vl.8
version of RMSLIB.OLB. Do not mix versions of these files: you must use the
updated SYSLIB with the Vl .8 RMSLIB and vice versa.
Example If you eliminate the SYSLIB update, yet use the Vl.8 RMSLIB, task building
results at least in the undefined symbol reference $SAVRM. And the tasks built will
produce unpredictable results.

2.1.3 RMS-11 (K) Resident Libraries
• The RMS-ll(K) installation medium contains a Task Builder object library
named TKB.OLB. Also on the medium is a text file named IASSGA.DOC
that explains when and how you use the new object library. Both these files
are in account [200,200].
• The RMSRES Resident Library is not built position-independent (/Pl).
Therefore, the RMSRES Resident Library must use APRs 7 and 6. The
RMSSEQ Resident Library, however, is position-independent.

2-2

Installing RMS-11 (K) on an IAS System

·~~.

•• Until you make the patch to the SYSLIB module OVCTR.MAC concerning
Resident Libraries (published in your software publication), you must specify the read-write (RW) option, instead of the read-only (RO) option, when
you task build against an RMS-ll(K) Resident Library.
Example LIBR=RMSRES:RW

2.1.4 Modifying the RMS-11 (K) Prototype ODL File
'The file MAKRMSODL.CMD is an MCR command file that you can use
indirectly. 'This file edits its own copy of the prototype RMSll.ODL file after
asking you questions about the functions performed by your program. Using
this file to produce a customized ODL file prevents you from making an error
while editing a renamed copy of the RMSll.ODL. However, the command file
uses the same ODL statements describing a 9KB overlay structure. Therefore,
the resulting task is not smaller than if you used RMSllS.ODL,
RMSllX.ODL, or your own version of RMSll.ODL. The task image size on
disk can be smaller, though.

2.1.5 Increase in Task Size
The virtual address space required by a program linked with RMS-11 (K) Vl.8
is greater than the address space used by the same program linked with the
Vl.O or the Vl.5 object library. The increase in task size depends on:
•• the RMS-ll(K) file organizations selected
•• the file and record operations used
•• the manner in which the RMS-ll(K) routines are overlaid
Example A program linked with the 9KB RMS-llK overlay structure via the RMSllX.ODL
file changes as follows:

• Root segment size increases by approximately 400 bytes.
• Increase of approximately 500 bytes in the length of the longest series of overlay
segments that must be resident in memory at the same time.
• Overall virtual address space requirement increases by approximately 900 bytes.
Example A task using all RMS-ll(K) facilities, built nonoverlaid, increases virtual address
space requirement by approximately 1000 bytes.

2.2 Instructions
The following instructions describe the installation procedure for the
RMS-llK software. You should perform this procedure using a hard-copy
terminal and save the printout for future reference.
1. Physically mount the RMS-ll(K) installation medium, using procedures
in the manual for the unit.

Installing RMS-11 (K) on an IAS System

2-3

CAUTION
Ensure that the medium is write-protected; that is, the write-enable ring
is removed from the tape reel or the WRITE PROTECT switch/indicator
is lit on the disk drive. This precaution ensures that the installation files
are not destroyed.
2. Log in under account [1, 1].
3.

Logically mount the RMS-ll(K) installation medium, using the command:
• For disks:
MOUNT/NOOP dun: RMSKIT
• For magnetic tapes:
MOUNT/FOREIGN/NOOP dun: RMSKIT
where:
specifies the physical name and number of the device carrying the
installation medium.
IAS responds with volume information.

dun:

Example If you mounted the RMS-ll(K) installation medium on the first RK05 unit on
your system, enter the command:

MOUNT/NOOP DKO: RMSKIT
IAS then displays:

MOUNT-••VOLUME INFORMATION**
DEl.JICE =DKO
CLASS
=FILE 11
LABEL
=RMSKIT
UIC
=Ut1J
ACCESS =[RWED1RWED1RWED1RWEDJ
CHARAC =[J

Copy the command file [200,200]RMS11.CMD from the installation medium to your account, using the command:
• For disks:
COPY dun:[200,200]RMS11.CMD *.*
• For magnetic tapes:
COPY dun:[200,200]RMS11.CMD/DOS *.*
where:
dun:

is the physical name and number you used in the MOUNT command (see step 3).

5. Execute the installation indirect command file by typing:
MCR IND @RMSll
The command file controls the installation of RMS-11 (K).

2-4

Installing RMS-ll(K) on an IAS System

6.
·ll-

After a series of operations and comments, the terminal prints:
WHAT DEt.JICE IS YOUR DISTRIBUTION KIT MOUNTED ON <NO COLON) [S R:2-4J:

Type the physical name and number of the device carrying the installation medium (see step 3), in the form dun.
An invalid device specification causes the terminal to print:
; *** I Nt,JALI D DEt,J I CE MNEMONIC ENTERED ***

Repeat this step.
7. The terminal prints:
*WILL YOU BE USING THE RMS RESIDENT LIBRARIES (STD AND 11K)? ['(/NJ:

If you are installing RMS-11, the Resident Library is RMSSEQ, which
supports Sequential files only. If you are installing RMS-1 lK, the
Resident Libraries include RMSSEQ and RMSRES, which supports all
RMS--llK file organizations.

Type one of the following:
y

if you want the RMS-ll(K) Resident Library(s) copied into LB: [1, 1]
on your system so that the system manager can install it (them)
when this process has completed.

if you do not want the RMS-ll(K) Resident Library(s) copied to
your system.

8. The terminal prints:
; THE RMS-11 DISTRIBUTION KIT CONTAINS THE RMS-11 UTILITY TASK IMAGES,
; IT ALSO CONTAINS THE OLB, ODL AND CMD FILES REQUIRED TO RE-TASKBUILD
; THE RMS-11 UTILITIES IF THE NEED SHOULD El.JER AR I SE, THESE FI LES
; WILL BE UNLOADED FROM THE DISTRIBUTION KIT ONTO YOUR SYSTEM DISK
; INTO DIRECTORY [0111003] IF YOU ANSWER "YES" TO THE FOLLOWING QUESTION,
; OTHERWISE' THEY WI LL BE LEFT ON THE DI STR I BUT I ON KIT FOR LATER ACCESS,
*DO YOU WANT THE RMS UTILITY TASKBUILD FILES ON YOUR SYSTEM DISK? [Y/NJ:

Type one of the following:
Y

if you want the installation process to copy the files required to
rebuild the RMS-ll(K) utilities onto your system. You use these
files whenever a utility or an RMS-ll(K) object module is patched
(see Section 1.4).

if you do not want these files copied onto your system, but left on the
installation medium.

9. The installation process performs a series of operations.

NOTE
Some of the REMOVE and PIP /DE commands may return
errors. You can ignore them.
Installing RMS-ll(K) on an IAS System

2-5

10. If your system disk is not an RK05, go to step 24; otherwise, the terminal
prints:
; SINCE YOUR SYSTEM DI SK IS AN RK DEl.' I CE, YOU WI LL BE GI l.JEN THE
; OPTION OF LOADING ONLY THOSE RMS-11 UTILITIES THAT YOU NEED

* DO YOU WANT THE RMSBCK UTILITY IN YOUR SYSTEM? [YIN J:

Type one of the following:
Y

if you want to copy and install the task image of RMSBCK Vl .8
onto your system; any RMSBCK task image already there is deleted. Go to step 11.

if you do not want the RM SB CK Vl .8 utility copied and installed
onto your system. Go to step 12.

11. The terminal prints:
* WHAT DI SK DEt.1 I CE DO YOU WANT RMSBCK ON (NO COLON) :

Type the physical name and number of the disk where you want the
RMSBCK utility copied, in the form dun.
12. After a series of operations, the terminal prints:
*DO YOU WANT THE RMSRST UTILITY IN YOUR SYSTEM? CY/NJ:

Type one of the following:
Y

if you want to copy and install the task image of RMSRST Vl .8 onto
your system; any RMSRST task image already there is deleted. Go
to step 13.

if you do not want the RMSRST Vl .8 utility copied and installed
onto your system. Go to step 14.

13. The terminal prints:
* WHAT DI SK DEl,l I CE DO YOU WANT RMSRST ON (NO COLON) :

Type the physical name and number of the disk where you want the
RMSRST utility copied, in the form dun.
14. After a series of operations, the terminal prints:
* DO YOU WANT THE RMSDSP UT LL I TY IN YOUR SYSTEM? [ Y /NJ:

Type one of the following:

2-6

if you want to copy and install the task image of RMSDSP Vl .8 onto
your system; any RMSDSP task image already there is deleted. Go
to step 15.

if you do not want the RM SD SP Vl .8 utility copied and installed
onto your system. Go to step 16.

Installing RMS-ll(K) on an IAS System

15. The terminal prints:
*WHAT DISK DEl.JICE DO YOU WANT RMSDSP ON (NO COLON>:

Type the physical name and number of the disk where you want the
RMSDSP utility copied, in the form dun.
16. After a series of operations, the terminal prints:
*DD YOU WANT THE RMSCNl,l UTILITY IN YOUR SYSTEM? CY /NJ:

Type one of the following:
Y

if you want to copy and install the task image of RMSCNV Vl .8
onto your system; any RMSCNV task image already there is deleted. Go to step 17.

if you do not want the RMSCNV Vl .8 utility copied and installed
onto your system. Go to step 18.

17. The terminal prints:
* WHAT DI SK DEi.JI CE DO YOU WANT RMSCNl.J ON (NO COLON) :

Type the physical name and number of the disk where you want the
RMSCNV utility copied, in the form dun.
18. After a series of operations, the terminal prints:
* DO YOU WANT THE RMSDFN UTILITY IN YOUR SYSTEM? [YIN J :

Type one of the following:

''-'

if you want to copy and install the task image of RMSDFN Vl.8
onto your system; any RMSDFN task image already there is deleted. Go to step 19.

if you do not want the RMSDFN Vl .8 utility copied and installed
onto your system. Go to step 20.

19. The terminal prints:
* WHAT DI SK DEi.' I CE DO YOU WANT RMSDFN ON (NO COLON) :

Type the physical name and number of the disk where you want the
RMSDFN utility copied, in the form dun.
20. After a series of operations, the terminal prints:
* DO YOU WANT THE RMSDEF UTILITY IN YOUR SYSTEM? [YIN J :

Type one of the following:
Y

if you want to copy and install the task image of RMSDEF Vl .8 onto
your system; any RMSDEF task image already there is deleted. Go
to step 21.

if you do not want the RMSDEF Vl.8 utility copied and installed
onto your system. Go to step 22.
Installing RMS-ll(K) on an IAS System

2-7

21. The terminal prints:
* WHAT DI SK DEl.JI CE DO YOU WANT RMSDEF ON (NO COLON) :

Type the physical name and number of the disk where you want the
RMSDEF utility copied, in the form dun.
22. If you are installing RMS-11, not RMS-llK, go to step 24; oth~rwise,
after a series of operations, the terminal prints:

* DO YOU WANT THE RMS I FL UT I LI TY IN YOUR SYSTEM? [YIN J:
Type one of the following:
Y

if you want to copy and install the task image of RMSIFL Vl.8 onto
your system; any RMSIFL task image already there is deleted. Go to
step 23.

if you do not want the RMSIFL Vl .8 utility copied and installed
onto your system. Go to step 24.

23. The terminal prints:

* WHAT DI SK DEl.JI CE DO YOU WANT RMS I FL ON (NO COLON) :
Type the physical name and number of the disk where you want the
RMSIFL utility copied, in the form dun.
24. The installation command file finally prints:
; *** RMS-11 SYSTEM INSTALLATION (l,JERSION 1 +8) IS NOW COMPLETE***

25. Type:
SAVE
IAS saves the current state of the system as part of its boot procedure.
26. Logically dismount the installation volume, using the command:
DISMOUNT dun: RMSKIT
where:
dun:

is the physical name and number of the device specified in step 3.

Example To finish the example started in step 3, enter:

DISMOUNT DKO: RMSKIT

27. Physically dismount the installation medium, using the procedure in the
manual for the unit.
28. Store the installation medium securely.

2-8

Installing RMS-11 (K) on an IAS System

29. Modify your system start-up procedures to contain those of the following
commands that are appropriate to your system, if they are not there:
• For PDS installations:
INS LB: [11,1JRMSBCK/TASK==$$$BCK
INS LB:[ll,1JRMSCNV/TASK==$$$CNV
INS LB:[ll,1JRMSDEF/TASK=$$$DEF
INS LB: [11, 1JRMSDFN/TASK=$$$DFN
INS LB: [11, lJRMSDSP/TASK=$$$DSP
INS LB:[ll,1JRMSIFL/TASK=$$$IFL (RMS-llK only)
INS LB:[ll,1JRMSRST/TASK=$$$RST

• For MCR installations:
INS LB:[ll,lJRMSBCK/TASK= ... BCK
INS LB:[ll,lJRMSCNV/TASK== ... CNV
INS LB:[ll,lJRMSDEF/TASK= ... DEF
INS LB:[ll,lJRMSDFN/TASK= ... DFN
INS LB:[ll,lJRMSDSP/TASK= ... DSP
INS LB:[ll,lJRMSIFL/TASK= .. .IFL (RMS-llK only)
INS LB: [11, lJRMSRST/TASK= ... RST

This modification ensures that RMS-11 (K) utilities are installed.
The RMS-11 User's Guide, Chapter 9, shows you how to use the
RMS-ll(K) utilities.
30. If you requested the RMS-ll(K) Resident Library(s) (Y in step 7), your
system manager can now install one or both of them. See the RMS-11
User's Guide, Chapter 8, for guidance in this procedure.

'"'-1
Installing RMS-11 (K) on an IAS System

2-9

Chapter 3
Installing RMS-11 K on a RSTS/E System
The RMS-llK installation procedure involves a control file named
RMSll.CTL. The file generates messages that fully document installation
actions as they are automatically initiated.

3.1

Preparation
Before beginning the installation procedure in "Instructions," Section 3.2:
• Ensure that the following software is available:
SY:[l,2JPIP.SAV
SY:LBR.TSK
RT-11 Run-Time System
RSX Run-Time System

• If your SYSLIB.OLB file is contiguous, make it noncontiguous or the installation process will fail.

• For current RMS-llK users: If you don't want your copies of the following
files deleted and replaced, move or rename them. Some of these files are
new with Vl.8.
RMSFUN.OBJ
SY:[l,2JRMSBCK.TSK
SY:[l,2JRMSDFN.TSK
SY: [0, lJRMSSEQ.LIB
LB:RMSRLS.ODL
LB:RMSll.ODL
LB:RMSRTX.ODL
LB:RMSll.TSK
SY: [l,2JRMSIFL. TSK
(RMS-llK only)
SY: [0, lJRMSRES.LIB

RlGET.OBJ
SY: [1,2JRMSCNV.TSK
SY: [1,2JRMSDSP.TSK
LB:RMSSEQ.TSK
SY:RMSFUN.OBJ
LB:RMSllS.ODL
LB:RMSllX.ODL
LB:RMSll.STB

RlGSET.OBJ
SY: [l,2JRMSDEF. TSK
SY: [1,2JRMSRST .TSK
LB:RMSSEQ.STB
LB:RMSRTS.ODL
LB:RMS12X.ODL
SY:[O,lJRMSll.RTS

LB:RMSRES.TSK

LB:RMSRES.STB

3-1

• For current RMS-llK users: This installation provides a new version of the
RMS-11 Run-Time System (RMSll.RTS). In the process, it deletes the
current version of the RTS. You cannot run tasks built against the older
(Vl.5) RTS using the newer RTS. See also the RSTS/E V7.0 Release Notes
concerning this subject.

·~

If you do not want to rebuild all tasks using this RTS, you should perform

the following steps before installing RMS-llK Vl.8.
1. Rename the RMS11.RTS file.
Example PIP RMSV15.RTS=RMS11.RTS/RE

Change the RTS attribute of each task using the RMS- llK RTS
to contain the new name. There are at least three ways to do this; see
your RSTS/E documentation for further explanation of syntax and
procedures.
• Use the NAME command provided by the UTILTY CUSP. This
command enables you to change one file at a time.

Example RUN $UTILTY
NAME RMSV15=ARMS11.TSK

• Use the RTS switch provided by the PIP.SAV CUSP. This facility
enables you to use wild card characters and thereby affect multiple
files.
Example RUN $PIP.SAY
*.*/RTS:RMSV15

• Write a BASIC-PLUS program that searches for task files with the
RMSll.RTS attribute, changing each one to specify the new name of
the RTS.

3.2 Effect on SYSLIB
This installation updates your system's SYSLIB.OLB and provides the Vl.8
version of RMSLIB.OLB. Do not mix versions of these files: you must use the
updated SYSLIB with the Vl .8 RMSLIB and vice versa.
Example If you eliminate the SYSLIB update, yet use the Vl.8 RMSLIB, task building
results at least in the undefined symbol reference $SAVRM. And the tasks built will
produce unpredictable results.

3.3 RMS-11 K Resident Libraries
The RMS-llK Resident Libraries are built position-independent (/Pl).
Therefore, you can select the Address Page Register(s) dedicated to a Library
when you task build against it or use the Task Builder's defaults (see the
RMS-11 User's Guide, Chapter 8).

3-2

Installing RMS-1 lK on a RSTS/E System

3.4 Increase in Task Size
~·

The virtual address space required by a program linked with RMS-11K Vl.8
is greater than the address space used by the same program linked with the
Vl.O or the Vl.5 object library. The increase in task size depends on:
• the RMS-11K file organizations selected
• the file and record operations used
• the manner in which the RMS-1 lK routines are overlaid
Example A program linked with the 9KB RMS-llK overlay structure via the RMSllX.ODL
file changes as follows:

• Root segment size increases by approximately 400 bytes.
• Increase of approximately 500 bytes in the length of the longest series of overlay
segments that must be resident in memory at the same time.
• Overall virtual address space requirement increases by approximately 900 bytes.
Example A task using all RMS-llK facilities, built nonoverlaid, increases virtual address
space requirement by approximately 1000 bytes.

3.!; Instructions

'--1.

The following instructions describe the installation procedure for the
RMS-llK software. You should perform this procedure using a hard-copy
terminal and save the printout for future reference.
1.

Physically mount the RMS-11K installation medium, using procedures in
the manual for the unit.

CAUTION
Ensure that the medium is write-protected; that is, the
write-enable ring is removed from the tape reel or the
WRITE PROTECT switch/indicator is lit on the disk drive.
This precaution ensures that the installation files are not
destroyed.
2.

3. If you received the RMS-11K installation files on magnetic tape, go
to step 4; otherwise, logically mount the installation medium, using the
command:
MOUNT dun: RMSKIT/RO
where:
dun:

specifies the physical name and number of the drive carrying the
installation disk.

Installing RMS-11K on a RSTS/E System

3-3

Example If you mounted the installation disk on the first RK05 drive on your system,

enter the command:
MOUNT DKO: RMSKIT/RO

4. Perform the following sequence of entries:
RUN $BUILD
BU I LD build id system id
SYsteM Build <No> ?
Source InPut Device <SY:>?
Library Output Device <SY:>?
Tarset SYsteM Device <SYO:>?
Li bran· Account <Cl 12J>?
Control File is ?

(BIT)

dun:
(BIT)
(BIT)
(BIT)

dun:[l,2JRMS11. CTL

*** CoP}'ins file dun:Cl 12JRMS11+CTL to BLDnn.TMP ***
Function <Build/Patch t Patch' Build) <Build/Patch>? (BIT)
Patch f i 1 e in Put 1 o cat i on <SY: [ 2 0 0 '2 0 0 J > ?
dun: [act nbr]
Sa1.1e Patched sources <No>?
(BIT)
Additional Control File is <None>?
(BIT)

where:

dun:

specifies the physical name and number of the device carrying the RMS- llK installation medium

dun: [act nbr]

specifies the physical name and account number that you
have specified at this point throughout your system generation procedure

5. The terminal where you entered the commands prints the installation
process.
Among other things, this process:
• Removes the following CCL commands. New RMS-llK users receive
error messages that they can ignore. These CCL commands are then
recreated (the RMSRST utility is given privileges).
BCK
CNV
DEF
DFN
DSP
IFL
RST

• Removes the following Resident Libraries and Run-Time Systems. New
RMS-llK users receive error messages that they can ignore. Then the
control file adds the new RMS- llK RTS.
RMSRES
RMS SEQ
RMSll.RTS

NOTE
All RMS-llK utilities use the RSX Run-Time System.

3-4

Installing RMS-1 lK on a RSTS/E System

6. The control file terminates after displaying the line:
RMS-11 INSTALLATION IS NOW COMPLETE

If this message does not appear before the system prints the keyboard
monitor prompt (Ready, by default), then a severe error occurred during
the installation process. (The control file allows warning errors to occur.)
Look at the messages printed during the process to determine where the
error occurred. Correct the condition causing the error and restart this
procedure.

7. The BUILD utility terminates after printing the line:
!*** BUILD ComPlete ***

''-"

8. If you are using the RMS-UK installation file on magnetic tape, go to
step 9; otherwise, logically dismount the installation volume, using the
following command sequence:
RUN $UTILTY
#DISMOUNT dun: RMSKIT
#EXIT

where:
dun:

is the physical name and number of the disk drive specified in
step 3.

Example To finish the example started in step 3, enter:

RUN $UTILTY
#DISMOUNT DKO: RMSKIT
#EXIT

Physically dismount the installation medium, using the procedure in the
manual for the unit.

10. Store the installation medium securely.
11. Modify your system start-up control file(s) to contain the following commands, if they are not there:
FORCE KBO: ADD RMSll
FORCE KBO: BCK-=$RMSBCK.TSK;O
FORCE KBO: CNV-=$RMSCNV.TSK;O
FORCE KBO: DEF-=$RMSDEF.TSK;O
FORCE KBO: DFN-=$RMSDFN .TSK;O
FORCE KBO: DSP-=$RMSDSP . TSK;O
FORCE KBO: IFL-=$RMSIFL.TSK;O
FORCE KBO: RST-=$RMSRST.TSK;PRIVO

This modification makes RMS-UK software available to system users
and designates RMS-UK utilities as CCL commands.

Installing RMS-UK on a RSTS/E System

3-5

NOTE
The RMSDFN utility is provided for compatibility only.
You should use the RMSDEF utility to create RMS-11K
files. Therefore, the line designating DFN as a CCL command may be omitted from your control file without reducing your RMS-11K capabilities.
12. The RMSll.CTL control file provides files that supply all RMS-11K
functionality. If the users of your system do not require some of those
features, you may delete the appropriate files.
Example If no one writes MACR0-11 programs that perform RMS- llK operations, you
can delete LB:RMSMAC.MLB.
Example If no one uses an RMS-llK Resident Library, you can delete the .LIB file on
SY: and the .TSK and .STB files on LB:.

13. If you are using the RMS-11K Resident Libraries, your system manager
can now install one or both of them. See the RMS-11 User's Guide,
Chapter 8, for guidance in this process.
You should also add one or both of the following commands to your system
start-up control file(s):
FORCE KBO: ADD RMSSEQ
FORCE KBO: ADD RMSRES

3-6

Installing RMS-1 lK on a RSTS/E System

Chapter 4
Installing RMS-11(K) on an RSX-11M or
RSX-11 M-PLUS System
The RMS-ll(K) installation procedure involves an MCR indirect command
file named RMSll.CMD. The file asks questions concerning the installation
medium and the system configuration and generates messages that fully document installation actions as they are automatically initiated.

4.1

Preparation
Before beginning the installation procedure in Section 4.2:
• Ensure that the following software is available:
PIP
REM
LBR
FLX (magnetic tape only)
INS

If PIP, LBR, and/or FLX are not installed, the installation command file
attempts to install them from logical device $.

• For current RMS-ll(K) users: If you don't want your copies of the following files deleted and replaced, move or rename them. Some of these files are
new with Vl.8.
LB: [1,54JRMSBCK.TSK
LB: [1,54JRMSCNV.TSK
LB: [1,54JRMSDEF. TSK
LB: [1,54JRMSDFN .TSK
LB: [1,54JRMSDSP. TSK
LB: [1,54JRMSIFL.TSK
LB: [1,54JRMSRST.TSK
LB: [1, lJRMSLIB. OLB
LB: [1,20JRMSODL.ODL
LB: [1, lJRMSFUN .OBJ
LB: [1, lJRMSll.ODL
LB: [1, 1JRMS12X.ODL
LB: [1, lJRMSllR.ODL
LB: [1, lJRMSRES.TSK
LB: [1, lJRMSSEQ.TSK
SY: [1,24JRMSRES.CMD

SY: [l,20JBCKBLD. ODL
SY: [1,20JCNVBLD.ODL
SY: [1,20JDEFBLD.ODL
SY: [1,20JDFNBLD.ODL
SY: [1,20JDSPBLD.ODL
SY: [1,20JIFLBLD.ODL
SY: [l,20JRSTBLD.ODL
SY: [1,20JRMSUTL. OLB
LB:[l,20JRMSCNV.ODL
LB: (1, lJRMSMAC.MLB
LB: (1, lJRMS llS. ODL
LB:[l,lJRMSRLX.ODL

SY:[l,24JBCKBLD.CMD
SY: [1,24JCNVBLD.CMD
SY: [1,24JDEFBLD.CMD
SY: [1,24JDFNBLD.CMD
SY: [1,24JDSPBLD.CMD
SY:[l,24JIFLBLD.CMD
SY: [l,24JRSTBLD.CMD
SY: [1,20JRMSIFL. OLB
SY: [1,20JIFLRSX. ODL
LB:[l,20JRMSUTL.ODL
LB:[l,lJRMSllX.ODL
LB: (1, lJRMSRLS.ODL

LB: [1, lJRMSRES.STB
LB: [1, lJRMSSEQ.STB
SY: [1,24JRMSSEQ.CMD

SY: [1,24JRMSRES.ODL
SY: [1,24JRMSSEQ. ODL

4-1

4.1.1

Installing COBOL and RMS-11 (K)

If you are installing PDP-11 COBOL V4.0 as well as RMS-ll(K):

1. Install RMS-ll(K) first.

2. Use the file CBLV40.CMD on the RMS-ll(K) installation medium as
your COBOL installation command file instead of the file provided on
your COBOL installation medium.
The CBLV40. CMD command file ensures that you have the latest versions of
the RMS-ll(K) ODL files after both installations are complete.

4.1.2 Effect on SYSLIB
This installation updates your system's SYSLIB.OLB and provides the Vl.8
version of RMSLIB.OLB. Do not mix versions of these files: you must use
the updated SYSLIB with the Vl.8 RMSLIB and vice versa.

Example If you eliminate the SYSLIB update, yet use the Vl.8 RMSLIB, task building
results at least in the undefined symbol reference $SAVRM. And the tasks built will
produce unpredictable results.

4.1.3 RMS-11 (K) Resident Libraries
The RMS-ll(K) Resident Libraries are built position-independent (/PI).
Therefore, you can select the Address Page Register(s) dedicated to a Library
when you task build against it or use the Task Builder's defaults (see the
RMS-11 User's Guide, Chapter 8).
Set up partitions for the Library(s) as follows:
Library
Name

Partition
Name

Minimum
Partition
Size

RMS RES

24KW

RMS SEQ

4KW

See the SET MCR command in the RSX-llM Operator's Procedures Manual.

-~-i

4.1.4 Modifying the RMS-11 (K) Prototype ODL File
The file MAKRMSODL.CMD is an MCR command file that you can use
indirectly. This file edits its own copy of the prototype RMSll.ODL file after
asking you questions about the functions performed by your program. Using
this file to produce a customized ODL file prevents you from making an error
while editing a renamed copy of the RMSll.ODL. However, the command file
uses the same ODL statements describing a 9KB overlay structure. Therefore,
the resulting task is not smaller than if you used RMSllS.ODL,
RMSllX.ODL, or your own version of RMSll.ODL. The task image size on
disk can be smaller, though.
NOTE TO VAX USERS
To use MAKRMSODL.CMD, you must logon using the
/CLI=MCR switch.
4-2

Installing RMS-ll(K) on an RSX-llM or RSX-llM-PLUS System

4.1.5 Increase in Task Size
The virtual address space required by a program linked with RMS-11 (K) Vl.8
is greater than the address space used by the same program linked with the
Vl.O or the Vl.5 object library. The increase in task size depends on:
•• the RMS-ll(K) file organizations selected
•• the file and record operations used
•• the manner in which the RMS-ll(K) routines are overlaid
Example A program linked with the 9KB RMS-llK overlay structure via the RMSllX.ODL
file changes as follows:
• Root segment size increases by approximately 400 bytes.
• Increase of approximately 500 bytes in the length of the longest series of overlay
segments that must be resident in memory at the same time.
• Overall virtual address space requirement increases by approximately 900 bytes.

Example A task using all RMS-ll(K) facilities, built nonoverlaid, increases virtual address
space requirement by approximately 1000 bytes.

4.2 Instructions
The following instructions describe the installation procedure for the
RMS-llK software. You should perform this procedure using a hard-copy
terminal and save the printout for future reference.
l.

Physically mount the RMS-ll(K) installation medium, using procedures
in the manual for the unit.

CAUTION
Ensure that the medium is write-protected; that is, the
write-enable ring is removed from the tape reel or the
WRITE PROTECT switch/indicator is lit on the disk drive.
This precaution ensures that the installation files are not
destroyed.
2.

3. If you received the RMS-ll(K) installation files on magnetic tape, go
to step 4; otherwise, logically mount the installation medium, using the
command:
MOUNT dun: RMSKIT
where:
dun:

specifies the physical name and number of the drive carrying the
installation disk.

Go to step 5.
Example If you mounted the installation disk on the first RK05 drive on your system,
type the command:
MOUNT DKO: RMSKIT

Installing RMS-ll(K) on an RSX-llM or RSX-llM-PLUS System

4-3

4. Identify the tape drive carrying the installation medium:
• On RSX-llM:
ALL dvn:
• On RSX-llM-PLUS:
MOUNT dvn:RMSKIT/FOR
where:
dvn:

specifies the physical name and number of the drive carrying the
installation tape.
f

Copy the installation command file RMSll.CMD from the installation
medium to your account, using one of the following commands:
• For tape:
FLX /RS=dvn:[200,200]RMS11.CMD/DO
• For disk:
PIP =dvn: [200,200]RMS11.CMD
where:
dvn:

specifies the device carrying the installation medium (see steps 3
and 4).

6. Execute RMSll.CMD as an MCR indirect file by typing:
@RMSll.CMD
This command file directs the installation of RMS-ll(K).
7. After a series of operations, the terminal prints:

>* WH A T D El.' I C E I S Y 0 U R D I S T R I B U T IO N K I T MD U N T E D 0 N ( N 0 C 0 L 0 N ) [ S, R : 2 - 4 J :
Type the physical name and number of the deviee carrying the installation medium (see step 3), in the form dvn.
An invalid device specification causes the terminal to print:

>;
>; *** I Nl.JALI D DEt,l I CE MNEMONIC ENTERED ***
>;
Repeat this step.
8.

After a series of operations, the terminal prints:

* WILL Y 0 U BE USING THE RMS RESIDENT LIBRA R I ES ( STD AND 11 K ) ? [YIN J :
If you are installing RMS-11, the Resident Library is RMSSEQ, which
supports Sequential files only. If you are installing RMS-llK, the

4-4

Installing RMS-ll(K) on an RSX-llM or RSX-llM-PLUS System

Resident Libraries include RMSSEQ and RMSRES, which supports all
RMS-llK file organizations.
Type one of the following:
Y

if you want the RMS-ll(K) Resident Library(s) copied into LB: [1, 1]
on your system so that the system manager can install it (them)
when this process has completed.

if you do not want the RMS-ll(K) Resident Library(s) copied to
your system.

9. The terminal prints:
:::-; THE RMS-11 DISTRIBUTION KIT CONTAINS THE RMS-11 UTILITY TASK IMAGES.
>; IT ALSO CON TA I NS THE OLB t ODL AND CMD FI LES REQUIRED TO RE-TASK BU I LD
>; THE RMS-11 UTILITIES IF THE NEED SHOULD El,JER AR I SE. THESE FI LES
>; WI LL BE UNLOADED FROM THE DI STR I BUT I ON KIT ONTO YOUR SYSTEM DI SK
>; INTO DIRECTORIES [001 t020J AND [001 t02l!J IF YOU ANSWER "YES" TO THE
>; FOLLOW I NG QUEST I ON. OTHERWISE t THEY WI LL BE LEFT ON THE DI STR I BUT I ON
>; KIT FOR LATER ACCESS •••

>;
>*DO YOU WANT THE RMS UTILITY TASKBUILD FILES ON YOUR SYSTEM DISK? CY/NJ:

Type one of the following:
y

if you want the installation command file to copy the files required
to rebuild the RMS-ll(K) utilities onto your system. You use these
files whenever a utility or an RMS-ll(K) object module is patched
(see Section 1.4).

if you do not want these files copied onto your system, but left on the
installation medium.

10. The installation command file performs a series of operations.

NOTE
Some of the REMOVE and PIP /DE commands may return
errors. You can ignore them.
11. If your system disk is not an RK05, go to step 25; otherwise, the terminal
prints:
>; SINCE YOUR SYSTEM DI SK IS AN RK DEl,J I CE t YOU WI LL BE GI l,lEN THE
>;OPTION OF LOADING ONLY THOSE RMS-11 UTILITIES THAT YOU NEED••.

>;
>;
>*DO YOU WANT THE RMSBCK UTILITY IN YOUR SYSTEM? CY/NJ:

Type one of the following:

if you want to copy and install the task image of RMSBCK Vl.8
onto your system; any RMSBCK task image already there is deleted. Go to step 12.

Installing RMS-ll(K) on an RSX-llM or RSX-llM-PLUS System

4-5

if you do not want the RMSBCK Vl .8 utility copied and installed
onto your system. Go to step 13.

12. The terminal prints:
>* WHAT DI SK DEi.i I CE DO YOU WANT RMSBCK ON (NO COLON) :

Type the physical name and number of the disk where you want the
RMSBCK utility copied, in the form dun.
13. After a series of operations, the terminal prints:
>* DO YOU WANT THE RMSRST UTILITY IN YOUR SYSTEM? [YIN J:

Type one of the following:
Y

if you want to copy and install the task image of RMSRST Vl .8 onto
your system; any RMSRST task image already there is deleted. Go
to step 14.

if you do not want the RMSRST Vl.8 utility copied and installed
onto your system. Go to step 15.

14. The terminal prints:
>* WHAT DI SK DEl.1 I CE DO YOU WANT RMSRST ON <NO COLON) :

Type the physical name and number of the disk where you want the
RMSRST utility copied, in the form dun.
15. After a series of operations, the terminal prints:
>* DO YOU WANT THE RMSDS P UT I LI TY IN YOUR SYSTEM? [YIN J:

Type one of the following:
Y

if you want to copy and install the task image of RM SD SP Vl .8 onto
your system; any RMSDSP task image already there is deleted. Go
to step 16.

if you do not want the RMSDSP Vl.8 utility copied and installed
onto your system. Go to step 17.

16. The terminal prints:
>* WHAT DI SK DEi.i I CE DO YOU WANT RMSDSP ON (NO COLON):

Type the physical name and number of the disk where you want the
RMSDSP utility copied, in the form dun.
17. After a series of operations, the terminal prints:
>*DO YOU WANT THE RMSCNl.1 UTILITY IN YOUR SYSTEM? CY/NJ:

Type one of the following:
y

4-6

if you want to copy and install the task image of RMSCNV Vl.8
onto your system; any RMSCNV task image already there is deleted. Go to step 18.

Installing RMS-ll(K) on an RSX-llM or RSX-llM-PLUS System

if you do not want the RMSCNV Vl .8 utility copied and installed
onto your system. Go to step 19.

18. The terminal prints:

>* WHAT DI SK DEl,J I CE DO YOU ltJANT RMSCNl.J ON (NO COLON) :
Type the physical name and number of the disk where you want the
RMSCNV utility copied, in the form dun.
19. After a series of operations, the terminal prints:

>* DO YOU WANT THE RMSDFN UTILITY IN YOUR SYSTEM? [YIN J:
The RMSDFN utility is provided for compatibility purposes only. You
should use the RMSDEF utility to create RMS-ll(K) files. Therefore, the
utility may be omitted from your system without reducing your
RMS-ll(K) capabilities.
Type one of the following:
Y

if you want to copy and install the task image of RMSDFN Vl.8
onto your system; any RMSDFN task image already there is deleted. Go to step 20.

if you do not want the RMSDFN Vl .8 utility copied and installed
onto your system. Go to step 21.

20. The terminal prints:

>* WHAT DI SK DEl.J I CE DO YOU ~~ANT RMSDFN ON (NO COLON) :
Type the physical name and number of the disk where you want the
RMSDFN utility copied, in the form dun.
21. After a series of operations, the terminal prints:

>* DO YOU WANT THE RMSDEF UT I LI TY IN YOUR SYSTEM? [YIN J:
Type one of the following:

if you want to copy and install the task image of RMSDEF Vl .8 ontO
your system; any RMSDEF task image already there is deleted. Go
to step 22.

if you do not want the RMSDEF Vl.8 utility copied and installed
onto your system. Go to step 23.

22. The terminal prints:

>* WHAT DI SK DEl.J I CE DO YOU WANT RMSDEF ON (NO COLON) :
Type the physical name and number of the disk where you want the
RMSDEF utility copied, in the form dun.

Installing RMS-ll(K) on an RSX-llM or RSX-llM-PLUS System

4-7

23. If you are installing RMS-11, not RMS-llK, go to step 25; otherwise,
after a series of operations, the terminal prints:

>* DO YOU WANT THE RMS I FL UTILITY IN YOUR SYSTEM? [YIN J :

Type one of the following:
Y

if you want to copy and install the task image of RMSIFL Vl .8 onto
your system; any RMSIFL task image already there is deleted. Go to
step 24.

if you do not want the RMSIFL Vl.8 utility copied and installed
onto your system. Go to step 25.

24. The terminal prints:
>* WHAT DI SK DEl.J I CE DD YOU WANT RMS I FL ON <NO COLON) :

Type the physical name and number of the disk where you want the
RMSIFL utility copied, in the form dun.

~·~

25. The command file finally terminates after printing the line:
>; *** RMS-11 SYSTEM INSTALLATION (l,IERSION 1 +8) IS NOW COMPLETE***

26. Modify either your system start-up control or VMR file to include the
following commands:
INS LB: [l,54JRMSBCK
INS LB: [1,54JRMSCNV
INS LB: [1,54JRMSDEF
INS LB: [1,54JRMSDFN
INS LB: [1,54JRMSDSP
INS LB:[l,54JRMSIFL (RMS-UK only)
INS LB: [l,54JRMSRST

,. ~

If your system disk is an RK05, you may have copied one or more utility

task files to a disk and/or account other than LB:[l,54]. Be sure to use the
correct device and account specification in the INS command. You may
also want to eliminate one or more of the commands.

27. Logically dismount the installation volume.
Example To finish the example started in step 3, type:

DMOUNT DKO: RMSKIT

NOTE
Logging off logically dismounts the volume.
28. Physically dismount the installation medium, using the procedure in the
manual for the unit.
29. Store the installation medium securely.
30. If you requested the RMS-ll(K) Resident Library(s) (Yin step 8), your
system manager can now install one or both of them. See the RMS-11
User's Guide, Chapter 8, for guidance in this procedure.

4-8

Installing RMS-ll(K) on an RSX-llM or RSX-llM-PLUS System

""'

RMS-11 Installation Guide
AA-H235A-TC
READER'S COMMENTS
NOTE: This form is for document comments only. DIGITAL will use comments submitted on this form at the
company's discretion. If you require a written reply and are eligible to receive one under Software
Perfonnance 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 user/reader that you most nearly represent.
D
D
D
D
D
D

Assembly language programmer
Higher-level language programmer
Occasional programmer (experienced)
User with little programming experience
Student programmer
Other (please s p e c i f y ) - - . . , . . - - - - - - - - - - - - - - - - - - - - - - - - -

Name
Organization _______________________________________
Street ____· - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - CitY---------------------

State - - - - - - - Zip Code---------or

Country

Do Not Tear- Fold Here and Tape

I 111

No Postage
Necessary
if Mailed in the
United States

BUSINESS REPLY MAIL
FIRST CLASS PERMIT N0.33 MAYNARD MASS.
POSTAGE WILL BE PAID BY ADDRESSEE

RT/C SOFTWARE PUBLICATIONS TW/A14
DIGITAL EQUIPMENT CORPORATION
1925 ANDOVER STREET
TEWKSBURY, MASSACHUSETTS

01876

Do Not Tear - Fold Here

=
:.::3
I]

OI,)

I .§
<
l:i
u
I