Installation of SETL V26 for VAX VMS V3
David Shields
Stephen Tihor
6 September 1982
SETL Project
Courant Institute
New York University
251 Mercer Street
New York, New York 10012
NOTE
This distribution is for VMS V3.0
(and later releases) only. It
will NOT run on earlier releases
of VMS.
The SETL system requires that the
value of the system parameter
VIRTUALPAGECNT be at least 8192.
The SETL system is a proprietary
product made available only by
agreement with New York
University. Materials made
available are solely for use at a
single site; they are not to be
made available to others without
the permission of New York
University.
This note describes how to install the SETL system contained on
the enclosed tape. The tape is standard VMS format, label SETL.
SETL VAX VMS V2 INSTALLATION Page 2
1.0 SETL INSTALLATION
Use the following procedure to install the SETL system.
1.1 Create Directory [SETL] For SETL Work.
Create a directory for the SETL files; [SETL] is suggested.
You can either create a subdirectory of an existing directory or
else consult the system manager to have new "user" directory
created.
The logical name NYU$SETL is used by the SETL system to refer to
the directory just created. Move to the newly created directory
using
$ SET DEFAULT [...]
and then do
$ SHOW DEFAULT
Then do
$ ASSIGN
ASSIGN will prompt for its arguments. For the first argument
("Device:") enter the string displayed by SHOW DEFAULT. For the
second argument ("Log_Name:") enter
NYU$SETL
Then do
$ SHOW TRANSLATION NYU$SETL
and verify that output obtained agrees with output of "SHOW
DEFAULT" done earlier.
1.2 Copy In Files From Tape
$ REQUEST/REPLY/TO=TAPES "mount SETL tape"
$ MOUNT MT: SETL
$ COPY/LOG MT:*.* NYU$SETL:
SETL VAX VMS V2 INSTALLATION Page 3
1.3 Install NYU$SETL Logical Name
Logical name NYU$SETL must be defined as above for all further
SETL work. This can be done either by modifying the appropriate
system startup files to do ASSIGN at group or system level, or
by including the assignment in the "definitions" file
SETLDEF.COM.
Note that SETLDEF.COM defines the various programs of the SETL
system as "foreign" commands, so that the ASSIGN for NYU$SETL
MUST include a device specification; for example,
$ ASSIGN [SETL] NYU$SETL
will NOT work since device not specified. You must use form
$ ASSIGN dbxx:[SETL] NYU$SETL
-----
SETL users should add
$ @nyu$setl:setldef
to their LOGIN.COM file.
1.4 Test SETL System With
$ SET DEFAULT NYU$SETL
$ @STLTST
which compiles and executes the test programs on file
STLTST.STL. Edit STLTST.XLI and look for string FAILED. The
presence of this string indicates a problem.
Note that it is normal for the terminal to receive a number of
error messages whilst running the tests, as the standard test
includes test code for error handling. The file STLTST.LOG
contains the LOG file from a run of the standard tests, and so
shows the messages that should appear at the terminal. The
tests require about 20 minutes of processor time on a
VAX-11/780.
At the end of the acceptance test, execute
$ SET DEFAULT NYU$SETL
$ DELETE STLTST.*.*
as these files are not part of the running system.
SETL VAX VMS V2 INSTALLATION Page 4
1.5 Install HELP File
Ask the system manager to install the SETL HELP file:
$ LIBR/HELP SYS$HELP:HELPLIB NYU$SETL:SETL.HLP
1.6 Page File Quotas
SETL attempts to determine the size of available virtual memory
by examining the value of the page file quota parameter
PGFLQUOTA. If attempts to use SETL yield the error message
SETL-F-VASFULL
then check that the value of PGFLQUOTA for the user is not
greater than the value of the system configuration parameter
VIRTUALPAGECNT. If PGFLQUOTA exceeds VIRTUALPAGECNT, run
AUTHORIZE and reduce the PGFLQUOTA value to not exceed
VIRTUALPAGECNT.
2.0 USING SETL
File USER.DOC contains the user manual. The easiest way to use
SETL is to use the SETL command, which is described in user
manual and help files. The user manual is more up to date, and
any differences between help files and user manual should be
resolved in favor of user manual.
3.0 SHAREABILITY, USING THE FOREIGN LANGUAGE INTERFACE
If you plan to use the interface to other languages described in
the user manual, or if you anticipate that many users may be
using the system at the same time, then you should install the
shared version of the system as follows:
1. To install STLSHR.EXE,the system manager should add the
following line to the system startup INSTALL file:
nyu$setl:stlshr /open/share/header
This will improve performance if several users may be
using SETL at the same time, but is not required.
SETL VAX VMS V2 INSTALLATION Page 5
4.0 HARD CODE SYSTEM
The hard code system includes the files STLSYM.MAR, STLMAC.MLB,
STLHCO.OBJ and STLASM.EXE; these files may be deleted if you do
not plan to use the hard code system. If you are going to use
the hard code system you should install STLSHR.EXE as described
above.
5.0 EXPIRATION CHECK
Be warned that an "expiration date" exists: the supplied .EXE
files will attempt to become non-functional a year after their
creation. Warning messages are issued during the month before
expiration. The expiration feature has been included to limit
the effects of unauthorized copying of the system, and to
maintain our control over the distributed system.