DEC_Pascal____________________________________ Installation Guide for DEC OSF/1 AXP Systems Order Number: AA-PV38A-TE May 1993 This guide describes how to install DEC Pascal on an AXP processor (Alpha AXP architecture) running the DEC OSF/1 operating system, and how to read the online release notes. Revision/Update Information: This is a new guide. Operating System: DEC OSF/1 AXP Version 1.2 or higher. Future maintenance releases may require higher versions. Software Version: DEC Pascal for DEC OSF/1 AXP Systems Version 5.0. Digital Equipment Corporation Maynard, Massachusetts __________________________________________________________ First Printing, May 1993 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. 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. © Digital Equipment Corporation 1993. All Rights Reserved. The postpaid Reader's Comments forms at the end of this document request your critical evaluation to assist in preparing future documentation. The following are trademarks of Digital Equipment Corporation: AXP, Alpha AXP, Bookreader, DEC, DECstation, DECsystem, DECwindows, DECsupport, Digital, VAX, VAX DOCUMENT, and the DIGITAL logo. The following are third-party trademarks: OSF and OSF/1 are registered trademarks of the Open Software Foundation, Inc. PostScript is a registered trademark of Adobe Systems, Inc. ZK6085 This document is available on CD-ROM. This document was prepared using VAX DOCUMENT, Version 2.1. ________________________________________________________________ Contents Preface.................................................. v 1 Preparing for DEC Pascal Installation 1.1 Reading the Online Release Notes............. 1-2 1.2 The Software Distribution Kit................ 1-3 1.2.1 Contents of the Media CD................. 1-3 1.2.2 Contents of the Documentation CD......... 1-4 1.2.3 Read Before Installing or Using DEC Pascal Cover Letter...................... 1-4 1.3 Installation Procedure Requirements.......... 1-4 1.3.1 Login Privileges Required................ 1-4 1.3.2 Hardware Requirements.................... 1-5 1.3.3 Software Requirements.................... 1-5 1.3.4 Determining Which Subsets to Load........ 1-6 1.3.5 Disk Space Requirements.................. 1-8 1.3.5.1 Increasing Available Disk Space ....... 1-10 1.4 Registering the License Product Authorization Key.......................................... 1-12 1.5 Backing Up Your System Disk.................. 1-12 1.6 Stopping the Installation.................... 1-12 1.7 Error Recovery and Software Problem Reporting.................................... 1-13 1.7.1 Reporting DEC Pascal Software Errors..... 1-13 1.7.2 Recovering from Errors that Occur During the Installation Procedure............... 1-16 1.7.3 Reporting Documentation Errors........... 1-17 iii 2 Installing DEC Pascal 2.1 Using CD-ROM Consolidated Distribution Media for Local Installations...................... 2-1 2.1.1 Responding to Installation Procedure Prompts.................................. 2-2 2.1.1.1 Selecting DEC Pascal Subsets........... 2-2 2.1.1.2 Monitoring Displays During the Subset Loading Process........................ 2-3 3 After Installation 3.1 Running the Installation Verification Procedure.................................... 3-1 3.2 Deleting DEC Pascal from Your System......... 3-2 3.3 Run-Time Library Messages.................... 3-2 A Sample Listings A.1 Sample Listing of a DEC Pascal Installation................................. A-1 A.2 Sample Listing of a DEC Pascal Installation Verification Procedure....................... A-3 Tables 1-1 DEC Pascal Subset Sizes (Disk Space Requirements)............................ 1-8 iv ________________________________________________________________ Preface This guide explains how to install DEC Pascal on an AXP processor running the DEC OSF/1 AXP operating system, and how to read the online release notes. The installation procedure creates DEC Pascal directories subordinate to the /usr/lib/cmplrs and /usr/man directo- ries and loads DEC Pascal software and DEC Compiled Code Support Library subsets. Keep this guide with your software distribution kit (see Section 1.2). You will need it to install maintenance updates or to reinstall DEC Pascal for any other reason. Intended Audience This guide is intended for system managers who install DEC Pascal. The online release notes are intended for both system managers and DEC Pascal users. Structure of this Document This guide contains the following chapters and appendixes: o Chapter 1 describes the hardware and software requirements for DEC Pascal installation and related procedures that you complete before installing DEC Pascal. o Chapter 2 describes the DEC Pascal installation procedure. v o Chapter 3 describes the DEC Pascal Installation Verification Procedure (IVP) and any postinstallation procedures you must complete to use DEC Pascal. This chapter also describes how to remove DEC Pascal from your system. o Appendix A contains sample listings of a DEC Pascal installation and a DEC Pascal IVP. The DEC Pascal Documentation Set In addition to this guide, the DEC Pascal documentation set includes the following books: o DEC Pascal Language Reference Manual (AA-PWVSA-TK) o DEC Pascal User Manual for DEC OSF/1 AXP Systems (AA- PV37A-TE) Related Manuals The DEC OSF/1 AXP documentation set includes online reference pages and hardcopy documentation on installing software and on aspects of the programming environment. You may want to refer to the DEC OSF/1 Reader's Guide, which includes a list of books in the programmer's subkit. The following manuals in the DEC OSF/1 AXP documentation set contain information relevant to installing software: o Guide to Installing DEC OSF/1 AXP o Guide to System and Network Setup and Configuration o Guide to System Administration Release Notes and Online Reference Pages The DEC Pascal online release notes provide more information on this version of DEC Pascal. See Section 1.1 for the location and the command used to access the online release notes after they have been installed on your system. DEC Pascal also provides online reference pages that list compiler options, restrictions, and diagnostics. vi Conventions This guide uses the following documentation conventions: __________________________________________________________ Convention_______Meaning__________________________________ # A pound sign (#) is the default superuser prompt. % A percent sign (%) is the default user prompt. In examples, a boxed symbol indicates that you must press the named key on the keyboard. Ctrl/C This symbol indicates that you must press the Ctrl key while you simul- taneously press another key (in this case, C). Username: In interactive examples, prompts or # df /usr displayed text appears in a monospace font. User input appears in bold monospace font. monospaced In text, this font indicates the exact name of a command, routine, partition, pathname, directory, or file. This font is also used in interactive examples and other screen displays. UPPERCASE The DEC OSF/1 AXP operating system lowercase differentiates between lowercase and uppercase characters. Literal strings that appear in text, examples, syntax descriptions, and function definitions must be typed exactly as shown. vii __________________________________________________________ Convention_______Meaning__________________________________ setld(8) Cross-references to online reference pages include the appropriate section number in parentheses. For example, setld(8) indicates that you can find the material on the setld command in Section 8 of the reference pages. [y] In a prompt, square brackets indicate that the enclosed item is the default response. For example, [y] means the default response is Yes. DEC OSF/1 AXP References to DEC OSF/1 AXP refer to the _________________DEC_OSF/1_AXP_operating_system.__________ Unless otherwise noted, press the Return key after entering commands or responses to command prompts. In this guide, some version numbers are given as Vn.n or (in subset identifiers) nnn. When you install DEC Pascal, the actual version numbers appear on your screen. viii 1 ________________________________________________________________ Preparing for DEC Pascal Installation Before starting the installation procedure in Chapter 2, you should complete the preparations explained in this chapter. This chapter provides the necessary information to make your installation run smoothly. This chapter helps you determine the following: o How to read the release notes and Read Before Installing letter o Whether your software distribution kit (see Section 1.2) includes all the components listed on the Bill of Materials (BOM) o Whether you need superuser privileges for the system where you will install DEC Pascal o If the system where you will install DEC Pascal meets the hardware, software, and disk space requirements o Which optional DEC Pascal subsets you should install o How much disk space you will need to install DEC Pascal o How to register your Product Authorization Key (PAK) o Whether you should back up your system disk before the installation o How to cancel the installation procedure, if necessary Preparing for DEC Pascal Installation 1-1 1.1 Reading the Online Release Notes DEC Pascal provides online release notes. Digital strongly recommends that you read the release notes before using DEC Pascal because they may contain information about changes to the installation and use of DEC Pascal. The release notes for DEC Pascal are in: /usr/lib/cmplrs/pc/relnotes 1-2 Preparing for DEC Pascal Installation You can use the following command to read the release notes after DEC Pascal is installed: # more /usr/lib/cmplrs/pc/relnotes For information about installing release notes before in- stalling DEC Pascal, see Section 2.1.1.1. 1.2 The Software Distribution Kit DEC Pascal for DEC OSF/1 AXP systems media and documenta- tion is provided on two CD-ROM devices: o The Software Binaries Layered Products Compact Disc (or Media CD). o The Documentation Compact Disc. You can use the Bill of Materials (BOM) to check the contents of your DEC Pascal software distribution kit. If your software distribution kit is damaged or incomplete, contact your Digital representative (see Section 1.7). 1.2.1 Contents of the Media CD The Media CD contains the following software and documentation: o The DEC Pascal software o The DEC Pascal installation subsets (used with setld(8)) needed to install the software o DEC Pascal Installation Guide for DEC OSF/1 AXP Systems (this guide) o The Read Before Installing or Using DEC Pascal Version 5.0 for DEC OSF/1 AXP Systems cover letter o The DEC Pascal Software Product Description (SPD) o The DEC Pascal System Support Addendum (SSA) o The DEC OSF/1 AXP Layered Products Compact Disc User's Guide Preparing for DEC Pascal Installation 1-3 o Other DEC OSF/1 AXP layered-products media and documentation All documentation on this CD is provided in PostScript (.ps) and ASCII (.txt) file types only. 1.2.2 Contents of the Documentation CD The Documentation CD contains the following DEC Pascal manuals in Bookreader format only: o DEC Pascal User Manual for DEC OSF/1 AXP Systems o DEC Pascal Language Reference Manual For more information on using the Bookreader, see the DEC OSF/1 AXP Layered Products Compact Disc User's Guide. 1.2.3 Read Before Installing or Using DEC Pascal Cover Letter Before you install DEC Pascal, you should take a few minutes to read the Read Before Installing or Using DEC Pascal Version 5.0 for DEC OSF/1 AXP Systems cover letter that is included in your distribution kit. This letter contains information that is important for you to know before installing DEC Pascal and that may not be included in this installation guide or in the release notes. 1.3 Installation Procedure Requirements This section discusses various requirements for installing DEC Pascal. Installing DEC Pascal, including running the Installation Verification Procedure (IVP), takes approximately 10 to 15 minutes, depending on your system configuration. 1.3.1 Login Privileges Required You must have superuser privileges to install the DEC Pascal software and to register the license PAK. 1-4 Preparing for DEC Pascal Installation 1.3.2 Hardware Requirements To install DEC Pascal, you need the following hardware: o Software distribution device Locate the CD-ROM drive for the CD-ROM software distribution media. The CD booklet or the documentation for the CD-ROM drive you are using explains how to load the CD-ROM media. o Terminal You can use either a hardcopy or video terminal to communicate with the operating system and respond to prompts from the installation procedure. See the DEC Pascal Software Product Description (SPD) for additional hardware requirements. 1.3.3 Software Requirements DEC Pascal Version 5.0 requires DEC OSF/1 AXP Version 1.2 (or higher). Future maintenance releases may require higher versions. See the Read Before Installing or Using DEC Pascal Version 5.0 for DEC OSF/1 AXP Systems letter or the online release notes for information about the minimum version of the operating system required. DEC Pascal also requires that the following subsets be loaded on the system where you install DEC Pascal: o OSFBASE-the DEC OSF/1 AXP Base System subset o OSFCMPLRS-the Compiler Back End subset o OSFPGMR-the Software Development Environment subset o DFARTL-the DEC FORTRAN for OSF/1 AXP Runtime Support To install the DEC Pascal reference pages (manual pages), the following DEC OSF/1 AXP software subsets must be installed on the system where you install DEC Pascal: o OSFMANOS-the Admin/User online manual pages o OSFMANOP-the Programming online manual pages o OSFDCMT-the document preparation software Preparing for DEC Pascal Installation 1-5 To check whether these subsets are loaded: 1. Log in to the system where you will install DEC Pascal. 2. Enter the following command: # setld -i | egrep 'OSFBASE|OSFCMPLRS|OSFPGMR|OSFMANOS|OSFMANOP|OSFDCMT|DFARTL' Note that if you do not log in as superuser (login name root), you must enter the full path of the command. For example: % /usr/sbin/setld -i | grep OSFBASE Check the displayed rows for the name of the relevant subset and any related patches. The word "installed" appears in a row after the subset identifier when a subset is loaded. If the word "installed" does not appear (that is, if the second column in a row is blank), the subset or patch is not loaded. In this case, you must load the missing DEC OSF/1 AXP software before installing DEC Pascal. 1.3.4 Determining Which Subsets to Load You must choose the DEC Pascal subsets you want to load. In the subset identifiers starting with DPO, the nnn represents the version number of DEC Pascal. In the subset identifier OTABASEnnn, the nnn represents the current version of OTABASE. The subsets have the following identifiers and titles: o OTABASEnnn (title: DEC Compiled Code Support Library Xn.n-n) This subset contains the static and shared versions of the run-time support library. This subset (or a higher version) is a prerequisite for the DPOBASEnnn subset. Always choose this subset if it appears in your menu and if you are also installing DPOBASEnnn. During the DEC Pascal installation procedure, if you choose OTABASEnnn, it will not be installed if there is already a more recent version on your system. This subset installs files in the /usr/lib/cmplrs/otabase, /usr/lib, and /usr/shlib directories. 1-6 Preparing for DEC Pascal Installation o DPORTLnnn (title: DEC Pascal Vn.n for OSF/1 AXP Runtime Support) This subset contains the DEC Pascal run-time libraries. This subset (or a higher version) is a prerequisite for the DPOBASEnnn subset. Always choose this subset if it appears in your menu and if you are also installing DPOBASEnnn. During the DEC Pascal installation procedure, if you choose DPORTLnnn, it will not be installed if there is already a more recent version on your system. You must install this subset to link and run DEC Pascal programs. This subset installs files in the /usr/lib/cmplrs/pcrtl, /usr/lib, /usr/shlib, and /usr/lib/nls/msg/en_US.88591 directories. o DPOBASEnnn (title: DEC Pascal Vn.n for DEC OSF/1 AXP Systems) This is the primary subset for DEC Pascal and depends on OTABASEnnn and DPORTLnnn subsets. You must install this subset to compile and link DEC Pascal programs. This subset installs its files in the /usr/lib/cmplrs /pc, /usr/include, and /usr/bin directories. o DPODOCnnn (title: DEC Pascal Vn.n Release Notes) This subset contains the online release notes for DEC Pascal and a list of the files in the DEC Pascal kit. You can choose to install this subset first, to view these files, before proceeding with the DEC Pascal installation. This subset installs its files in the /usr/lib/cmplrs /pc directory. o DPOMANnnn (title: DEC Pascal Vn.n Man Pages) This subset contains all unformatted reference pages for the DEC Pascal compiler. If disk space is a concern, you can omit installing this subset. This subset installs its files in the /usr/lib/cmplrs /pc and /usr/man/man1 directories. Preparing for DEC Pascal Installation 1-7 You can load the DEC Pascal reference pages subset only if the DEC OSF/1 AXP reference pages subset is already loaded on your system. If users on the system where DEC Pascal is being installed use reference pages that are nfs mounted from another system, load the DEC Pascal reference pages on the other system rather than on the one where you are installing DEC Pascal. In this case, do not request the reference pages subset during the DEC Pascal installation. After the installation is complete, you can log in to the system where the reference pages are installed and load only the DEC Pascal reference page subset on that system. For information about loading specific subsets, see the setld(8) reference page. 1.3.5 Disk Space Requirements Table 1-1 lists the disk space requirements for loading DEC Pascal software subsets. These disk space requirements apply to the disks where you load the DEC Pascal subsets. The disk space requirements are listed by directory for convenience if you are doing installations on systems where these directories are mount points for different disk partitions. Table_1-1_DEC_Pascal_Subset_Sizes_(Disk_Space_Requirements) Subset_Name__Directory__________________Kbytes_Required___ OTABASEnnn /usr/lib 1 /usr/lib/cmplrs 1 /usr/shlib 1 /usr/lib/cmplrs/otabase_ _447 nnn Total450 DPOBASEnnn /usr 1 /usr/bin 1 /usr/lib/cmplrs 1 (continued on next page) 1-8 Preparing for DEC Pascal Installation Table 1-1 (Cont.) DEC Pascal Subset Sizes (Disk Space __________________Requirements)___________________________ Subset_Name__Directory__________________Kbytes_Required___ /usr/lib/include 1 /usr/lib/cmplrs/pc_nnn 4000 Tota4004 DPORTLnnn /usr/lib 1 /usr/lib/cmplrs 1 /usr/shlib 1 /usr/lib/nls/msg/en_ 1 US.88591 /usr/lib/cmplrs/pcrtl_nnn 750 Total754 DPODOCnnn /usr/lib/cmplrs/pc_nnn 10 Total:10 DPOMANnnn /usr/lib/cmplrs/pc_nnn 25 /usr/share/man/man1 1 Total:26 Grand 5244 _____________Total:_______________________________________ Using these disk space requirements, total the values for the subsets you will load in each directory. Compare the space required for subsets with the free space currently on the disks where DEC Pascal files will reside. To check the current amount of free space for a directory path, log in to the system where you will install DEC Pascal. You can check which directories are mounted and where they are by viewing the /etc/fstab file. For example: # more /etc/fstab /dev/rd0a:/:rw:1:1:ufs:: /dev/rd0g:/usr:rw:1:2:ufs:: /usr/staff/r1/leslie@bigsys:/usr/staff/r1/leslie:rw:0:0:nfs:bg: /usr/man@bigsys:/usr/man:ro:0:0:nfs:bg: Preparing for DEC Pascal Installation 1-9 This display indicates that /usr (mounted to /dev/rd0g) is the only mount point that affects where DEC Pascal files will reside; the system has only one local disk drive and the /usr/lib and /usr/lib/cmplrs file systems reside in the g partition of the disk on that drive. To check total space and free space for the directories where DEC Pascal files will reside, enter the df command. Given the previous display of the /etc/fstab file, which shows that only /usr is a mount point, you need to check free space only in the /usr file system, as follows: # df /usr Filesystem Total kbytes kbytes % node kbytes used free used Mounted on /dev/rd0g 122598 54447 55892 49% /usr This display indicates there are 55892 Kbytes free. This free space must accommodate the subset requirements listed in Table 1-1. On systems where /usr/lib and /usr/man are mounted to different devices from /usr, enter the following command: # df /usr/lib /usr/man In this case, compare the space required for DEC Pascal files in /usr/lib with the free space displayed in the first line of the df output list, and compare the space required for DEC Pascal files in /usr/man with the free space displayed in the second line of that list. 1.3.5.1 Increasing Available Disk Space The DEC Pascal installation procedure creates some directories and loads files into subordinate directories, as listed in /usr/lib/cmplrs/pc/filelist. If the /usr/lib/cmplrs directory does not exist, the DEC Pascal installation procedure creates it. If this directory does exist, the installation procedure uses it. If you find that there is insufficient disk space for the DEC Pascal subsets and if you know that there is additional space on other disks or disk partitions for your system, you can perform the following steps before installing DEC Pascal: 1-10 Preparing for DEC Pascal Installation 1. Log in as superuser (login name root) to the system where you will install DEC Pascal. 2. Create the directory /usr/lib/cmplrs, /usr/lib/cmplrs /pc_nnn, or both. (In these directory names, nnn is the DEC Pascal version number). 3. Specify in the /etc/fstab file that one or more of the newly created directories are mount points to new disk partitions where there is additional space. 4. Enter the mount -a command so that the new mount points take effect. ________________________Note ________________________ The pathname /usr/lib/cmplrs/pc is a symbolic link to the directory /usr/lib/cmplrs/pc_nnn. _____________________________________________________ Preparing for DEC Pascal Installation 1-11 1.4 Registering the License Product Authorization Key DEC Pascal includes support for the License Management Facility (LMF). A License Product Authorization Key (License PAK) must be registered in the License Database (LDB) in order to use DEC Pascal on a newly licensed node. The License PAK may be shipped along with the kit if you ordered the license and media together; otherwise, it is shipped separately to a location based on your license order. The LMF name for DEC Pascal on DEC OSF/1 AXP is PASCAL-O. To register a license under DEC OSF/1: 1. Log in as superuser. 2. At the superuser prompt, enter the following command to edit an empty PAK template and enter all the information on your License PAK: # lmf register After you register your license, use the following command to copy the license details from the LDB to the kernel cache: # lmf reset For complete information on using the License Management Facility, see the Guide to Software Licensing and the lmf(8) reference page. 1.5 Backing Up Your System Disk Digital recommends that you back up your system disk before installing DEC Pascal or any software. Use the backup procedures established at your site. For information about backing up your system disk, see the DEC OSF/1 AXP system documentation. 1.6 Stopping the Installation To stop the installation procedure at any time, use Ctrl/C. However, files created up to that point are not deleted. You must then delete these files interactively. Chapter 2 lists the directories and files created during the DEC Pascal installation. 1-12 Preparing for DEC Pascal Installation 1.7 Error Recovery and Software Problem Reporting If you encounter a problem while using DEC Pascal, Digital recommends that you report the problem immediately. The following sections provide information on how to: o Report DEC Pascal software errors o Recover from errors that occur during the installation procedure o Report documentation errors 1.7.1 Reporting DEC Pascal Software Errors If an error occurs while DEC Pascal is in use and you believe the error is caused by a problem with DEC Pascal, take one of the following actions: o If you have a Software Product Services Support Agreement, call your Customer Support Center (CSC). The CSC provides telephone support for high-level advisory and remedial assistance. o If you have a Self-Maintenance Software Agreement, you can submit a Software Performance Report (SPR). o If you purchased DEC Pascal within the last 90 days and you think the problem is caused by a software error, you can submit an SPR. To obtain information about purchasing a software agreement, please contact your local Digital sales representative. Software Product Support Agreement If you have a Software Product Services Support Agreement, contact your Digital Customer Support Center (CSC), either by telephone or using the electronic means provided with your support agreement (such as DSNlink). The CSC provides telephone support for high-level advisory and remedial assistance. When you initially contact the CSC, please indicate the following: o The name and the version number of the operating system you are using (for example, DEC OSF/1 AXP Version 1.2). Preparing for DEC Pascal Installation 1-13 o The product name and the version number of DEC Pascal you are using (for example, DEC Pascal Version 5.0). You can use the following command to determine the DEC Pascal version number: % what /usr/lib/cmplrs/pc/decpascal | grep Pascal o The hardware system you are using, such as a model number. o A very brief description of the problem (limited to one sentence if possible). o The severity of the problem. When you submit information electronically or are speaking on the phone to the appropriate DEC Pascal support specialist, you can provide more detailed information. This includes the specific commands used to compile and link the program, the error messages displayed, and relevant detailed information (possibly including source program listings). Please attempt to narrow the cause of the problem to a specific module or lines of code. CSC personnel may ask for additional information, such as listings of any command files, INCLUDE files, relevant data files, and so forth. If the program is longer than 50 lines, submit a copy of it electronically or provide machine-readable media. Self-Maintenance Software Agreement If you have a Self-Maintenance Software Agreement, you can submit a Software Performance Report (SPR). You can also submit a SPR if you purchased DEC Pascal within the last 90 days and you think the problem is caused by a software error, regardless of whether you have any type of software support agreement with Digital. When you submit an SPR, please take the following steps: 1. Describe as accurately as possible the circumstances and state of the system when the problem occurred. In the description, please provide: - The version number of DEC Pascal being used. - The name and version number of the operating system being used. 1-14 Preparing for DEC Pascal Installation - A concise description of the problem with specific examples. Include any error messages displayed, the commands used to compile and link the program, and so on. 2. State the problem concisely. 3. Remember to include listings of any command files, INCLUDE files, relevant data files, and so forth. 4. Provide a listing of the program. 5. If the program is longer than 50 lines, submit a copy of it on machine-readable media. If necessary, also submit a copy of the program library used to build the application. For information about copying a program library to machine-readable media, see the tar(1) reference page. Preparing for DEC Pascal Installation 1-15 6. Report only one problem per SPR. This will facilitate a faster response. 7. Mail the SPR package to Digital. Experience shows that many SPRs do not contain enough information to duplicate or identify the problem. Concise, complete information helps Digital give accurate and timely service to software problems. 1.7.2 Recovering from Errors that Occur During the Installation Procedure If errors occur during the installation, the system dis- plays failure messages. For example, if the installation of the DPOBASEnnn subset fails due to insufficient disk space, the installation procedure displays the following message: There is not enough space for subset DPOBASEnnn DEC Pascal (DPOBASEnnn) will not be loaded. Errors can occur during the installation if any of the following conditions exist: o The operating system version is incorrect. o The prerequisite software version is incorrect. o The system parameter values for successful installation are insufficient. o The product license has not been registered and loaded. For descriptions of error messages generated by these conditions, see the DEC OSF/1 AXP documentation on system messages, recovery procedures, and software installation. If any of these conditions exist, take the appropriate action described in the message. For information on system requirements for installing DEC Pascal, see Section 1.3.3. 1-16 Preparing for DEC Pascal Installation 1.7.3 Reporting Documentation Errors If you find an error in the DEC Pascal documentation, please fill out one of the pre-addressed Reader's Comments forms at the back of the document containing the error and send the form to Digital. Please include the section and page number where the error occurred. Your comments are appreciated and will be considered for the next revision of the installation guide. Preparing for DEC Pascal Installation 1-17 2 ________________________________________________________________ Installing DEC Pascal This chapter describes the DEC Pascal installation procedure. Before you start the installation, read Chapter 1, which describes the general options and requirements for installing DEC Pascal. DEC Pascal is installed from CD-ROM, either locally or into a server area. The installation procedure loads DEC Pascal files on a disk belonging to the system where you perform the installation. When DEC Pascal is run, its executable images are mapped into memory on your system. 2.1 Using CD-ROM Consolidated Distribution Media for Local Installations Start the installation procedure as follows: 1. Mount the media on the appropriate disk drive. 2. Log in as superuser (login name root) to the system where you will install DEC Pascal. 3. Make sure you are at the root directory (/) by entering the following command: # cd / 4. Specify the /cdrom directory to be the mount point for the distribution file system on the drive. If your drive is rz1, enter the following command: # mount -r /dev/rz1c /cdrom 5. Enter a setld command that requests the load function (-l option) and identifies the directory in the mounted file system where DEC Pascal subsets are located: # setld -l /cdrom/DPO500/bin Installing DEC Pascal 2-1 2.1.1 Responding to Installation Procedure Prompts This section explains the installation procedure prompts and displays. Examples in this section use generic version numbers, such as Vn.n or (in subset identifiers) nnn. During installation, the actual version numbers will appear on your screen. 2.1.1.1 Selecting DEC Pascal Subsets After you enter the setld command, the installation procedure displays the names of DEC Pascal subsets and asks you to specify the subsets you want to load, as shown in the following example: *** Enter Subset Selections *** The subsets listed below are optional: 1) DEC Compiled Code Support Library 2) DEC Pascal Vn.n Man Pages 3) DEC Pascal Vn.n Release Notes 4) DEC Pascal Vn.n for DEC OSF/1 AXP Systems 5) DEC Pascal for DEC OSF/1 AXP Runtime Support 6) All of the Above 7) None of the Above 8) Exit without installing subsets Enter your choice(s) or press Return to confirm previous selections. Choices (for example, 1 2 4-6): In this example, you must choose subset numbers 1, 4, and 5 to run DEC Pascal programs; otherwise, you will see a warning message. Note that you will also see a warning message if you choose subset 4 (DPOBASEnnn) prior to installing subset 1 (OTABASEnnn) or the DFARTLnnn subset. To install only the online release notes, choose subset 3. This lets you read the release notes without installing DEC Pascal. If you specify more than one number at the prompt, separate each number with a space, not a comma. Typically, you enter the option to install all of the listed subsets (6 in the example shown above). 2-2 Installing DEC Pascal Next, the procedure lets you verify your choice. For example, if you enter 6 in response to the previous prompt, the following display appears: You are installing the following subsets: DEC Compiled Code Support Library DEC Pascal Vn.n Man Pages DEC Pascal Vn.n Release Notes DEC Pascal Vn.n for DEC OSF/1 AXP System DEC Pascal for DEC OSF/1 AXP Runtime Support Is this correct? (y/n): If the displayed subsets are not the ones you intended to choose, enter n. In this case, the subset selection menu is again displayed, and you can correct your choice of optional subsets. If the displayed subsets are the ones you want to load, enter y. 2.1.1.2 Monitoring Displays During the Subset Loading Process The installation procedure loads and verifies the selected DEC Pascal subsets. The following example shows a display where all DEC Pascal subsets are being loaded from CD-ROM: Installing DEC Pascal 2-3 DEC Compiled Code Support Library Copying from /cdrom/DPO500/bin (disk) Verifying DEC Pascal for DEC OSF/1 AXP Runtime Support Copying from /cdrom/DPO500/bin (disk) Verifying DEC Pascal n.n Release Notes Copying from /cdrom/DPO500/bin (disk) Verifying DEC Pascal n.n for DEC OSF/1 AXP Systems Copying from /cdrom/DPO500/bin (disk) Verifying DEC Pascal n.n Man Pages Copying from /cdrom/DPO500/bin (disk) Verifying OTABASEnnn, information: Shared library installed DPODOCnnn, information: The release notes are in /usr/lib/cmplrs/pc/relnotes DPOBASEnnn, information: You can run the Installation Verification Procedure using the following command from root: setld -v DPOBASEnnn # Chapter 3 explains how to run the Installation Verification Procedure (IVP) after installation, and how to delete old DEC Pascal subsets before installing a new version of DEC Pascal. Note that when you see the Verifying message during the subset installation, the installation procedure is checking to see that the files are copied correctly; it is not an IVP message. During the installation, if you get errors from the setld utility, see the Diagnostics section of the setld(8) reference page for an explanation of the errors and the appropriate actions to take. If the verification procedure fails, look in the /usr/var/adm/fverify file for information to help diagnose the problem. 2-4 Installing DEC Pascal 3 ________________________________________________________________ After Installation This chapter explains what you need to do after the installation to make DEC Pascal ready to use, and includes information about the DEC Pascal run-time library. 3.1 Running the Installation Verification Procedure After installing DEC Pascal, you can run the Installation Verification Procedure (IVP) independently to verify that the software is available on your system. You might also want to run the IVP after a system failure to be sure that users can access DEC Pascal. The IVP verifies the installation by using the fverify command with the -y option (see the fverify(8) reference page). DPOBASEnnn compiles, loads, and runs a DEC Pascal program, OTABASEnnn verifies that the run-time support library exists, and DPORTLnnn verifies that the runtime libraries exist. To run the IVP after an installation, enter the following command: # setld -v subset-name In this command, subset-name can be any DEC Pascal subset (for example, DPOBASEnnn, DPODOCnnn, and so on. For nnn, substitute the appropriate version number). For a sample listing of the DEC Pascal IVP, see Appendix A. After Installation 3-1 3.2 Deleting DEC Pascal from Your System If you must remove a version of DEC Pascal from your system, delete each subset that you previously installed. To delete subsets: 1. Log in as superuser (login name root). 2. Make sure you are at the root directory (/) by entering the following command: # cd / 3. Enter the following form of the setld command: # setld -i | egrep 'DPO.*nnn|OTABASE.*nnn' In this command, nnn is the version number. 4. Look for the word "installed" in the listing produced. Then delete the installed subsets. For example: # setld -d DPOBASEnnn DPODOCnnn DPOMANnnn Note that other products besides DEC Pascal can depend on the OTABASE subset. If there is only one version of OTABASE on your system and other products will be affected by its deletion, you should not delete it. When you delete DEC Pascal, the /usr/lib/cmplrs/pc_nnn directory is deleted and symbolic links are removed. If you have another version of DEC Pascal installed, then you must use the SELECT option to reestablish the symbolic links for the remaining version of DEC Pascal as follows: # setld -c DPOBASEnnn SELECT # setld -c DPODOCnnn SELECT # setld -c DPOMANnnn SELECT 3.3 Run-Time Library Messages The text for all messages issued by the DEC Pascal run- time library is kept in a separate file, /usr/lib/nls/msg/en_US.88591/libpas_msg.cat. This file should be present on the system to run an application built with DEC Pascal. If the file is not present and a DEC Pascal application signals an error from the run-time library, you will see the error message number and a message saying that libpas_msg.cat is 3-2 After Installation missing, but you will not see descriptive text about the error. You can move the libpas_msg.cat file to any DEC OSF /1 AXP system, even if that system has not been li- censed for DEC Pascal. DEC Pascal uses the nlspath environment variable to find its run-time message catalog. If nlspath is not set, the default used is /usr/lib/nls/msg/en_US.88591/libpas_msg.cat. If the DEC Pascal run-time library cannot find its message catalog, it displays a message that includes the following: pascal: message not found; Check environment variable NLSPATH and protection of /usr/lib/nls/msg/en_US.88591/libpas_msg.cat In this case, check to see if libpas_msg.cat exists and that users have access to it. Note that libpas_msg.cat is bundled with DEC Pascal. For more information on nlspath, see the DEC OSF/1 AXP documentation or the catopen(3) reference page. After Installation 3-3 A ________________________________________________________________ Sample Listings This appendix provides listings of the following procedures: o A DEC Pascal installation using CD-ROM o An Installation Verification Procedure (IVP) run after the installation A.1 Sample Listing of a DEC Pascal Installation # setld -l cdrom/DPO500/bin The subsets listed below are optional: 1) DEC Compiled Code Support Library 2) DEC Pascal 5.0 Man Pages 3) DEC Pascal 5.0 Release Notes 4) DEC Pascal 5.0 for DEC OSF/1 AXP Systems 5) DEC Pascal for DEC OSF/1 AXP Runtime Support 6) All of the Above 7) Cancel selections and redisplay menus 8) Exit without installing any subsets Sample Listings A-1 Enter your choices or press Return to confirm previous selections. Choices (for example, 1 2 4-6): 6 You are installing the following optional subsets: DEC Compiled Code Support Library DEC Pascal 5.0 Man Pages DEC Pascal 5.0 Release Notes DEC Pascal 5.0 for DEC OSF/1 AXP Systems DEC Pascal for DEC OSF/1 AXP Runtime Support Is this correct? (y/n): y DEC Compiled Code Support Library Copying from cdrom/DPO500/bin (disk) Verifying DPOBASE500: warning: Be *sure* to install DPORTL before running the IVP (setld -v) and trying to use DEC Pascal. DPOBASE500: warning: Be *sure* to install DFARTL before running the IVP (setld -v) and trying to use DEC Pascal. DEC Pascal 5.0 for DEC OSF/1 AXP Systems Copying from cdrom/DPO500/bin (disk) Verifying DEC Pascal 5.0 Release Notes Copying from cdrom/DPO500/bin (disk) Verifying DEC Pascal 5.0 Man Pages Copying from cdrom/DPO500/bin (disk) Verifying DEC Pascal for DEC OSF/1 AXP Runtime Support Copying from cdrom/DPO500/bin (disk) Verifying OTABASE100, information: Shared library installed. DPOBASE500, information: You can run the Installation Verification Procedure using the following command from root: setld -v DPOBASE500 DPODOC500, information: The release notes are in /usr/lib/cmplrs/pc/relnotes A-2 Sample Listings A.2 Sample Listing of a DEC Pascal Installation Verification Procedure # setld -v DPOBASE500 DEC Pascal V5.0 for DEC OSF/1 AXP Systems (DPOBASE500) DPOBASE500: Starting Installation Verification Procedure (IVP). If this fails, please include the following when submitting a report: 1) This subset name, which is DPOBASE500 2) Output from: ls -l /tmp/DPOBASE500.ivptmp 3) This setld session IVP, information: Created scratch directory. IVP, information: Compiling and linking. IVP, information: Running. ** Successful Installation of DEC Pascal V5.0 on 17-March-1992 at 19:39 ** IVP, information: Execution successful. IVP, information: Cleaning up. IVP, information: DPOBASE500 is properly installed. Sample Listings A-3