Digital PDFs

AA-P143F-TE

January 1990

40 pages

Original

3.0MB

view download

OCR Version

2.5MB

view download

Document:	VAX APL Installation Guide
Order Number:	AA-P143F-TE
Revision:	000
Pages:	40
Original Filename:

OCR Text

G4 < B3/06 405

VAX APL Installation Guide
Order Number: AA-P143F-TE

January 1990

This document contains instructions for installing VAX APL 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 APL Version 3.2.

Revision/Update Information:

This revised document supersedes the

VAX APL Installation Guide
(Order Number AA—P143E-TE).
Operating System and Version: VMS Version 5.2 or higher

VMS Workstation Software Version 4.1

DECwindows Version 2.0 on VMS Version 5.3
Software Version:

digitai equipment corporation
maynard, massachusetts

VAX APL Version 3.2

First Printing, December 1982
Revised, June 1984
Revised, November 1985
Revised, Junhe 1987
Revised, May 1988
Revised, January 1990

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.

Any 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 or equipment that is not supplied by Digital
Equipment Corporation or its affiliated companies.

Restricted Rights: Use, duplication, or disclosure by the U.S. Government is subject to
restrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and

Computer Software clause at DFARS 252.227-7013.

The 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:
DEC
DEC/CMS
DEC/MMS
DECnet

DIBOL
EduSystem
IAS
MASSBUS

DECwriter

RSX

DECsystem—10
DECSYSTEM-20
DECUS

PDP
PDT
RSTS

UNIBUS
VAX
VAXcluster
VMS
|

flfl@flfln

S1374

Prerequisite SORWAre . . . . ...

vttt ettt

. Accessing the OnlineRelease Notes
.

“Installation Procedure Reqmrements

e e

e e e

..........

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

...ttt

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

Using VMSINSTAL . . . ..

Installing VAX APL

Installing VAX APL on @ VAXCIUSIEr . ... ....otuiseeneiiiiine e,
Installing VAX APL on a VAXstation

After the Installation.

......... e

r e

e e e

.. . ...... [ett recraeanassecaannaseannnna

Control Character Keywords . .. .. P

‘Modifiable Files .

llllllllllllllllllllllllllllllllllllllllllllllll

Moving the QAPL Application.

. . .. ................. e e e e e
Running the Installation Verification Procedure Separately ....................

Error Condltlons

Installing VAX APL As a Shared Image

......
.. ......
il

Maintenance Updates . ...........cooveennnnnnn. e aaessseseseseena
Determining and Reporting Problems .......... s et eaaaes ‘. e
Sample Installation

DRONDNDROMNON
-+ - =t s

Preparing to Install VAXAPL......oovvunnn. e e,

ARWONN—=2OOCO®»OO®GIN DABDBNS

Preface ........

Contents

Preface

This document describes how to install VAX APL on the VMS operating

system. It is intended for system managers. This document applies to VAX
APL Version 3.2. A major version num
is represent
ber
ed 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 reinstall
VAX APL for any other reason.
I

At the back of this document is the 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 APL 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.

This installation guide contains samples from an installation of VAX APL,
These samples may not be exact replications of the installation output.

Conventions Used in This Document

The following conventions are used in this supplement.
Meanmg

Conventions

words and - thatyou should enter the word or letter exactly as shown

letters

| Uppercase words and letters usedin format examples, mdlcate |

UPPERCASE

bood
“

1nd1cates that you press a key on the
A symbol such as m symbol represents a single
terminal. For example, the [Retwn

color type
|

In examples that show interactive input and output, all lines that
~ APL or the VMS system pnnts or dlsplays are shownin black
| letters, and all lmes the user enters are shownin red letters

- stroke of the RETURNkey on a termmal

[cTROx])

o
|

M ‘[option] |

The phrase CTRL/x 1ndlcates that you must press the key labeled

CTRL while you s1mu1taneously press another key, for example, |

o CTRL/C CTRL/Y CTRL/Z

are not optlonal in the syntax ofa d1rectory name in a file
specification.)

