Digital PDFs

AA-EV09A-TE

May 1986

34 pages

Original

1.5MB

Document:	VAX LISP/ULTRIX Installation Guide
Order Number:	AA-EV09A-TE
Revision:	000
Pages:	34
Original Filename:

OCR Text

0
VAX LISP/ULTRIX
Installation Guide
Order Number: AA-EV09A-TE

0
May 1986
This document contains instructions for installing VAX LISP
/ULTRIX on the ULTRIX-32 and the ULTRIX-32m operating
systems.

0
Operating System and Version:

ULTRIX-32 Version 1.2
ULTRIX-32m Version 1.2

Software Version:

VAX LISP/ULTRIX Version 2.0

digital equipment corporation
maynard, massachusetts

--·--··---------------------------------------

First Printing, May 1986

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.
All Rights Reserved.

Printed in U.S.A.
A postage-paid READER'S COMMENTS form is included on the last page of
this document.
Your comments will assist us in preparing future
documentation.
The following are trademarks of Digital Equipment Corporation:

DEC
DECUS
MicroVAX
VAXstation
DECnet
ULTRIX-32
ULTRIX-32m

UNIBUS
VAX
MicroVAX II
VAXstation II
ULTRIX

momoomn™

PDP
VMS
MicroVMS
AI VAXstati.on
ULTRIX-11

CONTENTS

0
Page

PREFACE
CHAPTER 1
1.1
1.2
1. 2 .1
1. 2. 2
1. 3

O
0

CHAPTER 2
2.1
2.2
2.3
2.4
2.4.1
2.4.2
2.4.3

CHAPTER 3
3.1
3.2

OAPPENDIX A

PREPARING FOR THE INSTALLATION
VAX LISP NAMING CONVENTIONS
CONTENTS OF THE DISTRIBUTION KIT
Documentation
Components of the VAX LISP/ULTRIX Software
VAX LISP/ULTRIX INSTALLATION PREREQUISITES

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

INSTALLATION AND VERIFICATION
STARTING THE INSTALLATION PRqCEDURE
INSTALLATION PROCEDURE QUESTIONS AND PROMPTS
EXITING THE INSTALLATION PROCEDURE
THREE SAMPLE INSTALLATION PROCEDURES
Sample New Installation for a VAX
Sample Update Installation for a VAX
Sample Update Installation for a MicroVAX

2-1
2-2
2-7
2-8
2-8
2-12
2-15

COMPLETING THE INSTALLATION
CREATING THE FILE LISPSITE.TXT
FORMATTING THE VAXLISP MAN FILE

PROBLEM DETERMINATION AND REPORTING

0
iii

3-1
3-2

0
iv

PREFACE

Manual Objectives
This manual
LISP/ULTRIX.

explains

how

install,

verify,

and

manage

VAX

Intended Audience

If you are responsible for installing and maintaining the VAX
LISP/ULTRIX software product, you should read this manual. To do the
installation, you must have access to the superuser account and be
familiar with ULTRIX-32 installation procedures for layered products.

Structure of This Manual
The manual is divided into three chapters and one appendix:

Chapter 1, Preparing for the Installation, describes the
• prerequisites
for installing and verifying VAX LISP/ULTRIX.
2,
Installation and Verification,
explains
• Chapter
procedure for installing and verifying VAX LISP/ULTRIX.
e

Chapter 3, Completing the Installation,
needed to complete the installation.

•

The Appendix, Problem Determination and Reporting,
to report a defect in the product.

gives

the

information
shows

how

Conventions
Convention

Meaning

