Digital PDFs

AA-HH45C-TE

June 1989

33 pages

Original

3.1MB

Document:	VAXELN Ada Installation Guide
Order Number:	AA-HH45C-TE
Revision:	0
Pages:	33
Original Filename:	AA-HH45C-TE_VAXELN_Ada_Installation_Guide_Jun89.pdf

OCR Text

VAXELN Ada
Installation Guide

OE 0080

somWare

VAXELN Ada Installation Guide
Order Number:

June

AA—HH45C-—TE

1989

This document contains instructions for installing VAXELN Ada on the VMS operating
system. It also explains how to read the online release notes before or after installing
the product. This document applies to VAXELN Ada Version 2.0 and all maintenance
updates throughout that version.

Revision/Update Information:

This revised manual supersedes the VAXELN Ada
Installation Guide (Order Number AA—HH45B-TE)

Operating System and Version:

VMS Version 5.0 or higher.
VAXELN Version 3.1 or higher.
Future maintenance releases may
require higher versions.

Software Version:

VAXELN

ITS CUR
TESTING PROCEDURES

digital equipment corporation
maynard, massachusetts

Ada Version 2.0

First Printing, February 1986
Revised, January 1987
Revised, June

1989

The information in this document is subject to change without notice and should not
be construed as a commitment by Digital Equipment Corporation. Digital Equipment
Corporation assumes no responsibility for any errors that may appear in this document.
The software described in this document is furnished under a license and may be used
or copied only in accordance with the terms of such license.
No responsibility is assumed for the use or reliability of software on equipment that is
not supplied by Digital Equipment Corporation or its affiliated companies.
© Digital Equipment Corporation 1986, 1987, 1989.
All Rights Reserved.
Printed in U.S.A.
The postpaid Reader’s Comments forms at the end of this document request your
critical evaluation to assist in preparing future documentation.
The following are trademarks of Digital Equipment Corporation:
ALL—IN-1
DEC
DEC/CMS
DEC/MMS
DECmate
DECnet

EduSystem
IAS
MASSBUS
PDP
PDT
P/OS

RT
ULTRIX
UNIBUS
VAX
VAXcluster
VAXELN

DECSYSTEM-20
DECUS
DECwriter

Q-bus
Rainbow
RSTS

VT
Work Processor
™

DECsystem—10

DIBOL

Professional

RSX

VMS

SHERGED

ZK5129

Contents
Preface .. 0...
ee
Preparing to Install VAXELN Ada...........
2.00. cc
ee
Prerequisite Software .. 0...
eee
Accessing the Online Release Notes............
000 0c cee
ee
ees
Installation Procedure Requirements ......... 0.000 cee eee
ee ee eee
User Account Quotas and Privileges ............
0.00 eee
eee
VMS License Management Facility .........0.
00.0
ee eee
Using VMSINSTAL .. 2...
ees
Installing VAXELN Ada ....... 0.2... ee
es
Installing VAXELN Ada on a VAXcluster..
0...
es
After the Installation...
1... 2.0... 0.
es
Running the Installation Verification Procedure..............
000 ce eee
Error ConditionS 1... 0... 0c ce
ee
Installing the VAXELN Remote Debugger as a Shared Image.................:.
Maintenance Updates ........... 0.0 cee eee
ee es
Determining and Reporting Problems .............
000: ee eee ee
ns
Sample Installation...
.. 0... 0... 00. ee
ee

V
1
1
1
1
3
4
5
6
11
11
11
13
14
15
15
16

Preface

This document describes how to install VAXELN

Ada on the VMS

operating

system. It is intended for system managers. This document applies to
VAXELN Ada Version 2.0 and all maintenance updates in that version. A
major version number is represented by the digits to the left of the decimal
point, and the maintenance update version number is indicated by the digits
to the right of the decimal point.
Keep this document with your distribution kit. You will need it to install

maintenance updates or to reinstall VAXELN

Ada for any other reason.

At the back of this document are two Reader’s Comments forms. If you
have any comments about this document, fill out one form and mail it; your

comments will be considered for the next revision of the installation guide.

For more information about installing VAXELN Ada on VMS systems, see
your processor-specific installation/operations guide.
The installation procedure is described step-by-step and is, for the most
part, self-explanatory.

The system prompts you to answer questions and to

change volumes, and waits for you to tell it to continue.

Defaults appear in brackets ([]) throughout the installation procedure.

you type is indicated in red.

Text

Preparing to Install VAXELN

Ada

Your bill of materials (BOM) and indented bills report (BIL) specify the
number and contents of your media.

Be sure to check the contents of your

