Digital PDFs

AA-Y922C-TE

May 1986

36 pages

Original

5.3MB

view download

OCR Version

3.0MB

view download

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

OCR Text

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

May 1986

This document contains instructions for installing VAX LISP/VMS
on the VMS operating systems.

Operating System and Version:

VAX/VMS Version 4.2
MicroVMS Version 4.2

Software Version:

digital equipment corporation
maynard, massachusetts

VAX LISP/VMS Version 2.0

First

Printing,

Revised,

June

1984

December

1984

Revised,

The

information

and

should

Corporation.
for

any

The

software

and

this
be

Equipment

that

appear

may

described

document

wused

construed

Digital

errors

may

not

this

subject

Corporation
in

this

only

assumed

for

the

change
by

assumes

without
Digital

1986

notice

Equipment

responsibility

document.

document

copied

commitment

May

furnished

accordance

under

with

the

license

terms

such

license.

responsibility

equipment

that

affiliated

is
not

supplied

Digital

Equipment

All

reliability

Equipment

postage-paid

READER’'S

document.

Your

Corporation

Rights

Printed

this

software

Corporation

its

COMMENTS

page

1986.

in U.S.A.
form

comments

1984,

Reserved.

will

included

assist

wus

the

last

preparing

documentation.
The

companies.
©

use

Digital

following

are

trademarks

Digital

Equipment

Corporation:

DEC

UNIBUS

PDP

DECUS

VAX

VMS

MicroVAX

VAXstation

DECnet

ULTRIX

ULTRIX-32

ULTRIX-32m

MicroVMS
II

flgflnanfm

VAXstation

ULTRIX-11

future

CONTENTS

Page

PREFACE

DS
W DN

SAVING

VERIFYING THE
TWO

SAMPLE

B
g
S
i

LISP

INSTALLATION

PROCEDURES

STARTUP

LISP

FILE

STARTUP

FILE

Defining the LISP System Logical Names
Installing the Shareable Sections
The Default LISPSITE.COM File
TUNING

THE

VAXSTATION

Recommended

System Parameters
Recommended Authorization Quotas

PROBLEM

DETERMINATION AND

i1i

REPORTING

VAX

SYSTEM

THE

YOy

THE

MODIFYING

INSTALLATION
wwwwww

THE

wwhhNND
DN
W

OF VAX

INSTALLATION

Sample New Installation
Sample Update Installation

W
e
&
e
e
e
e

wwwwWw
W

o
e

PROCEDURE

PREVIOUS VERSIONS

U1 D

S
DS
>

~] O

>
to

NG I NS B NI A8

User Authorization Quotas
Disk Block Quota

COMPLETING

APPENDIX

(KFILSTCNT)

(VIRTUALPAGECNT)

STARTING THE VMSINSTAL

CHAPTER

List

Pages

INSTALLATION AND VERIFICATION