In examples, the sharp sign (#) prompt
indicates the root or superuser's account in
multiuser mode. For example:
# sh /etc/install_product

In examples, the percent sign (%) prompt
indicates a C-shell user's account. For
example:

PREFACE

Convention

Meaning

% setenv VAXLISP /usr/lib/vaxlisp/Vl.O
Carriage returns

Except where they are written for emphasis,
carriage returns are implied at the end of a
command line. For example:
Are you satisfied
( y/n) [y] ? y

Red print

In examples,
example:

indicates

with

your

answers

user

input.

For

% setenv VAXLISP '/usr/lp/vaxlisp'
Black print

In examples, indicates system output lines
or prompting characters. For example:

% setenv VAXLISP '/usr/lp/vaxlisp'

Italics

In text, indicates user input.

For example:

Type y
Bold

In text,
example:

indicates

ULTRIX

commands.

For

use the vaxlisp command
command(n)

The numbe'r enclosed in parentheses after a
is
the section number of the
command
ULTRIX-32 Programmer's Manual where that
command is described. For example:
chpt(8)

0
vi

0
CHAPTER 1
PREPARING FOR THE INSTALLATION

Before you install
familiar with:

01.1

the

VAX

LISP/ULTRIX

language,

•

VAX LISP naming conventions

•

Contents of the distribution kit

•

VAX LISP/ULTRIX installation prerequisites

you

should

VAX LISP NAMING CONVENTIONS

VAX LISP is implemented on both the VMS and the ULTRIX-32 operating
systems.
VAX LISP as implemented on the VMS operating system is
formally named VAX LISP/VMS. VAX LISP as implemented on the ULTRIX
operating
system is formally named VAX LISP/ULTRIX.
Both VAX
LISP/ULTRIX and VAX LISP/VMS are the same language· but with some
specific operating system differences. For the differences, see the
VAX LISP/ULTRIX Release Notes. These notes are kept on line in the
auxiliary
directory
(/usr/lib/vaxlisp by default) in the file
vaxlispnnn.mem, where nnn is the VAX LISP version number.

This manual describes VAX LISP/ULTRIX but refers to VAX LISP/ULTRIX as
VAX LISP where practicable.
The VAX LISP language runs on the ULTRIX-32 and the ULTRIX-32m
operating systems.
This manual refers to both operating systems as
ULTRIX except where the operating systems differ.

0
1-1

PREPARING FOR THE INSTALLATION
1.2

CONTENTS OF THE DISTRIBUTION KIT

The VAX LISP/ULTRIX distribution kit contains:
o

The distribution volume (either one 9-track tape or
cartridge tape)

A page for the ULTRIX-32 Programmer's Manual

Four manuals

1.2.1

one

TK50

Documentation

The page for the ULTRIX-32 Programmer's Manual describes the vaxlisp
command and its options.
The four manuals in the VAX LISP/ULTRIX
distribution kit are:
•

COMMON LISP: The Language by Guy Steele

•

VAX LISP/ULTRIX Installation Guide (this manual)

•

VAX LISP/ULTRIX User's Guide

•

VAX LISP/ULTRIX System Access Programming Guide

For information on system installation, utilities, operation, and
management not in the VAX LISP/ULTRIX distribution kit, see the

ULTRIX-32 Programmer's Manual -- Binder 3 -- System Managers.

1.2.2

Components of the VAX LISP/ULTRIX Software

The distribution volume contains the files for the VAX LISP product.
When
you conclude the installation procedure, these files are
installed in your system as follows:
•

The product directory (/usr/bin by default) will
file vaxlisp, the LISP executable image.

contain

•

The auxiliary file
will contain:

directory

(/usr/lib/vaxlisp

the

default)

lispsus.sus

Full development environment for VAX LISP

lispivp.lsp

Installation Verification Procedure

vaxlispnnn.mem

Release notes for VAX LISP, version nnn

1-2

PREPARING FOR THE INSTALLATION

xref-files

0
•

1.3

. Example LISP source files that cross-reference
LISP source code; th~y begin with the prefix
xref.

On ULTRIX-32 (not on ULTRIX-32m), the directory /usr/man/manl
will contain the LISP on-line documentation file vaxlisp.1.

VAX LISP/ULTRIX INSTALLATION PREREQUISITES

Before you begin the installation procedure, make sure you have the
necessary software and documentation, and the following prerequisites:

•

Access to the superuser or root account

•

A valid ULTRIX-32 or ULTRIX-32m operating system configuration
with ULTRIX-32 V1.2 or later
See the SPD for hardware requirements.
supported on MicroVAX I systems.

VAX

LISP

not

• Directories for the VAX LISP files
The procedure asks you for names of directories for the
product. If you select the default directories, the procedure
then creates /usr/lib/vaxlisp (if it does not exist), copies
the auxiliary files into it,' and uses the directory /usr/bin
for the executable file.

To put the VAX LISP product in other directories, enter the
names of those directories at the approp~iate point in the
installation procedure. The procedure will then create the
directories for you.

•

Adequate system disk blocks
The installation of VAX LISP/ULTRIX requires approximately
5200 free 1024-byte blocks on the system disk. After the
installation, approximately 5000 1024-byte blocks are occupied
by the product and auxiliary directories.

•

Adequate virtual memory (dmmin/dmmax)
Two configuration variables, dmmin and dmmax, control the
amount
of virtual memory a process can access.
These
variables can be defined by the system manager in the file
/sys/config/MACHINE where machine is the name you give your
computer; for example, MYVAX.

Using the default values, dmmin=32 and dmmax=1024, the maximum
amount of virtual memory (data and stack space) a process can
1-3

PREPARING FOR THE INSTALLATION
access is approximately 22 megabytes. With the default values
for dmmin and dmmax, you can use up to 35,000 pages (17,500
pages in each dynamic space) to start VAX LISP. VAX LISP by
default uses 6000 pages of dynamic virtual memory.

To change the amount of virtual memory, you have to rebuild
your ULTRIX-32 system image. For rebuilding the system image,
see "Building ULTRIX-32 Systems with Config" in the ULTRIX-32
Programmer's Manual -- Binder 4 -- Reference.

•

Adequate paging/swapping space
You must have an amount of swap space equivalent to the amount
of virtual memory to be allocated.
Use the limit command in the C shell, csh(l), to determine the
system resource limit.
To get enough swapping space on your system, adjust the disk
partitions. See the system maintenance command chpt(8) (added
in ULTRIX-32, Version 1.1) for details.

NOTE
Be careful when changing partitions.
Large
amounts of data can be lost since increasing
the size of one partition decreases the size
of an abutting partition.
•

G/H floating-point emulator
To use floating-point numbers in VAX LISP/ULTRIX, you must
have g/h floating-point hardware or use the g/h floating-point
emulator (the EMULFLT option, provided by ULTRIX-32, Version
1. 2) •

After the installation procedure installs the LISP files,
it
checks your system for g/h floating-point hardware.
If your
system does not have g/h floating-point
hardware,
the
procedure prints a message indicating so~
To install the EMULFLT option, you have to rebuild your
ULTRIX-32 system image. For rebuilding the system image, see
"Building ULTRIX-32 Systems with Config" in the ULTRIX-32
Programmer's Manual
Binder 4 -- System Managers, pages_ 8
through 16. See also Appendix B of the installation.

0
1-4

)

