                                   <               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 runningA               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 4                                             systems.  A               Operating System:             OpenVMS Alpha Version ?                                             6.1 (or higher; see 8                                             Section 1.1)  >               Software Version:             MACRO-64 Assembler;                                             Version 1.2 (or 3                                             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,8     or sell equipment or software in accordance with the     description.  9     Possession, use, or copying of the software described 8     in this publication is authorized only pursuant to a7     valid written license from Digital or an authorized      sublicensor.  >      Digital Equipment Corporation 1998. All Rights Reserved.  5     The following are trademarks of Digital Equipment 8     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-44   1.4.1     Installation Account Privileges and Disk<             Space....................................    1-4<   1.4.2     System Parameters........................    1-51   1.4.2.1     Calculating Values for GBLPAGES and <               GBLSECTIONS............................    1-63   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-23   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    0   Sample MACRO-64 Assembler Version 1.2 Listings  >     A.1   Sample MACRO-64 Assembler Installation.......    A-10     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                           A  ________________________________________________________________   A                                                           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 needA        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   2        This guide contains the following chapters:  7        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.       A                                                                 v                    Documentation  5     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)   8     o  Alpha Architecture Reference Manual (EY-L520E-LP)  =     o  A letter titled Read Before Installing or Using MACRO- 9        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" 8     cover letter and the release notes, see Section 1.1.  9     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 followed5     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  0     o  OpenVMS License Management Utility Manual  7     o  OpenVMS System Manager's Manual, which includes:   5        -  OpenVMS System Manager's Manual: Essentials   >        -  OpenVMS System Manager's Manual: Tuning, Monitoring,           and Complex Systems   .     o  Guide to OpenVMS Performance Management  9     For help understanding OpenVMS system error messages, ;     see the OpenVMS System Messages and Recovery Procedures 9     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:   A        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   A        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 commentsA        or questions about MACRO-64 Assembler, you can contact the A        Customer Support Center (CSC), preferably using electronic A        means such as DSNlink. In the United States, customers can 8        call the CSC at 1-800-354-9000 (see Section 3.8).    Conventions  ;        Table 1 lists the conventions used in this document.   A        Table_1_Conventions_Used_in_This_Document_________________   A        Convention__________Meaning_______________________________   >        UPPERCASE_TEXT      Uppercase letters indicate the name?                            of a command, a file, a parameter, a 3                            procedure, or a utility.   A                                          (continued on next page)       A                                                               vii                  >     Table_1_(Cont.)__Conventions_Used_in_This_Document________  >     Convention__________Meaning_______________________________  ;     $ SHOW DEFAULT      In interactive examples, prompts or >                         displayed text appears in a monospaced9                         font. User input appears in bold.   9     $                   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.   =     <Return>            In code examples, a key name is shown =                         enclosed to indicate that you press a *                         key on a keyboard.  9     [YES]               Square brackets indicate that the 8                         enclosed item is a default value8                         in an installation prompt. Also,;                         square brackets serve as delimiters 6                         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 more8                         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.                       A                                                                 1 A  ________________________________________________________________   A                     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)  3        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 0        CD-ROM) set provides the following files:  3        o  MACRO-64 Assembler installation kit files   =        o  MACRO-64 Assembler documentation files, including a A           "read first" cover letter, this installation guide, and            other files   ;        o  Online CD-ROM documentation files in the [README] A           directory on the first media CD-ROM, including a CD-ROM 7           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.  A                 Preparing for MACRO-64 Assembler Installation 1-1                  ;     MACRO-64 Assembler provides online release notes and an %     online "read first" cover letter:   8     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- 8        64 Assembler installation. The MACRO-64 Assembler<        release notes are also installed on your system after        installation.  6     For information about using the CDMENU utility and<     locating the appropriate media CD-ROM and directory that9     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 8        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).  9     DIGITAL strongly recommends that you read the release 9     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 9     minimum version of the OpenVMS Alpha operating system 4     required for this release of MACRO-64 Assembler.  ;     After installation, the release notes are installed in:   $       SYS$HELP:MACRO64.RELEASE_NOTES    0  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 base4        component and the following other components:          o  Programming support           o  Utilities   A        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.m  ?        The License PAK may be shipped along with the kit if youc?        ordered the license and media together; otherwise, it isA=        shipped separately to a location based on your licensen<        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 PAKn!        registration requirements.   >        If you are installing prerequisite or optional software?        along with MACRO-64 Assembler, review the PAK status and A        install the PAKs for any prerequisite or optional software -        before you install MACRO-64 Assembler.   A                 Preparing for MACRO-64 Assembler Installation 1-3t                 8     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.m  6     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 command9        with the appropriate qualifiers that correspond to         License PAK information.u  :     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  8     After you have registered and loaded the license PAK:     and have previously read the appropriate parts of this>     installation guide, the installation takes approximately 29     to 5 minutes, depending on your system configuration.r  3  Installation     Account Privileges and Disk SpaceE  ;     To install MACRO-64 Assembler, you must be logged in to 9     an account that has at least the following privilegesa     enabled:  
     o  CMKRNL   
     o  SYSLCKa  
     o  SYSPRVm    0  Preparing   for MACRO-64 Assembler Installation                 A        Table 1-1 lists MACRO-64 Assembler's requirements for freem        disk storage space.    A        Table_1-1_Disk_Space_Requirements__________________________  '                                  During C        Kit_Component_____________Installation____After_Installation   <        Digital MACRO-64          1000 blocks     1000 blocksA        Assembler_________________________________________________a  A        To determine the number of free disk blocks on the currenta4        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.a  7        The minimum number of free global pagelets (512-.;        byte subpage unit) and global sections needed is twot:        (2) global sections and approximately 20 contiguous8        free global pagelets, plus a sufficient number of:        contiguous free global pagelets to contain the file7        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, notr=        the total number you need to run your system and otherl        software.  ?           ________________________Note ________________________   7           If you do not ensure that your system has the =           necessary global pagelets and global section SYSGEN =           parameters for the installation, the DCL tables cani.           become corrupted in some situations.  ?           _____________________________________________________n      A                 Preparing for MACRO-64 Assembler Installation 1-5t M  O            6  Calculating       Values for GBLPAGES and GBLSECTIONS  8     To install and run MACRO-64 Assembler, you must have8     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  K     This command returns the size (in blocks) of SYS$LIBRARY:DCLTABLES.EXE.r9     As an approximation, use this figure as the number ofo!     global pagelets for the file..  ;     You can use the WRITE command with the F$GETSYI lexical.9     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):  2     $ WRITE SYS$OUTPUT F$GETSYI("CONTIG_GBLPAGES")	     15848 0     $ 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.e  4  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 orS"     GBLSECTIONS system parameters.  <     AUTOGEN automatically adjusts values for parameters that9     are associated with the values you reset manually. Tom=     change system parameters with AUTOGEN, edit the followings	     file:p       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.  0  Preparing   for MACRO-64 Assembler Installation i  a            :        To add a new parameter, add a line to the file that9        specifies the name of the parameter and its value.i<        To modify incremental parameters such as GBLPAGES and(        GBLSECTIONS, use the ADD_ prefix.  =        After you make all your changes, exit from the editor.e  <        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.n  ?        For information about using AUTOGEN and its command-line ;        parameters, see the OpenVMS System Manager's Manual: /        Tuning, Monitoring, and Complex Systems.r     1.5 Backing Up Your System Disk  A        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.n  (  1.6 Recovering from Installation Errors  =        Errors can occur during the installation if any of the "        following conditions exist:  4        o  The operating system version is incorrect.  ?        o  The privileges or disk space for successful installa-c            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 actionh         described in the message.  <        For information on system requirements for installing+        MACRO-64 Assembler, see Section 1.2.g  <        For a list of problems that can cause an unsuccessful%        installation, see Section 3.7.   7        To report a problem to Digital, see Section 3.8.   A                 Preparing for MACRO-64 Assembler Installation 1-7                        A                                                                 2 A  ________________________________________________________________B  A                                     Installing MACRO-64 Assembler               This chapter describes:  ?        o  How to read the online release notes before installa-t           tion.   <        o  How to install MACRO-64 Assembler using POLYCENTERA           Software Installation (PCSI) software. PCSI software is 4           bundled with the OpenVMS operating system.  9        Before you start the installation, read Chapter 1,h?        which describes the general options and requirements foro%        installing MACRO-64 Assembler.t  :        The installation procedure loads MACRO-64 Assembler>        product distribution files on to the system disk on the1        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.r9           This account must have the following privilegesi           enabled:             o  CMKRNL              o  SYSLCK              o  SYSPRV   :           Do not proceed with the installation unless your?           account has the CMKRNL, SYSLCK, and SYSPRV privilegesu@           enabled. If your process has the SETPRV privilege, youA           can enable the CMKRNL, SYSLCK, and SYSPRV privileges byo'           typing the following command:e  8           $ SET PROCESS/PRIVILEGE=(CMKRNL,SYSLCK,SYSPRV)  A                                 Installing MACRO-64 Assembler 2-1s    i            9        To check whether your process has these privilegese+        enabled, type the following command:            $ SHOW PROCESS/PRIVILEGES  ;     2. To obtain the kit directory location of the MACRO-64t>        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.  1        o  Contact the appropriate system manager.   =        For information about using the CDMENU utility and theY=        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 distribution9        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.c  ;     3. To determine whether the appropriate media CD-ROM isS9        already mounted on your system, type the following         command:           $ SHOW DEVICE DKA400e  <        ________________________Note ________________________  9        DKA400 is the device name used in examples in thism:        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 9        media CD-ROM (write down the volume label) into an 9        available CD-ROM drive. Type the appropriate MOUNT_;        command to mount the media CD-ROM (omit the /FOREIGNA)        qualifier), such as the following:           $ MOUNT DKA400 labelo     Installing   MACRO-64 Assembler s  l            ?           Where label is the volume label of that media CD-ROM.i  ;        5. To check that you have located the correct CD-ROMe;           device and directory, use the following DIRECTORY.           command:             $ DIRECTORYp  '           Directory DKA400:[dir.subdir]e  +           DEC-AXPVMS-MACRO64-Vnnnn-x-1.PCSIi             Total of 1 files.u  :        6. To extract the MACRO-64 Assembler online release?           notes before you install MACRO-64 Assembler, type theo           following command:  F           $ PRODUCT EXTRACT RELEASE_NOTES MACRO64 /SOURCE=disk:[dir] -"           $_/FILE=MACRO64.RELNOTES  A           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 installede:           on this system, it must be removed before MACRO-=           64 Assembler is installed. To determine if an older A           version of MACRO64 present, type the following command:i  (           $ PRODUCT SHOW PRODUCT MACRO64  <           If MACRO64 is present, the following text appears:             PRODUCT            -------l#           DEC AXPVMS MACRO64 V1.1-1              1 item found  A                                 Installing MACRO-64 Assembler 2-3  t               =        If MACRO64 is not present, the following text appears:e          PRODUCT        -------          0 items found  5        If MACRO64 is present, remove it by typing thee(        following PRODUCT REMOVE command:          $ PRODUCT REMOVE MACRO64M  "        The following text appears:  /        The following product has been selected:eA            DEC AXPVMS MACRO64 Vn.n                Layered Producto  %        Do you want to continue? [YES]i  -        The following product will be removed: A            DEC AXPVMS MACRO64 V1.2                Layered Productr  H        Portion done: 0%...30%...40%...50%...60%...70%...80%...90%...100%  .        The following product has been removed:A            DEC AXPVMS MACRO64 V1.2                Layered Product   <     8. To install the MACRO-64 Assembler Assembler, type the)        following PRODUCT INSTALL command:b  9        $ PRODUCT INSTALL MACRO64 /SOURCE=disk:[dir] /HELPa  <        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:UA            DEC AXPVMS MACRO64 Vn.n                Layered Product7  '        Configuration phase starting ...y  E        You will be asked to choose options, if any, for each selectedCD        product and for any products that may be installed to satisfy(        software dependency requirements.  D        DEC AXPVMS MACRO64 V1.2: MACRO-64 Assembler for OpenVMS Alpha  4            COPYRIGHT (c) 1998 -- All rights reserved  (            Digital Equipment Corporation  6        Do you want the defaults for all options? [YES]     Installing   MACRO-64 Assembler s  b            1           Do you want to review the options? [NO]y  @           If you wish to review the options, type YES, otherwise           type NO.  8           Installation continues with the following text           displayed:  &           Execution phase starting ...  2           The following product will be installed:D               DEC AXPVMS MACRO64 Vn.n                Layered Product  ?           Portion done: 0%...50%...60%...70%...80%...90%...100%o  3           The following product has been installed:eD               DEC AXPVMS MACRO64 V1.2                Layered Product  :           %PCSI-I-IVPEXECUTE, test procedure executing ...C           %PCSI-I-IVPSUCCESS, test procedure completed successfully   A        9. Installation takes about 2-5 minutes (depending on your @           system). When installation has been completed, the DCL           $  prompt reappears.  A        10.To obtain a list of files installed, type the followingi           command:  0           $ PRODUCT SHOW OBJECT /PRODUCT=MACRO64  9        To use other features of the PCSI utility, see the =        POLYCENTER Software Installation Utility User's Guide.t                          A                                 Installing MACRO-64 Assembler 2-5e n  m                  A                                                                 3bA  ________________________________________________________________   A                               After Installing MACRO-64 Assemblert      :        The following tasks can be performed after MACRO-64        Assembler is installed:  ?        o  Running the Installation Verification Procedure (IVP)n           separately  8        o  Making the recently installed MACRO64 commands/           available to users after installationu  3        o  Making the product usable on a VMScluster   %        o  Setting user account quotasA          o  Enhancing performancea  -        o  Getting help and reporting problemsi  ?  3.1 Running the Installation Verification Procedure Separatelym  A        The MACRO-64 Assembler Installation Verification Procedureo9        (IVP) runs automatically during MACRO-64 Assemblery        installation.  7        If system problems occur, you should run the IVPrA        separately to ensure the integrity of the installed files. 2        To run the IVP, type the following command:  "        $ @SYS$TEST:MACRO64$IVP.COM  =        If any problems are encountered, a message such as thee        following appears:k  .        Digital MACRO64 Version 1.n TEST FAILED    A                           After Installing MACRO-64 Assembler 3-1y    e              VMScluster   Considerations  ;     If you want to run MACRO-64 Assembler on multiple nodesl9     of a VMScluster, first check to see that you have theu8     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 activatee:        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 all9        cluster nodes, whether or not they are licensed toa9        use MACRO-64 Assembler; failure to do so may cause5#        unexpected errors for users.n  <        ________________________Note ________________________  :        If you are using a dual-architecture (VAX and Alpha7        systems) heterogeneous cluster, before executingi8        these commands, make sure the appropriate logical5        names have been set to define the scope of theb8        SYSMAN DO commands. For more information, see the'        OpenVMS System Manager's Manual.f  <        _____________________________________________________  =        While logged in as SYSTEM, or as another username that <        has the CMKRNL and SYSPRV privileges enabled, use the9        OpenVMS SYSMAN utility to make the new versions of +        DCLTABLES.EXE available, as follows:l          $ RUN SYS$SYSTEM:SYSMAN&        SYSMAN> SET ENVIRONMENT/CLUSTER2        %SYSMAN-I-ENV, current command environment:+                Clusterwide on local clustermC                Username SYSTEM       will be used on nonlocal nodess;        SYSMAN> DO INSTALL REPLACE SYS$LIBRARY:DCLTABLES.EXEu8        %SYSMAN-I-OUTPUT, command execution on node NODE18        %SYSMAN-I-OUTPUT, command execution on node NODE2  :        The SYSMAN utility will cause each DO command to be2        executed on all nodes of the local cluster.  &  After   Installing MACRO-64 Assembler e  n            $        3. Finally, exit from SYSMAN.             SYSMAN> EXIT           $D  =  3.3 Making the MACRO64 Commands Available After Installations  @        MACRO-64 Assembler is now installed and can be invoked by+        all users with the MACRO64 commands.e  @        The installation procedure modifies the DCL command tableA        so that the MACRO64 commands are recognized and processed._A        However, the previous command table is still in effect for /        those users who are currently logged in.n  ?        All logged-in users who want to use the MACRO64 commands >        must log out and log in again, or use the following DCL        command:_  2        $ SET COMMAND /TABLES=SYS$LIBRARY:DCLTABLES    3.4 User Account Requirements  7        No special privileges are needed to use MACRO-64 9        Assembler. There is no benefit from installing thea!        compilers with privileges.   >        To use MACRO-64 Assembler, a user account does not need;        to meet any special quota requirements. However, forf<        users who will be compiling very large programs (many=        program units compiled together) or running very largem<        performance-critical programs, consider the adjusting;        working set (WSDEF, WSQUOTA, WSEXTENT) and page fileo9        (PGFLQUOTA) account quotas to improve performance.   8        Use the OpenVMS Authorize Utility from a suitably=        privileged account to change the process quotas in the =        user authorization file (UAF). Some sites may restricti>        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.i  >        For information on using the Authorize Utility, see the3        OpenVMS System Manager's Manual: Essentials.   A                           After Installing MACRO-64 Assembler 3-3  u  u            +  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 toS>     adjust your system to enhance performance or lower the use     of some system resources.t  8     If users will be compiling very large programs (many:     program units compiled together) or running very large:     performance-critical programs, consider the following:  8     o  Check that adequate page file space exists. Large;        programs need more virtual memory during compilationt9        and execution than small programs. Use the INSTALLe<        command to extend an existing page file or create one        or more new page files.  9     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 9        also be checked if a larger process working set isn        needed.  4     For more information on page file use and SYSGEN8     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 MACRO64a  6     To remove Digital MACRO64 from the system, use the     following command:       $ PRODUCT REMOVE MACRO64        &  After   Installing MACRO-64 Assembler h  a              3.7 Troubleshooting Tipsi  <        If your installation is not successful, check for the#        following possible problems:a  ;        o  The appropriate PAK must be available to the userr;           performing the installation. The PAK must be reg-f<           istered and loaded before you can install MACRO-64A           Assembler. For information about registering a PAK, sees9           Section 1.3. Then reinstall MACRO-64 Assembler.   E        o  The DCLTABLES.EXE file should be in the SYS$COMMON:[SYSLIB]l@           directory. There should not be a copy of DCLTABLES.EXE#           in SYS$SPECIFIC:[SYSLIB].o  ?           If a copy of DCLTABLES.EXE is found in a SYS$SPECIFICa9           root, rename it to DCLTABLES.OLD, do an INSTALLr@           REPLACE SYS$LIBRARY:DCLTABLES, then reinstall MACRO-64           Assembler.  ;        o  The system logical name SYS$SYSROOT should not bef=           modified from the preset definition provided by thea)           OpenVMS Alpha operating system.   (  3.8 Getting Help and Reporting Problems  A        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 andA        you believe the error is caused by a problem with MACRO-64C4        Assembler, take one of the following actions:  9        o  If you have a Software Product Services Supportt>           Agreement, consider contacting your Customer Support=           Center (CSC) by telephone (in the United States, 1-)A           800-354-9000) or by using the electronic means providede=           with your support agreement. You can use DSNlink ord=           other electronic means to report the problem to theq           CSC.  >        o  Customers without a service contract can arrange for           per-call CSC support.r    A                           After Installing MACRO-64 Assembler 3-5  s               ;     When you initially contact the CSC, please indicate thea     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   9     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)l  >     When you submit information electronically or are speaking;     on the phone to the appropriate support specialist, your8     can provide more detailed information. This includes6     the specific commands used to compile and link the7     program, the error messages displayed, and relevantL;     detailed information (possibly including source programO<     listings). Please try to narrow the cause of the problem1     to a specific source module or lines of code.d  :     CSC personnel may ask for additional information, such=     as listings of any command files, INCLUDE files, relevantO;     data files, and so forth. If the program is longer thano;     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 5     accurate and timely service to software problems.n  :     To obtain information about purchasing Digital support5     services, please contact your local Digital salese     representative.           &  After   Installing MACRO-64 Assembler u  n                  A                                                                 ArA  ________________________________________________________________s  A                    Sample MACRO-64 Assembler Version 1.2 Listings       7        This appendix provides listings of the followingl        procedures:  7        o  A MACRO-64 Assembler installation from CD-ROM_           (Section A.1)_  ;        o  A procedure for removing MACRO-64 Assembler afterp$           installation (Section A.2)  >        This installation guide is not revised for each release?        of MACRO-64 Assembler. When installing later versions of A        MACRO-64 Assembler, the displayed numbers for the subsets,s1        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 systemN;        might not include certain lines if you have a recentG/        version of MACRO-64 Assembler installed.   7        The install command assumes that the .pcsi file:m8        DEC-AXPVMS-MACRO64-V0102--1.PCSI is in sys$login.  Y  # $ product install/producer=dec/base_system=axpvms/version=1.2/source=sys$login macro64O	  <Return>   )  The following product has been selected:E;      DEC AXPVMS MACRO64 V1.2                Layered Product   !  Configuration phase starting ...   O  You will be asked to choose options, if any, for each selected product and for P  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  A                Sample MACRO-64 Assembler Version 1.2 Listings A-1t s  i            -  you want the defaults for all options? [YES]h  %  you want to review the options? [NO]     phase        starting ...  &  following  product will be installed:8   DEC AXPVMS MACRO64 V1.2                Layered Product  3  done:      0%...50%...60%...70%...80%...90%...100%.  '  following  product has been installed:l8   DEC AXPVMS MACRO64 V1.2                Layered Product  .  test                  procedure executing ...7  test                  procedure completed successfullye  ;  Sample   MACRO-64 Assembler Installation Removal Procedure   7     This sample shows MACRO-64 Assembler being removed.i     product remove macro64 <Return>  &  following  product has been selected:8   DEC AXPVMS MACRO64 V1.2                Layered Product    you want to continue? [YES]  $  following  product will be removed:8   DEC AXPVMS MACRO64 V1.2                Layered Product  ?  done:      0%...30%...40%...50%...60%...70%...80%...90%...100%   %  following  product has been removed:68   DEC AXPVMS MACRO64 V1.2                Layered Product                    1  Sample   MACRO-64 Assembler Version 1.2 Listingse