                                     C                      MACRO-64_Assembler_for_OpenVMS_AXP_Systems____ '                      Installation Guide   .                      Order Number: AA-PT9LB-TE    "                      November 1993  G                      This document contains instructions for installing F                      MACRO-64 Assembler for OpenVMS AXP Systems on the2                      OpenVMS AXP operating system.            G                      Revision/Update Information: This guide supersedes B                                                   the MACRO-64 for?                                                   OpenVMS Alpha D                                                   Installation GuideC                                                   (Order Number AA- <                                                   PT9LA-TE).  D                      Software Version:            MACRO-64 AssemblerA                                                   for OpenVMS AXP E                                                   Systems Version 1.1   F                      Operating System and Version: OpenVMS AXP Version?                                                   1.5 or higher   2                      Digital Equipment Corporation+                      Maynard, Massachusetts                  H               __________________________________________________________+               First printing, November 1992 $               Revised, November 1993  C               Digital Equipment Corporation makes no representation E               that the use of its products in the manner described in F               this publication will not infringe on existing or futureF               patent rights, nor do the descriptions contained in thisF               publication imply the granting of licenses to make, use,B               or sell equipment or software in accordance with the               description.  F               Possession, use, or copying of the software described inE               this publication is authorized only pursuant to a valid H               written license from Digital or an authorized sublicensor.  D                Digital Equipment Corporation 1992, 1993. All rights               reserved.   D               The postpaid Reader's Comments form at the end of thisC               printed document requests your critical evaluation to 7               assist in preparing future documentation.   ?               The following are trademarks of Digital Equipment @               Corporation: Alpha AXP, AXP, DEC, DECnet, Digital,6               OpenVMS, VAX, VMS, and the DIGITAL logo.  H                                                                   ZK6340  3               This document is available on CD-ROM.   D               This document was prepared using VAX DOCUMENT, Version               2.1.                               E      ________________________________________________________________   E                                                              Contents     E      Preface..................................................      v     +      1  Preparing for MACRO-64 Installation   E            1.1   Required Operating System Components.........    1-1 E            1.2   Associated Software..........................    1-1 E            1.2.1     DEC Language-Sensitive Editor............    1-2 E            1.3   License Registration.........................    1-2 E            1.4   VMS Cluster Considerations...................    1-2 E            1.5   Installation Procedure Requirements..........    1-3 E            1.5.1     Privileges and Resources.................    1-3 <            1.5.1.1     Changing System Parameter Values withE                        AUTOGEN................................    1-4 E            1.5.2     Process Account Quotas...................    1-6 E            1.5.3     VMSINSTAL Requirements...................    1-7 E            1.5.4     Backing Up Your System Disk..............    1-7         2  Installing MACRO-64   E            2.1   The Installation Procedure...................    2-1 E            2.2   Error Recovery...............................   2-10   !      3  After Installing MACRO-64   6            3.1   Running the Installation VerificationE                  Procedure Separately.........................    3-1 E            3.2   Installing MACRO-64 on a VMS Cluster ........    3-1 E            3.3   User Account Requirements....................    3-2 E            3.4   Installing MACRO-64 as a Shared Image........    3-2 E            3.5   Determining and Reporting Problems...........    3-4       E                                                                   iii                           A  Sample Installation  H               A.1   Sample Installation..........................    A-1  )         B  Files Installed on Your System   H               B.1   File Names...................................    B-1             Tables  >               1-1       Process Account Quotas for the AccountH                         Installation.............................    1-6                                                                
         iv                           H         ________________________________________________________________  H                                                                  Preface               Purpose of This Guide   H               This guide describes how to install the MACRO-64 AssemblerH               for OpenVMS AXP Systems on AXP processors that are running/               the OpenVMS AXP operating system.   G               Keep this guide with your distribution kit. You will need C               it to install maintenance updates or to reinstall the 0               MACRO-64 kit for any other reason.  G               At the back of this guide is a Reader's Comments form. If E               you have any comments about this document, fill out the H               form and mail it; your comments will be considered for the6               next revision of the installation guide.           Intended Audience   C               The audience for this guide is the system manager who -               installs the MACRO-64 software.            Document Structure  1               This guide is organized as follows:   F               o  Chapter 1 describes the operating system and hardwareG                  requirements for the MACRO-64 installation and related F                  procedures that you complete before installing MACRO-                  64.  F               o  Chapter 2 describes the step-by-step instructions for"                  the installation.  C               o  Chapter 3 describes the actions and considerations (                  after the installation.  H                                                                        v                 E               o  Appendix A contains sample listings for the MACRO-64                   installation.  A               o  Appendix B describes the files used by MACRO-64.            Associated Documents  H               For more information on MACRO-64, see the following manual(               in this documentation set:  <               o  MACRO-64 for OpenVMS Alpha Reference Manual  E               For more information on the Alpha AXP architecture, see                the following:  4               o  Alpha Architecture Reference Manual  ,               o  Alpha Architecture Handbook  <               o  Alpha AXP Achitecture Quick Reference Guide  )               o  OpenVMS Calling Standard   :               o  OpenVMS License Management Utility Manual  1               o  OpenVMS System Management Subkit   @               o  OpenVMS System Messages and Recovery Procedures!                  Reference Manual            Conventions   E               In this guide, every use of Alpha VMS means the OpenVMS B               AXP operating system, every use of VAX VMS means theF               OpenVMS VAX operating system, and every use of VMS meansG               both the OpenVMS AXP operating system and the OpenVMS VAX                operating system.   ?               The following conventions are used in this guide:   H               UPPERCASE TEXT         Uppercase text indicates a command,G                                      the name of a routine, the name of F                                      a file, or the abbreviation for a6                                      system privilege.  H               $ @SYS$UPDATE:VMSINSTALIn interactive examples, user inputA                                      is printed in boldface text.   
         vi                   H               $                      The dollar sign is used to indicateG                                      the DCL prompt. This prompt may be >                                      different on your system.  F               .                      A vertical ellipsis indicates theB               .                      omission of items from a codeC               .                      example or command format; the G                                      items are omitted because they are E                                      not important to the topic being /                                      discussed.   F               file-spec, . . .       A horizontal ellipsis in examplesC                                      indicates one of the following 3                                      possibilities:   H                                      o  Additional optional arguments inF                                         a statement have been omitted.  G                                      o  The preceding item or items can F                                         be repeated one or more times.  F                                      o  Additional parameters, values,C                                         or other information can be 0                                         entered.  F               [logical-name]         Square brackets indicate that theG                                      enclosed item is optional. (Square H                                      brackets are not, however, optionalF                                      in the syntax of a directory nameF                                      in a file specification or in theH                                      syntax of a substring specificationA                                      in an assignment statement.)   @               MACRO-64               MACRO-64 refers to MACRO-64G                                      Assembler for OpenVMS AXP Systems.                   H                                                                      vii                       H                                                                        1H         ________________________________________________________________  H                                      Preparing for MACRO-64 Installation      F               This chapter discusses the preparations and requirements0               necessary for installing MACRO-64.  B               This guide applies to MACRO-64 Assembler for OpenVMSD               AXP Systems Version 1.1 and all subsequent maintenance<               releases up to the next major product release.  C               Your bill of materials (BOM) specifies the number and D               contents of your media. Be sure to verify the contentsG               of your kit with this information. If your kit is damaged G               or if you find that parts of it are missing, contact your %               Digital representative.   F               MACRO-64 provides online release notes. Digital strongly?               recommends that you read the release notes before B               proceeding with the installation. For information onB               accessing the online release notes, see Section 2.1.  0         1.1 Required Operating System Components  F               The OpenVMS AXP operating system comes with a variety ofG               support options, or classes. To use MACRO-64, your system F               should be running a version of OpenVMS AXP that includesF               at minimum the OpenVMS Required Saveset tailoring class.  B               For a complete list of the required classes, see theC               Software Support Addendum (SSA), which comes with the 1               Software Product Description (SPD).            1.2 Associated Software   E               This sections describes software used with the MACRO-64                assembler.    H                                                                      1-1                 +         1.2.1 DEC Language-Sensitive Editor   B               MACRO-64 does not require the DEC Language-SensitiveD               Editor (LSE) to work properly. However, if you plan toC               use MACRO-64 with LSE, you must register and load the H               license PAK and install the LSE software before installingF               MACRO-64. Otherwise, the MACRO-64 installation procedureE               does not install the MACRO-64 language template for use                with LSE.             1.3 License Registration  D               You must register and load your license for the MACRO-F               64 before you start the installation in order to run theC               Installation Verification Procedure (IVP) and use the                software.   C               To register a license under OpenVMS AXP, first log in F               to the system manager's account, SYSTEM. You then have a=               choice of two ways to perform the registration:   E               o  Invoke the SYS$UPDATE:VMSLICENSE.COM procedure. When G                  it prompts you for information, respond with data from "                  your License PAK.  F               o  At the DCL prompt, enter the LICENSE REGISTER commandC                  with the appropriate qualifiers that correspond to )                  license PAK information.   H               If you plan to use MACRO-64 on more than one node in a VMSE               cluster, you will need to perform a license load on the H               other nodes after you complete this installation. For moreF               information on how to install MACRO-64 on a VMS cluster,               see Section 3.2.  G               For complete information on using the Licencse Management H               Facility (LMF), see the OpenVMS License Management Utility               Manual.   &         1.4 VMS Cluster Considerations  C               To install MACRO-64 on each node of the cluster, your ;               account must have OPER and CMKRNL privileges.   F               For more information on how to install MACRO-64 on a VMS'               cluster, see Section 3.2.            1-2                  /         1.5 Installation Procedure Requirements   E               The following sections discuss various requirements for "               installing MACRO-64.  G               The installation takes approximately 2 to 5 minutes using &               compact disc (CD) media.  &         1.5.1 Privileges and Resources  D               Before installing MACRO-64, your account must have the8               following privileges and system resources:  A               o  SETPRV, or CMKRNL, WORLD, and SYSPRV privileges.   E               o  At least 22,000 blocks of free disk space during the D                  installation; of these, 13,000 blocks remain in use4                  after the installation is complete.  C                  To determine the number of free disk blocks on the H                  current system disk, enter the following command at the                  DCL prompt:  ,                  $ SHOW DEVICE SYS$SYSDEVICE  8               o  At least 512K bytes of physical memory.  C               o  At least 20 free global pagelets plus the size (in H                  number of disk blocks) of the SYS$LIBRARY:DCLTABLES.EXE!                  at installation.   A               o  At least 2 free global sections at installation.   F                 ________________________NOTE  ________________________  B                 You must ensure that your system has the necessaryD                 global pagelets and global section SYSGEN quotas forB                 the installation. Failure to do so could cause theB                 DCL tables to become corrupted in some situations.A                 Note that VMSINSTAL turns off BYPASS privilege at .                 the start of the installation.  E                 _____________________________________________________   E               You can use the WRITE command with the F$GETSYI lexical E               function to find the number of free global pagelets and A               global sections. The following example shows how to D               get this information at your terminal (the default for               SYS$OUTPUT):  H                                                                      1-3 t  a            :               $ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLPAGES")               15848 :               $ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLSECTS")               24  G               To determine the size of SYS$LIBRARY:DCLTABLES.EXE, enter $               the following command:  8               $ DIRECTORY/SIZE SYS$LIBRARY:DCLTABLES.EXE  >               This command displays the following information:  +               Directory SYS$COMMON:[SYSLIB]   )               DCLTABLES.EXE;299       857   -                  Total of 1 file, 857 blocks.   >               During and after installation, MACRO-64 requires?               20 global pagelets. In addition, the installation_F               procedure updates SYS$LIBRARY:DCLTABLES.EXE and requires?               a free global pagelet for each disk block used by E               SYS$LIBRARY:DCLTABLES.EXE. In this example, the size ofaE               SYS$LIBRARY:DCLTABLES.EXE is 857 disk blocks. Thus, the D               total requirement for installation of MACRO-64 in thisF               example is 20+857, or 877. Because in this example thereB               are 15,848 global pagelets free, there is no need to5               increase the number of global pagelets.   E               In addition, MACRO-64 requires two global sections both D               during and after installation. Because in this exampleF               there are currently 24 global sections free, there is no=               need to increase the number of global sections.i  E               Section 1.5.1.1 describes the procedures for increasingm)               these values using AUTOGEN.   =         1.5.1.1 Changing System Parameter Values with AUTOGEN   A               You can use the AUTOGEN command procedure to changeoE               system parameters if the number of free global pagelets:E               (GBLPAGES) and global sections (GBLSECTS) determined in,B               Section 1.5.1 is insufficient. AUTOGEN automaticallyD               adjusts values for parameters that are associated withH               the values you reset manually. To change system parameters4               with AUTOGEN, edit the following file:  &               SYS$SYSTEM:MODPARAMS.DAT           1-4_ _  _            E               Use an editor to access the file. To change a parameter A               value listed in this file, delete the current value.E               associated with that parameter and enter the new value.   A               To add a new parameter, add a line to the file that D               includes both the name of the parameter and its value.               For example:                 WSMAX = 1024  C               To modify incremental parameters such as GBLPAGES and.B               GBLSECTS, use the ADD command. The following example8               increases the global page setting by 2000:  !               ADD_GBLPAGES = 2000   F               Note that when you set the page file quota, do not use aH               value that exceeds the amount of page file space available               on the system.  G               After you make all your changes, exit from the editor and.F               execute the AUTOGEN procedure to recalculate your systemH               parameters. Enter the following command at the DCL prompt:  2               $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT  D               When you specify REBOOT, AUTOGEN performs an automaticD               system shutdown and then reboots the system. Any usersB               logged in to the system are immediately disconnectedD               during the shutdown. The automatic reboot puts the new+               parameter values into effect.2  >               AUTOGEN automatically adjusts some of the SYSGENH               parameters based on the consumption of resources since theG               last reboot. If you do not want to take advantage of this3G               automatic adjustment, include the NOFEEDBACK qualifier on '               the AUTOGEN command line.   G               For more information about using AUTOGEN, see the OpenVMS                System                Management Subkit.        H                                                                      1-5    e            $         1.5.2 Process Account Quotas  F               The account you use to install MACRO-64 must have suffi-E               cient quotas to enable you to perform the installation..H               Since VMSINSTAL verifies these quotas, it is not necessaryF               that you verify these quotas before installing MACRO-64.F               Table 1-1 summarizes the process quotas required for the#               installation account.   >               Table 1-1 Process Account Quotas for the AccountH               __________Installation____________________________________  H               Account_Quota____Minimum_Value____________________________  !               ASTLM            24   !               BIOLM            18u  %               BYTLM            20,480   !               DIOLM            18a  !               ENQLM            30   !               FILLM            20   6               PRCLM            Number required by user  3               WSDEF            300 pages minimum[1]bH               [1]The_values_for_WSEXT_and_WSQUO_must_be_equal_to_or_____  =               greater than the WSDEF value (500-700 optimal).tH               __________________________________________________________  H               User account quotas are stored in the file SYSUAF.DAT. YouF               can use the OpenVMS AXP Authorize Utility (AUTHORIZE) toF               verify and change user account quotas. To do this, firstF               set your directory to SYS$SYSTEM and then run AUTHORIZE:  &               $ SET DEFAULT SYS$SYSTEM               $ RUN AUTHORIZEy               UAF>  H               At the UAF> prompt, enter the SHOW command with an account>               name to check a particular account. For example:                 UAF> SHOW SMITHt           1-6t a  o            H               To change a quota, enter the MODIFY command. The followingG               example changes the FILLM quota for the SMITH account and *               then exits from the utility:  )               UAF> MODIFY SMITH /FILLM=50                UAF> EXIT   B               After you exit from the utility, the system displaysC               messages indicating whether or not changes were made.4H               After the changes have been made, you must log out and log9               in again for the new quotas to take effect.   ?               For more information on modifying account quotas, A               see the description of the Authorize Utility in thee/               OpenVMS System Management Subkit.A  $         1.5.3 VMSINSTAL Requirements  A               When you invoke VMSINSTAL, it checks the following:V  G               o  Whether you have set your default device and directory                   to SYS$UPDATE  B               o  Whether you are logged in to a privileged account  F               o  Whether you have adequate quotas for installation, as#                  shown in Table 1-1   *               o  Whether DECnet is running  >               o  Whether any users are logged in to the system  H               If VMSINSTAL detects any problems during the installation,B               it notifies you and asks if you want to continue theC               installation. In some instances, you can enter YES tonD               continue. To stop the installation process and correctG               the situation, enter NO or press Return. Then correct the 3               problem and restart the installation.   )         1.5.4 Backing Up Your System Diskb  E               At the beginning of the installation, VMSINSTAL asks if E               you have backed up your system disk. Digital recommendspD               that you do a system disk backup before installing any               software.   H                                                                      1-7 i  e            ?               Use the backup procedures that are established at @               your site. For details on performing a system diskB               backup, see the section on the BACKUP Utility in the/               OpenVMS System Management Subkit.f                                                                                           1-8                        H                                                                        2H         ________________________________________________________________  H                                                      Installing MACRO-64      H               This chapter explains how to install MACRO-64. Section 2.1E               contains a step-by-step description of the installation                procedure.  &         2.1 The Installation Procedure  F               The MACRO-64 installation procedure consists of a seriesE               of sequential questions and informational messages. See 3               Appendix A for a sample installation.r  H               If it is not already inserted, place the compact disk (CD)&               media into the CD drive.  D               To abort the installation procedure at any time, pressG               Ctrl/Y. When you press Ctrl/Y, the installation proceduresG               deletes all the files it has created up to that point and ?               exits. You can then start the installation again.   "               1. Invoke VMSINSTAL.  G                  VMSINSTAL is in the SYS$UPDATE directory. To start the E                  installation, invoke the VMSINSTAL command procedure F                  from a privileged account, such as the SYSTEM account,                  using the following syntax:  G                  @SYS$UPDATE:VMSINSTAL saveset-name device-name OPTIONS4	         N   ?                  The following list defines the elements of the (                  VMSINSTAL command line:                    saveset-name E                  The installation name for the component. For Version                   1.1 of ?                  MACRO-64, use the following installation name:_  !                  ALPHA_MACRO64011   H                                                                      2-1    s            H                  Note the three-digit version at the end of the save-setE                  name (011). For updated versions, adjust the versionlF                  accordingly. For example, to install MACRO-64 Version7                  1.2, you would enter ALPHA_MACRO64012.                     device-nameF                  The name of the device on which you plan to mount theH                  media. For example, DUB1: is a device name for a drive.F                  It is not necessary to use the console drive for thisH                  installation. However, if you do use the console drive,B                  you should replace any media you removed once the*                  installation is complete.                    OPTIONS NE                  An optional parameter that indicates you want to seeoE                  the question on release notes. If you do not include D                  the OPTIONS N parameter, VMSINSTAL does not ask youG                  about the release notes. You should review the release B                  notes before proceeding with the installation, inC                  case they contain additional information about thedE                  installation. If you are restarting the installationsH                  and have already reviewed the release notes, you do not+                  need to specify OPTIONS N.,  H                  There are several other options you can select when you"                  invoke VMSINSTAL:  D                  o  Auto_answer option (A): Initially creates a fileE                     that contains your answers to VMSINSTAL questions E                     and prompts. You can then use the option (and the E                     answer file) to save time during a reinstallationh<                     (typically after upgrading your system).  H                  o  Get save-set option (G): Lets you store product saveD                     sets temporarily on a magnetic tape or in a disk                     directory.  A                  o  File log option (L): Logs all activity to thee1                     terminal during installation.a  C                  o  Alternate root option (R): Lets you install theeC                     product to a system root other than that of theo#                     running system.              2-2t a  n            B                  If you specify more than one option, separate theC                  options with commas (OPTIONS A,N). See the OpenVMSiB                  AXP documentation on software installation in the>                  OpenVMS System Management Subkit for detailed.                  information on these options.  C                  The following example invokes VMSINSTAL to install ?                  MACRO-64 from drive DUB1: and shows the systemfG                  response. This example uses the OPTIONS N release noter                  parameter.T  I                  $ @SYS$UPDATE:VMSINSTAL ALPHA_MACRO64011 DUB1: OPTIONS Nt  M                    OpenVMS ALPHA Software Product Installation Procedure V1.5e  ,                  It is 12-OCT-1992 at 14:10.@                  Enter a question mark (?) at any time for help.  D                  If you do not supply either the product name or theH                  device name, VMSINSTAL prompts you for this informationD                  later in the installation procedure. VMSINSTAL doesF                  not prompt you for any options, so be sure to includeF                  OPTIONS N on the VMSINSTAL command line to access the7                  release notes during the installation.a  '               2. Confirm system backup.u  O                  * Are you satisfied with the backup of your system disk [YES]?o  E                  VMSINSTAL asks if you are satisfied with your systemsC                  backup. You should always back up your system disk.H                  before performing an installation. If you are satisfiedC                  with the backup of your system disk, press Return.OE                  Otherwise, enter NO to discontinue the installation.eH                  After you back up your system disk, you can restart the                  installation.  !               3. Mount the media.c              H                                                                      2-3                 C                  Please mount the first volume of the set on DUB1:.2%                  * Are you ready? YESh5                  %MOUNT-I-MOUNTED, CONDIST MOUNTED ONcG                                                      _$$DUB1:  (NODE 1) :                  The following products will be processed:%                    ALPHA_MACRO64 V1.1e  J                      Beginning installation of ALPHA_MACRO64 V1.1 at 14:15  E                  %VMSINSTAL-I-RESTORE, Restoring product saveset A...1  F                  When you receive the prompt to mount the first volumeC                  of the save set, you should mount the distributionfD                  volume on the device you specified when you invoked?                  VMSINSTAL. The device name appears in the line C                  preceding the question. VMSINSTAL then asks if you_=                  are ready to continue with the installation.e  C                  If you respond YES to indicate that you are ready,uG                  VMSINSTAL displays a message that the media containingtF                  MACRO-64 has been mounted on the specified device and1                  that the installation has begun.S  F                  If you entered the wrong device name when you invokedF                  VMSINSTAL and need to restart the installation, enterD                  NO in response to the "Are you ready?" question. ToH                  abort the installation for other reasons, press Ctrl/Y.                                             2-4o h  t            /               4. Select a release notes option.d  J                  Release notes included with this kit are always copied to                    SYS$HELP.  2                  Additional Release Notes Options:  +                   1.  Display release notes )                   2.  Print release notesG"                   3.  Both 1 and 2'                   4.  None of the abovez  %                  * Select option [2]:   G                  If you select option 1, VMSINSTAL displays the releaseBC                  notes immediately on the console terminal. You cannF                  terminate the display at any time by pressing Ctrl/C.  F                  If you select option 2, VMSINSTAL prompts you for the)                  name of the print queue:t  *                  * Queue name [SYS$PRINT]:  E                  You can press Return to send the file to the defaultcC                  output print device or you can enter another queue                   name.  G                  If you select option 3, VMSINSTAL displays the releaseeC                  notes immediately on the console terminal and thendF                  prompts you for a queue name for the printed version.  F                  If you select option 4, VMSINSTAL does not display orE                  print the release notes. VMSINSTAL always copies thee<                  release notes to the system help directory.  A                  Next, VMSINSTAL displays the following question:e  E                  * Do you want to continue the installation [N]?: YESsM                  %VMSINSTAL-I-RELMOVED, The product's release notes have beenoM                                               successfully moved to SYS$HELP.   D                  To continue the installation, enter YES. Otherwise,D                  press Return. In either case, the release notes are<                  copied to a file in the SYS$HELP directory:  2                  SYS$HELP:MACRO64011.RELEASE_NOTES  H                                                                      2-5 a  g            D                  After the installation, you can enter the followingE                  command to locate the release notes through the help                   facility:  5                  $ HELP MACRO/Alpha_AXP RELEASE_NOTESe                                                                                         2-6M D  A            F                 ________________________Note  ________________________  ?                 The name of the release notes file installed byfB                 VMSINSTAL consists of the current product name and?                 version number. Do not delete release notes forp.                 previous versions of MACRO-64.  E                 _____________________________________________________                  5. Purge files.S  K                  * Do you want to purge files replaced by this installationn                       [YES]?  A                  You have the option to purge files from previous A                  versions of MACRO-64 that are superseded by this F                  installation. Purging is recommended; however, if youG                  need to keep files from the previous version, enter NOe-                  in response to the question.   E               6. Choose the Installation Verification Procedure (IVP)                   option.  K                  * Do you want to run the IVP after the installation [YES]?o  G                  The installation procedure now asks if you want to runOE                  the IVP. The IVP for MACRO-64 checks to be sure thattG                  the installation is successful. It is recommended that !                  you run the IVP.e  A                  After MACRO-64 is installed, you can run the IVPeG                  independently to verify that the software is availabletD                  on your system. You might need to run the IVP afterD                  a system failure to make sure that users can access                  MACRO-64.  9               7. Respond to license registration queries.   '                  Product:       MACRO64A#                  Producer:      DECU$                  Version:       V1.1+                  Release Date:  dd-mmm-yyyy   M                  * Does this product have an authorization key registered and                     loaded?  H                  The installation procedure displays license informationH                  about your product and then asks if you have registeredA                  and loaded your Product Authorization Key (PAK).   H                                                                      2-7 ,               @                  If you have not registered and loaded your PAK,A                  you must answer NO to this question. You have toeD                  register and load your PAK to successfully completeF                  the installation. If you have not done so, you shouldG                  stop the installation, register and load your PAK, andn/                  then restart the installation._                                                                                       2-8     L            -               8. Read informational messages.   E                  At this point, the installation procedure displays a D                  number of informational messages that report on theC                  progress of the installation. There are no furtherlB                  questions. If the installation procedure has beenE                  successful up to this point, VMSINSTAL moves the new_G                  or modified files to their target directories, updatescE                  help files, and updates DCL tables, if necessary. IfsG                  you chose to have files purged, that work is done now.a6                  The following messages are displayed:  4                  No further questions will be asked.@                  Installation will take 2-5 minutes to complete.  K                  %VMSINSTAL-I-SYSDIR, This product creates system directory (                   [SYSTEST.MACRO64$IVP].  I                  %VMSINSTAL-I-MOVEFILES, files will now be moved to theirS'                   target directories...   G               9. Observe the Installation Verification Procedure (IVP).i  D                  If you chose to run the IVP, VMSINSTAL runs it now.G                  If the IVP runs successfully, the following message isD                  displayed:   W                  %MACRO64$IVP-I-PASSED, MACRO-64 Assembler for OpenVMS AXP Systems V1.1                    IVP has PASSED.  0               10.End the installation procedure.  L                     Installation of ALPHA_MACRO64011 V1.1 completed at 14:21  5                     VMSINSTAL procedure done at 14:22e  ?                  The previous messages indicate that the entiree4                  installation procedure is complete.  ?                  You can now log out of the privileged account:e                    $ LOGOUThA                  SYSTEM     logged out at 12-OCT-1992 14:25:12.01     H                                                                      2-9 Y  P            B                  Note that VMSINSTAL deletes or changes entries inC                  the process symbol tables during the installation. B                  Therefore, if you are going to continue using theG                  system manager's account and you want to restore these >                  symbols, you should log out and log in again.             2.2 Error Recovery  D               If errors occur during the installation itself or whenG               the Installation Verification Procedure (IVP) is running,nF               VMSINSTAL displays failure messages. If the installation3               fails, you see the following message:   N               %VMSINSTAL-E-INSFAIL, The installation of MACRO-64 Assembler for3                OpenVMS AXP Systems V1.1 has failed.h  C               If the IVP fails, the following message is displayed:u  T               MACRO64$IVP-F-FAILURE, MACRO-64 Assembler for OpenVMS AXP Systems V1.1                IVP has failed.  D               Errors can occur during the installation if any of the)               following conditions exist:   ;               o  The operating system version is incorrect.   A               o  Quotas necessary for successful installation are                   insufficient.  H               o  System parameter values for successful installation are                  insufficient.  >               o  The OpenVMS Help Library is currently in use.  H               o  The product license has not been registered and loaded.  ?               o  The DEC Language-Sensitive Editor (LSE) is not_@                  installed. If you choose to use LSE, it must beE                  installed before you install MACRO-64. If you do note@                  intend to use LSE, you may ignore this message.  G               For descriptions of the error messages generated by these.F               conditions, see the OpenVMS System Messages and RecoveryG               Procedures Reference Manual. If you are notified that any H               of these conditions exist, you should take the appropriateD               action as described in the message. For information onE               installation requirements, see Chapter 1 of this guide.            2-10 o  t                  H                                                                        3H         ________________________________________________________________  H                                                After Installing MACRO-64      C               The following tasks can be performed after installingV               MACRO-64:D  F               o  Running the Installation Verification Procedure (IVP)                  separately.  <               o  Making the product usable on a VMS cluster.  -               o  Setting user account quotas.:  $               o  Reporting problems.  F         3.1 Running the Installation Verification Procedure Separately  E               You usually run the Installation Verification ProceduremC               (IVP) during installation. If you want to run the IVPsC               separately to ensure the integrity of installed filesoA               should system problems occur, execute the following_                command procedure:  )               $ @SYS$TEST:MACRO64$IVP.COM   F               If the IVP runs successfully, the following message will               be displayed:t  T               %MACRO64$IVP-I-PASSED, MACRO-64 Assembler for OpenVMS AXP Systems V1.1                IVP has PASSED.  0         3.2 Installing MACRO-64 on a VMS Cluster  E               After installing MACRO-64 using VMSINSTAL, you can then A               install it on each node of the cluster. Perform thep               following steps:  E               1. Add the privileges OPER and CMKRNL for your process. -                  Enter the following command:   H                                                                      3-1 v               6                  $ SET PROCESS/PRIVILEGE=(OPER,CMKRNL)  >               2. Invoke the System Management Utility. Set theG                  environment to the entire cluster and allow 10 seconds @                  or longer for the command to execute. Enter the$                  following commands:                    $ MCR SYSMANt0                  SYSMAN> SET ENVIRONMENT/CLUSTER-                  SYSMAN> SET TIMEOUT 00:00:10   F               3. Replace the DCL tables with the new copy on all nodes=                  in the cluster. Enter the following command:   E                  SYSMAN> DO INSTALL REPLACE SYS$LIBRARY:DCLTABLES.EXE 0                               /OPEN/HEADER/SHARE  F               4. Exit from the System Management Utility and reset theB                  process privileges. Enter the following commands:                    SYSMAN> EXIT :                  $ SET PROCESS/PRIVILEGE=(NOOPER,NOCMKRNL)  %         3.3 User Account Requirementsa  B               To use the MACRO-64, each account must have at leastC               the TMPMBX and NETMBX privileges. Use the OpenVMS AXP C               Authorize Utility to determine whether users have thet&               privileges they require.  1         3.4 Installing MACRO-64 as a Shared Imaged  F               If MACRO-64 will be used extensively on your system, youC               can reduce system overhead and memory requirements byoE               installing it as a shared image. If you want to performnE               the installation on a system that is currently running, F               use the OpenVMS AXP Install Utility while you are loggedB               in to a privileged account. If errors occur, see theG               OpenVMS System Messages and Recovery Procedures Referencei               Manual.   @               To install MACRO-64 as a shared image, perform the               following steps:  C               1. Determine the number of available global pages andeF                  global sections on your system. See Section 1.5.1 for/                  information on how to do this.V           3-2t                 C               2. Invoke the OpenVMS AXP Install Utility and installr8                  MACRO-64 as a shared image, as follows:  C                  $ INSTALL ADD SYS$SYSTEM:MACRO64.EXE /OPEN /SHAREDA  B                  If you wish to install MACRO-64 as a shared image@                  on each node of a VMS cluster, you need to per-@                  form steps 3 through 6. If not, then proceed to                  step 7.  E               3. Add the privileges OPER and CMKRNL for your process. -                  Enter the following command:   6                  $ SET PROCESS/PRIVILEGE=(OPER,CMKRNL)  >               4. Invoke the System Management Utility. Set theG                  environment to the entire cluster and allow 10 seconds @                  or longer for the command to execute. Enter the$                  following commands:                    $ MCR SYSMANk0                  SYSMAN> SET ENVIRONMENT/CLUSTER-                  SYSMAN> SET TIMEOUT 00:00:10   H               5. Install MACRO-64 on all nodes in the cluster. Enter the#                  following command:   >                  SYSMAN> DO INSTALL ADD SYS$SYSTEM:MACRO64.EXE1                               /OPEN/HEADER/SHARED   F               6. Exit from the System Management Utility and reset theB                  process privileges. Enter the following commands:                    SYSMAN> EXITu:                  $ SET PROCESS/PRIVILEGE=(NOOPER,NOCMKRNL)  D               7. Update the system startup file to install MACRO-64.  G                  To insure that MACRO-64 is installed as a shared image B                  each time the system is bootstrapped, include theH                  following lines in the site-specific startup file found.                  in the SYS$MANAGER directory:  C                  $ INSTALL ADD SYS$SYSTEM:MACRO64.EXE /OPEN /SHAREDo  H                                                                      3-3                 .         3.5 Determining and Reporting Problems  E               If you encounter a problem while using MACRO-64, report C               it to Digital. Depending on the nature of the problemuG               and the type of support you have, you can take one of the                 following actions:  @               o  If your software contract or warranty agreementA                  entitles you to telephone support, call Digital.e  F               o  If the problem has to do with MACRO-64 documentation,G                  fill out and submit a Reader's Comments form. There istH                  a Reader's Comment form at the back of each manual. UseG                  the form from the manual in which you found the error. 5                  Include the section and page number.a  H               Review the Software Product Description (SPD) and WarrantyG               Addendum for an explanation of warranty. If you encounterlF               a problem during the warranty period, report the problemF               as previously indicated or follow alternate instructionsB               provided by Digital for reporting SPD nonconformance               problems.                                                        3-4R a  n                  H                                                                        AH         ________________________________________________________________  H                                                      Sample Installation      D               This appendix contains a sample installation of MACRO-E               64. This sample was run on a system that had a previousVH               version of MACRO-64 installed. Depending on the version ofF               OpenVMS AXP you are using and which layered products youH               have on your system, you might see additional messages and;               questions when you perform your installation.t  3               The sample installation assumes that:   *               o  DECnet has been shut down  6               o  No users are logged in to your system  '               o  OPTIONS N is specified   E               o  The installation is not done from the SYSTEM accountd  A               o  The Installation Verification Procedure (IVP) isl8                  executed at the end of the installation  B               o  The logical name, MACRO64_KIT, is assigned to theD                  device and the directory of the installation media.           A.1 Sample Installation   B               This a sample log file from a MACRO-64 installation.  %               $ @SYS$UPDATE:VMSINSTAL   I                OpenVMS ALPHA Software Product Installation Procedure V1.5s  )               It is 22-OCT-1993 at 16:15.S  =               Enter a question mark (?) at any time for help.   H                                                                      A-1                 L               %VMSINSTAL-W-ACTIVE, The following processes are still active:                BATCH_933                BATCH_9346               * Do you want to continue anyway [NO]? YN               * Are you satisfied with the backup of your system disk [YES]? YK               * Where will the distribution volumes be mounted: SYS$UPDATE:   X               Enter the products to be processed from the first distribution volume set.*               * Products: ALPHA_MACRO64011B               * Enter installation options you wish to use (none):7               The following products will be processed:   "                 ALPHA_MACRO64 V1.1  D                Beginning installation of ALPHA_MACRO64 V1.1 at 16:15  D               %VMSINSTAL-I-RESTORE, Restoring product save set A ...Y               %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP.   S                   MACRO-64 for OpenVMS AXP (TM) Systems V1.1 Installation Procedures  Y                    Digital Equipment Corporation 1991, 1992, 1993.  All rights reserved._  K                   Restricted Rights: Use, duplication, or disclosure by the L                   U.S. Government is subject to restrictions as set forth inH                   subparagraph (c) (1) (ii) of DFARS 252.227-7013, or inM                   FAR 52.227-19, or in FAR 52.227-14 Alt. III, as applicable.t  O                   This software is proprietary to and embodies the confidentialrS                   technology of Digital Equipment Corporation.  Possession, use, or S                   copying of this software and media is authorized only pursuant to T                   a valid written license from Digital or an authorized sublicensor.  O               * Do you want to purge files replaced by this installation [YES]?   O                 This kit contains a file summarizing the new features, changes, I                 restrictions, and compatibility issues in this release of R                 MACRO-64.  This file is named MACRO64011.RELEASE_NOTES and will be$                 placed in SYS$HELP:.  K                 The release notes contains information valuable to MACRO-64mN                 users.  Please inform MACRO-64 users of this file's existence.  S                 This kit also contains an Installation Verification Procedure (IVP) U                 which can be used at any time to verify the installation of MACRO-64.oU                 You can invoke the IVP after installation with the following command:   +                     $ @SYS$TEST:MACRO64$IVPo           A-2t i  i            L                 If you wish, you can also run the IVP automatically when the1                 installation procedure completes.   H               * Do you want to run the IVP after the installation [YES]?  ,                       Product:      MACRO-64'                       Producer:     DEC '                       Version:      1.1 .                       Release Date: 1-NOV-1993  T               * Does this product have an authorization key registered and loaded? Y  2                No further questions will be asked.?                Installation will take 2-10 minutes to complete.I  H               %VMSINSTAL-I-SYSDIR, This product creates system directory$               [SYSTEST.MACRO64$IVP].O               %CREATE-I-EXISTS, VMI$COMMON:[SYSTEST.MACRO64$IVP] already exists \               %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...]               %MACRO64$IVP-I-PASSED, MACRO-64 Assembler for OpenVMS AXP (TM) Systems V1.1 IVPl               has PASSEDD                Installation of ALPHA_MACRO64 V1.1 completed at 16:23  L                   Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY  ]                   Creating installation data file: VMI$ROOT:[SYSUPD]ALPHA_MACRO64011.VMI_DATAo  W               Enter the products to be processed from the next distribution volume set.                * Products: ^Z0                VMSINSTAL procedure done at 16:25                 $ LOGOB                 SYSTEM       logged out at 22-OCT-1993 16:25:28.38                        H                                                                      A-3 s  l                  H                                                                        BH         ________________________________________________________________  H                                           Files Installed on Your System      H               MACRO-64 installation procedure installs a number of filesD               on your system. Section B.1 lists the files installed.           B.1 File Names  G               This section lists the names of all files created on yourm               system when $               MACRO-64 is installed.  '               o  SYS$SYSTEM:MACRO64.EXEe  *                  MACRO-64 executable image  *               o  SYS$MESSAGE:MACRO$MSG.EXE  ,                  MACRO-64 assembler messages  2               o  SYS$HELP:MACRO64011.RELEASE_NOTES  '                  MACRO-64 release notesa  )               o  SYS$TEST:MACRO64$IVP.COMs  H                  MACRO-64 Installation Verification Program command file  A               o  SYS$SYSROOT:[SYSTEST.MACRO64$IVP]MACRO64$IVP.M64c  G                  MACRO-64 Installation Verification Program source filet  A               o  SYS$SYSROOT:[SYSTEST.MACRO64$IVP]MACRO64$IVP.OBJ   G                  MACRO-64 Installation Verification Program object fileN  (               o  SYS$LIBRARY:MACRO64.MLB  4                  MACRO-64 library of supplied macros  /               o  SYS$EXAMPLES:MACRO64$HELLO.M64y  )                  MACRO-64 example program   /               o  SYS$EXAMPLES:MACRO64$WHAMI.M64t  )                  MACRO-64 example programu  H                                                                      B-1 f  r            ,               o  SYS$EXAMPLES:MACRO64$PI.M64  )                  MACRO-64 example program                                                                                              B-2 