0
CHAPTER 2
INSTALLATION AND VERIFICATION

This chapter describes the procedure for installing and verifying the
VAX LISP product on the ULTRIX operating systems. The procedure is
automated, mostly self-explanatory, and takes
approximately
10
minutes.
You must mount the software distribution volume when
prompted and respond to questions asked during the installation. Most
of the questions can be answered with a YES or a NO. The default
response is enclosed in square brackets ([]). Press the RETURN key if
you want the default response. If you need help, type h or help and
press the RETURN key.

0 2.1

STARTING THE INSTALLATION PROCEDURE

To install VAX LISP/ULTRIX:

Make sure the installation prerequisites in.Section 1.3
been met.

(not echoed)

3. · Invoke the ULTRIX installation procedure:

# sh /etc/install_product

0
2-1

have

INSTALLATION AND VERIFICATION
The procedure responds with:
ULTRIX V1.2 Software Product Installation Procedure

Enter 'h' or 'help' at anytime for help.

2.2

INSTALLATION PROCEDURE QUESTIONS AND PROMPTS

The installation consists of 11 steps with the following questions and
prompts:
1.

Backing up the system disk
The procedure first prompts:
You should back up your system disk before installing
If you answer No to the next
any layered products.
question, the procedure will exit. Would you like to
continue (y/n) [y] ?
If you are satisfied with the backup of your system disk,
type y (or press the RETURN key).
If you are not satisfied,
type n (NO) and provide for a backup at this time.
If you
type n, the procedure ends. When you are ready, start again.

Mounting the media

The procedure next prompts:
Name your type of distribution media (tape or disk)
Because VAX LISP is only available on tape, you
tape in response to this prompt.

must

answer

The procedure continues with:
What is the device special
device [] ?

file

for

the

installation

Since your distribution medium is a tape, you might
/dev/rmtB as the device special file (tape drive).

specify

The next prompt is:
Mount volume 1 of the distribution media on
device and press the RETURN key when ready.

the. named

Place Volume 1 of the distribution media in the device from.
which you are doing the installation, When the volume is
ready for use, press the RETURN key.
2-2

INSTALLATION AND VERIFICATION

Entering the product name
Once the distribution medium is mounted, and you have pressed
the RETURN key, the installation procedure reads the product
name from the distribution volume.
The name (vaxlisp)
is
then displayed on the output device.
Because some distribution volumes contain files for more than
one product, the installation procedure prompts you for the
product you want to install:
Enter the name of the product you would like to install:
Enter vaxlisp. The procedure responds by saying that it will
install VAX LISP/ULTRIX at the current date and time.

Checking disk block numbers and status
The procedure then displays:

•

Number of blocks VAX LISP/ULTRIX requires before and after
installation

•

Default directories
placed

•

Current status of the system disk(s)

which

VAX

LISP/ULTRIX

will

See the example installation procedures in Section 2.4 for a
full example of this display.
After the display,
the
procedure prompts:
Do you wish to continue with the installation(y/n) [y] ?

If you do not have enough blocks to install VAX LISP/ULTRIX,
type n to abort the procedure. Type y to continue. To get
help, type h.
5.

Selecting directories for the product files
library directory

and

creating

After the preceding message, the procedure
names of the installation directories:

prompts

for

a
the

In which directory is vaxlisp to be installed
[/usr/bin] ?

In which directory are the auxiliary vaxlisp files to be
put [/usr/lib/vaxlisp] ?

