MACRO-64_Assembler____________________________ Installation Guide for OpenVMS Alpha Systems Order Number: AA-PT9LC-TE October 1998 This guide describes how to install MACRO-64 Assembler on an Alpha processor system running the OpenVMS operating system. It also describes how to read the online release notes. Revision/Update Information: This manual super- sedes all previous MACRO-64 Assembler installation guides for OpenVMS Alpha systems. Operating System: OpenVMS Alpha Version 6.1 (or higher; see Section 1.1) Software Version: MACRO-64 Assembler Version 1.2 (or higher) Digital Equipment Corporation Maynard, Massachusetts __________________________________________________________ First Printing, November 1992 Revised, November 1993 Revised, October 1998 Digital Equipment 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. Possession, use, or copying of the software described in this publication is authorized only pursuant to a valid written license from Digital or an authorized sublicensor. © Digital Equipment Corporation 1998. All Rights Reserved. The following are trademarks of Digital Equipment Corporation: DEC, DEC, DECwindows, Digital, OpenVMS, POLYCENTER, VAX, VMS, and the DIGITAL logo. The following is a third-party trademark: PostScript is a registered trademark of Adobe Systems, Inc. ZK6340 This document is available on CD-ROM. This document was prepared using VAX DOCUMENT Version 2.1. ___________________________________________________________ Contents .................................................. v for MACRO-64 Assembler Installation 1.1 The Software Product Library CD-ROM and Installation-Related Documentation Files..... 1-1 1.2 Required Operating System Components......... 1-3 1.3 License Registration......................... 1-3 1.4 Installation Procedure Requirements.......... 1-4 1.4.1 Installation Account Privileges and Disk Space.................................... 1-4 1.4.2 System Parameters........................ 1-5 1.4.2.1 Calculating Values for GBLPAGES and GBLSECTIONS............................ 1-6 1.4.2.2 Changing System Parameter Values with AUTOGEN................................ 1-6 1.5 Backing Up Your System Disk.................. 1-7 1.6 Recovering from Installation Errors.......... 1-7 MACRO-64 Assembler Installing MACRO-64 Assembler 3.1 Running the Installation Verification Procedure Separately......................... 3-1 3.2 VMScluster Considerations.................... 3-2 3.3 Making the MACRO64 Commands Available After Installation................................. 3-3 3.4 User Account Requirements.................... 3-3 3.5 Enhancing MACRO-64 Assembler Performance..... 3-4 3.6 Removing Digital MACRO64..................... 3-4 iii 3.7 Troubleshooting Tips......................... 3-5 3.8 Getting Help and Reporting Problems.......... 3-5 Sample MACRO-64 Assembler Version 1.2 Listings A.1 Sample MACRO-64 Assembler Installation....... A-1 A.2 Sample MACRO-64 Assembler Installation Removal Procedure............................ A-2 1 Conventions Used in This Document........ vii 1-1 Disk Space Requirements.................. 1-5 ________________________________________________________________ Preface This guide explains how to install MACRO-64 Assembler on an Alpha processor system running the OpenVMS operating system. It also describes how to read the online release notes. Keep this guide with your distribution kit. You will need it to install maintenance updates or to reinstall MACRO-64 Assembler for any other reason. This manual applies to Version 1.2 of MACRO-64 Assembler and all subsequent releases until a revised installation guide is issued. Intended Audience This guide is intended for system managers who install MACRO-64 Assembler. Structure of This Document This guide contains the following chapters: o Chapter 1 describes the hardware and software requirements for MACRO-64 Assembler installation. It also lists related procedures that you must complete before installing MACRO-64 Assembler. o Chapter 2 describes how to install MACRO-64 Assembler, including an example installation. o Chapter 3 describes post-installation considerations. v Documentation In addition to this guide, the MACRO-64 Assembler documentation set includes the following: o MACRO-64 Assembler for OpenVMS Alpha Systems Reference Manual (AA-PT9KB-TE) o Alpha Architecture Reference Manual (EY-L520E-LP) o A letter titled Read Before Installing or Using MACRO- 64 Assembler Version n.n for OpenVMS Alpha Systems ("read first" cover letter) o MACRO-64 Assembler online release notes For the location of the MACRO-64 Assembler "read first" cover letter and the release notes, see Section 1.1. Once installed, you can use MACRO-64 Assembler online HELP, which describes the command qualifiers, explains run-time messages, and provides a quick-reference summary of language topics. To use online HELP, type HELP followed by the command name as in the following examples: $ HELP MACRO/ALPHA The following manuals in the OpenVMS Alpha documentation set contain information relevant to installing software: o POLYCENTER Software Installation Utility User's Guide o OpenVMS License Management Utility Manual o OpenVMS System Manager's Manual, which includes: - OpenVMS System Manager's Manual: Essentials - OpenVMS System Manager's Manual: Tuning, Monitoring, and Complex Systems o Guide to OpenVMS Performance Management For help understanding OpenVMS system error messages, see the OpenVMS System Messages and Recovery Procedures Reference Manual or the online HELP/MESSAGE facility. Sending Digital Your Comments on This Manual We welcome your comments on this or any other DIGITAL manual. You can send comments in the following ways: o FAX: 603-881-0120 Attn: Languages Documentation, ZKO2-3 /K35 o A letter addressed to: Digital Equipment Corporation Languages Documentation, ZK02-3/K35 110 Spit Brook Road Nashua, NH 03062-2698 USA If you have suggestions for improving a particular section or find any errors, please indicate the title, order number, and section (if available). We also welcome general comments. Getting Help from Digital If you have a customer support contract and have comments or questions about MACRO-64 Assembler, you can contact the Customer Support Center (CSC), preferably using electronic means such as DSNlink. In the United States, customers can call the CSC at 1-800-354-9000 (see Section 3.8). Conventions Table 1 lists the conventions used in this document. Table_1_Conventions_Used_in_This_Document_________________ Convention__________Meaning_______________________________ UPPERCASE_TEXT Uppercase letters indicate the name of a command, a file, a parameter, a procedure, or a utility. (continued on next page) vii Table_1_(Cont.)__Conventions_Used_in_This_Document________ Convention__________Meaning_______________________________ $ SHOW DEFAULT In interactive examples, prompts or displayed text appears in a monospaced font. User input appears in bold. $ The dollar sign indicates the DCL prompt. This prompt may be different on your system. Ctrl/x In interactive examples, a sequence such as Ctrl/x indicates that you must hold down the key labeled Ctrl while you press another key or a pointing device button; for example, Ctrl/C or Ctrl/Z. In code examples, a key name is shown enclosed to indicate that you press a key on a keyboard. [YES] Square brackets indicate that the enclosed item is a default value in an installation prompt. Also, square brackets serve as delimiters for a directory name in a file specification. OpenVMS, References to OpenVMS, OpenVMS AXP, OpenVMS Alpha, or OpenVMS Alpha refer to the OpenVMS OpenVMS AXP Alpha operating system. MACRO-64 References to MACRO-64 refer to the DIGITAL MACRO-64 Assembler. For more information, see the Read Before Installing or Using MACRO-64 Assembler ____________________Version_n.n_for_OpenVMS_Alpha_Systems. In this manual, some version numbers are given as "Vn.n". When you install MACRO-64 Assembler, the actual version numbers appear on your screen. 1 ________________________________________________________________ Preparing for MACRO-64 Assembler Installation Before starting the installation procedure in Chapter 2, you should complete the preparations explained in this chapter. This chapter includes the following sections: o Reading the online release notes and "read first" letter (Section 1.1) o Required operating system components (Section 1.2) o License registration (Section 1.3) o Installation procedure requirements, including disk space requirements (Section 1.4) o Backing up your system disk (Section 1.5) o Recovering from installation errors (Section 1.6) 1.1 The Software Product Library CD-ROM and Installation-Related Documentation Files The OpenVMS Alpha Software Product Library CD-ROM (media CD-ROM) set provides the following files: o MACRO-64 Assembler installation kit files o MACRO-64 Assembler documentation files, including a "read first" cover letter, this installation guide, and other files o Online CD-ROM documentation files in the [README] directory on the first media CD-ROM, including a CD-ROM user guide and master list of CD-ROM products o A CDMENU utility To determine whether the appropriate media CD-ROM is already mounted on your system, contact the appropriate system manager. Preparing for MACRO-64 Assembler Installation 1-1 MACRO-64 Assembler provides online release notes and an online "read first" cover letter: o You can read the online "read first" cover letter provided on the media CD-ROM set or read the printed hardcopy letter. o You can extract the MACRO-64 Assembler release notes to a file and type or print them before starting MACRO- 64 Assembler installation. The MACRO-64 Assembler release notes are also installed on your system after installation. For information about using the CDMENU utility and locating the appropriate media CD-ROM and directory that contains the MACRO-64 Assembler cover letter, see the first few steps in Chapter 2. Once the appropriate media CD-ROM has been mounted and the appropriate MACRO-64 Assembler documentation directory located, do one of the following: o Use a TYPE command to display the ASCII version of the MACRO-64 Assembler cover letter (on your screen). o Use a PRINT command to print the ASCII or PostScript version of the MACRO-64 Assembler cover letter to a printer. For information about reading the online release notes before installation, use the PRODUCT EXTRACT RELEASE_NOTES command described in Chapter 2 (step 7). DIGITAL strongly recommends that you read the release notes and the cover letter before installing MACRO-64 Assembler. They contain information about changes to the installation and use of MACRO-64 Assembler, such as the minimum version of the OpenVMS Alpha operating system required for this release of MACRO-64 Assembler. After installation, the release notes are installed in: SYS$HELP:MACRO64.RELEASE_NOTES Preparing for MACRO-64 Assembler Installation 1.2 Required Operating System Components MACRO-64 Assembler Version 1.2 requires the OpenVMS Alpha operating system Version 6.1 or higher. Future MACRO-64 Assembler releases may require higher versions of the operating system, as described in the online release notes or the Read Before Installing or Using MACRO-64 Assembler Version n.n for OpenVMS Alpha Systems (cover) letter. The OpenVMS Alpha operating system comes with a variety of support options (or components). To use MACRO-64 Assembler, your system should be running a version of the OpenVMS Alpha operating system that includes the base component and the following other components: o Programming support o Utilities For a complete list of the required components, see MACRO- 64 Assembler Software Product Description (SPD) on the media CD-ROM. 1.3 License Registration Before you install and run MACRO-64 Assembler Version 1.2 on a newly-licensed node (or cluster), you must first register a License Product Authorization Key (License PAK), using the License Management Facility (LMF). The specific LMF product name used by the MACRO-64 Assembler is: MACRO64. 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. If you are installing MACRO-64 Assembler as an update on a node or cluster already licensed for this software, you have already completed the License PAK registration requirements. If you are installing prerequisite or optional software along with MACRO-64 Assembler, review the PAK status and install the PAKs for any prerequisite or optional software before you install MACRO-64 Assembler. Preparing for MACRO-64 Assembler Installation 1-3 You must register and load your license for MACRO-64 Assembler before you start the installation in order to run the Installation Verification Procedure (IVP) and use the software. Log in to a privileged account, such as the system manager's account, SYSTEM. You have a choice of two ways to register a license: o Invoke the SYS$UPDATE:VMSLICENSE.COM procedure. When it prompts you for information, respond with data from your License PAK. o At the DCL prompt, enter the LICENSE REGISTER command with the appropriate qualifiers that correspond to License PAK information. If you plan to use MACRO-64 Assembler on more than one node in a cluster, you will need to perform a license load on the other nodes after you complete this installation. See Section 3.2. For complete information on using LMF, see the OpenVMS License Management Utility Manual. Installation Procedure Requirements After you have registered and loaded the license PAK and have previously read the appropriate parts of this installation guide, the installation takes approximately 2 to 5 minutes, depending on your system configuration. Installation Account Privileges and Disk Space To install MACRO-64 Assembler, you must be logged in to an account that has at least the following privileges enabled: o CMKRNL o SYSLCK o SYSPRV Preparing for MACRO-64 Assembler Installation Table 1-1 lists MACRO-64 Assembler's requirements for free disk storage space. Table_1-1_Disk_Space_Requirements_________________________ During Kit_Component_____________Installation____After_Installation Digital MACRO-64 1000 blocks 1000 blocks Assembler_________________________________________________ To determine the number of free disk blocks on the current system disk, enter the following DCL command: $ SHOW DEVICE SYS$SYSDEVICE 1.4.2 System Parameters Installing MACRO-64 Assembler (both compilers) requires certain system parameter settings. The minimum number of free global pagelets (512- byte subpage unit) and global sections needed is two (2) global sections and approximately 20 contiguous free global pagelets, plus a sufficient number of contiguous free global pagelets to contain the file SYS$LIBRARY:DCLTABLES.EXE (see Section 1.4.2.1). These values represent the number of free global pagelets and global sections required for the installation, not the total number you need to run your system and other software. ________________________Note ________________________ If you do not ensure that your system has the necessary global pagelets and global section SYSGEN parameters for the installation, the DCL tables can become corrupted in some situations. _____________________________________________________ Preparing for MACRO-64 Assembler Installation 1-5 Calculating Values for GBLPAGES and GBLSECTIONS To install and run MACRO-64 Assembler, you must have sufficient free global pagelets and global sections. Enter the following DCL command to determine the number of global pagelets required by SYS$LIBRARY:DCLTABLES.EXE: $ DIRECTORY/SIZE SYS$LIBRARY:DCLTABLES.EXE This command returns the size (in blocks) of SYS$LIBRARY:DCLTABLES.EXE. As an approximation, use this figure as the number of global pagelets for the file. You can use the WRITE command with the F$GETSYI lexical function to find the number of free contiguous global pagelets and free global sections. The following example shows how to get this information at your terminal (the default for SYS$OUTPUT): $ WRITE SYS$OUTPUT F$GETSYI("CONTIG_GBLPAGES") 15848 $ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLSECTS") 24 If the value of free global pagelets or global sections is less than the required value (see Section 1.4.2), you must increase the system parameter setting. Section 1.4.2.2 describes the procedures for increasing these values using AUTOGEN. Changing System Parameter Values with AUTOGEN If you do not have enough free global pagelets or free global sections to install MACRO-64 Assembler, you can use the AUTOGEN command procedure to increase the GBLPAGES or GBLSECTIONS system parameters. AUTOGEN automatically adjusts values for parameters that are associated with the values you reset manually. To change system parameters with AUTOGEN, edit the following file: SYS$SYSTEM:MODPARAMS.DAT To change a parameter value listed in this file, delete the current value associated with that parameter and enter the new value. Preparing for MACRO-64 Assembler Installation To add a new parameter, add a line to the file that specifies the name of the parameter and its value. To modify incremental parameters such as GBLPAGES and GBLSECTIONS, use the ADD_ prefix. After you make all your changes, exit from the editor. When you execute the AUTOGEN procedure to recalculate your system parameters, AUTOGEN uses the information in your MODPARAMS.DAT file and also can automatically adjust some of the SYSGEN parameters based on the consumption of resources since the last reboot. For information about using AUTOGEN and its command-line parameters, see the OpenVMS System Manager's Manual: Tuning, Monitoring, and Complex Systems. 1.5 Backing Up Your System Disk Digital recommends that you do a system disk backup before installing any software. Use the backup procedures that are established at your site. For details on performing a system disk backup, see the Using VMS BACKUP manual. 1.6 Recovering from Installation Errors Errors can occur during the installation if any of the following conditions exist: o The operating system version is incorrect. o The privileges or disk space for successful installa- tion are insufficient. For descriptions of error messages generated by these and related conditions, see the OpenVMS Alpha documentation on system messages and software installation or the online HELP/MESSAGE command. Take the appropriate action described in the message. For information on system requirements for installing MACRO-64 Assembler, see Section 1.2. For a list of problems that can cause an unsuccessful installation, see Section 3.7. To report a problem to Digital, see Section 3.8. Preparing for MACRO-64 Assembler Installation 1-7 2 ________________________________________________________________ Installing MACRO-64 Assembler This chapter describes: o How to read the online release notes before installa- tion. o How to install MACRO-64 Assembler using POLYCENTER Software Installation (PCSI) software. PCSI software is bundled with the OpenVMS operating system. Before you start the installation, read Chapter 1, which describes the general options and requirements for installing MACRO-64 Assembler. The installation procedure loads MACRO-64 Assembler product distribution files on to the system disk on the system where you perform the installation. Follow these steps to install MACRO-64 Assembler from the OpenVMS Alpha Software Products Library CD-ROM set: 1. Log in to a privileged account on the system (or cluster) where you will install MACRO-64 Assembler. This account must have the following privileges enabled: o CMKRNL o SYSLCK o SYSPRV Do not proceed with the installation unless your account has the CMKRNL, SYSLCK, and SYSPRV privileges enabled. If your process has the SETPRV privilege, you can enable the CMKRNL, SYSLCK, and SYSPRV privileges by typing the following command: $ SET PROCESS/PRIVILEGE=(CMKRNL,SYSLCK,SYSPRV) Installing MACRO-64 Assembler 2-1 To check whether your process has these privileges enabled, type the following command: $ SHOW PROCESS/PRIVILEGES 2. To obtain the kit directory location of the MACRO-64 Assembler product distribution files on the appropriate OpenVMS Alpha Software Product Library CD-ROM (media CD-ROM), do one of the following: o Use the CDMENU utility provided on the media CD-ROM. o View the CD-ROM master index file on the media CD- ROM. o Contact the appropriate system manager. For information about using the CDMENU utility and the CD-ROM files on the media CD-ROM set, see the Software Product Library CD-ROM User's Guide (media CD-ROM user guide), which accompanies the media CD-ROM distribution kit. The media CD-ROM user guide and CD-ROM master index file are provided as online files in the [README] directory on the first media CD-ROM. 3. To determine whether the appropriate media CD-ROM is already mounted on your system, type the following command: $ SHOW DEVICE DKA400 ________________________Note ________________________ DKA400 is the device name used in examples in this document to show where the appropriate media CD-ROM has been mounted. _____________________________________________________ 4. If the media CD-ROM containing the MACRO-64 Assembler installation files is not mounted, either contact the appropriate system manager or insert the appropriate media CD-ROM (write down the volume label) into an available CD-ROM drive. Type the appropriate MOUNT command to mount the media CD-ROM (omit the /FOREIGN qualifier), such as the following: $ MOUNT DKA400 label Installing MACRO-64 Assembler Where label is the volume label of that media CD-ROM. 5. To check that you have located the correct CD-ROM device and directory, use the following DIRECTORY command: $ DIRECTORY Directory DKA400:[dir.subdir] DEC-AXPVMS-MACRO64-Vnnnn-x-1.PCSI Total of 1 files. 6. To extract the MACRO-64 Assembler online release notes before you install MACRO-64 Assembler, type the following command: $ PRODUCT EXTRACT RELEASE_NOTES MACRO64 /SOURCE=disk:[dir] - $_/FILE=MACRO64.RELNOTES In this command, disk:[dir] is the specification of the disk and directory containing the product installation files. You can view or print the file MACRO64.RELNOTES before you continue with the installation (next command). For example: $ TYPE/PAGE MACRO64.RELNOTES 7. If the MACRO64 Assembler was previously installed on this system, it must be removed before MACRO- 64 Assembler is installed. To determine if an older version of MACRO64 present, type the following command: $ PRODUCT SHOW PRODUCT MACRO64 If MACRO64 is present, the following text appears: PRODUCT ------- DEC AXPVMS MACRO64 V1.1-1 1 item found Installing MACRO-64 Assembler 2-3 If MACRO64 is not present, the following text appears: PRODUCT ------- 0 items found If MACRO64 is present, remove it by typing the following PRODUCT REMOVE command: $ PRODUCT REMOVE MACRO64 The following text appears: The following product has been selected: DEC AXPVMS MACRO64 Vn.n Layered Product Do you want to continue? [YES] The following product will be removed: DEC AXPVMS MACRO64 V1.2 Layered Product Portion done: 0%...30%...40%...50%...60%...70%...80%...90%...100% The following product has been removed: DEC AXPVMS MACRO64 V1.2 Layered Product 8. To install the MACRO-64 Assembler Assembler, type the following PRODUCT INSTALL command: $ PRODUCT INSTALL MACRO64 /SOURCE=disk:[dir] /HELP Where disk:[dir] is the specification of the disk and directory containing the product installation files. The following text appears: The following product has been selected: DEC AXPVMS MACRO64 Vn.n Layered Product Configuration phase starting ... You will be asked to choose options, if any, for each selected product and for any products that may be installed to satisfy software dependency requirements. DEC AXPVMS MACRO64 V1.2: MACRO-64 Assembler for OpenVMS Alpha COPYRIGHT (c) 1998 -- All rights reserved Digital Equipment Corporation Do you want the defaults for all options? [YES] Installing MACRO-64 Assembler Do you want to review the options? [NO] If you wish to review the options, type YES, otherwise type NO. Installation continues with the following text displayed: Execution phase starting ... The following product will be installed: DEC AXPVMS MACRO64 Vn.n Layered Product Portion done: 0%...50%...60%...70%...80%...90%...100% The following product has been installed: DEC AXPVMS MACRO64 V1.2 Layered Product %PCSI-I-IVPEXECUTE, test procedure executing ... %PCSI-I-IVPSUCCESS, test procedure completed successfully 9. Installation takes about 2-5 minutes (depending on your system). When installation has been completed, the DCL $ prompt reappears. 10.To obtain a list of files installed, type the following command: $ PRODUCT SHOW OBJECT /PRODUCT=MACRO64 To use other features of the PCSI utility, see the POLYCENTER Software Installation Utility User's Guide. Installing MACRO-64 Assembler 2-5 3 ________________________________________________________________ After Installing MACRO-64 Assembler The following tasks can be performed after MACRO-64 Assembler is installed: o Running the Installation Verification Procedure (IVP) separately o Making the recently installed MACRO64 commands available to users after installation o Making the product usable on a VMScluster o Setting user account quotas o Enhancing performance o Getting help and reporting problems 3.1 Running the Installation Verification Procedure Separately The MACRO-64 Assembler Installation Verification Procedure (IVP) runs automatically during MACRO-64 Assembler installation. If system problems occur, you should run the IVP separately to ensure the integrity of the installed files. To run the IVP, type the following command: $ @SYS$TEST:MACRO64$IVP.COM If any problems are encountered, a message such as the following appears: Digital MACRO64 Version 1.n TEST FAILED After Installing MACRO-64 Assembler 3-1 VMScluster Considerations If you want to run MACRO-64 Assembler on multiple nodes of a VMScluster, first check to see that you have the appropriate software license (see Section 1.3). Then perform the following steps after you install MACRO-64 Assembler: 1. Issue the LICENSE LOAD command, as described in the OpenVMS License Management Utility Manual, to activate the license on each node in the VMScluster on which MACRO-64 Assembler is to be executed. 2. The commands in this step should be executed on all cluster nodes, whether or not they are licensed to use MACRO-64 Assembler; failure to do so may cause unexpected errors for users. ________________________Note ________________________ If you are using a dual-architecture (VAX and Alpha systems) heterogeneous cluster, before executing these commands, make sure the appropriate logical names have been set to define the scope of the SYSMAN DO commands. For more information, see the OpenVMS System Manager's Manual. _____________________________________________________ While logged in as SYSTEM, or as another username that has the CMKRNL and SYSPRV privileges enabled, use the OpenVMS SYSMAN utility to make the new versions of DCLTABLES.EXE available, as follows: $ RUN SYS$SYSTEM:SYSMAN SYSMAN> SET ENVIRONMENT/CLUSTER %SYSMAN-I-ENV, current command environment: Clusterwide on local cluster Username SYSTEM will be used on nonlocal nodes SYSMAN> DO INSTALL REPLACE SYS$LIBRARY:DCLTABLES.EXE %SYSMAN-I-OUTPUT, command execution on node NODE1 %SYSMAN-I-OUTPUT, command execution on node NODE2 The SYSMAN utility will cause each DO command to be executed on all nodes of the local cluster. After Installing MACRO-64 Assembler 3. Finally, exit from SYSMAN. SYSMAN> EXIT $ 3.3 Making the MACRO64 Commands Available After Installation MACRO-64 Assembler is now installed and can be invoked by all users with the MACRO64 commands. The installation procedure modifies the DCL command table so that the MACRO64 commands are recognized and processed. However, the previous command table is still in effect for those users who are currently logged in. All logged-in users who want to use the MACRO64 commands must log out and log in again, or use the following DCL command: $ SET COMMAND /TABLES=SYS$LIBRARY:DCLTABLES 3.4 User Account Requirements No special privileges are needed to use MACRO-64 Assembler. There is no benefit from installing the compilers with privileges. To use MACRO-64 Assembler, a user account does not need to meet any special quota requirements. However, for users who will be compiling very large programs (many program units compiled together) or running very large performance-critical programs, consider the adjusting working set (WSDEF, WSQUOTA, WSEXTENT) and page file (PGFLQUOTA) account quotas to improve performance. Use the OpenVMS Authorize Utility from a suitably privileged account to change the process quotas in the user authorization file (UAF). Some sites may restrict the use of the Authorize Utility to certain accounts or people. After the quotas for the account have been changed, the user should log out of the account and log in again for the new quotas to take effect. For information on using the Authorize Utility, see the OpenVMS System Manager's Manual: Essentials. After Installing MACRO-64 Assembler 3-3 Enhancing MACRO-64 Assembler Performance This section includes information on system tuning and explains how to install MACRO-64 Assembler as a shared image. After you install MACRO-64 Assembler, you might want to adjust your system to enhance performance or lower the use of some system resources. If users will be compiling very large programs (many program units compiled together) or running very large performance-critical programs, consider the following: o Check that adequate page file space exists. Large programs need more virtual memory during compilation and execution than small programs. Use the INSTALL command to extend an existing page file or create one or more new page files. o The SYSGEN parameter virtual page count is related to the total amount of page file space. If you create more page file space, review the virtual page count parameter and increase it if necessary. o The SYSGEN parameter maximum working set (WSMAX) might also be checked if a larger process working set is needed. For more information on page file use and SYSGEN parameters, see the OpenVMS System Manager's Manual: Tuning, Monitoring, and Complex Systems. For information about system tuning and performance investigation, see the Guide to OpenVMS Performance Management. Removing Digital MACRO64 To remove Digital MACRO64 from the system, use the following command: $ PRODUCT REMOVE MACRO64 After Installing MACRO-64 Assembler 3.7 Troubleshooting Tips If your installation is not successful, check for the following possible problems: o The appropriate PAK must be available to the user performing the installation. The PAK must be reg- istered and loaded before you can install MACRO-64 Assembler. For information about registering a PAK, see Section 1.3. Then reinstall MACRO-64 Assembler. o The DCLTABLES.EXE file should be in the SYS$COMMON:[SYSLIB] directory. There should not be a copy of DCLTABLES.EXE in SYS$SPECIFIC:[SYSLIB]. If a copy of DCLTABLES.EXE is found in a SYS$SPECIFIC root, rename it to DCLTABLES.OLD, do an INSTALL REPLACE SYS$LIBRARY:DCLTABLES, then reinstall MACRO-64 Assembler. o The system logical name SYS$SYSROOT should not be modified from the preset definition provided by the OpenVMS Alpha operating system. 3.8 Getting Help and Reporting Problems If you encounter a problem while using MACRO-64 Assembler, report it to Digital. If an error occurs while MACRO-64 Assembler is in use and you believe the error is caused by a problem with MACRO-64 Assembler, take one of the following actions: o If you have a Software Product Services Support Agreement, consider contacting your Customer Support Center (CSC) by telephone (in the United States, 1- 800-354-9000) or by using the electronic means provided with your support agreement. You can use DSNlink or other electronic means to report the problem to the CSC. o Customers without a service contract can arrange for per-call CSC support. After Installing MACRO-64 Assembler 3-5 When you initially contact the CSC, please indicate the following: o The name and version number of the operating system (OpenVMS Alpha) you are using o The name (MACRO-64 Assembler) and version number of MACRO-64 Assembler you are using o The hardware system you are using (such as a model number) o How critical the problem is o A very brief description of the problem (one sentence if possible) When you submit information electronically or are speaking on the phone to the appropriate 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 try to narrow the cause of the problem to a specific source 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 (floppy diskette or magnetic tape). Experience shows that problem reports sometimes do not contain enough information to duplicate or identify the problem. Concise, complete information helps Digital give accurate and timely service to software problems. To obtain information about purchasing Digital support services, please contact your local Digital sales representative. After Installing MACRO-64 Assembler A ________________________________________________________________ Sample MACRO-64 Assembler Version 1.2 Listings This appendix provides listings of the following procedures: o A MACRO-64 Assembler installation from CD-ROM (Section A.1) o A procedure for removing MACRO-64 Assembler after installation (Section A.2) This installation guide is not revised for each release of MACRO-64 Assembler. When installing later versions of MACRO-64 Assembler, the displayed numbers for the subsets, version, and subset directory will differ. A.1 Sample MACRO-64 Assembler Installation This appendix shows a new installation (all lines are displayed). The actual menu display shown on your system might not include certain lines if you have a recent version of MACRO-64 Assembler installed. The install command assumes that the .pcsi file: DEC-AXPVMS-MACRO64-V0102--1.PCSI is in sys$login. # $ product install/producer=dec/base_system=axpvms/version=1.2/source=sys$login macro64 The following product has been selected: DEC AXPVMS MACRO64 V1.2 Layered Product Configuration phase starting ... You will be asked to choose options, if any, for each selected product and for any products that may be installed to satisfy software dependency requirements. DEC AXPVMS MACRO64 V1.2: MACRO-64 Assembler for OpenVMS Alpha COPYRIGHT (c) 1998 -- All rights reserved Digital Equipment Corporation Sample MACRO-64 Assembler Version 1.2 Listings A-1 you want the defaults for all options? [YES] you want to review the options? [NO] phase starting ... following product will be installed: DEC AXPVMS MACRO64 V1.2 Layered Product done: 0%...50%...60%...70%...80%...90%...100% following product has been installed: DEC AXPVMS MACRO64 V1.2 Layered Product test procedure executing ... test procedure completed successfully Sample MACRO-64 Assembler Installation Removal Procedure This sample shows MACRO-64 Assembler being removed. product remove macro64 following product has been selected: DEC AXPVMS MACRO64 V1.2 Layered Product you want to continue? [YES] following product will be removed: DEC AXPVMS MACRO64 V1.2 Layered Product done: 0%...30%...40%...50%...60%...70%...80%...90%...100% following product has been removed: DEC AXPVMS MACRO64 V1.2 Layered Product Sample MACRO-64 Assembler Version 1.2 Listings