rDECAVMACRO64\<>MACRO-64 Assembler for OpenVMS AXP Systems Installation Guide:+MACRO64_IGBOOKBROWSER  Contents Tables*+TABLESTABLES9P1=A1-1ProcessAccountQuotasfortheAccount Installation1- 1 Process Account Quotas for the Account Installation8 / CONTENTSCONTENTS8 E[TitlePageTitle Page@E\ CopyrightPageCopyright Page1xE\PrefacePreface y&;%$L1 PreparingforMACRO-64  Installation1 Preparing for MACRO-64 Installation)>*$@1.1Required OperatingSystem& Components1.1 Required Operating System ComponentsS\##$A1.2 AssociatedSoftware1.2 Associated Softwarecl ++$A1.2.1Language-SensitiveEditor1.2.1 Language-Sensitive EditorUl$$$@1.3License Registration1.3 License Registrationb\++$@1.4VMSClusterConsiderations1.4 VMS Cluster Considerations!tl(44$@1.5 Installation Procedure Requirements1.5 Installation Procedure Requirements#bl++$@1.5.1 Privilegesand Resources1.5.1 Privileges and Resources%6M.$A1.5.1.1ChangingSystem ParameterValueswithAUTOGEN1.5.1.1 Changing System Parameter Values with AUTOGEN.^\))$@1.5.2ProcessAccountQuotas1.5.2 Process Account Quotas7]l(($A1.5.3 VMSINSTAL Requirements1.5.3 VMSINSTAL Requirements>jl"00$A1.5.4BackingUpYourSystemDisk1.5.4 Backing Up Your System DiskAOw!!$L2 InstallingMACRO-642 Installing MACRO-64Cb\++$A2.1The Installation Procedure2.1 The Installation ProcedureDIl$A2.2ErrorRecovery2.2 Error Recoveryi\w(($K3After InstallingMACRO-643 After Installing MACRO-64n?V7$@3.1Runningthe Installation Verification& Procedure Separately3.1 Running the Installation Verification Procedure Separatelyp)@/$A3.2 InstallingMACRO-64onaVMS&Cluster3.2 Installing MACRO-64 on a VMS Clusterr`l**$@3.3UserAccount Requirements3.3 User Account Requirementst*A2$@3.4 InstallingMACRO-64asaShared&Image3.4 Installing MACRO-64 as a Shared Imageusl'44$A3.5 Determiningand ReportingProblems3.5 Determining and Reporting ProblemszO!!$\AMSample InstallationA Sample Installation~Sl##$@A.1Sample InstallationA.1 Sample Installationh!//$[BMFiles InstalledonYourSystemB Files Installed on Your SystemA\$AB.1FileNamesB.1 File Names+TABLESTABLES9P1=A1-1ProcessAccountQuotasfortheAccount Installation1- 1 Process Account Quotas for the Account Installation8~*,fOYMACRO-64 AssemblerOfor OpenVMS AXPOxSystemsO InstallationGuide ONovember1992VOJThisdocumentcontains instructionsfor installingMACRO-64 AssemblerOOforOpenVMSAXPSystemsontheOpenVMSAXP operatingsystem.tJ'ORevision/Update Information:#^Thisisanewmanual. ,cOSoftwareVersion:+^MACRO-64 AssemblerforOpenVMS^AXPSystemsV1.0{*O OperatingSystemandVersion:$xOpenVMSAXPVersion1.0)O%Digital Equipment Corporation!ObMaynard, Massachusetts G! -  OONovember1992eOxThe informationinthisdocumentissubjecttochangewithoutnoticeandshould^Onotbe construedasa commitmentbyDigital Equipment Corporation.-DigitalfO Equipment CorporationassumesnoresponsibilityforanyerrorsthatmayappearinO?this document.fOThesoftware describedinthisdocumentis furnishedunderalicenseandmaybeVOusedorcopiedonlyin accordancewiththetermsofsuchlicense.lONoresponsibilityisassumedfortheuseor reliabilityofsoftwareon equipmentthataOisnotsuppliedbyDigital Equipment Corporationorits affiliated companies.iO RestrictedRights:(Use, duplication,or disclosurebytheU.S. GovernmentissubjectrOto restrictionsassetforthin subparagraph(c)(1)(ii)oftheRightsin TechnicalDataCOandComputerSoftwareclauseatDFARS 252.227-7013.3ODigital Equipment Corporation1992. OPAllRights Reserved.bOThe followingare trademarksofDigital Equipment Corporation:!AlphaAXP,AXP,[O-Digital,OpenVMS,OpenVMSAXP,PALcode,VAX,VAX DOCUMENT,VMS,andtheOpDIGITALlogo.dO The followingare third-party trademarks:*Adaisa registered trademarkofthe9OMU.S. Government,AdaJointProgramOffice.MO ThisdocumentwaspreparedusingVAX DOCUMENT,Version2.1.*  pwF6O1.1BRequired OperatingSystem ComponentsGOUTheOpenVMSAXP operatingsystemcomeswithavarietyGOofsupportoptions,orclasses..Touse MACRO-64,yourIOsystemshouldberunningaversionofOpenVMSAXPthat9O^includesatminimumthe followingclasses:vhL `OpenVMSsaveset `OOOpenVMS utilitiesNQOForacompletelistoftherequiredclasses,seetheSoftwareFOSupportAddendum(SSA),whichcomeswiththeSoftware&O5Product Description(SPD).  #O1.2B AssociatedSoftwareHOUThissections describessoftwareusedwiththeMACRO-64O assembler.(`+O1.2.1BLanguage-SensitiveEditor?O4MACRO-64doesnotrequiretheLanguage-SensitiveIOEditor(LSE)towork properly..However,ifyouplantoHOuseMACRO-64withLSE,youmustregisterandloadtheOO=licensePAKandinstalltheLSEsoftwarepriorto installing>OtheMACRO-64 Assembler.- Otherwise,theMACRO-64DO installation proceduredoesnotinstalltheMACRO-642OGlanguagetemplateforusewithLSE.j8 @POTable1-1:7ProcessAccountQuotasfortheAccount Installation O OFAccountQuotaKFMinimumValue Ob O ASTLM K 24O$ BIOLM K$ 18O BYTLMK 20,480O DIOLM K 18O ENQLM K 30O  FILLM K  20O PRCLM$K NumberrequiredbyuserO WSDEFK 300pagesminimum 1 OI  O1}mThevaluesforWSEXTandWSQUOmustbeequaltoorgreaterthantheWSDEFvalue(500-700 optimal). O L*##4O1.5B Installation Procedure RequirementsNOUThissection,andthe following,discussvarious requirements$Ofor installing MACRO-64.$pKOThe installationtakes approximately2to5minutesusing%Ocompactdisc(CD)media.%+O1.5.1B Privilegesand ResourcesGO4Before installing MACRO-64,youraccountmusthavethe8O following privilegesandsystem resources:<&!  `@SETPRV,orCMKRNL,WORLD,andSYSPRV privileges. `OGOAtleast12,000blocksoffreediskspaceduringtheK installation;ofthese,10,000blocksremaininuseafter*the installationis complete.' EWTo determinethenumberoffreediskblocksontheIcurrentsystemdisk,enterthe followingcommandattheDCLprompt:  $% SHOW%DEVICE& SYS$SYSDEVICE ` 7 Atleast512Kbytesofphysicalmemory. `QAtleast20freeglobalpageletsplusthesize(innumberof?diskblocks)oftheSYS$LIBRARY:DCLTABLES.EXEat= installation. `AAtleast2freeglobalsectionsat installation. >MBANOTE >MDYoumustensurethatyoursystemhasthe necessaryEglobalpageletsandglobalsectionSYSGENquotasforIwthe installation.(FailuretodosocouldcausetheDCLDtablestobecome corruptedinsome situations.*NoteA(that VMSINSTALturnsoffBYPASS privilegeatthe'startofthe installation. (! GOYoucanusetheWRITEcommandwiththeF$GETSYIlex-POicalfunctiontofindthenumberoffreeglobalpageletsandOO5global sections.)The followingexampleshowshowtogetthisKO informationatyourterminal(thedefaultfor SYS$OUTPUT): O $6 WRITE& SYS$OUTPUT%F$GETSYI("FREE_GBLPAGES")OZ 15848 O $6 WRITE& SYS$OUTPUT%F$GETSYI("FREE_GBLSECTS") O 24)zBOTo determinethesizeofSYS$LIBRARY:DCLTABLES.EXE,)Oenterthe followingcommand: Oa $3a directory/size&sys$library:dcltables.exe*?OThiscommanddisplaysthe following information:(O Directory%SYS$COMMON:[SYSLIB]Oq DCLTABLES.EXE;299 q 857+ Total%of%1&file,&857%blocks.+! ?ODuring and after installation,!MACRO-64 requiresIO20global pagelets.0In addition, the installationproce-ofSYS$LIBRARY:DCLTABLES.EXEis857diskblocks.'Thus,LOthetotal requirementfor installationofMACRO-64inthisLOexampleis20+857,or1057.*BecauseinthisexamplethereQOHare15,848globalpageletsfree,thereisnoneedtoincrease,Othenumberofglobal pagelets.D,HOIn addition,MACRO-64requirestwoglobalsectionsbothNOduringandafter installation.)BecauseinthisexamplethereNO5are currently24globalsectionsfree,thereisnoneedto6Oincreasethenumberofglobal sections.-wOSection1.5.1.1<[ describesthe proceduresfor increasingthese!OvaluesusingAUTOGEN.*-OF?.y. OEO1.5.1.1CChangingSystem ParameterValueswithAUTOGENEO)YoucanusetheAUTOGENcommand proceduretochangeIOsystem parametersifthenumberoffreeglobalpageletsGO (GBLPAGES)andglobalsections (GBLSECTS) determinedinO3Section1.5.1<3is insufficient.(AUTOGEN automaticallyadjustsKOvaluesfor parametersthatare associatedwiththevaluesEOyoureset manually..Tochangesystem parameterswith/O<AUTOGEN,editthe followingfile:"O SYS$SYSTEM:MODPARAMS.DAT*.O?%/ NROUseaneditortoaccessthefile.&Tochangea parametervalueVOlistedinthisfile,deletethecurrentvalue associatedwiththat1O5 parameterandenterthenewvalue.0zROToaddanew parameter,addalinetothefilethatincludesNOboththenameofthe parameteranditsvalue.&Forexample:Oa WSMAX%=&10241FOTomodify incremental parameterssuchasGBLPAGESandEO GBLSECTS,usetheADDcommand.)The followingexample:O5 increasestheglobalpagesettingby2000:O ADD_GBLPAGES%=%20002! NUONotethatwhenyousetthepagefilequota,donotuseavalueOOthatexceedstheamountofpagefilespace availableontheO5system.P3+&MOAfteryoumakeallyourchanges,exitfromtheeditorandGOexecutetheAUTOGEN procedureto recalculateyoursys-HO5tem parameters.)Enterthe followingcommandattheDCLOprompt: O $. @SYS$UPDATE:AUTOGEN%GETDATA%REBOOTs4IAOWhenyouspecifyREBOOT,AUTOGENperformsanau-JOtomaticsystemshutdownandthenrebootsthesystem.)AnyLO5usersloggedintothesystemare immediately disconnectedHOduringthe shutdown.+The automaticrebootputsthenew*O parametervaluesintoeffect.y5OEOAUTOGEN automaticallyadjustssomeoftheSYSGENpa-JOrametersbasedonthe consumptionof resourcessincetheSO5lastreboot.(Ifyoudonotwanttotake advantageofthisau-GOtomatic adjustment,includethe NOFEEDBACK qualifieron&OtheAUTOGENcommandline.6zBOFormore informationaboutusingAUTOGEN,seethe-O OpenVMSSystem ManagementSubkit .7! )O1.5.2BProcessAccountQuotasIO4TheaccountyouusetoinstallMACRO-64musthavesuf-ROficientquotastoenableyoutoperformthe installation.(SincePO VMSINSTALverifiesthesequotas,itisnot necessarythatyouAO=verifythesequotaspriorto installing MACRO-64.~=Table1-1LO summarizestheprocessquotasrequiredforthe installationOaccount.*7~a?89! MOUseraccountquotasarestoredinthefile SYSUAF.DAT.YouFOcanusetheOpenVMSAXP AuthorizeUtility (AUTHORIZE)TO<toverifyandchangeuseraccountquotas.(Todothis,firstsetEOyour directoryto SYS$SYSTEMandthenrun AUTHORIZE: O $" SET%DEFAULT& SYS$SYSTEM Oa $a RUN% AUTHORIZEO UAF>:zEOAttheUAF>prompt,entertheSHOWcommandwithanJOaccountnametochecka particularaccount.'Forexample:Oa UAF> a SHOW%SMITH<;HOTochangeaquota,entertheMODIFYcommand.)Thefol-FOlowingexamplechangestheFILLMquotafortheSMITH8O5accountandthenexitsfromtheutility:O UAF>"  MODIFY%SMITH% /FILLM=50O UAF>  EXITA<POAfteryouexitfromtheutility,thesystemdisplaysmessagesGO indicatingwhetherornotchangesweremade.,OncetheNO5changeshavebeenmade,youmustlogoutandloginagain2Oforthenewquotastotakeeffect.=N>OFor more information on! modifying account quo-KOtas, seethe descriptionofthe AuthorizeUtilityinthe-O5 OpenVMSSystem ManagementSubkit 5.>Ml(O1.5.3B VMSINSTAL RequirementsDO4Whenyouinvoke VMSINSTAL,itchecksthe following:? `HWhetheryouhavesetyourdefaultdeviceand directory(to SYS$UPDATE `CWhetheryouareloggedintoa privilegedaccount `'F'Whetheryouhaveadequatequotasfor installation,asshownin2Table1-1 `&WhetherDECnetisrunning `~?~Whetheranyusersareloggedintothesystem*?2Ca?8@ WKOIf VMSINSTALdetectsanyproblemsduringthe installation,SOitnotifiesyouandasksifyouwanttocontinuethe installa-NO5tion.*Insome instances,youcanenterYESto continue.*ToPOstopthe installationprocessandcorrectthe situation,enterKONOorpressReturn.)ThencorrecttheproblemandrestartO>the installation.@A0O1.5.4BBackingUpYourSystemDiskNO4Atthe beginningofthe installation, VMSINSTALasksifyouJOhavebackedupyoursystemdisk.)Digital recommendsthatNOyoudoasystemdiskbackupbefore installingany software./BBOUse the backup procedures!that are established atDOyour site.2For details on performinga system diskGO5backup,seethesectionontheBACKUPUtilityinthe-O OpenVMSSystem ManagementSubkit .BC ["O 2.2 Installing!MACRO-64>OThischapterexplainshowtoinstall MACRO-64.ZSection2.1OOcontainsa step-by-step descriptionofthe installationproce-OBdure.*CZT|?Di DO2.2BErrorRecoveryMOUIferrorsoccurduringthe installationitselforwhentheDO Installation Verification Procedure(IVP)isrunning,HO VMSINSTALdisplaysfailure messages.+Ifthe installation4O^fails,youseethe followingmessage:PO %VMSINSTAL-E-INSFAIL,%The& installation%of%MACRO-64% Assembler%for3t+ OpenVMS%AXP%Systems%V1.0&has%failed.j iGOIftheIVPfails,the followingmessageis displayed:WO MACRO64$IVP-F-FAILURE,&MACRO-64& Assembler%for%OpenVMS%AXP%Systems%V1.0tP IVP&has%failed.k sROErrorscanoccurduringthe installationifanyofthefollow-!Oing conditionsexist:l  `9The operatingsystemversionis incorrect. `OIOQuotas necessaryfor successful installationareinsuffi-cient. `'G'System parametervaluesfor successful installationare insufficient. `>TheOpenVMSHelpLibraryis currentlyinuse. `~I~Theproductlicensehasnotbeen registeredandloaded. `ITheLanguage-SensitiveEditor(LSE)isnot installed.(IfMVyouchoosetouseLSE,itmustbe installedpriortoin-Kstalling MACRO-64.'IfyoudonotintendtouseLSE,you%mayignorethismessage. m WKOFor descriptionsoftheerrormessages generatedbytheseO conditions,seethe3 OpenVMSSystemsMessagesandRecovery'O5 Procedures ReferenceManual2y5.'IfyouarenotifiedthatanyofPOthese conditionsexist,youshouldtakethe appropriateactionNOas describedinthemessage.)For informationon installationO> requirements,see>Chapter1\>ofthismanual.*mlOn)O 3.2After! Installing!MACRO-64FOThe followingtaskscanbe performedafter installingO MACRO-64:.o `DRunningthe Installation Verification Proceduresepa-(rately. `<MakingtheproductusableonaVMScluster. `')'Settinguseraccountquotas. ` Reporting problems.p UBO3.1BRunningthe Installation Verification Procedure( SeparatelyNOYouusuallyrunthe Installation Verification Procedure(IVP)QOduring installation.(IfyouwanttoruntheIVP separatelytoPO^ensurethe integrityof installedfilesshouldsystemproblems>Ooccur,executethe followingcommand procedure: O< $#< @SYS$TEST:MACRO64$IVP.COMq NOIftheIVPruns successfully,the followingmessagewillbeO displayed:WOa %MACRO64$IVP-I-PASSED,&MACRO-64& Assembler%for%OpenVMS%AXP%Systems%V1.0t IVP&has%PASSED.@ r8O3.2B InstallingMACRO-64onaVMSClusterBOUAfter installingMACRO-64using VMSINSTAL,youcanLOtheninstallitoneachnodeofthecluster..PerformtheO followingsteps.s J`1.:Addthe privilegesOPERandCMKRNLforyourprocess.)(Enterthe followingcommand:  $. SET%PROCESS/PRIVILEGE=(OPER,CMKRNL)H`-2.:InvoketheSystem ManagementUtility.+Settheenvi-Hronmenttotheentireclusterandallow10secondsorHlongerforthecommandtoexecute.)Enterthe following6 commands:  $ MCR%SYSMAN SYSMAN>" SET%ENVIRONMENT/CLUSTERK SYSMAN> K SET%TIMEOUT&00:00:10Q`3.:ReplacetheDCLtableswiththenewcopyonallnodesin8#thecluster.'Enterthe followingcommand: SYSMAN>9 DO&INSTALL%REPLACE%SYS$LIBRARY:DCLTABLES.EXE /OPEN/HEADER/SHAREK`o4.:ExitfromtheSystem ManagementUtilityandresetthe@process privileges.'Enterthe following commands:L SYSMAN>L EXIT  $2 SET%#PROCESS/PRIVILEGE=(NOOPER,NOCMKRNL)fLt w"*O3.3BUserAccount RequirementsLOUTousethe MACRO-64,eachaccountmusthaveatleastthe=OTMPMBXandNETMBX privileges.+UsetheOpenVMSKOAXP AuthorizeUtilityto determinewhetherusershavethe$O^ privilegestheyrequire. ~u T9O3.4B InstallingMACRO-64asaSharedImageKOUIfMACRO-64willbeused extensivelyonyoursystem,youFOcanreducesystemoverheadandmemory requirementsbyPO installingitasasharedimage.*IfyouwanttoperformtheNO^ installationonasystemthatis currentlyrunning,usetheLOOpenVMSAXPInstallUtilitywhileyouareloggedintoa INSTALL%ADD&SYS$SYSTEM:MACRO64.EXE%/OPEN%/SHARED*w?%x HWIfyouwishtoinstallMACRO-64asasharedimageonLeachnodeofaVMScluster,youneedtoperformsteps3<through6.'Ifnot,thenproceedtostep7.J`3.:Addthe privilegesOPERandCMKRNLforyourprocess.)Enterthe followingcommand: e $.e SET%PROCESS/PRIVILEGE=(OPER,CMKRNL)H`4.:InvoketheSystem ManagementUtility.+Settheenvi-H=ronmenttotheentireclusterandallow10secondsorHlongerforthecommandtoexecute.)Enterthe following commands: s $s MCR%SYSMAN SYSMAN>" SET%ENVIRONMENT/CLUSTER SYSMAN>  SET%TIMEOUT&00:00:10N`5.:InstallMACRO-64onallnodesinthecluster.(Enterthe followingcommand:_ SYSMAN>2_ DO&INSTALL%ADD&SYS$SYSTEM:MACRO64.EXE /OPEN/HEADER/SHAREDK`'6.:ExitfromtheSystem ManagementUtilityandresetthe@process privileges.'Enterthe following commands: SYSMAN> EXIT L $2L SET%#PROCESS/PRIVILEGE=(NOOPER,NOCMKRNL)I`7.:Updatethesystemstart-upfiletoinstall MACRO-64.ty JIWToinsurethatMACRO-64is installedasasharedimageKeachtimethesystemis bootstrapped,includethefollow-Linglinesinthe site-specificstart-upfilefoundinthe!a SYS$MANAGER directory.  $> INSTALL%ADD&SYS$SYSTEM:MACRO64.EXE%/OPEN%/SHARED[z w14O3.5B Determiningand ReportingProblemsIOUIfyou encounteraproblemwhileusing MACRO-64,reportROittoDigital.' DependingonthenatureoftheproblemandthePOtypeofsupportyouhave,youcantakeoneofthe followingO^actions:\{! 2 `IIfyoursoftwarecontractorwarranty agreemententitles6(youto telephonesupport,callDigital. `:SubmitaSoftware PerformanceReport(SPR). `'G'IftheproblemhastodowithMACRO-64documentation,IfilloutandsubmitaReader'sCommentsform.)ThereisFaReader'sCommentformatthebackofeachmanual.G1Usetheformfromthemanualinwhichyoufoundthe;error.&Includethesectionandpagenumber.| WAOReviewtheSoftwareProduct Description(SPD)andJOWarrantyAddendumforan explanationof warranty.(IfyouLO5 encounteraproblemduringthewarrantyperiod,reporttheMOproblemas previously indicatedorfollow alternateinstruc-KOtionsprovidedbyDigitalfor reportingSPDnonconformanceO> problems.}mJOSeeMACRO-64Version1.0coverletterfor informationon#OhowtosubmitanSPR.~e"O A.!Sample! InstallationJOThisappendixcontainsasample installationof MACRO-64.MOThissamplewasrunonasystemthathadapreviousver-IOBsionofMACRO-64 installed.+ DependingontheversionofFOOpenVMSAXPyouareusingandwhichlayeredproductsMOyouhaveonyoursystem,youmightsee additionalmessagesAOLand questionswhenyouperformyour installation.]33OThesample installationassumesthat:. `'DECnethasbeenshutdown `O6ONousersareloggedintoyoursystem `#OPTIONSNis specified `NFNThe installationisnotdonefromtheSYSTEMaccount `IThe Installation Verification Procedure(IVP)isexecuted-&attheendofthe installation `BThelogicalname, MACRO64_KIT,isassignedtotheDdeviceandthe directoryofthe installationmedia./ @#OA.1CSample InstallationFOUThisasamplelogfilefromaMACRO-64 installation.NO $&@sys$update:vmsinstal%alpha_macro64010& macro64_kit:%options&NHtC OpenVMS%AXP%Software%Product% Installation% Procedure&V1.0)O It%is% 24-AUG-1992%at%13:16.BO6 Enter%a&question&mark%(?)&at&any%time&for%help.MO %VMSINSTAL-W-NOTSYSTEM,%You%are&not%logged%in%to%the&SYSTEMz account. -ADOBE-Courier-Bold-R-Normal--*-120-*-*-M-*-ISO8859-1M -ADOBE-New Century Schoolbook-Bold-R-Normal--*-120-*-*-P-*-ISO8859-1O-ADOBE-New Century Schoolbook-Medium-R-Normal--*-100-*-*-P-*-ISO8859-1@  % ! DOPreface"OPurposeofThisGuideLOyThisguide describeshowtoinstalltheMACRO-64 AssemblerDOforOpenVMSAXPSystemsonAXP processorsthatare8O+runningtheOpenVMSAXP operatingsystem. NIOKeepthisdocumentwithyour distributionkit..YouwillMOneedittoinstall maintenanceupdatesorto reinstallthe,O5MACRO-64foranyotherreason.f L<MOAtthebackofthisdocumentisaReader'sCommentsform.NOIfyouhaveanycommentsaboutthis document,fillouttheNO5formandmailit;yourcommentswillbe consideredforthe7Onextrevisionofthe installationguide.O3IntendedAudience YHOATheaudienceforthisguideisthesystemmanagerwho,OinstallstheMACRO-64 software.O@Document Structure\ Z22OAThisguideis organizedasfollows: `Chapter1:Z describesthe operatingsystemandhardware=( requirementsfortheMACRO-64 installationandFrelated proceduresthatyoucompletebefore installingthe MACRO-64. `YYChapter2>YY describesthe step-by-step instructionsforthe installation. `11Chapter3=Z1 describesactionsandconsiderationsafterthe installation. `  AppendixA8 containssamplelistingsfortheMACRO-64a installation. `AppendixB4 describesfilesusedbythe MACRO-64.O Associated Documents*mO*mOC*mOn*O~*O `9 MACRO-64 AssemblerforOpenVMSAXPSystems( ReferenceManual `9 MACRO-64 AssemblerforOpenVMSAXPSystems ReleaseNotes `5 AlphaAXP Architecture ReferenceManual `, AlphaAXP ArchitectureHandbook `~;~ AlphaAXP ArchitectureQuick ReferenceGuide `$ OpenVMSCallingStandard `}7} OpenVMSLicense ManagementUtilityManual `- OpenVMSSystem ManagementSubkit `{>{ OpenVMSSystemMessagesandRecovery Procedures ReferenceManualOz ConventionslZBBOAThe following conventionsareusedinthisguide:*! [O UPPERCASETEXT1b Uppercasetext indicatesacommand,6b0 thenameofaroutine,thenameofa6b~ file,orthe abbreviationforasystemb privilege. OE $E @SYS$UPDATE:VMSINSTAL1bE In interactive examples,userinput*b isprintedinboldfacetext. O  $3b  Thedollarsignisusedtoindicate.bZ theDCLprompt.#Thispromptmay*b be differentonyoursystem. O! . On . O ./b! Averticalellipsis indicatesthe1bn omissionofitemsfromacodeex-*b ampleorcommandformat;the1b  itemsareomittedbecausetheyare/bW not importanttothetopicbeingb discussed.O file-spec, .../b A horizontalellipsisinexamples4bl indicatesoneofthe followingpossi-b bilities: r>)> Additionaloptional arguments- ina statementhavebeenomit- ted. rX.X The precedingitemoritemscan- berepeatedoneormoretimes. r% *% Additional parameters,values,)s orother informationcanbe entered.Oq [logical-name]/bq Squarebracketsindicatethatthe0b encloseditemis optional.%(Square1b bracketsarenot,however,optional5bZ inthesyntaxofa directorynamein5b afile specificationorinthesyntax1b ofa substring specificationinan!bB assignment statement.)!O VMS,OpenVMS,OpenVMS O AXP)b ThetermsVMS,OpenVMS,and,b OpenVMSAXPrefertothesamebW operatingsystem.O MACRO-64&b MACRO-64referstoMACRO-*b 64 AssemblerforOpenVMSAXPbl Systems.  4O 1.2 Preparing!for"MACRO-64! InstallationHOThischapter discussesthe preparationsand requirements4O necessaryfor installingthe MACRO-64.NIOThismanualappliestoVersion1.0oftheMACRO-64andJOall subsequent maintenancereleasesuptothenextmajorO5productrelease.wMGOYourbillof materials(BOM) specifiesthenumberandMOcontentsofyourmedia.-BesuretoverifythecontentsofMO5yourkitwiththis information.-IfyourkitisdamagedorSOifyoufindthatpartsofitaremissing,contactyourDigitalOrepresentative.E! HOMACRO-64providesonlinereleasenotes.+DigitalstronglyBO recommends that!you read the!release!notes beforeOO5 proceedingwiththe installation.'For informationon accessing+Otheonlinereleasenotes,see;Section2.1.*;P|?DB  9! $O1.3BLicense RegistrationKOUYoumustregisterandloadyourlicensefortheMACRO-64O beforeN2youstartthe installationinordertorunthe InstallationBO Verification Procedure(IVP)andusethe software. NQOToregisteralicenseunderOpenVMSAXP,firstlogintotheJOsystem manager'saccount,SYSTEM.Youthenhaveachoice8O5oftwowaystoperformthe registration: j `0Invoke the SYS$UPDATE:VMSLICENSE.COMH. procedure.'Whenitpromptsyoufor information,respond/withdatafromyourLicensePAK. `>AttheDCLprompt,entertheLICENSEREGISTERG^commandwiththe appropriate qualifiersthat correspond(toLicensePAK information. WLOIfyouplantouseMACRO-64onmorethanonenodeinaPOVMScluster,youwillneedtoperformalicenseloadontheLO5othernodesafteryoucompletethis installation.+FormoreKO informationonhowtoinstallMACRO-64onaVMScluster, OseeSection3.2.*{?r ?OForcomplete informationonusingLMF,seetheG OpenVMS.O License ManagementUtilityManual g. !+O1.4BVMSClusterConsiderationsHOUToinstallMACRO-64oneachnodeofthecluster,yourEOaccountmusthavethe following privileges:-OPERandOCMKRNL"zGOFormore informationonhowtoinstallMACRO-64onaOVMScluster,seeSection3.2.*"{?r49&D+O2.1BThe Installation ProcedureDOUMACRO-64 installation procedureconsistsofaseriesGOof sequential questionsand informational messages.-SeeOAppendixA'forasample installation.*DOO~EtNOIfitisnotalready inserted,placethecompactdisk(CD)&OmediaintotheCDdrive.GFQOToabortthe installation procedureatanytime,pressCtrl/Y.OOWhenyoupressCtrl/Y,the installation proceduredeletesallSO5filesithascreateduptothatpointandexits.*Youcanthen*Ostartthe installationagain.JG  `1.:Invoke VMSINSTAL.uHWKCW VMSINSTALisinthe SYS$UPDATE directory.(TostartCthe installation,invokethe VMSINSTALcommandpro-Fcedurefroma privilegedaccount,suchastheSYSTEM1aaccountusingthe followingsyntax::@SYS$UPDATE:VMSINSTAL saveset-name device-nameO>OPTIONSNI' bJWThe followinglistdefinestheelementsofthe VMSINSTALcommandline:J!  saveset-nameJ#The installationnameforthe component.'FortheVersionF|1.0of MACRO-64,usethe following installationname: ALPHA_MACRO640105K z JWNotethethreedigitversionattheendofthesavesetJname(010).(Forupdated versions,adjusttheversionac-C cordingly.*Forexample,toinstallMACRO-64Version4a1.1,youwouldenterALPHA_MACRO64011.L  device-nameE(ThenameofthedeviceonwhichyouplantomountEthemedia.+Forexample,DUB1:+isadevicenameforNadrive.*Itisnot necessarytousetheconsoledriveforO2this installation.(However,ifyoudousetheconsoledrive,Cyoushouldreplaceanymediayouremovedoncethe% installationis complete.MgOPTIONSNF(Anoptional parameterthat indicatesyouwanttoseeLthequestiononreleasenotes.*Ifyoudonotincludethe@OPTIONSN parameter, VMSINSTALdoesnotaskyouH2aboutthereleasenotes.+YoushouldreviewthereleaseMnotesbefore proceedingwiththe installation,incasetheyEcontain additional informationaboutthe installation.I<Ifyouare restartingthe installationandhavealreadyIreviewedthereleasenotes,youdonotneedtospecifyOPTIONSN.NrKWNotethatthereareseveralotheroptionsyoucanselect'whenyouinvoke VMSINSTAL.8O FY Auto_answeroption(A): Initiallycreatesafilethat;Y(containsyouranswersto VMSINSTAL questionsDYandprompts.*Youcanthenusetheoption(andtheBYanswerfile)tosavetimeduringareinstallation6Y2 (typicallyafter upgradingyoursystem). GYGetsavesetoption(G):LetsyoustoreproductsaveCY sets temporarilyonamagnetictapeorinadiskYc directory. IYFilelogoption(L):LogsallactivitytotheterminalY:during installation. GY Alternaterootoption(R):Letsyouinstalltheprod-GYucttoasystemroototherthanthatoftherunningYksystem.bP8HWIfyouspecifymorethanoneoption,separatetheop-Ationswithcommas(OPTIONSA,N).SeetheOpenVMSAAXP documentationonsoftware installationinthe-a OpenVMSSystem ManagementSubkit_afordetailed* informationontheseoptions. Q{ BWThe followingexampleinvokes VMSINSTALtoinstall?MACRO-64fromdriveDUB1:*andshowsthesystemB response.,ThisexampleusestheOPTIONSNreleaseanote parameter.  $D @SYS$UPDATE:VMSINSTAL%ALPHA_MACRO64010&DUB1:&OPTIONS%NHv OpenVMS%AXP&Software&Product% Installation& Procedure%V1.0)M It%is% 12-OCT-1992%at%14:10.B Enter%a&question&mark%(?)&at&any%time&for%help.@R /GWIfyoudonotsupplyeithertheproductnameortheCdevicename, VMSINSTALpromptsyouforthisinfor-Emationlaterinthe installation procedure.( VMSINSTALKadoesnotpromptyouforanyoptions,sobesuretoin-BcludeOPTIONSNonthe VMSINSTALcommandlinetoAaccessthereleasenotesduringthe installation.&`2.:Confirmsystembackup.S *&Are%you% satisfied&with%the&backup%of%your&system%disk&[YES]?SV pF VMSINSTALasksifyouare satisfiedwithyoursystemIbackup.'Youshouldalwaysbackupyoursystemdiskbe-L5fore performingan installation.)Ifyouare satisfiedwithJthebackupofyoursystemdisk,pressReturn.' Otherwise,JenterNOto discontinuethe installation.)AfteryoubackH>upyoursystemdisk,youcanrestartthe installation. `3.:Mountthemedia.EB Please%mount%the&first&volume%of%the%set&on&DUB1:. *&Are%you%ready? O YES1 %MOUNT-I-MOUNTED,%CONDIST&MOUNTED%ON _$$DUB1:J(NODE%1)8b The% following&products&will%be% processed: ALPHA_MACRO64%V1.0Ei: Beginning& installation%of% ALPHA_MACRO64&V1.0%at%14:15B %VMSINSTAL-I-RESTORE,% Restoring&product%saveset%A...TWFWhenyoureceivetheprompttomountthefirstvol-Gumeofthesaveset,youshouldmountthe distributionE5volumeonthedeviceyou specifiedwhenyouinvokedE VMSINSTAL.Thedevicenameappearsinthelinepre-Ecedingthe question.* VMSINSTALthenasksifyouare7>readytocontinuewiththe installation..UzEWIfyourespondYEStoindicatethatyouareready,A VMSINSTALdisplaysamessagethatthemediacon-CtainingMACRO-64hasbeenmountedonthe specified;adeviceandthatthe installationhasbegun.VV NHWIfyouenteredthewrongdevicenamewhenyouinvokedD VMSINSTALandneedtorestartthe installation,en-MterNOinresponsetothe``Areyouready?''( question.(ToHaabortthe installationforotherreasons,pressCtrl/Y.0`4.:Selectareleasenotesoption.Le Release&notes&included&with%this%kit%are&always%copied%to SYS$HELP..= Additional&Release%Notes%Options:% 1.KDisplay%release%notes# 2.KPrint&release%notes] 3.KBoth%1%and%2" 4.KNone%of%the&above!5 *&Select%option%[2]:W!HWIfyouselectoption1, VMSINSTALdisplaysthereleaseCnotes immediatelyontheconsole terminal..YoucanG terminatethedisplayatanytimebypressingCtrl/C.XNHWIfyouselectoption2, VMSINSTALpromptsyouforthe&nameoftheprintqueue:&5 *&Queue&name% [SYS$PRINT]:Y! PWYoucanpressReturntosendthefiletothedefaultoutputCprintdeviceoryoucanenteranotherqueuename.Z !DWIfyouselectoption3, VMSINSTALdisplaysthere-Jleasenotes immediatelyontheconsoleterminalandthenHpromptsyouforaqueuenamefortheprintedversion.[!HWIfyouselectoption4, VMSINSTALdoesnotdisplayorDprintthereleasenotes.*Notethat VMSINSTALalwaysHcopiesthereleasenotestothesystemhelp directory.0\ ?WNext, VMSINSTALdisplaysthe following question:B *&Do&you%want&to&continue&the% installation%[N]?:  YESL$ %VMSINSTAL-I-RELMOVED,&The% product's%release%notes%have&been,l successfully%moved%to% SYS$HELP.]JTocontinuethe installation,enterYES. Otherwise,pressMReturn.)Ineithercase,thereleasenotesarecopiedtoa-5fileintheSYS$HELP directory:+ !SYS$HELP:MACRO64010.RELEASE_NOTES^{ 2aJWAfterthe installation,youcanenterthe followingcom-Nmandtolocatethereleasenotesthroughthehelp facility: 5 $*5 HELP% MACRO/ALPHA% RELEASE_NOTES _UNote _A>Thenameofthereleasenotesfile installedby> VMSINSTALconsistsofthecurrentproductnameEandversionnumber.*Donotdeletereleasenotesfor+Hpreviousversionsof MACRO-64. `L5.:Purgefiles.N *&Do&you%want&to&purge&files&replaced&by&this% installation [YES]? _{ [LYouhavetheoptiontopurgefilesfrompreviousversionsFofMACRO-64thatare supersededbythis installation.F5Purgingis recommended;however,ifyouneedtokeepKfilesfromthepreviousversion,enterNOinresponsetothe question.G`e6.:Choosethe Installation Verification Procedure(IVP)option.OB *&Do&you%want&to&run%the%IVP&after&the% installation%[YES]?`IThe installation procedurenowasksifyouwanttorunHtheIVP.TheIVPforMACRO-64checkstobesurethatL5the installationis successful.(Itis recommendedthatyouruntheIVP.ha .>IWAfterMACRO-64is installed,youcanruntheIVPinde-M pendentlytoverifythatthesoftwareis availableonyourHsystem.*YoumightneedtoruntheIVPafterasystemFafailuretomakesurethatuserscanaccess MACRO-64.:`7.:Respondtolicense registrationqueries.e Product:e MACRO64 Producer:DEC Version: V1.0%= Release&Date:K dd-mmm-yyyyO *&Does%this%product&have%an% authorization%key% registered%and loaded?bNFThe installation proceduredisplayslicense informationJaboutyourproductandthenasksifyouhave registered@5andloadedyourProduct AuthorizationKey(PAK).c! RLWIfyouhavenot registeredandloadedyourPAK,youmustManswerNOtothis question.'YouhavetoregisterandloadLyourPAKto successfullycompletethe installation.'IfyouOahavenotdoneso,youshouldstopthe installation,registerGandloadyourPAK,andthenrestartthe installation.,`98.:Read informational messages.d{ KWAtthispoint,the installation proceduredisplaysanum-Kberof informationalmessagesthatreportontheprogressNofthe installation.)Therearenofurther questions.(IftheNa installation procedurehasbeen successfuluptothispoint,D VMSINSTALmovesthenewormodifiedfilestotheirMtarget directories,updateshelpfiles,andupdatesDCLta-Okbles,if necessary.)Ifyouchosetohavefilespurged,thatIworkisdonenow.'The followingmessagesare displayed:2H No%further& questions%will&be&asked.? Installation%will%take&2-5%minutes&to& complete.Ih %VMSINSTAL-I-SYSDIR,%This&product%creates%system% directory  [SYSTEST.MACRO64$IVP].I: %VMSINSTAL-I-MOVEFILES,%files%will&now%be%moved%to%their  target&directories...I`9.:Observethe Installation Verification Procedure(IVP).e; GWIfyouchosetoruntheIVP, VMSINSTALrunsitnow.HIftheIVPruns successfully,the followingmessageis displayed:W %MACRO64$IVP-I-PASSED,&MACRO-64& Assembler%for%OpenVMS%AXP%Systems%V1.0 IVP%has&PASSED.1`T10.Endthe installation procedure.HD Installation%of%ALPHA_MACRO64010%V1.0& completed%at%14:21/Di VMSINSTAL% procedure&done%at%14:22f! nLWThepreviousmessagesindicatethattheentire installation" procedureis complete.g=@WYoucannowlogoutofthe privilegedaccount: $ LOGOUT;$ SYSTEMlogged%out%at% 12-OCT-1992% 14:25:12.01{h! QGWNotethat VMSINSTALdeletesorchangesentriesintheIprocesssymboltablesduringthe installation.* Therefore,Eifyouaregoingtocontinueusingthesystemman-Laager'saccountandyouwanttorestorethesesymbols,you0shouldlogoutandloginagain.I&:Jb"S\ ~  ^@hRjBmJ L*'ZBn&49(,.-$/@1\f2 8R;h=/EBAF