2-3

----------------------------------

INSTALLATION AND VERIFICATION
Press the RETURN key for the default responses or enter the
names of your directories. The procedure then asks if you
want to create the named auxiliary library directory:

/usr/lib/vaxlisp is not a directory. Do you want it
created? (y/n) [y] ?
If this is your first installation of VAX LISP,
this
directory
will not yet exist.
If this is an update
installation of VAX LISP, this directory will exist.
6.

Saving or deleting previous versions of VAX LISP
If you have a previous version of VAX LISP, you are prompted:
You
currently
have
vaxlisp
on
your
machine.
Installation of the new version will make user-created
suspended systems unuseable.
The current version of
lisp is: xx.x.
The XX.X represents the version number of your current
The next prompt asks:
Do you wish to keep the pr~vious version after
install the new version of vaxlisp (y/n) [n] ?

LISP.
you

Users of VAX LISP can create suspended systems containing
LISP
programs
and data.
These suspended systems are
sensitive to the version of VAX LISP used to create them.
Consequently, suspended systems do not run with versions of
VAX LISP other than the version with which they were created.
To avoid a suspended system that is incompatible with a new
version of VAX LISP, you can save the previous version of VAX
LISP.
So, if you have a previous version of VAX LISP, you
are asked during the installation procedure if you want to
save the previous version of the VAX LISP system.
The files comprising a saved version of VAX LISP are placed
in a directory separate from a new version.
For example,
suppose the current version of VAX LISP is Vl.O, and the VAX
LISP suspended system is stored in /usr/lib/vaxlisp. During
the installation of Vl.1 of VAX LISP, the saved Vl.O VAX LISP
executable
image and the corresponding saved VAX LISP
suspended system are placed in a directory that defaults to a
subdirectory of /usr/lib/vaxlisp; the name of this directory
will be the name of the old version of VAX LISP.
In the
example above,
the old version of VAX LISP is Vl.O, and the
directory na~e would be /usr/lib/vaxlispjVl.O. However, you
are also prompted during the installation if you would like
to override the default directory name.

2-4

INSTALLATION AND VERIFICATION
To use a versipn of VAX LISP that is not stored in
you must:

•

/usr/bin,

Define the environment variable VAXLISP to refer to the
subdirectory containing the VAX LISP executable image and
suspended system. In the preceding example, you would
say:

% setenv VAXLISP /usr/lib/vaxlisp/V1.0
•

Inform ULTRIX where the VAX LISP executable image is
located.
The simplest way to do this is to use a full
directory specification when you invoke the saved version
of VAX LISP. In the preceding example, you would say:

% /usr/lib/vaxlisp/Vl.0/vaxlisp

An alternate way to do this is to redefine your path
environment variable so that the old VAX LISP directory
precedes /usr/bin in that variable.
Again, in
the
previous example, if the environment variable path was:
path=.:/bin:/usr/bin:/usr/local
you could redefine that variable:

% setenv path\
.:/bin:/usr/lib/vaxlisp/Vl.0:/usr/bin:/usr/local
In either case, you use the vaxlisp command to invoke the
old version of the VAX LISP system. Remember, if you
change the path environment variable t~ run a previous
version of VAX LISP, you will have to change it again to
run the current version of VAX LISP.

Verifying the installation or postponing verification
The installation procedure next prompts:
Is your system configured as described in the
Installation Guide (y/n) [y] ?
Would you like to run the IVP after the installation
(y/n) ·[y] ?

If you have properly configured your system (according to the
prerequisites
in
Section
1.3), type y
(YES) to the
configuration question to
run
the
IVP
(Installation
Verification Procedure) at the conclusion of the installation
procedure.

2-5

INSTALLATION AND VERIFICATION
If you type n (NO) to the preceding
questions,
installation is concluded without running the IVP.

the

You can install VAX LISP without properly configuring your
system, but VAX LISP will not run until you have properly
configured your system. You may want only to install VAX
LISP and to configure your system later. Then, when you have
properly configured your system, you can run the IVP by
entering the shell command vaxlispivp.sh. If you have put
the product files in the default directory, that command with
the pathname is:

# /usr/lib/vaxlisp/vaxlispivp.sh

Checking your responses
To verify your decisions,
responses. For example:

the

procedure

summarizes

your

vaxlisp will reside in /usr/bin.
Auxiliary vaxlisp files will reside in /usr/lib/vaxlisp.
The IVP will be run after the installation.
The procedure then ~sks:
Are you satisfied with your answers (y/n) [y] ?
If you type n (NO), the procedure begins again at step 2 of
this section.
If you type y (YES), the procedure copies
(using install(8)) the files (vaxlisp and lispsus.sus) from
the distribution volume into the specified directories.
9.

