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
