Digital PDFs

AA-Y922E-TE

June 1989

56 pages

Original

18MB

Document:	VAX LISP/VMS Installation Guide
Order Number:	AA-Y922E-TE
Revision:	000
Pages:	56
Original Filename:

OCR Text

VAX LISP/VMS Installation Guide
Order Number: AA-Y922E-TE

This document contains instructions for installing VAX LISP 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 VAX LISP Version 3.0 and all maintenance updates throughout that
version.

Revision/Update Information:

This is a revised manual.

Operating System and Version: VMS Version 5.1
Software Version:

digital equipment corporation
maynard, massachusetts

VAX LISP Version 3.0

First Printing, June 1984
Revised, December 1984
Revised, May 1986
Revised, July 1987
Revised, July 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 1984, 1986, 1987, 1989.
All rights reserved.
Printed in U.S.A.
The postpaid Reader’s Comments form at the end of this document requests your critical
evaluation to assist in preparing future documentation.

The following are trademarks of Digital Equipment Corporation:
AI VAXstation
DEC
DECnet
DECUS
MicroVAX
MicroVAX II
MicroVMS

PDP
ULTRIX
ULTRIX-11
ULTRIX-32
UNIBUS
VAX
VAX LISP

VAX LISP/VMS
VAX LISP/ULTRIX
VAXstation
VAXstation II
VMS

MLO-S843

This document was prepared using VAX DOCUMENT, Version 1.1.

Contents
Preface . . . .

Chapter 1

........................................................................................................................................................................................................................

Preparing to Install VAX LISP

i.i

Prerequisite Software................................................................................................

1-1

1.2

Accessing the Online Release N o te s .....................................................................

1-1

1.3

Installation Procedure Requirements.....................................................................
1.3.1
Calculating the Values for GBLPAGES and GBLSECTIONS.................
1.3.2
Calculating the Values for WSMAX, PQL DWSDEFAULT, and
PROSECTCNT........................................................................................
1.3.3
Changing System Parameter Values with AUTOGEN ..........................

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

1.4

User Account Quotas and Privileges ...............................................................

1-3

1.5

VMS Tailoring C la s s e s .....................................................................................

1-4

1.6

DECwindows Tailoring C lasses ........................................................................

1-4

1.7

VMS License Management Facility ...................................................................

1-4

1.8

Using VMSINSTAL . ...................................................................................................

1-5

Chapter 2
2.1

Chapter 3

Installing VAX LISP
Installing VAX LISP on a VAXcluster ...............................................................

2-6

Completing the Installation

3.1

Modifying the System Startup F ile ...................................................................

3-1

3.2

Modifying the VAX LISP Startup F i l e .....................................................................

3-1

3.3

Defining the LISP System Logical Names ........................................................

3-2

Chapter 4

Using Previous Versions of VAX LISP

Chapter 5

Running the Installation Verification Procedure Separately

Chapter 6

Error Conditions

Chapter 7

Installing VAX LISP as a Shared Image

Chapter 8

Maintenance Updates

Chapter 9

Tuning the AI VAXstation

9.1

Recommended System Parameters...........................................................

9-1

9.2

Recommended Authorization Quotas........................................................

9 -3

Chapter 10

Determining and Reporting Problems

Chapter 11

Sample Installation

Appendix A

Files Added to the System

A.1

LISP$SYSTEM: Directory............................................................................................

A-1

A.2

LISP$EXAMPLES: Directory .....................................................................................

A-1

A.3

LISP$LIBRARY: D irectory..........................................................................................

A -6

A.4

LISP$PCL: Directory...................................................................................................

A -6

A.5

RDBLISP$EXAMPLES: D irectory..............................................................................

A -8

A.6

FOXGLOVE$SYSTEM: Directory................................................................................

A -1 0

A.7

SYS$STARTUP: Directory..........................................................................................

A -1 0

Preface
This document is intended for system managers. It describes how to install VAX
LISP on the VMS operating system. This document applies to VAX LISP Version
3.0 and all maintenance updates in that version. The 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 mainte
nance updates or to reinstall VAX LISP for any other reason.
At the back of this document is a Reader’s Comments form. If you have any
comments about this document, fill out the form and mail it; your comments will
be considered for the next revision of the installation guide.
For more information about installing VAX LISP 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. Text you
type is indicated in red.

Chapter 1

Preparing to Install VAX LISP
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.
Distribution media must be mounted in numerical order. The installation
procedure prompts you to mount the volumes. For more information on how
to mount distribution media, see your processor-specific installation/operations
guide, which also details several options to the installation procedure.

1.1 Prerequisite Software
VAX LISP Version 3.0 requires VMS Version 5.1 or higher.

1.2 Accessing the Online Release Notes
VAX LISP provides online release notes. The prompt to display or print the
release notes during the installation appears in step 3 of the installation
procedure when you invoke VMSINSTAL with the OPTIONS N parameter (the
OPTIONS N parameter is available only with VMS Version 4.4 or higher).
Ib obtain the release notes after the installation, type or print the file
SYS$HELP:LISP030.RELEASE_NOTES.
Online help also directs you to the release notes file. After the installation, type
the following command:
$ HELP LISP RELEASEJNOTES |Return|

1.3 Installation Procedure Requirements
The installation takes approximately 20 to 30 minutes, depending on the type of
media and your system configuration. Before installing VAX LISP, you must have
the following privileges and resources:
•

CMKRNL, WORLD, and SYSNAM privileges

•

A minimum of 95,380 blocks of free disk space during and after installation.
— Saveset A occupies 280 blocks.
— Saveset B occupies 20,200 blocks.
— Saveset C occupies 14,900 blocks.
— Saveset D occupies 37,700 blocks.
Preparing to Install VAX LISP

1-1

Saveset E occupies 22,300 blocks.

•

Eight megabytes of address space

•

A minimum of 25,000 virtual pages (VIRTUALPAGECNT) at installation.
NOTE

You must ensure that your system has the necessary global page and
global section system parameters for the installation. Failure to do so
could cause the DCL tables to be corrupted in some situations.

1.3.1

Calculating the Values for GBLPAGES and GBLSECTIONS
To install and rim VAX LISP, you must set the correct values for the GBLPAGES
and GBLSECTIONS system parameters.
To calculate how many unused global pages and global sections your system has,
perform the following steps:
1. Run the VMS Install Utility (INSTALL) using the following DCL command:
$ INSTALL L I S T /GLOBAL /SUMMARY

The INSTALL utility displays a summary of global pages and global sections
used by your system, as well as the current number of unused global pages.
For example:
S u m m ary o f L o c a l M em ory G l o b a l S e c t i o n s
258 G lo b a l S e c t i o n s U sed ,

2 2 5 8 0 /3 2 4 0

G lo b a l P a g e s U sed /U n u sed

2. Determine if the number of unused pages (3420 in the example) is equal to
or greater than the number you need. If the number of unused pages is less
than the number you need, you must increase the value for GBLPAGES.
3. Note the amount shown for "Global Sections Used" (258 in the example).
4. Run the SYSGEN utility and use the SHOW command to determine the
number of global sections allocated:
$ RUN SYS$SYSTEM: SYSGEN fReturnl
SYSGEN> SHOW GBLSECTIONS |Return 1
P a r a m e t e r Name
GBLSECTIONS

C u rren t

D e fa u lt

512

250

M in im u m Maximum U n i t D y n a m i c
20

4095 S e c ti o n s

5. Subtract the amount shown in the summary (258 in the example) from the
amount allocated. If the difference is less than the number you need, you
must increase the value of the GBLSECTIONS parameter.
Section 1.3.3 describes the procedures for increasing these values as well as
those of other system parameters. Refer to the VMS documentation on system
management and operations for more information.

1.3.2

Calculating the Values for WSMAX, PQL_DWSDEFAULT, and
PROSECTCNT
Tb rim VAX LISP, you must have appropriate values for the WSMAX, PQL_
DWSDEFAULT, and PROSECTCNT system parameters. Inappropriate values
result in the user getting SECTBLFUL (Section table is full) error messages when
tiying to activate a LISP image. There is no hard and fast rule for appropriate

1-2

Preparing to Install VAX LISP

values for these system parameters, but large images or processes that activate
many images require more PSTE space.
You can find further information about these SYSGEN parameters inVAX/VM S
Internals and Data Structures and Introduction to VMS System Services.
Section 1.3.3 describes the procedures for increasing these values.

1.3.3 Changing System Parameter Values with AUTOGEN
You use the AUTOGEN command procedure to change system parameters.
AUTOGEN automatically adjusts values for parameters that are associated with
the ones you reset manually. To change system parameters with AUTOGEN, you
must edit the following file:
SYS$SYSTEM:MODPARAMS.DAT

