z0},VDE VDE Installation and New Features GuideكVDE_IG_NAME ) Contents  Tables .Index@#B*.DECdocument V3.2n/ gCONTENTSCONTENTS8 E\TitlePageTitle Page@E\ CopyrightPageCopyright Page 1xE\PrefacePreface pw%33$K1 PreparingfortheVDE Installation1 Preparing for the VDE Installationw)> $K1.11&KRequired OperatingSystem Components1.1 Required Operating System Components{w'< $K1.2/&K PrerequisiteandOptionalHardware1.2 Prerequisite and Optional Hardware{w'< $L1.3/&L PrerequisiteandOptionalSoftware1.3 Prerequisite and Optional Softwarefl!--$A1.3.1PCSISoftware Registration1.3.1 PCSI Software Registration hl"..$A1.3.1.1Product RegistrationKits1.3.1.1 Product Registration Kits#^g(($A1.3.1.2PCSI$REGISTER_PRODUCT1.3.1.2 PCSI$REGISTER_PRODUCT'~w(> $K1.41&KUpgradesfromPreviousVDEVersions1.4 Upgrades from Previous VDE Versions,]w, $K1.5&KLicense Registration1.5 License Registration-g+? $K1.62&K VMScluster InstallationConsiderations1.6 VMScluster Installation Considerations.|w(< $K1.7/&K Installation Procedure Requirements1.7 Installation Procedure Requirements0el --$@1.7.1 PrivilegesandDiskSpace1.7.1 Privileges and Disk Space3Sl##$A1.7.2System Parameters1.7.2 System Parameters8l6EE$A1.7.2.1ChangingSystem ParameterValueswithAUTOGEN1.7.2.1 Changing System Parameter Values with AUTOGEN:l0>>$A1.7.2.2SettingDynamicSystem ParameterValues1.7.2.2 Setting Dynamic System Parameter ValuesCml$11$@1.7.3ProcessQuotasand Privileges1.7.3 Process Quotas and PrivilegesDjl"00$@1.7.4BackingUpYourSystemDisk1.7.4 Backing Up Your System DiskJw-::$K2 InstallingOpenVMS Development Environment2 Installing OpenVMS Development EnvironmentLew1 $L2.1$&LThePCSI SequentialKit2.1 The PCSI Sequential KitMjg3 $K2.2&&KThe Installation Procedure2.2 The Installation ProcedureO{w'< $K2.3/&K InstallingtheOnline Documenation2.3 Installing the Online DocumenationV3I4$K3After InstallingOpenVMS Development  Environment3 After Installing OpenVMS Development EnvironmentZ?^ $K3.1=&KRunningthe Installation Verification Procedure& Separately3.1 Running the Installation Verification Procedure Separately\gw2 $K3.2%&KEditingtheSystemFiles3.2 Editing the System Files]^w- $L3.3 &L TailoringTheSystem3.3 Tailoring The System_gg1 $K3.4$&K VMSclusterConsiderations3.4 VMScluster Considerationsbhw2 $L3.5%&LUserAccount Requirements3.5 User Account RequirementsdDl$A3.5.1 Privileges3.5.1 PrivilegeseX\&&$A3.5.2UserAccountQuotas3.5.2 User Account Quotasgkw4 $K3.6'&KAddingVMS_MENUtoSYLOGIN3.6 Adding VMS_MENU to SYLOGINjcw0 $K3.7#&K UploadingCMSintoVDE3.7 Uploading CMS into VDEl{w'< $K3.8/&K Determiningand ReportingProblems3.8 Determining and Reporting Problemsm|g(< $L3.9/&L Installation Verification Procedure3.9 Installation Verification ProcedurenIx" $\A\NewFeaturesA New Featureso[+ $\B \Example InstallationsB Example Installationszfw1 $KB.1$&KExampleVDE InstallationB.1 Example VDE Installation{lw 4 $KB.2'&KExampleVDEDOC InstallationB.2 Example VDEDOC Installation|+gTABLESTABLEStl(44=A1-1 PrerequisiteandOptionalSoftware1- 1 Prerequisite and Optional Software]l((=A1-2DiskSpace Requirements1- 2 Disk Space Requirements6]l((=A3-1RequiredMinimumQuotas3- 1 Required Minimum Quotashil"//=AA-1VDENewandChangedFeaturesA- 1 VDE New and Changed Featuresp nD$* Copyright December1997 ~AllRights Reserved.uK O]VDE%OVDE Installationand NewOfFeaturesGuideODecember1997WOJThisisthe installationguideandthenewfeaturesmanualfortheNOOpenVMS Development Environment(VDE)sourcecodecontroland)Osourcecodebuilderpackage.y'ORevision/Update Information:,^Thismanual supersedestheVDE2^ InstallationandNewFeaturesGuide,^`Version1.4-n.c9OSoftwareVersion:^VDEVersion1.5-0,o%O OperatingSystemVersion:&^OpenVMSAlphaVersion6.2$^OpenVMSVAXVersion6.2**t J)ODigital Equipment Corporation!OuMaynard, Massachusetts  !  O OO December1997 O$O Copyright December1997aOThe followingare trademarksofDigital Equipment Corporation:) Bookreader,DECYONotes, DECdirect,Digital,OpenVMS,OpenVMSCluster,VAX,VAX Document,5O VMScluster,VMS,andtheDIGITALlogo.7OThe followingare third-party trademarks:\OSMotif,OSF,OSF/1, OSF/Motif,andOpenSoftware Foundationare registered@O trademarksoftheOpenSoftware Foundation,Inc.dO0UNIXisa registered trademarkofUnixSystem Laboratories,Inc.)a wholly-owned'Os subsidiaryofNovell,Inc.dOXWindowSystemisa registered trademarkoftheMass.& Instituteof TechnologyhOAllother trademarksand registered trademarksarethepropertyoftheir respectiveOholders.%ZK????* U  ; OPreface   OIntendedAudienceNOUThismanualisintendedforuserswhowanttoknowhowto5OinstallOpenVMS Development Environment. tO Associated Documents `UUGuidetoUsingVDE ` VDE ReferenceManual kO ConventionsGOUInthismanual,everyuseofOpenVMSAlphameanstheEOOpenVMSAlpha operatingsystem,everyuseofOpenVMSGOVAXmeanstheOpenVMSVAX operatingsystem,andeveryGO^useofOpenVMSmeansboththeOpenVMSAlpha operatingK PF1,thenpressandreleaseanotherkeyora#K pointingdevicebutton.OZ GOLD %Z x%KZ AsequencesuchasGOLD Z xZ indicatesthat9K youmustfirstpressandreleasethekeyK6 thesyntaxofa substring specificationinan!K assignment statement.)O {}8K Informat descriptions,bracessurrounda;KK requiredchoiceofoptions;youmustchoose(K oneoftheoptionslisted.O boldfacetext>K Boldfacetext representsthe introductionofa9K` newtermorthenameofan argument,an$K attribute,orareason.?K' Boldfacetextisalsousedtoshowuserinput4Kt in Bookreaderversionsofthemanual.O italictext5K Italictext emphasizes importantinfor-8K< mation, indicates variables,and indicatesKt indicatestherightmousebutton.!(Thebuttons-K canbe redefinedbytheuser.)RO; PB1,PB2,PB3,PB4PB1,PB2,PB3,andPB4indicatebuttonsonK thepuck.O SB,SB:K SBandSBindicatebuttonsonthestylus.!6O1.1BRequired OperatingSystem ComponentsFOUTheOpenVMS operatingsystemcomeswithavarietyofQOsupportoptions,or tailoringclasses.( TailoringclassesincludeHOsuchfeaturesas networkingandRMS journaling.*TouseJO^VDE,yoursystemshouldberunningaversionofOpenVMS;Othatincludesatleastthe followingclass:C `mmBASE  forusewithDECCMSVersion3.7orgreater. O 4O1.2B PrerequisiteandOptionalHardwareOUVDEdoes U not:LUrequireany particularhardwareforproductO installation.wV4O1.3B PrerequisiteandOptionalSoftwareOUTable1-17Uprovides informationonthesoftwareyouU mustOOhave installedonyoursystempriortoVDE installation.(TheMOtablealsoincludes informationaboutoptionalsoftwarethat-O^youcanusetogetherwithVDE.*Oc? _UNote _=Some prerequisiteproductsmayhave additionalEv requirements.&Forexample,anewerversionofOracle?Rdb7isrequiredforuseonOpenVMSAlphaV7.  n .C'Pleaseconsultthe appropriate operatingsystemandBlayeredproduct documentationformore information. .OAll prerequisitelayeredproducts mustbe installedr prior 8toOOtheVDE installation.) InstallationofVDEdoesnotrequireaOisystemreboot. 5*Caution 65ErIfanyupdatesaremadetoanyofthe prerequisiteHsoftwareortoVDEitself,therunningversionofVDE#mustbeshutdown. n'JOPCSIis availableinOpenVMSV6.1andlater,thoughnotIOall prerequisiteproductsmaybe installedwithit.0SeeO5Section1.3.14&5for informationon registeringOpenVMSOproductsviaPCSI.*O?  -O1.3.1BPCSISoftware RegistrationHO4PCSI installationkitsforvarious prerequisiteproductsHOmaynotyetbe available,andthusPCSImaynothaveLO informationonthese products.)TherearetwowaysonecanRO=register products,withaproduct registrationkit,orwiththe+OPCSI$REGISTER_PRODUCT procedure.i! ?LOThe registrationfora particular prerequisiteproductneedHOonlybe performedonce,butitmustbe performedanewPO5wheneveranewversionofthe prerequisiteproductisloaded.O(SeeTable1-19rforalistofthe prerequisite products.)*!Pa?"sCOFormore informationonPCSIorthePCSIcommands0Oshownhere,seethePCSImanuals.K#U!.O1.3.1.1CProduct RegistrationKitsIO)Some products,suchasOpenVMSVAXV6.1,include``typeIO6''PCSI registrationkits.*WhileOpenVMSVAXV6.1doesTOnotusePCSItoinstall,itdoescontaina registrationkit.*In,O3 particular,theOpenVMSproduct"3 must3havebeen installedHOviaPCSI(onversionsofOpenVMSwherethisoptionisLO available),ortheOpenVMS registrationkitmusthavebeen O< registeredviaPCSI.$ @OThesePCSIkits typicallyresidein SYS$MANAGER: * -O6.PCSI D*/or(more commonly)in SYS$UPDATE: */-6.PCSI U* z. O$0 DEFINE/NOLOG% PCSI$SOURCE% SYS$UPDATE: O$)PRODUCT%REGISTER%PRODUCT%VMS7OIThe% following&product%has&been% selected:-ODEC%VAXVMS&VMS%V6.1 [Available]-ODo%you%want%to% continue?%[YES] YES8O!The% following&product%will%be% registered: OiDEC%VAXVMS&VMS%V6.1MOPortion&Done:&30%...10%...20%...30%...40%...50%...60%...70%...100%9OThe% following&product%has&been% registered: OADEC%VAXVMS&VMS%V6.1 O$%NFOWhen registeringtheproductusingtheabove-mentionedHOcommand,PCSImayask differentor additional questionsEO5 dependingonthe particular``type6''kitspresent.&NNOShoulderrorsoccurduringthe installationontheHELPli-MObrariesor DCLTABLES,itislikelythattheOpenVMS``type1O56''kitshavenotbeen registered.'[(O1.3.1.2CPCSI$REGISTER_PRODUCTMO)Iftheproductshavenotbeen registeredwithPCSIanddoLOnothaveproduct registrationkits,youmustmanuallyreg-OOisterthemwithPCSI.Toregister products,youcanusetheO3 followingcommand:.O$*!@SYS$UPDATE:PCSI$REGISTER_PRODUCT=(OOFailuretoperformthis registrationcanleadtoerrorsdur-MOingtheVDE installation.*OneerrorthatmayindicatethatHO5theOpenVMSimageshavenotbeen registeredinvolvesa/O%PCSI-E-PARUDFerroron DCLTABLES.)zMOThe followingexampledisplayshowtoregisterversionV3.6FOoftheDECCode ManagementSystem(CMS)ProductwithO5PCSI: O$+!@SYS$UPDATE:PCSI$REGISTER_PRODUCTOProduct&name: ZCMSOIVersion:IV3.6OProducer%[DEC]: DEC7O!The% following&product%has&been% selected: OiDEC%AXPVMS&CMS%V3.6-ODo%you%want%to% continue?%[YES] YES8OAThe% following&product%will%be% registered: ODEC%AXPVMS&CMS%V3.6#OPortion&Done:& 0%...100%9OThe% following&product%has&been% registered: OaDEC%AXPVMS&CMS%V3.6* vNOTheproduct registrationprocessneedonlybe performedonce(Oforany particularproduct.+zMOThecurrentcontentsofthePCSIdatabasecanbe displayedOwiththecommand: Oa$#aPRODUCT%SHOW%HISTORY&*,! D6O1.4BUpgradesfromPreviousVDEVersionsIOUThisversionofVDEsupportsupgradesfromallpreviousPOversionsofVDE,andthisversionisdirectly compatiblewith9OthelibraryformatusedintheVDEV1.3- & nqandX1.2-  n 6re-RO^leases.' LibrariescreatedbyVDEversionspriortoX1.2canbe=OupgradedtothelibraryformatusedbyX1.2-  n,V1.3-  n ,andPOV1.5-0releasesofVDEusingthebuilt-inlibraryformatcon-QOhversiontools.)(Forfurther informationonthistopic,seethe'OCONVERTLIBRARYcommandin a VDE ReferenceManual .) B5*ECaution 6B5IPriortothe installationofVDE,disablethe automaticB#libraryformat conversiononeachlibraryusinga3{MODIFYLIBRARY/NOAUTOCONVERTcommand.BThiscommandmustbeissuedagainsteachVDEli-F-brarypresentonthesystemor VMScluster.'ThisstepCwillpreventan unintentionalor unexpectedlibraryformat conversion. (|-nR$O1.5BLicense Registration.OUVDEdoesnotrequirealicense.6F 0OTable1-2:7DiskSpace Requirements O  OFKitC3FBlocksDuring InstallationBlocksAfter Installation Ob "O VDEforOpenVMSAlphaO V1.5-03 28,000 28,000 Oq VDEforOpenVMSVAXO V1.5-03q 12,500q 12,500$O8 VDEV1.5-0 Documentation O Kit38 17,0008 17,000 O (Z.w07O1.6B VMScluster InstallationConsiderationsGOUIfVDEistobe installedina VMSclusterormixed-CO architecture VMScluster environment,all prerequisiteJOsoftwareproductsmustbe installedand operatingonall%O^nodesinthe VMScluster./ ROAlso,allversionsofall prerequisiteproductsmustbecompat-8Oableacrossallnodesinthe VMScluster.M)O2.1BThePCSI SequentialKitJOUYoushouldhavereceivedtheVDEkitasaPCSIsequen-QOtialkit.)CopythePCSIkitforthe appropriateplatformintoO SYS$SCRATCH:.N `mmOpenVMSAlpha: emDEC-AXPVMS-VDE-V0105-1 `OpenVMSVAX: 8DEC-VAXVMS-VDE-V0105-1V z4O2.3B InstallingtheOnline Documenation?OUOnline documentationfortheOpenVMS DevelopmentCO Environment(VDE)is availablein Bookreaderand/orRO PostscriptformatsinaseparatePCSIkit.(Toinstallthedoc-KO^ umentation,copythe documentationkitforthe appropriate'Oplatforminto SYS$SCRATCH:.W `mmOpenVMSAlpha:#emDEC-AXPVMS-VDEDOC-V0105-1 `OpenVMSVAX:#8DEC-VAXVMS-VDEDOC-V0105-1X! NLOTheVDE documentationkitinstallsusingasimilarcommandUOasisusedtoinstalltheVDEutility.'Thereareno prerequisite O5product requirements.Y `m7mInvokethePCSIPRODUCTINSTALLcommand.6PRODUCT*INSTALL+VDEDOC/SOURCE=SYS$SCRATCH: _UNote _DTwo documentationkitsexistto facilitatePCSIin-Ak stallationfromeitherplatform(OpenVMSAlphaor@OpenVMSVAX),butthe documentation installedis&thesameforeitherkit. fZh5O 3.:After% Installing%OpenVMS& DevelopmentOr EnvironmentJOThe followingtasksarerequiredafter installingOpenVMS*OO Development Environment(VDE):[ `m.mEditingthesystemstartupfile. `" Modifyinguserquotas. `l:lMakingtheproductusableona VMScluster. ` Reporting problems. \ UBO3.1BRunningthe Installation Verification Procedure( SeparatelyNOYouusuallyrunthe Installation Verification Procedure(IVP)QOduring installation.(IfyouwanttoruntheIVP separatelytoPO^ensurethe integrityof installedfilesshouldsystemproblems>Ooccur,executethe followingcommand procedure: O<$<@SYS$TEST:VDE$IVP ! ]*O3.2BEditingtheSystemFilesOOUYoumusteditthesystemstartupandshutdownfilestopro-KOvidefor automaticstartupandshutdownofVDEwhenyourOsystemis rebooted.^! LOMakecertainthecommandlineusedtostartVDEhasbeenGOaddedtothesystemstartupfile,SYS$SYSTEM:SYSTARTUP_EO5VMS.COM.The followingexampleshowstheVDEstartupOcommandline: O$A!%SYS$SYSTEM:SYSTARTUP_VMS.COM% Site-Specific&Startup OZ$Z!%Start%VDE O$&@SYS$STARTUP:VDE$STARTUP.COM . 2. z.! "_o%O3.3B TailoringTheSystemHOUYoucaneditthe site-specificVDEstartupDCLcommand8O procedure,SYS$STARTUP:VDE$SYSTARTUP.COM,toNOprovidelocal definitionsforthedefaultVDE librariesvis-KO^ibletousers.-This procedureisinvokedfromwithinthe1OSYS$STARTUP:VDE$STARTUP.COM procedure.Q`[ '=OAtemplateoftheSYS$STARTUP:VDE$SYSTARTUP.COMaO procedureisincludedinthe distributionas#SYS$STARTUP:VDE$SYSTARTUP.TEMPLATE.MO5Usersshouldnotmodifythe"SYS$STARTUP:VDE$SYSTARTUP.TEMPLATE"zzSET%ENVIRONMENT/CLUSTEROSYSMAN>3zDO&INSTALL%REPLACE%SYS$SHARE:DCLTABLESO SYSMAN>*z DO&@SYS$STARTUP:VDE$STARTUP.COMORSYSMAN>zREXIT O$cLOThiswillmaketheVDEcommand availabletoallnodesinMOtheclusterwithout requiringasystem(orcluster)reboot.#"%d *O3.5BUserAccount RequirementsLOUToworkwithVDE,useraccountsonyoursystemmusthaveNOcertain privilegesandquotas.)Thenexttwosectionscontain/O informationonthese requirements.*eVO3.5.1B PrivilegesCO4Touse VDE,each usernamemust haveatleastthe=OTMPMBXandNETMBX privileges.+UsetheOpenVMSFO AuthorizeUtilityto determinewhetherusershavetheO=required privileges.FfHOVDE internallyincludesasetofVDE privileges./UsersHOwiththeOpenVMS privilegeBYPASScanoverridetheas-MO5signedVDE privilegesandcangainallVDE privileges.)For?O information,seetheVDEcommandSET PRIVILEGE.g &O3.5.2BUserAccountQuotasO4Table3-1@4containstheminimumprocessquotasrequiredforOVDE.*gOb?hmi! C OSeeSection1.7.3?fora descriptionofhowtoverifyandchangeMOaccountquotasand privileges.+IfVDEdetectsavaluethatGO<isbelowthe specifiedminimumvalue,an informationalKOmessagewillbeissuedandVDEwillattemptto continue.*iM?D%#&j V,O3.6BAddingVMS_MENUtoSYLOGINQOUIfyouwishtoallowusersaccesstotheVDEmenu interface,MOyouwilllikelywanttoeditthe system-widelogincommandb" madetomessages displayedduring notification.O VDE/WHEREISgb Thisisanew qualifiertothe DCL-levelVDEcommand(not availableattheVDE>jbc prompt).#Thistoolallowscommand proceduretolocatekey componentsand/orobtainanb listof available databases.$ InformationisreturnedaslocalsymbolsorprocesslogicalBb names,as specifiedbythecaller.!Exampleusage:#b $ VDE/WHEREIS /LIBRARY=c  vde-libname" /RETURN=LOGICAL_NAMES$b  VDE/WHEREIS/INDEX=  vde-libindex /RETURN=SYMBOLSRbw Forfurther information,seethe informationonthe VDE$WHEREIS_ * w symbols/logicalb names.rz a  O OFeatureb Description O 0OA New/ChangedFeaturesforVDEV1.4- An O\ O QuotaChecksgbV TheminimumquotavaluesusedforVDE'squotacheckshavebeenraisedforASTLM,`b BYTLM,JTQUOTAandTQLMforV1.5-0.%VDEwilldisplayawarningmessageandbb attempttocontinueshouldoneormore insufficientquotavaluesbe detected.gbj Seethe VDE/READ_UAFcommandfor assistanceinupdatinguserquotasinthesystembb authorizationdatabase(SYSUAF)andupdatinguserentriesintheVDE database.O2 SETCMS/SETVDEeb TheSETCMS,SETVSCandSETVDEcommandsareobsoleteandall referencestothesecb commandshavebeenremovedfromthecommandtablesandtheOpenVMS Development`bF Environmentdocumentation.#Thesecommandsprovidedanaccesscontrol mechanismmb fortheVDE components.$Moreflexibleaccesscontrol capabilitiesarenow availableviaNb standardVDEsecurityfeaturessuchas subsystem identifiers.O[ MessageTextpb ThetextofvariousmessagesoutputbyVDEhasbeenimprovedforclarity."The associatedFb" documentedrecoverystepshavebeenimprovedaswell. O 1O New/ChangedFeaturesfromVDEV1.3- =n O O7 Documentationjb The documentationnowcallsoutthe similaritiesandthe differencesbetweentheVSC-b andtheVDEcommand interfaces.7bx SeveralchaptershavebeenaddedtotheVx GuidetoUsingVDE% x todetailvariouscommonhb tasks,and informationonmanagingaVDElibraryhasbeen expanded.$Theformatof+b themanualhasbeen improved.Kb AnErrorMessagesandRecoverysectionhasbeenaddedto VDE ReferenceManual .4b An installationguidehasbeenadded.:b Thevariousindicesarenowratherlarger.eb Various appendicieshavebeenadded, includingone containingvariousVDElogicalbH names.sz m  O OFeatureb Description O 1OA New/ChangedFeaturesfromVDEV1.3- =An O\ gb Implicit assumptionsonvariouspointsofarcaneprocess knowledge-andon knowledgejb) oftermssuchas``MasterPack''and ``Yellow'',etc-havebeenreducedor eliminatedgbw fromtheVDEdocumentation."Whenever possible, terminologyhasbeenmade consistent_b acrossboththeOpenVMSVAXandtheOpenVMSAlpha development environments.O> Motif Interfaceb VDEV1.3-  nN andlaterversionscontaina Motif-baseduser interface,andXb associated hyper-help.0InvoketheVDEcommand specifyingthe qualifier bS /INTERFACE=DECwindows.bb TheMotif interfaceincludessupportforFETCH,RESERVE,REPLACEand UNRESERVEgb commands,aswellasHELPandafewother Motif-related commands.$VDEtargetli-vbh brary selectionis currentlyviastaticresourcefileentries(madevisibleandselectedviaahb cascademenuloadedat run-time),butmaybemadedynamicinanupcomingrelease.(O/ CREATELIBRARY/NOAUTO_CONVERTcb Automaticlibraryformat conversionisnowdisabledbydefaultasthe/NOAUTO_hb CONVERT qualifierisnowthedefault.&PreviousversionsofVDE defaultedtoallow-dbD ing automatic conversion.& Libraries presentlymarkedfor automatic conversionarelb notaffectedbythischange.&AllVDE librariesshouldbereviewedto determineifan7b automatic conversionshouldbe permitted.OX ArchitectureSupportWb TheVDEcommandsformanaging ARCHITECTUREsare partially documented.q  ThisJb capability introducedinV1.3-nisnotfully implemented.!O OpenVMSAlphaSupportgb AsofV1.3-0,VDEis availableforOpenVMSVAXandOpenVMSAlpha;ReleasesV1.3- ba nDa andV1.5-0operateinmixed-architecture VMSclusters.O PCSI Installation;bT VDEisnow installedviathePCSIutility. tp  O OFeatureb Description O 1OA New/ChangedFeaturesfromVDEV1.3- =An O\ O QuotaCheckibV VDEV1.3andlaterreleasescheckforvariousminimumquotavalues.#VDEdisplaysakb warningmessageandattemptstocontinueshouldoneormore insufficientquotavaluesb be detected.gbj Seethe VDE/READ_UAFcommandfor assistanceinupdatinguserquotasinthesystembb authorizationdatabase(SYSUAF)andupdatinguserentriesintheVDE database.!O2 SETPRIVILEGE/OVERRIDEfb AllowsauserthathastheOpenVMSBYPASS privilegeenabledtooverridetheVDEmb privilegesettingsandtosetallVDE privileges.#An informationalmessageis generatedSbF whenthe privilegeisused,and privilegeauditingis performed.O SETLIBRARYcb: TheSETLIBRARYcommandnowallowsauserthathastheOpenVMSBYPASSprivi-ob legeenabledtooverridea restrictedVDEuser authorization database,andtoaccessthelb library."Thisisintendedtoallow privilegedVDEuserstoperformVDEdatabasemain-db" tenancewhen necessary.%An informationalmessageis generatedwhenthe privilegePbp overrideisused,anda privilegeauditmessageis generated.eb TheSETLIBRARYcommandnow correctly processeslibraryspecifications incorrectlyrb7 includethelibraryfilename,thelibraryfile extension,and/orthelibraryfileversion-jb these componentsarenowignored.#PreviousversionsofVDE permittedonlythedevicegb and directoryspecifications,andanerrorwas generatedwhen additional componentsb were specified.hb TheSETLIBRARYcommandnowallowsthe specificationofeitheranexplicitlibraryfb specification,oramnemonic shorthandforthedesiredlibrary.% Mnemonicsandthenb4 associated translationsare establishedvialogicalnames,andcanbetailoredforindi-lb vidualusers,forgroups,orona system-widebasis.$Forfurther information,seetheSb informationontheVDE$LIBRARY_DEFAULTS,VDE$LIBRARY_DEFAULTS_LABELS,Hb VDE$LIBRARY_DEFAULTS_CMS,andVDE$LIBRARY_DEFAULTS_MNEMONICSbj logicalnames.ab Whenno parameteris specifiedontheSETLIBRARYcommand,anerrormessageob1 is(still) generated,andasite-configurablelistofthe availableVDE librariesisnowb displayed.uz ?  O OFeatureb Description O 1OA New/ChangedFeaturesfromVDEV1.3- =An O\ Ub WhentheVDE$LIBRARY_DEFAULTS_MNEMONICSlogicalnameisdefined,thegb) SETLIBRARYcommandis availableviakeyboard definitionsfortheF17throughF20ibw keyboardkeys.%Thefirstfour librarieslistedinthetranslation(s)of VDE$LIBRARY_4b DEFAULTS_MNEMONICSareselectedbythe default1  keystate,thesecondfourbytheb gold0 state,andthethirdfourbythe blued state.O SHOW DEVELOPER8b Thiscommandisnow partially documented.$O SHOWREPLACEMENT/ACCEPTEDnb Thisisanew qualifier.!Thisdisplaysall replacement componentmodulesthathavebeenbF markedas accepted.%O SHOWREPLACEMENT/IN_REVIEWob: Thisisanew qualifier,anddisplaysall replacement componentthatare presentlyunderb review.(O SHOWREPLACEMENT/NOT_REVIEWEDkb{ Thisisanew qualifieranddisplaysall replacement componentmodulesthathavenotb yetbeen reviewed.$OB SHOWREPLACEMENT/REJECTEDgb Thisisanew qualifieranddisplays replacement componentmodulesthathavebeenb rejected.O VDE$ENABLE_AUDITfb Asystemlogicalnamedefinedin executivemodethatenablesOpenVMS system-levelmbJ auditingofvariousVDE operations.$UseofthisoptionrequiresthattheVDEimagebeRb installedwithorrunwiththeOpenVMSAUDIT privilegeenabled.O CREATE MODULE/INPUTgb Thiscommandisnolongeracceptedonstreamsmarkedforqueued replacements."Anykb attempttoperformthis operationonastreammarkedforqueued replacementswillbe5b& rejectedwiththeerrorVDE$_INCNOTVAL.r vz H  O OFeatureb Description O 1OA New/ChangedFeaturesfromVDEV1.3- =An O\ .O VDE$MARKER marker-file directoriesabV VDEnowcreatesthe [.VDE$MARKER] marker-file subdirectorywhen initializingab library.O MODIFY LIBRARY/LOCKob VDEnowsupportsalimited capabilitytomaintaina write-lockonalibrary."Thiscapa-mb bilityisintended primarilyforthe maintenanceand consistencyofshadowor referenceb2 VDE libraries.(O MODIFY MODULE/NAME Obsoletedob% The/NAME qualifierhasbeenremoved,asthereisnoreliablewaytohandletherenameobs operationattheCMSlevel,nora reasonablewaytohandlecopyingthevariouspossibleqb sourcefiles,objectfilesandsimilar.!Userswishingtoperformarenamemustdeletethekb oldmoduleandrecreateitunderthenewname, specifyingthe appropriate generationsb[ tocreate.O Kept SubprocesseslbO Erroneousattemptstodirectlyattachtoakept subprocess,via lib$attachortheDCLOb ATTACHcommand,nolongercausethekept subprocesstoexit.kb Thekept subprocessnowusesauniqueprocessname;previousversionsusedaprocess)bc namebasedonthe username.O Calling InterfacelbW VDEnowincludesacallable interfaceallowinglistingsof libraries,andfetches.%Theib interfacesupportsremoteaccessviaanIPnetwork,andis implementedasashare-kb ableimage.#This interfacedirectlysupportstheVDEWWWserver.#Afuturereleaseofgb? VDEmayaddsupportfor reservations,unreservations,and replacements."ContactVDE#b supportfor informationZ beforeG( usingthis interface-afew incompatiblechangestothe.b interfaceare currently expected.OT VDE$LIBRARY_LABELbb VDEnowdefinesaprocesslogicalnameVDE$LIBRARY_LABELwhenevera connectionpb ismadetoalibrary."Thislogicalnamecontainstheremark associatedwiththelibrary,Zbi andisintendedforusewithin proceduresbasedontheVDE utilities.d wz I :  O OFeatureb Description O 1OA New/ChangedFeaturesfromVDEV1.3- =An O\ O VDE$LIBRARY_MNEMONICYbV VDEnowdefinesaprocesslogicalnameVDE$LIBRARY_MNEMONICwheneveramb connectionismadetoalibrary.#Thislogicalnamecontainsthelibrarynameor,whenlb known,themnemonicname associatedwiththecurrentlibrary,andisintendedforuse=b> within proceduresbasedontheVDE utilities.O VDE$NOTES_LIBRARYpb2 AlogicalnamethatallowsausertochangethedefaultNotes conferencefile specifica-qb tionforSCTNotes conferencesaccessedbyVDE.Ifthislogicalnameisnotdefined,the@b defaultvalueof``NOTES$LIBRARY:.NOTE''isused.OF Script Enhancementsib Anewscripttype,CREATE_FACILITY,hasbeenadded."Thisoptionalscriptisinvoked3b whenanewfacilityiscreated.!See  VDE ReferenceManual  fordetails.ob The executioncontextofthescripthasbeenchanged,andscriptsnow correctlytoleratefb anEMITofanEXITDCLcommand;scriptsalsorecoverfromvariousabnormalter--b" minationsofscript.%Scriptsdo 8" notD" correctlyrecoverfromthecompletedeletionofthepbp subprocess.#Thiswillwedgethecurrent operation,andstillrequiretheusertoentera b bTzCTRL/Y zT b! tofreetheprocess. b@ The - T = T V- 7@ and - T = T V-Y @ characterscannowbeusedtoquotestringsusedintheEMITscriptb command.jb Anewscript function, $SCRATCH,hasbeenadded.!Wheninvoked,thisfunctionreturnsmbT thedeviceand directory specificationfortheVDEscratch directory.%This directoryis?b usefulforscriptsthatneed temporarystorage. O Statistics CollectionTb VDE now optionally collects replacement statistics.4Seethe MODIFYNb LIBRARY/STATISTICS,REPLACE/REASONSandREPLACE/DEFECTS_CORRECTED!b0 commandsfordetails. xz q  O OFeatureb Description O 1OA New/ChangedFeaturesfromVDEV1.3- =An O\ ,O ChangestotheREPLACEcommandfbV ExistingREPLACEpromptshavebeenchanged,newpromptshavebeenadded,andnewkb qualifiershavebeenadded.$Changesinvolvethesyntax surroundingthereasonforthejb change,howtheSCT informationis processed,andthe collectionof statistics.%Somepb> ofthisworkispartofthe statistics collectionwork mentionedabove,somereducestheob numberofseperatestepsrequiredtoenterachange,andsomeisintendedtoallowforeb theoptional automatic generationoftheSCTentryinafuturereleaseofVDE.`bS ThenewREPLACE/DEFECTS_CORRECTED qualifierallowsdirectentryofthenumbermb ofdefects correctedbythe replacement.$Thisqualiferoperatesin conjunctionwiththe_b statistics collectionprocess,theMODIFYLIBRARY/STATISTICScommand,andtheb; /REASONS qualifier.hb Thenew REPLACE/NOTEqualiferallowsdirectentryoftheSCTnotenumber.$Ifthislb qualiferis specified,thedefaultSCTNotes conferencenameisassumed.%Ifboth/SCT@bP and/NOTEare specified,/NOTEtakes precedence._b REPLACE/REASONSallowsdirectentryofthereasonforthe replacement.)Thisgb qualiferoperatesin conjunctionwiththe statistics collectionprocess,theMODIFYZbe LIBRARY/STATISTICScommand,andthe/DEFECTS_CORRECTED qualifier.#Partofub thischangeisinsupportofthe statistics collectionwork mentionedabove,andpartistheob foundationthatwillallowfortheoptional automatic generationoftheSCTentryinan0bM unspecifiedfuturereleaseofVDE.gb Thenew REPLACE/SCTqualiferallowsdirectentryofafilename containingtheSCTnb notetext.%Ifthisis specified,thedefaultSCTNotes conferencenameisassumed,andlbb VDEloadsthe specifiedfileintotheSCTNotes conference,usingthe replacementre-ob marktextasthetitleofthenote.%Ifboth/SCTand/NOTEare specified,/NOTEtakesb precedence.`bw ThenewMODIFYGENERATION/NOTEqualiferallowsdirectentryoftheSCTnoteob number.!Ifthisqualiferis specified,thedefaultSCTNotes conferencenameisassumed.Pb Ifboth/SCTand/NOTEare specified,/NOTEtakes precedence.bb ThenewMODIFYGENERATION/SCTqualiferallowsdirectentryofafilenamecon-nb tainingtheSCTnotetext.%Ifthisis specified,thedefaultSCTNotes conferencenamemb& isassumed,andVDEloadsthe specifiedfileintotheSCTNotes conference,usingthepbt replacementremarktextasthetitleofthenote.#Ifboth/SCTand/NOTEare specified,#b /NOTEtakes precedence.yn { O OFeatureb Description O 1OA New/ChangedFeaturesfromVDEV1.3- =An O\ 5O ChangestotheCREATEFACILITYcommandabV As mentionedabove,anewscripttype,CREATE_FACILITY,hasbeenadded.&ThisRb optionalscriptisinvokedwhenanewfacilityiscreated.!See  VDE ReferenceManual  forb details.]bj TheCREATEFACILITYcommandnowsends notificationmessagesforthenewlygb createdfacilitytothe individualsthathaveaskedfor stream-levelnotifications. O2 LongerCLDsacceptedeb VDEacceptsbothnineandten characterCLDnumbers:#boththeoriginalXXX-NNNNHb andthelonger XXX-NNNNNCLDformatsarenow accepted.Os NewExampleshb VDEincludesexamplecommand proceduresand associatedfilesusedtouploadanex-qb: istingsetofCMS librariesintoanewVDElibrary,andanexampleofamenu interface.Ib Allexamplesarelocatedinthe VDE$EXAMPLES: directory. O (')fn<4O3.9B Installation Verification ProcedureOOUThe installation verification procedureteststhelocalcompo-NOnentsoftheVDE software;itdoesnotincludeanynetworkEOtesting.'ToruntheIVP,usethe followingcommand. O$@SYS$TEST:VDE$IVP )(+oO A.!New!FeaturesOTableA-1> describesthevariousnewandchangedfeatures1OpresentintheVDEV1.5-0release.*oOTn?ph+),Nz$$OB.!Example! Installations))gINDEXINDEX!i  iAA-S8ASTLMASTLMr3S 8AuditingAuditingu5S 8 AuthorizeAuthorizee1S8AUTOGENAUTOGEN:!i  jBB-S9BYTLMBYTLMr!i  iCCYS&&8ChangingSystem ParametersChanging System Parameters:)S  8CLDCLDy-S  8CMSCMSyBMN3SeealsoDECCMSSee also DEC CMS=SN8 compatibilitycompatibilityq3S 8 ConversionConversion5S N8 AutomaticAutomaticpOS!!9CREATEMODULEcommandCREATE MODULE commanduAS9CREATE_FACILITYCREATE_FACILITYw!i  iDDBS8DatabaseFormatDatabase Formatp9S 8 DCLTABLESDCLTABLES&(.S8DECCMSDEC CMS9M N3SeealsoCMSSee also CMSDSN9versionrequiredversion required2S 9DECNotesDEC Notes=MN3SeealsoNotesSee also NotesDSN8versionrequiredversion required@S8 DECwindowsMotifDECwindows MotifDSN8versionrequiredversion required9S 8 DirectoriesDirectoriesv!i  jEE)S8ErrorErroraS**N9during installation:! DCLTABLESduring installation: DCLTABLES&lS$00N9during installation:!HELP librariesduring installation: HELP libraries&/S 8ExamplesExamples/SN8MenuMenujy/SN8UploadUploady!i  iFF2S9F17keyF17 keyu2S9F18keyF18 keyu2S8F19keyF19 keyu2S8F20keyF20 keyuNS  8Facility notificationFacility notificationy!i  iHH@S9HELP librariesHELP libraries&!i  iJJ1S8JTQUOTAJTQUOTAr!i  iLL8S 8LogicalNameLogical NameCSN8VDE$ENABLE_AUDITVDE$ENABLE_AUDITuESN8VDE$LIBRARY_LABELVDE$LIBRARY_LABELvKSN8VDE$LIBRARY_MNEMONICVDE$LIBRARY_MNEMONICwESN9VDE$NOTES_LIBRARYVDE$NOTES_LIBRARYw!i  iMM'S8MailMailBSN8CREATEFACILITYCREATE FACILITYy;S N8 notificationnotificationqTS##8 Marker-file subdirectoryMarker-file subdirectoryv@S 9MenuExampleMenu ExamplejySS%%9MODIFY GENERATIONcommandMODIFY GENERATION command@SN8/NOTEqualifer/NOTE qualiferx>SN8/SCTqualifer/SCT qualiferxYS&&8MODIFY MODULE/NAMEcommandMODIFY MODULE/NAME commandv=S8 MODPARAMS.DATMODPARAMS.DAT:-S9MotifMotifsTM&&N3Seealso DECwindowsMotifSee also DECwindows Motif!i  iNN)S8NMAILNMAILDSN9versionrequiredversion required-S8NotesNotesFMN3SeealsoDECNotesSee also DEC Notes;S N8 notificationnotificationqJS8Notes ConferencesNotes Conferencesqx;S 8 NotificationNotificationq!i  jOO-S9OpenVMSOpenVMSDSN8versionrequiredversion required>S8OpenVMSAlphaOpenVMS Alphas:S 8OpenVMSVAXOpenVMS VAXs6M 2OracleRdb7Oracle Rdb7.MN3SeeRdbSee Rdb!i  iPP3S9PCSIPCSI$(sCSN9``Type6''kits``Type 6'' kits$MS8PCSI$REGISTER_PRODUCTPCSI$REGISTER_PRODUCT'?S8%PCSI-E-PARUDF%PCSI-E-PARUDF(9S8 PrerequisitesPrerequisites/S N8SoftwareSoftware3S 9OptionalOptional3S 8RequiredRequired1S 8 PrivilegePrivilege-SN9AUDITAUDITu7SN9BYPASSBYPASS4ft/SN8CMKRNLCMKRNL4/SN8NETMBXNETMBXe3S N8OverrideOverridet/SN8SETPRVSETPRV4/SN9SYSPRVSYSPRV43SN9TMPMBXTMPMBXHe-SN8WORLDWORLD4US$$8PRODUCTREGISTERPRODUCTPRODUCT REGISTER PRODUCT$MS  8PRODUCTSHOWHISTORYPRODUCT SHOW HISTORY+!i  iQQ)S9QuotaQuota-SN9FILLMFILLMH/S8QuotasQuotasr!i  iRR%S  8RdbRdbDSN8versionrequiredversion required>S8REPLACEcommandREPLACE command@SN8/NOTEqualifer/NOTE qualiferxDSN9 promptingchangeprompting changexFSN9/REASONSqualifer/REASONS qualiferx>SN8/SCTqualifer/SCT qualiferx!i  iSS-S8ScriptsScripts-SN8StuckStuckw8S 9ScriptTypesScript TypesASN9CREATE_FACILITYCREATE_FACILITYw)S  8SCTSCT3S 8SecuritySecurityuOS!!8SET PRIVILEGEcommandSET PRIVILEGE commandfMS  8SHOWLIBRARYcommandSHOW LIBRARY commandp/S 9SoftwareSoftware3S N9OptionalOptional3S N9RequiredRequiredNS  9 Statistics CollectionStatistics CollectionwYS%%8SYS$STARTUP:VDE$STARTUP.COMSYS$STARTUP:VDE$STARTUP.COM_]S''8SYS$STARTUP:VDE$SYSTARTUP.COMSYS$STARTUP:VDE$SYSTARTUP.COM_gS#,,8"SYS$STARTUP:VDE$SYSTARTUP.TEMPLATESYS$STARTUP:VDE$SYSTARTUP.TEMPLATE_n"4#8SYS$UPDATE:PCSI$REGISTER_-PRODUCTSYS$UPDATE:PCSI$REGISTER_ PRODUCTS_S))9System AuthorizationDatabaseSystem Authorization DatabaserFS9System ParametersSystem Parameters9/S8SYSUAFSYSUAFr!i  iTT+S8TQLMTQLMr/S8TuningTuning9FS9Type6PCSIkitsType 6 PCSI kits$!i  iUU@S8UploadExampleUpload Exampley!i  iVV_S))8VDE$ENABLE_AUDITlogicalnameVDE$ENABLE_AUDIT logical nameu[S%%8 VDE$EXAMPLESlogicalnameVDE$EXAMPLES logical namejygS"--8VDE$LIBRARY_DEFAULTSlogicalnameVDE$LIBRARY_DEFAULTS logical nametw&9"8VDE$LIBRARY_DEFAULTS_CMS-logicalnameVDE$LIBRARY_DEFAULTS_CMS logical namet})<%9VDE$LIBRARY_DEFAULTS_LABELS-logicalnameVDE$LIBRARY_DEFAULTS_LABELS logical namet-A9VDE$LIBRARY_DEFAULTS_"- MNEMONICSlogicalnameVDE$LIBRARY_DEFAULTS_ MNEMONICS logical nametaS**8VDE$LIBRARY_LABELlogicalnameVDE$LIBRARY_LABEL logical namevo"5'8VDE$LIBRARY_MNEMONIClogical-nameVDE$LIBRARY_MNEMONIC logical namew7S 8 VDE$MARKERVDE$MARKERvaS**8VDE$NOTES_LIBRARYlogicalnameVDE$NOTES_LIBRARY logical namewAS9VDE$STARTUP.COMVDE$STARTUP.COM_ES9VDE$SYSTARTUP.COMVDE$SYSTARTUP.COM_OS  8VDE$SYSTARTUP.TEMPLATEVDE$SYSTARTUP.TEMPLATE_5I$8VDE$WHEREIS_BACKUPS_AFTER_%-IMAGEsymbol/logicalnameVDE$WHEREIS_BACKUPS_AFTER_ IMAGE symbol/logical nameq0C%8VDE$WHEREIS_BACKUPS_ARCHIVE-symbol/logicalnameVDE$WHEREIS_BACKUPS_ARCHIVE symbol/logical nameq0C%8VDE$WHEREIS_BACKUPS_CURRENT-symbol/logicalnameVDE$WHEREIS_BACKUPS_CURRENT symbol/logical nameq,?!8VDE$WHEREIS_BACKUP_FULL-symbol/logicalnameVDE$WHEREIS_BACKUP_FULL symbol/logical nameq,?!9VDE$WHEREIS_BACKUP_INCR-symbol/logicalnameVDE$WHEREIS_BACKUP_INCR symbol/logical nameqs$7)9VDE$WHEREIS_CMSsymbol/logical-nameVDE$WHEREIS_CMS symbol/logical nameq})<8VDE$WHEREIS_DATABASE-symbol/logicalnameVDE$WHEREIS_DATABASE symbol/logical nameqw&9+9VDE$WHEREIS_LABELsymbol/logical-nameVDE$WHEREIS_LABEL symbol/logical nameq})<8VDE$WHEREIS_MNEMONIC-symbol/logicalnameVDE$WHEREIS_MNEMONIC symbol/logical nameq?S8VDE$_INCNOTVALVDE$_INCNOTVALu1S8VDE/AGEVDE/AGEpLS8 VDE/READ_UAFCommandVDE/READ_UAF Commandr7S 9 VMSclusterVMSclusters!i  iWWHS8/WHEREIS qualifier/WHEREIS qualifierq,+-{ { )OB.1CExampleVDE InstallationHOUThe followingisanexampleVDE installation.,ThePCSIMOkitisassumedtobea sequentialkit,andisassumedtoGOresidein SYS$SCRATCH:./Inthiscase,all prerequisiteLO^productsnot installedviaPCSIhavebeen registeredusing$OPCSI$REGISTER_PRODUCT.COM.6O<$&PRODUCT%INSTALL%VDE/SOURCE=SYS$SCRATCH:7OThe% following&product%has&been% selected:"ODEC%AXPVMS&VDE%V1.5-0-OVDo%you%want%to% continue?%[YES]YO***%DEC&AXPVMS%VDE%V1.5-0:%DEC%VDE&For%OpenVMS&Alpha,%Version&V1.5-0L( Copyright&Digital% Equipment&Corp%1997.KAll%rights% reserved.AVDE&was%produced%by%Digital& Equipment% Corporation>This%product&is&for%DIGITAL&INTERNAL&USE%ONLYNdDo%you&want%all&the%default&values%for%this%product?%[YES]  Prerequisite&Products56Do%you&want%to%view%the%values?%[NO]8O%PCSIUI-I-DONEASK,% execution&phase&starting7OThe% following&product%will%be% installed:"O/DEC%AXPVMS&VDE%V1.5-0UOw%PCSI-I-VOLINFO,& estimated%space% information%for%volume& DISK$ALPHASYSNO-PCSI-I-VOLSPC,%27532% required;&1091910% available;%1064378&netGO Portion&Done:&-0%...10%...20%...40%...60%...70%...90%...100%8OO The% following&product%has&been% installed:"O DEC%AXPVMS&VDE%V1.5-0YO ***%DEC&AXPVMS%VDE%V1.5-0:%DEC%VDE&For%OpenVMS&Alpha,%Version&V1.5-0i VDE&Startup%FileK Insert&the% following%lines%in%SYS$MANAGER:SYSTARTUP_VMS.COM:&z @SYS$STARTUP:VDE$STARTUP.COM Ob $v-,2|L ,OB.2CExampleVDEDOC InstallationKOUThe followingisanexampleVDEDOC installation.(ThePCSIEO sequentialkitisassumedtoresidein SYS$SCRATCH:.9O2$&PRODUCT%INSTALL%VDEDOC/SOURCE=SYS$SCRATCH:7OThe% following&product%has&been% selected:%ODEC%AXPVMS&VDEDOC%V1.5-00OLDo%you%want%to% continue?%[YES]%Y_O***%DEC&AXPVMS%VDEDOC%V1.5-0:%DEC%VDEDOC&For%OpenVMS&Alpha,%Version&V1.5-0S Copyright&Digital% Equipment& Corporation&1997.KAll%rights& reserved.@VDEDOC&was%produced%Digital& Equipment% Corporation>This%product&is&for%DIGITAL&INTERNAL&USE%ONLYNZDo%you&want%all&the%default&values%for%this%product?%[YES]5Do%you&want%to%view%the%values?%[NO]8O-%PCSIUI-I-DONEASK,% execution&phase&starting7OuThe% following&product%will%be% installed:%ODEC%AXPVMS&VDEDOC%V1.5-0UO%PCSI-I-VOLINFO,& estimated%space% information%for%volume& DISK$ALPHASYSNOL-PCSI-I-VOLSPC,%16834% required;&1062936% available;%1046102&net5OPortion&Done:&0%...30%...50%...90%...100%8OThe% following&product%has&been% installed:%O$DEC%AXPVMS&VDEDOC%V1.5-0 Ol$*}   !!!""####$#%%&'()**********+,--zPrefaceIntended AudienceDocument StructureDocument StructureDocument StructureAssociated DocumentsConventionsConventionsConventions,1. Preparing for the VDE Installation,1. Preparing for the VDE Installation,1. Preparing for the VDE Installation/1.1 Required Operating System Components/1.1 Required Operating System Components-1.2 Prerequisite and Optional Hardware-1.3 Prerequisite and Optional Software5Table 1- 1: Prerequisite and Optional Software-1.3 Prerequisite and Optional Software-1.3 Prerequisite and Optional Software-1.3 Prerequisite and Optional Software'1.3.1 PCSI Software Registration'1.3.1 PCSI Software Registration'1.3.1 PCSI Software Registration(1.3.1.1 Product Registration Kits(1.3.1.1 Product Registration Kits(1.3.1.1 Product Registration Kits(1.3.1.1 Product Registration Kits$1.3.1.2 PCSI$REGISTER_PRODUCT$1.3.1.2 PCSI$REGISTER_PRODUCT$1.3.1.2 PCSI$REGISTER_PRODUCT$1.3.1.2 PCSI$REGISTER_PRODUCT$1.3.1.2 PCSI$REGISTER_PRODUCT.1.4 Upgrades from Previous VDE Versions1.5 License Registration11.6 VMScluster Installation Considerations11.6 VMScluster Installation Considerations.1.7 Installation Procedure Requirements.1.7 Installation Procedure Requirements.1.7 Installation Procedure Requirements&1.7.1 Privileges and Disk Space&1.7.1 Privileges and Disk Space&1.7.1 Privileges and Disk Space*Table 1- 2: Disk Space Requirements&1.7.1 Privileges and Disk Space1.7.2 System Parameters1.7.2 System Parameters<1.7.2.1 Changing System Parameter Values with AUTOGEN<1.7.2.1 Changing System Parameter Values with AUTOGEN<1.7.2.1 Changing System Parameter Values with AUTOGEN<1.7.2.1 Changing System Parameter Values with AUTOGEN<1.7.2.1 Changing System Parameter Values with AUTOGEN<1.7.2.1 Changing System Parameter Values with AUTOGEN<1.7.2.1 Changing System Parameter Values with AUTOGEN<1.7.2.1 Changing System Parameter Values with AUTOGEN<1.7.2.1 Changing System Parameter Values with AUTOGEN61.7.2.2 Setting Dynamic System Parameter Values*1.7.3 Process Quotas and Privileges*1.7.3 Process Quotas and Privileges*1.7.3 Process Quotas and Privileges*1.7.3 Process Quotas and Privileges*1.7.3 Process Quotas and Privileges*1.7.3 Process Quotas and Privileges(1.7.4 Backing Up Your System Disk(1.7.4 Backing Up Your System Disk42. Installing OpenVMS Development Environment"2.1 The PCSI Sequential Kit"2.1 The PCSI Sequential Kit%2.2 The Installation Procedure%2.2 The Installation Procedure%2.2 The Installation Procedure%2.2 The Installation Procedure%2.2 The Installation Procedure%2.2 The Installation Procedure%2.2 The Installation Procedure-2.3 Installing the Online Documenation-2.3 Installing the Online Documenation-2.3 Installing the Online Documenation-2.3 Installing the Online Documenation:3. After Installing OpenVMS Development Environment:3. After Installing OpenVMS Development EnvironmentE3.1 Running the Installation Verification Procedure Separately#3.2 Editing the System Files#3.2 Editing the System Files3.3 Tailoring The System3.3 Tailoring The System3.3 Tailoring The System$3.4 VMScluster Considerations$3.4 VMScluster Considerations$3.5 User Account Requirements3.5.1 Privileges3.5.1 Privileges 3.5.2 User Account Quotas*Table 3- 1: Required Minimum Quotas 3.5.2 User Account Quotas%3.6 Adding VMS_MENU to SYLOGIN%3.6 Adding VMS_MENU to SYLOGIN!3.7 Uploading CMS into VDE-3.8 Determining and Reporting Problems.3.9 Installation Verification ProcedureA. New Features/Table A- 1: VDE New and Changed Features/Table A- 1: VDE New and Changed Features/Table A- 1: VDE New and Changed Features/Table A- 1: VDE New and Changed Features/Table A- 1: VDE New and Changed Features/Table A- 1: VDE New and Changed Features/Table A- 1: VDE New and Changed Features/Table A- 1: VDE New and Changed Features/Table A- 1: VDE New and Changed Features/Table A- 1: VDE New and Changed FeaturesB. Example Installations#B.1 Example VDE Installation&B.2 Example VDEDOC Installation&B.2 Example VDEDOC Installation j vde_ig_preface front_intended_audience front_document_structure$front_associated_documentsfront_conventionsvde_ig_prepareh1_required_opsysh1_hardwareh1_softwaretab_sw h2_pcsi_sw_reg#h2_pcsi_sw_reg_kit'h2_pcsi_sw_reg_com,h1_upgrade-h1_license. h1_preclusters_consids0h1_install_reqs3h2_privileges6disk_space_tab8h2_system_params:h3_reautogenCh3_dynamic_paramsDh2_process_quotasJh2_system_backupLvde_ig_installMh1_pcsi_kitOh1_install_proc_secVh1_install_online_docZvde_ig_cleanup\h1_running_ivp]h1_editing_sysfiles_h1_system_tailoringb h1_postcluster_considsdh1_user_reqseh2_user_privsgh2_user_quotashtbl_quotasjh1_adding_menulh1_uploadmh1_problemsnivp_chapovde_ig_new_featuresptbl_new_featureszh1_example_install{h2_example_install| h2_example_doc_install B-ADOBE-Helvetica-Medium-R-Normal--*-120-*-*-P-*-ISO8859-1@-ADOBE-Helvetica-Bold-R-Normal--*-240-*-*-P-*-ISO8859-1@-ADOBE-Helvetica-Bold-R-Normal--*-180-*-*-P-*-ISO8859-1@-ADOBE-Helvetica-Bold-R-Normal--*-120-*-*-P-*-ISO8859-1@-ADOBE-Helvetica-Bold-R-Normal--*-100-*-*-P-*-ISO8859-1B-ADOBE-Helvetica-Medium-R-Normal--*-100-*-*-P-*-ISO8859-1@-ADOBE-Helvetica-Bold-R-Normal--*-140-*-*-P-*-ISO8859-1O-ADOBE-New Century Schoolbook-Medium-R-Normal--*-140-*-*-P-*-ISO8859-1/-ADOBE-Symbol-*-R-*--*-140-*-*-P-*-*-*O -ADOBE-New Century Schoolbook-Medium-R-Normal--*-120-*-*-P-*-ISO8859-1O -ADOBE-New Century Schoolbook-Medium-I-Normal--*-120-*-*-P-*-ISO8859-1M -ADOBE-New Century Schoolbook-Bold-R-Normal--*-120-*-*-P-*-ISO8859-1O -ADOBE-New Century Schoolbook-Medium-I-Normal--*-140-*-*-P-*-ISO8859-1O -ADOBE-New Century Schoolbook-Medium-R-Normal--*-100-*-*-P-*-ISO8859-1O-ADOBE-New Century Schoolbook-Medium-I-Normal--*-100-*-*-P-*-ISO8859-1@-ADOBE-Courier-Medium-R-Normal--*-120-*-*-M-*-ISO8859-1>-ADOBE-Courier-Bold-R-Normal--*-120-*-*-M-*-ISO8859-1B-ADOBE-Helvetica-Medium-R-Normal--*-140-*-*-P-*-ISO8859-1M-ADOBE-New Century Schoolbook-Bold-R-Normal--*-140-*-*-P-*-ISO8859-1@-ADOBE-Helvetica-Bold-O-Normal--*-120-*-*-P-*-ISO8859-1B-ADOBE-Helvetica-Medium-O-Normal--*-140-*-*-P-*-ISO8859-1;  ODocument StructureGOUThisdocumentcontains installation informationforthe@OOpenVMS Development Environment(VDE)sourcecode9Ocontrolandsourcecodebuild environment.h>>OThismanualcontainsthe following information:  `mmChapter15am describesthe preparationsfortheVDE  installationprocess. `EEChapter27`E describesthestepsinvolvedintheVDE  installationprocess. `Chapter3:_providesafull descriptionofallchangesHvrequiredaftertheVDE installationhasbeen performed. `AppendixA5outlinesthenewandchanged features.*0pO*pOL*pOZ*Ook}! S4O 1.2 Preparing!for"the!VDE! InstallationHOThischapter discussesthe preparationsand requirementsGO necessaryfor installingOpenVMS Development EnvironmentMOB(VDE).(VDEis sometimes confusinglyreferredtoasVSCorCOasVTSC.ThesearesynonymsfortheVDE package.)g==OThismanualappliestoVersion1.5-0ofVDE.C KOVDEprovidesonlinereleasenotes.*Digitalstronglyrecom-IOmendsthatyoureadthereleasenotesbefore proceedingPO5withthe installation.'For informationon accessingtheonlineOreleasenotes,seeSection2.2.*P|?O(04O1.7B Installation Procedure RequirementsMOUThissectionandthosethatfollowdiscussvariousrequire-&Omentsfor installingVDE.1 MOThe installationtakes approximately3minutes, dependingonBOyourtypeofmediaandyoursystemconfiguration.2NHO InstallingVDEandrunningthe Installation VerificationDO Procedure(IVP)ona standaloneDEC7000-610system+O5takes approximately5minutes.I3V-O1.7.1B PrivilegesandDiskSpaceIO4Digital recommendsyouperformthe installationfromtheEOSYSTEM username.,ToinstallVDE,youmustbeloggedOOintoanaccountthathasSETPRVoratleastthe followingO= privileges:z4P `mmCMKRNL `WORLD `llSYSPRV5NJOTheVDEproducthas different requirementsforfreediskIOstoragespaceduring installationandafter installation.O5Table1-215 summarizesthestorage requirements.*5Oa?67 POTo determinethenumberofdiskblocks availableonthecur-KOrentsystemdisk,enterthe followingcommandattheDCLO<prompt: O$%SHOW%DEVICE& SYS$SYSDEVICE\8V2#O1.7.2BSystem ParametersFO4VDEdoesnotrequire particularsystem parameterset-OOtingsforproduct installation,otherthanthose specifiedin9O OpenVMSSystem Manager'sManual:* EssentialseforPCSI.O=product installationsingeneral.\92HOSystem parametersmaybeadjustedafter installationofLOVDEandany prerequisiteproductsfortuning purposes.)SeeBO5 OpenVMSSystem Manager'sGuide:,Tuning, Monitoring,O andComplexSystems,formore informationonsystemOtuning.@:EO1.7.2.1CChangingSystem ParameterValueswithAUTOGENFO)Shouldanysystem parametersrequire changing,whetherOOfor installationorforsystemtuningwhilerunningVDE,use@OtheAUTOGENcommand proceduretodoso.+AUTOGENMO3 automaticallyadjustsvaluesfor parametersthatareassoci-LOatedwiththevaluesyoureset manually.)TochangesystemAO parameterswithAUTOGEN,editthe followingfile:"OhSYS$SYSTEM:MODPARAMS.DAT; NROUseaneditortoaccessthefile.&Tochangea parametervalueVOlistedinthisfile,deletethecurrentvalue associatedwiththat1O5 parameterandenterthenewvalue.<#ROToaddanew parameter,addalinetothefilethatincludesLOboththenameofthe parameteranditsproperminimumor(O5maximumvalue.&Forexample:O MIN_WSMAX%=%1024O MAX_WSMAX%=%2048 _UNote _ UseoftheAUTOGEN  MIN_  ,   MAX_ % and  ADD_ pre-Gdfixesis recommendedover specificationofanexplicitvalue. $=FOTomodify incremental parameterssuchasGBLPAGESand%O GBLSECTS,usetheprefix ( ADD$.The followingexample?O5 increasestheglobalpagelimitby2000pages:O ADD_GBLPAGES%=%2000|>! +RUONotethatwhenyousetthepagefilequota,donotuseavalueOOthatexceedstheamountofpagefilespace availableontheOO5system.'To determinetheamountofpagefilespace presently3O available,usethe followingcommand: O$!SHOW%MEMORY/FILES/FULLZ?+0MOAfteryoumakeallyourchanges,exitfromtheeditorandGOexecutetheAUTOGEN procedureto recalculateyoursys-HO5tem parameters.)Enterthe followingcommandattheDCLOprompt: O$8@SYS$UPDATE:AUTOGEN%GETDATA%REBOOT%FEEDBACKf@<AOWhenyouspecifyREBOOT,AUTOGENperformsanau-JOtomaticsystemshutdownandthenrebootsthesystem.)AnyLO5usersloggedontothesystemare disconnectedduringtheFO shutdown.+The automaticrebootputsthenew parameterOvaluesintoeffect.AIOTheAUTOGENUtility automaticallyadjustsvariousoftheHOsystem parametersbasedonthe consumptionof resourcesMO5sincethelastreboot.-Ifyoudonotwanttotakeadvan-FOtageofthis automatic adjustment,usethe NOFEEDBACK5O parameterontheAUTOGENcommandline. Ok$:k@SYS$UPDATE:AUTOGEN%GETDATA%REBOOT% NOFEEDBACKBsGOFormore informationaboutusingAUTOGEN,seetheVMS,OSystem Managementdocumentation.RC! R(>O1.7.2.2CSettingDynamicSystem ParameterValuesGO)UsetheSystem ManagementUtility(SYSMAN)tosetdy-BOnamicsystem parameters.,Dynamic parameterschanged!zb PARAMETERS%USE&ACTIVEOSYSMAN>)z PARAMETERS%SET& CLISYMTBL%300OSYSMAN>#z PARAMETERS%WRITE%ACTIVEO9SYSMAN>z9EXITcD! h91O1.7.3BProcessQuotasand PrivilegesJO4TheaccountyouusetoinstallVDEmusthave sufficientOOquotasand privilegestoenableyoutoperformthe installa-MOtion.*VDErequiresno particulurprocessquotasforproductPO= installation,otherthanthoserequiredforanyPSCI installa-POtion.'For informationonPCSI installationandprocessquotas,O reference9 OpenVMSSystem Manager'sManual:' Essentials . p_UsNote p_ETheabove statementonlyappliestothe installationQaccount..SeeQTable3-1&9Qforthequotavaluesre-Gquiredforthe individualaccountsofusers performing" operationswithinVDE. L*De?hElIOUseraccountquotasarestoredinthesystem authoriza-FOtiondatabasefile./UsetheOpenVMS AuthorizeUtilityCO5 (AUTHORIZE)toverifyandchangeuseraccountquo-GOtas.,Touse AUTHORIZE,logintoa privilegedusernameHOandsetyourdefault directoryto SYS$SYSTEM,thenrunO> AUTHORIZE: O$"SET%DEFAULT& SYS$SYSTEM O $ RUN% AUTHORIZEOSUAF>FzEOAttheUAF>prompt,entertheSHOWcommandwithanJOaccountnametochecka particularaccount.'Forexample:OaUAF> aSHOW%HOFFMANG HOTochangeaquota,entertheMODIFYcommand.)Thefol-HOlowingexamplechangestheFILLMquotaandthedefaultLO5and authorized privilegesfortheHOFFMANaccount;itthen$Oexitsfromtheutility:OUAF>O MODIFY%HOFFMAN& /FILLM=50%/DEFPRIVILEGES=TMPMBX%/PRIVILEGES=TMPMBX3OZ%UAF-I-MDFYMSG,%user% record(s)%updatedOUAF> EXIT O$HsPOAfteryouexitfromtheutility,thesystemdisplaysmessagesMO indicatingwhichparts,ifany,ofthesystem authorizationJO5databasewere modified.(Oncethechangeshavebeenmade,LOall processesundertheusernamemustlogoutandlogin@Oagainforthenewquotavaluestotakeeffect.INKOFormore informationon modifyingaccountquotas,seetheLO descriptionofthe AuthorizeUtilityintheOpenVMSSystem$O5 Managementdocumentation.wJM0O1.7.4BBackingUpYourSystemDisk 15*4Caution 615FIfaversionofVDEis installedonandrunningonEthesystem,itmustbeshutdownpriortoperform-@iingthebackup,andmustremainshutdownwhen( performingtheVDEupgrade. OOAtthe beginningofthe installation,PCSIasksifyouhave)Obackedupyoursystemdisk.# Digital recommendsthatIO\ youperformasystemdiskbackuppriortoanysoftwareO installation.,KHOUsethebackup proceduresthatare establishedatyourLOsite.,Fordetailson performingasystemdiskbackup,seeJO5thesectionontheBackupUtilityintheOpenVMSSystem$O Managementdocumentation.<L [;O 2.2 InstallingOpenVMS Development EnvironmentIOThischapterexplainshowtoinstallOpenVMS DevelopmentO Environment(VDE).SSection2.2#containsa step-by-step8OB descriptionofthe installation procedure.*LS?Ov O+O2.2BThe Installation ProcedureOOUTheVDE installation procedureconsistsofaseriesofques-.Otionsand informational messages.P! HOToabortthe installation procedureatanytime,press C ETCTRL/Y ET  .OWhenyoupress  TCTRL/Y T 7,the installation proceduredeletesallSO5filesithascreateduptothatpointandexits.*Youcanthen*Ostartthe installationagain.Qo `m:mInvokePCSIusingthePRODUCTINSTALLcom-mand.3VPRODUCT*INSTALL+VDE/SOURCE=SYS$SCRATCH:RMOPSCIwill automaticallyinstallthe appropriatekitforthe@Ocurrentplatform(OpenVMSAlphaorOpenVMSVAX).CS oIOIfyouhavenot installedthePCSI transitionkitsforAOtheOracleRdb7,DECCMSand/orDECNotesprod-HO5ucts,orifyouhavenotalreadybrute-force-registeredAOthese pesky prerequisiteproductsviathe OpenVMS6O"@SYS$UPDATE:PCSI$REGISTER_PRODUCT,butyouMO>arecertainyouhavethecorrectproductversions installedKOonthesystem,youcansafelyignorethe followingdire-LOsoundingwarningmessagesandcansafelycontinuewiththe:OHOpenVMS Development Environment installation:OO%PCSI-W-SFTREFWRN,% referenced%product&DEC%VAXVMS%RDB&not%found0Ofor%product%DEC%VAXVMS&VDE%V1.5-0ZO] Terminating%is%strongly% recommended.KDo&you%want&to& terminate?%[YES]%nOO%PCSI-W-SFTREFWRN,% referenced%product&DEC%VAXVMS%CMS&not%found0Ofor%product%DEC%VAXVMS&VDE%V1.5-0ZOV Terminating%is%strongly% recommended.KDo&you%want&to& terminate?%[YES]%nT[LOTheabovemessagesmaybe displayedtwiceduring installa-Otion.uUK5OAnexample installationisincludedinAppendixB.*UFOz.66zjV \U;Tk$! F 2H,/0(|(/1v 2|5678<T=:T@B2C pq> CZrLhvr)