kit against this information. If your kit is damaged or if you find that parts
of it are missing, call your Digital representative.

Prerequisite Software
VAXELN Ada requires Version 5.0 or higher of the VMS operating system.
It also requires VAX Ada Version 2.0 or higher and the VAXELN Toolkit
Version 3.1 or higher.
The VMS operating system comes with a variety of support options, or
classes. Classes include such features as networking and RMS journaling.
To use VAXELN Ada, your system should be running a version of VMS that
includes the classes listed in the Software Support Addendum

comes with the Software Product Description (SPD).

(SSA), which

Accessing the Online Release Notes
VAXELN Ada provides online release notes. The prompt to display or print
the release notes during the installation appears in step 4 of the installation
procedure when you invoke VMSINSTAL with the OPTIONS N parameter.
To obtain the release notes after the installation, type or print the file
SYS$HELP:VAXELN_ADA02n.RELEASE_NOTES. The n represents the

maintenance update of VAXELN Ada covered in the release notes. Thus,
in the case of VAXELN

Ada Version 2.0, the release notes are in the file

SYS$HELP:VAXELN_ADA020.RELEASE_NOTES.

Online HELP also directs you to the release notes file. After the installation,
type the following command:
$ HELP

VAXELN ADA

RELEASE NOTES

Installation Procedure Requirements
The installation takes approximately

15 minutes, depending on the type of

WORLD,

media and your system configuration. Before installing VAXELN Ada, you
must have the following privileges and resources:
SETPRV

privileges

privileges, or CMKRNL,

BYPASS,

VAXELN

Ada

and SYSPRV

Installation Guide

5000 blocks of free disk space, minimum, during installation.

If VAXELN Ada already exists on your system and the VAXELN Remote
Debugger was specified as a known or shared image, VMSINSTAL
automatically attempts to install the new version as a known or shared
image. In this case, the installation will require the following number of
global sections and global pages:
Image

Global Sections

Global Pages

SYS$SYSTEM:RDBG$RDEBUG.EXE

SYS$SHARE:RDBG$SHARE.EXE

186

SYS$MESSAGE:RDBG$SHAREMSG.EXE

Note that if you are running VAXELN Ada on a VAXcluster,
VMSINSTAL automatically installs new versions as known or shared

images only on the machine on which the installation is actually performed. You must manually install new versions as known or shared
images on other machines using the VMS Install Utility.

See the Installing the VAXELN Remote Debugger as a Shared Image
section for more information.

To determine the number of available global pages on your system, invoke
the VMS Install Utility by typing the following commands:
$ INSTALL
$ INSTALL

:== $INSTALL/COMMAND
MODE

Then type the following command:
INSTALL>

LIST/GLOBAL/SUMMARY
Summary

379

Global

Sections

INSTALL>

EXIT

When

Local

Memory

Global

Sections

Used,

31922/39978

Global

you enter the LIST/GLOBAL/SUMMARY

Pages

Used/Unused

command,

the system

displays a summary of the number of global sections used, the number of
global pages used, and the number of global pages unused. To exit from the
VMS Install Utility, type the EXIT command.
NOTE
If the necessary number of global pages and global sections is
not available, the DCL tables (SYS$LIBRARY:DCLTABLES.EXE)
could be corrupted in some situations.
2

VAXELN

Ada Installation Guide

If there are fewer than the required number

of global pages

avail-

able, you can delete an existing known image with the VMS Install
Utility, or you can increase the GBLPAGES system parameter by edit-

ing the file SYS$SYSTEM:MODPARAMS.DAT

and then invoking the

SYS$UPDATE:AUTOGEN command procedure. For more information
on modifying system parameters and using AUTOGEN, see the Guide to
Setting Up a VMS System.
You can determine the number of available global sections by invoking
SYSGEN as follows:
$ RUN SYSS$SYSTEM: SYSGEN
SYSGEN> USE CURRENT
SYSGEN> SHOW GBLSECTIONS

SYSGEN>

EXIT

Compare the maximum number of global sections with the number of
global sections in use displayed by the VMS Install Utility. If the number
of global sections used plus the number of global sections required for
the remote debugger exceeds the maximum number of global sections,

you must increase the number

of available global sections before you

can install the remote debugger as a shared image.

number,

you must increase the GBLSECTIONS

To increase the

system parameter by

editing the file SYS$SYSTEM:MODPARAMS.DAT and then invoking the
SYS$UPDATE:AUTOGEN command procedure. For more information
on modifying system parameters and using AUTOGEN, see the Guide to
Setting Up a VMS System.
If the number of global sections used plus the number of global sections
required for the remote debugger is less than the maximum number of
global sections, you can exit from SYSGEN