(NS N

CHAPTER

File

Sections

and

(GBLSECTIONS)

Known

S
N

PREREQUISITES

INSTALLATION

directory

will

PREPARING FOR THE INSTALLATION

1.3

VAX/VMS SYSTEM MANAGEMENT

For information on
system
installation,
wutilities,
operation,
and
management
not
contained
in the VAX LISP/VMS documentation, see the
appropriate VMS documentation.
If you are installing VAX LISP on
the
VMS operating system, see the following documents:

VAX/VMS Guide to System Management and Daily Operations

Guide to VAX/VMS Software Installation

VAX/VMS Utilities Reference Volume

For a complete

list of

VAX/VMS

documents,

see

the

VAX/VMS

Master

Index.

If you are

installing VAX LISP on the MicroVMS operating

the MicroVMS User’s Manual.

1.4

system,

see

VAX LISP/VMS INSTALLATION PREREQUISITES

Before you begin the installation procedure, make sure
necessary software, documentation, and prerequisites.

If you have an AI VAXstation,
paramters

see Section 3.3 for

you

have

the

recommended

system

with

VAX/VNMS

and authorization gquotas.

Prerequlsites:

Access

to the system manager’s account

A valid VAX/VMS operating system
vd.2

configuration

later

e A direétory for the vAX LISP files
@

Adequate:

System disk blocks

Global pages

Known

Virtual pages

User authorization quotas

User disk block quota

file

(GBLPAGES)

list

and sections

(KFILSTCNT)

(VIRTUALPAGECNT)

(GBLSECTIONS)

PREPARING

The

following

sections

explain

FOR THE

all

but

INSTALLATION

the

first

two

prerequisites.

NOTE
If

you

modify

any

the

SYSSSYSTEM:MODPARAMS.DAT
the

AUTOGEN

Utility

parameters.

S
Since

these

parameters

need

The

and

using

Guide

the

you

must

your

following

run

system

command:

dynamic,

vyour

AUTOGEN will

when

has

AUTOGEN Utility,

VAX/VMS

see

the

System

not

reboot

parameters,

Utility,

see

Appendix

finished.

System Management

descriptions

system

perform

Chapter

and Daily

the

SYSGEN

VAX/VMS Reference Manual,

Generation

Vol

4C,

directory

into

it.

put

directory

The

the
under

procedure

1installation
the

directory

specity.

1.4.2

System

Disk Blocks

The

installation

blocks

the

12,000

blocks

VAX

LISP/VMS

system
are

disk.

occupied

requires

approximately

After

installation,

the

disk

12,300

free

approximately

containing

the

product

directory.

1.4.3
You

Global

need

Pages

approximately

install

the

need

additional

1install

(with

(GBLPAGES) and Sections (GBLSECTIONS)

the

VAX
the

310

LISP/VMS
4200

global

suspended

LISP/INSTALL

global

image

pages

LISP.EXE
pages

system

command

and

global

make

additional

LISPSUS.SUS

described

1-4

and

Section

sections

shareable.

You

global

section

shareable

section

3.2.2).

PREPARING FOR THE INSTALLATION
(SYSGEN)
You might need to adjust the values of the system generation
before installing LISP.EXE and
GBLSECTIONS
and
GBLPAGES
parameters
LISPSUS.SUS.

To determine the current value of GBLSECTIONS and GBLPAGES

enter

the

commands:

RUN SYSSSYSTEM:SYSGEN

SYSGEN>

SHOW

GBLSECTIONS

SYSGEN>

SHOW

GBLPAGES

Next, you must determine how many global pages and global sections are
in
use on
your
system.
To do so, type CTRL/Z to leave the SYSGEN
the

utility and enter

$
S

INSTALL>

SSYSSSYSTEM:INSTALL /COMMAND_MODE

:==

INSTALL
INSTALL

commands:

LIST/GLOBAL/SUMMARY

These commands display "Global Sections Used" and "Global Pages Used."
subtract them from the values you previously
and
values
these
Take
global
If you do not have adequate
obtained from the SYSGEN utility.
global pages available, you must modify the GBLSECTIONS
and
sections
and/or

parameters.

GBLPAGES

To modify these values edit the file SYSSSYSTEM:MODPARAMS.DAT
3.3.1)

include

the

(Section

lines:

ADD_GBLPAGES=3

ADD GBLSECTIONS=310

if you

plan

install

LISPSUS.SUS:

ADD_GBLPAGES=4

ADD GBLSECTIONS=4510

1.4.4

Known File List (KFILSTCNT)

If VAX LISP is installed on a user disk, you may also need to increase
the

value

the

KFILSTCNT parameter.

To determine the current value of KFILSTCNT, enter the commands:
S

RUN SYSSSYSTEM:SYSGEN

SYSGEN>

SHOW

KFILSTCNT

To mddify the KFILSTCNT wvalue, edit the file
(Section 3.3.1)

to include the line:

ADD KFILSTCNT=1

SYSSSYSTEM: MODPARAMS .DAT

PREPARING

1.4.5
The

Virtual

default

address
be

VAX

LISP

space.

The

must

increase

LISP

the

product

value

16,000

User’s

INSTALLATION

Pages (VIRTUALPAGECNT)

approximately

value

FOR THE

requires

the

virtual

larger

1if

size

the

Guide

for

pages

you want

LISP

approximately

SYSGEN
for
to

system’s

description

parameter

VAX

use

LISP

the

dynamic

the

eight

megabytes

VIRTUALPAGECNT

must

This

execute.

LISP/MEMORY
memory

LISP/MEMORY

command

the

VAX

(see

command).

NOTE
If

you

increase

need

can

display

the

DCL

determine

the

virtual

1increase

statistics

command

the

page

size
on

you

may

your

paging

file.

paging

file

your

count,

also

You

usage

with

SHOW MEMORY.

current

value

VIRTUALPAGECNT,

enter

the

commands:

S RUN SYSSSYSTEM:SYSGEN
SYSGEN>

modify

3.3.1)

SHOW VIRTUALPAGECNT

these

values

include

the

edit

the

file

SYSSSYSTEM:MODPARAMS.DAT

