                                       C                      MACRO-64_Assembler_for_OpenVMS_AXP_Systems____ '                      Installation Guide   .                      Order Number: AA-PT9LA-TE    "                      November 1992  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 is a new manual.   D                      Software Version:            MACRO-64 AssemblerA                                                   for OpenVMS AXP >                                                   Systems V1.0  F                      Operating System and Version: OpenVMS AXP Version5                                                   1.0           2                      Digital Equipment Corporation+                      Maynard, Massachusetts                  H               __________________________________________________________               November 1992   C               The information in this document is subject to change H               without notice and should not be construed as a commitmentA               by Digital Equipment Corporation. Digital Equipment G               Corporation assumes no responsibility for any errors that *               may appear in this document.  H               The software described in this document is furnished underD               a license and may be used or copied only in accordance-               with the terms of such license.   E               No responsibility is assumed for the use or reliability F               of software on equipment that is not supplied by Digital@               Equipment Corporation or its affiliated companies.  G               Restricted Rights: Use, duplication, or disclosure by the H               U.S. Government is subject to restrictions as set forth inE               subparagraph (c)(1)(ii) of the Rights in Technical Data A               and Computer Software clause at DFARS 252.227-7013.   3                Digital Equipment Corporation 1992.   "               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 D               Corporation: Alpha AXP, AXP, Digital, OpenVMS, OpenVMSI               AXP, PALcode, VAX, VAX DOCUMENT, VMS, and the DIGITAL logo.   C               The following are third-party trademarks: Ada[R] is a D               registered trademark of the U.S. Government, Ada Joint               Program Office.   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-2 E          1.2.1  Language-Sensitive Editor ....................    1-2 E          1.3  License Registration............................    1-2 E          1.4  VMS Cluster Considerations......................    1-3 E          1.5  Installation Procedure Requirements.............    1-3 E          1.5.1  Privileges and Resources .....................    1-3 8          1.5.1.1   Changing System Parameter Values withE                    AUTOGEN....................................    1-5 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-8   !      3  After Installing MACRO-64   =          3.1  Running the Installation Verification Procedure E               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  9            1-1     Process Account Quotas for the Account H                    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.   E               Keep this document with your distribution kit. You will H               need it to install maintenance updates or to reinstall the,               MACRO-64 for any other reason.  G               At the back of this document is a Reader's Comments form. H               If you have any comments about this document, fill out theH               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 C                  procedures that you complete before installing the                   MACRO-64.  F               o  Chapter 2 describes the step-by-step instructions for"                  the installation.  E               o  Chapter 3 describes 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 files used by the MACRO-64.            Associated Documents  E               o  MACRO-64 Assembler for OpenVMS AXP Systems Reference                   Manual   C               o  MACRO-64 Assembler for OpenVMS AXP Systems Release                   Notes  8               o  Alpha AXP Architecture Reference Manual  0               o  Alpha AXP Architecture Handbook  =               o  Alpha AXP Architecture 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   ?               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.   H               $                      The dollar sign is used to indicateG                                      the DCL prompt. This prompt may be >                                      different on your system.    
         vi                   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.)   H               VMS, OpenVMS, OpenVMS  The terms VMS, OpenVMS, and OpenVMSD               AXP                    AXP refer to the same operating,                                      system.  @               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 requirements4               necessary for installing the MACRO-64.  D               This manual applies to Version 1.0 of the MACRO-64 andF               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 includes/               at minimum the following classes:                   o  OpenVMS saveset  "               o  OpenVMS utilities  B               For a complete list of the required classes, see theC               Software Support Addendum (SSA), which comes with the 1               Software Product Description (SPD).       H                                                                      1-1           +         Preparing for MACRO-64 Installation          1.2 Associated Software            1.2 Associated Software   E               This sections describes software used with the MACRO-64                assembler.  '         1.2.1 Language-Sensitive Editor   E               MACRO-64 does not require the Language-Sensitive Editor H               (LSE) to work properly. However, if you plan to use MACRO-E               64 with LSE, you must register and load the license PAK B               and install the LSE software prior to installing theF               MACRO-64 Assembler. Otherwise, the MACRO-64 installationG               procedure 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.  D               For complete information on using LMF, see the OpenVMS0               License Management Utility Manual.               1-2            H                                      Preparing for MACRO-64 InstallationH                                           1.4 VMS Cluster Considerations  &         1.4 VMS Cluster Considerations  C               To install MACRO-64 on each node of the cluster, your B               account must have the following privileges: OPER and               CMKRNL  F               For more information on how to install MACRO-64 on a VMS'               cluster, see Section 3.2.   /         1.5 Installation Procedure Requirements   >               This section, and the following, discuss various3               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 12,000 blocks of free disk space during the D                  installation; of these, 10,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.  H                                                                      1-3           +         Preparing for MACRO-64 Installation /         1.5 Installation Procedure Requirementsg  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):  :               $ 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.s  >               During and after installation, MACRO-64 requires?               20 global pagelets. In addition, the installationeF               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 ofnE               SYS$LIBRARY:DCLTABLES.EXE is 857 disk blocks. Thus, theeD               total requirement for installation of MACRO-64 in thisG               example is 20+857, or 1057. Because in this example therenB               are 15,848 global pagelets free, there is no need to5               increase the number of global pagelets.t  E               In addition, MACRO-64 requires two global sections bothtD               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.   E               Section 1.5.1.1 describes the procedures for increasingP)               these values using AUTOGEN.            1-4e A  V      H                                      Preparing for MACRO-64 InstallationH                                  1.5 Installation Procedure Requirements  =         1.5.1.1 Changing System Parameter Values with AUTOGEN   A               You can use the AUTOGEN command procedure to changehE               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  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 andeB               GBLSECTS, use the ADD command. The following example8               increases the global page setting by 2000:  !               ADD_GBLPAGES = 20005  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 andrF               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.   >               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 thisFG               automatic adjustment, include the NOFEEDBACK qualifier on.'               the AUTOGEN command line.   H                                                                      1-5           +         Preparing for MACRO-64 Installation./         1.5 Installation Procedure Requirements   G               For more information about using AUTOGEN, see the OpenVMS                System                Management Subkit.  $         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 necessaryH               that you verify these quotas prior to installing MACRO-64.F               Table 1-1 summarizes the process quotas required for the#               installation account.u  >               Table 1-1 Process Account Quotas for the AccountH               __________Installation____________________________________  H               Account_Quota____Minimum_Value____________________________  !               ASTLM            24t  !               BIOLM            18r  %               BYTLM            20,480i  !               DIOLM            18d  !               ENQLM            30n  !               FILLM            20e  6               PRCLM            Number required by user  3               WSDEF            300 pages minimum[1]iH               [1]The_values_for_WSEXT_and_WSQUO_must_be_equal_to_or_____  =               greater than the WSDEF value (500-700 optimal).AH               __________________________________________________________  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 AUTHORIZE                UAF>  H               At the UAF> prompt, enter the SHOW command with an account>               name to check a particular account. For example:                 UAF> SHOW SMITHs           1-6n           H                                      Preparing for MACRO-64 InstallationH                                  1.5 Installation Procedure Requirements  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=50V               UAF> EXIT   B               After you exit from the utility, the system displaysC               messages indicating whether or not changes were made.SG               Once the changes have been made, you must log out and log 9               in again for the new quotas to take effect.v  ?               For more information on modifying account quotas, A               see the description of the Authorize Utility in the /               OpenVMS System Management Subkit.   $         1.5.3 VMSINSTAL Requirements  A               When you invoke VMSINSTAL, it checks the following:s  G               o  Whether you have set your default device and directoryl                  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-1T  *               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 to D               continue. To stop the installation process and correctG               the situation, enter NO or press Return. Then correct the 3               problem and restart the installation.d  )         1.5.4 Backing Up Your System Diskh  E               At the beginning of the installation, VMSINSTAL asks ifcE               you have backed up your system disk. Digital recommendsiD               that you do a system disk backup before installing any               software.   H                                                                      1-7           +         Preparing for MACRO-64 Installation /         1.5 Installation Procedure Requirementsa  ?               Use the backup procedures that are established atd@               your site. For details on performing a system diskB               backup, see the section on the BACKUP Utility in the/               OpenVMS System Management Subkit.                                                                                            1-8p n                     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 installatione               procedure.  &         2.1 The Installation Procedure  B               MACRO-64 installation procedure consists of a seriesE               of sequential questions and informational messages. SeeC3               Appendix A for a sample installation.   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 procedure_C               deletes all 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 theCE                  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 OPTIONS 	         Ns  ?                  The following list defines the elements of theu(                  VMSINSTAL command line:                    saveset-nameoA                  The installation name for the component. For thei                  Version 1.0 of ?                  MACRO-64, use the following installation name:   !                  ALPHA_MACRO64010t  H                                                                      2-1 n  m               Installing MACRO-64h&         2.1 The Installation Procedure  G                  Note the three digit version at the end of the savesetpE                  name (010). For updated versions, adjust the versionrF                  accordingly. For example, to install MACRO-64 Version7                  1.1, you would enter ALPHA_MACRO64011.                     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 see E                  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 the E                  installation. If you are restarting the installation H                  and have already reviewed the release notes, you do not+                  need to specify OPTIONS N.g  B                  Note that there are several other options you can2                  select when you invoke VMSINSTAL.  D                  o  Auto_answer option (A): Initially creates a fileE                     that contains your answers to VMSINSTAL questionstE                     and prompts. You can then use the option (and the E                     answer file) to save time during a reinstallation <                     (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 the 1                     terminal during installation.S  C                  o  Alternate root option (R): Lets you install theaC                     product to a system root other than that of the #                     running system.n             2-2d n  V      H                                                      Installing MACRO-64H                                           2.1 The Installation Procedure  B                  If you specify more than one option, separate theC                  options with commas (OPTIONS A,N). See the OpenVMSnB                  AXP documentation on software installation in the>                  OpenVMS System Management Subkit for detailed.                  information on these options.  C                  The following example invokes VMSINSTAL to installs?                  MACRO-64 from drive DUB1: and shows the system G                  response. This example uses the OPTIONS N release note                   parameter.n  I                  $ @SYS$UPDATE:VMSINSTAL ALPHA_MACRO64010 DUB1: OPTIONS Na  K                    OpenVMS AXP Software Product Installation Procedure V1.02  ,                  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.   '               2. Confirm system backup.   O                  * Are you satisfied with the backup of your system disk [YES]?c  E                  VMSINSTAL asks if you are satisfied with your system C                  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.SE                  Otherwise, enter NO to discontinue the installation. H                  After you back up your system disk, you can restart the                  installation.  !               3. Mount the media.               H                                                                      2-3 t  a               Installing MACRO-64_&         2.1 The Installation Procedure  C                  Please mount the first volume of the set on DUB1:.a%                  * Are you ready? YES 5                  %MOUNT-I-MOUNTED, CONDIST MOUNTED ONnG                                                      _$$DUB1:  (NODE 1)t:                  The following products will be processed:%                    ALPHA_MACRO64 V1.0   J                      Beginning installation of ALPHA_MACRO64 V1.0 at 14:15  E                  %VMSINSTAL-I-RESTORE, Restoring product saveset A...a  F                  When you receive the prompt to mount the first volumeB                  of the saveset, you should mount the distributionD                  volume on the device you specified when you invoked?                  VMSINSTAL. The device name appears in the linemC                  preceding the question. VMSINSTAL then asks if youf=                  are ready to continue with the installation.i  C                  If you respond YES to indicate that you are ready, G                  VMSINSTAL displays a message that the media containing4F                  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.  /               4. Select a release notes option.   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 notes "                   3.  Both 1 and 2'                   4.  None of the above   %                  * Select option [2]:B  G                  If you select option 1, VMSINSTAL displays the release C                  notes immediately on the console terminal. You can F                  terminate the display at any time by pressing Ctrl/C.           2-4e i  o      H                                                      Installing MACRO-64H                                           2.1 The Installation Procedure  F                  If you select option 2, VMSINSTAL prompts you for the)                  name of the print queue:e  *                  * Queue name [SYS$PRINT]:  E                  You can press Return to send the file to the default C                  output print device or you can enter another queue                   name.  G                  If you select option 3, VMSINSTAL displays the releaseaC                  notes immediately on the console terminal and thenuF                  prompts you for a queue name for the printed version.  F                  If you select option 4, VMSINSTAL does not display orD                  print the release notes. Note that VMSINSTAL alwaysG                  copies the release notes to the system help directory.   A                  Next, VMSINSTAL displays the following question:   E                  * Do you want to continue the installation [N]?: YES M                  %VMSINSTAL-I-RELMOVED, The product's release notes have been M                                               successfully moved to SYS$HELP.D  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:MACRO64010.RELEASE_NOTES  D                  After the installation, you can enter the followingE                  command to locate the release notes through the help                   facility:  1                  $ HELP MACRO/ALPHA RELEASE_NOTESn                      H                                                                      2-5    b               Installing MACRO-64 &         2.1 The Installation Procedure  F                 ________________________Note  ________________________  ?                 The name of the release notes file installed by B                 VMSINSTAL consists of the current product name and?                 version number. Do not delete release notes for .                 previous versions of MACRO-64.  E                 _____________________________________________________                  5. Purge files.T  K                  * Do you want to purge files replaced by this installationc                       [YES]?  A                  You have the option to purge files from previoustA                  versions of MACRO-64 that are superseded by thisuF                  installation. Purging is recommended; however, if youG                  need to keep files from the previous version, enter NO -                  in response to the question.o  E               6. Choose the Installation Verification Procedure (IVP)t                  option.  K                  * Do you want to run the IVP after the installation [YES]?.  G                  The installation procedure now asks if you want to run E                  the IVP. The IVP for MACRO-64 checks to be sure thatrG                  the installation is successful. It is recommended thate!                  you run the IVP.f  A                  After MACRO-64 is installed, you can run the IVP G                  independently to verify that the software is available D                  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:       MACRO64n#                  Producer:      DECl$                  Version:       V1.0+                  Release Date:  dd-mmm-yyyyc  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).            2-6            H                                                      Installing MACRO-64H                                           2.1 The Installation Procedure  @                  If you have not registered and loaded your PAK,A                  you must answer NO to this question. You have to_D                  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, andu/                  then restart the installation.   -               8. Read informational messages.c  E                  At this point, the installation procedure displays acD                  number of informational messages that report on theC                  progress of the installation. There are no further B                  questions. If the installation procedure has beenE                  successful up to this point, VMSINSTAL moves the new G                  or modified files to their target directories, updates E                  help files, and updates DCL tables, if necessary. If G                  you chose to have files purged, that work is done now. 6                  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 theira'                   target directories...c  G               9. Observe the Installation Verification Procedure (IVP).r  D                  If you chose to run the IVP, VMSINSTAL runs it now.G                  If the IVP runs successfully, the following message ist                  displayed:   W                  %MACRO64$IVP-I-PASSED, MACRO-64 Assembler for OpenVMS AXP Systems V1.0                    IVP has PASSED.  0               10.End the installation procedure.  L                     Installation of ALPHA_MACRO64010 V1.0 completed at 14:21  5                     VMSINSTAL procedure done at 14:22v  ?                  The previous messages indicate that the entire 4                  installation procedure is complete.  H                                                                      2-7 a  u               Installing MACRO-64 &         2.1 The Installation Procedure  ?                  You can now log out of the privileged account:                     $ LOGOUTtA                  SYSTEM     logged out at 12-OCT-1992 14:25:12.01S  B                  Note that VMSINSTAL deletes or changes entries inC                  the process symbol tables during the installation.rB                  Therefore, if you are going to continue using theG                  system manager's account and you want to restore theseg>                  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, F               VMSINSTAL displays failure messages. If the installation3               fails, you see the following message:a  N               %VMSINSTAL-E-INSFAIL, The installation of MACRO-64 Assembler for3                OpenVMS AXP Systems V1.0 has failed.o  C               If the IVP fails, the following message is displayed:e  T               MACRO64$IVP-F-FAILURE, MACRO-64 Assembler for OpenVMS AXP Systems V1.0                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.  F               o  The Language-Sensitive Editor (LSE) is not installed.H                  If you choose to use LSE, it must be installed prior toF                  installing MACRO-64. If you do not intend to use LSE,-                  you may ignore this message.            2-8o e         H                                                      Installing MACRO-64H                                                       2.2 Error Recovery  G               For descriptions of the error messages generated by these G               conditions, see the OpenVMS Systems Messages and Recovery G               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 onF               installation requirements, see Chapter 1 of this manual.                                                                              H                                                                      2-9                       H                                                                        3H         ________________________________________________________________  H                                                After Installing MACRO-64      C               The following tasks can be performed after installing                MACRO-64:   @               o  Running the Installation Verification Procedure                  separately.  <               o  Making the product usable on a VMS cluster.  -               o  Setting user account quotas.v  $               o  Reporting problems.  F         3.1 Running the Installation Verification Procedure Separately  E               You usually run the Installation Verification ProcedureaC               (IVP) during installation. If you want to run the IVPtC               separately to ensure the integrity of installed files A               should system problems occur, execute the followingr                command procedure:  )               $ @SYS$TEST:MACRO64$IVP.COM   F               If the IVP runs successfully, the following message will               be displayed:o  T               %MACRO64$IVP-I-PASSED, MACRO-64 Assembler for OpenVMS AXP Systems V1.0                IVP has PASSED.  0         3.2 Installing MACRO-64 on a VMS Cluster  E               After installing MACRO-64 using VMSINSTAL, you can thensA               install it on each node of the cluster. Perform ther               following steps.  E               1. Add the privileges OPER and CMKRNL for your process.c-                  Enter the following command:h  6                  $ SET PROCESS/PRIVILEGE=(OPER,CMKRNL)  H                                                                      3-1           !         After Installing MACRO-64O0         3.2 Installing MACRO-64 on a VMS Cluster  >               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 SYSMAN 0                  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 Requirements   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 thef&               privileges they require.  1         3.4 Installing MACRO-64 as a Shared Image   F               If MACRO-64 will be used extensively on your system, youC               can reduce system overhead and memory requirements bydE               installing it as a shared image. If you want to performeE               the installation on a system that is currently running,OF               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 Reference                Manual.   @               To install MACRO-64 as a shared image, perform the               following steps:  C               1. Determine the number of available global pages andfF                  global sections on your system. See Section 1.5.1 for/                  information on how to do this.            3-2  s  f      H                                                After Installing MACRO-64H                                3.4 Installing MACRO-64 as a Shared Image  C               2. Invoke the OpenVMS AXP Install Utility and install 8                  MACRO-64 as a shared image, as follows:  C                  $ INSTALL ADD SYS$SYSTEM:MACRO64.EXE /OPEN /SHAREDs  E                  If you wish to install MACRO-64 as a shared image onVH                  each node of a VMS cluster, you need to perform 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 SYSMAN 0                  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:N  >                  SYSMAN> DO INSTALL ADD SYS$SYSTEM:MACRO64.EXE1                               /OPEN/HEADER/SHAREDo  F               6. Exit from the System Management Utility and reset theB                  process privileges. Enter the following commands:                    SYSMAN> EXITI:                  $ SET PROCESS/PRIVILEGE=(NOOPER,NOCMKRNL)  E               7. Update the system start-up file to install MACRO-64.   G                  To insure that MACRO-64 is installed as a shared imagevB                  each time the system is bootstrapped, include theC                  following lines in the site-specific start-up filee4                  found in the SYS$MANAGER directory.  C                  $ INSTALL ADD SYS$SYSTEM:MACRO64.EXE /OPEN /SHARED     H                                                                      3-3 N  L      !         After Installing MACRO-64n.         3.5 Determining and Reporting Problems  .         3.5 Determining and Reporting Problems  E               If you encounter a problem while using MACRO-64, reportnC               it to Digital. Depending on the nature of the problemoG               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.   <               o  Submit a Software Performance Report (SPR).  F               o  If the problem has to do with MACRO-64 documentation,G                  fill out and submit a Reader's Comments form. There is H                  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.s  H               Review the Software Product Description (SPD) and WarrantyG               Addendum for an explanation of warranty. If you encounteriF               a problem during the warranty period, report the problemF               as previously indicated or follow alternate instructionsB               provided by Digital for reporting SPD nonconformance               problems.N  F               See MACRO-64 Version 1.0 cover letter for information on#               how to submit an SPR.T                                             3-4n h  i                  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 previous H               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.s  3               The sample installation assumes that:M  *               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 accountR  A               o  The Installation Verification Procedure (IVP) is 8                  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.  M               $ @sys$update:vmsinstal alpha_macro64010 macro64_kit: options N   G                OpenVMS AXP Software Product Installation Procedure V1.0   )               It is 24-AUG-1992 at 13:16.   =               Enter a question mark (?) at any time for help.   I               %VMSINSTAL-W-NOTSYSTEM, You are not logged in to the SYSTEM                        account.  8               * Do you want to continue anyway [NO]? yesL               * Are you satisfied with the backup of your system disk [YES]?  H                                                                      A-1                    Sample Installation          A.1 Sample Installatione  7               The following products will be processed:S  "                 ALPHA_MACRO64 V1.0  D                Beginning installation of ALPHA_MACRO64 V1.0 at 13:16  D               %VMSINSTAL-I-RESTORE, Restoring product save set A ...  K                   Release notes included with this kit are always copied toe                   SYS$HELP.   3                   Additional Release Notes Options:   (                1.  Display release notes&                2.  Print release notes                3.  Both 1 and 2a$                4.  None of the above  $               * Select option [2]: 4  B               * Do you want to continue the installation [NO]? yesF               %VMSINSTAL-I-RELMOVED, Product's release notes have been                moved to SYS$HELP.  O               * Do you want to purge files replaced by this installation [YES]?O  O                 This kit contains a file summarizing the new features, changes,aI                 restrictions, and compatibility issues in this release ofeF                 MACRO-64.  This file is named MACRO64010.RELEASE_NOTES0                 and will be placed in SYS$HELP:.  K                 The release notes contains information valuable to MACRO-64 C                 users.  Please inform MACRO-64 users of this file's                  existence.  S                 This kit also contains an Installation Verification Procedure (IVP)tU                 which can be used at any time to verify the installation of MACRO-64. U                 You can invoke the IVP after installation with the following command:   +                     $ @SYS$TEST:MACRO64$IVP   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:      MACRO64 '                       Producer:     DECd'                       Version:      1.0n.                       Release Date: dd-mmm-yyy           A-2e n  o      H                                                      Sample InstallationH                                                  A.1 Sample Installation  V               * Does this product have an authorization key registered and loaded? yes  2                No further questions will be asked.>                Installation will take 2-5 minutes to complete.    H               %VMSINSTAL-I-SYSDIR, This product creates system directory$               [SYSTEST.MACRO64$IVP].O               %CREATE-I-EXISTS, VMI$COMMON:[SYSTEST.MACRO64$IVP] already exists   R               The MACRO-64 installation procedure cannot install MACRO-64 languageU               support for use with the Language Sensitive Editor (LSE) because LSE is V               not installed on your system.  If you want MACRO-64 language support for%               use with LSE, you must:   !                  1.  Install LSE.r)                  2.  Re-install MACRO-64.   H               If you do not use LSE or you do not need MACRO-64 languageI               support for LSE, there is no problem with your installations               of MACRO-64.  \               %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...  N               %MACRO64-I-SUMMARY, Completed with 0 error(s), 0 warning(s), and&               0 informational messagesT               %MACRO64$IVP-I-PASSED, MACRO-64 Assembler for OpenVMS AXP Systems V1.0               IVP has PASSEDD                Installation of ALPHA_MACRO64 V1.0 completed at 13:17  L                   Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY  2                   Creating installation data file:I                                VMI$ROOT:[SYSUPD]ALPHA_MACRO64010.VMI_DATAa  0                VMSINSTAL procedure done at 13:18                 $ logoutB                 ASM          logged out at 24-AUG-1992 13:18:21.45            H                                                                      A-3                       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 youre               system whene$               MACRO-64 is installed.  '               o  SYS$SYSTEM:MACRO64.EXE   +                  MACRO-64 executable image.i  *               o  SYS$MESSAGE:MACRO$MSG.EXE  -                  MACRO-64 assembler messages.   2               o  SYS$HELP:MACRO64010.RELEASE_NOTES  (                  MACRO-64 release notes.  )               o  SYS$TEST:MACRO64$IVP.COM   C                  MACRO-64 Installation Verification Program command                   file.  A               o  SYS$SYSROOT:[SYSTEST.MACRO64$IVP]MACRO64$IVP.M64   H                  MACRO-64 Installation Verification Program source file.  A               o  SYS$SYSROOT:[SYSTEST.MACRO64$IVP]MACRO64$IVP.OBJA  H                  MACRO-64 Installation Verification Program object file.  (               o  SYS$LIBRARY:MACRO64.MLB  5                  MACRO-64 library of supplied macros.l  /               o  SYS$EXAMPLES:MACRO64$HELLO.M64e  *                  MACRO-64 example program.  H                                                                      B-1