For example, to change the setting for the WSMAX system parameter, add this
line to the file:
WSMAX = 1 0 2 4

Or for incremental system parameters:
ADD_GBLPAGE S = 2 0 0 0

(Digital recommends using the ADD_x form of system parameter modifier. Avoid
entering absolute values.)
Now, run the AUTOGEN procedure to recalculate your system parameters. Enter
the following command at the DCL prompt:
$ 0SYS$ÜPDATE:AUTOGEN GETDATA REBOOT

AUTOGEN performs an automatic system shutdown and reboots when it has
finished. Rebooting your system makes the new parameter values active. The
/[NOJFEEDBACK qualifier on the AUTOGEN command line could be appropriate
for your system. See the Guide to Setting Up a VMS System manual for more
information.

1.4

User Account Quotas and Privileges
To use VAX LISP, each account must have TMPMBX and NETMBX privileges
and the following requirements:
•

Paging file quota (PGFLQUOTA) 10,500 pages (minimum)

•

Working set size (WSDEF) 200 pages (minimum)

Use the VMS Authorize Utility (AUTHORIZE) to compare the current values of
these quotas with the requirements for VAX LISP. For example, the account used
in the following example is the SYSTEM account:
$ SET DEFAULT SYS$SYSTEM [Rehm?]
$ RUN AUTHORIZE |Return|
UAF> SHOW SYSTEM 1Return|

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

Preparing to Install VAX LISP

1-3

1.5 VMS Tailoring Classes
For version V5.0 or later systems, the following VMS classes are required for full
functionality for VAX LISP:
•

VMS Required Saveset

•

Programming Support

•

Network Support

•

VMS Workstation Support

For more information on VMS classes and tailoring, see the VAX/VMS Operating
System Software Product Description (SPD 25.01.xx).

1.6 DECwindows Tailoring Classes
You can run VAX LISP with a DECwindows interface. DECwindows must be
installed separately from VAX LISP and from the VMS operating system. VAX
LISP can use DECwindows in two modes:
•

Stand-alone execution, running the X ll display server and the client
application on the same machine

•

Remote execution, running the X ll display server and the client application
on different machines

To run VAX LISP with DECwindows in the stand-alone execution mode, the
following DECwindows components must be installed:
•

VMS DECwindows Compute Server

•

VMS DECwindows Device Support

•

VMS DECwindows Programming Support

To run VAX LISP with DECwindows in the remote execution mode, the following
DECwindows components must be installed:
•

On the server machine:
-

•

VMS DECwindows Device Support

On the client machine:
-

VMS DECwindows Compute Server

VMS DECwindows Programming Support

1.7 VMS License Management Facility
The VMS License Management Facility (LMF) became available with Version 5.0
of the VMS operating system. If you are installing VAX LISP on a VMS V5.1 or
later system, you must register your VAX LISP software license. Normally, you
register your VAX LISP license before beginning the installation. This permits
you to run the Installation Verification Procedure (IVP) during the installation,
and to use the software immediately afterwards.

1—4

Preparing to Install VAX LISP

The license registration information you need is contained in the Product
Authorization Key (PAK) that is shipped with VAX LISP. 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 VAX LISP
license and loaded the appropriate authorization key. You must register and load
your license for VAX LISP before you start the installation in order to run the
IVP and use the software.
To register a license under VMS V5.0, first log in to the system manager’s
account, SYSTEM. Choose only one of the following two ways to perform the
registration:
1. Set default to SYS$UPDATE and invoke the VMSLICENSE.COM procedure.
$ SET DEFAULT SYS$UPDATE |Return|
$ 0VMSLICENSE | Return |

When the procedure prompts you for information, respond with data from
your PAK. When it asks you if you want to load the license, respond YES.
When the procedure completes successfully, you see the following message:
DEC VAX L I S P h a s b e e n r e g i s t e r e d .

2. Issue the LICENSE REGISTER command at DCL level with the appropriate
qualifiers that correspond to information on the PAK. (See the VMS License
Management Utility Manual for instructions.) Then activate the license with
the LICENSE LOAD command.
For complete information on using LMF, see VMS License Management Utility
Manual.

1.8 Using VMSINSTAL
After you log in to a privileged account to install VAX LISP, invoke VMSINSTAL,
the command procedure that installs this product. An example of this procedure
is shown in steps 1 and 2 of Chapter 2.
The VMSINSTAL command procedure has the following syntax:
$ §SYS$UPDATE:VMSINSTAL L I S P d d c u :

[OPTIONS N]

You can also type an asterisk (*) in place of LISP. If you are installing from
magnetic tape, you can use the asterisk to save installation time; the asterisk
causes VAX LISP to be installed with a minimum of tape passes. For example,
the first parameter to VMSINSTAL for VAX LISP Version 3.0 could be either
LISP or *.
ddcu:

Represents a device name where the distribution volumes will be mounted for
the VAX LISP 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 VAX LISP. If you do use the console drive, you should replace any media
you removed from the drive. MUGO: is the device name used in 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 pa
rameter, VMSINSTAL does not prompt you to display or print the release notes.

Preparing to Install VAX LISP

1-5

VMSINSTAL permits the use of several other options. For more information on
the other options, see your processor-specific installation/operations guide.
If you do not supply the first two parameters, VMSINSTAL prompts you for the
product and device names. If you wish to be prompted for the product and device
names and to display or print the release notes, type the following:
$ 0SY S$UPDA TE : VMSINSTAL

IReturn!

When you invoke VMSINSTAL, it checks the following:
•

Whether you logged in to a privileged account. Digital recommends that you
install software from the system manager’s account with your default device
and directory set to SYS$UPDATE.

•

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

ASTLM = 24

BIOLM = 18

BYTLM = 18000

DIOLM = 18

ENQLM = 30

FILLM = 20

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.

1-6

Preparing to Install VAX LISP

Chapter 2

Installing VAX LISP
This chapter explains how to use the VMSINSTAL procedure to install VAX LISP
and to verify the installation. The chapter contains excerpts from the installation
procedure and explains 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.
Step 1: Log in to a privileged account and set your default device and directory
to SYS$UPDATE.
| Return |

Step 2: Invoke VMSINSTAL.
REMINDER

If you have not y et registered and loaded a licen se for VAX
LISP, be sure to read Section 1.7 before you start the in stalla
tion.

$ 0VMSINSTAL L I S P MUGO: OPTIONS N [rSu^ I
VAX/VMS S o f t w a r e P r o d u c t I n s t a l l a t i o n
I t i s 2 0 -M A R -1 9 8 9 a t 1 4 : 0 9 .
E n t e r a q u e s t i o n m a rk (?) a t
* A re you s a t i s f i e d

any tim e

P r o c e d u r e V 5 .0

fo r h e lp .

w ith th e backup o f y o u r sy stem d is k

[Y E S ]? | Return|

If you are satisfied with the backup of your system disk, press Return. Otherwise,
type NO and press Return to discontinue the installation.
VMSINSTAL begins installing the kit.
The f o l l o w i n g p r o d u c t s w i l l b e p r o c e s s e d :
VAX L I S P V 3 . 0
B e g in n in g i n s t a l l a t i o n
%VMSINSTAL—I —RESTORE,

o f VAX L I S P V 3 . 0 a t

R e sto rin g p ro d u ct

1 4 :1 0

saveset A ...

Installing VAX LISP

2-1

Step 3: Select a release notes option.

This step applies only if you specified OPTIONS N in step 2.
R e le a s e N o te s O p tio n s :
1.
2.
3.
4.
5.

D isp la y r e le a s e n o te s
P r i n t r e le a s e n o te s
B o th 1 an d 2
Copy r e l e a s e n o t e s t o
Do n o t d i s p l a y , p r i n t

* S e le c t o p tio n

[3]:

SYS$HELP
o r copy r e l e a s e

n o te s

IReturn |

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.
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.
* Q u eu e name

[SYS$PRINT] : IReiurn|

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 VAX LISP release notes are then
copied to SYS$HELP:LISP030.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, this option is selected when the user wants 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 VAX LISP.
Next, VMSINSTAL displays the following prompt:
* Do y o u w a n t t o c o n t i n u e t h e i n s t a l l a t i o n
%VMSINSTAL-I—RELMOVED, T h e p r o d u c t r e l e a s e
m o v e d t o SYS$HELP.

[N ]?:
n o te s

Y IReturn |
have been

su c c e ssfu lly

If you want to continue the installation, type YES and press Return. If you type
NO or press Return, VMSINSTAL discontinues the installation. In either case,
VMSINSTAL moves the release notes to SYS$HELP.
Step 4: Respond to purging previous versions of VAX LISP check.
* Do y o u w a n t t o

p u rg e

file s

r e p l a c e d by t h i s

in s ta lla tio n

[Y E S ]? IReturn |

The directories SYS$HELP, SYS$MANAGER, and SYS$SYSROOT may contain
previous versions of VAX LISP files. These files are replaced during the instal
lation with new files, but the old files are not automatically purged. Purging is
recommended, unless it is necessary to save a LISP "suspended system" built
with a previous version of VAX LISP. In response to the purging prompt, press
Return to purge the files or type NO to keep them.

2-2

Installing VAX LISP

Step 5: Respond to license registration queries.

VAX LISP supports the VMS License Management Facility (LMF). The instal
lation procedure displays license information about your product and then asks
if you have registered and loaded your authorization key for VAX LISP. The
following is an example of such information:
P ro d u ct:
P roducer:
V ersio n :
R e le a se D a te :
* Does t h i s

L ISP
DEC
3 .0
0 1 -M A Y -1 9 8 9

p r o d u c t have an a u t h o r i z a t i o n

key r e g is te r e d

and lo ad ed ?

If you have not registered and loaded your authorization key, you must answer
NO to this question. You have to register and load your product authorization
key to successfully complete the installation. If you have not done so, you should
stop the installation, register and load your product authorization key, and then
restart the installation.
Step 6: Install the VAX LISP product files.
Do y o u w i s h t o
[Y E S ]? !Return |

in sta ll

t h e VAX L I S P p r o d u c t f i l e s

(2 0 ,2 0 0 b lo c k s )

The procedure now asks whether you want to install the product files saveset on
the tape, and displays the size of the saveset. The product files contain everything
you need to rim VAX LISP: the LISP executable image, online documentation
library, and Installation Verification Procedure (IVP). Press the Return key if you
want to install the saveset. Enter NO if you do not.
Step 7: Respond to DECwindows check.
Do y o u w a n t t h e

D E C w ind ow s v e r s i o n

o f VAX L I S P

[Y E S ]?

| Return 1

The procedure now asks whether you want to install the DECwindows version
of VAX LISP. Press the Return key to install the DECwindows version. If you do
not want the DECwindows version, type NO in response to the prompt. Typing
NO gives you the UIS version of VAX LISP. When you press the Return key, the
procedure asks you for the directory where the VAX LISP product files are to be
installed:
I n w h i c h d i r e c t o r y a r e t h e VAX L I S P p r o d u c t
[SYS$COMMON:[VAXLISP]] ? IReturn |

file s

be i n s t a l l e d

You must now tell VMSINSTAL the desired location of the saveset you selected
to install. Press the Return key if you are satisfied with the default directory, or
enter a different location. If the directory you specify does not already exist, the
procedure asks:
D ire c to ry
[Y es]?

SYS$COMMON:[VAXLISP]

does n o t e x is t.

S h o u ld i t

be c re a te d

Step 8: Install the VAX LISP example files.
Do y o u w i s h t o
jReturn]

in sta ll

th e

VAX L I S P e x a m p l e s

(3 7 ,7 0 0 b lo c k s )

[NO]?

The procedure now asks whether you want to install the VAX LISP example
files. These contain some useful VAX LISP utilities and serve as examples of
LISP programming style. The examples include the 5/23/89 version of PCL,
and versions of RdbLISP and Foxglove. PCL is the publicly-available version
of the Common LISP Object System (CLOS). The RdbLISP software provides
an interface layer between Digital’s relational database (Rdb) and VAX LISP.

Installing VAX LISP

2-3

Foxglove is a rapid-prototyping language for developing rule-based expert system
applications. The example files are not required in order to run VAX LISP.
Type YES to install the example files at this time. Type NO or press the Return
key to skip installing the example files. If you choose to install the example files,
the procedure asks you for the name of the directories where the files are to be
installed.
Step 9: Install the VAX LISP system-building library files.
Do y o u w i s h t o i n s t a l l t h e VAX L I S P s y s t e m - b u i l d i n g
l i b r a r y f i l e s ( 2 2 3 0 0 b l o c k s ) [NO] ? | Return |

The VAX LISP System-Building utility enables you to create a LISP system that
is a single executable image. This user-built system can serve as a customized
VAX LISP development environment that can be shared efficiently by multiple
users at the same time or as a delivery vehicle for applications based on VAX
LISP. The system-building library files are not required to run VAX LISP.
Type YES to install the system-building library files at this time. Type NO
or press the Return key to skip installing the files. If you choose to install the
system-building library files, the procedure asks you for a directory.
Step 10: Respond to previous version save check.
Do y o u w a n t t o

save th e p re v io u s v e rs io n

o f VAX L I S P

(1 8 ,1 3 5 b lo c k s )

[NO]?

| Return |

This question does not appear unless a previous version of VAX LISP is already
installed in the default directory.
VAX LISP users can create "suspended systems" that contain LISP programs and
data. A suspended system depends on the version of VAX LISP used to create it.
Since the installation procedure overwrites any previous version of VAX LISP in
the default directory, installing the new version makes user-created suspended
systems unusable. You may want to save your previous versions of VAX LISP so
that users can resume their suspended systems.
To save the previous version of VAX LISP, you can allow the procedure to move it
to another directory before you install the new version in SYS$COMMON:[VAXLISP].
If you do not want to save your previous version, enter NO or press the Return key.
If you want to save it, enter YES. The procedure now asks for a new location for
the previous version of VAX LISP:
In w h ich d i r e c t o r y s h o u ld t h e p r e v i o u s
[SYS$COMMON: [VAXLISP . V 022 ] ] ? | Return |

v e rs io n be saved

Press the Return key if you are satisfied with the default directory, or enter a
different location. (The default directory automatically includes the correct
version number.) Again, if the directory you specify does not already exist, the
procedure asks you if it should be created.
See Chapter 4 of this manual for directions on using the old version of VAX LISP
after you have moved it out of SYS$COMMON:[VAXLISP].
Step 11: Respond to IVP check.
* Do y o u w a n t t o

run th e

IVP a f t e r t h e

in sta lla tio n

[YES] ? | Return|

The IVP runs tests to check whether the installation procedure was successful.
Press Return to rim the IVP after the installation only if you have properly con
figured your system. Because VAX LISP will not run until you have properly

2-4

Installing VAX LISP

configured your system, you cannot run the IVP if you have not already config
ured your system. If you do not want to run the IVP, type NO in response to the
prompt.
Step 12: Read informational messages.

The VAX LISP installation procedure produces a number of informational mes
sages that report on the progress of the installation.
The success of the installation is indicated by the following messages:
%LISP-I-QUESDONE,

T here a r e

%VMSINSTAL-I-RESTORE,

no m ore i n s t a l l a t i o n

R e sto rin g p ro d u ct

q u e stio n s

be answ ered

saveset B ...

%VMSINSTAL-I-MOVEFILES, f i l e s w i l l now b e m o v e d t o
d ire c to rie s...
E x e c u t i n g VAX L I S P s t a r t u p p r o c e d u r e . . .

th e ir

ta rg e t

If the installation procedure is successful, the new or modified files are moved to
their target directories.
The SYS$HELP:HELPLIB.HLB file is updated to include the new version of the
VAX LISP HELP text.
See Appendix A for a complete list of the files added to the system.
If you typed YES in response to the prompt that requests a file purge at step 6,
previous Versions of the VAX LISP files are now purged.
Step 13: Observe the Installation Verification Procedure.

If you chose to run the IVP in step 6, VMSINSTAL now calls the IVP to verify
that VAX LISP was installed successfully.
VAX L IS P I n s t a l l a t i o n V e r i f i c a t i o n
S ta r tin g c o m p ila tio n o f f i l e

P rocedure

(IV P )

VMI$ROOT:[SYSUPD.LISP030]LISPIVP.LSP;1
FIBONNACI c o m p i l e d .
PRINT-FIBONACCI-TABLE c o m p i l e d .

F in ish e d c o m p ila tio n

of file

VMI$ROOT:[SYSUPD.LISP030]LISPIVP.LSP;1
0 E rro rs,

0 W arnings

W e lc o m e t o

VAX L I S P ,

A ta b le

o f th e

VAX L IS P V 3 . 0

first

v e rsio n

3 .0

20 F i b o n a c c i n u m b e r s

IVP C o m p l e t e d S u c c e s s f u l l y

Step 14: End the installation procedure.
In sta lla tio n

o f VAX L I S P V 3 . 0 c o m p l e t e d a t

VMSINSTAL p r o c e d u r e

done a t

$ LOGOUT | Return |
SYSTEM
lo g g ed o u t a t

1 4 :2 3

2 0 -M A R -1 9 8 9 1 4 : 2 5 : 1 0 . 3 2

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.

Installing VAX LISP

2-5

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.

2.1 Installing VAX LISP on a VAXcluster
If you want to run VAX LISP on multiple nodes of a VAXcluster, first check to
see that you have the appropriate software license. Then, follow these steps after
installing VAX LISP:
1. Issue the LICENSE LOAD command to activate the license on each node in
the VAXcluster on which VAX LISP is to be executed as described in the VMS
License Management Utility Manual.
2. Run SYS$MANAGER:LISPSTART.COM on each node of the cluster that has
a software license.
3. To use the product on other nodes in the VAXcluster, you must replace the
version of the DCL tables that is installed on the other VAXcluster nodes. To
do this, perform the following steps:
a. Log in to a node on the cluster.
b. Run INSTALL and enter the following command at the INSTALL>
prompt:
INSTALL> REPLACE SYS$LIBRARY: DCLTABLES. EXE
| Return |

2-6

Installing VAX LISP

Repeat steps a and b for each node of the cluster.

Chapter 3

Completing the Installation
To complete a new installation of VAX LISP, you must modify the sitespecific system startup file, SYS$MANAGER:SYSTARTUP_V5.COM. You
should also modify the default site-specific startup file for VAX LISP,
SYS$STARTUP:LISPSITE.COM. If you are installing VAX LISP on an AI
VAXstation, read Chapter 9 on recommended system parameters and authoriza
tion quotas. Chapter 4 explains how to use a previous version of VAX LISP that
has been moved out of the main directory.

3.1 Modifying the System Startup File
After the installation procedure is concluded, add the following line to your
site-specific system startup file, SYS$MANAGER:SYSTARTUP_V5.COM:
$ @SYS $ COMMON: [SYS$STARTUP] L IS P S T A R T . COM

This command line invokes the VAX LISP system startup procedure every time
you boot your system. The startup procedure defines:
•

The system logical name LISP$SYSTEM to mean the VAX LISP product
directory

•

The logical name LISP$EXAMPLES to mean the examples directory

•

The logical name LISP$PCL to mean the PCL subdirectory

•

The logical name RDBLISP$EXAMPLES to mean the RDBLISP subdirectory

•

The logical name FOXGLOVE$SYSTEM to mean the Foxglove subdirectory

•

The logical name LISP$LIBRARY to mean the library files directory

3.2 Modifying the VAX LISP Startup File
When you boot your VMS system, the file SYS$MANAGER:SYSTARTUP_
V5.COM invokes the LISP command file LISPSTART.COM, which in turn invokes
the file SYS$STARTUP:LISPSITE.COM. This last command file is a default
site-specific startup procedure for VAX LISP.
This file includes default LISP system logical names and default commands for
installing shareable sections. You should modify the logical name definitions to
make them appropriate for your site.

Completing the Installation

3-1

If your VAX LISP system has only one user or if enough global pages are not
available, you may not want to install LISP shareable. The benefit of installing
shareable sections is that multiple users running VAX LISP use only one copy
of the LISP system rather than a separate copy for each user, thereby saving
valuable system resources.
This skeleton LISPSITE.COM file will be installed in SYS$STARTUP, provided
such a file is not already there:
$!
$!
$!

VAX L I S P s i t e - s p e c i f i c s t a r t u p p r o c e d u r e .
T h is p ro c e d u r e i s in v o k e d by t h e l i s p s t a r t p ro c e d u r e .
R em o v e c o m m e n t s a n d a l t e r t h i s f i l e t o s u i t y o u r s i t e .

$
$
$

$!
5!

DEFINE/SYSTEM/EXECUTIVE
DEFINE/SYSTEM/EXECUTIVE
DEFINE/SYSTEM/EXECUTIVE
DEFINE/SYSTEM/EXECUTIVE
DEFINE/SYSTEM/EXECUTIVE

LISP$TIM E_ZONE 0
LISP$DAYLIGHT_SAVING_TIME_P NO
LISP$SHORT_SITE_NAME " ? "
LISP$LONG_SITE_NAME " ? "
LISP$MACHINE_INSTANCE " ? "

$
$

$!
$!
$
$

SET NOON
INSTALL : =$SYS$SYSTEM :INS TALL/ COMMAND_MODE
INSTALL CREATE L IS P $S Y S T E M :L IS P /O P E N /H E A D E R _ R E S ID E N T /SHARED
SET ON
EXIT

You can add to this file any other site-specific commands for starting VAX LISP.
To install your system shareable, delete the comment character (!) from the
beginning of each command between SET NOON and SET ON in the default
LISPSITE.COM file.

3.3 Defining the LISP System Logical Names
The following list describes the LISP system logical names and shows how to
define them.
•

LISP$TIME_ZONE
Define LISP$TIME_ZONE to indicate your local time zone relative to
Greenwich Mean Time (GMT). The value can be an integer or a floating-point
number in the range 0 (inclusive) to 24 (exclusive). Floating-point numbers
are used when an area is not in a full hour time zone and are specified by
format "hour.fraction". To determine your local time zone, consult an atlas.
Examples:
$DEFINE/SYSTEM
$DEFINE/SYSTEM
$DEFINE/SYSTEM
$DEFINE/SYSTEM
$DEFINE/SYSTEM

LISP$TIM E_ZONE
LISP$TIM E_ZONE
LISP$TIM E_ZONE
LISP$TIM E_ZONE
L IS P $T IM E ZONE

4 .5
5
8
1 2 .7 5
23

!N e w fo u n d la n d
!B o s to n
! San F r a n c i s c o
!C h ath am I s l a n d
!M u n i c h

NOTE

This logical name is required.

•

LISP$DAYLIGHT_SAVING_TIME_P
Define LISP$DAYLIGHT_SAVING_TIME_P to specify whether you are on
daylight saving time. The values T, TRUE, YES, and 1 mean YES; the values
F, FALSE, NO and 0 mean NO. You should update this logical name each
time daylight saving time changes.

3-2

Completing the Installation

In the following example, the NO after the logical name means it is not
daylight saving time.
Example:
$ DEFINE/SYSTEM L I S P $DAYLIGHT SAVING TIME P NO

LISP$SHORT_SITE_NAME
Define LISP_SHORT_SITE_NAME to specify a short string that describes
your site. This string is returned by the LISP s h o r t - s i t e - na me function. An
example is "Widget Group".
Example:
$ d e f in e / system/ L I SP $ SHORT_SITE_NAME " W i d g e t G r o u p "

LISP$LONG_SITE_NAME
Define LISP$LONG_SITE_NAME to specify a long string that describes
your site. This string is returned by the LISP l o n g - s i t e - na me function. An
example is "Super Widget Development Group, Widget Corp".
Example:
$ d e f i n e / s y s t e m l i s p $ long_ s i t e _ name" S u p e r W id g et D e v e lo p m e n t G roup,

W id g et C orp"

If you would like the long site name to occupy several lines, you can create
a text file for it. Then, refer to the text file with the logical name. Suppose,
for example, that the file SYS$MANAGER:LISPSITE.TXT contained the
following text:
S u p e r W id g e t D e v e lo p m e n t G roup
I n t e l l i g e n t W id g et C o r p o r a t i o n
O ne F i r s t S t r e e t
A ny T own, M a s s a c h u s e t t s 0 1 0 0 1

You can define LISP$LONG_SITE_NAME by placing an at sign (@) in front of
the name of the text file you created.
Example:
$ DEFINE/SYSTEM LISP$LONG_SITE_NAME" @SYS$STARTUP: L I S P S I T E . TXT"

LISP$MACHINE_INSTANCE
Define LISP$MACHINE_INSTANCE as a string that identifies the specific
computer on which VAX LISP is running. This string is returned by the
LISP-M ACHINE-INSTANCE function. An example is "Super Widget VAX-11/785".
Example:
$ DEFINE/SYSTEM LISP$MACHINE_INSTANCE" S u p e r W id g e t V A X -1 1 /7 8 5 "

If this logical name is not defined and you are running DECnet, your
computer’s node name is used as the machine instance.

Completing the Installation

3-3

In the preceding list of system logical names, the two logical names LISP$TIME_
ZONE and LISP$DAYLIGHT_SAVING_TIME_P are used by the LISP function
GET-DECODED-TIME, which is described in Common LISP: The Language. The VAX
LISP functions s h o r t - s i t e - n a m e , l o n g - s i t e - n a m e , and m a c h i n e - i n s t a n c e are
described in the VAX LISP/VM S Object Reference Manual.

3-4

Completing the Installation

Chapter 4

Using Previous Versions of VAX LISP
By default, the files comprising a saved version of VAX LISP are put in a
subdirectory under the main VAX LISP directory (referred to by the logical name
LISP$SYSTEM). The subdirectory name uses the VAX LISP version number in
the format Yvvu, with vv representing the 2-digit version and u representing
the 1-digit update. For example, Version 2.2 would be saved in the subdirectory
V022.
To run a saved version of VAX LISP, you must define the logical name
LISP$SYSTEM to refer to the subdirectory containing the files of that saved
version. Then use the standard LISP command to invoke the old version of the
LISP system.

Using Previous Versions of VAX LISP

4-1

Chapter 5

Running the Installation Verification Procedure
Separately
The Installation Verification Procedure (TVP) is usually run at installation. If you
want to run the IVP separately to ensure the integrity of installed files if system
problems occur, execute the following command procedure:
$

@SYS$ T E S T : L I S P $ I V P

If the IVP fails for any reason, the following messages are displayed:
T h e VAX L I S P V 3 . 0

In sta lla tio n

% VMSINSTAL-E-IVPFAIL,

V e rific a tio n

P rocedure

T h e IV P f o r VAX L I S P V 3 . 0 h a s

fa ile d .

Running the Installation Verification Procedure Separately

5-1

Chapter 6

Error Conditions
If the installation procedure fails for any reason, a message such as the one
following is displayed:
%VMSINSTAL—E - I N S F A I L ,

The i n s t a l l a t i o n

o f VAX L I S P V 3 .0 h a s

fa ile d .

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

Operating system version is incorrect.

•

Quotas necessary for successful installation are insufficient (see Section 1.3).

•

Process quotas required by VMSINSTAL are incorrect (see Section 1.8).

•

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. If the installation fails due to an IVP failure, contact a Digital field service
representative.

Error Conditions

6-1

Chapter 7

Installing VAX LISP as a Shared Image
If VAX LISP will be used extensively on your system, you can reduce the system
overhead and memory requirements by installing it as a shared image. To
perform the installation on a system that is currently running, use the VMS
Install Utility while you are logged in to a privileged account. If errors occur, see
VMS System Messages and Recovery Procedures Reference Volume.
First, determine the number of available global pages and global sections on your
system. See Section 1.3 for information on how to do this. Installing VAX LISP
as a shared image requires:
•

A minimum of 11,000 free global pages plus the size (in number of disk
blocks) of the file SYS$LIBRARY:DCLTABLES.EXE at installation.

•

A minimum of 4 free global sections at installation. Three global sections are
used after installation.

Then, invoke the VMS Install Utility and install VAX LISP as a shared image by
typing the following commands:
$ RUN SYS$SYSTEM:INSTALL IReturn [
INSTALL> CREATE SYSSSYSTEM: L I S P . EXE/OPEN/SHARED fääwil
INSTALL> EXIT | Return|

Finally, update the system startup file to install VAX LISP. Modify
SYS$STARTUP:LISPSITE.COM by removing the commented lines (See
Section 3.2).

Installing VAX LISP as a Shared Image

7-1

Chapter 8

Maintenance Updates
Digital may periodically issue maintenance updates of VAX LISP. Each update
consists of an installation kit. You should install this kit as described in this
document or in any documentation accompanying the maintenance update.
Each time a maintenance update is released, the version number changes. For
example, if the current version is 3.0, the version number of the first maintenance
update will be 3.1. In addition, each maintenance update includes new release
notes. The release notes describe the changes that have been made to VAX LISP
since the previous release.
The update release notes are provided on line. You should read the release notes
when you first install VAX LISP; 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 VAX LISP, follow the installation procedure through step 5. To
locate the release notes after VAX LISP is installed, display or print the file
SYS$HELP:LISP030.RELEASE_NOTES, or type the following command :
$ HELP L I S P RELEASE_NOTES I Return|

Maintenance Updates

8-1

Chapter 9

Tuning the AI VAXstation
You can tune your AI VAXstation in one of two ways:

9.1

•

By adjusting parameter values in your system parameters file

•

By adjusting authorization quotas in your user accounts

Recommended System Parameters
The following sample MODPARAMS.DAT file is for a typical monochrome AI
VAXstation. The values of these AUTOGEN parameters are recommended for
optimal performance of VAX LISP on an AI VAXstation with 9 megabytes of
memory.

SAMPLE SYS$SYSTEM:MODPARAMS.DAT FILE

S i t e s p e c i f i c AUTOGEN d a t a f i l e .
In a V A X c lu ste r w h ere a
common s y s t e m d i s k i s b e i n g u s e d , t h i s f i l e s h o u l d r e s i d e
i n S Y S $ S P E C I F I C : [S Y S E X E ], n o t a common s y s t e m d i r e c t o r y .
A dd m o d i f i c a t i o n s t h a t y o u w i s h t o m a k e AUTOGEN'S h a r d w a r e
c o n f i g u r a t i o n d a ta , sy ste m p a r a m e te r c a l c u l a t i o n s , and p a g e ,
s w a p , a n d dump f i l e s i z e s t o t h e b o t t o m o f t h i s f i l e .
CHANNELCNT=2048
CTLPAGES=500
SPTREQ=2000
MPW_HILIM IT=2500
MPW W A IT LIM IT =2500

MPW L O L IM IT =500

NPAGEDYN=330000
PAGFILCNT=1
P A G E F IL E = 3 0 0 0 0
PAGEDYN=4000000
PHYSICALPAGES=18432

N um ber o f a l l o w e d c h a n n e l s
U s e d w i t h w o r k s t a t i o n w in d o w s
R e q u ire d num ber o f sy s te m p ag e t a b l e
e n trie s
M o d ifie d p a g e - l i s t s i z e a t w h ich w r i t i n g
to f r e e - l i s t page o ccu rs
W a i t - l i m i t num ber o f p a g e s on th e
m o d ifie d p ag e l i s t ; t h i s num ber m ust
be g r e a te r th a n o r eq u al to th e
MPW_HILIMIT n u m b e r o r a s y s t e m
d e a d lo c k w i l l o c c u r
W ritin g o f th e m o d ified page l i s t sto p s
w hen i t i s l e s s t h a n o r e q u a l t o t h e
MPW_LOLIMIT n u m b e r
S iz e o f t h e n o n -p a g e d d y n am ic p o o l i n
pages
1 p a g e f i l e ; t h e m ax im um n u m b e r o f
page f i l e s t h a t can be i n s t a l l e d
S iz e o f a page f i l e in pages
S iz e o f t h e p a g e d dynam ic p o o l i n p a g e s
9 m e g a b y t e s o f p h y s i c a l m em o ry

Tuning the AI VAXstation

9-1

SWPFILCNT-1
SWAPFILE=8000
WSMAX=12000
WSINC=350

WSDEC=0
VIRTUALPAGECNT=3 0 0 0 0

1 s w a p f i l e ; t h e m ax im um n u m b e r o f
sw ap p in g t h a t can b e i n s t a l l e d
S i z e o f a sw ap f i l e i n p a g e s
Maximum w o r k i n g s e t s i z e
A mount b y w h ic h t h e w o r k i n g s e t o f a
p r o c e s s i s i n c r e a s e d b y AWSA
(A u to m a tic W orking S e t A d ju s tm e n t)
Amount b y w h ic h t h e w o r k in g s e t o f a
p r o c e s s i s d e c r e a s e d b y AWSA
Maximum a m o u n t o f v i r t u a l p a g e s
a p r o c e s s c a n map

The following three values are recommended for a VAXstation II/GPX:
CTLPAGES=850
SPTREQ=2300
NPAGEDYN=4 5 0 0 0 0

U se d w i t h w o r k s t a t i o n w in d o w s
R e q u ire d num ber o f sy s te m p ag e t a b l e
e n trie s
S iz e o f t h e n o n -p a g e d dynam ic p o o l i n
pages

NOTE

These values are only recommended for a 9-megabyte system and
should not be used on systems with less than 9 megabytes of memory.
Using these values on systems with less than 9 megabytes could
prevent your workstation from booting.
The values are valid only for a system that can be characterized as a
single-use system running primarily VAX LISP. Although running only
VAX LISP is not a requirement, these values tune the system to run
VAX LISP efficiently and may have an adverse effect on systems that
heavily use other products concurrently with VAX LISP.
Therefore, you should review the requirements of other products and
evaluate these recommended values in that context.
To adjust your system’s parameter values:
1. Add the preceding values to the file SYS$SYSTEM:MODPARAMS.DAT
2. Reconfigure your system, using the AUTOGEN utility by executing the
command:
@SYS$UPDATE:AUTOGEN SAVPARAMS REBOOT

For details on using the AUTOGEN utility, see your processor-specific installation/operations guide.
Since these parameters are not dynamic, your system will need to be rebooted.
AUTOGEN will perform an automatic shutdown and reboot when it has finished.

9-2

Tuning the AI VAXstation

9.2 Recommended Authorization Quotas
The following are recommended authorization quotas for VAX LISP accounts on
an AI VAXstation:
WSDEFAÜLT:
WSQUOTA:

1024
8000

WSEXTENT:

18000

PGFLQUOTA:

30000

!
!
!
!
!
!
!
!
!
!

D e f a u lt w o rk in g s e t s i z e
L im it f o r t h e am ount o f p h y s i c a l
m e m o ry a u s e r p r o c e s s m ay l o c k
i n t o i t s w o rk in g s e t
A b s o lu te l i m i t on p h y s i c a l
m em o ry t h e s y s t e m a l l o w s t h e
process
Maximum n u m b e r o f p a g e s a u s e r ' s
p r o c e s s can u se in t h e sy ste m
p a g in g f i l e

To adjust these quotas, invoke the Authorize Utility as shown in Section 1.4.

Tuning the AI VAXstation

9-3

Chapter 10

Determining and Reporting Problems
If an error occurs while you are using VAX LISP and you believe that the error is
caused by a problem with VAX LISP, take one of the following actions:
•

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

•

If you 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.

•

If you have a Self-Maintenance Software Agreement, you can submit an SPR.

If you find an error in the VAX LISP documentation, you should fill out and
submit a Reader’s Comments form from the back of the document in which the
error was found. Include the section and page number where the error was
found.

Determining and Reporting Problems

10-1

Chapter 11

Sample Installation
This section contains a sample installation of VAX LISP. 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
VAX LISP letter before you install this product. This letter notes any significant
changes in the installation that vary from this sample.

W e lc o m e t o
U s e rn a m e :
P a s s w o rd :

VAX/VMS V 5 . 1

SYSTEM

W e lc o m e t o VAX/VMS v e r s i o n V 5 . 1 o n n o d e Z
L a s t i n t e r a c t i v e l o g i n o n M o n d a y , 2 0 -M A R -1 9 8 9 1 3 : 4 1
L a s t n o n - i n t e r a c t i v e l o g i n o n F r i d a y , 1 7 -M A R -1 9 8 9 1 6 : 2 8
SYSTEM> 0SYS$UPDATE: VMSINSTAL L I S P : : B I Z E T : [ L I S P . V 3 . K I T ]
VAX/VMS S o f t w a r e P r o d u c t I n s t a l l a t i o n P r o c e d u r e V 5 . 0
I t i s 2 0 -M A R -1 9 8 9 a t 1 4 : 0 9 .
E n t e r a q u e s t i o n m a rk (?) a t a n y t i m e f o r h e l p .
%VMSINSTAL-W-DECNET, Y o u r D E C n e t n e t w o r k i s u p a n d r u n n i n g .
%VMSINSTAL-W-ACTIVE, T h e f o l l o w i n g p r o c e s s e s a r e s t i l l a c t i v e :
N OTES$001D_1*
BATCH_235
LOCAL
EDIT
REMOTE
M A IL _ 2 4 8 2 8
M A IL _ 2 48 3 2
SERVER_0 001

* Do y o u w a n t t o c o n t i n u e a n y w a y [N O ]? YES
* A re you s a t i s f i e d w ith t h e b a c k u p o f y o u r s y s te m d i s k

[Y E S ]?

The f o l l o w i n g p r o d u c t s w i l l b e p r o c e s s e d :
L ISP V 3 .0
B e g i n n i n g i n s t a l l a t i o n o f LISP V 3 .0 a t 1 4 :1 0
%VMSINSTAL-I-RESTORE, R e s t o r i n g p r o d u c t s a v e s e t A . . .
%VMSINSTAL-I-RELMOVED , T h e p r o d u c t ' s r e l e a s e n o t e s h a v e b e e n
s u c c e s s f u l l y m o v e d t o SYS$HELP.
* Do y o u w a n t t o p u r g e f i l e s r e p l a c e d b y t h i s i n s t a l l a t i o n [Y E S ]? NO
P ro d u ct:
L IS P
P roducer:
DEC
V ersio n :
3 .0
R e l e a s e D a t e : 1 -M A Y -1989
* D o e s t h i s p r o d u c t h a v e a n a u t h o r i z a t i o n k e y r e g i s t e r e d a n d l o a d e d ? YES

Sample Installation

11-1

T h e L I S P i n s t a l l a t i o n k i t c o n t a i n s t h e VAX L I S P p r o d u c t f i l e s
( i . e . , t h e f i l e s w h i c h a r e n e e d e d t o r u n VAX L I S P ) , so m e e x a m p l e
f i l e s , a n d so m e s p e c i a l l i b r a r y f i l e s f o r b u i l d i n g c u s t o m i z e d
l i s p sy ste m s.
I t i s p o s s i b l e t o i n s t a l l j u s t VAX L I S P , a n d
n o th in g e ls e .
I t i s a l s o p o s s i b l e t o i n s t a l l j u s t t h e ex am p les,
o r j u s t th e l i b r a r y f i l e s , o r any c o m b in a tio n o f th e s e .
E n t e r YES t o t h i s q u e s t i o n i f y o u w i s h t o i n s t a l l VAX L I S P a t
t h i s tim e .
E n t e r NO t o t h i s q u e s t i o n i f y o u o n l y w i s h t o i n s t a l l
t h e ex am p les a n d /o r l i b r a r y f i l e s a t t h i s tim e .
* Do y o u w i s h t o

in s ta ll

th e

VAX L I S P p r o d u c t f i l e s

(20200 b l o c k s )

[Y E S ]?

VAX L I S P c a n b e i n s t a l l e d w i t h b u i l t - i n c o d e e i t h e r f o r
D E C w in d o w s o r f o r t h e U IS w i n d o w i n g s y s t e m .
(T h e c h o i c e o f
w i n d o w i n g s y s t e m f o r t h e i n s t a l l e d VAX L I S P p r o d u c t d o e s n o t
l i m i t t h e c h o i c e o f w i n d o w i n g s y s t e m f o r c u s t o m - b u i l t VAX L I S P
sy s te m s .)
You s h o u l d s e l e c t t h e w i n d o w i n g s y s t e m w h i c h i s
p re fe rre d a t your s ite .
A n s w e r YES t o t h i s q u e s t i o n t o s e l e c t D E C w in do w s a s y o u r
w in d o w in g s y s te m .
A n s w e r NO t o t h i s q u e s t i o n t o s e l e c t U IS a s
y o u r w in d o w in g s y s te m .
* Do y o u w a n t t h e D E C w indow s v e r s i o n o f VAX L I S P [Y E S ]?
* I n w h i c h d i r e c t o r y a r e t h e VAX L I S P p r o d u c t f i l e s t o b e
[SYSSCOMMON:[VAXLISP]] : DUAO : [M IS C . VAXLISP]

in sta lle d

T h e i n s t a l l a t i o n k i t c o n t a i n s som e u n s u p p o r t e d e x a m p l e l i s p
f i l e s , w h i c h c o n t a i n som e u s e f u l VAX L I S P u t i l i t i e s , a n d w h i c h
a d d i t i o n a l l y s e r v e a s e x a m p l e s o f L ISP p ro g r a m m in g s t y l e .
They
a r e n o t r e q u i r e d i n o r d e r t o r u n VAX L I S P .
I n c l u d e d i n t h e e x a m p l e s a r e t h e 0 5 / 2 3 / 8 9 ( V i c t o r i a Day) v e r s i o n o f
P o r t a b l e Common L o o p s ( P C L ) , t h e p u b l i c l y - a v a i l a b l e i m p l e m e n t a t i o n
o f t h e Common L i s p O b j e c t S y s t e m (C L O S ) .
PCL i s n o r m a l l y i n s t a l l e d
i n i t s own s u b - d i r e c t o r y .
The e x a m p l e s d i r e c t o r y a l s o i n c l u d e s a v e r s i o n o f R dbLISP a n d
F o x g lo v e .
B o t h R d b L I S P a n d F o x g l o v e a r e i n s t a l l e d i n t h e i r own
su b -d ire c to ry .
The R dbLISP s o f t w a r e p r o v i d e s
D i g i t a l 's r e l a t i o n a l d a ta b a se

an i n t e r f a c e l a y e r b e tw e e n
(R db) a n d VAX L IS P /V M S .

F o x g lo v e i s a r a p i d - p r o t o t y p i n g
e x p e r t sy stem a p p l i c a t i o n s .

la n g u a g e

fo r d e v e lo p in g ru le -b a s e d

T h e e x a m p l e s ( i n c l u d i n g PCL, R d b L I S P , a n d F o x g l o v e ) m ay b e i n s t a l l e d
w i t h VAX L I S P , o r m ay b e s k i p p e d .
T h e e x a m p l e s m ay b e i n s t a l l e d a t
a l a t e r tim e , i f t h a t i s p r e f e r r e d .
E n t e r YES t o i n s t a l l t h e e x a m p l e f i l e s ( i n c l u d i n g PCL) a t t h i s
tim e .
E n t e r NO t o s k i p t h e e x a m p l e f i l e s a t t h i s t i m e .
* Do y o u w i s h t o

in s ta ll

t h e VAX L I S P e x a m p l e s

(37 7 0 0 b l o c k s )

[NO]?

* Do y o u w i s h t o i n s t a l l t h e VAX L I S P s y s t e m - b u i l d i n g l i b r a r y f i l e s
( 2 2 3 0 0 b l o c k s ) [NO]?
* Do y o u w a n t t o r u n t h e IVP a f t e r t h e i n s t a l l a t i o n [ Y E S ] ?
% L ISP-I-Q U E SD O N E, T h e r e a r e n o m o r e i n s t a l l a t i o n q u e s t i o n s t o b e a n s w e r e d
%VMSINSTAL-I-RESTORE, R e s t o r i n g p r o d u c t s a v e s e t B . . .
%VMSINSTAL-I-MOVEFILES, F i l e s w i l l now b e m o v e d t o t h e i r t a r g e t
d ire c to rie s...
E x e c u t i n g VAX L I S P s t a r t u p p r o c e d u r e . . .
VAX L I S P

In s ta lla tio n

V e rific a tio n

S ta r ti n g c o m p ila tio n o f f i l e
V M I$ROOT:[SYSUPD. L I S P 0 3 0 ] L I S P I V P . L S P ; 1

11-2

Sample Installation

P ro ced u re

(IV P )

FIBONACCI c o m p i l e d .
PRINT-FIBONACCI-TABLE
c o m p ile d .
F i n i s h e d c o m p i l a t i o n o f f i l e VMI$ROOT:[SYSUPD.LISP030]LISPIVP.LSP;1

0 E rro rs,

0 W arning s

W e lc o m e t o VAX L I S P ,

v e r s i o n V 3 .0

A ta b le

20 F i b o n a c c i n u m b e r s :

of th e

first

F ib o n a c c i(n )

0
1
1

1
2
3
4
5

2
3
5

13
21
34
55
89
144
233
377
610
987
1 ,5 9 7
2 ,5 8 4
4 ,1 8 1

8
9
10
11
12
13
14
15
16
17
18
19

VAX L I S P V 3 . 0
In sta lla tio n

IV P C o m p l e t e d S u c c e s s f u l l y

o f LISP V 3 .0 c o m p l e t e d a t

1 4 :2 3

VMSINSTAL p r o c e d u r e d o n e a t 1 4 : 2 3
SYSTEM> d i r s y s $ s t a r t u p : l i s p s t a r t . com
D ire c to ry

SYS$STARTUP: [SYSMGR]

L IS P S T A R T .C O M ;2
T o ta l o f 1 f i l e .
SYSTEM> l o
SYSTEM
lo g g ed o u t a t

2 0 -M A R -1 9 8 9 1 4 : 2 4 : 4 0 . 3 3

Sample Installation

11-3

Appendix A

Files Added to the System
As a result of the installation procedure, several files are added to your system.

A.1

LISP$SYSTEM: Directory
•

LISP.EXE

•

LISPDOC.TLB

•

SYS$TEST:LISP$IVPCOM

•

LISP$DE CWIND 0 WS.UID

•

LISP$DECWINDOWS.HLB

A.2 LISP$EXAMPLES: Directory
•

ANIMATE. LSP

•

ANIMATE. FAS

•

BASMSG.LSP

•

BLACKBOARD.LSP

•

BLACKBOARD.FAS

•

CHAOS.LSP

•

CHAOS.FAS

•

CLX-EXAMPLES.LSP

•

CLX-EXAMPLES.FAS

•

CLX-HELLOJUNKLSP

•

CLX-HELLOJUNKFAS

•

CLX-HELLOWORLD.LSP

•

CLX-HELLOWORLD.FAS

•

CLX-PUBLIC.LSP

•

CLX-PUBLIC.FAS

•

COBSMG.LSP

Files Added to the System

A-1

•

CRF.LSP

•

CURSORFONT.LSP

•

CURSORFONT.FAS

•

CURSORS.LSP

•

CURSORS.FAS

•

DECW$CURSOR.LSP

•

DECW$CURSOR.FAS

•

DE CW-CALLBACK-STRUCTURES.LSP

•

DE CW-CALLBACK-STRUCTURES.FAS

•

DECW-PUBLIC.LSP

•

DECW-PUBLIC.FAS

•

DECW-README.TXT

•

DISPLAY-BITMAP.LSP

•

DRAGON.LSP

•

DRAGON.FAS

•

DSTDEF.LSP

•

DTK$ROUTINES.LSP

•

DTKDEF.LSP

•

DTKMSG.LSP

•

DTKMSG.FAS

•

DWTAPPL.LSP

•

DWTAPPL.FAS

•

EDINIT.LSP

•

EDINIT.FAS

•

EXAMPLE S .LIST

•

FAS-HEADER.COM

•

FORMSG.LSP

•

GRAPH.LSP

•

GRAPH.FAS

•

HELLOWORLD.COM

•

HELLOWORLD.LSP

•

HELLOWORLD.FAS

•

HELLO WORLD.UID

•

HELLOWORLD.UIL

•

ISAM-DEMO.LSP

•

ISAM-DEMO.FAS

•

ISAM-RMSBLOCKS.LSP

•

ISAM-RMSBLOCKS.FAS

A-2 Files Added to the System

•

ISAM-RMSUTIL.LSP

•

ISAM-RMSUTIL.FAS

•

ISAM-RUN-DEMO.COM

•

ISAM-STARLET.LSP

•

ISAM-STARLET.FAS

•

ISAM-TEST.FDL

•

ISAM.LSP

•

JBCMSG.LSP

•

LBRUSR.LSP

•

LIB$ROUTINES.LSP

•

LIB CLIDEF.LSP

•

LIBCQDEF.LSP

•

LIBDCFDEF.LSP

•

LIBMSG.LSP

•

LK201.LSP

•

LK201.FAS

•

MENU.LSP

•

MENU.FAS

•

MTH$ROUTINES.LSP

•

MTHMSG.LSP

•

OBJFMT.LSP

•

OPCDEF.LSP

•

OPCMSG.LSP

•

OPDEF.LSP

•

OTS$ROUTINES.LSP

•

OTSMSG.LSP

•

PARSE-DISPLAY.LSP

•

PARSE-DISPLAY.FAS

•

PROFILE.LSP

•

PROFILE.FAS

•

PSEUDOSCHEME.LSP

•

PSEUDOSCHEME.FAS

•

PSMMSG.LSP

•

RADAR.LSP

•

RADAR.FAS

•

REBOUND.LSP

•

REBOUND.FAS

•

RECIPE.COM

A-4

•

RECIPE.FAS

•

RECIPE.LSP

•

RECIPE.RUN

•

RECIPE.UID

•

RECIPE.UIL

•

RMSDEF.LSP

•

RMSFALMSG.LSP

•

RMSUSR.LSP

•

SCRDEF.LSP

•

SHRMSG.LSP

•

SIEVE .LSP

•

SIEVE .FAS

•

SMBMSG.LSP

•

SMG$ROUTINES.LSP

•

SMGDEF.LSP

•

SMGMSG.LSP

•

SMGTRMPTR.LSP

•

SRMDEF.LSP

•

SSMSG.LSP

•

STARDE FAE.LSP

•

STARDEFFL.LSP

•

STARDEFMP.LSP

•

STARFEFQZ.LSP

•

STARLET.LSP

•

STR$ROUTINES.LSP

•

STRMSG.LSP

•

WATCH.LSP

•

WATCH.FAS

•

XREF.LSP

•

XREF.FAS

•

XREFANALYZERS .LSP

•

XREFANALYZERS .FAS

•

XREFBUILD.LSP

•

XREFBUILD.FAS

•

XREFCATALOG.LSP

•

XREFCATALOG.FAS

•

XREFCROSSREF.LSP

•

XREFCROSSREF.FAS

Files Added to the System

•

XREFDUMPER.LSP

•

XREFDUMPER.FAS

•

XREFEXAMPLE .LSP

•

XREFEXAMPLE.FAS

•

XREFGRAPH.LSP

•

XREFGRAPH.FAS

•

XREFQUERY.LSP

•

XREFQUERY.FAS

•

XREFRELATIONS.LSP

•

XREFRELATIONS.FAS

•

XREFREPORT.LSP

•

XREFREPORT.FAS

•

XREFSYSTEM.LSP

•

XREFSYSTEM.FAS

•

XREFTOOLS.LSP

•

XREFTOOLS.FAS

•

XREFUSERGUIDE.MEM

•

XREF_READ_ME_1ST.TXT

A.3 LISP$LIBRARY: Directory
•

LISP$FASLIB.TLB

•

LISP$OB JLIB .OLB

•

LISP$BUILD-VAXLISP.EXE

•

LISP$BUILD-VAXLISP. CLD

A.4 LISP$PCL: Directory
•

3-17-88-NOTES.TXT

•

3-19-87-NOTES.TXT

•

4-21-87-NOTES.TXT

•

4-29-87-NOTES.TXT

•

5-22-87-NOTES.TXT

•

8-28-88-NOTES.TXT

•

BOOT.FAS

•

BOOT.LSP

•

BRAID1.FAS
Files Added to the System A -5

A-6

•

BRAID l.LSP

•

COMBIN-TEST.LSP

•

COMBIN.FAS

•

COMBIN.LSP

•

COMPAT.FAS

•

COMPAT.LSP

•

COMPILE-PCL.LOG

•

CONSTRUCT.FAS

•

CONSTRUCT.LSP

•

DCODE-PRE1.FAS

•

DCODE-PRE1.LSP

•

DCODE-PRE2.FAS

•

DCODE-PRE2.LSP

•

DCODE-PRE3.FAS

•

DCODE-PRE3.LSP

•

DCODE-PRE4.FAS

•

DCODE-PRE4.LSP

•

DCODE.FAS

•

DCODE.LSP

•

DEFCLASS.FAS

•

DEFCLASS.LSP

•

DEFS.FAS

•

DEFS.LSP

•

DEFSYS.LSP

•

FIN-V2.LSP

•

FIN.FAS

•

FIN.LSP

•

FIXUP.FAS

•

FIXUP.LSP

•

FSC.FAS

•

FSC.LSP

•

GET-PCL.TXT

•

HIGH.FAS

•

HIGH.LSP

•

INIT.FAS

•

INIT.LSP

•

ITERATE.FAS

•

ITERATE.LSP

Files Added to the System

•

LOW.FAS

•

LOW.LSP

•

MACROS.FAS

•

MACROS.LSP

•

METHODS.FAS

•

METHODS.LSP

•

MKI.FAS

•

MKI.LSP

•

NOTES.TXT

•

PCL-ENV.LSP

•

PKG.FAS

•

PKG.LSP

•

README.TXT

•

SLOTS.FAS

•

SLOTS.LSP

•

STD-CLASS.FAS

•

STD-CLASS.LSP

•

TEST.LSP

•

VAXL-LOW-V2.LSP

•

VAXL-LOW.FAS

•

VAXL-LOW.LSP

•

VECTOR.FAS

•

VECTOR.LSP

•

WALK-V2.LSP

•

WALK. FAS

•

WALK.LSP

A.5 RDBLISP$EXAMPLES: Directory
•

BUILD-RDBLISP.COM

•

DB-HANDLE.LSP

•

DEMO-DATE.LSP

•

DEMO-RDBKEY.LSP

•

DEMO-RESUME .TXT

•

DEMO-SEGMENTED-STRING.LSP

•

DEMO.LSP

•

DSRI.FAS

•

RDBBLR.FAS
Files Added to the System A-7

•

RDBBLR.LSP

•

RDBCONSTANTS.FAS

•

RDBCONSTANTS.LSP

•

RDBDDL.FAS

•

RDBDDL.LSP

•

RDBDML.FAS

•

RDBDML.LSP

•

RDBERRORS.FAS

•

RDBERRORS.LSP

•

RDBLISP-COMPILE.COM

•

RDBLISP-LOAD.LSP

•

RDBLISP-V11.DVI

•

RDBLISP-V11.MEM

•

RDBLISP-V11.TEX

•

RDBLISP-V11-RN.DVI

•

RDBLISP-V11-RN.MEM

•

RDBLISP-V11-KN.TEX

•

RDBLISP.MMS

•

RDBLISP_EXAMPLES.LSP

•

RDBLOAD.LSP

•

RDBMETA.FAS

•

RDBMETA.LSP

•

RDBSUBS.FAS

•

RDBSUBS.LSP

•

RDBUTILITIES.FAS

•

RDBUTILITIES.LSP

•

RDBVARIABLES.FAS

•

RDBVARIABLES.LSP

A.6 FOXGLOVE$SYSTEM: Directory
•

APPLICATION.UID

•

CAR.FOX

•

FACTORIAL.FOX

•

FOXGLOVE.EXE

•

FOXGLOVE.FAS

•

FOXGLOVE. CLD

•

FOXGLOVE.UID

A-8 Files Added to the System

•

FOXGLOVE.HLP

•

READ .ME

•

REFERENCEJVIANUAL.POST

•

REFERENCE_MANUAL.TXT

•

TUTORIAL_LESSON_3 .FOX

•

TUTORIAL_LESSION_4.FOX

•

USERS_GUIDE .POST

•

USERS_GUIDE.TXT

•

WINES.FOX

A.7 SYS$STARTUP: Directory
•

LISPSTART.COM

•

LISPSITE.COM

Rles Added to the System

A-g

HOW TO ORDER ADDITIONAL DOCUMENTATION
F rom

C all

Alaska, Hawaii,
603-884-6660
or New Hampshire
Rest of U.S.A.
and Puerto Rico1

W rite

Digital Equipment Corporation
P.O. Box CS2008
Nashua NH 03061

800-DIGITAL

1P rep a id ord ers from P u e rto Rico, c a ll D ig ita l’s local su b sid ia r y ( 8 0 9 - 7 5 4 - 7 5 7 5 )

Canada

800-267-6219
(for software
documentation)

Digital Equipment of Canada Ltd.
100 Herzberg Road
Kanata, Ontario, Canada K2K 2A6
Attn: Direct Order Desk

613-592-5111
(for hardware
documentation)

Internal orders
(for software
documentation)
Internal orders
(for hardware
documentation)

—
DTN: 234-4323
508-351-4323

Software Supply Business (SSB)
Digital Equipment Corporation
Westminster MA 01473
Publishing & Circulation Services (P&CS)
NR03-1/W3
Digital Equipment Corporation
Northboro MA 01532

Reader’s Comments

VAX LISP/VMS Installation Guide
AA-Y922E-TE

Your comments and suggestions will help us improve the quality of our future documentation. Please note
that this form is for comments on documentation only.
I r a te th is m a n u a l’s:

Accuracy (product works as described)
Completeness (enough information)
Clarity (easy to understand)
Organization (structure of subject matter)
Figures (useful)
Examples (useful)
Index (ability to find topic)
Page layout (easy to find information)

Excellent
□
□
□
□
□
□
□
□

Good
□
□
□
□
□
□
□
□

Fair
□
□
□
□
□
□
□
□

What I like best about this manual:
What I like least about this manual:

I found the following errors in this manual:
Page
Description

My additional comments or suggestions for improving this manual:

Please indicate the type of user/reader that you most nearly represent:
□ Administrative Support
□ Computer Operator
□ Educator/Trainer
□ Programmer/Analyst
□ Sales

□ Scientist/Engineer
□ Software Support
□ System Manager
□ Other (please specify)

Name/Title _______________________________________________ Dept. _____
Company ________________________________________________________ Date
Mailing Address ________________________________________________________
-------------------------------------------------------------------------------------- Phone _____
1 0/87

Poor
□
□
□
□
□
□
□
□

—

Do Not T ear — Fold Here and Tape

MBM

NO POSTAGE
NECESSARY
IF MAILED
IN THE
UNITED STATES

BUSINESS REPLY MAIL
FIRST CLASS PERMIT NO.33 M A Y N A R D MASS.
POSTAGE W IL L BE PAID BY ADDRESSEE

DIGITAL EQUIPMENT CORPORATION
CORPORATE USER PUBLICATIONS
PKO3-1/30D
129 PARKER STREET
MAYNARD, MA 01754-2198

Do Not T ear — Fold Here

Cut Along Dotted Line

— —