(Section

VAX

LISP

adequate

line:

VIRTUALPAGECNT=20000

1.4.6

User Authorization

Quotas

The

system manager’s

account

and

user

authorization

quotas

for

these

quotas

utility.

(PGFLQUOTA,

invoke

paging

WSQUOTA,

the

wusers

files

and WSEXTENT)

AUTHORIZE

wutility,

must

and

have

working

sets.

the

AUTHORIZE

specify

the

following

commands:

$ SET DEFAULT SYSSSYSTEM
S RUN AUTHOR
UAF>

NOTE
If

the

quota

system manager

(this

changes

includes

the

the AUTHORIZE utility,
the

leave

the

user

logs

AUTHORIZE

out

utility,

wuser

authorization

system manager’s

the

quota

system and

type

1-6

EXIT

Set

by using

guota)

not

changed

then

logs

CTRL/Z.

with

until

back

in.

PREPARING FOR THE INSTALLATION

Paging

file

quota

(PGFLQUOTA)

A VAX LISP user requires a minimum paging file quota of 10,500
pages.
However,
this
quota must be larger 1f users want to
use the LISP/MEMORY command to increase the size of
the
LISP
system’s
dynamic memory.
See the VAX LISP User’s Guide for a
description of the LISP/MEMORY command.

You can use the following format to

change

the

paging

file

quota:

UAF> MODIFY user-name /PGFLQUOTA=value
Example:

UAF> MODIFY JONES /PGFLQUOTA=20000

Working

set

quota

(WSQUOTA)

The amount of physical
memory
program
is
highly
dependent

required
to
execute
on
the nature of the

a
LISP
program.

doing
user
LISP
each
that
recommends
However, DIGITAL
development work has a minimum working set quota of 1500 pages
to
format
following
the
use
can
You
of physical memory.
change

this

quota:

UAF> MODIFY user-name /WSQUOTA=value
Example:

UAF> MODIFY JONES /WSQUOTA=1500

Working

set

extent

quota

(WSEXTENT)

this
Increasing
You may want to adjust your WSEXTENT quota.
quota increase the amount of physical memory the system allows
You
your process when the system has an excess of free pages.
can use the

following format to change this quota:

UAF> MODIFY user-name /WSEXTENT=value
Example:

UAF> MODIFY JONES

/WSEXTENT=10000

PREPARING

1.4.7

FOR THE

INSTALLATION

Disk Block Quota

VAX LISP provides a
facility
that
enables
wusers
to
suspend
LISP
operation
and continue it later (see the VAX LISP User’s Guide for an
explanation of suspended systems).
Since
a
suspended
LISP
system
regquires
a
large
amount
o0f
disk
space,
wusers
may be asking for
increases in their disk quotas.
You can change these gquotas with
the
DISKQUOTA utility.
To enter that utility, type the command:
S RUN

SYSSSYSTEM:DISKQUOTA

DISKQ>

the

leave

the

DISKQUOTA utility,

use

the

type

EXIT

following

CTRL/Z.

format

quota:

DISKQ>

MODIFY

uic

[/PERMQUOTA=quota]

[ /OVERDRAFT=quota-plus]
Example:

DISKQ> MODIFY

[300,211]

/PERMQUOTA=20000

When you

change

are

user

1in

disk

CHAPTER 2

INSTALLATION AND VERIFICATION

Use the VMSINSTAL procedure to install and verify the VAX LISP product
on
the
VAX/VMS
or MicroVMS operating system.
This chapter explains
how to use the VMSINSTAL procedure to
install
VAX
LISP/VMS
and
to
verify
the installation.
For a detailed description of the VMSINSTAL
procedure, see the Guide to VAX/VMS Software Installation.
Any system user who has

access

the

system manager's

account

an
account
that
has
the
same
privileges
as the system manager’s
account can perform the installation procedure.

The VMSINSTAL procedure
1is
automated,
self-explanatory,
and
takes
approximately
15
minutes to complete.
The procedure requires you to
mount the software distribution volume when prompted and to respond to
questions asked during the installation.
Most of the questions can be
answered with a YES or a NO.
The
default
response
1is
enclosed
in
square brackets ([ ]).
To choose the default response, just press the
RETURN key or enter your response and press the RETURN
key.
If
vyou
need
help
with
a
question,
type a gquestion mark (?) and press the
RETURN

2.1
To

key.

STARTING THE VMSINSTAL PROCEDURE
start

the VMSINSTAL procedure:

Section
in
1listed
Make sure the installation prerequisites
Software
VAX/VMS
to
Guide
The
met.
been
have
1.4
Installation describes all the VMSINSTAL prerequisites.
N

Log

into

the

system manager’s

account.

Installations are usually done from the console terminal.

INSTALLATION AND VERIFICATION

you

sure
in

have

Section

that

have

you

version

edited your

3.2.2.

Pay

the

VAX

particular

section.

Invoke

LISP

installed,

LISPSITE.COM procedure
attention

make

described

the

notes

VMSINSTAL

procedure

wusing

the

following

command
:

$
In

@SYSSUPDATE:VMSINSTAL LISP device

the

preceding

which

vyou

command,

must

examples

a device

name,

device

mount

device

the

names

type

are

colon

VAX

MTAQ0

(:)

the

name

LISP

and

DUAl.

after

the

device

distribution

the

When you

name.

For

volume;

specify

example:

$ @SYSSUPDATE:VMSINSTAL LISP MTAOQ:
After

you

type

messages,
on your

the

output

preceding
the

Enter

question mark

(?) at

satisfied with

the

you

Respond

the

backup of

key).

1If

Product

the

time,

following

are

displayed

are

not

time

for

backup

your

the

Guide

you

NO,

the

procedure

you

type

satisfied,