Checking for g/h floating-point hardware
Next, the procedure checks for g/h floating-point hardware.
If your system has that hardware, no message is displayed.
If your system does not have the hardware, the following
message is displayed:

Your system does not have g and h float instructions.
See Section 1. 3 on
ULTRIX-32.
10.

the

use

float;::ing-point

numbers

Running the IVP
If you have typed y (YES) to the verification question (step
7), the IVP next creates, compiles, and executes a small LISP
program. A message is printed when the program is completed.
If you have typed n (NO) to the verification question, the
installation proceeds without the IVP.

2-6

INSTALLATION AND VERIFICATION
11.

Reviewing the instructions for completing the installation
When VAX LISP/ULTRIX has been installed (with or without the
verification procedure), four reminders on how to complete
the installation are displayed on the output device:
1.

If you have installed this version of VAX LISP/ULTRIX in
some location other than the default one, you must do two
things:
•

Inform ULTRIX where the VAX LISP/ULTRIX executable
image is located. The simplest way to do this is to
modify the variable path. For example:
% set path=(.

•

$HOME/bin /usr/bin /bin /usr/ucb'
/usr/local /usr/lp/vaxlisp)

Define the environment variable VAXLISP to refer to
the directory containing the suspended system. For
example:
% setenv VAXLISP '/usr/lp/vaxlisp'

Make sure you have enough virtual memory
and
equivalent amount of swap/passing space. To do so:
e
•
•

Check the values of dmmin and dmmax in the config
file.
Use the limit csh(l) command to check the amount of
virtual memory.
Use the chpt(8) command to check the swap/paging
space.

If you do not have G/H floating-point hardware, make sure
you have installed the ULTRIX-32 G/H software emulator.

If you would like the formatted version
man file, run catman(8).

See Section 1.3 and Chapter 3
completing the installation.

2.3

for

further

the

vaxlisp

information

EXITING THE INSTALLATION PROCEDURE

At the conclusion of the installation procedure, you are prompted:
Do you want to install another product (y/n) [n] ?

Type y (YES) to start a new installation with the naming
product. Type n (NO) to exit the procedure.
2-7

the

new

INSTALLATION AND VERIFICATION
2.4

THREE SAMPLE INSTALLATION PROCEDURES

The following three sample installation procedures show a
new
installation
and
two
update
installations.
The
first two
installations are on a VAX; the last installation is on a microVAX.

2.4.1

Sample New Installation for a VAX

The following sample is on a system that does not have
g/h
floating-point hardware. Therefore, a message is displayed saying the
system does not have g/h float instructions.
ULTRIX V1.2 Software Product Installation Procedure
Enter 'h' or 'help' at anytime for help.

You should back up your system disk before installing any layered
products. If you answer No to the next question, the procedure will
exit. Would you like to continue (y/n) [y] ? y
Which type of distribution media do you have (tape, disk) [] ? tape
What is the device special file for the installation device [] ?
/dev/rmt8

Mount volume 1 of the installation kit on the device.
Press the RETURN key when ready.
The following products are on this tape:
vaxlisp
Enter the name of the product you would like to install: vaxlisp

Beginning installation of VAX LISP/ULTRIX V2.0 on
Wed May 28 15:37:55 EDT 1986
VAX LISP/ULTRIX requires approximately 5200
blocks during the installation and
5000 blocks after the installation has finished.
By default, this procedure will install VAX LISP/ULTRIX
in the /usr/bin and /usr/lib/vaxlisp directories.

0
2-8

INSTALLATION AND VERIFICATION

Current status of the disks.
clFilesystem
node
/dev/hpOa
/dev/hpOg
/dev/hpla
/dev/hplg
/dev/hplh

total
kbytes

kbytes
used

kbytes
free

7421
136647
7653
309208
142440

4897
49506
3526
185478
23727

1781
73475
3361
92809
104469

percent
used
Mounted on
73%
I
40%
/usr
51%
/installation
67%
/vu
19%
/users

If you do not have enough blocks to install VAX LISP/ULTRIX,
please abort this procedure and restart it when there is
space on the disk(s).
Do you wish to continue with the installation (y/n) [y] ? y
In which directory is vaxlisp to be installed [/usr/bin] ?
O

In which directory are the auxiliary vaxlisp files to be put
[/usr/lib/vaxlisp) ?
/usr/lib/vaxlisp is not a directory.
( y /n)

Do you want it created