- Brackets 1nd1cate that the enclosed 1tem is optmnal (Brackets

Preparing to Install VAX APL
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 customer services 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.

Prerequisite Software
VAX APL Version 3.2 requires VMS Version 5.2 or higher.
VAX APL Version 3.2 requires VMS Workstation Software Version 4.1 or
DECwindows Version 2.0 on VMS Version 5.3 or higher on VAXstations to
support the APL character set.

Contact your Digital customer services representative if you have questions
about the compatibility of other software products with this version of VAX
APL. You can request the most recent copy of the VAX System Software
Order Table/Optional Software Cross Reference Table. That copy verifies
which versions of your operating system are compatible with this version of
VAX APL.
NOTE

If you are using a VAXstation and accessing a host VAX system to
run VAX APL, VAX APL must be installed on both the host VAX
system and the VAXstation.

Accessing the Online Release Notes
VAX APL provides online release notes. The prompt to display or print the
release notes during the installation appears in Step 5 of the installation
procedure when you invoke VMSINSTAL with the OPTIONS N parameter.
To obtain the release notes after the installation, type or print the file
SYS$HELP:APL032.RELEASE_NOTES. Online help also directs you to the
release notes file. After the installation, enter the following command:
$ HELP APL RELEASE NOTES [Return]

VAX APL Installation Guide

Installation Procedure Requirements
The installation takes approximately 10 to 45 minutes, depending on the
type of media and your system configuration. Before installing VAX APL,
you must have the following privileges and resources:
e

SETPRYV privileges, or CMKRNL, WORLD, and SYSPRV privileges

A minimum of 7000 blocks of free disk space during installation; 5200
to 6100 blocks are used after installation depending on the optional files
selected during installation

20 contiguous free global pages and 4 global sections to install
APLSHR.EXE as a protected shared image (required)

950 contiguous free global pages and 2 global sections to install
APL.EXE as a known shared image (optional)

930 contiguous free global pages and 2 global sections to install
QAPL.EXE as a known shared image (optional)

100 contiguous free global pages and 1 global section to install
APLMSG.EXE as a known shared image (opfional)

Sufficient disk space (in blocks) for a copy of the file
SYS$LIBRARY:DCLTABLES.EXE

Buffered I/0 byte count (BYTLM) of 8192 bytes (minimum) and
subprocess creation quota of 1 (minimum) to prevent failure of the
Installation Verification Procedure (IVP)
NOTE

You must ensure that your system has the necessary global page

and global section SYSGEN quotas for the installation. Failure
to do so could cause the DCL tables to be corrupted in some
situations.

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

$§ INSTALL

:==

$INSTALL/COMMAND
MODE

[Return‘l

Then, enter the following command:
INSTALL> LIST/GLOBAL/SUMMARY
Summary

?? Global

Sections Used,

INSTALL> EXIT

of Local

VAX APL Installation Guide

Memory Global

Sections

???/???? Global Pages Used/Unused

When you issue these commands, the system displays a summary of the

number of global sections used, the number of global pages used, and the
number of global pages unused. To exit from the VMS Install Utility, enter

the EXIT command and press [Reum].

VAX APL requires the following global pages:
*

APLSHR: approximately 20 global pages (required)

APL: approximately 950 global pages (optional)

QAPL: approximately 930 global pages (optional)
APLMSG: approximately 100 global pages (optional)

If fewer pages are available, delete an existing knownimage with the
VMS Install Utility, or increase the GBLPAGES system parameter

with the VMS System Generation Utility (SYSGEN), editing the file

" SYS$SYSTEM:MODPARAMS.DAT and then invoking the AUTOGEN

command procedure, SYS$UPDATE:AUTOGEN.COM. For more information

on the AUTOGEN command procedure, see your processor-specific

installation/operations guide.

You can determine the number of avaflable global sectlons by invoking
SYSGEN as follows:
$ RUN

SYS$SYSTEM: SYSGEN

SYSGEN> USE

CURRENT

SYSGEN> SHOW

GBLSECTIONS

SYSGEN> EXIT

[Return]

The last number displayed is the maximum number of global sections.

Compare this number to the number of global sectionsin use displayed by
the VMS Install Utility.

If the number of global sections used plus the number needed by VAX APL
exceeds the maximum number of global sections, you must increase the

number of available global sections before you can install VAX APL.

To increase the number, increase the GBLSECTIONS system parameter

by editing the file SYS$SYSTEM:MODPARAMS.DAT and then

invoking the SYS$UPDATE:AUTOGEN.COM procedure. For more

information on the AUTOGEN. COM procedure, see your processor-specific

installation/operations guide.

If the number of global sections used plus the number needed to install VAX
APLis less than the maximum number of global sections, you can exit from

SYSGEN and continue.

VAX APL Installation Guide

User Account Quotas and annleges
To use VAX APL, each account must have TMPMBX and NETMBX
pnwleges and the following requirements:
e

AST hmlt (ASTLM) 10 (minimum)

Bufl'ered I/0 quota (BIOLM) 10 (mlmmum)

Dlrect I/O quota (DIOLM) 10 (Immmum)

Open file limit (FILLM) 10 (minimum)

o “Bufi'ered /O byte count quota (BYTLM) 8192 (m:lmmu:m)

. Enqueue quota (ENQLM) 10 (m1mmum)
*

Paging file quota (PGFLQUOTA) 2500 pages (m1n1mum)
.
Subprocess creat1on quota (PRCLM) 3 (mlmmum)

°
. Workmg set. sme (WSDEF) 250pages (mlmmum) 500 or more pages
*Vgrecommended

SRR

- Use the VMS Authonze Utlhty(AUTHORIZE) to compare the current

values of these quotas with the reqmrementsfor VAX APL. For example, the

account usedin the followmg example is the SYSTEM account:
§ SET DEFAULT SYS$SYSTEM
$ RUN AUTHORIZE
UAF>

SHOW SYSTEM

To change the values of these quotas, use the VMS Authorize Utility’s
MODIFY command For more 1nformat10n see the WVIS Authorzze Uttlzty

Manual

VMS License Management Facility
The VMS License Management Facility (LMF)is available with Version 5.0

of the VMSoperat:lng system You must reglster yourVAX APL software
hcense

The hcense reglstratlon 1nformatlon you needis conta.medin the Product
'Authorization Key (PAK) thatis shipped with VAX APL The PAKis a paper
~ certificate that contains information about the license you have to run a
particular piece of software.

VAX APL Installation Guide

To register a license under VMS V5.0, first log in to the system manager’
s
account, SYSTEM. You then have a choice of two ways to

-registration:

perform the

Invoke the SYS$UPDATE:VMSLICENSE.COM procedure. When it

- prompts you for information, respond with data from your Product
- Authorization Key (PAK). o

. Issue the LICENSE REGISTER DCL command with the appropriate
~

qualifiers that correspond to information
on the PAK.

For complete information on using LMF, see the VMS License Managem

ent

Utility Manual in the VMS documentation set.

Usi

ng | V

MSI

NST

After you log in to a privileged account to install VAX APL, invoke

VMSINSTAL, the command procedure that installs this product.

An
example of this procedure is shown in Steps 1 and 2 of the
Installing VAX

APL section.

The VMSINSTAL command procedure has the following syntax:
$ @SYSSUPDATE:VMSINSTAL APLO32 ddcu:

[op:cIoNs Nj

VMSINSTAL prompts you for the product and device names if

you do not
supply these first two parameters. If you wish to be prompted for the
product and device names and to display
or print the release notes, enter
the following:
T
.
|
o
|
$ @SYS$UPDATE:VMSINSTAL

You can also enter an asterisk (*) in place of APL032. If you are installin
g
from magnetic tape, you can use the asterisk to save installation time;
the
asterisk causes VAX APL to be installed witha minimum of

tape passes.

ddcu:
|
Represents a device name where the distribution volumes will

be mounted

for the VAX APL installation media, where dd is the device code, c
is the
controller code, and u is the unit number. It is not necessar
y to use the

console drive to install VAX APL. If you do use the console drive, after

installation, you should replace any media you removed from

CSAL: is the device name used in examples in this document.

the

the drive.

VAX APL Installation Guide

OPTIONS N

Is an optional parameter you should provide if you want to be prompted
to display or print the release notes. If you do not include the OPTIONS
N parameter, VMSINSTAL does not prompt you to display or print the
release notes. VMSINSTAL permits the use of several other options.
For more information on the other optlons see your processor-specific
1nstallatlon/operat10ns guide.

When you 1nvoke ‘VMS]NSTAL, it checks the following:

Whether you loggedin 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, enter YES
and press [Feum]. If you want to stop the installation, enter NO and press

Installing VAX APL
This section contains excerpts from the installation procedure and explmns
each step. Defaults appear in brackets an throughout the installation

procedure. To use the default response, press [Return],

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.
6

VAX APL Installation Guide

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

SYSTEM

Password:

$ SET DEFAULT SYS$UPDATE

Step 2: Invoke VMSINSTAL.

$ @SYSSUPDATE:VMSINSTAL APLO32 CSALl: OPTIONS N
VAX/VMS

Software Product

Installation Procedure Vx.x

It is dd-mmm-yyyy at hh:mm.
Enter a question mark

(?)

any time for help.

Use the VMSINSTAL command procedure to install the product.
$VMSINSTAL-W-ACTIVE,

The follow1ng processes are still active:
o

processname
processname

* Do you still want to continue anyway [NO]‘? YES W
If nonsystem processes are running, VMSINSTAL will list the active
processes. If you want to continue the installation, enter YES and press

[Rewum), Press
- to stop the 1nstallat1on procedure
* Are you satisfied with the backup of your system dlsk [YES]? Efiflfil
If you are satisfied with the backup of your system disk, press [Retum].

Otherwise, enter NO and press

to discontinue the installation.

Step 3: Insert the installation kit volume.
Please mount the

first volume of the

YES

Are you

The

ready?

set

on CSAl:.

following products will be processed:

'VAX APL V3.2

Beginning installation of VAX APL V3.2 at hh:mm

YVMSINSTAL-I-RESTORE, Restoring product saveset A...

To indicate that you want to continue the installation, mount the volume,
enter YES, and press [Return].

VAX APL Installation Guide

Step 4: Choose a release notes option.
This step applies only if you specified OPTIONS N in Step 2.
Release Notes Options:
l.

Display release

notes

2. Print release notes
3.

Both
1 and 2

Copy release notes

Do not display,

to SYS$HELP

print,
or copy release notes

o Select option [3]

Choose the appropnate option by entermg the option number and pressing
If you choose option 1, VMSINSTAL d1splays the release notes on line

immediately. You can termmate the dlsplay at any time by pressmg
CTRL/C.

Ifyou choose optlon 2, VMSINSTAL prompts you for a queue name. Either

enter a queue name or press Retum] to send the file to the default output pnnt

f dewce

* Queue name

[SYSSPRIN'I‘]

If you choose optlon 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 enter
a queue name or press [Rewm]
to send the file to the default output print

device.
If you choose option 4, VMSINSTAL copies the release notes to SYS$SHELP
1mmed1ately
If you choose optlon 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 VMSINSTALis
labeled with the current product name and version number Take

care not to delete release notes for previous versions of VAX APL.

Next, VMSINSTAL displays the following prompt:
* Do you want to continue the installation

[N]?:

Y [Retrn|

If you want to continue the installation, enter Y and press [fsum]. If you press
VMSINSTAL discontinues the installation.

[Retum],

VAX APL Installation Guide

In either case, VMSINSTAL moves the release notes to SYSSHELP.
Step 5: Respond to License Registration Queries.

VAX APL supports the VMS License Management Facility (LMF). The
installation procedure displays license information about your product and
then asks if you have registered and loaded your authorization key for VAX
APL. The following example shows that information:
Product:

APL

Producer:

DEC

Version:

3.2

Release
*

Does

Date:

this product

26-FER-1990

have

authorization

key

registered and

loaded? YES

Enter YES and press

if you have registered and loaded your

-authorization key.
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, beginning with Step 2.
During the installation procedure, the VAX APL LMF key is invoked.
Step 6: Select installation options.
This

kit

contains

to verify the

can be

answering

Installation Verification Procedure

correct

installation

of the VAX APL

run prior to

the

conclusion

"YES"

IVP

prompt

installation

the

of this

(IVP)

interpreter.

procedure by

or invoked after the

follows:

$ APL/TERM=TTY/SILENT

SYS$COMMON: [SYSTEST.APL]APLS$IVP

* Do you want to run the IVP after the installation [IES]?[HMWM

The Installation Verification Procedure (IVP) runs tests to check whether the
installation procedure was successful. Press
to run the IVP after the
installation. If you do not want to run the IVP, enter NO and press [Reum]
in
response to the prompt.
* Do you want VMS Workstation Software

(VWS)

fonts

[NO]? YES

The VMS Workstation Software fonts are optionally available for
installation. The workstation fonts are needed to support APL character

display on VAXstations running VMS Workstation Software V4.1, Enter NO
and press
if you do not want to install the VMS Workstation Software
fonts. Enter YES and press
if you want to install the VMS Workstation
Software fonts.

VAX APL Installation Guide

Under Versjon

the APL
fonts

2.0

characters

must

Do you want

DECwindows,

this

in the DECwindows

version

installed on the

DECwindows

[YES]?

fonts

of VAX APL

terminal.

can

this,

display

the APL

server.

If you want to display the APL characters on the DECwindows terminal,

the fonts must be installed. Enter YES and press

to install the

DECwindows fonts. If you do not want to install the DECwindows fonts,

enter

NO and press [Retun].

Along with

the

dpi

fonts,

you

can

optionally

install

the

100

dpi

fonts.
*

Do you want

100

dpi

video

fonts

installed

[NO]?

YES

Optionally, the 100 dpi (dots per inch) fonts for the DECwindows terminal
can be installed on the DECwindows server. If you want to install the 100
dpi fonts, enter YES and press [Reun]. If you do not want the 100 dpi fonts
installed, press
This

kit

contains

workspaces

format

VAX APL
to

place

tools which read and write APL

in WSIS

allow

(Workspace

the

and other APL
WSIS

in your

Do you want WSIS

Interchange

transportation

implementations.
[SYSLIB]

Standard)

of workspaces
It

between

your

option

area.

[YES]?

Tools to read and write APL workspaces in WSIS (Workspace Interchange

Standard) format are optionally available with this installation. To install
the WSIS tools, press [Reum]. Enter NO and press

if you do not want to

install the WSIS tools.
This

kit

contains

annotated versions

which read and write APL workspaces
(Workspace
option

Interchange

to place WSINCOM

Standard)

of the

format.

and WSOUTCOM

Do you want WSINCOM and WSOUTCOM

tools

in WSIS
It

is your

in your

[SYSLIB]

[NO]?

area.

YES

The annotated versions of the tools that read and write APL workspaces
in WSIS (Workspace Interchange Standard) format are optionally available

for installation. If you want to install the annotated versions of these tools,
enter YES and press

If you do not want to install these tools, press

[Retumn].
This

kit

contains

(Appendix C
It

your

in the
option

Do you want

the APL meta-functions
"VAX APL Language Reference Manual").
to place METAFNC

the APL meta-functions

VAX APL Installation Guide

in your

[NO]?

[SYSLIB]

YES

area.

The APL meta-functions are optionally available for installation on your
system. Refer to Appendix C in the VAX APL Reference Manuals for more
information on the APL meta-functions. To install the meta-functions, enter
YES and press [Reum]. Press
if you do not want to install the APL
meta-functions.
* Do you want to purge files replaced by this installation [YES]? [Retumn]

The directories SYS$LIBRARY and SYS$SYSTEM may contain previous
versions of VAX APL files. These files are replaced during the installation
with new files, but the old files are not automatically purged. Purging is
recommended. In response to the purging prompt, press
to purge the
files or enter NO and press

to keep them.

Step 7: Read informational messages.

The VAX APL installation procedure produces a number of informational
messages that report on the progress of the installation.
The APL help

any user

the

not

procedure

this

fail.

access

in the help library.

online help during this
the

procedure

fails,

You may want

online help until

this

time,

you must

notify

step

of the

completed.

are

The APL help
library.

installed

installation procedure.

any users

Type Y when you

now be

to access

installation may

restart

file will

attempts

ready

file has

Users

continue?

been

can now

[Return

successfully

access

online

installed

help without

the help

endangering

installation procedure.

To indicate that you are ready to continue the installation, type Y and press

[Retum].
No

further

questions

will

asked.

$VMSINSTAL-I-RESTORE,

Restoring product

saveset

$VMSINSTAL-I-RESTORE,

Restoring product

saveset

$APL-I-DWFUNP75,

The

dpi

DECwindows

fonts will

now be unpacked.

VAX APL Installation Guide

VMI$KWD:APL TERMINAL14.DECWSFONT
VMI$KWD:APL TERMINALLS.DECWS$FONT

VMISKWD:APL TERMINAL28.DECWSFONT

VMISKWD:APL TERMINAL36.DECWSFONT
VMISKWD:APLTERMINALBOLD14.DECWSFONT

VMISKWD.APL TERMINAL ,.BOLD18.DECWSFONT
VMI$KWD:APL TERMINAL " BOLD28 .DECWSFONT
»VMISKWD:APLTERMINAL ".BOLD36.DECWSFONT
VMI$KWD: APLTERMINAL BOLDDBLWIDEl4.DECW$SFONT

VMISKWD:APL
_TERMINAL
VMISKWD: APL

BOLD"DBLWIDE1S.DECWSFONT

TERMINAL BOLD ".NARROW14 .DECWSFONT

VMISKWD: APL TERMINAL " BOLD NARROWlS DECWSFONT
VMISKWD: APL TERMINAL BOLD NARROW28 DECWSFONT
VMISKWD: APL

TERMINAL .BOLD" NARROW3
6 .DECWSFONT

VMISKWD: APL TERMINAL BOLD
VMISKWD: APL TERMINAL

WIDE1l4.DECWSFONT

BOLDWIDE18.DECWSFONT

VMISKWD:APLTERMINALDBLWIDE14.DECWSFONT

VMISKWD: APL TERMINAL |DBLWIDE18.DECWSFONT
VMISKWD: APL TERMINAL " NARROW14.DECWSFONT
VMISKWD: APL

TERMINAL .|NARROW18.DECWSFONT

VMISKWD: APL_IERMINAL_MARRGwzs DECWSFONT
VMIS$KWD:APL
TERMINAL NARROW36.DECWSFONT

VMIS$KWD:APL
TERMINAL WIDE1l4.DECWSFONT
VMI$KWD:APL
TERMINAL WIDE18.DECW$FONT
$VMSINSTAL-I-RESTORE,
$APL-I-DWFUNP100,

Restoring product

The 100

saveset E

dpi DECwindows

...

fonts will

VMI$KWD:APLTERMINAL10_ 100DPI.DECW$FONT

VMIS$KWD:APLTERMINAL14 100DPI.DECWS$FONT
VMISKWD:APLTERMINAL20_100DPI.DECWSFONT
VMISKWD: APL_TERMINAL28 100DPI.DECW$FONT

VMI$KWD:APL

TERMINAL BOLD10_100DPI.DECWS$FONT

VMI$KWD:APLTERMINALBOLD14_ 100DPI.DECWSFONT
VMIS$KWD:APLTERMINALBOLD20_ 100DPI.DECW$FONT

VMI$KWD:APLTERMINALBOLD28_100DPI.DECWS$FONT
VMIS$KWD:APLTERMINALBOLDDBLWIDE10 100DPI.DECW$FONT
VMISKWD:APL_TERMINAL
BOLD DBLWIDE14_100DPI.DECW$FONT
VMI$KWD:APL TERMINAL BOLD

NARROW10_100DPI.DECWSFONT

VMI$KWD:APL TERMINAL BOLD

NARROW14_ 100DPI.DECW$FONT

VMI$KWD:APLTERMINALBOLDNARROW20_ 100DPI.DECWS$FONT
VMIS$KWD:APLTERMINALBOLDNARROW28 100DPI.DECW$FONT
VMI$KWD:APLTERMINALBOLDWIDE10 100DPI.DECWSFONT

VMI$KWD:APLTERMINALBOLDWIDE14_ 100DPI.DECW$FONT
VMI$KWD: APL_TERMINALDBLWIDE10 100DPI.DECW$FONT
VMI$KWD:APLTERMINALDBLWIDE14_ 100DPI.DECW$FONT
VMI$KWD:APL_TERMINALNARROW10 100DPI.DECW$FONT

VMI$KWD:APL TERMINALNARROW14 100DPI.DECW$FONT
VMI$KWD:APL_TERMINALNARROW20 100DPI.DECW$FONT

VMI$KWD:APLTERMINALNARROW28 100DPI.DECWSFONT
VMI$KWD:APLTERMINALWIDE10 100DPI.DECWSFONT
VMI$KWD:APLTERMINALWIDE14_ 100DPI.DECW$FONT
The

following files will be

VAX APL Installation Guide

left

on disk:

now be unpacked.

SYS$SYSTEM:APL.EXE

[new]

SYSSHELP :HELPLIRB.HLB

[modified]

SYSSLIBRARY :DCLTARLES.EXE

[modified]

SYS$SYSTEM: QAPL.EXE

[new]

SYSSHELP : VAXAPL.HLB

[new]

SYSSLIBRARY : VAXAPL.HLP

[new]

SYSSLIBRARY:APL.CLD

[new]

SYSSLIBRARY:APL.HLP

[new]

SYSSHELP : APL032.RELEASE_NOTES

[new]

SYS$MESSAGE : APLMSG . EXE

[new]

SYS$LIBRARI:APL$VT220_FONT.FNT

[new]

SYS$LIBRARY :APL$VT240 FONT.FNT

[new)

SYS$LIBRARI:APL$VT240_FONT_132.FNT

[new]

SYS$LIBRARY :APL$VT320

[new]

FONT.FNT

SYS$LIBRAR¥:APL$VT320_FONT_132.FNT

[new]

SYS$LIBRAR¥:APL$VT330_FONT.FNT

[new]

SYSSLIBRARY:APL$VT330_EONT_132.FNT

[new]

SYS$LIBRARY:APL$VT340_FONT.FNT

[new]

SYSSLIBRARY :APL$VT340

[new]

FONT 132.FNT

SYSSFONT:UISSLOAD FONT APL.COM

[new]

SYSSFONT
:DVWS* . VWS$*FONT

[new]

SYS$COMMON:[SYSFONT.DECW.USER_75DPI]APL_$ERMINAL*.DECW$FONT

[new]

SYSSCOMMON: [SYSFONT.DECW.USER_100DPI])APL TERMINAL*.DECWSFONT

[new]

SYSSLIBRARY:APLSHR.EXE

[new]

SYSSLIBRARY :APLSYS.OBJ

[new]

SYSSLIBRARY:APLDISP.OBJ

[new]

SYSSLOADABLE IMAGES:PCDRIVER.EXE

[copied if no previous version]

SYSSLIBRARY:PCDRIVER.OBJ

[new]

SYSSLIBRARY : PCLOADER.COM

[new]

SYSSLIBRARY: SMG.AAS

[new]

SYSSLIBRARY : GKS.AAS

[new]

SYSSCOMMON: [SYSTEST.APL]APLSIVP.APL

[new]

SYS$COMMON: [SYSTEST.APL]APLSIVPKIT.COM

[new]

SYS$STARTUP : APLSSTARTUP . COM

[new]

SYSSLIBRARY :APLTAP .EXE

[optional WSIS]

SYSSLIBRARY :WSIN.APL

[optional WSIS]

SYSSLIBRARY:WSOUT.APL

[optional WSIS]

SYSSLIBRARY:WSINCOM.AAS

[optional

annotated WSIS]

SYSSLIBRARY : WSOUTCOM. AAS

[opticonal

annotated WSIS]

SYSSLIBRARY : METAFNC.AAS

[optional meta-functions]

SYSSLIBRARY : QWDFMT.AAS

[optional meta-functions]

The SYS$HELP:HELPLIB.HLB and SYS$LIBRARY:DCLTABLES.EXE files
are updated to include the new versions of the VAX APL HELP text and the
APL command line definition.

The UISSLOAD_FONT_APL.COM and DVWS* VWS$*FONT files will be
put into SYSFONT if it exists. If SYSFONT does not exist, they will be put
in SYS$LIBRARY.

A sample startup command procedure, APL$STARTUP.COM, is put in
SYS$STARTUP. This procedure is also used to ensure that APLSHR.EXE is
correctly installed before running the IVP.

VAX APL Installation Guide

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

Files will

now be moved to their target

directories...

If the installation procedure is successful, the new or modified files are

moved to their target directories.
If you entered YES in response to the prompt that requests a file purge at

Step 6, previous versions of the VAX APL files are now purged.
Step 8: Observe the Installation Verification Procedure.
If you chose to run the IVP in Step 6, VMSINSTAL now calls the IVP to
verify that VAX APL was installed successfully.
If the IVP was successful, the following messages appear on the screen:
Beginning the VAX APL V3.2

VAX APL V3.2

Installation Verification Procedure.

Installation Verification Procedure

completed

successfully.
Installation

of APL V3.2

completed

hh:mm

If the installation procedure fails for any reason, the following message is

displayed:
VAX APL V3.2

Installation Verification Procedure

failed.

Step 9: End the installation procedure.
VMSINSTAL procedure
$

done

hh:mm

LOGOUT

SYSTEM

logged

out

dd-mmm-yyyy

hh:mm:ss.ss

When the product installation procedure is complete, you can choose to
install more products or to log out (as shown here). If you removed any
media from the console drive before beginning the installation, you should

replace it now.

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.

VAX APL Installation Guide

Installing VAX APL on a VAXcluster
If you want to run VAX APL on multiple nodes of a VAXcluster, first check to

see that you have the appropriate software license. Then, follow these steps
after installing VAX APL:
1.

Issue the LICENSE LOAD command to activate the license on each node
in the VAXcluster on which VAX APL is to be executed as described in

the VMS License Management Utility Manual.

Run SYS$STARTUP:APL$STARTUP.COM on each node of the cluster

that has a software license.
$

@SYS$STARTUP :APL$STARTUP

If APL character support for Digital VT200 series terminals,
Digital VT300 series terminals, and VAXstations is wanted, run

SYSSMANAGER:PCLOADER.COM on each node of the cluster.
$

@SYS$SMANAGER:PCLOADER

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.

Run INSTALL and enter the following command at the INSTALL>
prompt:
INSTALL>

REPLACE

SYS$LIBRARY:DCLTABLES.EXE

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

Installing VAX APL on a VAXstation
If you want to run VAX APL on a VAXstation, first check that you have the
appropriate software license. Then, follow the instructions in the Installing

VAX APL section.
NOTE

If you are using a VAXstation and accessing a host VAX system to
run VAX APL, VAX APL must be installed on both the host VAX

system and the VAXstation.

VAX APL Installation Guide

For installations on a VAXstation running DECwindows, skip to the After
the Installation section. (The rest of this section contains information

needed for installations on VAXstations running VMS Workstation
Software.)

If you are installing VAX APL on a VAXstation running VMS Workstation
Software, follow the steps below after installing VAX APL as explained in
the Installing VAX APL section.

UIS$VT_ENABLE_OSC_STRINGS Logical

The system logical name UIS$VT_ENABLE_OSC_STRINGS must be
defined as “TRUE” to enable VAX APL to support the APL character set
and keyboard on the VAXstation. If the system logical name is not defined
as “TRUE,” characters will display in ASCII as if APL support had not been
enabled.

Use the SHOW command to determine if the logical is defined as “TRUE” by
entering the following command:
$

SHOW LOGICAL UIS$VT*

If the logical is defined as “TRUE,” skip to the APL Character Font Files
section. If the system message indicates that the logical is not defined or is
not defined to be “TRUE,” then follow the steps below.

Define the system logical name UIS$VT_ENABLE_OSC_STRINGS to be
“TRUE” by entering the following command:
$ DEFINE/SYSTEM/EXEC UISS$VT_ENABLE OSC_STRINGS TRUE lHeturnl

Edit SYSSMANAGER:UIS$SETUP_VT240.COM to add the system
logical name defined above. This will ensure that when the system is
rebooted, the system logical name will be defined as “TRUE.”
NOTE

This logical enables many facilities in the VAXstation terminal
emulator and only affects terminal windows created after its value
is defined.
APL Character Font Files

If you entered “YES” in response to the VMS Workstation Software fonts
question in Step 6 of the Installing VAX APL section, the following files are
placed on the VAXstation. The files that contain the APL character fonts are

placed in SYS$FONT if it exists; otherwise in SYS$LIBRARY.

TUIS$LOAD_FONT_APL.COM is placed in SYS$FONT. This file loads
the APL fonts into font memory at system startup.

VAX APL Installation Guide

DVWSVTOIOSWKO00GGO01TKZZZZ02A000.VWSSFONT the VAXstation
APL 80-wide normal font

DVWSVTO0G03CKO00GG001TKZZZZ02A000.VWSSFONT the VAXstation
APL 132-wide normal font

DVWSVTOI0SWKOOGGO01TKZZZZ02A000.VWS$VAFONT the GPX APL
80-wide normal font

DVWSVTOG03CK0O0GG001TKZZZZ02A000.VWS$VAFONT the GPX
APL 132-wide normal font

UISSVT_SPACING and UIS$VT_POINT Logicals

The VT200 terminal emulator allows the user to select different fonts based
on character size by defining the UIS$VT_SPACING and UIS$VT_POINT
logicals.

If these logicals are not defined with the default settings, then the VT220

terminal emulator will use an MCS font corresponding to the size specified
by the user. The user will see the APL keyboard, but will not see the APL
font.

Verify with the following command that the logicals are defined with the
default settings shown below:
$

SHOW LOGICAL UIS$VT_*

Logical

Default Setting

UIS$VT_SPACING_DEF

UIS$VT_SPACING_132

UIS$VT_SPACING_80

UIS$VT_POINT_DEF

UIS$VT_POINT 132

UIS$VT_POINT 80

If the logical names are not defined to the default settings, edit
SYS$MANAGER:UIS$SETUP_VT240.COM to change the logical settings.
Execute the command file with the following command:
$

RSYSSMANAGER:UIS$SETUP_VT240

VAX APL Installation Guide

After the Installation
VAX APL is now installed and can be invoked by all users with the APL

command.

The installation procedure modifies the DCL command table so that the
APL command is recognized and processed. However, the previous command

table is still in effect for those users who are currently logged in. All
logged-in users who want to use the APL command must log out of the
system and log in again.

If VAX APL is used extensively on your system, you can reduce system
overhead and memory requirements by installing it as a shared image,

using the VMS Install Utility. For more information, see the Installing VAX
APL As a Shared Image section.

PCDRIVER, The Terminal Driver Software
PCDRIVER supports the APL character set on Digital VT200 series
terminals, Digital VT300 series terminals, and VAXstations. If it is not
already installed, PCDRIVER, the terminal driver software, is installed
automatically by the VAX APL installation.
Verify that PCDRIVER is running by entering the following command:
$

SHOW DEVICE PC

If VMS reports NO SUCH DEVICE, follow the steps below to start the

PCDRIVER.

PCDRIVER.EXE is not a shareable image. Use the following command
to make sure that the file was installed with the /NOSHARED qualifier:
$

INSTALL LIST/SUMMARY

SYS$LOADABLE IMAGES:PCDRIVER

If the PCDRIVER.EXE file is not installed as a shareable image, go to
Step 2. If the PCDRIVER.EXE file is installed as a shared image, use

the following command to change the installation:
$

SYS$LOADABLE IMAGES:PCDRIVER

[Return]

Start the PCDRIVER by entering the following command:
$

INSTALL REPLACE/NOSHARE

@SYS$LIBRARY:PCLOADER

VAX APL Installation Guide

SYS$LIBRARY:PCLOADER should be invoked from the site-specific
system startup procedure, SYS$STARTUP:SYSTARTUP_V5.COM. Edit
the startup command procedure to add the following command:
$ @SYSSLIBRARY : PCLOADER

Control Character Keywords
A feature of VMS V4.0 and subsequent releases is that keywords can be
displayed when certain control characters are entered. By default, the
following keywords are displayed for the control characters listed:
Control

Character

Keyword

CTRLY

Interrupt

CTRL/C

Cancel

CTRL/Z

Exit

These keywords are enabled on a system-wide basis. VMS displays

keywords even if the terminal is not in the ASCII character set. A site that
uses VT102 terminals for APL may wish to modify these keywords so that
they display correctly on both ASCII and APL terminals.

The easiest way to accomplish this is to use keywords entirely in lowercase
letters. They will display as lowercase letters on an ASCII terminal and as
APL letters on a key- or bit-paired APL terminal.

See the VMS System Generation Utility Manual for more information.

To modify the keywords to CTRL/Y, CTRL/C, and so on, edit the file
SYS$EXAMPLES:SYSGTTSTR.MSG. The file contains instructions for the
editing procedure and to activate the new definitions.

Modifiable Files
Certain files may be modified after installation if desired.

VAXAPL.HLP, the source text of the VAX APL HELP function file, is
in SYS$LIBRARY. You can add new text to the HELP library. Refer
to HELP HOW-TO-BUILD while inside VAX APL for instructions on
creating the HELP file.

APL.CLD, the VAX APL DCL command line, is in SYSSLIBRARY.

VAX APL Installation Guide

APL.HLP, the VAX APL DCL HELP file, is in SYS$LIBRARY. APL.HLP

is the file used to update the DCL HELP file. Refer to the VMS
Librarian Utility Manual for instructions on modifying the DCL HELP
file.

Moving the QAPL Application
QAPL.EXE, the execute-only, runtime support for APL applications, is
installed on SYS$SYSTEM. This support facility can be used to execute

APL applications but cannot be used to develop APL applications. It may be
moved to any valid VAX/VMS system, free of charge, whether the system is
licensed for VAX APL or not.

To move the execute-only, runtime APL to a VMS system where it does not
exist, follow these instructions:
1.

Copy the following files from the VMS system on which they are
installed to the target system area specified.

QAPL.EXE to SYS$SYSTEM:
APLMSG.EXE to SYS$MESSAGE:

APLSYS.OBJ to SYS$LIBRARY:
APLDISP.OBJ to SYSSLIBRARY:
PCLOADER.COM to SYS$LIBRARY:

APL$VT220_FONT.FNT to SYS$LIBRARY:

APL$VT240_FONT.FNT to SYS$LIBRARY:
APL$VT240_FONT _132.FNT to SYS$LIBRARY-

APL$VT320_FONT.FNT to SYS$LIBRARY:
APL$VT320_FONT_132.FNT to SYS$LIBRARYAPL$VT330_FONT.FNT to SYS$LIBRARY:
APL$VT330_FONT_132.FNT to SYS$LIBRARY:

APL$VT340_FONT.FNT to SYS$LIBRARY:
APL$VT340_FONT_132.FNT to SYS$LIBRARY:
APL.CLD to SYS$LIBRARY:
VAXAPL.HLB (optional) to SYS$HELP:

If PCDRIVER is not available on the target system, then, copy the
following to files:
PCDRIVER.OBJ to SYS$LIBRARY:
PCDRIVER.EXE to SYS$LOADABLE_IMAGES:
20

VAX APL Installation Guide

Edit and execute a command file to facilitate linking the QAPL object
modules into a program image as shown in this example:
$ EDIT LINK QAPL.COM

$LINK/PROTECT/NOSYSSHR/NODEBUG/NOMAP
/NOTRACE/~ [Return]
$ SHARE=SYS$LIBRARY:APLSHR.EXE SYS$LIBRARY:APLSYS.OBJ, -

$ SYSSINPUT/OPTIONS, SYS$SYSTEM: SYS.STB/SELECTIVE @
CLUSTER=TRANSFERVECTOR, , , SYSSLIBRARY:APLDISP.OBJ [Retwmn]
GSMATCH=LEQUAL,
1,1

CTRL/Z

$ QLINK QAPL

If the PCDRIVER is not available on the QAPL system, edit and execute
a command file to facilitate linking the PCDRIVER object module into a
program image as shown in this example:
$ EDIT LINKPCDRIVER.COM
$LINK/NODEBUG/NOMAP/NOTRACEBACK/ -

$_EXE=SYS$LOADABLEIMAGES:PCDRIVER.EXE$_ SYS$SLIBRARY:PCDRIVER.OBJ, -

$ SYS$INPUT/OPTIONS, SYS$SYSTEM: SYS.STB [Rewm]
BASE=0 [Return]
IDENT="APL V3.2"

CTRL/Z

$ @LINK_PCDRIVER

Use the following DCL command to install the APL command on the
target system (you must have SYSPRYV privileges to change the DCL
command table):
$ SET COMMAND/TABLE=SYS$LIBRARY:DCLTABLES/$ OUTPUT=SYS$LIBRARY:DCLTABLES APL.CLD

Use the INSTALL utility to replace the system’s DCLTABLES. Users
that log in after the DCLTABLES have been replaced will be able to
access the APL command.
$§ RUN

SYS$SYSTEM:INSTALL

INSTALL> REPLACE SYS$LIBRARY:DCLTABLES.EXE

Running the Installation Verification Procedure Separately
The Installation Verification Procedure (IVP) is usually run at installation.
The IVP (Installation Verification Procedure) files, APL$IVP.APL and
APLS$IVPKIT.COM are put in SYS$COMMON:[SYSTEST.APL] so that the
IVP may be run after the installation is completed.

VAX APL Installation Guide

If you want to run the IVP separately to ensure the integrity of installed
files if system problems occur, execute the following command procedure:
$

APL/TERM=TTY/SILENT SYS$COMMON: [SYSTEST.APL]APLSIVP

IHaturnI

Error Conditions
If the installation procedure fails for any reason, a message like the
following one is displayed:
$VMSINSTAL-E~INSFAIL,
Version

3.2

has

The

installation

of VAX APL

failed.

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 the
Installation Procedure Requirements section).

Process quotas required by VMSINSTAL are incorrect (see the Using

VMSINSTAL section).
*

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 exists, 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

customer services representative.

Installing VAX APL As a Shared Image
If VAX APL will be used extensively on your system, you can reduce the
system overhead and memory requirements by installing VAX APL 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 the VMS System Messages and Recovery
Procedures Reference Volume.

VAX APL Installation Guide

First, determine the number of available global pages and global sections

on your system. See the Installation Procedure Requirements section for
information on how to do this.

Then, invoke the VMS Install Utility and install VAX APL as a shared
image by entering the following commands.
NOTE
APLSHR.EXE must be installed as a protected, shareable image.
APL EXE, QAPL.EXE, and APLMSG.EXE installations are

optional.
$ RUN SYS$SYSTEM:INSTALL
INSTALL> ADD

SYSSLIBRARY :APLSHR.EXE/OPEN/SHARED/HEADER/PROT

I Return

INSTALL> ADD

SYS$SYSTEM:APL.EXE /OPEN/SHARED/HEADER__RESIDENT

IRetum [

INSTALL> ADD

SYS$SYSTEM: QAPL.EXE/OPEN/SHARED /HEADER RESIDENT

INSTALL> ADD

SYSSMESSAGE :APLMSG.EXE/OPEN/SHARED

IRetum |

!Flaturn!

INSTALL> EXIT

To ensure that VAX APL is installed as a shared image each

time the system is bootstrapped, include the following lines in

SYS$MANAGER:SYSTARTUP_V5.COM (the site-specific startup file):
$INSTALL

ADD

SYSSLIBRARY:APLSHR.EXE/OPEN/SHARED/HEADER
/PROT

ADD

SYS$SYSTEM:APL.EXE/OPEN/SHARED/HEADER RESIDENT

ADD

SYS$SYSTEM:QAPL.EXE/OPEN/SHARED/HEADER RESIDENT

ADD

SYS$MESSAGE:APLMSG.EXE/OPEN/SHARED

EXIT

[Return|

[Return]
|Return]

[Retumn]

NOTE
APLSHR.EXE must be installed as a protected, shareable image.

APL EXE, QAPL.EXE, and APLMSG.EXE installations are

optional.

Maintenance Updates
Digital may periodically issue maintenance updates of VAX APL. Each

update consists of an installation kit. You should install this kit as described
in this document or in any documentation that may accompany the
maintenance update.

Each time a maintenance update is released, the version number changes.
For example, if the current version is 1.0, the version number of the first
maintenance update will be 1.1. In addition, each maintenance update

inciudes new release notes. The release notes describe the changes that
have been made to VAX APL since the previous release.

VAX APL Installation Guide

The updated release notes are provided on line. You should read the release
notes when you first install VAX APL; they are also accessible at any {ime
after the product is installed. For information on reading the release notes
at the time that you install VAX APL, follow the installation procedure
through Step 5. To locate the release notes after VAX APL is installed,
display or print the file SYS$HELP:APL032.RELEASE_NOTES or enter the
following command:
$ HELP APL RELEASE NOTES

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

If you purchased VAX APL 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 customer
services representative.

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

Software Performance Report (SPR).

If you find an error in the VAX APL 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.

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

sample.

VAX APL Installation Guide

Username:

SYSTEM

Password:

SET DEFAULT SYS$SUPDATE

@SYSSUPDATE:VMSINSTAL APL032 ddcu:

OPTIONS

VAX/VMS Software Product Installation Procedure V5.2
is 26-FEB-1990

13:16.

Enter a question mark

$VMSINSTAL-W-ACTIVE,

(?)

any time for help.

The following processes are still active:

processname

processname
processname

Do you want to

continue anyway

[NO]? YES

* Are you satisfied with the backup of your system disk
Please mount the

first volume

* Are you ready?

YES

The

of the

[YES]?

set on DDCU:

following products will be processed:

APL V3.2

Beginning installation of APL V3.2

13:17

$VMSINSTAL-I-RESTORE, Restoring product saveset A ...
%$VMSINSTAL-I-RELMOVED , The product’s release notes have been
successfully moved to

SYSSHELP.

Product:

APL

Producer:

DEC

Version:

3.2

Release Date:

26-~-FEB-1990

* Does this product have an autheorization key registered and
loaded? YES

VAX APL Installation Guide

This

kit

contains

to verify

the

run prior

can be

answering

"YES"

installation

Installation Verification Procedure

correct

installation

the

conclusion

the

IVP

prompt

the
of

VAX APL
this

invoked

(IVP)

interpreter.

procedure

after

the

follows:

APL/TERM=TTY/SILENT SYS$COMMON: [SYSTEST.APL]APLSIVP
*

you want

you

VMS

want

Under Version

the APL

fonts
*

run

2.0

characters

must be

Do you want
Along with

the

IVP

after

Workstation

DECwindows,

in the

the

installation

Software

(VWS)

this

DECwindows

version

DECwindows
75

dpi

fonts

fonts,

[NO]?
you

[YES]?
[NO]?

YES

of VAX APL

terminal.

installed on the DECwindows

the

fonts

can

this,

you want

This

kit
to

VAX APL

to
*

allow

and

kit

the

YES

can

optionally

installed

install

the

annotated versions

Interchange
place

Standard)
is

between

your

option

[YES]?

contains

(Workspace

|Retumn]

area.

read and write APL workspaces

option

YES

of workspaces

implementations.

[SYSLIB]

[NO]?

read and write APL
Interchange

transportation

in your
WSIS

fonts

(Workspace

other APL

Do you want

This

video

tools which

in WSIS

place WSIS

which

dpi

contains

workspaces
format

100

Standard)

WSINCOM

of the

tools

in WSIS

format.

and WSOUTCOM

It
your

your

[SYSLIB]

area.

you want

This

kit

contains

(Appendix

WSINCOM

your

"VAX APL

Do you want

to purge

installation

[YES]?

you want

The APL help

the

any user
the

users

procedure

file

in your
[NO]?

now

access

fail.

access

Manual").

[SYSLIB]

area.

YES

replaced by this

Restoring product

completed.

VAX APL Installation Guide

YES

Language Reference

METAFNC

installed

saveset
in

the

If the procedure

online

B
help

library.

online help during this

installation procedure.

not

files

will

attempts

installation may

restart
any

place

the APL meta-functions

¥VMSINSTAL-I-RESTORE,

[NO]?

the APL meta-functions

the

option

and WSOUTCOM

help

display

the APL

server.

fonts.
*

[Retmn]

fails,

You may want
until

this

step

time,

you must
notify
of

the

100

dpi

* Type Y when you are ready to continue? Y

The APL help file has been successfully installed in the help
library.

Users can now access online help without endangering

this installation procedure.

No further questions will be asked.

$VMSINSTAL-I-RESTORE, Restoring product saveset C
%SVMSINSTAL~-I-RESTORE,
$AP1-I-DWFUNP75,

Restoring product saveset D

The 75 dpi DECwindows fonts will now be unpacked.

VMI$KWD :APL,_TERMINAL14.DECWSFONT
VMI$SKWD : APL ~ TERMINAL1S.DECWSFONT

SFONT
_
VMISKWD :APL TERMINAL28.DECW
VMISKWD :APL.TERMINAL36.DECWSFONT
VMI$SKWD :APL

TERMINAL BOLD14.DECWSFONT

.
VMISKWD: APL TERMINAL BOLD18.DECWSFONT
VMISKWD :APL

TERMINAL-BOLD28.DECWSFONT

VMISKWD: APL TERMINALBOLD36. DECWSFONT
~ VMISKWD :APL TERMINAL .BOLD_DBLWIDEl4.DECWSFONT

.BOLD" DBLWIDE1S8.DECWSFONT
NARROW14 DECWSFONT
|
VMISKWD:APL TERMINAL BOLD

VMISKWD: APL ~' TERMINAL

VMI$KWD:APL TERMINAL .BOLD " NARROW1S.DECWSFONT
VMI$KWD :APL, TERMINALBOLD" NARROW28 .DECWSFONT
VMI$KWD:APL TERMINAL BOLD NARROWBG DECWSFONT
VMI$KWD:APLTERMINAL |BOLD WIDE14 DECWSFONT

.: BOLD WIDE18 DECWSFONT
VMISKWD:APLTERMINAL

‘VMI$KWD:APLTERMINALDBLWIDE14.DECWSFONT

VMI$KWD:APLTERMINAL"DBLWIDE1S8.DECWSFONT
. NARROW14.DECWSFONT
VMISKWD:APLTERMINAL
VMISKWD:APL|TERMINAL" NARROW18 .DECWSFONT
VMISKWD : APL TERMINAL . NARROW28 .DECWSFONT
VMISKWD : AEL_TERMINAL_NARROWBG DECW$FONT
:APL
TERMINAL WIDE14.DECWSFONT
VMISKWD
:APL
TERMINAL WIDE18.DECWSFONT
VMISKWD

$VMSINSTAL~-I-RESTORE,

Restoring product saveset E

...

SAPL~I~DWFUNP100, The 100 dpi DECwindows fonts will now be unpacked.
VMISKWD:APLTERMINAL10_100DPI. DECWSFONT
VMI$KWD :APLTERMINAL14 T100DPI. DECWSFONT

VMISKWD: APL. TERMINAL20 1OODPI DECWSFONT
VMI$KWD :APLTERMINAL28 " 100DPI.DECWSFONT

VMISKWD :APL|TERMINAL BOLD10_100DPI.DECWSFONT
VMISKWD : APL TERMINAL .. BOLD14 100DPI DECWSFONT
VMISKWD : APL TERMINAL" BOLD20 100DPI DECW$FONT
VMISKWD :APLTERMINAL" BOLD28 IOODPI DECWSFONT

VMIS$KWD :APLTERMINAL BOLD DBLWIDElO 100DPI. DECW$FONT

VMISKWD:APLTERMINAL BOLD" DBLWIDE1l4 100DPI DECWSFONT
VMI$KWD :APLTERMINAL. BOLD NARROWlO 100DPI.DECWSFONT
VMISKWD : APL TERMINAL. BOLD NARR0W14 IOODPI DECWSFONT

" NARROW20 IOODPI DECWSFONT
VMISKWD: APL TERMINAL BOLD__
VMISKWD: APL TERMINAL BOLD" NARROW28 100DPI DECWSFONT

VAX APL Installation Guide

VMISKWD:APL TERMINALBOLDWIDE10_ 100DPI.DECWSFONT

VMISKWD: APL TERMINAL BOLD WIDE14 100DPI DECWSFONT

VMISKWD: APL TERMINAL DBLWIDElO100DPI DECWSFONT
VMISKWD:APL
'TERMINAL DBLWIDE14 IOODPI DECW$FONT

VMISKWD : APL TERMINAL NARROWIO 100DPI DECW$FONT

VMI$KWD: APL|TERMINAL NARROW14

lOODPI DECW$FONT

VMI$KWD APL

100DPI DECW$FONT

TERMINAL NARROW?O

VMI$KWD APL

TERMINAL NARROW28 100DPI DECW$FONT
VMISKWD:APL|TERMINAL
. WIDE1O 100DPI DECW$FONT

VMI$KWD APL TERMINAL WIDE14 100DPI DECW$FONT

The followxng flles w111 be left on dlsk
SYSSSYSTEM APL EXE

‘

[new]

SYS$MESSAGE : APLMSG. EXE

[new]

SYS$HELP : HELPLIB.HLB

[modified]

SYS$SLIBRARY: DCLTABLES
. EXE

[modlfled]

SYS$SYSTEM: QAPL.EXE

[new]

SYSSHELP :VAXAPL.HLB

[new]

SYS$LIBRARY : VAXAPL . HLP

[new]

SYS$LIBRARY:APL.CLD

[new]

SYS$LIBRARY :APL.HLP
}
SYS$HELP:APL032.RELEASE NOTES

[new]

‘7SYS$LIBRARYAPL$VT220 FONT,FNT
SYSSLIBRARY:APL$VT240FONT.ENT

[new]
[new]

SYSSLIBRARY:APL§VT240FONT 132.FNT

[new]

SYS$LIBRARY:APL$VT320FONT.FNT
~
SYS$LIBRARY:APL$VT320FONT132.FNT

[new]
[new)

- SYS$LIBRARY: APL$VT330 FONT.FNT
SYS$LIBRARY: APL$VT330 FONT132.FNT
SYssLIBRARxAPL$VT340 FONT.FNT

[new]
' [new]
[new] *»

SYS$LIBRARY: APL$VT340FONT' 132.FNT

[new]

SYS$FONT: UIS$LOADFONTAPL,COM

[new]

SYS$FONT: DVWS*. VWS
$ *FONT

[new]

SYSSCOMMON: [SYSFONT.DECW.USER_75DPI]APLTERMINAL*.DECW$FONT
SYS$COMMON: [SYSFONT.DECW. USERIOODPI]APL

SYSSLIBRARY:APLSHR.EXE

[new]

SYS$LIBRARY:APLSYS.OBJ

[new]

SYSSLIBRARY :APLDISP.OBJ

[new]

SYS$LOADABLE IMAGES: PCDRIVER EXE

[copled 1f no prevmous ver31on]
[new]

SYS$LIBRARY: PCDRIVER.OBJ

SYSSLIBRARY:PCLOADER.COM

SYS$LIBRARY:GKS.AAS

[new]

SYS$COMMON: [SYSTEST.APL]APL$IVP.APL

[new)

SYS$COMMON: [SYSTEST.APL]APL$IVPKIT.COM

[new]

SYS$STARTUP:APL$STARTUP.COM

[new]

SYS$LIBRARY: APLTAP. EXE
SYSSLIBRARY:WSIN.APL

[optional WSIS]
[optional WSIS]

SYS$LIBRARY :WSOUT.APL

[optional WSIS]

SYS$LIBRARY : WSINCOM.AAS

SYS$LIBRARY :WSOUTCOM.AAS

SYS$LIBRARY:METAFNC.AAS

SYS$LIBRARY: QWDFMT . AAS

VAX APL Installation Guide

‘

[new]
[new]

SYS$LIBRARY: SMG.2AAS

[new]

TERMINAL*.DECWSFONT

[optional annotated WSIS]

[optional annotated WSIS]
[optional meta-functions]

[optional meta-functions]

*********************************************************************

If this

installation is being done

a cluster,

you must

do @SYS$STARTUP:APL$STARTUP.COM on all other nodes.
addition,

1In

be sure to have your system manager add

@SYS$STARTUP APL$S£ARTUP COM to your system startup file.
If you

intend to use DECterm or

series

of terminals,

the VT200,

you should also

@SYSSLIBRARY:PCLOADER.COM is in your

VT300,

or HDS200

insure that
system startup

file,

*********************************************************************
%VMSINSTAL—I~MOVEFILES

Flles will now be moved to thelr

target

directories...

Beginning the VAX APL V3.2 Installation Verification Procedure.
VAX APL V3.2

Installation Verification Procedure

completed

successfully.

‘Installatlon of APL V3 2 completed at 13: 49‘W‘

VMSINSTAL procedure done at 13 52

$ LOGOUT [Return]
SYSTEM

logged

out

26-FEB-1990

13:52:30:52

VAX APL Installation Guide

HOW TO ORDER ADDITIONAL DOCUMENTATION
From

Call

Alaska, Hawaii,

or New Hampshire

Rest of U.S.A.

and Puerto Rico!

603-884-6660

Write

Digital Equipment Corporation

P.O. Box CS2008
Nashua NH 03061

800-DIGITAL

1Prepaid orders from Puerto Rico, call Digital’s local subsidiary (809-7 54-7575)
Canada

800-267-6219

(for software
documentation)

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

~ (for hardware

documentation)

Internal orders

—

Internal orders
(for hardware

DTN: 2344323
508-351-4323

(for software
documentation)

documentation)

Software Supply Business (SSB)

Digital Equipment Corporation
Westminster MA 01473

Publishing & Circulation Services (P&CS)
NRO3-1/W3

Digital Equipment Corporation
Northboro MA 01532

Reader’s Comments

VAX APL Installation Guide
AA—P143F—TE

Clarity (easy to understand)
Organization (structure of subject matter)
Figures (useful)
Examples (useful)

Index (ability to find topic)

Page layout (easy to find information)

Fair

Poor
gooooogog

Completeness (enough information)

Good

Ogooododod

Accuracy (product works as described)

Excellent

oooooonod

I rate this manual’s:

Oooooood

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.

What I like best about this manual:

What I like least about this manual:

My additional comments or suggestions for improving this manual:

I found the following errors in this manual:
Page
Description

Please indicate the type of user/reader that you most nearly represent:

[J Administrative Support

[J Scientist/Engineer

[0 Computer Operator

[] Software Support

[J Educator/Trainer

[J System Manager

[J Programmer/Analyst

O Other (please specify)

[ Sales
Name/Title

Dept.

Company

Date

Mazailing Address

Phone
10/87

—

Do Not Tear — Fold Here and Tape

—

dlilalilt[a]1]}

—

l““l

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

PKO3-1/30D
129 PARKER STREET
MAYNARD, MA 01754-2198

—

Do Not Tear — Fold Here

—

Cnt Alnane Natted 1 ine