(see

Procedure

any

system disk,

backup

type

and

Installation

backup question.

your

you

date

device:

Software

information,

current

VAX/VMS

Are
5.

along with

help.
system disk

are

YES

(or

and

type

[YES]?

satisfied

press

the

provide

with

RETURN
for

VAX/VMS

Software

Installation).

ends.

When you

are

ready,

a
1If

start

again.

you

have

typed

installation

2.2

(or

pressed

the

RETURN

key),

the

SAVING PREVIOUS VERSIONS OF VAX LISP

Users of
programs
version
not
To

YES

starts.

VAX
and
of

VAX

usually
avoid

with

VAX

LISP.

asked

LISP
data.
LISP

run with

the

can create
suspended
systems
These
suspended
systems
are
used

later

create

them.

versions

problem

having

new version

VAX

Consequently,
you want

save

suspended

LISP,

during
the

VAX

you

the

can

Thus,

suspended

systems

LISP.
system

save

the

installation

containing
LISP
sensitive to the

version

that

incompatible

version

procedure,

you

are

the VAX

LISP

system.

INSTALLATION AND VERIFICATION

The files comprising a
saved
version
of
VAX
LISP
are
put
1in
a
subdirectory
under
the
main
VAX LISP directory (referred to by the
logical name LISPSSYSTEM).
The subdirectory name uses
the
VAX
LISP
version
number
in
the format Vvvu, with vv representing the 2-digit
version and u representing the 1-digit update.
For
example,
Version
2.0 would be saved in the subdirectory V020.

To run a saved version of VAX LISP, you must define the
1logical
name
LISPSSYSTEM
to
refer
to
the
subdirectory
containing
that
saved
version’s files.
Then, use the standard LISP command
to
1invoke
the
old

version

the

LISP

system.

2.3

VERIFYING THE INSTALLATION

During the installation, the VMSINSTAL
procedure
asks
1if
you
have
properly
configured
your system (according to the prerequisites that
are listed in Section 1.4).
If
vyou
have
properly
configured
your
system,
type YES in response to the preceding question.
The IVP then
creates, compiles, and executes a small LISP program.
A
message
18
printed
when
the
program
is completed, and the VMSINSTAL procedure
automatically

ends.

If
you
reply
NO
installation
is
Verification

to
the
preceding
installation
question,
the
concluded
without
running
the
Installation

Procedure

(IVP).

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 only want 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 following DCL command:

@LISPSSYSTEM:LISPIVP

INSTALLATION AND VERIFICATION

2.4

TWO SAMPLE INSTALLATION PROCEDURES

Two

sample

installation procedures

installation,

2.4.1

and

the

second

follow.

The

an update

first

o0of

new

installation.

Sample New Installation

This

example

Version

1.2

illustrates
of

VAX

new

1installation

when

you

not

have

LISP/VMS.

LISP MSAOQ:
$ @SYSSUPDATE:VMSINSTAL
VAX/VMS

28-APR-1986

Enter

you

Are

The

Software

(?)

satisfied with

the

products

will

Procedure

V4.4

any

time

backup

for

help.

your

system disk

[YES]?

YES

processed:

V2.0

Beginning
*VMSINSTAL-I-RESTORE,
*

Installation

10:24.

question mark

following

LISP

Product

In which

directory

installation
Restoring

is VAX

LISP V2.0

product

LISP

10:24

saveset A...
installed

[SYS$SSYSROOT:[VAXLISP]]:

SYSSCOMMON:
[ VAXLISP)

directory

SYSSCOMMON:[VAXLISP]

$VMSINSTAL-I-SYSDISK,

This

product

correct

creates

[YES]? YES

system disk

directory

SYSSCOMMON: [VAXLISP].
*

your

[YES]?

system configured

described

the

Installation Guide

YES

SVMSINSTAL-I-SYSDISK,

This

product

creates

system disk

directory

SYSSCOMMON: [VAXLISP.EXAMPLES].

$LISP-I-RELNOTES, The release notes are in SYSSHELP:LISP020.RELEASE_NOTES.
$LISP-I-SITESTART, A skeleton site-specific startup procedure, LISPSITE.COM,
-LISP-I-SITESTART, has been provided in SYSSMANAGER.
YVMSINSTAL-I-MOVEFILES,

Files

will

now be

moved

their

target

directories...

Executing VAX

LISP

startup

VAX

LISP

Installation Verification

Starting

compilation of

procedure...

file

Procedure

(IVP)

VMISROOT:[SYSUPD.LISP020]JLISPIVP.LSP;1

2-4

INSTALLATION AND VERIFICATION

FIBONACCI

compiled.

PRINT-FIBONACCI-TABLE

Finished
0

compilation

Errors,

compiled.

file VMISROOT:[SYSUPD.LISP020]LISPIVP.LSP;1

Warnings

Welcome

to VAX

LISP,

version V2.0

first

table
n

the

Fibonacci

numbers:

Fibonacci(n)

144

233

377

610

987

1,597

2,584

4,181

VAX LISP V2.0

IVP Completed Successfully

Installation of LISP V2.0

completed at

VMSINSTAL procedure done

2.4.2

10:29

at 10:29

Sample Update Installation

This example illustrates a new installation when you have Version
of VAX

LISP/VMS.

S @SYSSUPDATE:VMSINSTAL LISP MSAOQ:

2-5

1.2

INSTALLATION AND VERIFICATION

VAX/VMS

Software

Product

Installation

It 1s
Enter

28-APR-1986 at 08:34.
a question mark (?) at

any

you

backup of

Are

The

satisfied with

the

following products will

LISP

time

for

help.

your

$VMSINSTAL-I-RESTORE,

*
*

Do you want
Do you want

[NO]?
[YES]?

YES

processed:

installation
Restoring

LISP V2.0

product

08:34

saveset A...

to purge files replaced by this installation [YES]? YES
to save the previous version of VAX LISP (8037 blocks)

system confiqured as

described

the

Installation Guide

YES

$LISP-I-RELNOTES,

The

release notes are

in SYSSHELP:LISP020.RELEASE_NOTES.

$VMSINSTAL-I-MOVEFILES, Files will now be
directories...
|
Executing VAX LISP startup procedure...
VAX LISP

Starting

compilation of

FIBONACCI

Finished

moved

Installation Verification

their

Procedure

target

(IVP)

file VMISROOT:[SYSUPD.LISP020]LISPIVP.LSP;1

compiled.

PRINT-FIBONACCI-TABLE

compiled.

compilation of

Errors,

file VMISROOT:[SYSUPD.LISPO20]LISPIVP.LSP;1

Warnings

Welcome

to VAX

LISP,

version V2.0

first

[YES]?

your

table

system disk

V2.0

Beginning

Procedure V4.4

the

Fibonacci
(n)

Fibonacci

numbers:

INSTALLATION AND VERIFICATION

55
89
144

233
377

610
987
1,597

2,584

4,181

VAX

LISP V2.0

Installation

VMSINSTAL

IVP Completed
LISP V2.0

Successfully

completed at

procedure done

08:38

CHAPTER 3

COMPLETING THE INSTALLATION

complete

new

site-specific
You

should

installation

system

startup

VAX

file,

LISP/VMS,

you

must

modify

the

SYSSMANAGER:SYSTARTUP.COM.

also:

Modify the default site-specific startup file

for

VAX

LISP,

SYSSMANAGER:LISPSITE.COM.

Read
Section
authorization

3.3

recommended
system
parameters
and
you are installing VAX LISP on an Al

quotas

VAXstation.

3.1

MODIFYING THE SYSTEM STARTUP FILE

After

the

to your

installation

site-specific

procedure

concluded,

system startup file,

add

the

following

line

SYSSMANAGER:SYSTARTUP.COM:

$ @SYSSMANAGER:LISPSTART
This

time
name

command

vyou

line

boot

your
to

LISPSSYSTEM

defines

the

invokes

the

VAX

LISP

system

startup

procedure

system.
This procedure defines the
refer
to
the
VAX
LISP
product

1logical

name

LISPSEXAMPLES

refer

system

each

logical
and

directory

the

examples

directory.

3.2

MODIFYING THE VAX LISP STARTUP FILE

When you boot your VAX/VMS
invokes

file

the

LISP

command

system,

file

SYSSMANAGER:LISPSITE.COM.

site-specific

the

file

LISPSTART.COM,

startup procedure

This

for

last

SYSSMANAGER:SYSTARTUP.COM
which

command

VAX LISP.

file

turn

1is

invokes

the

default

COMPLETING THE INSTALLATION

Included in this file
are
default
LISP
system
logical
names
and
You should modify
default commands for installing shareable sections.
the logical name definitions to make them appropriate for your site.
If your VAX LISP system has only one user or if you do not have enough
global
pages
available,
you may not want to install LISP shareable.
The benefit of installing shareable sections is
that
multiple
wusers
one copy of the LISP system rather than
only
use
LISP
running VAX
separate

copies

(one

for

each user).

(!)
character
comment
the
To install your system shareable, delete
from
the beginning of each command between SET NOON and SET ON 1in the
default

LISPSITE.COM

file.

You can add to this file any other site-specific commands for starting
up

VAX

LISP.

Defining the LISP System Logical Names

3.2.1

The following list describes the LISP system logical names
how

define

and

shows

them.

LISPSTIME_ZONE

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

atlas.

Examples:

$ DEFINE/SYSTEM/EXECUTIVE LISPSTIME_ZONE 4.5
$ DEFINE/SYSTEM/EXECUTIVE LISPSTIME_ZONE 5

$ DEFINE/SYSTEM/EXECUTIVE LISPSTIME_ZONE 8
$ DEFINE/SYSTEM/EXECUTIVE LISPSTIME_ZONE 12.75
$ DEFINE/SYSTEM/EXECUTIVE LISPSTIME_ZONE 23

3-2

Boston

! San Francisco
! Chatham Island
t Munich

NOTE

This logical name

Newfoundland

is not optional.

COMPLETING THE INSTALLATION

LISPSDAYLIGHT_SAVING_TIME_P

Define LISPSDAYLIGHT_ _SAVING_TIME_P to specify whether you
are
on
daylight saving time.
The values T, TRUE, YES, and 1 mean
yes; any other values mean no.
You should update this logical
name each time daylight saving time

In the following example,
it

is not daylight

Example:

changes.

the NO after the logical name

saving time.

means

DEFINE/SYSTEM/EXECUTIVE LISPSDAYLIGHT SAVING_TIME_P NO

LISPSSHORT_ SITE_NAME

Define LISPSSHORT
SITE _NAME to specify
a
short
string
that
1is returned by the LISP
string
This
site.
your
describes
An example is "Widget Group."
SHORT-SITE-NAME function.
Example:

$ DEFINE/SYSTEM/EXECUTIVE LISPSSHORT_SITE_NAME "Widget Group"

LISPSLONG_SITE_NAME

Define LISPSLONG_SITE_NAME
to
specify
a
1long
string
that
1is returned by the LISP
string
This
site.
your
describes
Widget
"Super
is
example
An
function.
LONG-SITE-NAME
Development Group,

Example:

Widget Corp."

S DEFINE/SYSTEM/EXECUTIVE LISPSLONG_SITE_NAME "Super Widget Development Group, Widget Corp."

If you would like the long site name to occupy multiple lines,
Then, refer
can create a text file containing the lines.
you
Suppose, for example,
to the text file with the logical name.
that the file SYSSMANAGER:LISPSITE.TXT contained the following
text:

Super Widget Development Group
Intelligent Widget Corporation
One

First

Any Town,

Street

Massachusetts

01001

You can define LISPSLONG_SITE_NAME by placing an at
before the name of the text file you created.
Example:

sign

$ DEFINE/SYSTEM/EXECUTIVE LISPSLONG_SITE_NAME "E@SYSSMANAGER:LISPSITE.TXT"

(@)

COMPLETING THE

INSTALLATION

LISPSMACHINE_INSTANCE
Define
the

LISPSMACHINE_INSTANCE

specific

string

example

computer

returned

1is

Example:

"Super
S

this

the

which

LISP

Widget

logical
your

that

LISP

MACHINE-INSTANCE

identifies

running.

This

function.

VAX-11/785."

Widget

name

string
VAX

DEFINE/SYSTEM/EXECUTIVE

"Super

DECnet,

LISPSMACHINE_INSTANCE

VAX-11/785"

1is

not

computer’s

defined

node

and

vyou

are

running

name

used

the

machine

names,

the

two

1logical

instance.

the

preceding

LISPSTIME_ZONE
function

list

and

system

LISPSDAYLIGHT_SAVING_TIME_P

GET-DECODED-TIME,

Language.

The

which

functions

MACHINE-INSTANCE

logical

are

described

SHORT-SITE-NAME,

described

the

3.2.2

Installing the Shareable Sections

have

you

install
or

delete

install

You

need

image
If

than

shareable

user

The

the

following

sections

and

the

used

COMMON

LISP

User’s

Guide.

VAX

LISP

system,

you

explanation
of

LISP
The

LONG-SITE-NAME,

VAX

amount

the
LISP:

shows

global

and

may want

how

pages

install

you

need

them.

approximately

LISP.EXE.

you

one

shareable.

are
in

names

You

install

1it,

read-only

section

and

making

image

You

install

310

can

global

install

wusers

the

image,

activation

LISP.EXE

pages

this
the

install

image
VAX

the

you

LISP/VMS

reducing

VAX

any

system

physical

memory

LISP/VMS

other

image.

the

requirements

faster.

putting

the

following

two

lines

the

file

LISPSITE.COM:

S
$
Most

INSTALL := SSYSSSYSTEM:INSTALL
INSTALL LISPSSYSTEM:LISP.EXE /OPEN/HEADER_RESIDENT/SHARED
the

LISP

LISPSUS.SUS.
portion

you

that

You

code

and

can

data

create
Yt

suspended

Sor

system

L2 g

reside

global
C-IASE

1in

the

section

shared

among

all

need:

SYSGBL

and

the

Approximately

PRMGBL
4200

privileges

additional

global

pages

suspended

that

the

users.

system

read-only
To

so,

COMPLETING THE INSTALLATION

The

following line

the

file

LISPSITE.COM:

LISP/INSTALL=LISPSSYSTEM:LISPSUS.SUS

You can delete the global section created by the preceding command, 1f
you
have
the
SYSGBL
and
the
PRMGBL privileges and if you use the
following DCL

command:

LISP/REMOVE=LISPSSYSTEM:LISPSUS.SUS

NOTE

1in
commands
installation
You must surround any
with the SET NOON (do not check for
LISPSITE.COM
errors) and SET ON (check for errors) commands.
symbol definitions, as in the
preceding
example
(INSTALL
=
SSYSSSYSTEM:INSTALL), must be local
(:=),

not

global

(:==).

The Default LISPSITE.COM File

3.2.3

This skeleton LISPSITE.COM file

@
@ e
D wan

mnwmwennunnnnnonan
o n

provided such a

file

will

installed

SYSS$SMANAGER,

is not already there:

VAX LISP site-specific startup procedure.
This procedure is invoked by the lispstart procedure.
Remove comments and alter this file to suit your site.

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

LISPSTIME_ZONE 0
LISPSDAYLIGHT_SAVING_TIME_P NO
LISP$SHORT_SITE_NAME "?2"
LISPSLONG_SITE_NAME "?2"
LISPSMACHINE_INSTANCE "?2"

NOON

INSTALL := S$SYSSSYSTEM:INSTALL /COMMAND_MODE
INSTALL CREATE LISPSSYSTEM:LISP/OPEN/HEADER_RESIDENT/SHARED
rTcD/TmcmATr—TTQDQQVQmPM
I.TSPSIUIS SIS
Yu&u&u&&oua—vavv wwwww
dd b Bed
L L3dd
tdd / iV
ddd

SET

EXIT

3-5

COMPLETING THE

3.3

TUNING THE Al VAXSTATION

You

can

your

VAXstation

two

adjusting

parameter

adjusting

authorization quotas

Recommended System
following

VAXstation.
for

optimal

memory).

