KAP Fortran for_OpenVMS___________________________________ Installation Guide Part Number: AA-PWBPE-TE April 1999 This document contains instructions for installing KAP Fortran on Compaq OpenVMS Alpha systems. Revision/Update Information: This is a revised document. Operating System and Version: Compaq OpenVMS Alpha Version 7.2 Software Version: Version 3.2 Compaq Fortran 90 Compaq Computer Corporation Maynard, Massachusetts __________________________________________________________ First Printing, February 1993 Revised, April 1999 Possession, use, or copying of the software described in this publication is authorized only pursuant to a valid written license from Compaq or an authorized sublicensor. Compaq Computer Corporation makes no representations that the use of its products in the manner described in this publication will not infringe on existing or future patent rights, nor do the descriptions contained in this publication imply the granting of licenses to make, use, or sell equipment or software in accordance with the description. © Digital Equipment Corporation 1993-1999. All rights reserved. © Kuck & Associates, Inc. 1993-1999. All rights reserved. Compaq, the Compaq logo, AlphaGeneration, Compaq Fortran, and OpenVMS are registered in the U.S. Patent and Trademark Office. KAP is a trademark of Kuck & Associates, Inc. Other product names mentioned herein may be the trademarks of their respective companies. This document is available on CD-ROM. This document was prepared using VAX DOCUMENT Version 2.1. ________________________________________________________________ Contents Preface.................................................. v 1 Preparing for KAP Fortran Installation 1.1 Required Operating System Components......... 1-1 1.2 License Registration......................... 1-2 1.3 Required Privileges.......................... 1-2 1.4 Hardware Requirements........................ 1-3 1.4.1 Required Disk Space...................... 1-3 1.5 VMSINSTAL Requirements....................... 1-3 1.6 VMSINSTAL Quota Requirements................. 1-4 1.7 User Quota Requirements...................... 1-4 1.8 Backing Up Your System Disk.................. 1-4 2 KAP Installation Procedure 2.1 KAP Command Options.......................... 2-6 3 After Installing KAP 3.1 Running the Installation Verification Procedure.................................... 3-1 3.2 Reviewing Release Notes...................... 3-2 3.3 Editing System Startup Procedures............ 3-2 3.4 Reporting Problems........................... 3-2 iii A Files Installed on Your System B Sample Installation Index Tables A-1 KAP Files Installed...................... A-1 iv ________________________________________________________________ Preface This guide describes how to install KAP Fortran on Compaq OpenVMS Alpha systems. ________________________Note ________________________ The KAP Fortran product name will be referred to as KAP throughout this document. _____________________________________________________ Intended Audience This guide is intended for a system manager who wants to install KAP on an OpenVMS Alpha system. Structure of This Document This guide is organized as follows: o Chapter 1 describes the operating system and hardware requirements for the KAP installation and related procedures that you complete before beginning the installation. o Chapter 2 describes a step-by-step installation procedure. o Chapter 3 describes actions to take and considerations to make after the installation. o Appendix A lists the files installed during this installation. o Appendix B contains a sample KAP installation log file. v Associated Documents In addition to this guide, the KAP documentation set includes the following documents: o KAP Fortran for OpenVMS User Guide o KAP Fortran Version 3.2 for OpenVMS Cover Letter The following documents may also prove helpful: o Introduction to Compaq OpenVMS System Management o Guide to Setting Up a Compaq OpenVMS System o Compaq OpenVMS SYSMAN Utility Manual o Compaq OpenVMS VAXcluster Manual For information about how to install software, see the Compaq OpenVMS Alpha Upgrade and Installation Manual for your version of OpenVMS Alpha, and the upgrade and installation supplement for your computer. Also, see the release notes and Software Product Descriptions (SPDs) for any software products you install. Conventions The following conventions are used in this guide. __________________________________________________________ Convention_______Meaning__________________________________ boldface type Boldface type in examples indicates user input. italic type Italic type indicates complete titles of manuals. Ctrl/x Ctrl/x indicates that you hold down the Ctrl key while you press another key or mouse button (indicated here by x). [_]______________Square_brackets_indicate_optional_items__ vi 1 ________________________________________________________________ Preparing for KAP Fortran Installation This chapter discusses the preparations and requirements necessary for installing KAP. Your bill of materials (BOM) and indented bills report (BIL) specify the number and contents of your media. Be sure to verify the contents of your kit with this information. If your kit is damaged or if you find that parts of it are missing, contact your Compaq representative. Online release notes are provided. Compaq strongly recommends that you read the release notes before proceeding with the installation. For information about how to access the online release notes, see Section 3.2. 1.1 Required Operating System Components The OpenVMS operating system comes with a variety of support options, or classes. For the installation of KAP, the following classes are required: o Compaq OpenVMS Required Saveset o Programming Support o Utilities KAP requires OpenVMS Alpha Version 7.2 or later. For a complete list of prerequisite software and required version numbers, see the Software Product Description (SPD). Preparing for KAP Fortran Installation 1-1 1.2 License Registration Before you install and run KAP, you must first register a License Product Authorization Key (License PAK) using the License Management Facility (LMF). 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. You must register and load your KAP license before you start the installation procedure. Register your License PAK in one of the following ways: o Invoke the SYS$UPDATE:VMSLICENSE.COM procedure. When the procedure prompts you for information, respond with data from your license PAK. o At the DCL prompt, enter the LICENSE REGISTER command with the qualifiers that correspond to your License PAK information. As you respond to the LMF procedure prompts, note that PRODUCER=KUCK. Load the PAK using the LICENSE LOAD command. If previous versions of the PAK have been loaded on the system, remove the current license from system memory using the following command (where lmf-name is KAP-FORTRAN): $ LICENSE UNLOAD lmf-name Then load the new license using the following command: $ LICENSE LOAD lmf-name 1.3 Required Privileges To install KAP, you must be logged in to an account that has SETPRV or at least the following privileges: o CMKRNL o WORLD 1-2 Preparing for KAP Fortran Installation o SYSPRV ________________________Note ________________________ Note that VMSINSTAL turns off the BYPASS privilege at the start of the installation. _____________________________________________________ 1.4 Hardware Requirements For a complete list of supported processors, see the Software Product Description. To perform the installation, you need the following hardware: o Software distribution device (if installing from media) A CD-ROM software kit. The documentation for the CD-ROM drive that you are using explains how to load 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 for KAP. 1.4.1 Required Disk Space The KAP installation requires 24,000 blocks of disk space. To determine the number of free disk blocks on the current system disk, enter the following command at the DCL prompt: $ SHOW DEVICE SYS$SYSDEVICE 1.5 VMSINSTAL Requirements When you invoke VMSINSTAL, it checks the following: o Whether you are logged in to a privileged account o Whether you have adequate quotas for installation o Whether DECnet is running Preparing for KAP Fortran Installation 1-3 o Whether any users are logged in to the system 1.6 VMSINSTAL Quota Requirements VMSINSTAL requires that the installation account have a minimum of the following quotas: o ASTLM = 24 o BIOLM = 18 o BYTLM = 18,000 o DIOLM = 18 o ENQLM = 30 o FILLM = 20 If VMSINSTAL detects any problems during the installation, it notifies you and asks if you want to continue the installation. In some instances, you can enter Yes to continue. To stop the installation process and correct the situation, enter No or press Return. Then correct the problem and restart the installation. 1.7 User Quota Requirements The user authorization quota, PGFLQUOTA, should be set to a minimum value of 300,000. When concurrency is used, large pagefiles may be required. A minimum pagefile size of 500,000 blocks is recommended. 1.8 Backing Up Your System Disk At the beginning of the installation, VMSINSTAL asks if you have backed up your system disk. Compaq recommends that you do a system disk backup before installing any software. Use the backup procedures that are established at your site. For details about how to perform a system disk backup, see the section on the Backup utility in the VMS System Management Subkit. 1-4 Preparing for KAP Fortran Installation 2 ________________________________________________________________ KAP Installation Procedure This chapter explains how to install KAP. The following sections provide a step-by-step description of the installation procedure and describe what to do if you encounter an error during installation. The KAP installation procedure consists of a series of questions and informational messages. To abort the installation procedure at any time, press Ctrl/Y. When you press Ctrl/Y, the installation procedure deletes all files it has created up to that point and exits. You can then start the installation again. Installing KAP and running the Installation Verification Procedure (IVP) takes approximately 5 minutes. Follow these steps: 1. Invoke VMSINSTAL. $ @SYS$UPDATE:VMSINSTAL saveset-name device-name OPTIONS N To start the installation, invoke the VMSINSTAL command procedure from a privileged account, such as the SYSTEM account. VMSINSTAL is in the SYS$UPDATE directory. The following list defines the elements of the VMSINSTAL command procedure: o saveset-name is the installation name for the component. For KAP, the installation name is KFORT. o device-name is the name of the device on which you plan to mount the media. For example, DKA100: is the device name for CD-ROM reader. You must also include the name of the directory containing the saveset. To obtain this directory, refer to the booklet Compaq OpenVMS Alpha Layered Products Disc User Guide that is included with the distribution kit. KAP Installation Procedure 2-1 o OPTIONS N is an optional parameter that indicates you want to see the question on release notes. If you do not include the OPTIONS N parameter, VMSINSTAL does not ask you about the release notes. If you are restarting the installation and have already reviewed the release notes, you do not need to specify OPTIONS N. 2. Note that there are several other options you can select when you invoke VMSINSTAL: o Auto_answer option (A) - Initially creates a file that contains your answers to VMSINSTAL questions and prompts. You can then use the option (and the answer file) to save time during a reinstallation (typically after upgrading your system). o Get save set option (G) - Lets you store product save sets temporarily on a magnetic tape or in a disk directory. o File log option (L) - Logs all activity to the terminal during installation. o Alternate root option (R) - Lets you install the product to a system root other than that of the running system. See the OpenVMS documentation on software installation in the Compaq OpenVMS System Management Subkit for detailed information about these options. If you specify more than one option, separate the options with commas (OPTIONS A,N). 3. The following example invokes VMSINSTAL to install KAP from CD-ROM drive DKA100: and shows the system response. This example uses the OPTIONS N release note parameter. $ @SYS$UPDATE:VMSINSTAL KFORT032 DKA100: OPTIONS N OpenVMS AXP Software Product Installation Procedure K7.2 It is 7-APR-1999 at 10:48. Enter a question mark (?) at any time for help. 2-2 KAP Installation Procedure If you do not supply either the product name or the device name, VMSINSTAL prompts you for this information later in the installation procedure. VMSINSTAL does not prompt you for any options, so be sure to include OPTIONS N on the VMSINSTAL command line to access the release notes during the installation. 4. Confirm system backup. * Are you satisfied with the backup of your system disk [YES]? VMSINSTAL asks if you are satisfied with your system backup. You should always back up your system disk before performing an installation. If you are satisfied with the backup of your system disk, press Return. Otherwise, enter No to discontinue the installation. After you back up your system disk, you can restart the installation. 5. Mount the media. Please mount the volume on DKA100:. * Are you ready? YES The following products will be processed: KFORT V3.2 Beginning installation of KFORT V3.2 at 06:13 %VMSINSTAL-I-RESTORE, Restoring product save set A... You should now mount the distribution volume on the device you specified when you invoked VMSINSTAL. The device name appears in the line preceding the question. VMSINSTAL then asks you if you are ready to continue with the installation. If you respond Yes to indicate that you are ready, VMSINSTAL displays a message that the media containing the KFORT saveset has been mounted on the specified device and that the installation has begun. If you entered the wrong device name when you invoked VMSINSTAL and need to restart the installation, enter No in response to the "Are you ready?" question. To abort the installation for other reasons, press Ctrl/Y. 6. Select a release notes option. KAP Installation Procedure 2-3 Release notes included with this kit are always copied to SYS$HELP. If you specified OPTIONS N when you invoked VMSINSTAL, you are now asked to choose one of the four options for reviewing the release notes. Additional Release Notes Options: 1 Display release notes 2 Print release notes 3 Both 1 and 2 4 None of the above * Select option [2]: o If you select option 1, VMSINSTAL displays the release notes immediately on the console terminal. You can terminate the display at any time by pressing Ctrl/C. o If you select option 2, VMSINSTAL prompts you for the name of the print queue that you want to use: * Queue name [SYS$PRINT]: You can press Return to send the file to the default output print device or you can enter another queue name. o If you select option 3, VMSINSTAL displays the release notes immediately on the console terminal and then prompts you for a queue name for the printed version. o Select option 4 if you have already reviewed the release notes and are restarting the installation. 7. Next, VMSINSTAL displays the following question: * Do you want to continue the installation [N]?: YES %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP. To continue the installation, enter Yes. Otherwise, press Return. In either case, the release notes are copied to a file in the SYS$HELP directory: SYS$HELP:KFORT032_RELEASE_NOTES.TXT 8. License confirmation. 2-4 KAP Installation Procedure If the license PAK has been registered and loaded, answer Yes to the following question. If you answer No, the IVP phase of the installation will be cancelled. * Does this product have an authorization key registered and loaded? 9. Purge files. You have the option to purge files from previous ver- sions of KAP that are superseded by this installation. Purging is recommended; however, if you need to keep files from the previous version, enter No in response to the following question: * Do you want to purge files replaced by this installation [YES]? 10.Read informational messages. At this point, the installation procedure displays a number of informational messages that report on the progress of the installation. There are no further questions. If the installation procedure has been successful up to this point, VMSINSTAL moves the new or modified files to their target directories, updates help files, and updates DCL tables, if necessary. If you chose to have files purged, that work is done now. 11.End the installation procedure. Installation of KFORT V3.2 completed at 6:15 This is followed by history and data file informational messages. ________________________Note ________________________ The KFORT$STARTUP.COM file must be executed to de- fine the KAP foreign command @SYS$STARTUP:KFORT$STARTUP. This startup must be executed each time a user logs on to the system. See Section 3.3 for additional information. _____________________________________________________ 12.Error recovery. KAP Installation Procedure 2-5 If an error occurs during installation, VMSINSTAL displays an error message. If the installation fails, you see the following message: %VMSINSTAL-E-INSFAIL, The installation of KFORT V3.2 has failed. Errors can occur during the installation if any of the following conditions exist: o The operating system version is incorrect. o A prerequisite software version is incorrect. o Quotas necessary for successful installation are insufficient. o System parameter values for successful installation are insufficient. For descriptions of the error messages generated by these conditions, see the OpenVMS documentation on system messages, recovery procedures, and OpenVMS software installation. If you are notified that any of these conditions exist, you should take the appropriate action as described in the message. 2.1 KAP Command Options Installation of KAP and execution of SYS$STARTUP:KFORT$STARTUP will create two foreign commands: KFORT and KAPF. KAPF is the command for stand-alone KAP. KFORT is the "envelope command" that invokes KAP and Compaq Fortran. To use these commands, please see the KAP Fortran for OpenVMS User Guide. 2-6 KAP Installation Procedure 3 ________________________________________________________________ After Installing KAP This chapter describes the following tasks that you perform after installing KAP: o Executing the Installation Verification Procedure (IVP) o Reviewing the KAP release notes o Editing system startup procedures o Recommended file cleanup o Reporting problems 3.1 Running the Installation Verification Procedure VMSINSTAL will execute the IVP as part of a successful installation. To run the IVP stand-alone, issue the following commands: $ @SYS$STARTUP:KFORT$STARTUP $ @SYS$TEST:KFORT$IVP If the IVP succeeds, you see these messages: %DCL-I-SUPERSEDE, previous value of KFORT$TEST has been superseded Copyright (c) Kuck and Associates, Inc 1992, 1999 *-------------------------------------------* * Installation Verification Procedure * *-------------------------------------------* KFORT Compilation Test Passed KFORT Object Execution Test Passed ****** Installation Verification Procedure SUCCESSFUL ****** After Installing KAP 3-1 If the IVP fails, you see this message: ****** Installation Verification Procedure FAILED ****** If the IVP fails, issue the DCL command SET VERIFY and then run the IVP again. The messages displayed while the IVP runs will indicate the cause of the failure. You will then be able to take corrective action. 3.2 Reviewing Release Notes To review the release notes before the installation, you can retrieve the release notes from the KFORT032 saveset with the OpenVMS BACKUP command. Alternatively, you can start the installation procedure, and then abort the installation when the release notes have been successfully moved to the SYS$HELP directory. At any time after that point of the installation, you can enter the following command to review the release notes: $ TYPE SYS$HELP:KFORT032_RELEASE_NOTES.TXT 3.3 Editing System Startup Procedures To make KAP available for all users, revise the system- wide login command file (SYS$MANAGER:SYLOGIN.COM) to invoke this KAP startup command file. Alternatively, it can be included in the user-specific login file (LOGIN.COM) for each user who will be using KAP. 3.4 Reporting Problems If you encounter a problem while using KAP, report it to Compaq. Depending on the nature of the problem and type of support you have, you can take one of the following actions: o Call Compaq if your software contract or warranty agreement entitles you to telephone support. o Submit a Software Performance Report (SPR). 3-2 After Installing KAP A ________________________________________________________________ Files Installed on Your System The KAP installation procedure installs a number of files on your system. Table A-1 lists these files and specifies whether the file is modified or new. Table_A-1_KAP_Files_Installed_____________________________ File_Name____________________________Blocks_____Status____ SYS$SYSTEM:KAPF.EXE 17736 New SYS$SYSTEM:KFORT.EXE 215 New SYS$ROOT:[SYSTEST.KFORT]KAPFIVPIN.F 2 New SYS$ROOT:[SYSTEST.KFORT]KAPFIVPIN.KMP12 New SYS$ROOT:[SYSTEST.KFORT]KAPCFIVPIN.KU53 New SYS$STARTUP:KFORT$IVP.COM 16 New SYS$STARTUP:KFORT$STARTUP.COM 1 New SYS$LIBRARY:KMP.OLB__________________2079_______New_______ Files Installed on Your System A-1 B ________________________________________________________________ Sample Installation This appendix contains a log of a complete installation of the KAP kit. Your installation may differ from this example because you can make different choices during the procedure. $ @sys$update:vmsinstal kfort032 OpenVMS AXP Software Product Installation Procedure K7.2 It is 7-APR-1999 at 10:48. Enter a question mark (?) at any time for help. %VMSINSTAL-W-NOTSYSTEM, You are not logged in to the SYSTEM account. * Do you want to continue anyway [NO]? yes * Are you satisfied with the backup of your system disk [YES]? * Where will the distribution volumes be mounted: sys$sysdevice:[kits] Enter installation options you wish to use (none): The following products will be processed: KFORT V3.2 Beginning installation of KFORT V3.2 at 10:48 %VMSINSTAL-I-RESTORE, Restoring product save set A ... © Kuck and Associates, Inc. 1992, 1999. All Rights Reserved. Restricted Rights: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of DFARS 252.227-7013, or in FAR 52.227-19, or in FAR 52.227-14 Alt. III., as applicable. Possession, use, or copying of this software and media is authorized only pursuant to a valid written license from Compaq or an authorized sublicensor Sample Installation B-1 Product: KAP-FORTRAN Producer: KUCK Version: V3.2 Release Date: 12-MAR-99 * Does this product have an authorization key registered and loaded? yes * Do you want to purge files replaced by this installation [YES]? The installation will take approximately 5 minutes %VMSINSTAL-I-RESTORE, Restoring product save set B ... IMPORTANT NOTE: **** The KFORT$STARTUP.COM file must be executed **** **** to define the KFORT foreign command: **** **** **** **** @sys$startup:KFORT$startup **** This startup must be executed each time a user logs on to the system. %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... Execution of SYS$TEST:KFORT$IVP has not been invoked. After installation is complete this IVP may be run with the commands: @SYS$STARTUP:KFORT$STARTUP @SYS$TEST:KFORT$IVP Installation of KFORT V3.2 completed at 10:49 Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY Creating installation data file: VMI$ROOT:[SYSUPD]KFORT032.VMI_DATA VMSINSTAL procedure done at 10:49 B-2 Sample Installation ________________________________________________________________ Index C__________________________ P__________________________ Conventions, vi Privileges required, 1-2 D__________________________ Problems Disk space reporting, 3-2 required, 1-3 Q__________________________ E__________________________ Quota requirements Error recovery, 2-6 for KAP, 1-4 ___________________________ R__________________________ Hardware requirements, 1-3 Release notes reviewing, 3-2 I__________________________ Installation procedure, S__________________________ 2-1 Startup procedures Installation Verification editing, 3-2 Procedure System components, 1-1 running, 3-1 System Disk backing up, 1-4 K__________________________ V KAP command options, 2-6 ___________________________ VMSINSTAL L Quotas, 1-4 ___________________________ requirements, 1-3 License registration, 1-2 Index-1