[y J ? y

Is your system configured as described in the installation guide
( y /n)

[y J ? y

Owould you like to run the IVP after the in~tallation (y/n) [y] ? y
Summary of user responses to installation questions
vaxlisp will reside in /usr/bin.

auxiliary vaxlisp files will reside in /usr/lib/vaxlisp.
The IVP will be run after the installation.
Are you satisfied with your answers (y/n) [y] ? y

Copying the VAX LISP/ULTRIX tar file off the distribution media
'Breaking the VAX LISP/ULTRIX file into individual files ...
Moving vaxlisp to /usr/bin.
Moving the auxiliary files to /usr/lib/vaxlisp.
oMoving the unformatted man file to /usr/man/manl.

2-9

INSTALLATION AND VERIFICATION
Welcome to VAX LISP, Version V2.0
Your system does not have g and h float instructions.

Running the IVP ...
VAX LISP/ULTRIX Installation Verification Procedure
Welcome to VAX LISP, Version V2.0
Lisp>
Starting compilation of file /usr/lib/vaxlisp/fibonacci.lsp
FIBONACCI compiled.
PRINT-FIBONACCI-TABLE compiled.

Finished compilation of file /usr/lib/vaxlisp/fibonacci.lsp
O Errors, 0 Warnings
A table of the first 20 Fibonacci numbers:
n
0
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

Fibonacci(n)

------------

0
1
1
2
3
5
8
13
21
34
55
89
144
233
377
610
987
1,597
2,584
4,181

VAX LISP/ULTRIX IVP Completed Successfully

0
2-10

INSTALLATION AND VERIFICATION

If this procedure has generated errors,
correct the problems and
re-run the procedure. · If no problems were encountered, then continue
the installation by performing the following steps:
1.

If you have installed this version of VAX LISP/ULTRIX in some
location other than the default one, you must do two-things:
Inform ULTRIX where the VAX LISP/ULTRIX executable image
is located. The simplest way to do this is to modify the
variable path.
For example:

% set path=(.

$HOME/bin /usr/bin /bin /usr/ucb'
/usr/local /usr/lp/vaxlisp)

Define the environment variable VAXLISP to
directory containing the suspended system.

refer to the
For example:

% setenv VAXLISP '/usr/lp/vaxlisp'
2.

Make sure you have enough virtual memory
amount of swap/passing space. To do so:

and

equivalent

Check the values of dmmin and dmmax in the config file.
Use the limit Csh(l)
command to check the amount of
virtual memory.
Use the chpt(8) command to check the swap/paging space.

If you do not have G/H floating-point hardware, make sure you
have installed the ULTRIX-32 G/H software emulator.

If you would like the formatted version of
file, run catman(8).

the

vaxlisp

man

-------------------------------------------------------------------~--

O ---------------------------------------------------------------------Finished installation of VAX LISP/ULTRIX V2.0 on
Tue May 28 ~15:45:50 EDT 1986

Do you want to install another product (y/n)

0
2-11

[n] ? n

INSTALLATION AND VERIFICATION
2.4.2

Sample Update Installation for a VAX

The following sample is on a system that has g/h floating-point()
hardware.
Therefore, no message is displayed concerning g/h float
instructions.
ULTRIX Vl.2 Software Product Installation Procedure
Enter 'h' or 'help' at anytime for help.
You should back up your system disk before installing,any layered
products. If you answer No to the next question, the procedure will
exit. Would you like to continue (y/n) [y] ? y
Which type of distribution media do you have (tape, disk) [] ? tape
What is the device special file for the installation device [] ?
/dev/rmt8

()

Beginning instailation of VAX LISP/ULTRIX V2.0 on
Wed May 28 15:37:55 EDT 1986

---·

------------------------------------------------------------------

VAX LISP/ULTRIX requires approximately 5200
blocks during the installation and
5000 blocks after the installation has finished.

()

By default, this procedure will install VAX LISP/ULTRIX
in the /usr/bin and /usr/lib/vaxlisp directories.
Current status of the disks.
Filesystem
node
/dev/hpOa
/dev/hpOg
/dev/hpla
/dev/hplg
/dev/hplh

total
kbytes
7421
136647
7653
309208
142440

kbytes kbytes
used
free
4897
1781
49506
73475
3526
3361
185478
92809
23727 104469

2-12

percent
used
Mounted on
73%
I
40%
/usr
51%
/installation
67%
/vu
19%
/users

()

INSTALLATION AND VERIFICATION

If you do not have enoµgh blocks to install VAX LISP/ULTRIX,
please abort this procedure and restart it when there is
space on the disk(s).

Do you wish to continue with the installation (y/n) [y] ? y
In which directory is vaxlisp to be installed [/usr/bin] ?
In which directory are the auxiliary vaxlisp files to be put
[/usr/lib/vaxlisp] ?
You currently have vaxlisp on your machine.
Installation of the new version will make user-created
suspended systems unuseable.
The current version of lisp is: Vl.O
Do you wish to keep the previous version after you
install the new version of vaxlisp (y/n) [n] ? n

0 Is your system configured as described in the installation guide
(y/n) [y] ? y
Would you like to run the IVP after the installation (y/n) [y] ? y
Summary of user responses to installation questions

The previous version of vaxlisp will be deleted.
vaxlisp will reside in /usr/bin
auxiliary vaxlisp files will reside in /usr/lib/vaxlisp
The !VP will be run after the installation.

Are you satisfied with your· answers (y/n) [y] ? y

Copying the VAX LISP/ULTRIX tar file off the distribution media
Breaking the VAX LISP/ULTRIX file into individual files ...

Moving vaxlisp to /usr/bin.
Moving the auxiliary files to /usr/lib/vaxlisp.
Moving the unformatted man file to /usr/man/manl.

Welcome to VAX LISP, Version V2.0

2-13

INSTALLATION AND VERIFICATION

Running the IVP ...
VAX LISP/ULTRIX Installation Verification Procedure

Welcome to VAX LISP, Version V2.0
Lisp>
Starting compilation of file /usr/lib/vaxlisp/fibonacci.lsp
FIBONACCI compiled.
PRINT-FIBONACCI-TABLE compiled.
Finished compilation of file /usr/lib/vaxlisp/fibonacci.lsp
O Errors, 0 Warnings
A table of the first 20 Fibonacci numbers:
n

Fibonacci(n)

0
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

0
1
1
2

3
5
8
13
21

55
89
144
233
377
610
987
1,597
2,584
4,181

0
VAX LISP/ULTRIX IVP Completed Successfully

2-14

INSTALLATION AND VERIFICATION
If this procedure has generated errors,
correct the problems and
~-run the procedure.
If no problems were encountered, then continue
he installation by performing the following steps:

If you have installed this version of VAX LISP/ULTRIX in some
location other than the default one, you must do two things:
Inform ULTRIX where the VAX LISP/ULTRIX executable image
is located. The simplest way to do this is to modify the
variable path. For example:

% set path=(.

$HOME/bin /usr/bin /bin /usr/ucb'
/usr/local /usr/lp/vaxlisp)

Define the environment variable VAXLISP to
directory containing the suspended system.

refer to the
For exampl~:

% setenv VAXLISP '/usr/lp/vaxlisp'
2.

Make sure you have enough virtual memory
amount of swap/passing space. To do so:

and

equivalent

Check the values of dmmin and dmmax in the config file.
Use the limit Csh(l) command to check the amount of
virtual memory.
Use the chpt(8) shell command to check the swap/paging
space.

0
3.

If you do not have G/H floating-point hardware, make sure you
have installed the ULTRIX-32 G/H software emulator.

If you would like the formatted version of
file, run catman(8).

the

vaxlisp

man

Do you want to install another product (y/n) [n] ? n
#

2.4.3

Sample Update Installation for a MicroVAX

The following sample is on a system
hardware.
Therefore no message is
instructions.

that has g/h floating-point
displayed concerning g/h float

OaLTRIX Vl.2 Software Product Installation Procedure
2-15

INSTALLATION AND VERIFICATION

Enter 'n' or 'help' at anytime for help.
You should back up your system disk before installing any layered
products. If you answer No to the next question, the procedure will
exit. Would you like to continue {y/n) [y] ? y

Which type of distribution media do you have {tape, disk) [] ? tape
What is the device special file for the installation device [] ?
/dev/rmt8
Mount volume 1 of the installation kit on the device.
Press the RETURN key when ready.
The following products are on this tape:
vaxlisp
Enter the name of the product you would like to install: vaxlisp

By default, this procedure will install VAX LISP/ULTRIX
in the /usr/bin and /usr/lib/vaxlisp directories.
Current status of the disks.
Filesystem
node
/dev/raOa
/dev/raOg
/dev/rala
/dev/ralg

total
kbytes
7447
42003
7447
42003

kbytes
used
4476
22126
5997
9241

kbytes
free
2226
15676
705
28561

percent
Mounted on
used
67%
I
59%
/usr
89%
/va
24%
/vu

INSTALLATION AND VERIFICATION

You currently have vaxlisp on your machine.
installation of the new version will make user-created
suspended systems unuseable.
The current version of lisp is: Vl.O
Do you wish to keep the previous version after you
install the new version of vaxlisp (y/n) [n] ? n
Is your system configured as described in the installation guide
( y /n) [ y J ? y
Would you like to run the IVP after the installation (y/n)

[y] ? y

Summary of user responses to installation questions

The previous version of vaxlisp will be deleted.
vaxlisp will reside in /usr/bin
auxiliary vaxlisp files will reside in /usr/lib/vaxlisp
The IVP will be run after the installation.
Are you satisfied with your answers (y/n) [y] ? y

0
Copying the VAX LISP/ULTRIX tar file off the distribution media
Breaking the VAX LISP/ULTRIX file into individual files

Moving vaxlisp to /usr/bin.
Moving the auxiliary files to /usr/lib/vaxlisp.
Welcome to VAX LISP, Version V2.0
Running the IVP ...
VAX LISP/ULTRIX Installation Verification Procedure
Welcome to VAX LISP, Version V2.0
Lisp>
Starting compilation of file /usr/lib/vaxlisp/fibonacci.lsp

FIBONACCI compiled.
PRINT-FIBONACCI-TABLE compiled.

2-17

INSTALLATION AND VERIFICATION

Finished compilation of file /usr/lib/vaxlisp/fibonacci.lsp

O Errors, 0 Warnings
A table of the first 20 Fibonacci numbers:
n

Fibonacci(n)

0
1
2
3
4

0
1

6
7
8

8
13
21

34
55

1
2

10
11
12
13
14
15
16
17
18
19

89
144
233
377
610
987
1,597
2,584
4,181

0
VAX LISP/ULTRIX IVP Completed Successfully

If this procedure has generated errors,
correct the problems and
re-run the procedure.
If no problems were encountered, then continue
the installation by performing the following steps:
1.

If you have installed this version of VAX LISP/ULTRIX in some
location other than the default one, you must do two things:

Inform ULTRIX where the VAX LISP/ULTRIX executable image
is located.
The simplest way to do this is to modify the
variable path.
For example:

% set path=(.

$HOME/bin /usr/bin /bin /usr/ucb'
/usr/local /usr/lp/vaxlisp)

Define the environment variable VAXLISP to
directory containing the suspended system.

refer to the
For example:

% setenv VAXLISP '/usr/lp/vaxlisp'
2.

Make sure you have enough virtual memory. and
amount of swap/passing space. To do so:
2-18

equivalent

INSTALLATION AND VERIFICATION

Check the values of dmmin and dmmax in the config file.
Use the limit Csh(l)
command to check the amount of
virtual memory.
Use the ·chpt ( 8) shell command to check the swap/paging
space.

0
3.

If you do not have G/H floating-point hardware, make sure you
have installed the ULTRIX-32 G/H software emulator.

If you would like the formatted version of
file, run catman(8).

the

vaxlisp

Finished installation of VAX LISP/ULTRIX V2.0 on
Tue May 28 15:45:50 EDT 1986

Do you want to install another product (y/n)
#

0
2-19

[n] ? n

man

0
CHAPTER 3
COMPLETING THE INSTALLATION

of
VAX
LISP/ULTRIX,
create
a
To complete the installation
a
formatted
version
of
the
vaxlisp
man
site-specific text file and
file.

3.1

CREATING THE FILE LISPSITE.TXT

The file lispsite.txt is a site-specific text file for VAX LISP/ULTRIX
that you may create.
The file should be a description of your
computer site, and you should place the file in the directory
/usr/lib/vaxlisp
or
the
directory
you
specified during the
installation. The first line of the file is used by the COMMON LISP
function SHORT-SITE-NAME. The entire file is used by the COMMON LISP
function LONG-SITE-NAME. The following example illustrates a site
text file:
% cat /usr/lib/vaxlisp/lispsite.txt
Super Widget Development Group
Intelligent Widget Corporation
One First Street
Any Town, Massachusetts 0100-1
%

The next example illustrates how the LISP functions
and LONG-SITE-NAME work on the preceding file:
Lisp> (SHORT-SITE-NAME)
"Super Widget Development Group"
Lisp>

Lisp> (LONG-SITE-NAME)
"Super Widget Development Group
Intelligent Widget Corporation
One First Street
Any Town, Massachusetts 01001

Lisp>
3-1

SHORT-SITE-NAME

COMPLETING THE INSTALLATION
3.2

FORMATTING THE VAXLISP MAN FILE

To format the vaxlisp man file, run catman(8).

For example:

# /etc/catman /usr/man/manl/vaxlisp.1

NOTE
This formatting
ULTRIX-32m.

applies

only

ULTRIX-32,

not

01
0

0
3-2

0
APPENDIX A
PROBLEM DETERMINATION AND REPORTING

If an error occurs while you are using VAX LISP/ULTRIX and you believe
that the error is a result of a defect in the product, you should
report the error to DIGITAL, using a Software Performance Report (SPR)
form.
In particular, an error message preceded by "Internal error:"
is caused by the failure of an internal consistency .check and should
be reported.
Along with the SPR form, you should include:
operating
• The
respectively

system name and
obtain
with
SOFTWARE-VERSION functions.

version, which
you
the
SOFTWARE-TYPE

•

The version number of VAX LISP/ULTRIX, which is
the greeting message when you start up VAX LISP.

•

A complete description of the problem.

•

A listing (reduced to the shortest form possible) of the LISP
program that caused the error.
Include initialization files
or macro definitions that are pertinent.

If possible, use the DRIBBLE function (see COMMON LISP: The
Language) to place the error output in a file and include the
file.

A-1

included

can
and
in