sample
The

values

ways:

3.3.1
The

tune

INSTALLATION

1in your

performance

Sample

in your

o0f

these

VAX

LISP

file

1is

AUTOGEN

accounts

for

an AI

file.

1In

typical
are

VAXstation

SYSSSYSTEM:MODPARAMS.DAT

specific AUTOGEN data

parameters

{

Site

common system disk is being used, this
in SYSSSPECIFIC:[SYSEXE], not a common

user

file

Parameters

MODPARAMS.DAT

values

system parameters

recommended

megabytes

File

a VAXcluster where

file should reside
system directory.

Add

configuration

modifications

swap,

and

dump

that

data,
file

you wish

to make

system parameter
sizes

the

to AUTOGEN's

calculations,

bottom of

Number

CTLPAGES=500

Used with workstation windows

SPTREQ=2000

Required
Modified
to

MPW_WAITLIMIT=2500

Wait-limit

modified

MPW_HILIMT

when

of
it

Gmd

of
W

1is

writing

equal
or

the

number

must

the

system

occur

less

than

page
or

list

equal

stops

to the

number

2w
A e

rlvtjv

the

files

that

Size

the

PHYSICALPAGES=18432

megabytes

SWPFILCNT=1

swap

modified

file;

SWAPFILE=8000

this

page

pages

page

PAGEDYN=4000000

dond
Yo &

which

non-paged dynamic

PAGEFILE=30000

pool

pages

table

occurs

number

the

size

list;

than

MPW_LOLIMIT

Size

PAGFILCNT=1

number

deadlock will

Writing

system page

page

greater

!
i

IPAGEDYN=2320000
o
&
Bod B
o
b
wf wf W W
W WY

page-list

free-list

MPW_LOLIMIT=500

number

channels

entries

allowed

page,

file.

CHANNELCNT=2048

MPW_HILIMIT=2500

this

hardware

and

3-6

a swap

installed

pages

dynamic

physical

the

that

can be

file

paged

file;

swapping
Size

page

maximum number

pool

memory

maximum number

can be
file

installed
pages

pages

COMPLETING THE INSTALLATION

WSMAX=12000

Maximium working

WSINC=350

Amount

process

!
!

WSDEC=0

VIRTUALPAGECNT=30000

by which
1S

set
the

size
working

increased

set

by AWSA

(Automatic Working Set Adjustment)
Amount by which the working set of a
process

decreased

Maximum amount

process

by AWSA

of wvirtual

can

pages

map

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

The

values

from booting.

are

valid only

for

system whose

wuse

can

be
characterized
as
a
single-use
system
running
primarily VAX LISP.
While running only
VAX
LISP
1is
not a requirement, these values tune the system to run
VAX LISP efficiently and may have some adverse
effect
on
systems
that
heavily
use
other
products
concurrently with VAX

Therefore you
products
and
for

adjust

VAX

your

LISP.

should review the requirements of
other
use
these values as recommended values

LISP.

system’s

Add

Reconfigure

parameter

the preceding values

executing

vyour

the

values:

system,

the

file SYS$SYSTEM:MODPARANMS.DAT

wusing

the

AUTOGEN

wutility

command:

@SYSSUPDATE :AUTOGEN SAVPARAMS REBOOT

For details on using the AUTOGEN Utility, see Chapter 11 of The
Guide
to
VAX/VMS
System
Management
and
Daily
Operations.
For detailed
descriptions of the
SYSGEN
parameters,
see
the
VAX/VMS
Reference
L

Manual,

o B Pl

Vol

aom

4C,

The

System Generation Utility,

Appendix A.

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.

COMPLETING THE INSTALLATION

3.3.2
The

Recommended Authorization Quotas
following

accounts

are

an AI

WSDEFAULT:
WSQUOTA:

WSEXTENT:

PGFLQUOTA:

recommended

authorization

quotas

for

VAX

LISP

VAXstation:

1024
8000

18000

30000

!
!

Default working set size
Limit for the amount of physical

memory a

user

into

working

Absolute

memory

process

1ts

process

may

lock

set

limit on physical
the

system allows

Maximum number
process

can

paging

file

the

of pages a user’s
use

1in

the

system

To adjust these quotas, invoke the Authorize Utility.
See
Chapter
1
of
this
manual on how to use the Authorize Utility.
See the VAX/VMS
Reference Manual, Vol 4 for further information on the quotas.

3-8

APPENDIX A

PROBLEM DETERMINATION AND REPORTING

the
the
In

error

occurs

error
error

1is
to

you

defect

using

Software

DIGITAL,

particular,

caused

while

result

the

are

using VAX

LISP

the

and

you

product,

Performance

error

message

preceded

failure

internal

consistency

you

should

believe

that

you

should

report

Report

(SPR)

form.

"Internal

check

and

error:"

1is

should

reported.

Along with

the

The

SPR

form,

operating

system

include:

name

respectively

obtain

SOFTWARE-VERSION

functions.

and

with

version,
the

The version number
of VAX LISP/VMS which is
greeting

message

when

you

start

VAX

A complete description of the problem.

A listing (reduced to
program
that
caused

are

can

included

and

1in

the

LISP.

form possible) of the
initialization

1Include

LISP
files

macro

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

file.

that

shortest
error.

you

Language)

