VAX LISP/VMS Installation Guide
Contents
1. e VAX LISP naming conventions e Contents of the distribution Kit e VAX VMS system management e VAX LISP VMS installation prerequisites 1 1 VAX LISP NAMING CONVENTIONS VAX LISP is implemented on both the VMS and the ULTRIX 32 operating systems VAX LISP as implemented on the VMS operating system is formally named VAX LISP VMS VAX LISP as implemented on the ULTRIX operating system is formally named VAX LISP ULTRIX VAX LISP VMS and VAX LISP ULTRIX are the same language but with some specific operating system differences For the differences see the VAX LISP VMS Release Notes described in Section 1 2 2 This manual describes VAX LISP VMS but refers to VAX LISP VMS as VAX LISP whenever possible 1 2 CONTENTS OF THE DISTRIBUTION KIT The VAX LISP VMS distribution kit contains seven manuals and distribution volume PREPARING FOR THE INSTALLATION 1 2 1 Documentation The seven manuals in the distribution kit are e COMMON LISP The Language by Guy Steele e VAX LISP VMS Editor Programming Guide VAX LISP VMS Graphics Programming Guide e VAX LISP VMS Installation Guide this manual e VAX LISP VMS System Access Programming Guide VAX LISP VMS System Building Guide e VAX LISP VMS User s Guide 1 2 2 Software The distribution volume contains the files for the VAX LISP product in four savesets LISPnnn A Installation procedure and release notes LISPnnn B LISP executable image on line documentation and Installatio2. For a complete list of VAX VMS documents see the VAX VMS Master Index If you are installing VAX LISP on the MicroVMS operating system see the MicroVMS User s Manual 1 4 VAX LISP VMS INSTALLATION PREREQUISITES Before you begin the installation procedure make sure you have the necessary software documentation and prerequisites The prerequi sites listed below are the minimum amounts needed to install VAX LISP The installation procedure will fail if any of these parameters are below the required value If you have an AI VAXstation you may want more than the minimum number for your virtual page count and user authorization quotas The recommended values may be set before or after the installation See Section 3 3 for recommended system parameters and authorization quotas on a typical AI VAXstation Prerequisites Access to the system manager s account e A valid VAX VMS operating system configuration with VAX VMS V4 4 or later e Adequate amounts or values for PREPARING FOR THE INSTALLATION System disk blocks Global pages GBLPAGES and sections GBLSECTIONS Virtual page count VIRTUALPAGECNT User authorization quotas User disk block quota The following sections explain all but the first two prerequisites NOTE If you modify any of the SYSGEN parameters in SYSSSYSTEM MODPARAMS DAT Section 3 3 1 you must run the AUTOGEN utility to _ re compute your system parameters To do so enter the followi
3. You need approximately 5060 global pages to install the VAX LISP VMS image LISP EXE You can install this image as you do any other image If you install it users of the VAX LISP VMS system share the read only section of the image reducing physical memory requirements and making image activation faster Install LISP EXE by putting the following two lines in the file LISPSITE COM INSTALL SSYSSSYSTEM INSTALL COMMAND MODE INSTALL LISPSSYSTEM LISP OPEN HEADER_RESIDENT SHARED COMPLETING THE INSTALLATION NOTE You must surround any installation commands in LISPSITE COM with the SET NOON do not check for errors and SET ON check for errors commands Symbol definitions as in the preceding example INSTALL SSYSSSYSTEM INSTALL must be local not global 3 3 TUNING THE VAXSTATION You can tune your AI VAXstation in two ways e By adjusting parameter values in your system parameters file e By adjusting authorization quotas in your user accounts 3 3 1 Recommended System Parameters The following sample MODPARAMS DAT file is for a typical monochrome AI VAXstation The values of these AUTOGEN parameters are recommended for optimal performance of VAX LISP on an AI VAXstation with 9 mega bytes of memory Sample SYSSSYSTEM MODPARAMS DAT File Site specific AUTOGEN data file In a VAXcluster where a common system disk is being used this file should reside in SYSSSPECIFIC SYSEXE not a common syste
4. This procedure is invoked by the lispstart procedure Remove comments and alter this file to suit your site DEFINE SYSTEM EXECUTIVE LISPSTIME ZONE O0 DEFINE SYSTEM EXECUTIVE LISPSDAYLIGHT SAVING TIME P NO DEFINE SYSTEM EXECUTIVE LISPSSHORT SITE NAME DEFINE SYSTEM EXECUTIVE LISPSLONG SITE NAME DEFINE SYSTEM EXECUTIVE LISPSMACHINE INSTANCE SET NOON INSTALL SYSSSYSTEM INSTALL COMMAND MODE SET ON EXIT UY Ur 4 UE HY UU XY Ur You can add to this file any other site specific commands for starting VAX LISP i To install your system shareable delete the comment character from the beginning of each command between SET NOON and SET ON in the default LISPSITE COM file 3 2 1 Defining the LISP System Logical Names The following list describes the LISP system logical names shows how to define them e LISPSTIME ZONE Define LISPSTIME ZONE to indicate your local time zone relative to Greenwich Mean Time GMT The value can be an integer or a floating point number in the range 0 inclusive to 24 exclusive Floating point numbers are used when an area is not in a full hour time zone and are specified by the format hour fraction TO determine your local time zone consult an atlas 3 2 INSTALL CREATE LISPSSYSTEM LISP OPEN HEADER RESIDENT SHARED COMPLETING THE INSTALLATION Examples DEFINE SYSTEM EXECUTIVE LISPSTIME ZONE 4 5 Newfoundland DEFINE SYSTEM EXECUTIVE LISP
5. See the VAX LISP User s Guide for a description of the LISP MEMORY command Use the following format to change a user s paging file quota UAF MODIFY user name PGFLQUOTA value Example UAF MODIFY JONES PGFLQUOTA 20000 e Working set quota WSQUOTA The amount of physical memory required to execute a LISP program depends on the nature of the program DIGITAL recommends that each LISP user doing development work have a minimum working set quota of 1500 pages of physical memory Use the following format to change this quota UAF MODIFY user name WSQUOTA value Example UAF gt MODIFY JONES WSQUOTA 1500 e Working set extent quota WSEXTENT The WSEXTENT quota allocates the amount of physical memory given to a process when the system has an excess of free pages Use the following format to change this quota UAF gt MODIFY user name WSEXTENT value Example UAF MODIFY JONES WSEXTENT 10000 1 4 5 User Disk Block Quota VAX LISP provides a facility that enables users 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 requires a large amount of disk space users may need increased disk quotas You can change these quotas with the DISKQUOTA utility To enter that utility type the command RUN SYSSSYSTEM DISKQUOTA DISKQ PREPARING FOR THE INSTALLATION To leave the DISKQUOTA utility type EXIT or CTRL Z When you
6. are in the DISKQUOTA utility use the following format to change a user disk quota DISKQ MODIFY uic PERMQUOTA quota OVERDRAFT quota plus Example DISKQ MODIFY 300 211 PERMQUOTA 20000 2 INSTALLATION AND VERIFICATION 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 to the system manager s account or to an account with the same privileges as the system manager s account can perform the installation procedure The VMSINSTAL procedure is automated and self explanatory takes approximately 15 minutes 25 on a MicroVAX The procedure prompts you to mount the software distribution volume and to respond to questions during the installation Most of the questions can be answered with YES or NO default response is enclosed in square brackets To choose the default response just press the RETURN key Or enter your response and press the RETURN key If you need help with a question type a question mark and press the RETURN key It s a good idea to back up your system disk before installing layered product 2 1 STARTING THE VMSINSTAL PROCEDURE To start the VMSINSTAL procedure 1 Make sure the installation prerequisites listed in Section 1 4 have been met The Guide to VAX VMS Softwa
7. directory VMISROOT VAXLISP LIBRARY SVMSINSTAL I RESTORE Restoring product saveset D VMSINSTAL I MOVEFILES Files will now be moved to their target directories Executing VAX LISP startup procedure VAX LISP Installation Verification Procedure IVP Starting compilation of file VMISROOT SYSUPD LISPO22 LISPIVP LSP 1 FIBONACCI compiled PRINT FIBONACCI compiled Finished compilation of file VMISROOT SYSUPD LISPO22 LISPIVP LSP 1 0 Errors 0 Warnings Welcome to VAX LISP version V2 2 INSTALLATION AND VERIFICATION A table of the first 20 Fibonacci numbers n Fibonacci n 0 0 1 1 2 1 3 2 4 3 5 5 6 8 Fi 13 8 21 9 34 10 55 11 89 12 144 13 233 14 377 15 610 16 987 17 1 597 18 2 584 19 4 181 VAX LISP V2 2 IVP Completed Successfully Installation of LISP V2 2 completed at 16 22 VMSINSTAL procedure done at 16 22 3 2 4 2 Sample Update Installation This example illustrates an update installation on MicroVAX with Version 2 1 of VAX LISP VMS already present Version 2 1 will be saved to the directory VMISROOT VAXLISP V021 Only the VAX LISP product files will be installed S SYSSUPDATE VMSINSTAL LISP MUAO VAX VMS Software Product Installation Procedure It is 10 APR 1987 at 16 30 Enter a question mark at any time for help 2 8 INSTALLATION AND VERIFICATION Are you satisfied with the backup of your system disk YES RET The following products will be processed LIS
8. so type CTRL Z to leave the SYSGEN utility and enter the commands INSTALL SYSSSYSTEM INSTALL COMMAND MODE INSTALL INSTALL LIST GLOBAL SUMMARY These commands display Global Sections Used and Global Pages Used Take these values and subtract them from the values you previously obtained from the SYSGEN utility If you do not have enough global sections and global pages you must modify the GBLSECTIONS and or GBLPAGES parameters To modify these values edit SYSSSYSTEM MODPARAMS DAT to include the lines ADD GBLPAGES 5060 ADD GBLSECTIONS 4 NOTE Using the ADD prefix with these parameters increases them by the amount you supply in each subsequent GENPARAMS phase of AUTOGEN After many executions of AUTOGEN parameters can become undesirably large You can avoid this problem by commenting out the ADD lines in MODPARAMS DAT after the first execution of the GENPARAMS phase of AUTOGEN 1 4 3 Virtual Page Count VIRTUALPAGECNT The default VAX LISP product requires approximately eight megabytes of address space In addition the value of the SYSGEN parameter VIRTUALPAGECNT must be approximately 16 000 virtual pages for VAX LISP to execute This value must be larger if you want to increase the size of the LISP system s dynamic memory with the LISP MEMORY command See the VAX LISP User s Guide for a description of the LISP MEMORY command PREPARING FOR THE INSTALLATION NOTE If you increase the virtual page coun
9. to install the saveset Enter NO if you do not You can install all three savesets now or you install only the product files the LISP executable image on line documentation library and Installation Verification Procedure Saveset B contains everything needed to run VAX LISP You can install additional savesets at any time by running VMSINSTAL again and selecting different savesets Specify location You must now tell VMSINSTAL the desired location of the saveset you selected in step 2 Continuing with saveset B as the example In which directory are the VAX LISP product files to be installed SYSSSYSROOT VAXLISP INSTALLATION AND VERIFICATION Press the RETURN key if you are satisfied with the default directory or enter a different location If the directory you specify does not already exist the procedure asks Directory SYS SYSROOT VAXLISP does not exist Should it be created YES 4 Save previous version optional This step is not executed unless a previous version of VAX LISP is already installed in the default directory VAX LISP users can create suspended systems that contain LISP programs and data A suspended system depends on the version of VAX LISP used to create it Since the installa tion procedure overwrites any previous version of VAX LISP in the default directory installing the new version makes user created suspended systems unuseable You may want to save your previous version of V
10. AX LISP so that users resume their suspended systems To save the previous version of VAX LISP you can allow the procedure to move it to another directory before you install the new version in SYSSSYSROOT VAXLISP Do you want to save the previous version of VAX LISP nnnn blocks NO If you do not want to save your previous version enter NO or press RETURN and skip the rest of this step If you do want to save it enter YES The procedure now asks for a new location for VAX LISP In which directory should the previous version be saved VMISROOT VAXLISP V021 Enter your own directory or just press RETURN to use the de fault The default directory automatically includes the correct version number Again if the directory does not exist the procedure asks for confirmation Directory VMISROOT VAXLISP V021 does not exist Should it be created YES See Chapter 3 of this manual for directions on using the old version of VAX LISP after you have moved it out of SYSSSYSROOT VAXLISP Steps 2 and 3 repeat for each of the other savesets on the tape INSTALLATION AND VERIFICATION 5 Verifying the installation If you have selected saveset B the last prompt asks whether you want to run the Installation Verification Procedure IVP after the installation is complete Do you want to run the IVP after the installation YES Press RETURN or enter YES only if you have properly confi gured your system according
11. FILE After the installation procedure is concluded add the following line to your site specific system startup file SYSSMANAGER SYSTARTUP COM GSYSSMANAGER LISPSTART This command line invokes the VAX LISP system startup procedure every time you boot your system The startup procedure defines the system logical name LISPSSYSTEM to mean the VAX LISP product directory and defines the logical name LISPSEXAMPLES to mean the examples directory 3 2 MODIFYING THE VAX LISP STARTUP FILE When you boot your VAX VMS system the file SYSSMANAGER SYSTARTUP COM invokes the LISP command file LISPSTART COM which in turn invokes the file SYSSMANAGER LISPSITE COM This last command file is default Site specific startup procedure for VAX LISP This file includes default LISP system logical names and default commands for installing shareable sections You should modify the logical name definitions to make them appropriate for your site COMPLETING THE INSTALLATION If your VAX LISP system has only one user or if enough global pages are not available you may not want to install LISP shareable The benefit of installing shareable sections is that multiple users running VAX LISP use only one copy of the LISP system rather than a separate copy for each user thereby saving valuable system resources This skeleton LISPSITE COM file will be installed in SYSSMANAGER provided such a file is not already there VAX LISP site specific startup procedure
12. MANAGER LISPSITE TXT contained the following text COMPLETING THE INSTALLATION Super Widget Development Group Intelligent Widget Corporation One First Street Any Town Massachusetts 01001 You can define LISPSLONG SITE NAME by placing an at sign 8 in front of the name of the text file you created Example DEFINE SYSTEM EXECUTIVE LISPSLONG SITE NAME SYSSMANAGER LISPSITE TXT LISPSMACHINE_INSTANCE Define LISPSMACHINE_INSTANCE as a string that identifies the specific computer which VAX LISP is running This string is returned by the LISP MACHINE INSTANCE function An example is Super Widget VAX 11 785 Example S DEFINE SYSTEM EXECUTIVE LISPSMACHINE INSTANCE Super Widget VAX 11 785 If this logical name is not defined and you are running DECnet your computer s node name is used as the machine instance In the preceding list of system logical names the two logical names LISPSTIME ZONE LISPSDAYLIGHT SAVING TIME P used by the LISP function GET DECODED TIME which is described in COMMON LISP The Language The functions SHORT SITE NAME LONG SITE NAME and MACHINE INSTANCE are described in the VAX LISP User s Guide 3 2 2 Installing the Shareable Sections If more than one user is on your VAX LISP system you may want to install it as a shareable system The following explanation describes how to install and delete shareable sections and the amount of global pages you need to install them
13. O 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 NO POSTAGE NECESSARY IF MAILED IN THE UNITED STATES Cut Along Dotted Line
14. P V2 2 Beginning installation of LISP V2 2 at 16 31 VMSINSTAL I RESTORE Restoring product saveset A SVMSINSTAL I RELMOVED The products release notes have been successfully moved to SYSSHELP Do you want to purge files replaced by this installation YES RET The LISP installation kit contains the VAX LISP product files some example files and some special library files for building customized LISP systems It is possible to install just VAX LISP and nothing else It is also possible to install just the examples or just the library files or any combination of these Enter YES to this question if you wish to install VAX LISP at this time Enter NO to this question if you only wish to install the examples and or library files at this time Do you wish to install the VAX LISP product files 11500 blocks YES RET In which directory are the VAX LISP product files to be installed SYSSSYSROOT VAXLISP RET Do you want to save the previous version of VAX LISP 9151 blocks NO YES In which directory should the previous version be saved VMISROOT VAXLISP V021 RET Directory VMISROOT VAXLISP V021 does not exist Should it be created YES RET Do you wish to install the VAX LISP examples 203 blocks NO lt RET gt Do you wish to install the VAX LISP ding library files 13500 blocks NO RET Do you want to run the IVP after the installation YES RET VMSIN
15. STAL I SYSDISK This product creates system disk directory VMISROOT VAXLISP V021 SVMSINSTAL I RESTORE Restoring product saveset Bi VMSINSTAL I MOVEFILES Files will now be moved to their target directories Executing VAX LISP startup procedure VAX LISP Installation Verification Procedure IVP Starting compilation of file VMISROOT SYSUPD LISP022 LISPIVP LSP 1 2 9 INSTALLATION AND VERIFICATION FIBONACCI compiled PRINT FIBONACCI compiled Finished compilation of file VMISROOT SYSUPD LISPO22 LISPIVP LSP 1 0 Errors 0 Warnings Welcome to VAX LISP version V2 2 A table of the first 20 Fibonacci numbers n Fibonacci n 0 0 1 1 2 1 3 2 4 3 5 5 6 8 7 13 8 21 9 34 10 55 11 89 12 144 13 233 14 377 15 610 16 987 17 1 597 18 2 584 19 4 181 VAX LISP V2 2 IVP Completed Successfully Installation of LISP V2 2 completed at 16 55 VMSINSTAL procedure done at 16 55 3 CHAPTER 3 COMPLETING THE INSTALLATION To complete a new installation of VAX LISP VMS you must modify the Site specific system startup file SYSSMANAGER SYSTARTUP COM You should also modify the default site specific startup file for VAX LISP SYSSMANAGER LISPSITE COM you are installing VAX LISP on an AI VAXstation read Section 3 3 on recommended system parameters authorization quotas Section 3 4 explains how to use a previous version of VAX LISP that has been moved out of the main directory 3 1 MODIFYING THE SYSTEM STARTUP
16. STEM LISPIVP INSTALLATION AND VERIFICATION 2 4 TWO SAMPLE INSTALLATION PROCEDURES Two sample installation procedures follow The first is a new instal lation and the second is an update installation 2 4 1 Sample New Installation This example illustrates the first installation of VAX LISP VMS on a VAX Since no previous version is present the installation procedure does not ask whether you want to save it S QSYSSUPDATE VMSINSTAL LISP MFAO VAX VMS Software Product Installation Procedure It is 10 APR 1987 at 16 10 Enter a question mark at any time for help Are you satisfied with the backup of your system disk YES RET The following products will be processed LISP V2 2 Beginning installation of LISP V2 2 at 16 10 SVMSINSTAL I RESTORE Restoring product saveset A SVMSINSTAL I RELMOVED The products release notes have been successfully moved to SYSSHELP Do you want to purge files replaced by this installation YES RET LISP installation kit contains the VAX LISP product files some example files and some special library files for building customized LISP systems It is possible to install just VAX LISP and nothing else It is also possible to install just the examples or just the library files or any combination of these Enter YES to this question if you wish to install VAX LISP at this time Enter NO to this question if you only wish to install the examples and or library f
17. STIME ZONE 5 Boston DEFINE SYSTEM EXECUTIVE LISPSTIME ZONE 8 San Francisco DEFINE SYSTEM EXECUTIVE LISPSTIME ZONE 12 75 Chatham Island DEFINE SYSTEM EXECUTIVE LISPSTIME ZONE 23 Munich NOTE This logical name is required LISPSDAYLIGHT SAVING TIME P Define LISPSDAYLIGHT SAVING TIME P to specify whether you 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 changes In the following example the NO after the logical name means it is not daylight saving time Example DEFINE SYSTEM EXECUTIVE LISPSDAYLIGHT SAVING TIME P NO LISPSSHORT SITE NAME Define LISPSSHORT SITE NAME to specify a short string that describes your site This string is returned by the LISP SHORT SITE NAME function An example is Widget Group Example S DEFINE SYSTEM EXECUTIVE LISPSSHORT SITE NAME Widget Group LISPSLONG SITE NAME Define LISPSLONG SITE NAME to specify a long string that describes your site This string is returned by the LISP LONG SITE NAME function An example is Super Widget Develop ment Group Widget Corp Example DEFINE SYSTEM EXECUTIVE LISPSLONG SITE NAME Super Widget Development Group Widget Corp If you would like the long site name to occupy several lines you can create text file for it Then refer to the text file with the logical name Suppose for example that the file SYSS
18. VAX LISP VMS Installation Guide Order No AA Y922D TE July 1987 This document contains instructions for installing VAX LISP VMS on the VMS operating system Revislon Update Information This is a revised manual Operating System and Version VAX VMS Version 4 4 Software Version VAX LISP VMS Version 2 2 Digital Equipment Corporation Maynard Massachusetts First Printing June 1984 Revised December 1984 Revised May 1986 Revised July 1987 The information in this document is subject to change without notice and should not be construed as a commitment by Digital Equipment Corporation Digital Equipment Corporation assumes no responsibility for any errors that may appear in this document The software described in this document is furnished under a license and may be used or copied only in accordance with the terms of such license No responsibility is assumed for the use or reliability of software on equipment that is not supplied by Digital Equipment Corporation or its affiliated companies Copyright 1984 1986 1987 by Digital Equipment Corporation All Rights Reserved Printed in U S A The READER S COMMENTS form on the last page of this document requests the user s critical evaluation to assist in preparing future documentation The following are trademarks of Digital Equipment Corporation AI VAXstation MicroVMS VAX DEC PDP VAXstation DECnet ULTRIX VAXstation II DECUS ULTRIX 11 VMS MicroVAX ULTRIX 32 Mic
19. ased by AWSA Maximum amount of virtual pages a process can map The following three values are recommended for a VAXstation II GPX CTLPAGES 850 SPTREQ 2300 NPAGEDYN 450000 These values are only system should Used with workstation windows Required number of system page table entries Size of the non paged dynamic pool in pages NOTE recommended for a 9 megabyte not be used on systems with less than 9 megabytes of memory Using these values on systems with less than 9 megabytes could prevent your workstation from booting The values are valid only fora system that can be characterized as a single use system running primarily VAX LISP Although running only VAX LISP is not a requirement these values tune the system to run VAX LISP efficiently and may have an adverse effect on systems that heavily use other products concurrently with VAX LISP Therefore you should review the requirements of other products and evaluate these recommended values in that context 3 6 COMPLETING THE INSTALLATION To adjust your system s parameter values 1 Add the preceding values to the file SYSSSYSTEM MODPARAMS DAT 2 Reconfigure your system using the AUTOGEN utility by executing the 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
20. iles at this time Do you wish to install the VAX LISP product files 11500 blocks YES RET In which directory are the VAX LISP product files to be installed SYSSSYSROOT VAXLISP RET 2 6 INSTALLATION AND VERIFICATION Directory SYSSSYSROOT VAXLISP does not exist Should it be created YES RET Do you wish to install the VAX LISP examples 5000 blocks NO YES In which directory are the VAX LISP examples to be installed SYSSSYSROOT VAXLISP EXAMPLES RET Directory SYSSSYSROOT VAXLISP EXAMPLES does not exist Should it be created YES RET Do you wish to install the VAX LISP system building library files 13500 blocks NO YES In which directory are the VAX LISP system building library files to be installed SYSSSYSROOT VAXLISP LIBRARY RET Directory SYSSSYSROOT VAXLISP LIBRARY does not exist Should it be created YES RET Do you want to run the IVP after the installation YES RET VMSINSTAL I SYSDISK This product creates system disk directory VMISROOT VAXLISP SVMSINSTAL I RESTORE Restoring product saveset B LISP I SITESTART A skeleton site specific startup procedure LISPSITE COM LISP I SITESTART has been provided in SYSSMANAGER VMSINSTAL I SYSDISK This product creates system disk directory VMISROOT VAXLISP EXAMPLES SVMSINSTAL I RESTORE Restoring product saveset C VMSINSTAL I SYSDISK This product creates system disk
21. m directory l Add modifications that you wish to make to AUTOGEN s hardware configuration data system parameter calculations and page swap and dump file sizes to the bottom of this file CHANNELCNT 2048 CTLPAGES 500 SPTREQ 2000 Number of allowed channels Used with workstation windows Required number of system page table entries MPW HILIMIT 2500 Modified page list size at which writing to free list page occurs Wait limit number of pages on the modified page list this number must be greater than or equal to the MPW HILIMT number or a system 3 deadlock will occur MPW_WAITLIMIT 2500 3 5 COMPLETING THE INSTALLATION MPW LOLIMIT 500 NPAGEDYN 330000 PAGFILCNT 1 PAGEFILE 30000 PAGEDYN 4000000 PHYSICALPAGES 18432 SWPFILCNT 1 SWAPFILE 8000 WSMAX 12000 WSINC 350 WSDEC 0 VIRTUALPAGECNT 30000 Writing of the modified page list stops when it is less than or equal to the MPW_LOLIMIT number Size of the non paged dynamic pool in pages 1 page file the maximum number of page files that can be installed Size of a page file in pages Size of the paged dynamic pool in pages 9 megabytes of physical memory 1 swap file the maximum number of swapping that can be installed Size of a swap file in pages Maximium working set size Amount by which the working set of a process is increased by AWSA Automatic Working Set Adjustment Amount by which the working set of a process is decre
22. ment of Canada Ltd documentation 100 Herzberg Road Kanata Ontario Canada K2K 2A6 613 592 5111 Attn Direct Order desk for hardware documentation Internal orders Software Distribution Center SDC for software Digital Equipment Corporation documentation Westminster MA 01473 Internal orders 617 234 4323 Publishing amp Circulation Serv P amp CS for hardware NR03 1 W3 documentation Digital Equipment Corporation Northboro MA 01532 VAX LISP VMS Installation Guide AA Y922D TE READER S Note This form is for document comments only DIGITAL will use comments submitted on this form at the company s discretion If you require a written COMMENTS 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 specify OOOOOO Name Date Organization Street City ee tt Us Zi Code or Country Do Not Tear Fold Here and Tape 4 Do Not Tear Fold Here BUSINESS REPLY MAIL FIRST CLASS PERMIT N
23. n Verification Procedure LISPnnn C Examples of LISP source code LISPnnn D System Building utility libraries where nnn is the VAX LISP version number When you finish the installation procedure these files are installed in your system in the following way e The system manager s directory SYSSMANAGER will contain the files LISPSTART COM and LISPSITE COM e The system help directory SYSSHELP will contain the release notes in the file LISPnnn RELEASE NOTES where nnn is the VAX LISP version number For example file LISPO20 RELEASE NOTES contains the release notes for VAX LISP Version 2 0 e The product directory SYSS SYSROOT VAXLISP by default will contain LISP EXE LISP executable image LISPDOC TLB LISP on line documentation library LISPIVP COM Installation Verification Procedure IVP PREPARING FOR THE INSTALLATION e The EXAMPLES subdirectory of the product directory will con tain sample LISP source files e The LIBRARY subdirectory of the product directory will contain the System Building utility files 1 3 VAX VMS SYSTEM MANAGEMENT For information on system installation utilities operation and man agement not covered by the VAX LISP VMS documentation see the appropriate VMS documentation If you are installing VAX LISP the VMS operating system the following documents may be useful e Guide to VAX VMS System Management and Daily Operations e Guide to VAX VMS Software Installation e VAX VMS Utilities
24. ng command SYSSUPDATE AUTOGEN SAVPARAMS REBOOT Since these parameters are not dynamic your system will then need to be rebooted AUTOGEN will perform an automatic shutdown and reboot when it has finished 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 Utilities 1 4 1 System Disk Blocks The installation of VAX LISP VMS requires approximately 60 000 free blocks on the system disk After the installation approximately 30 000 blocks on the disk containing the product directory are occupied Saveset B occupies approximately 11 500 blocks saveset C approximately 5 000 and saveset D approximately 13 500 1 4 2 Global Pages GBLPAGES and Sections GBLSECTIONS You need approximately 5060 global pages and 4 global sections to install the VAX LISP VMS image LISP EXE and to make it shareable You may need to adjust the values of the system generation SYSGEN parameters GBLPAGES and GBLSECTIONS before installing LISP EXE TO determine the current value of GBLSECTIONS and GBLPAGES enter the following SYSGEN utility commands 1 4 PREPARING FOR THE INSTALLATION S RUN SYSSSYSTEM SYSGEN SYSGEN SHOW GBLSECTIONS SYSGEN SHOW GBLPAGES Note the values that are displayed Next you must determine how many global pages and global sections are actually in use your system do
25. ot satisfied type NO and provide for a backup see the Guide to VAX VMS Software Installation If you type NO the procedure ends When you are ready start again If you type YES or press the RETURN key the installation starts 2 2 INSTALLING VAX LISP VMS The installation consists of the following five steps 1 Purge files 2 2 INSTALLATION AND VERIFICATION The installation procedure first reads the tape and displays the product s it contains The following products will be processed LISP V2 2 Beginning installation of LISP V2 2 at hh mm SVMSINSTAL I RESTORE Restoring product saveset A SVMSINSTAL I RELMOVED The products release notes have been successfully moved to SYSSHELP Next it asks whether you want to purge any files replaced during the course of the installation Do you want to purge files replaced by this installation YES Just press the RETURN key if you want to purge the old files or enter NO if you want to keep them See also step 4 below on saving the previous version The installation procedure now displays a help message explaining the contents of the savesets and your options for installing them Select a saveset The procedure now asks whether you want to install the next saveset on the tape and displays the size of the saveset On saveset B for example it asks Do you wish to install the VAX LISP product files 11500 blocks YES Press the RETURN key if you do want
26. re Installa tion describes all the VMSINSTAL prerequisites 2 Log into the system manager s account Installations are usually done from the console terminal but can be done from any terminal INSTALLATION AND VERIFICATION If a previous version of VAX LISP is installed make sure you have edited your LISPSITE COM procedure as described in Section 3 2 2 Pay particular attention to the notes in that section Invoke the VMSINSTAL procedure by using a command of the form SYSSUPDATE VMSINSTAL LISP device where device is the name of the device on which you must mount the VAX LISP distribution volume such as MFAO or MUAO When you specify a device name type a colon after the name For example QGSYSSUPDATE VMSINSTAL LISP MFAO After you invoke VMSINSTAL the following messages displayed on your output device VAX VMS Software Product Installation Procedure It is dd mmm yyyy at hh mm Enter a question mark at any time for help You may receive warning messages from VMSINSTAL if for example your DECnet network is still up and running Check the Guide to VAX VMS Software Installation for VMSINSTAL error messages and recommended actions Once all VMSINSTAL prerequisites are met the procedure displays Are you satisfied with the backup of your system disk YES Respond to the backup question If you are satisfied with the backup of your system disk type YES or press the RETURN key If you are n
27. re product you should read this manual To perform the installation you must have access to a privileged system manager s account and be familiar with VAX VMS installation procedures for layered products Structure of This Manual The manual is divided into three chapters and one appendix e Chapter 1 Preparing for the Installation describes the prerequisites for installing and verifying VAX LISP e Chapter 2 Installation and Verification explains the procedure for installing and verifying VAX LISP e Chapter 3 Completing the Installation gives information needed to complete the installation e The Appendix Problem Determination and Reporting shows how to report a defect in the product Conventions Convention Meaning UPPERCASE characters In examples indicate that you should type the word or letter exactly as shown For example RUN SYSSSYSTEM SYSGEN Convention lowercase italics Red print Black print PREFACE Meaning In examples italics indicate that you are to substitute a word or value of your choice For example UAF MODIFY user name PGFLQUOTA value In examples indicates user input For example INSTALL LIST GLOBAL SUMMARY In examples indicates output lines or prompting characters that the system displays For example SYSGEN SHOW GBLSECTIONS vi CHAPTER 1 PREPARING FOR THE INSTALLATION Before you install the VAX LISP VMS language you should be familiar with
28. roVAX II UNIBUS PREFACE CHAPTER 1 121 1 2 1 2 1 1 2 2 1 3 1 4 1 4 1 1 4 2 1 4 3 1 4 4 1 4 5 CHAPTER 2 2 1 2 2 2 3 2 4 2 4 1 2 4 2 CHAPTER 3 3 1 3 2 3 2 1 3 2 2 353 323 1 3 3 2 3 4 APPENDIX A CONTENTS PREPARING FOR THE INSTALLATION VAX LISP NAMING CONVENTIONS CONTENTS OF THE DISTRIBUTION KIT Documentation Software VAX VMS SYSTEM MANAGEMENT VAX LISP VMS INSTALLATION PREREQUISITES System Disk Blocks Global Pages GBLPAGES and Sections GBLSECTIONS Virtual Page Count VIRTUALPAGECNT User Authorization Quotas User Disk Block Quota INSTALLATION AND VERIFICATION STARTING THE VMSINSTAL PROCEDURE INSTALLING VAX LISP VMS VERIFYING THE INSTALLATION TWO SAMPLE INSTALLATION PROCEDURES Sample New Installation Sample Update Installation COMPLETING THE INSTALLATION MODIFYING THE SYSTEM STARTUP FILE MODIFYING THE VAX LISP STARTUP FILE Defining the LISP System Logical Names Installing the Shareable Sections TUNING THE AI VAXSTATION Recommended System Parameters Recommended Authorization Quotas USING PREVIOUS VERSIONS OF VAX LISP PROBLEM DETERMINATION AND REPORTING iii Page PPRPP PPP 1 amp 0 ID BS PPP 1 1 1 SH WWW UJ C2 CO J U AN PP PREFACE Manual Objectives This manual explains how to install verify and manage VAX LISP VMS Intended Audience If you are responsible for installing and maintaining the VAX LISP softwa
29. standard LISP command to invoke the old version of the LISP system APPENDIX A PROBLEM DETERMINATION AND REPORTING If an error occurs while you are using VAX LISP VMS and you believe that the error is a result of a defect in the product you should report the error to DIGITAL using a Software Performance Report SPR form In particular an error message preceded by Internal error is caused by the failure of an internal consistency check and should be reported Along with the SPR form you should include e The operating system name and version which you can obtain with the SOFTWARE TYPE and SOFTWARE VERSION functions e The version number of VAX LISP VMS which is part of the greeting message when you start VAX LISP e complete description of the problem e A listing reduced to the shortest form possible of the LISP program that caused the error Include initialization files or macro definitions that are pertinent e If possible use the DRIBBLE function see COMMON LISP The Language to place the error output in a file and include a listing of the file HOW TO ORDER ADDITIONAL DOCUMENTATION From Call Write Alaska Hawaii 603 884 6660 or New Hampshire Digital Equipment Corporation P O Box CS2008 Rest of U S A 800 258 1710 Nashua NH 03061 and Puerto Rico Prepaid orders from Puerto Rico must be placed with DIGITAL s local subsidiary 809 754 7575 Canada 800 267 6219 for software Digital Equip
30. t you may also need to increase the size of your paging file You can display statistics about your paging file use with the DCL command SHOW MEMORY FILES To determine the current value of VIRTUALPAGECNT enter the SYSGEN utility commands RUN SYS SYSTEM SYSGEN SYSGEN SHOW VIRTUALPAGECNT To modify these values edit SYSSSYSTEM MODPARAMS DAT to include a line in the following format VIRTUALPAGECNT value 1 4 4 User Authorization Quotas The system manager s account and accounts for VAX LISP users must have adequate user authorization quotas for paging files and working sets These quotas PGFLQUOTA WSQUOTA and WSEXTENT are set with the AUTHORIZE utility To invoke the AUTHORIZE utility specify the following commands SET DEFAULT SYSSSYSTEM RUN AUTHORIZE UAF gt NOTE When the system manager changes a user authorization quota including the system manager s own quota with the AUTHORIZE utility the quota is not changed until the user logs out of the system and then logs back in Once you have invoked the AUTHORIZE utility you can set each of the quotas with the commands below To leave the AUTHORIZE utility type EXIT or CTRL Z Paging file quota PGFLQUOTA A VAX LISP user requires a minimum paging file quota of 10 500 pages However this quota must be larger if users want to increase the size of the LISP system s dynamic memory with the 1 6 PREPARING FOR THE INSTALLATION LISP MEMORY command
31. the VAX VMS Utilities Volume 4C Since these parameters not dynamic your system will need to be rebooted AUTOGEN will perform an automatic shutdown and reboot when it has finished 38 3 2 Recommended Authorization Quotas The following are recommended authorization quotas for VAX LISP accounts on an AI VAXstation process can use in the system paging file WSDEFAULT 1024 Default working set size WSQUOTA 8000 Limit for the amount of physical memory a user process may lock into its working set WSEXTENT 18000 Absolute limit on physical memory the system allows the l process PGFLQUOTA 30000 Maximum number of pages a user s To adjust these quotas invoke the Authorize Utility as shown Section 1 4 5 of this manual See the VAX VMS Utilities Volume 4 for further information on the quotas 3 4 USING PREVIOUS VERSIONS OF VAX LISP The files comprising a saved version of VAX LISP are put in a subdirectory under the main VAX LISP directory referred to by the logical name 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 2 would be saved in the subdirectory V022 COMPLETING THE INSTALLATION To run a saved version of VAX LISP you must define the logical name LISPSSYSTEM to refer to the subdirectory containing the files of that saved version Then use the
32. to the prerequisites in Section 1 4 See the next section for more information on the IVP Once you have answered all its questions the installation procedure copies the files For example SVMSINSTAL I SYSDISK This product creates system disk directory SYSSSYSROOT VAXLISP SVMSINSTAL I RESTORE Restoring product saveset B SLISP I SITESTART A skeleton site specific startup procedure LISPSITE COM LISP I SITESTART has been provided in SYSSMANAGER VMSINSTAL I MOVEFILES Files will now be moved to their target directories You may receive additional messages depending on how many subsets you are installing and your system configuration for example a VAX cluster or an AI VAXstation 2 3 VERIFYING THE INSTALLATION The IVP creates compiles and executes a small LISP program Because VAX LISP will not run until you have properly configured your system you cannot run the IVP if you have not already configured your system During installation the VMSINSTAL procedure asks if you want to run the IVP If you have properly configured your system type YES The IVP runs prints a message when the program has been completed and the VMSINSTAL procedure automatically ends If you type NO VMSINSTAL ends without running the IVP You may want only to install VAX LISP now 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 LISPSSY
Download Pdf Manuals
Related Search