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.