definitions

the
the

which

SOFTWARE-TYPE

pertinent.

The
the

HOW TO ORDER
ADDITIONAL DOCUMENTATION

From

Call

Chicago

Write

312-640-5612

Digital Equipment Corporation

8:15am to 500 pm CT

Accessories & Supplies Center
1050 East Remington Road

Schaumburg, IL 60195

San Francisco

408-734—-4915

Digital Equipment Corporation

8:15amM to 500p,m PT

Accessories & Supplies Center

603—-884—-6660

Alaska, Hawaii

830aM to600pPM ET

632 Caribbean Drive
Sunnyvale, CA 94086

408-734—-4915
8:15amM to500pm PT

New Hampshire

603-884—-6660

Digital Equipment Corporation

830 AaM to600PM ET

Accessories & Supplies Center

Rest of U.S.A.,

1-800-258-1710

Puerto Rico®

830 amM to600pPmM ET

P.O. Box CS2008
Nashua, NH 03061

*Prepaid orders from Puerto Rico must be placed with the local DIGITAL subsidiary (call 809-754—7575)

Canada
British Columbia

Ottawa—Hull

1-800-267—-6146

Digital Equipment of Canada Ltd

8:00 AM to 500 pmMm ET

940 Belfast Road

613-234-7726
8:00 aM to 500 pm ET