and continue.

User Account Quotas and Privileges
To use VAXELN

Ada, each account must have TMPMBX

privileges and the following requirements:
e

Enqueue quota (ENQLM): 60 (minimum)

Open file quota (FILLM): 50 (minimum)

Paging file quota (PGFLQUOTA):

Subprocess creation quota (PRCLM): 2 (minimum)

Working set size (WSDEF): 750 pages (minimum)

and NETMBX

17000 pages (minimum)

VAXELN

Ada

Installation Guide

Working set quota (WSQUOTA):

1500 pages (minimum)

Working set extent (WSEXTENT): 2500 pages (minimum)

Use the VMS Authorize Utility (AUTHORIZE) to compare the current
values of these quotas with the requirements for VAXELN Ada. The account
used in the following example is the SYSTEM account:
$ SET DEFAULT SYSSSYSTEM
$ RUN AUTHORIZE
UAF> SHOW SYSTEM

To change the values of these quotas, use the VMS Authorize Utility’s
MODIFY command. For more information, see the VMS Authorize Utility
Manual.

VMS License Management Facility
The VMS License Management Facility (LMF) is available with Version 5.0
of the VMS operating system. Before installing VAXELN Ada, you should
register and load your VAXELN Ada software license.
The license registration information you need is contained in the Product

Authorization Key (PAK) that is shipped with VAXELN Ada. The PAK is a

paper certificate that contains information about the license you have to run

a particular piece of software.

During the installation, you are asked if you have registered the VAXELN
Ada license and loaded the appropriate authorization key. You must register
and load your license for VAXELN Ada before you run the Installation
Verification Procedure (IVP) and use the software.
To register a license under VMS Version 5.0, first log in to a privileged
account. Digital recommends that you register and load the license from the
system manager’s account. You then have a choice of two ways to perform
the registration:
e

Invoke the SYS$UPDATE:VMSLICENSE.COM

procedure.

When it

prompts you for information, respond with data from your Product

Authorization Key (PAK).
e

VAXELN

Ada

Enter the DCL

LICENSE

command

with the appropriate

qualifiers that correspond to information on the PAK.

Installation Guide

Depending on the way in which you have registered the VAXELN Ada
license, you also have a choice of two ways to load the license:
¢

Type YES in response to the appropriate question when you are running

Enter the DCL LICENSE

SYS$UPDATE:VMSLICENSE.COM.
LOAD

Note that you need the CMKRNL,

this command.

command.
SYSNAM,

and SYSPRV

privileges to use

For complete information on using LMF, see the manual on

the License Management

Utility in the VMS

documentation set.

Using VMSINSTAL
After you log in to a privileged account to install VAXELN Ada, invoke
VMSINSTAL, the command procedure that installs this product. An
example of this procedure is shown in steps 1 and 2 of the Installing

VAXELN Ada section.

The VMSINSTAL command procedure has the following syntax:
S

@SYSSUPDATE:VMSINSTAL

VAXELN ADAO2n

ddcu:

[OPTIONS

Represents the maintenance update of VAXELN Ada. Refer to the label on
the VAXELN Ada distribution kit or the bill of materials for the maintenance
update number of your kit. For VAXELN Ada Version 2.0, the maintenance
update is 0.
You can also type an asterisk (*) in place of VAXELN_ADAO2zn.
ddcu:

Represents a device name where the distribution volumes will be mounted
for the VAXELN Ada installation media, where dd is the device code, c is

the controller code, and u is the unit number. It is not necessary to use the
console drive to install VAXELN Ada. If you do use the console drive, you
should replace any media you removed from the drive. MUAO: is the device
name used in the examples in this document.
OPTIONS N
Is an optional parameter you should provide if you want to be prompted
to display or print the release notes. If you do not include the OPTIONS
N parameter, VMSINSTAL does not prompt you to display or print the
release notes. VMSINSTAL permits the use of several other options.
For more information on the other options, see your processor-specific

installation/operations guide.

VAXELN

Ada

Installation Guide

VMSINSTAL

requires the product and device names.

these parameters, VMSINSTAL prompts you for them.

If you do not supply

VMSINSTAL will

also prompt you for the optional parameter that indicates whether or not

you want the release notes displayed or printed. If you wish to be prompted
for the product and device names and to display or print the release notes,
type the following:
9 @SYSSUPDATE: VMSINSTAL

When you invoke VMSINSTAL, it checks the following:
e

Whether you logged in to a privileged account.

Digital recommends

that you install software from the system manager’s

default device and directory set to SYS$UPDATE.

account with your

Whether you have adequate quotas for installation. VMSINSTAL checks
for the following quota values:

—-

ASTLM = 24

—

BIOLM = 18

—-

BYTLM

DIOLM = 18

—-

ENQLM

—

FILLM = 20

= 18000
= 30

VMSINSTAL then checks whether the following conditions exist. If so,
discontinue the conditions before resuming the installation procedure.

Whether DECnet is up and running

Whether any users are logged in to the system

If VMSINSTAL detects either of these conditions, you will be asked
whether you want to continue the installation. If you want to continue,
type YES. If you want to stop the installation, press RETURN.

Installing VAXELN Ada
This section contains excerpts from the installation procedure and ex-

plains each step. Defaults appear in brackets throughout the installation
procedure.

To abort the installation procedure at any time, press CTRL/Y. When you

press CTRL/Y, the installation procedure deletes all files it has created up
to that point and then returns you to DCL level. If you want to retry the
installation procedure after pressing CTRL/Y, you must proceed from step 2.

VAXELN

Ada

Installation Guide

Step 1: Log in to a privileged account and set your default device and
directory to SYSS$UPDATE.
Username:
Password:

SYSTEM

$ SET DEFAULT

SYSSUPDATE

Step 2: Invoke VMSINSTAL.
$ @VMSINSTAL

VAXELN_ADAO2n

VAX/VMS

Software

MUAO:

OPTIONS

Product

Installation

It is
Enter

dd-mmm-yyyy at hh:mm.
a question mark
(?) at

any

you

backup

Are

satisfied

with

the

time

for

Procedure

VX.xX

help.

your

system

disk

[YES]?

[RETURN|

If you are satisfied with the backup of your system disk, press RETURN.
Otherwise, type NO and press RETURN to discontinue the installation.
Digital recommends that you back up your system disk before installing any
software.

Step 3: Insert the installation kit volume.
Please

mount

* Are

The

you

the

ready?

following

VAXELN ADA

first

YES

products

volume

will

processed:

the

set

MUAO:.

V2.n

Beginning installation
SVMSINSTAL-I-RESTORE,

of VAXELN ADA V2.n at hh:mm

Restoring product

saveset A...

To indicate that you want to continue the installation, mount volume
YES, and press RETURN.

1, type

Step 4: Select a release notes option.
This step applies only if you specified OPTIONS N in step 2.

Release

.
.

Notes

Options:

Display release notes
Print release notes
Both 1 and 2
Copy release notes to

SYSSHELP

* Select

not

display,

option

copy

release

notes

[2]:

If you select option 1, VMSINSTAL displays the release notes on line immediately. You can terminate the display at any time by pressing CTRL/C.
VAXELN

Ada

Installation Guide

If you select option 2, VMSINSTAL prompts you for a queue name. Either
type a queue name or press RETURN to send the file to the default output
print device.
* Queve

name

[SYSSPRINT]:

If you select option 3, VMSINSTAL displays the release notes on line immediately. You can terminate the display at any time by pressing CTRL/C.
VMSINSTAL then prompts you for a queue name. Either type a queue name
or press RETURN to send the file to the default output print device. The
VAXELN

Ada release notes are then copied to

SYS$HELP: VAXELN_ADA02n.RELEASE_
NOTES.

If you select option 4, VMSINSTAL copies the release notes to SYS$HELP

immediately.

If you select option 5, VMSINSTAL does not display, print, or copy the
release notes; typically you select this option when you want to terminate
the installation.
NOTE
This version of the release notes file installed by VMSINSTAL is
labeled with the current product name and version number. Take
care not to delete release notes for previous versions of VAXELN

Ada.

Next, VMSINSTAL displays the following prompt:
* Do

you

want

continue

sVMSINSTAL-~I-RELMOVED,
moved to SYSSHELP.

The

the

installation?:

product

release

notes

[RETURN

If you want to continue the installation, type YES

you type NO or press RETURN, VMSINSTAL
In either case, VMSINSTAL

have

been

successfully

and press RETURN.

discontinues the installation.

moves the release notes to SYS$HELP.

Step 5: Select installation options.
* Do

you

want

purge

files

replaced

this

installation

[YES]?

[RETURN]

The directories SYS$EXAMPLES, SYS$HELP, SYS$LIBRARY,
SYS$MANAGER, SYS$SYSTEM, SYS$TEST, and ELN$ may contain previous versions of VAXELN Ada files. These files are replaced during the installation with new files, but the old files are not automatically purged. Purging
is recommended. In response to the purging prompt, press RETURN
purge the files or type NO to keep them.

VAXELN

Ada

Installation Guide

Step 6: Respond to License Registration Queries.
VAXELN Ada supports the VMS License Management Facility (LMF). The
installation procedure displays license information about your product and
then asks if you have registered and loaded your authorization key for
VAXELN Ada. The following is an example of such information:
Product:
Producer:
Version:
Release
Date:

Does

this

product

VAXELN ADA
DEC
2.n
dd-mmm-yyyy

have

authorization

key

registered

and

loaded?

If you have not registered and loaded your authorization key, you must
answer “NO” to this question. If you answer “NO”, the installation still

continues.

Step 7: Read informational messages.
The VAXELN Ada installation procedure produces a number of informational
messages that report on the progress of the installation.
There are
procedure

no more questions.
The
will take approximately

remainder of
10 minutes.

the

installation

This kit contains an Installation Verification Procedure
(IVP)
to
verify the correct installation of VAXELN ADA.
It can be invoked
after the conclusion of this procedure as follows:
@SYSSTEST:VAXELN_ADASIVP
.COM
You must reinstall
VAXELN Toolkit.

VAXELN

sVMSINSTAL-I-RESTORE,
Providing

VAXELN

Ada

VAXELN

Restoring

Remote

IVP

you

install

product
Library

Restoring

SVMSINSTAL-I-RESTORE,
Providing

Run-Time

SVMSINSTAL-I-RESTORE,
Providing

Ada

new

saveset

images

and

version

the

objects.

product

saveset

product

saveset

Debugger.
Restoring

files.

SVMSINSTAL-I-SYSDIR,
This product creates system disk directory
VMISROOT: [SYSTEST.VAXELN ADA].
SCREATE-I-EXISTS,
VMISROOT: [SYSTEST.VAXELN ADA]
already exists
Providing

example

Providing

HELP

program

topic

files.

VAXELN Ada.

The success of the installation is indicated by the following message:
SVMSINSTAL-I-MOVEFILES,

Files

will

now

moved

their

VAXELN

Ada

target

directories...

Installation Guide

If the installation procedure is successful, the files created by the procedure

are moved to their target directories. The following files are created or
modified by the installation procedure:
SYS$COMMON|[SYSTEST. VAXELN_ADA]

and contents

(new)

SYS$TEST: VAXELN_ADA$IVP.COM

(new)

ELN$:ADA$DMATH.EXE

(new)

ELN$:ADA$FMATH.EXE

(new)

ELN$:ADA$GMATH.EXE

(new)

ELN$:ADA$HMATH.EXE

(new)

ELN$:ADA$ELNRTL.EXE

(new)

ELN$:ADA$ELNVMS.EXE

(new)

ELN$:RTLSHARE.OLB

(modified)

ELN$:RTL.OLB

(modified)

ELN$:RTLOBJECT.OLB

(modified)

ELN$:ERROR_HANDLING.ADA

(new)

ELN$:SQRT_SERVER.ADA

(new)

ELN$:SQRT_SERVER_TESTER.ADA

(new)

SYS$SYSTEM:RDBG$RDEBUG.EXE

(new)

SYS$SHARE:RDBG$SHARE. EXE

(new)

SYS$MESSAGE:RDBG$SHAREMSG.EXE

(new)

SYS$HELP:RDBG$HELPLIB.HLB

(new)

SYS$HELP:HELPLIB.HLB

(new)

SYS$HELP: VAXELN_ADA02n.RELEASE_NOTES

(new)

If you typed YES in response to the prompt that requests a file purge at
step 5, previous versions of the VAXELN Ada files are now purged.

Step 8: End the installation procedure.
Installation
VMSINSTAL

$ LOGOUT

SYSTEM

VAXELN ADA

procedure

logged

out

done

V2.n
at

completed

hh:mm

dd-mmm-yyyy

hh:mm:ss.ss

When the product installation procedure is complete, you can choose to
install more products, or to log out (as shown here.) If you removed any

media from the console drive before beginning the installation, you should
replace it now.

VAXELN

Ada

Installation Guide

VMSINSTAL deletes or changes entries in the process symbol tables during
the installation. Therefore, if you are going to continue using the system
manager’s account and you want to restore these symbols, you should log
out and log in again.

Installing VAXELN Ada on a VAXcluster
If you want to run VAXELN Ada on multiple nodes of a VAXcluster, first
check to see that you have the appropriate software license. Then, follow

these steps after installing VAXELN
1.

Ada:

Enter the LICENSE LOAD command to activate the license on each
node in the VAXcluster on which VAXELN Ada is to be executed, as

described in the VMS License Management Utility Manual.

2.
3.

Ifthe other nodes do not share a common system disk with the installation node, you must run a separate installation on each node.
If previous versions of VAXELN

Ada or remote debugger have been spec-

ified as known or shared images, VMSINSTAL automatically attempts
to install the new versions as known or shared images. However, if you
are running VAXELN Ada on a VAXcluster, VMSINSTAL automatically
installs new versions as known or shared images only on the node on
which the installation is actually performed. You must manually install
new versions as known or shared images on other nodes using the VMS
Install Utility.

After the Installation
VAXELN Ada is now installed.

The VAXELN Remote Debugger can be

invoked with the DEBUG/REMOTE
If VAXELN

command.

Ada will be used extensively on your system, you can reduce

system overhead and memory requirements by installing it as a shared
image using the VMS Install Utility. For more information, see the
Installing the VAXELN Remote Debugger as a Shared Image section.

Running the Installation Verification Procedure
The VAXELN Ada installation procedure creates the files needed to run
the Installation Verification Procedure (IVP) (see step 7 of the Installing
VAXELN Ada section).

VAXELN

Ada

Installation Guide

To run the IVP, execute the following command procedure:
$ @SYSSTEST:VAXELN_ADASIVP.COM
The procedure compiles, links, and builds a VAXELN Ada test program to
verify that the packages and run-time library have been properly installed.
First, the following message is issued:
VAXELN

Ada

Version

2.n

Installation

Verification

Procedure.

Then, a temporary program library is created and defined to be the
current program library; the VAX Ada predefined units just installed in
ADA$PREDEFINED are entered into the program library. Messages like

the following are issued:
%ACS-I-CL_

LIBCRE,

SACS-I-CL LIBIS,
SYSSSYSROOT:

Library

Current

SYSSSYSROOT:

program

[SYSUPD.ADAELNSIVP_LIB]

library

created

[SYSUPD.ADAELNSIVP_LIB]

The IVP consists of two programs that are compiled, linked, and then built
into two versions of a bootable VAXELN system. One version is suitable for
copying to a disk; the other is suitable for downline loading.

messages are issued:

Compiling IVP programs.
Linking IVP programs.
SsACS-I-CL LINKING,
Invoking
SACS-I-CL LINKING,
Invoking

the
the

VMS
VMS

An Installation Verification Program
type.
Answer YES if you want an IVP
NO is the default.

QBUS - MicroVAX
UBUS

62xx:

85xx,8700:
8800:

MicroVAX
The

I, MicroVAX

MicroVAX 3600:
- 725, 730, 750:

for
for

VAXELN
VAXELN

target
target

can be built for
built for any of

(KA630),

KA620,

each target CPU
the following targets.

MicroVAX 3500,

2000:

Installation

Verifying

Linker
Linker

The following

Verification

installation

Procedure

VAXELN

Remote

building

the

system...

Debugger.

Two bootable VAXELN Ada test systems have been provided for each
target.
They are in directory SYSSCOMMON: [SYSTEST.VAXELN ADA}.
VAXELN ADASIVP_target_DISK.SYS
is a disk or tape-bootable
VAXELN ADASIVP_target_DOWNLINE.SYS
is a downline-loadable

specified

system.
system.

Use the ELN$:COPYSYS.COM procedure to copy VAXELN ADASIVP_
target _DISK.SYS
to a disk or tape and boot it on a target VAX,
or use downline load
procedures to boot VAXELN ADASIVP target DOWNLINE.SYS.
See the VAXELN
Ada User’s Manual for more details.

VAXELN

Ada

Installation Guide

Any
Ada
the

of these systems will verify that the execution environment of VAXELN
has been correctly installed.
Because the IVP system does not include
Network Service,
you cannot use the VAXELN Remote Debugger on these

systems.

VAXELN

Ada

Version

2.n

Installation

Verification

Procedure

has

After you run the IVP, you will have two bootable VAXELN
available for you to verify that the VAXELN

completed.

systems

Ada execution environment is

correct. SYS$COMMON:[SYSTEST. VAXELN_ADA]:VAXELN_ADAS$IVP__
target_DISK.SYS is a version that can be copied to a disk or tape using
ELN$:COPYSYS.COM, and then booted on a target VAX processor;
SYS$COMMON:ISYSTEST. VAXELN_ADA]:VAXELN_ADAS$IVP_target_
DOWNLINE.SYS is a version that can be downline-loaded. To verify that
the VAXELN Ada execution environment is correct, you should boot one
of these systems on a target VAX processor following the instructions in

the VAXELN Ada User’s Manual. When you boot one of these systems, the
following messages should be displayed on your system console terminal:
VAXELN

Ada

IVP_OK

Job

IVP OK
IVP_OK
IVP_OK

Test
Test
Test

IVP_OK

VAXELN

Version

- Job

Ada

2.n

Installation

Verification

Program

Verification

Program

starting

2 starting

task activated
starting
task finished

Version

2.n

Installation

passed.

If you do not see these messages, or other messages are displayed, the
execution environment may be incorrect and you should contact Digital for
assistance.

Error Conditions
If the VAXELN Ada installation procedure fails for any reason, a message
like the following is displayed:
SVMSINSTAL-E-INSFAIL,

The

installation

VAXELN ADA

V2.n

has

failed.

An error during the installation can occur if one or more of the following
conditions exist:
e

Operating system version is incorrect.

Prerequisite software version is incorrect.

Quotas necessary for successful installation are insufficient (see the
Installation Procedure Requirements section).

Process quotas required by VMSINSTAL

VMSINSTAL section).

are incorrect (see the Using

VAXELN

Ada

Installation Guide

e¢

The VMS HELP library is currently in use.

The product was registered incorrectly or not registered.

For descriptions of the error messages generated by these conditions, see

the VMS System Messages and Recovery Procedures Reference Volume,

your processor-specific installation/operations guide, or the VMS License
Management Utility Manual.
If you are notified that any of these conditions exist, you should take the
appropriate action as described in the message. You may need to change a

system parameter or increase an authorized quota value.

If the installation fails, you must restart the installation procedure from
step 2.

Installing the VAXELN

Remote Debugger as a Shared Image

If VAXELN Ada will be used extensively on your system, you can reduce
the system overhead and memory requirements by installing the VAXELN
Remote Debugger as a shared image.

First, determine the number of available global pages and global sections
on your system.

See the Installation Procedure Requirements

information on how to do this.

section for

Then, invoke the VMS Install Utility and install the remote debugger as a
shared image by typing the following commands:
$ RU

SYSSSYSTEM: INSTALL

INSTALL>

REPLACE

SYSSSYSTEM:RDBGSRUEBUG.EXE/OPEN

INSTALL>

REPLACE

SYSSSHARE:

_INSTALL>/SHARED/HEADER RESIDENT

INSTALL> EXIT

RDBGSSHARE.EAE/OPEN/SHARED/HEADER RESIDENT

| RETURN

By using the /HEADER_RESIDENT qualifier, you save disk I/O on image
activation (at the expense of a permanently allocated page of memory). By

using the REPLACE command, you guarantee that the installation will
work whether the images are newly installed or were previously installed.

If a file has not been previously installed, you may get a warning message;

however, you can ignore the message because the file wi!l be installed
correctly.

To ensure that the remote debugger is installed as a shared image
each time the system is bootstrapped, include the following lines in
SYS$MANAGER:SYSTARTUP_V5.COM

VAXELN

Ada

Installation Guide

(the site-specific startup file):

S$ INSTALL
:== SINSTALL/COMMAND
MODE
S$ INSTALL
REPLACE SYSSSYSTEM: RDBGSRDEBUG. EXE/OPEN/SHARED/HEADER RESIDENT
REPLACE SYSS$SHARE:RDBGSSHARE.EXE/OPEN/SHARED/HEADER_ RESIDENT
EXIT

Maintenance Updates
Digital may periodically issue maintenance updates of VAXELN Ada.
Each update consists of an installation kit. You should install this kit as
described in this document or in any documentation that may accompany
the maintenance update.
Each time a maintenance update is released, the version number changes.
For example, if the current version is 2.0, the version number of the first
maintenance update will be 2.1. In addition, each maintenance update
includes new release notes. The release notes describe the changes that
have been made to VAXELN Ada since the previous release.
The update release notes are provided on line. You should read the release
notes when you first install VAXELN

Ada; they are also accessible at any

time after the product is installed. For information on reading the release
notes at the time that you install VAXELN Ada, follow the installation
procedure through step 4. After VAXELN Ada is installed, display or print
the file SYS$HELP: VAXELN_ADA02n.RELEASE_NOTES to locate the
release notes (where n is the number of the current maintenance update), or
type the following command:
$ HELP

VAXELN Ada

Release Notes

Determining and Reporting Problems
If an error occurs while you are using VAXELN

Ada and you believe that the

error is caused by a problem with VAXELN Ada, take one of the following
actions:
e

If you purchased VAXELN Ada within the past 90 days and you think
the problem is caused by a software error, you can submit a Software
Performance Report (SPR).

Ifyou have a Basic or DECsupport Software Agreement, you should call
your Customer Support Center. With these services, you receive telephone support that provides high-level advisory and remedial assistance.
For more information, contact your local Digital representative.

Ifyou have a Self-Maintenance

Software Agreement,

Software Performance Report (SPR).

VAXELN

Ada

you can submit a

Installation Guide

If you find an error in the VAXELN Ada documentation, you should fill out
and submit a Reader’s Comments form from the back of the document in

which the error was found.
error was found.

Include the section and page number where the

When you prepare to submit an SPR, please take the following steps:

Describe as accurately as possible the state of the system and the
circumstance when the problem occurred. Include in the description the
version number of VAXELN Ada being used. Demonstrate the problem
with specific examples.

Reduce the problem to as small a size as possible.

Remember to include listings of any command files, relevant data files,
and so on.

Provide a listing of the program.

If the program is longer than 50 lines, submit a copy of the program on
machine-readable media (floppy diskette or magnetic tape). If necessary,
also submit a copy of the program library used to build the application.

Use the VMS Backup Utility to copy the program library to the machinereadable media.
answered.

All media will be returned to you when the SPR is

Report only one problem per SPR. This will facilitate a more rapid
response.

Mail the SPR package to Digital.

Eixperience shows that many SPRs do not contain enough information to
duplicate or identify the problem. Complete and concise information helps
Digital give accurate and timely service to software problems.

Sample Installation
This section contains a sample installation of VAXELN Ada.

Note that

this is only a sample. Sometimes the installation procedure is modified in
maintenance updates of this product. Because this installation guide is not
usually revised for maintenance updates, be sure to read the Read Before

Installing or Using VAXELN Ada letter before you install this product.

This

letter notes any significant changes in the installation that vary from this

sample.

VAXELN

Ada

Installation Guide

S$
S

SET DEFAULT SYSSUPDATE
@VMSINSTAL VAXELN ADAO20
VAX/VMS

25-APR-1989

Enter

* Are

you

The

Software

question

following

17:22.
(?)

Release

Select

* Do

Notes

This

want

Ada

[2]:

continue

the

The

requires
Version

installation

that
5.0

you

want

Checking

for

correct

disk

V2.0

[YES]?

[RETURN]

see

17:23

following

YES

notes

have

been

already

successfully

products

installed:

higher,
and
3.1 or higher.

will

now

space

files

verify

these

products

software

check

completed

for

are

present.

installation.

this

installation

key

registered

[YES]?

[RETURN |

agreements.

VAXELN-ADA

DEC
2.0
15-MAR-1989

that

available

replaced

licensing

have

notes

higher,

Producer:
Version:
Release
Date:

Does this product
loaded? YES

release

prerequsisite

enough

purge

SYSSHELP
or copy release

Procedure

Product:

There are
procedure

system

saveset

installation?

the

procedure

Checking

VAXELN ADA

product

Installation

SVAXELN ADA-S-PREREQ OK,

help.

of your

product’s

VAX Ada Version 2.0 or
VAXELN Toolkit Version
The

V5.0

Options:

V2.0-00

product
VMS

for

Procedure

processed:

Restoring

SVMSINSTAL-I-RELMOVED
moved to SYSSHELP.
VAXELN

time

Display release notes
Print release notes
Both 1 and 2
Copy release notes to
Do not display,
print

option

you

any

installation

SVMSINSTAL-I-RESTORE,

Installation

the backup

will

V2.0

Beginning

1.
2.
3.
4
5

with

products

OPTIONS

Product

mark

satisfied

VAXELN ADA

MUAO:

authorization

no more questions.
The
will take approximately

remainder of
10 minutes.

the

and

installation

VAXELN

Ada

Installation Guide

You

must

VAXELN

reinstall

VAXELN

Ada

you

install

new

saveset

version

the

Toolkit.

SVMSINSTAL-I-RESTORE,

Restoring

Providing

Run-Time

VAXELN

Ada

SVMSINSTAL-I-RESTORE,
Providing

VAXELN

Restoring

Remote

sVMSINSTAL-I-RESTORE,
Providing

IVP

product
Library

images

and

objects.

product

saveset

product

saveset

Debugger.

Restoring

files.

SVMSINSTAL-I-SYSDIR,
This product
VMISROOT: [SYSTEST.VAXELN ADA].
sCREATE-I-EXISTS,

VMISROOT:

Providing

example

program

Providing

HELP

topic

VMSINSTAL

system

[SYSTEST.VAXELN ADA]

disk