Elsewhere

Ottawa, Ontario K1G 4C2
Attn: A&SG Business Manager

112-800-267-6146
8:00 Am t0o5:00 M ET

Elsewhere

Digital Equipment Corporation
A&SG Business Manager®
*c/o DIGITAL's local subsidiary or approved distributor

VAX LISP/VMS Installation Guide

AA-YQ22C-TE

READER’S

COMMENTS
:

Note: This form is for document comments only. DIGITAL will use comments
submitted on this form at the company’s discretion.

|f you require a written reply and

are eligible to receive one under Software Performance Report (SPR) service, submit
your comments on an SPR form.

Did you find this manual understandable, usable, and well organized?

Please make suggestions for

Improvement.

Did you find errors in this manual?

If so, specify the error and the page number.

Please indicate the type of user/reader that you most nearly represent:
Assembly language programmer
Higher-level language programmer

Occasional programmer (experienced)
User with little programming experience

Student programmer
Other (please specity)

Name

Date

Organization

Street
City

State

Zip Code
or Country

Do Not Tear — Fold Here and Tape

dligliltiall

NO POSTAGE
NECESSARY
IF MAILED
IN THE
UNITED STATES

BUSINESS REPLY MAIL
FIRST CLASS PERMIT NO.33 MAYNARD MASS.

POSTAGE WILL BE PAID BY ADDRESSEE

DIGITAL EQUIPMENT CORPORATION

CORPORATE USER PUBLICATIONS
MLO5-5/E45
146 MAIN STREET
MAYNARD, MA 01754-2571

Do Not Tear — Fold Here

Cut Along Dotted Line