z R VDE VDE Reference ManualKVDE_MANUAL_NAME_2  Contents  Tables DIndexB*DECdocument V3.2nl*/ gCONTENTSCONTENTS8 E\TitlePageTitle Page@E\ CopyrightPageCopyright Page 1xE\PrefacePreface Pg""$K1 IntroductiontoVDE1 Introduction to VDEGw! $K1.1&KUsingVDE1.1 Using VDEnl$22$@1.1.1EnteringVDEandVSCCommands1.1.1 Entering VDE and VSC CommandsMl  $A1.1.1.1InvokingVDE1.1.1.1 Invoking VDE!kl#00$A1.1.1.2EnteringCommandsfromDCL1.1.1.2 Entering Commands from DCL%[l''$A1.1.1.3Using Abbreviations1.1.1.3 Using Abbreviations(El$A1.1.2UsingHELP1.1.2 Using HELP)Sw' $K1.2&KCommandSummary1.2 Command Summary+fg ..$K2VDECommandsInvokedfromDCL2 VDE Commands Invoked from DCL3)g  EKVDEVDE47g EK VDE/DEPENDVDE/DEPENDL;r EK VDE/READ_UAFVDE/READ_UAFZ9g EL VDE/WHEREISVDE/WHEREISd)g  EKVSCVSCuTg$$$K3VDECommand Reference3 VDE Command Reference%g  EK@@HgEKACCEPT REPLACEMENTACCEPT REPLACEMENT/gEKATTACHATTACH-gELBUILDBUILDDgEKCANCEL DIRECTORYCANCEL DIRECTORY:g EKCANCELFOLDCANCEL FOLD8g EKCANCELLOGCANCEL LOGFgEKCANCEL PRIVILEGESCANCEL PRIVILEGESHgEKCANCEL REPLACEMENTCANCEL REPLACEMENT@gELCANCELSESSIONCANCEL SESSION >gEKCANCELVERIFYCANCEL VERIFY1gELCOMPILECOMPILEBgEKCONVERTLIBRARYCONVERT LIBRARY'+gEKCOPYCOPY2JgEKCREATE ARCHITECTURECREATE ARCHITECTURE?@gEKCREATECONTEXTCREATE CONTEXTMNr  EKCREATEDIRECTORY_TREECREATE DIRECTORY_TREE_BgELCREATEFACILITYCREATE FACILITYt:g EKCREATEFOLDCREATE FOLD<g EKCREATEGROUPCREATE GROUP@gEKCREATELIBRARYCREATE LIBRARY>gEKCREATEMODULECREATE MODULEHgEKCREATE REPLACEMENTCREATE REPLACEMENT$>gELCREATESCRIPTCREATE SCRIPT/@gELCREATESESSIONCREATE SESSIONQ:g EKCREATESTEPCREATE STEP\>gEKCREATESTREAMCREATE STREAMu:g EKCREATEUSERCREATE USER?gEKDEFINE/COMMANDDEFINE/COMMAND7g EK DEFINE/KEYDEFINE/KEY?gEKDELETE/COMMANDDELETE/COMMAND7g EL DELETE/KEYDELETE/KEYJgELDELETE ARCHITECTUREDELETE ARCHITECTUREDrEKDELETE BUILD_JOBDELETE BUILD_JOB@gEKDELETECONTEXTDELETE CONTEXT BgEKDELETEFACILITYDELETE FACILITY:g EKDELETEFOLDDELETE FOLD!FgELDELETE GENERATIONDELETE GENERATION.<g ELDELETEGROUPDELETE GROUP@>gEKDELETEMODULEDELETE MODULEMHgEKDELETE REPLACEMENTDELETE REPLACEMENTZ>gEKDELETESCRIPTDELETE SCRIPTl:g EKDELETESTEPDELETE STEP>gELDELETESTREAMDELETE STREAM:g ELDELETEUSERDELETE USER9g EK DIFFERENCESDIFFERENCES+gELEXITEXIT@gEKEXTRACTSCRIPTEXTRACT SCRIPT-gEKFETCHFETCH+gEKHELPHELPFgEKINSERT GENERATIONINSERT GENERATION>gELINVOKESCRIPTINVOKE SCRIPT0+gELLINKLINKKJgEKMODIFY ARCHITECTUREMODIFY ARCHITECTUREVDrEKMODIFY BUILD_JOBMODIFY BUILD_JOBd@gEKMODIFYCONTEXTMODIFY CONTEXTyBgEKMODIFYFACILITYMODIFY FACILITY:g ELMODIFYFOLDMODIFY FOLDFgELMODIFY GENERATIONMODIFY GENERATION<g EKMODIFYGROUPMODIFY GROUP@gEKMODIFYLIBRARYMODIFY LIBRARY>gEKMODIFYMODULEMODIFY MODULEHgEKMODIFY REPLACEMENTMODIFY REPLACEMENT)HgELMODIFY RESERVATIONMODIFY RESERVATION>>gEKMODIFYSCRIPTMODIFY SCRIPT\@gEKMODIFYSESSIONMODIFY SESSIONy:g ELMODIFYSTEPMODIFY STEP>gEKMODIFYSTREAMMODIFY STREAM:g EKMODIFYUSERMODIFY USERJgEKPERFORM REPLACEMENTPERFORM REPLACEMENTBgEKPOPULATESTREAMPOPULATE STREAMHgEKREJECT REPLACEMENTREJECT REPLACEMENTFgELREMOVE GENERATIONREMOVE GENERATION 1gEKREPLACEREPLACE1gEKRESERVERESERVEgDrEKREVIEW BUILD_JOBREVIEW BUILD_JOBXg&&EKReviewBuildJobCommandsReview Build Job CommandsHgEKREVIEW REPLACEMENTREVIEW REPLACEMENT[w''ELReview ReplacementCommandsReview Replacement CommandsBwEKScriptKeywordsScript KeywordsDwEKScript FunctionsScript Functions<w EKScriptTypesScript Types:DgEKSET ARCHITECTURESET ARCHITECTUREG:g EKSETCONTEXTSET CONTEXTN>gEKSET DEVELOPERSET DEVELOPER\>gEKSET DIRECTORYSET DIRECTORYc8g ELSETEDITORSET EDITOR{<g ELSETFACILITYSET FACILITY2gEKSETKEYSET KEY:g EKSETLIBRARYSET LIBRARY2gEKSETLOGSET LOG<g EKSETNOVERIFYSET NOVERIFY@gELSET PRIVILEGESSET PRIVILEGES8g ELSETPROMPTSET PROMPT8g EKSETSTREAMSET STREAM<g EKSETTERMINALSET TERMINAL8g EKSETVERIFYSET VERIFYFgEKSHOW ARCHITECTURESHOW ARCHITECTURE@rELSHOW BUILD_JOBSHOW BUILD_JOB<g ELSHOWCONTEXTSHOW CONTEXT>gELSHOWDEFAULTSSHOW DEFAULTS@gELSHOW DEVELOPERSHOW DEVELOPER$@gEKSHOW DIRECTORYSHOW DIRECTORY*:g EKSHOWEDITORSHOW EDITOR6>gEKSHOWFACILITYSHOW FACILITY>6g EKSHOWFOLDSHOW FOLDKBgELSHOW GENERATIONSHOW GENERATION[8g ELSHOWGROUPSHOW GROUP4g EKSHOWKEYSHOW KEY<g EKSHOWLIBRARYSHOW LIBRARY>gEKSHOWLOCATIONSHOW LOCATION4g EKSHOWLOGSHOW LOG:g ELSHOWMEMORYSHOW MEMORY:g ELSHOWMODULESHOW MODULEBgEKSHOW PRIVILEGESSHOW PRIVILEGESDgEKSHOW REPLACEMENTSHOW REPLACEMENTDgEKSHOW RESERVATIONSHOW RESERVATION:g EKSHOWSCRIPTSHOW SCRIPT <g EKSHOWSESSIONSHOW SESSION4 6g EKSHOWSTEPSHOW STEPJ :g ELSHOWSTREAMSHOW STREAMY :g ELSHOWSYMBOLSHOW SYMBOLi >gEKSHOWTERMINALSHOW TERMINALq 6g EKSHOWUSERSHOW USERx :g EKSHOWVERIFYSHOW VERIFY <g EKSHOWVERSIONSHOW VERSION -gELSPAWNSPAWN BrELSTART BUILD_JOBSTART BUILD_JOB @rEKSTOP BUILD_JOBSTOP BUILD_JOB BgEKSTOP SUBPROCESSSTOP SUBPROCESS FrEKSUSPEND BUILD_JOBSUSPEND BUILD_JOB 5g EK UNRESERVEUNRESERVE FgEKVERIFY GENERATIONVERIFY GENERATION @rELWAIT BUILD_JOBWAIT BUILD_JOB b/ $\A$\ AssociatedLogicalNamesA Associated Logical Names j3 $\B(\ RecordingBuild DependenciesB Recording Build Dependencies GwEQLIB$REC_DEPENDENCYLIB$REC_DEPENDENCY Ux( $\C\Callable InterfaceC Callable Interface5 AwEPVDE$FetchModuleVDE$FetchModule: E|EPVDE$ReplaceModuleVDE$ReplaceModuleK A|EPVDE$SetFacilityVDE$SetFacility] ?|EQVDE$SetLibraryVDE$SetLibraryo =wEQ VDE$SetStreamVDE$SetStream GwEQVDE$ShowFacilitiesVDE$ShowFacilities C|EPVDE$ShowProjectsVDE$ShowProjects A|EPVDE$ShowLibraryVDE$ShowLibrary AwEPVDE$ShowModulesVDE$ShowModules AwEQVDE$ShowStreamsVDE$ShowStreams IwEQVDE$UnreserveModuleVDE$UnreserveModule Z+ $\D \CMSLibraryUploaderD CMS Library Uploader M$ $\E\ErrorMessagesE Error Messages +gTABLESTABLES@l=@3-1KeyNames3- 1 Key Names;\ =A3-2Reasons3- 2 ReasonsQFl=@3-3ScriptTypes3- 3 Script TypesCA\=A3-4 Parameters3- 4 ParametersaAl=A3-5 Privileges3- 5 PrivilegesHl=AA-1LogicalNamesA- 1 Logical Names Nl  =AB-1 DependencyCodesB- 1 Dependency Codes J\=@C-1ItemlistCodesC- 1 Itemlist Codes8 Pl!!=@D-1 VDE$UPLOADSyntaxD- 1 VDE$UPLOAD Syntax  *_5 O]VDE OVDEOf ReferenceManual ODecember1997TOJThisisa referencefortheOpenVMS Development Environment(VDE)VOsourcecodecontrolandsourcecodebuilderpackage.(This referenceQOprovidesdetailsoftheOpenVMS Development Environmentandthe\O3OpenVMSSourceControl utilities;these utilitiesareusedwithinvariousNODigital engineering organizations includingtheOpenVMSgroup.,'ORevision/Update Information:,^Thismanual supersedestheVDE-^ ReferenceManual,Version1.5-0.c9OSoftwareVersion:^VDEVersion1.5-0,o%O OperatingSystemVersion:&^OpenVMSAlphaVersion6.2$^OpenVMSVAXVersion6.2**t #J)ODigital Equipment Corporation!O Maynard, Massachusetts   O O"O  11-DEC-1998 17:41:52.61 O.O Copyright 11-DEC-1998 17:41:52.61aOThe 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.hO0Allother trademarksand registered trademarksarethepropertyoftheir respectiveOsholders.* U  ; OPreface   OIntendedAudienceNOUThismanualisintendedforuserswhowanttoknowhowto6OusetheOpenVMS Development Environment. O Associated Documents `UUGuidetoUsingVDE `6VDE InstallationandNewFeaturesGuide 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.? [#O 1.2 Introduction!to!VDEBOTheOpenVMS Development Environment(VDE) utilitiesAOassistOpenVMS engineersinmanagingthesoftwareOB developmentprocess..BOThis is!the VDE reference!manual.4For a completeCO introduction,"overview of the VDE package,"and!forHO5 informationoncommonly performedVDEtasks,pleasesee Othe GuidetoUsingVDE .`EOVDEcommandsenableOpenVMS engineerstoperformtheO followingtasks:  `mEmCreate,modify,display,anddelete informationinaAVDEdatabasesuchasthatusedbyOpenVMS.ThisC information includestheusers, facilities,!modules,Dw developmentstreams,groups,andotherentitiesthatIdefinethesoftwaresystemthatyouwanttomanageand(build. `MDefine,set,andshowcurrentcontextanddefault settings. `'H'Buildasoftwaresystem.'VDEcanperformbothcompleteEandminimalsystembuilds./Inacompletebuild,allEmodulesinthesoftwaresystemare compiled,linked,D0and otherwise processed.-Inaminimalsystembuild,KonlythosemodulesthathavebeenchangedsincethelastAsystembuildare compiled,linked,and processed. `a@aReservesourcemodulesfromtheVDElibraryand;replacethemaftertheyhavebeen modified. `9B9Collectandreportsoftware development statistics. `ITransfercontroltoanotherprocesswhilestillinVDE.DUsers typicallyinteractwiththeVDEpackageusing>ieithertheVDEortheVSCDCL commands.0BothEcommandshave equivilent capabilities,thoughtheVSCJdefaultsare specificallytailoredtothe requirementsofsOpenVMS engineering.]JOVDEis implementedasasetofimages,andseveralDCLO commands. O1.1BUsingVDEJOUThissection describeshowtoentercommandsfromwithinOOtheutilityorfromtheDCLcommandline.)Italso describes1OhowtousetheVDEhelp facility.A 2O1.1.1BEnteringVDEandVSCCommandsHO4YoucanenterVDEcommandsineitheroftwoways:,byTOinvokingtheutilityandallowingittopromptforinput,orbyIO includingthecommanddirectlyontheDCLcommandline.GOTherearetwoVDE interfaces supportedwithintheVDEIOpackage:,theVDE interface,andtheVSC interface.+BothDO5 interfacessupportthesamecommandverbs,andbothOfunction similarly. WHOTheonlysalient differencesbetweenthetwo interfacesPOinvolves differencesinthe invocationdefaultsandthepromptNO5string:,VDEisageneral interfaceanddoesnotdefaulttoMOa particularsourcecodelibrary,whileVSCis specificallyEOtailoredforusers accessingtheOpenVMSsourcecodeEO> librariesandsetsitslibrarydefaultappropriately.NQOSaveforthedefaultoptionsandcosmeticaspectssuchastheGOcommandpromptstring,theVDEandVSC interfacesare>O5fully compatibleandarefullyinterchangeable.7   NONotethatcertain qualifierspresentontheVDE utility-suchBOas VDE/READ_UAFandVDE/STATUS-mayinvoke utilitiesOO5otherthantheVDEutility.'TheremaybenoVSC equivilents.OtosomeoftheseVDE utilities.!c O1.1.1.1CInvokingVDEGO)ToinvoketheVDEutility, entertheVDEortheVSCCOcommandattheOpenVMSDCLprompt( $ ).,OpenVMSFOrespondswiththe appropriatepromptfortheutility. O_ $ _VDEO VDE> EXIT O $ VSCO7 VSC> 7EXIT O $y"bOHOOncethecommandhasbeeninvoked,youthencanenterJOcommandsattheVDEprompt.*Forexample,todisplaytheEO5defaultVDElibrary,entertheSHOWLIBRARYcommand:O VDE> SHOW%LIBRARYEO Main&library%LIBNAME%in%root& directory%DEV$:[PROJDIR]OI VDE>#! KOYouarereturnedtotheVDEpromptwhenthecommandhasFOexecutedandyouthencanenteranotherVDEcommand.$vOEndingaSessionIO4ToexitfromVDE,entertheVDEcommandEXITorpressOCTRL/Z.%! `0O1.1.1.2CEnteringCommandsfromDCLJO)ToenteraVDEcommandfromtheDCLcommandline,typeMOVDEattheDCLprompt( $ )thentypeaVDEcommandonHOthesameDCLcommandline.)The followingexampleshowsFO3howtodisplaythenameofthedefaultVDElibrary: O $VDE%SHOW&LIBRARYEO Main&library%LIBNAME%in%root& directory%DEV$:[PROJDIR] OG $ &LOYouarereturnedtotheDCLprompt( $ )whenthecom-NOmandhasbeen executed.)Forthisreason,thisformismostMO5 appropriatewhenyouonlyneedtoenterasingleVDEcom-Omand.' R\MOMultiplecommandscanbe specifiedonasingleVDEorVSCHODCLcommandlinebyusinga semicolonasa delimiter.Oa VDE>' aSHOW%LIBRARY;%SHOW%VERSIONFO Library&VMS%in%root& directory%VSC$ROOTDISK:[VMS.DBROOT]>O Executing%VDE&for%OpenVMS&Alpha&Version%V1.5-0O9 VDE>;('O1.1.1.3CUsing AbbreviationsDO)Allcommandand qualifierkeywordsforVDEcommandsMOcanbe abbreviatedtotheshortestunique abbreviation.*TheHODELETEcommand,forexample,canbe abbreviatedtoDELFO3becausenootherVDEcommandbeginswiththosethreeEOletters.,TheDELETEcommandcannotbe abbreviatedtoBODE,however,becausetheDEFINEcommandmakesthe.O< two-letter abbreviation ambiguous. _UNote _HFThenumberoflettersneededto referencea particularEVDEcommandissubjecttochangeinfuturereleasesAofVDE.DIGITALstrongly recommendsthatallVDE<PorVSCcommandsimbeddedwithincommandpro-Eceduresspecifythefullcommand.(Thisavoidserrors=shouldany particularVDEcommand abbreviationGYbecome ambiguousina potentialfuturereleaseoftheVDEpackage. l) kBO1.1.2BUsingHELPGO4TheVDE interfacescontainaHELPcommandandanex-OOtensiveonlineHELP facility.)Toobtainhelpona particularAOcommand,appendthecommandtotheHELPcommand.Oi VDE> iHELP%SHOW%VERSIONO SHOW VERSIONST Displays%the&VDE%version&string%for%the&version%of%VDE&you%areTa running.T Format SHOW&VERSION-Y Additional% information% available:* Parameters% Qualifiers&Examples"OR SHOW&VERSION% Subtopic?*OOThehelplibraryalsocontainsacompletelistofallerror?Omessagesandthe associatedrecovery procedures. +O1.2BCommandSummaryNOUThe followingtablelistsallthe availableVDEcommandsbyO functional category:O, I% OKOCreatingDatabase Information ModifyingDatabase Information OOA CREATECONTEXTA MODIFYCONTEXTO CREATE DEPENDENCY MODIFY DEPENDENCYO4 CREATEFACILITY4 MODIFYFACILITYO CREATEGROUP MODIFYGROUPO( CREATELIBRARY( MODIFYLIBRARYO CREATEMODULE MODIFYMODULEO CREATESESSION MODIFYSESSIONO CREATESTREAM MODIFYSTREAMO CREATEUSER MODIFYUSER O*@-I OLO DisplayingDatabase InformationDeletingDatabase Information OOA SHOWCONTEXTA DELETECONTEXTO SHOW DEPENDENCY DELETE DEPENDENCYO4 SHOWFACILITY4 DELETEFACILITYO SHOWGROUP DELETEGROUPO( SHOWLIBRARY( DELETELIBRARYO SHOWMODULE DELETEMODULEO SHOWSESSION UNRESERVE/SESSIONO SHOWSTREAM DELETESTREAMO SHOWUSER DELETEUSER O*. O,OSettingthe DevelopmentContext OOA SHOWDEFAULTSA SETSTREAMO SETLIBRARY SET PRIVILEGESO4 SHOWLIBRARY4 CANCEL PRIVILEGESO SETCONTEXT SHOW PRIVILEGESO( SETFACILITY( RESERVE/SESSIONO CREATECONTEXT MODIFYCONTEXTO SHOWCONTEXT DELETECONTEXTO SHOWSESSION UNRESERVE/SESSION O/ OO ReservingModulesBuildingtheSystem OOA RESERVEA BUILDO REPLACE COMPILEO4 UNRESERVE4 LINKO FETCH TEST O0 O)ODefining Directory Structures OOA SET DIRECTORYA CANCEL DIRECTORYO SHOW DIRECTORY  CREATEDIRECTORY_TREE O61  OOModeSettings OOA SHOWALLA SETVERIFYO SETLOG SETNOVERIFYO4 CANCELLOG4 CANCELVERIFYO SHOWLOG SHOWVERIFYO( SETTERMINALO SHOWTERMINAL O2c OO TailoringVDE,Exitingor TransferringControl OOA DEFINE/COMMANDA HELPO DELETE/COMMAND  @# file-nameO4 SHOWSYMBOL4 SPAWNO DEFINE/KEY ATTACHO( DELETE/KEY( EXITO SETKEYO SHOWKEYO SETPROMPT OsY3%//O 2.2VDE!Commands!Invoked"from!DCLV&>LO VDE/DEPEND*MN ?KOInvokesaprogramthat automaticallycollectsbuilddepen-MO(dency informationfromacompiler-generatedanalysisfiletoCO determinetheinputsandoutputsofabuildstep.AOThiscommandshouldonlybeinvokedinDCLcom-AOumand procedurescreatedfromVDEscriptstoper-GOformbuildsteps.'DonotattempttorunthisprogramO&interactively.OVOFormatFOs VDE/DEPENDNlangana-file [in-out-file[,in-out-file...]]BPO ParametersOslangGOThenameofthelanguage processorthat generatedtheMO$SourceCodeAnalyzeranalysisfile.*Thisisarequiredpa-GO|rameter.+Keywordsforthe supportedlanguage processorsOareasfollows:RQJ ( O&OKeywordhLanguage Processor OOAADAAdacompilerOB32Blisscompiler O4C4Ccompiler2ODMLDBMS preprocessorsfor compilers O(FORFortrancompilerOMARMacro assembler6ONOANAXNoanalysisfilegiven(onlytheY in-out-file t parametersareused)OPLIPLIcompilerOhPASPascalcompiler-ORBARDML preprocessorforBASIC-O[RBLRDML preprocessorforBliss ORC$RDML preprocessorforC-OORCORDML preprocessorforCOBOL/ORFORDML preprocessorforFORTRAN.OBRPARDML preprocessorforPascal*OREQBlisslibrary compilation O6 SC#6 SQL preprocessorforC,O SCOSQL preprocessorforCOBOL.O) SFOSQL preprocessorforFORTRAN-O SPASQL preprocessorforPascal+O SPLSQL preprocessorforPL/I-O SQLADAHSQL preprocessorforAda'O SQLMOD#SQLmodulelanguage O+ RKVOana-fileRO(Thefile specificationfortheanalysisfile containingthede-LOpendency information.)Thisisarequired parameter.)IftheOlangK parameterisNOANA,specifytwodoublequotes( "" )toO2indicatethatthe2ana-file2 parameterisnull.S! O in-out-fileTO(Afile specificationthat specifiesaninputfileoroutputfileVOforthebuildstep.'Thefile specificationcanbefollowedbytheRO/INPUT qualifiertoindicatethatthefileisaninputtotheRO2steporbythe/OUTPUT qualifiertoindicatethatthefileis[Oanoutputofthestep.'Ifneither qualifieris specified,thefileisROassumedtobeaninputfile.'This parameterisusedtorecordWO<inputandoutputfilesthatarenot specifiedintheanalysisfileROorthatarenot correctly classifiedasinputsoroutputsfrom4Othe informationintheanalysisfile.T! O DescriptionAOsThe VDE/DEPENDcommandinvokesaseparateprogramMOthat automaticallycollectsbuild dependency informationfromFO$acompiler-generatedSourceCodeAnalyzer(SCA)analy-EO|sisfile.*The VDE/DEPENDcommandisusedincommandHO procedures generatedfromVDEscriptstocompilesourceKO-modules.*Theprogramreadstheanalysis(.ANA)filealongMOwith information specifiedonthecommandlineto determineQOallinputandoutputmodulesforthecurrentbuildstep.(ThisPO7 informationiswrittentotheVDEdatabaseifthebuildstep"O completes successfully.OU! %QOTheanalysisfile specifiesallinputandoutputfilesoftheOO compilationbutdoesnotindicatewhichfilesareinputsandFO5whichfilesareoutputs.+ VDE/DEPEND thereforerequiresOOthatyouspecifythelanguagethatwascompiledsothattheOOprogramcanguesswhichfilesareinputsandwhichareout-UO>putsbasedonfiletypes.)Asaresult,itis importantthatyouLOusethestandardfiletypesforallofyour compilations.rV HBOBecause theanalysis file and command line supplyHO VDE/DEPENDwithalistoffilenames,VDEmusttrans-MO5latethosefilenamesintoVDEmodulenamesbeforeitcanQOrecordbuild dependenciesinits database.(Todoso,VDEuses Othe followingrules:WW 5- `mDmVDEassumesthattheVDEmodulenameandtypeareNthesameasthefilenameandtypefromtheanalysisfileorcommandline. `PVDElooksupthefull directory specificationofthefileinKtheVDE database.*Ifthat directoryisa subdirectoryinJOtheVDE directorytreeforthestreambeingbuilt,thenHVDEcan determinethefacilityofthemodule.*Thefa-Ocilityis determinedfromthepartofthe directorytreein&Ywhichthefileisfound. `EOncethe facility,modulename,andmoduletypeareE0 determined,themodulecanbelookedupintheVDEM database.(IfthemoduleisanoutputmoduleforthebuildIstepandthemoduleisnotfoundinthe database,VDEC:addsittothedatabaseasanewderivedmodule. `MIfthefull directory specificationcannotbefoundintheGVDE database,themoduleisassumedtobeoutsideofLjyourVDElibraryandisignored.(Asaresult,inputmod-Kulesfromsystem libraries,forexample,areomittedfrom#VDE's dependencygraph.X WQOAsaresultoftheserules,itis importantthateachsourceJOmoduleorderivedmodulebestored somewhereinthedi-QO5rectorytreeforthestreamyouarebuildingand,withinthatTOstream,forthefacilitytowhichthemodulebelongs.'ThisisaQO constraintthatyourscriptsmustobey;withinthat constraint,DO>scriptsarefreetoplacefilesanywhereyouwant.1 Y[  OExamples O1.6$&DEFINE%SRC$&DEV$:[ROOTLIB.MAIN.FAC.SRC]6$&DEFINE%OBJ$&DEV$:[ROOTLIB.MAIN.FAC.OBJ]0H$&VDE%FETCH%[FAC]FOO.C/OUTPUT=SRC$:/$&CC/ANA=OBJ$:/OBJ=OBJ$:K SRC$:FOO.C($& VDE/DEPEND%C% OBJ$:FOO.ANACGThisexampleshowsthelines generatedfromaVDEJscripttocompilemoduleFOO.C.Thefirsttwolinesde-KfinelogicalnamesSRC$andOBJ$topointtothesourceIQandobject directoriesforstreamMAINandfacilityFACGwithintheVDElibrary.,ThethirdlinefetchessourceCmoduleFOO.CfromtheVDElibraryintothesourceGZ directory.+ThenextlinerunstheC compiler,compil-DingmoduleFOO.CtoproduceanobjectfileFOO.OBJG andanSCAanalysisfileFOO.ANA.ThelastlinerunsEd VDE/DEPENDtoreadthatanalysisfile.(Frominforma-Ftionintheanalysisfile, VDE/DEPEND determineswhatHinputfileswereusedandwhatoutputfileswerepro-Knducedbythe compilation.'This informationwillbepassed:toVDEfor inclusionintheVDE database. O>2.II$& VDE/DEPEND%REQ&OBJDIR:LIBDEF.ANA&OBJDIR:LIBDEF.L32/OUTPUT?Whenthecommand procedure containingthisline@  executes, VDE/DEPENDwillreadtheanalysisfileAi OBJDIR:LIBDEF.ANAto determinetheinputandout-G putmodulesofaBlisslibrary compilation.,BecauseaF Blisslibrary compilationproducesone.L32moduleasEs anoutputandmayusemany.L32modulesasinputs,> the VDE/DEPENDcommandlinemustspecifywhichM$ .L32moduleistheoneoutput.(Thisisdoneby specifyingC| OBJDIR:LIBDEF.L32withthe/OUTPUT qualifierattheF endofthecommand.(Thisisanexampleofusingan X in-- out-file;%-  parametertooverridethedefault assumptionO thatamoduleofthattypeisaninputtothe compilation. O 3.N $& VDE/DEPEND%NOANA%""%*SRCDIR:FOO.MSG/INPUT,OBJDIR:FOO.EXE/OUTPUT>w Thisexampleshowshow VDE/DEPENDcanbeusedF tospecifyinputandoutputmoduleswhennoanalysisJ)fileis available.)ThemessagecompilerdoesnotproduceJananalysisfile.*Forthisreason,thecommandusestheDNOANAkeywordand specifiesthenullstringastheL2analysisfile parameter.(Theactualinputandoutputfiles)are specifiedbyalistof9 in-out-file parametersatthe endofthecommand. @ZO VDE/READ_UAF*[\ ALOUpdatestheUserTableinaVDEdatabasefrom information?O(inthesystemuser authorizationfile (SYSUAF).\]2OFormat"OsVDE/READ_UAF[/WRITE_UAF]^! _O DescriptionCOsThe VDE/READ_UAFcommandinvokesaseparateprogramMOthatupdatestheUserTableinaVDEdatabasefrominfor-LO$mationinthesystemuser authorizationfile (SYSUAF).ForLO|eachuserrecordedintheVDE database,theprogramlooksNOupthatuserintheUAFto determinetheuser'sfullnameNO-fromtheUAFownerfield.)ThatnameisthenstoredintheJOVDEdatabaseifnotalreadythere.+Theprogramalsode-SOtermineswhethertheuser'saccountisstillvalid.(Ifnot,theNO7userismarkedasdeletedintheVDEdatabasesothatthe?Odatabaseisnolonger accessibletothatuser.@O+The VDE/READ_UAFcommandalsosupportsa/WRITE_AOUAF qualifier.* SpecificationofVDE/READ_UAF/WRITE_LOUAFcausesVDEtoupdatetheprocessquotavaluesofallIO4VDEusersintheSystem AuthorizationDatabase (SYSUAF).FOAnyprocessquotasbelowtheminimumVDE requirementsOOare increased,butquotasabovetheminimumarenotaltered.LO>The /WRITE_UAF qualifierisvalidonlywhen specifiedwithJO /READ_UAF,anditrequiresreadandwriteaccesstotheOSYSUAF database.A_! JO VDE/READ_UAFcanberunatregular intervalstomaintainJOtheVDEdatabasesoitstays synchronizedwiththesys-KO5tem authorization database.+Thisway,youdonothavetoFOmanuallymaintaintheVDEUserTablewiththeCREATE SpecificationofthethetargetVDElibraryisrequiredviatheMO/LIBRARY qualifieronthecommand,orviathelogicalnameO VDE$LIBRARY.`B IOTousethiscommand,youmusthavereadaccesstotheGOSYSUAFsystem authorizationfile.-AccesstothesystemHO5 authorizationfilecanbegrantedviaOpenVMSanpriv-FOilegesuchasREADALLorBYPASS,viaanACLontheGOSYSUAFfile,orviavariousothermeans.-Contactyour+O>systemmanagerfor assistance.O= =O= =OH= =O= =O= =OR= =O= =O= =O[= =O= =O = =Oe= =O= =O= =Oo= =O= =O = =Ox= =O= = O) =Sa)O QualifiersOs/DELETEDOThe/DELETE qualifiercausesVDEtodeleteanyVDELO$ usernamesthatarenotalsofoundinSYSUAF.ThisisnotJO| generally desirable,andcan potentiallyleadtoproblems*OshouldSYSUAFbe misdirected.sb 6 IO /WRITE_UAFHO(The /WRITE_UAF qualifiercausesVDEtoupdateanypro-LOcessquotasstoredintheSYSUAFfilethatarebelowtheIOrequiredminimumsettingstotheminumum settings.(QuotaCO2valuesabovetheminimumsettingsarenotaltered.O= =O= =O<= =O= =O= =OE= =O= =O= =OO= =O= =O= =OY= =O= =O = =Ob= =O= =O= =Ol= =O= = O =cOExample O $'SET%PROCESS/PRIVILEGE=BYPASS O $9/VDE/READ_UAF/WRITE_UAF/LIBRARY=DEV$:[VDELIBDIR] OC $)CSET%PROCESS/PRIVILEGE=NOBYPASSEOThefirstcommandsetstheOpenVMS privilegeBYPASS,LO which overridesall protectionsonthesystem authorizationAOc database.+Thesecondcommandruns VDE/READ_UAFtoKOupdatetheVDEdatabasefromtheuser authorizationfile,JOandthesystem authorizationdatabaseprocessquotasfromROmthelistofusersintheVDE database.(Thefinallineremoves0OtheBYPASS privilegetocleanup.#?dO VDE/WHEREIS*e*fLOInvokesautilitythat retrieves site-specific configuration!O( informationfromVDE.GONodirectaccessnordirect retrievalofanyunderly-AOing configuration informationshouldbe performed,4Ounorshouldthe underlying VDE$LIBRARY_ *\ulogical>Onamesbe translateddirectlybycommandproce-CO&dures,norshouldsoftwaredependonthe continued:O~ accessabilityofthe underlying information.Og%OFormatOs VDE/WHEREIShUO DescriptionBOsThe VDE/WHEREIScommandinvokesaseparateutilityIOthat retrieves site-specific configuration informationas-GO$sociatedwithaVDElibrary.+ThecommandreturnssuchKO| informationastheVDEmnemonicnameandlocationoftheHORdbdatabaseandCMS libraries associatedwiththeVDEBO-library., VDE/WHEREIScanbeusedfromthecommandMOlineorwithinDCLscriptsto facilitatelibrary managementLO operations independentofspecific configuration information.i WGO VDE/WHEREISreturns configuration informationviaasetOof VDE$WHEREIS_/ info-item.localsymbolsorprocesslogicalKO5names.)Whethersymbolsorlogicalnamesareusediscon-LOtrolledbythe/RETURN qualifier.(Thelocalsymbols/processGOlogicals currentlydefinedby VDE/WHEREISare describedO>below:(j  O-* VDE$WHEREISSymbols/LogicalNames OOAVDE$WHEREIS_MNEMONIC=zVDE shorthandname associatedwithadatabase%O4VDE$WHEREIS_BACKUPS_CURRENT;zLocationofthelatestRdbdatabasebackups%O(VDE$WHEREIS_BACKUPS_ARCHIVE=zLocationofthearchivalRdbdatabasebackups)OVDE$WHEREIS_BACKUPS_AFTER_IMAGEAzLocationoftheRdbdatabase after-imagejournalsOVDE$WHEREIS_CMSBzRoot specificationoftheCMS libraries associatedzwithadatabaseO[VDE$WHEREIS_DATABASE8zLocation(root)oftheRdbdatabasefileOOVDE$WHEREIS_LABELAzVDEtextlabel(remarkstring) associatedwithaz!database!OVDE$WHEREIS_BACKUP_INCR=z FilenameofcurrentRdbdatabase incrementalzm backupsaveset!O VDE$WHEREIS_BACKUP_FULL>za FilenameofcurrentRdbdatabasefullbackupz saveset O3 VDE$WHEREIS_STATISTICSAz  SpecificationoftheVDE statisticsdatabasefileO& VDE$WHEREIS_STAGING@z Location(root)whereVDEstageslibrarychangesO VDE$WHEREIS_BUILD2z Forfutureuse/notfully implemented O kBOWheninvoking VDE/WHEREIS,youmustspecifyaVDEKOlibrary,eitherviathe/LIBRARY qualifierwithalibraryIO5mnemonicorroot,orviathe/INDEX qualifierwiththeOlibraryindex.=l! O QualifiersOs/INDEX=library-indexO/LIBRARY=library-specAO$The/INDEXand/LIBRARY qualifiersto VDE/WHEREISTO|areusedtoidentifyaVDElibraryforwhichtheutilityshould-Oreturn configuration information.>m! TOThe/INDEX qualifierisusedtoidentifyalibrarybyindex,orWObytheoffsetintothelistofall availableVDE librariespresentVO5onthesystem.)Thefirstlibraryinthelisthasanindexof0.MOThis qualifiercanbeusedtoobtain configurationinforma-SOtionforallVDE librariesonagivensystem,bystartingwithEO>index0and incrementingtheindexuntil VDE/WHEREIS.O completeswithafailurestatus.!n HOThe/LIBRARY qualifierto VDE/WHEREISisusedtoiden-LOtifyaVDElibraryviaeitherthe shorthandmnemonicnameQO5orthedatabaseroot directory,justaswiththestandardVDEOcommand.4o DOThe/INDEXand/LIBRARY qualifiersaremutuallyex-OOclusive.+Ifbothare specifed,the/INDEX qualifierisused.3O5Oneofeither/INDEXor/LIBRARYis5 required,5withtheO VDE/WHEREIScommand.p O/LOGLO(Controlswhether informationalmessagesareprintedtodis-POplaythe requestedlibrary informationasitis retrieved.*By/Odefault,nomessagesareprinted.DqKO/RETURN=keywordIO(The/RETURN qualifierisusedtospecifythemethodinNOwhich site-specificlibrary informationshouldbereturnedtoDOthecaller.*The qualifieracceptsthe followingtwo` keywordO2 parameters:rhm `mDmSYMBOLS-the requested informationisreturnedvia+thelocalsymbols VDE$WHEREIS_ info-item.(Thisisthedefault behavior. `@ LOGICAL_NAMES-the requested informationisre-Aturnedviatheprocesslogicalnames VDE$WHEREIS_O info-item $O.s" |KOIfno/RETURN qualifieris specifiedwiththe VDE/WHEREIS1Ocommand,/RETURN=SYMBOLSisassumed. t;  OExamples O1.  $? VDE/WHEREIS&/LIBRARY=PROD$LIB&/RETURN=LOGICAL_NAMES  $K DIRECTORY/DATE/SINCE=10-OCT-1996&VDE$WHEREIS_CMS:[*.CMS.CMS$000]0j Directory%VMS$:[PROD$SHR.CMS.CMS$000]3 PROD$SHR.OPT;29 10-OCT-1996% 16:45:01.74 PRODDEF.H;15" 15-OCT-1996% 15:12:01.21c PRODIO.C;24"c 14-OCT-1996% 22:39:24.73 PRODUTIL.C;5" 16-OCT-1996% 16:31:00.79 D. D;. D.CThisexampleshowshow VDE/WHEREIScanbeusedtoDJretrieve informationaboutaVDE library's CMS-levelJsourcefiles,without necessarilyknowingthelocationoftheCMSlibrary. Os2.7 $& vde_lib_index%=%F$EDIT(p1,"UPCASE,TRIM")A $& VDE/WHEREIS&/INDEX='vde_lib_index'%/RETURN=SYMBOLS9. $&IF&.NOT.&$STATUS%THEN%GOTO& BCKLIB$AbortEv $&DEFINE/PROCESS&BCKLIB$DB_SOURCEp'vde$whereis_database'N $&DEFINE/PROCESS&BCKLIB$BACKUP_AREA%'vde$whereis_backups_current'L $&WRITE& SYS$OUTPUT%"% Performing&full%database%backup&for:"HM $&WRITE& SYS$OUTPUT%"''vde$whereis_mnemonic'%library&.."N $&RMU%/BACKUP&/LOG%/ONLINE%!BCKLIB$DB_SOURCE:VDE$DATABASE.RDB%-8 .MLIB$BACKUP_AREA:'vde$whereis_backup_full'.RBF?s Thisexampleshowshow VDE/WHEREIScanbeusedB withinaDCLcommand proceduretoperformafullG$ backupoftheRdbdatabase associatedwithaVDEli-L| brary, independentofthespecificlibraryorthedatabase  location. OM 3. t $*t  VDE/WHEREIS& /LIBRARY=EVMS%/LOGG VDE% Ancillary&Support%for&OpenVMS%Alpha%Version%V1.5-0D %VDE-I-WHEREIS,% component&VDE$WHEREIS_MNEMONIC&is&EVMSvL %VDE-I-WHEREIS,% component&VDE$WHEREIS_BACKUPS_CURRENT%is%/DISK$VDERDBBKP:[VDE.MASTERPACK_BACKUPS.CURRENT]r %VDE-I-WHEREIS,% component&VDE$WHEREIS_BACKUPS_ARCHIVE%is%+DISK$VDERDBBKP:[VDE.MASTERPACK_BACKUPS.OLD]} %VDE-I-WHEREIS,% component&VDE$WHEREIS_BACKUPS_AFTER_IMAGE%is%2DISK$VDERDBBKP:[VDE.MASTERPACK_BACKUPS.DB_JOURNAL]?# %VDE-I-WHEREIS,% component&VDE$WHEREIS_CMS%is%VMS$]k %VDE-I-WHEREIS,% component&VDE$WHEREIS_DATABASE&is&DISK$VDEROOT:[VDE.VMS.DBROOT]d %VDE-I-WHEREIS,% component&VDE$WHEREIS_LABEL&is&OpenVMS%Alpha%Base% Operating%System^ %VDE-I-WHEREIS,% component&VDE$WHEREIS_BACKUP_INCR&is&VDE$DATABASE$EVMS_BCKP_INCR^C %VDE-I-WHEREIS,% component&VDE$WHEREIS_BACKUP_FULL&is&VDE$DATABASE$EVMS_BCKP_FULL %VDE-I-WHEREIS,% component&VDE$WHEREIS_STATISTICS%is%BDISK$VDERDBBKP:[VDE.CHECKIN_STATISTICS]STATISTICS_DATABASE_V10.DATb %VDE-I-WHEREIS,% component&VDE$WHEREIS_STAGING%is%#DISK$VDESTAGE:[VDE.VMS.VDE$STAGING]BBThisexampleshowshowthe/LOG qualifiertotheC VDE/WHEREIScommandcanbeusedtodisplaycurrent. site-specificlibrary information.7u  OVSC*vw VVGOTheVSCcommandisacommandvariantthatbydefaultJO(providessourcecontrolservicesfortheOpenVMSVAXli-EObrary..UsetheVSCcommandtoperformthe followingO operations: `^D^ReservesourcemodulesfromtheOpenVMSVAXlibraryfor modification `6B6ReplacesourcemodulestotheOpenVMSVAXlibrary+aftertheyhavebeenmodified `BReviewsourcemodulesmodifiedbyother developers `GCreatenewmodules, facilities,and developmentstreams(intheOpenVMSVAXlibrary `eHe AdministertheOpenVMSVAXlibraryandcontrolitsuse `EDisplay informationabouttheOpenVMSsourcesinthe=OpenVMSVAXlibraryxjHOUsetheVSCHELPcommandfor additional informationon"OspecificVSC commands.yOpenVMSVAXlibrary.*(Further informationontheVDE"Ocommandis available.)z NIOVSCincludes extensivebuilt-inHELP.AttheVSC>,typeLO ``HELP''.An extensive documentationset,in Bookreaderand4O5 Postscriptformats,isalso available.f{<OFormat,OsVSCN [VDE-command][;VDE-command]|! FO DescriptionGOsTheVSCcommandperformssourcecontrol operationsforKOtheOpenVMSVAXsourcecodecontrollibrary.)ItrunstheJO$sameimageastheVDEcommandanddiffersonlyinthatKO|it automaticallyoperatesontheOpenVMSVAXlibrary,andPOnotanyoftheotherVDE librariesaround.( Therefore,attheJO-VSCprompt(VSC>),youcanenteranyvalidVDEcommand. }KOToinvoketheVSCutility,entertheVSCcommandattheNODCLprompt( $ ).(Thesystemrespondswiththepromptfor7O5theVSCutility( VSC> ).&Forexample: O $ VSCO VSC>~JOAttheVSC>prompt,youcanenterVSCcommandstoper-GOformVSC functions.-ToexitfromVSC,entertheEXITEO5commandorpressCTRL/Z.The followingexampleshowsLOhowtoenterVSCcommandsfromwithintheutilityattheOVSC>prompt: Ok $ kVSCO VSC> SHOW%FACILITY%SYSO Facility%SYS "SYS% Facility"OB VSC> BEXIT O $d b:LOYoucanalsoenterVSCcommandsdirectlyontheVSCcom-JOmandline.*The followingexampleshowshowtoenterthe SHOW%FACILITY%BADO" Facility%BAD" "BAD% Facility"Oj VSC> jSHOW%STREAM&V5.4O Stream%V5.4' "V5.4&SSB%release&(AETNA)"O VSC> EXIT OB $GOInthisexampletheuserenterstheVSCcommandfromHO DCL.VSCgivestheusertheVSC>promptandtheuser;Obenterstwo commands,SHOWFACILITYandSHOWCOSTREAM.TheEXITcommandendstheVSCsessionandROreturnstheusertotheDCLprompt( $ ).'TheVSCkeptsub-JOkprocessremainsandwillbe reenteredbyeach subsequentOVSCcommand. OA $7AVSC%SHOW&FACILITY&BAD;%SHOW%STREAM%V5.4O Facility%BAD "BAD% Facility"O Stream%V5.4' "V5.4&SSB%release&(AETNA)" O $FOThisexampleshowsthesametwoVSCcommandsenteredGOdirectlyonthe DCL-levelVSCcommandline.*Bothcom-KO9mandsare executed,afterwhichVSCexitsandreturnstoROtheDCLprompt( $ ).(Inthiscase,VSCdoesnotpromptforOExamples O1. VDE>@INFILEDThisexampleshowshowtoexecutetheVDEcommandsFTinthefile INFILE.VDEinyourdefault directory.,AsItherewasnofile extension explicitly specifiedintheDexamplecommand,VDEdefaultsthefile extensionto^.VDE. O2. VDE>@[MYDIR]MYFILE.TMPDJThisexampleshowshowtoexecutetheVDEcommands7infile MYFILE.TMPin directory[MYDIR].  :OATTACH*A`NO Transferscontrolfromyourcurrentprocesstothe specifiedO(process.X.OFormatOsATTACHN process-namec! :9O ParameterOs process-namePO Specifiestheparentprocessoraspawned subprocesstowhichUO$controlistobepassed.'Theprocessmustalreadyexist,bepartQO|ofyourcurrentjob,andsharethesameinputstreamasyourMOcurrentprocess.(However,theprocesscannotbethecurrentMO-processora subprocesscreatedwiththe/NOWAIT qualifier.ODonotspecifythe process-name&D parameterifyouusethe%O!/IDENTIFICATION qualifier.G O DescriptionHOsTheATTACHcommandallowsyoutoquicklytransfercon-JOtrolbetween processes.,(For informationaboutcreatingaEO$ subprocess,seetheSPAWN command.)*Forexample,youMO|cantransfercontrolfromaparentprocesstoa subprocessHOusingtheATTACHcommand.)Then,inthe subprocess,youTO-canstartabuildjobusingVDEand,afteryoufinish,youcanFOentertheATTACHcommandtomovebacktotheparentSOprocess.)IfyoulaterwanttodisplaythestatusofyourbuildIO7job,youcanenteranotherATTACHcommandatDCLlevelOO(orfrommany utilities)tomovebacktotheVDE subprocessOyoucreated. qJODonotattempttousetheDCLATTACHcommandtoattach'OtoaVDEkept subprocess.r HO QualifiersOs/IDENTIFICATION=pidNO Specifiestheprocessidentification(PID)oftheprocesstoMO$whichterminalcontrolis transferred.)Leadingzeroscanbe)O|omitted.'Donotspecifythe*| process-name| parameterwhen$Oyouusethis qualifier.V  WOExamples O1.  $EDIT% VACATION.TXT D. D". Dj. x  {MCTRL/Y {M    $SPAWN&VDE4G %DCL-S-SPAWNED,%process%SMITH_1&spawnedI %DCL-S-ATTACHED,&terminal&now%attached%to%process&SMITH_1 VDE>BUILD& GAME_PROG VDE>ATTACH%SMITHAg %DCL-S-RETURNED,&control%returned%to%process%SMITH D. D. D?. M  PMCTRL/Y PM    $ATTACH%SMITH_1 VDE>FThisexampleshowshowtospawna subprocess(SMITH_A1)toinvokeVDEandusetheATTACHcommandto?<movebetweenVDE (SMITH_1)andtheDCLcommand@level(SMITH).TheATTACHcommandallowsyouto3transfercontrolbetween subprocesses. o_UrNote o_?UsetheSPAWNcommandtocreateanewprocess@P andtheATTACHcommandtoconnecttoaprocess thatalreadyexists. e(9OBUILD*5TOCreatesand optionallystartsabuildjobtobuildthe specifiedLO(modules.*Thediscretesteps performedduringthebuildare&OderivedfromVDEscripts.%ORequiresBUILD privilege.e;OFormat+OsBUILDNmod-name[, mod-name...]=O ParameterOsmod-nameRO SpecifiesamoduleorbuildgrouptobeproducedbythebuildO$job.G! TOIfthe parameterisamodulename,itis typicallythenameofMOan executableimageoranothertypeofderivedmodulethatSO5istheendresultofabuild operation.(EachsuchmoduleisaO target9ofthebuild. WGOThemodulenamemustconsistofamodulenameandaFOmoduletype separatedbyaperiod(asin MODNAM.EXE)MO5andmay optionallybeprecededbyafacilitynameenclosedGOinsquarebrackets(forexample,[FACIL]MODNAM.EXE).IfROnofacilitynameis specified,themoduleisassumedtobelong%O>tothedefault facility.#! LOYoucanbuildmorethanonetargetmodulebyusingwild-POcard charactersinanyofthethree componentsofthemoduleMO5name.*Thepercentsign( % )inanamematchesanysin-POgle characterinthepositionitoccupiesandtheasterisk( c* )OOmatcheszeroormore charactersinthepositionit occupies.IO>VDEbuildsthosemoduleswhosenamesmatchthewildcardOpattern. xOIfthe2mod-name5 parameter specifiesabuildgroup,theKOBUILDcommandbuildsallmodulesthataremembersoftheMO5buildgroup.(A build-groupnameisasimplenamethathasCObeendeclaredwithaCREATE GROUP/BUILDcommand.'AEO build-groupnamemaynotcontainwildcard characters.N $O DescriptionGOsTheBUILDcommandperformstwodistinct operations:*itQOcreatesabuildjobforthedefault developmentstreamintheVO$VDEdatabaseandit optionallystartsthatbuildjobonasetof!O|OpenVMSbatchqueues.!OCreatingaBuildJobLO4Tocreateabuildjobinthe database,theBUILDcommand.Odoesthe followingthreethings: w `mDmFirst,theBUILDcommand determinesthetargetmod-Mulestobebuilt.*Thetargetmodulesare specifiedbythemod-name' parametersofthecommand. `HNext,thecommand determinesthebuildstepsthatmustHbe performedtobuildthosetargetmodules.*TheneededEObuildstepsare determinedbythebuild dependenciesGstoredintheVDE database,bythemodulesthathaveNchangedsincethelasttimethetargetswerebuilt,andbyDYwhethertheuserrequestsafullorminimalbuild. `DFinally,theBUILDcommandrecords informationaboutK0thenewbuildjobinthe database.)The informationspec-Lifiesthebuildstepstobe performed,any constraintsonHtheorderinwhichthestepsare performed,andotherL: attributes.)(Anexampleofanorder constraintisthere-F quirementthatacompilestepmustcompletebeforea) dependentlinkstepstarts.)! |NOThebuildjobisalwayscreatedforthedefault developmentOOstream.)Itusesthebuild dependenciesofthedefaultstreamNO5to determinethebuildstepstoperformanditusesmoduleJO replacementdataforthedefaultstreamto determinetheQOmodulesthathavechangedsincethelastbuild.(ThebuildjobQO>isthen identifiedbythestreamnameanda build-jobidenti-POficationnumber.'Forexample,thesecondbuildjobforstreamUOV1.0islabeled``buildjob2forstreamV1.0''inVDE messages.) OOYoucannotcreateanewbuildjobforagivenstreamifaTObuildjobalreadyexistsforthatstreamandthatexistingbuildOO5jobhasnotyet completed execution.)This restrictionensuresSOthattwobuildjobsforthesamestreamdonotexecuteattheROsametime.*Ifyoudonotwanttheexistingbuildjobtorun,IO>stopitwiththeSTOP BUILD_JOBcommandbeforecreatingOthenewbuildjob._`5!OStartingaBuildJobJO4Tostartabuildjob,theBUILDcommandsubmitsoneorGOmorebatchjobstotheOpenVMSbatchqueuesthattheLOuser specifiedeitherwiththe/QUEUE qualifierorbyde-GO>fault..Theneachbatchjobrunsthe VDE$BUILDutilityQOthatexecutesthebuildsteps belongingtothebuildjob.*TheTOstepsareexecutedinaloopuntilallthestepsaredone.(TheKOG VDE$BUILDutilitydoesthe followingforeachbuildstep:! ] `mHmTheprogramlooksinthedatabaseforthenextavail-Pablebuildstep.((Abuildstep,normallyacompile,copy,orVlinkstep,is availableifitisnotwaitingforanothersteptoOw complete.)&Ifnostepis available,theprogramwaitsafewIsecondsbeforelookingforanother availablebuildstep. `OLOWhentheprogramfindsabuildsteptorun,itlooksupKtheVDEscriptforthatstepand,fromthescript,gen-FeratestheDCLcommandsneededtorunthestep.*TheBYprogramthensendstheDCLcommandstoasubpro-Qcessthatexecutesthebuildstep,andwaitsforthestepto  complete. `HAfterthestep completes,theprogramrecordsthecom-Ppletionstatusofthestepinthe database.'Astep completesK:either successfullyorwitherrors.*Ifthestep completesG successfully,theprogramupdatesthestep'sbuildde-Ipendency informationinthedatabaseandthenlooksfor%Danothersteptoperform.FOTheBUILDcommandalwayscreatesanewbuildjobinMOtheVDE database..ItalsostartsthebuildjobunlessyouJO5usethe/NOSTART qualifieroryouanswerNOtoaqueryJOaskingwhethertostartthebuild.+IftheBUILDcommandSOdoesnotstartthebuildjob,youcanstartitlaterwiththeFO>START BUILD_JOBcommand.+Afterthebuildjobiscre-MOated(whetherornotyoustartit),youcanusetheSHOWKO BUILD_JOBcommandtodisplaythe attributesofthebuild,ROH includingthesizeofthebuildjobandtheexactbuildstepsIOand build-step dependenciesthatmakeupthebuildjob.! LOYoucan distributethebuildjobacrossseveral processorsMO(whetherinasinglemachineorinmultiplemachinesinaDO5cluster)by specifyingthe/QUEUEand/PROCESS_COUNTLO qualifiers.*The/QUEUE qualifier specifiesthebatchqueuesJOtorunthebuildjob.'The/PROCESS_COUNT qualifierspec-PO>ifiesthetotalnumberof processesVDEsubmitstothebatchJOqueues performingthebuildjob..By specifyingthebatchIOqueuesandthenumberof processesVDEsubmitstoeachQOHqueue,youcandecidehowto distributethebuildjoboveraPOclusterwith processorsof differentspeedsandconfigurations.  DOIfyoudonotspecifythe/QUEUEor/PROCESS_COUNTJO qualifier,VDEusesthedefaultbatchqueuesandprocessMO5countsofthedefault developmentstream.)Youcan establishBOthesedefaultsusingthe/QUEUEand/PROCESS_COUNTSTREAM commands.'Ifyouhavenot specifiedsuch defaults,;OVDEsubmitsoneprocesstoqueue SYS$BATCH.! FO QualifiersOs/AFTER=date-timeSO Indicatesthedateandtimeatwhichthebuildjobbeginsexe-KO$cution.'SpecifythedateandtimeusingOpenVMS date-timeNO|syntax.'Usethis qualifieronlyiftheBUILDcommandstartsROthebuildjob:*the qualifier specifiesthestarttimeforeachHO-batchjobthatis submittedtoexecutethebuildjob.! eO/CONFIRMO( /NOCONFIRM (default)IOControlswhetherVDEasksyoutoconfirmthatyouwantNOthebuildjobstarted.&The/CONFIRM qualifiercausesVDEtoNO2printamessageaskingwhetheryouwanttostartthebuildMOjob.+Thismessageis displayedafterVDEcreatesthebuildTOjobanddisplaysamessagestatingthesizeofthejob.)IfyouOO<answerYES(orY),thebuildjobisstarted.+IfyouanswerKONO(orN),thebuildjobisnotstarted.)The /NOCONFIRMRO qualifiercausesVDEtostartthebuildjobwithoutaskingforPOE confirmation.(Neither qualifierhasanyeffectifyouusetheCO/NOSTART qualifier:*/NOSTARTunconditionallyprevents/OVDEfromstartingthebuildjob.S! )O/FULLMO(DirectstheBUILDcommandtoperformafullbuildofyourROsoftwaresystem.'Inafullbuild,allsourcemodulesthatcon-NOtributetothetargetmodulesyou specifiedarecompiledorMO2 otherwise processed.)Ifyoudonotspecifythe/FULLqual-COifier,theBUILDcommandperformsaminimalsystemLObuild,whichmeansthatonlythesourcemodulesthathaveOO<changedsincethelastbuildofthe specifiedtargetmodulesNOarecompiledor processed.'AminimalbuildisnormallymuchOOquickerthanafullbuildbecauseitperformsonlythemin-KOEimalworkneededto propagateyoursourcechangestotheOtargetmodules. VO/LOG (default)O(/NOLOGPOControlswhetherlogmessagesareprintedafterthebuildjobNOiscreatedand submittedtobatchqueuesfor execution.)TheLO2/LOG qualifiercausessuchmessagestobeprintedandtheIO/NOLOG qualifier suppressesthem.(ThesemessagesindicateQOthatthebuildjobhasbeencreated,thatthedatabasetrans-MO<actionhas successfully committed,andthatbatchjobshaveNObeen submittedtovariousbatchqueuestoexecutethebuildOjob. l#O/PROCESS_COUNT=proc-countNO( Specifiesthenumberof processestoexecutethebuildjob.LOVDEcreatesthe processesby submittingbatchjobstotheMOqueues specifiedbythe/QUEUE qualifierortothedefaultNO2queuesforthedefaultstream.(Thenumberof processesthatMOVDEcreates(thatis,thenumberofOpenVMSbatchjobsit*Osubmits)is specifiedbythe! proc-count  parameter.(Asare-OO<sult,this parameter determinesthedegreeof parallelismforOthebuildjob.! /O/QUEUE=(queue-name[,queue-name...])PO( SpecifiestheOpenVMSbatchqueuestowhichthebuildjobisO submitted.'Each queue-name) parameter specifiesthename%Oofonebatchqueue.(The queue-name parametermayop-OO2tionallybefollowedbyaprocesscountin parentheses.*ThisNOcount specifiesthenumberof processesthatarestartedonLOthequeuetorunthebuildjob.(Forexample, SYS$BATCH(3)KO<causesthree build-job processestobe submittedtoqueueMO SYS$BATCH.Iftheprocesscountisomitted,oneprocessis$O submittedtothequeue. }%OIfyouonlyspecifyone queue-name! parameter,theparen-#Othesesmaybeomitted.c t9BOIfyoualsousethe/PROCESS_COUNT qualifier, theCO/PROCESS_COUNT qualifierstatesthetotalnumberofRO5 build-job processestocreate.(Inthatcase,theprocesscountsOattachedtothe queue-name% parametersonthe/QUEUEOO qualifierareusedasscalingfactorsto distribute build-jobKO> processesamongthequeuesproportionally.*Forexample,ifEOyouspecifyqueues HI_BATCH, HO_BATCH(3)andatotalNOprocesscountofeight,thentwo processesare submittedtoDOHqueueHI_BATCHandsix processestoqueue HO_BATCH.SOIfthetotalprocesscountdoesnotdivideevenlyintothesumOOofthescalingfactors,the remaining processesare allocatedTORtothequeuesintheorderthequeuesarelisted.*IfthetotalPOprocesscountisnine,forexample,theoneextraprocessisGO allocatedtoqueueHI_BATCHbecauseHI_BATCHislistedO[first. KUO/REMARK="string"SO( SpecifiesaremarkstringtobestoredinthedatabaseforthePOnewbuildjob.'Thequotedremarkstring,whichcanbeuptoHO132 characterslong,maycontainany explanatoryremarkPO2aboutthebuildjobthatyouwanttostoreinthe database.! qO/START (default)O(/NOSTARTPOControlswhetherthebuildjobisstartedornot.(The/STARTLO qualifierstartsthebuildjob,whichmeansthatVDEsub-JO2mitsbatchjobstothe appropriateOpenVMSbatchqueues.ROThesebatchjobsrunprogramsthatexecuteallthebuildstepsJOthatmakeupthebuildjob.*The/NOSTART qualifierpre-LO<ventsVDEfrom submittingthebatchjobs.+IfyouusetheRO/NOSTART qualifier,youcanstartthebuildjoblaterwiththe$OSTART BUILD_JOBcommand.! #O/STEP_DELAY=time-intervalJO( Specifiesthe step-delaytimeintervalusedby VDE$BUILD.HO VDE$BUILDistheprogramthatexecutesthebuildstepsPO belongingtoabuildjob.&If VDE$BUILDcannotfindanavail-QO2ablebuildstepinthe database,theprogramwaitstheamountQOoftime specifiedbythe /STEP_DELAY qualifierbeforeitlooks#Ointhedatabaseagain. WOOWhenmultiple processesrunabuildjob,oneprocessmaybePOidleuntilasecondprocess completesitscurrentbuildstep.QO5Inthat situation,thefirstprocess periodicallylooksintheUOdatabasetoseeifthesecondprocesshasfinisheditsstep.'TheKO step-delayinterval determineshowoftenthefirstprocess=O>looksinthedatabaseforan availablestep.JOUsethe followingsyntaxtodenotethenumberofhours,4Ominutes,andsecondsinthe interval:!Ol/STEP_DELAY=hh:mm:ss.ssMOForexample,anintervalofthreeandonehalfsecondsis!O specifiedasfollows:!O/STEP_DELAY=00:00:03.50> XOUsuallytheintervalissetatafewseconds.'Ifthis qualifierisQOnot specified,VDEusesthedefault step-delayintervaloftheSO5stream.(Ifnodefaulthasbeen specified,thedelayintervalisOfiveseconds.!  O/TIMEOUT=time-intervalQO( Specifiesthetimeoutintervalforthebuildjob.,IfnobuildKOstepscompleteduringthis interval,the VDE$BUILDutilityPOstopsthebuildjobandassignsitTIMEOUTstatus.& Therefore,QO2thetimeoutintervalmustbelongerthanthetimerequiredto.Ocompletethelongestbuildstep.! aTO Normally,abuildjobonlytimesoutifanodethatisrunningROoneofthe build-job processesfails.)Whenanodefails,otherPO5 build-job processesmaybeunabletoproceedbecausetheyareROwaitingforabuildstepthatranonthefailednodetocom-QOplete,whichwillnothappen.)Inthatcase,afterthetimeoutQO>intervalexpires,oneofthewaiting processesmarksthebuildOOjobastimedout,afterwhichthe remaining processestermi-ROnate themselves.(Youcanlaterrestartthebuildjobusingthe$OHSTART BUILD_JOBcommand.JOUsethe followingsyntaxtodenotethenumberofhours,4Ominutes,andsecondsinthe interval:Ol/TIMEOUT=hh:mm:ss.ssQOForexample,anintervaloftwoandonehalfhoursisspeci-Ofiedasfollows:O/TIMEOUT=02:30:00.00! gROThelengthofthetimeoutintervalshouldbesetbasedontheZOlengthofthelongestbuildstepinthebuildjob.'Ifthis qualifierRO5isnot specified,VDEusesthedefaulttimeoutintervaloftheQOstream.(Ifnodefaulthasbeen specified,thetimeoutintervalOisonehour. OExamples O1. VDE>BUILD&FOO.EXEQ %VDE-I-BLDJOBCRE,%build%job%1%for%stream&BL22%has&been%createdU %VDE-I-BLDJOBSIZ,%build%job%1%for%stream&BL22%consists%of%5%stepsMe %VDE-I-COMMIT,%database% transaction%has% successfully& committedL %VDE-I-BLDJOBSTARTING,&starting&build&job%1&for%stream%BL22P %VDE-I-BLDJOBENT,%entry%number%308& submitted%to%queue% SYS$BATCHYD< Job% VDEBUILD_0001%(queue%CLUSTER_BATCH,%entry%308)%started&on& PHI_BATCH^ %VDE-I-BLDJOBSTARTED,%build%job&1%for&stream%BL22&started%with%1& processes VDE>G;ThisexampleperformsaminimalsystembuildtobuildLmoduleFOO.EXE.Thecreatedbuildjobisbuildjob1forKstreamBL22.+Thebuildjobconsistsoffivebuildsteps,FEsuchascompileandlinksteps.)Becausethe/NOSTARTQ qualifierisomitted,thebuildjobisstartedonthedefaultIqueueforthestream, SYS$BATCH.ThebuildjobrunsonNonlyoneprocess. O2. VDE>$BUILD/FULL/NOSTART%BLDGRPQ %VDE-I-BLDJOBCRE,%build%job%2%for%stream&BL22%has&been%createdWV %VDE-I-BLDJOBSIZ,%build%job%2%for%stream&BL22%consists%of%125&stepsM %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE>NUInthisexample,buildjob2forthedefaultstream,BL22,Jiscreated..Thisisafullbuild(notaminimalbuild)J thatbuildsallmodulesthataremembersofbuildgroupH_ BLDGRP.Thisbuildrequires125buildsteps.)ThebuildM jobisnotstartedbecausethe/NOSTART qualifierisspec-D ified.-(Tostartitlater,usetheSTART BUILD_JOBJh  command.)*Althoughthebuildjobisnotstarted,itex-L istsinthedatabasesoyoucandisplay informationabout3 itusingtheSHOW BUILD_JOBcommand. O 3. VDE>& BUILD/PROCESS_COUNT=3%*.EXES %VDE-I-BLDJOBCRE,%build%job%2%for%stream&V2.0-3%has%been%createdX' %VDE-I-BLDJOBSIZ,%build%job%2%for%stream&V2.0-3%consists%of%25%stepsMo %VDE-I-COMMIT,%database% transaction%has% successfully& committedN %VDE-I-BLDJOBSTARTING,&starting&build&job%2&for%stream%V2.0-3P %VDE-I-BLDJOBENT,%entry%number%317& submitted%to%queue% SYS$BATCHYDG Job% VDEBUILD_0001%(queue%CLUSTER_BATCH,%entry%317)%started&on& PHI_BATCHP %VDE-I-BLDJOBENT,%entry%number%318& submitted%to%queue% SYS$BATCHYD Job% VDEBUILD_0001%(queue%CLUSTER_BATCH,%entry%318)%started&on& FOO_BATCHP %VDE-I-BLDJOBENT,%entry%number%319& submitted%to%queue% SYS$BATCHYDf Job% VDEBUILD_0001%(queue%CLUSTER_BATCH,%entry%319)%started&on& FUM_BATCH` %VDE-I-BLDJOBSTARTED,%build%job&2%for&stream%V2.0-3%started%with&3% processes VDE>JeThisexamplecreatesandstartsabuildjobthatbuildsLall executableimagesforthedefaultstream.(ItrunstheKbuildjobwiththreeparallel processes,all submittedtoGoqueue SYS$BATCH.Thebatchjobsexecuteonthreesep-Karatebatchqueues,inthiscaseonseparatenodesina cluster. O4. VDE>?.BUILD/QUEUE=(PHI_BATCH,FOO_BATCH(2),FUM_BATCH)%*.EXES %VDE-I-BLDJOBCRE,%build%job%3%for%stream&V2.0-3%has%been%createdX- %VDE-I-BLDJOBSIZ,%build%job%3%for%stream&V2.0-3%consists%of%25%stepsMu %VDE-I-COMMIT,%database% transaction%has% successfully& committedN %VDE-I-BLDJOBSTARTING,&starting&build&job%3&for%stream%V2.0-3P %VDE-I-BLDJOBENT,%entry%number%417& submitted%to%queue% PHI_BATCHUDM Job% VDEBUILD_0001%(queue% PHI_BATCH,%entry%417)&started%on% PHI_BATCHP %VDE-I-BLDJOBENT,%entry%number%418& submitted%to%queue% FOO_BATCHUD Job% VDEBUILD_0001%(queue% FOO_BATCH,%entry%418)&started%on% FOO_BATCHP% %VDE-I-BLDJOBENT,%entry%number%419& submitted%to%queue% FOO_BATCHUDm Job% VDEBUILD_0001%(queue% FOO_BATCH,%entry%419)&started%on% FOO_BATCHP %VDE-I-BLDJOBENT,%entry%number%420& submitted%to%queue% FUM_BATCHUD Job% VDEBUILD_0001%(queue% FUM_BATCH,%entry%420)&started%on% FUM_BATCH`E %VDE-I-BLDJOBSTARTED,%build%job&3%for&stream%V2.0-3%started%with&4% processes VDE>DLikethepreviousexample,thisexamplecreatesandQTstartsabuildjobthatbuildsall executableimages.(InthisKcase,the/QUEUE qualifier specifiesthatfourbatchjobsEare submitted:*onetobatchqueue PHI_BATCH,twoto<^queue FOO_BATCH,andonetoqueue FUM_BATCH.KThesequeuesbelongtospecificnodesinthecluster.*AsHaresult,the/QUEUE qualifier determines preciselyhowQgthebuildjobis distributedacrossthenodesofthecluster. O5. VDE>  BUILD/CONFIRM%FOO.EXEQ' %VDE-I-BLDJOBCRE,%build%job%8%for%stream&BL22%has&been%createdUo %VDE-I-BLDJOBSIZ,%build%job%8%for%stream&BL22%consists%of%2%stepsM %VDE-I-COMMIT,%database% transaction%has% successfully& committed; Start%build%job%8%for%stream&BL22%?%[No]: YESLG %VDE-I-BLDJOBSTARTING,&starting&build&job%8&for%stream%BL22O %VDE-I-BLDJOBENT,%entry%number%79% submitted&to&queue& SYS$BATCHXD Job% VDEBUILD_0001%(queue%CLUSTER_BATCH,%entry%79)&started%on% PHI_BATCH^ %VDE-I-BLDJOBSTARTED,%build%job&8%for&stream%BL22&started%with%1& processesg VDE>CThe/CONFIRM qualifiercausesVDEtoasktheuserJ.whethertostartthenewbuildjob.*VDEaskstheques-Mtionaftercreatingthebuildjobandafter displayingitsKsize(inthisexample,onlytwosteps).)TheuseranswersN8YESandVDEstartsoneprocessforthebuildjobonqueue SYS$BATCH.  @OCANCELFOLD*\2MODeletesoneormorefoldrecordsfromtheVDE database.)ALO(foldrecordisareminderthatasourcechangeshouldbeNOmanually ``folded''intoagiven developmentstreaminorder%Oto propagatethechange.&OuRequiresRESREP privilege.lBOFormat2OsCANCELFOLDMmod-name[, mod-name...] P}O ParameterOsmod-nameGO Specifies a!module for which a fold record is!to beIO$deleted..Themodulenameconsistsofanoptionalfacil-FO|itynameenclosedinsquare brackets,amodulename,KOandanoptionaltypenameprecededbyaperiod(suchasGO-[FACIL]MOD1.MAR).Ifthefacilitynameisomitted,theOOmoduleisassumedtobelongtothedefault facility.,IftheQOtypenameisomitted,VDEdeletesfoldrecordsforallsourcePO7moduleswiththe specifiedmodulenameinthegiven facility.K !POYoucandeletefoldrecordsformorethanonemodulebyus-LOingwildcard charactersinanyofthethree componentsofOO5themodulename.'Thepercentsign( % )inanamematchesPOanysingle characterinthepositionitoccupiesandtheas-Oterisk( ]*C)matcheszeroormore charactersinthepositionOO>it occupies.*VDEdeletesfoldrecordsforallsourcemodules6Owhosenamesmatchthewildcardpattern. FO DescriptionOOsAfoldrecordisareminderthatasourcechangeshouldbeJOmanuallyfoldedintoagiven developmentstreaminorderFO$to propagatethechangeintothatstream.,TheCANCELJO|FOLDcommanddeleteseach specifiedfoldrecordfromtheIOVDE database.'ThiscommandisasynonymfortheDELETEO-FOLDcommand.mO QualifiersOs/CONFIRMO /NOCONFIRM (default)IO$ControlswhetherVDEasksyoutoconfirmthatyouwantHO|eachfoldrecorddeleted.+The/CONFIRM qualifiercausesNOVDEtoprintamessageforeachfoldrecordaskingwhetherKO-youwantthatrecorddeleted.,IfyouanswerYES(orY),MOthatfoldrecordisdeletedfromthe database.,Ifyouan-ROswerNO(orN),thefoldrecordisnotdeleted.*IfyouenterGO7amodulenamewithawildcardspecification,VDEasksMOyoutoconfirmthedeletionoffoldrecordsforeachmod-GOulewhosenamematchesthewildcardspecification.,TheHOA /NOCONFIRM qualifiercausesVDEtodeletethe specified+CANCEL%FOLD&[CODE]X.FOR/IDENT=1X %VDE-I-FOLDDEL,%fold%record%1%for%module& [CODE]X.FOR&has%been&deletedM" %VDE-I-COMMIT,%database% transaction%has% successfully& committedj VDE>>This example deletes fold!record!1!for moduleD1 [CODE]X.FOR.Thelogmessagesconfirmthatthefold3recordhasbeen successfullydeleted. !?OCANCELLOG*RODisablesthe recordingofVDEinputandoutputinalogfile.HO(InputandoutputloggingisenabledusingtheSETLOGOcommand.O%OFormatOsCANCELLOGM#O ParametersOs None.M#O QualifiersOs None.V,OExamples O1. VDE>CANCEL%LOG VDE>SHOW%LOG No%output%logginge VDE>?TheCANCELLOGcommanddisablesinputandout-@,putlogging.*TheSHOWLOGcommandconfirmsthat loggingis disabled.W" !#GOCANCEL REPLACEMENT*U +IOThiscommandisthenegationofthePERFORM REPLACEMENTHO(command.+ThiscommandallowsaprojectleaderorotherJOreviewertocanceloneormore accepted,queuedreplace-LOments,andthuspreventthesemodulesfrombeing relocated?O2intotheVDElibraryviaaPERFORM REPLACEMENTOcommand.DO&RequiresRESREP privilegetocancelyourownqueued@O~ replacement.)RequiresPERFREP privilegetocancel/Oanotheruser'squeued replacement.sIOFormat9OsCANCEL REPLACEMENTMrep-name[, rep-name...]~ TO ParameterOsrep-nameMOThenameofaqueued replacementtobe cancelled.(YoucanMO$cancelmorethanone replacementatatimebyusingwild-KO|card charactersinthe replacementname.(ThepercentsignRO( % )inanamematchesanysingle characterintheposition-O-itoccupiesandtheasterisk( [9*+-)matcheszeroormorechar-OOactersinthepositionit occupies.'Thosequeued replacementsFOwhosenamesmatchthewildcardpatternare cancelled.! FO DescriptionAOsTheCANCEL REPLACEMENTcommandisusedaftertheLO module(s)inthe replacementhavebeenreplacedbyauserKO$andhavebeenacceptedthroughthe (optional)codereviewKO|process supportedbyVDE. Cancellationpreventsthesemod-QOulesfrombeingmovedintotheVDElibrary.'This operationis@O-thenegationofthePERFORM REPLACEMENTcommand.9:OTheCANCEL REPLACEMENTcommandcancelseachHO specifiedqueued replacementsothatthe replacementisQO5deletedfromtheVDElibraryandisnolongereligibletobemoduleswillagainhavetobeaccepted(or rejected)bytheO reviewers. NMOFor informationonhowaqueued replacementisacceptedor?O rejected,seetheACCEPT REPLACEMENTandREJECT O5 REPLACEMENT commands.~! TO QualifiersOs/CONFIRMO /NOCONFIRM (default)IO$ControlswhetherVDEasksyoutoconfirmthatyouwantIO|each replacement cancelled.'The/CONFIRM qualifiercausesMOVDEtoprintamessageforeach replacementaskingwhetherMO-youwantthat replacement cancelled.(IfyouanswerYES(orOOY),that replacementis cancelled.)IfyouanswerNO(orN),OOthe replacementisnot cancelled.(Ifyouentera replacementNO7namewithawildcardspecification,VDEasksyoutoconfirmHOthe cancellationofeach replacementwhosenamematchesCOthewildcardspecification.-The /NOCONFIRM qualifierHOAcausesVDEtocancelthe specified replacementswithout$Oaskingfor confirmation.UO/LOG (default)O(/NOLOGJOControlswhetherlogmessagesareprintedaftereachre-HO placementhasbeen cancelled.,The/LOG qualifiercausesLO2suchmessagestobeprintedandthe/NOLOG qualifiersup-KOpressesthem.(Thesemessagesindicatethatthe replacementJOhasbeen cancelledandthatthedatabase transactionhas"O< successfully committed. OExamples O1. VDE>&CANCEL% REPLACEMENT%SMITH-29 %VDE-I-REPCAN,% replacement%SMITH-2& cancelledM" %VDE-I-COMMIT,%database% transaction%has% successfully& committedj VDE>FThisexamplecancels replacementSMITH-2sothatthisF1 replacementisnolongerqueuedintheVDE database.FThemodules associatedwiththe replacementarestill;reservedafterthe replacementis cancelled.Z# "$C OCANCELSESSION* 6  KOCancelsoneormore reservationsessionsbydeletingthem#O(fromtheVDE database.BORequiresRESREP privilegetocancelyourownses-BOsion.)RequiresPERFREP privilegetocancelanotherOuuser'ssession.w MOFormat=OsCANCELSESSIONM session-name[,session-name...]v  LO ParameterOs session-nameNOThenameofa reservationsessiontobe cancelled.*YoucanLO$cancelmorethanonesessionatatimebyusingwildcardQO| charactersinthesessionname.*Thepercentsign( % )inaPOnamematchesanysingle characterinthepositionitoccupiesO-andtheasterisk( 9*9-)matcheszeroormore charactersintheMOpositionit occupies.)Those reservationsessionswhosenames8Omatchthewildcardpatternare cancelled.! WO DescriptionAOsTheCANCELSESSIONcommandcancelseach specifiedSO reservationsessionsothatthesessionisdeletedfromtheVDEMO$ database.*The reservationsthatbelongedtothesessionre-OO|maininthe database,butnolongerbelongtothe cancelledOsession.! NSOIfyouwanttobothdeleteasessionand unreserveallmodulesGO associatedwiththesession,usethe UNRESERVEcommand)O5withthe/SESSION qualifier.\ Z2O QualifiersOs/CONFIRMO /NOCONFIRM (default)IO$ControlswhetherVDEasksyoutoconfirmthatyouwantJO|eachsession cancelled.&The/CONFIRM qualifiercausesVDEOOtoprintamessageforeachsessionaskingwhetheryouwantOO-thatsession cancelled.+IfyouanswerYES(orY),thatses-TOsionis cancelled.(IfyouanswerNO(orN),thesessionisnotPO cancelled.(Ifyouenterasessionnamewithawildcardspec-NO7 ification,VDEasksyoutoconfirmthe cancellationofeachKOsessionwhosenamematchesthewildcardspecification.(TheHO /NOCONFIRM qualifiercausesVDEtocancelthe specified7OAsessionswithoutaskingfor confirmation.! O/LOG (default)O(/NOLOGNOControlswhetherlogmessagesareprintedaftereachsessionMOhasbeen cancelled.'The/LOG qualifiercausessuchmessagesIO2tobeprintedandthe/NOLOG qualifier suppressesthem.MOThesemessagesindicatethatthesessionhasbeen cancelledNOandthatthedatabase transactionhas successfully committed. OExamples O1. VDE>"CANCEL%SESSION&SMITH-35 %VDE-I-SESCAN,%session&SMITH-3% cancelledM" %VDE-I-COMMIT,%database% transaction%has% successfully& committedj VDE>?Thisexamplecancels reservationsessionSMITH-3I1sothatthissessionisnolongerrecordedintheVDEM database.'Themodules associatedwiththesessionarestill7reservedafterthesessionis cancelled.5$#%BOCANCELVERIFY*lBBOCancelsdisplayofcommandinputtothe terminal.R(OFormatOsCANCELVERIFYM#O ParametersOs None. O DescriptionBOsTheCANCELVERIFYcommanddisablestheechoingofOOcommandinputtothe terminal.*Itcancelstheeffectofthe=O$SETVERIFYcommand.)TheCANCELVERIFYcommandLO|normallyisusedtodisabletheechoingofinputcommands$Ofromcommand procedures.@OpTheCANCELVERIFYandSETNOVERIFYcommandsareO equivalent.M#O QualifiersOs None.[OExamples O1. VDE>SET%VERIFY VDE> SHOW%MODULE&MOD1.FOR  SHOW&MODULE%MOD1.FOR!e Module%[FACIL]MOD1.FOR VDE>CANCEL%VERIFY CANCEL%VERIFY< VDE><SHOW%FACILITY%FACIL Facility%FACIL VDE>D;TheSETVERIFYcommandallowstheterminaltodis-Dplay(echo)thecommandlineit receives.,TheSHOWAMODULEcommandis thereforeechoedonthetermi-IEnalbeforetheoutputofthecommandis displayed.*TheBCANCELVERIFYcommandisalsoechoedbutitdis-Cablesthedisplayof subsequent commands.*TheSHOWGNFACILITYcommandthatfollowsisnot displayedonthe;terminalbuttheoutputofthecommandis.% $&;OCOMPILE*MOCompilesthe specifiedmodulesusingthe appropriatescriptsO(fromthe database.%ORequiresBUILD privilege.g=OFormat-OsCOMPILEMmod-name[, mod-name...]N$O ParameterOsmod-nameJO Specifiesamoduletobe compiled.*Themodulenamecon-RO$sistsofanoptionalfacilitynameenclosedinsquare brackets,JO|amodulename,andanoptionaltypenameprecededbyaIOperiod,suchas[FACIL]MOD1.MAR.IfnofacilitynameisRO- specified,thedefaultfacilityisassumed.*IfnotypenameisPO specified,allsourcemodulesofthe specifiedmodulenamein.Othegivenfacilityare compiled. IOYoucancompilemorethanonemodulebyusingwildcardJO charactersinanyofthethree componentsofthemoduleMO5name.*Thepercentsign( % )inanamematchesanysin-POgle characterinthepositionitoccupiesandtheasterisk( c* )KOmatcheszeroormore charactersinthepositionitoccu-HO>pies.*VDEcompilesthosemoduleswhosenamesmatchtheOwildcardpattern.@!O DescriptionDOsTheCOMPILEcommandcompilesamodulethesamewayJOitiscompiledinabuildjob.*TheCOMPILEcommandre-JO$trievesthecompilescriptforeach specifiedmoduleandIO| generatesaDCLcommandfilefromthescript.)Thecom-JOmandthenexecutesthecommandfileina subprocess.+IfHO-themodulecompiles successfully,VDEupdatesthebuildNO dependency informationforthecompilestepinthe database." kFOTheCOMPILEcommandcanbeusedtocompileamoduleSOwithoutstartingabuildjob.+ItisoftenusedtotestcompileRO5scripts.+Itcanalsobeusedtocollecttheinitial dependencyPO informationforacompilestepthatdoesnotyethavedepen-0Odency informationinthe database.# WBOTheCOMPILEcommandonlyoperatesonmodulesthatNOhavea generationinthecurrentstream(thedefaultstreamNO5orthestream specifiedwiththe/STREAM qualifier).(Inad-POdition,itonlyoperatesonsourcemodulesunlessyouspecify"OthetypenameintheZmod-name#: parameterwithoutwild-PO>card characters.(Inotherwords,unlessyou explicitlyspecifyJOaderived-modulefile extension,thecommandassumesthat8Oyouonlywanttocompilesourcemodules.?$ PO QualifiersOs/LOG (default)O/NOLOGJO$Controlswhetherlogmessagesareprintedafterthecom-MO|pilestep executes.(The/LOG qualifiercausessuchmessagesIOtobeprintedandthe/NOLOG qualifier suppressesthem.NO-Thesemessagesindicatethatthecompilestephas completed,IOeither successfullyorwitherrors,andthatthedepen-NOdency informationforthestephasbeenupdatedintheVDEO7 database.3%  O/STREAM=stream-nameNO( SpecifiesthatthemodulesbecompiledforthestreamgivenObytheD stream-name7 parameter.(Ifthis qualifierisomitted,AOthemodulesarecompiledforthedefaultstream.; &  OExamples O1. VDE>COMPILE%B.C= $& DEFINE/NOLOG%SRC$&DEV$:[PROJDIR.MAIN.CODE.SRC]= $& DEFINE/NOLOG%OBJ$&DEV$:[PROJDIR.MAIN.CODE.OBJ]/e $&VDE%FETCH%[CODE]B.C/OUTPUT=SRC$:U %VDE-I-FETCHED,%module& generation%[CODE]B.C;1(1)%fetched%from&libraryM %VDE-I-OUTFILE,%output&file%is% DEV$:[PROJDIR.MAIN.CODE.SRC]B.C;0< $&CC/ANA=OBJ$:/OBJECT=OBJ$:KSRC$:B.C& $& VDE/DEPEND%C% OBJ$:B.ANA $&!= $&SET%NOVERIFYp!% Successful%script% completionO\ %VDE-I-COMPSUCC,& compilation&of& [CODE]B.C% completed% successfullyO %VDE-I-DEPUPDATE,% dependency& information&updated%for&build&step VDE>H[ThisexamplecompilesmoduleB.Cinthedefaultfacil-Kity,facilityCODE.Theoutputfromthe executionoftheM compilescriptis displayedonthe terminal.(ThefinallogGemessagesshowthatthecompilestep completedsuccess-Jfullyandthatits dependency informationwasupdatedinthe database. O2. VDE>COMPILE% [RMS]E.B32F $&VDE%FETCH%-[RMS]E.B32/OUTPUT=DEV$:[PROJDIR.MAIN.RMS.SRC]X# %VDE-I-FETCHED,%module& generation%[RMS]E.B32;3(2A1)%fetched%from&libraryNk %VDE-I-OUTFILE,%output&file%is%!DEV$:[PROJDIR.MAIN.RMS.SRC]E.B32;< $& DEFINE/NOLOG%SRC$&DEV$:[PROJDIR.MAIN.RMS.SRC]< $& DEFINE/NOLOG%OBJ$&DEV$:[PROJDIR.MAIN.RMS.OBJ]5C $&BLISS/OBJECT=OBJ$:/ANA=OBJ$:K SRC$:E.B32 ;p0067J2 RETRUN;% %&WARN#000....1KL1:0067# Undeclared%name:KRETRUNIc %BLS32-W-ENDDIAGS,% Compilation% completed&with%1% diagnostic $VDE$ERROR:> $&SET%NOVERIFYp!%Script& completed%with&errorsP: %VDE-I-COMPFAIL,& compilation&of& [RMS]E.B32% completed&with%errors VDE>? Thisexamplecompilesmodule [RMS]E.B32buttheFJ  compilation terminateswitherrors.+TheoutputoftheH compilestepincludeserrormessagesfromthe compiler,L andthefinallogmessageshowsthatthestepfailed.)InHS thiscase,VDEdoesnotupdatethedatabase dependency  information.~ & %'D'OCONVERTLIBRARY*() 5MOConvertsthecurrentVDElibrarytotheformatrequiredby)O(thecurrentversionofVDE.DORequiresMODLIB privilegeif automatic conversionisO disabled.T**OFormatOsCONVERTLIBRARYM+#O ParametersOs None.[, 1O DescriptionPOsWhenanewversionofVDEis installedonyoursystem,thatKOnewversion frequentlyrequiresa differentlibraryformatHO$thanthepreviousversion.,ThenewversionmayrequireKO|a differentdatabaseschemaornewlibrarysubdirectories,NOforexample.)BecauseyourexistingVDE librariesareintheMO-oldlibraryformat,youmustconvertthemtothenewfor->Omat.,TheCONVERTLIBRARYcommandperformsthisO conversion.- WLOTheVDEdatabaseinyourlibrarycontainsa``formatver-MOsionnumber''thattellsVDEwhatformatyourlibraryhas.PO5IfthecurrentversionofVDErequiresamorerecentlibraryEOformat,theCONVERTLIBRARYcommandconvertstheli-NObraryanditsdatabasetothatmorerecentformat.+ItthenCO>updatestheformatversionnumberinthe database.. oJOOnceyouhave convertedaVDElibrarytoamorerecentPOformat,youcannolongeruseolderversionsofVDEonthatSO5library.)IfyouwanttoretaintheoptionofgoingbacktoanROolderversionofVDE,youshouldbackupyourlibraryandits0Odatabasebeforeyourconvertthem./! kGOIfyouhave specifiedthe /AUTO_CONVERT qualifierwith?OtheCREATEorMODIFYLIBRARYcommand,VDEwillQO5 automaticallyconvertyourlibrarytothenewformatthefirstPOtimeauseraccessesthelibrarydatabaseusingthenewver-KOsionofVDE. Automatic conversionismore convenientthanFO>usingtheCONVERTLIBRARYcommand,butdoesnotgiveMOyoutheoptionofbackingupthelibrarybefore convertingDOit.+Ifyouhave specifiedthe/NOAUTO_CONVERTqual-AOHifierwiththeCREATEorMODIFYLIBRARYcommand,GOyoumustconvertthelibrarywithanexplicitCONVERTDOLIBRARYcommand.*Seethe descriptionsoftheCREATE@ORLIBRARYandCONVERTLIBRARYcommandsforafullO explanation.M0#O QualifiersOs None.16 UuOExamples O1. VDE>CONVERT%LIBRARYQ %VDE-I-LIBCONV,%library%format% converted&for%new%version%of%VDE VDE>IThiscommandconvertsthecurrentlibrarytotheformatGrequiredforthenewversionofVDE.Thelogmessage@<showsthatthe conversion successfully completed.' &(82OCOPY*34KOCopiesthe specifiedmodulesusingthe appropriatescriptsO(fromthe database.%ORequiresBUILD privilege.d5:OFormat*OsCOPYNmod-name[, mod-name...]W6! -O ParameterOsmod-nameRO Specifiesamoduletobecopiedusingacopyscript.'Themod-LO$ulenameconsistofanoptionalfacilitynameenclosedinLO|square brackets,amodulename,andanoptionaltypenameNOprecededbyaperiod,suchas[FACIL]MOD2.H.IfnofacilityRO-nameis specified,thedefaultfacilityisassumed.*IfnotypeROnameis specified,allmodulesofthe specifiedmodulenamein,Othegivenfacilityarecopied.7FOYoucancopymorethanonemodulebyusingwildcardJO charactersinanyofthethree componentsofthemoduleMO5name.*Thepercentsign( % )inanamematchesanysin-POgle characterinthepositionitoccupiesandtheasterisk( c* )OOmatcheszeroormore charactersinthepositionit occupies.IO>VDEcopiesthosemoduleswhosenamesmatchthewildcardOpattern.8 lO DescriptionGOsTheCOPYcommandcopiesamodulethesamewayitisNOcopiedinabuildjob.'TheCOPYcommand retrievesthecopyLO$scriptforeach specifiedmoduleand generatesaDCLcom-KO|mandfilefromthescript.)Thecommandthenexecutesthe+Ocommandfileina subprocess.9 VOOAcopystepmovesamoduleintothe directoryorotherlo-OOcationwhereotherbuildstepslaterexpecttofindit.,ForIO5example,copystepsmoveINCLUDEfilesfromdeltafilesOOinto clear-copyfilesinthesubdirectorieswhereotherbuildSOstepswilllateraccessthem.(Unlikeacompileorlinkstep,aPO>copystepdoesnot transformonesetofmodulesintoadif-SOferentsetofmodules;itonlycopiesasinglemodulefromone*Oformorlocationtoanother.:NGOTheCOPYcommandcanbeusedtoperformacopystepPOwithoutstartingabuildjob.-ItisoftenusedtotestcopyO5scripts.{; QEOTheCOPYcommandonlyoperatesonmodulesthathaveLOa generationinthecurrentstream(thedefaultstreamorJO5thestream specifiedwiththe/STREAM qualifier).+Inad-POdition,itonlyoperatesonsourcemodulesunlessyouspecify"OthetypenameintheZmod-name#: parameterwithoutwild-PO>card characters.(Inotherwords,unlessyou explicitlyspecifyJOaderived-modulefile extension,thecommandassumesthat5Oyouonlywanttocopysourcemodules.<! O QualifiersOs/LOG (default)O/NOLOGJO$ControlswhetherlogmessagesareprintedafterthecopyGO|step executes.-The/LOG qualifiercausessuchmessagesIOtobeprintedandthe/NOLOG qualifier suppressesthem.KO-Thesemessagesindicatethatthecopystephas completed,MOeither successfullyorwitherrors,andthatthe dependencyLO informationforthestephasnotbeenupdatedintheVDEMO7 database.'(Copystepsdonotnormallyupdate dependencyin-QO formationsincetheonlyinputandoutputtothestepisthe!Omodulebeingcopied.)/=! O/STREAM=stream-namePO( Specifiesthatthemodulesbecopiedforthestreamgivenby Othe stream-name< parameter.'Ifthis qualifierisomitted,the:Omodulesarecopiedforthedefaultstream. >a vOExamples O1. VDE>COPY% [CODE]A.REQH $&VDE%FETCH%/[CODE]A.REQ/OUTPUT=DEV$:[PROJDIR.MAIN.CODE.SRC]W" %VDE-I-FETCHED,%module& generation%[CODE]A.REQ;1(1)%fetched&from%libraryOj %VDE-I-OUTFILE,%output&file%is%"DEV$:[PROJDIR.MAIN.CODE.SRC]A.REQ; $&!= $&SET%NOVERIFYp!% Successful%script% completionJB %VDE-I-COPYSUCC,&copy%of% [CODE]A.REQ% completed& successfullyW %VDE-I-DEPNOTUPDATE,% dependency& information&not%updated&for%build%step VDE>A@ThisexampleperformsthecopyactionformoduleE [CODE]A.REQ.Thecopyscriptfetchesthelatestgen-NerationformoduleA.REQfromitsdeltafileandleavesitJJin clear-copyforminthe[.SRC] subdirectoryforfacil-GityCODEandthedefault developmentstream.)ThereitLis availabletofuturecompilesteps.)TheoutputfromtheITcopyscriptis displayedontheterminalasshown.*TheLfinallogmessagesshowthatthecopystep completedsuc-F cessfullyandthatits dependency informationwasnot%]updatedinthe database.] (')H?OCREATE ARCHITECTURE*@ALODefinesoneormore architecturetableentriesintheVDE8O( database.'Each architecturetableentry...,ORequirestheCREARCH privilege.gB==O ARCHITECTUREsupportisnotfully implemented.;C NOAn architectureisa constructthat encompassesoneormoreMO facilities,andallowsmodulestoexistina ``common''orRO5 ``default'' facility,andzeroormore architecturespecificfa-HO cilities.,Inmustthesamefashionasthe SYS$SYSROOT:MOlogicalnameallowsonetosupportbothsystem-specificandLO>cluster-commonfiles,an architectureallowsonetosupportCOarchitecture-specificandarchitecture-commonmodules.vDLOFormat:CREATE% ARCHITECTURE%VAXPDP/REMARK="Version%n" VDE> IUnderConstruction...z)(*CMOCREATECONTEXT*NO! ?OODefinesoneormorecontextsintheVDE database.&Eachcon-NO(textcanbeusedtospecifythedefault developmentstream,NOdefault architectureanddefaultfacilityforaVDEsession,NOandonecontextcanbeusedtosetthedefaultstreamandBO2facilitywhenfirst connectingtoaVDE database.DORequirestheCRECTX privilegetocreatepubliccon-O&texts.oPEOFormat5OsCREATECONTEXTMctx-name[, ctx-name...]Q =O ParameterOsctx-namePOThenameofthecontexttobecreated.'ThisnamemaybeupIO$to39 characterslongandmustfollowVDEnamesyntax.VR,O DescriptionMOsA ``context'' specifiesdefaultsforVDE sessions.*WhenyouCOcreateacontextusingtheCREATECONTEXTcommand,OO$youspecifythenameofthecontext,the associateddevelop-8O|mentstream,andthe associated facility.SWOOToapplythedefaults associatedwithacontext,specifytheFOcontextnameasa parametertotheSETCONTEXTcom-PO5mand.)Toseta particularcontextasthedefaultcontextforFOusewhenyouissuetheSETLIBRARYcommand,usethe@OSETCONTEXT/DEFAULTcommandtomarka particular-O>contextasthedefaultcontext.dT::OTherearetwokindsofcontexts available:6U!   `m mthe^mprivatecontext8mis availabletoandonlyvisibletothe!userwhocreatedit. `E Ethe^Epubliccontext9Eis availabletoallusersofthecurrentVDElibrary.V xNOYoudonotneedspecialVDE privilegestocreateaprivateIOcontext,butyoumusthavetheVDECRECTX privilegetoQO5createapubliccontext.'WhileaprivatecontextcanhavetheNOsamenameasapubliccontext,neithertwoprivatecontextsBOnortwopubliccontextscansharethesamename.uWKO QualifiersOs /ARCHITECTURE OUnderConstruction...X YO/FACILITY=facil-nameO( /NOFACILITYNOThe /FACILITY qualifier specifiesthedefaultfacilityforaFOcontext establishedwiththeSETCONTEXTcommand.(TheVO2defaultfacilityisthefacilitythatisassumedwhenthefacilityEOnameisomittedfromamodulename.*The /NOFACILITYRO qualifier specifiesthatthedefaultfacility establishedbytheUO<contextisnull.'Ifyouomitboth qualifiers,thecurrentdefaultPOfacilitybecomesthefacility associatedwiththenewcontext.Y! O/LOG (default)O(/NOLOGMOControlswhetherlogmessagesareprintedafteranewcon-MOtextiscreated.*The/LOG qualifiercausesthemessagestoJO2beprintedandthe/NOLOG qualifier suppressesthem.)TheJOmessagesindicatethateachnewcontexthasbeencreatedNOandthatthedatabase transactionhas successfully committed.Z! O/PRIVATE (default)O(/PUBLICSO Specifieswhetheraprivateorapubliccontextiscreated.'TheLO/PRIVATE qualifiercausesVDEtocreateacontextthatisMO2privatetoyou.(The/PUBLIC qualifiercausesVDEtocreateWOacontextthatis availabletoallusersofthelibrary.&YoumustIOhavetheCRECTX privilegetousethe/PUBLIC qualifier.o[EEOOf/PRIVATEand/PUBLIC,theformeristhedefault.\! O/REMARK="string"OO( Specifiesaremarkstringtobestoredforthenewcontext.OOThequotedremarkstring,whichcanbeupto132 charactersHOlong,maycontainany explanatoryremarkaboutthenewNO2contextthatyouwantstoredintheVDE database.( TypicallyOOtheremark describesthefunctionorpurposeofthecontext.7]!  O/STREAM=stream-nameO( /NOSTREAMLOThe/STREAM qualifier specifiesthatthe indicateddevelop-IOmentstreambecomesthedefaultstreamwhenthecontextAO2is establishedwiththeSETCONTEXTcommand..TheJO /NOSTREAM qualifier specifiesthatthedefaultstreames-WO tablishedbythecontextisnull.'Ifyouomitboth qualifiers,theJO<currentdefaultstreambecomesthestream associatedwithOthenewcontext.7^;  OExamples O1. VDE>NCREATE%CONTEXT&/NEWCTX/STREAM=V2.0/FACILITY=RMS/REMARK="Version&2"E %VDE-I-CTXADDED,&context%NEWCTX&added&to&the%databaseM" %VDE-I-COMMIT,%database% transaction%has% successfully& committedj VDE>jSHOW%CONTEXT%NEWCTX5 Context&NEWCTX%(private%to%user&SMITH)#D Default&stream%is%V2.0$DB Default&facility&is&RMS VDE>A@ThisexamplecreatesaprivatecontextNEWCTXinLwhichthedefaultstreamisV2.0andthedefaultfacility>isRMS.TheSHOWCONTEXTcommanddisplaystheAJcontextsettings associatedwiththenewcontext. O2. VDE>ECREATE%CONTEXT&*PUBCTX/PUBLIC/STREAM=V3.3-2FT/FACILITY=RMSE %VDE-I-CTXADDED,&context%PUBCTX&added&to&the%databaseMW %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE>;Inthisexample,theCREATECONTEXTcommandIgcreatesapubliccontextPUBCTX availabletoallusers.GWhenthiscontextis specifiedonaSETCONTEXTcom-Fmand,thedefaultstreamissettoV3.3-2FTandthe.pdefaultfacilityissettoRMS.I*)+J_  OCREATEDIRECTORY_TREE*`a5NOCreatesthedisk directorytreefortheVDE library'sdeltaPO(files,forthedefault developmentstream,orfora specifiedO facility.'ORequiresCRESTRM privilege.Zb0OFormat OsCREATEDIRECTORY_TREE c! O DescriptionOAyouentertheCREATEDIRECTORY_TREEcommandtoNOcreatedisk directories accordingtotherulesyou specified/OwithyourSET DIRECTORY commands.@d MO Directoriesarecreatedusingthe protectionsettingoftheKOparent directoryfortheUICgroupandworldaccess,anyNO5 applicableACEentriesfromtheparent directory,andallow-0Oingfullsystemandowneraccess.e! O QualifiersOs/BRIEF (default)O/FULLIO$ Determineshowmanylogmessagesare displayedwhenVDENO|createsnewdisk directories.)The/BRIEF qualifieronlydis-QOplayslogmessagesforthestreamor delta-fileroot directoryKO-andforeachfacilityroot directory.,The/FULL qualifierNOdisplaysalogmessageforevery directoryVDEcreates,in-QOcludingallfacilitysubdirectories.)(ThefacilitysubdirectoriesNO7arethemostnumerous directories.)(These qualifiershaveno7Oeffectifyouusethe/NOLOG qualifier.kfAAOOf/BRIEFand/FULL,theformeristhedefault.g! hqO /DELTA_FILESO(/STAGINGO/STREAM (default)LO Determineswhether directoriesarecreatedfortheVDEli-RO2brary'sdeltafiles,foritsstagingareas,orforthedefaultDO developmentstream.+The /DELTA_FILES qualifierspeci-UOfiesthatdisk directoriesbecreatedfortheVDE library'sdeltaPO<files.(Thesearethe directoriesthatholdCMS libraries.)TheNO/STAGING qualifier specifiesthattheroot directorybecre-POatedforthe library'sstaging directories.*Staging directoriesOOEare temporaryholdingareasforfilesthatarereplacedintoHOthelibrarywithqueued replacements.)The/STREAMqual-SOifier specifiesthatdisk directoriesbecreatedforthedefaultOO developmentstream.h! WGOIfyouspecifythe /DELTA_FILES qualifierbutnottheDO/FROM_CMS_LIBRARY qualifier,VDEcreatestheCMSli-RO5braryforeachfacilityaffectedbythiscommand.'Ifyouspec-JOifythe/STREAM qualifier,VDErunsthedefaultstream'sOO new-streamscriptforeachfacilityaffectedbythiscommand,RO>providedsuchascriptisdefined.( Dependingonhowitisde-OOfined,thisscriptmaypopulatethestream'sfacility-specific@O directorieswithsourcemodulesandotherfiles.i\EOOf /DELTA_FILES,/STAGINGand/STREAM,thelatterisOthedefault.~jKTO/FACILITY=fac-nameQO( Specifiesthatdisk directoriesbecreatedonlyforthefacil-!Oity specifiedbythefac-name) parameter.+Ifthis qualifierUOisomitted, directoriesarecreatedforall facilities,eitherfor6O2deltafilesorforthedefaultstream.:k! ROYoucancreate directorytreesformultiple facilitiesbyusing'Owildcard charactersinthefac-name parameter.(Theper-TO5centsign( % )inanamematchesanysingle characterinthe7Opositionitoccupiesandtheasterisk( u*$)matcheszeroormoreOO charactersinthepositionit occupies.)VDEcreates directoryKO>treesforthose facilitieswhosenamesmatchthewildcardOpattern.lg'O/FROM_CMS_LIBRARY[=date-time]PO( Specifiesthatthe delta-fileroot directoryforeachfacilityAOcoveredbythecurrentCREATEDIRECTORY_TREEcom-JOmandalreadycontainsaCMSlibraryandthatVDEshouldJO2enterallmodulesandmodule generationspresentinthatLOCMSlibraryintothecurrentVDE database.)This qualifier,DOwhichVDEalsoacceptsontheCREATEFACILITYcom-HO<mand,givesyouawayto automaticallypopulateaVDECOlibrarywithmodulesfromanexistingCMSlibrary.m n)OIfyouspecifytheoptional date-time parameter,VDEad-KO ditionally retrievesall reservationsfromtheCMSlibraryPO5thatwerecreatedsincethedateandtimegivenbythatpa-JOrameter.(VDEprintswarningmessagesforany reservationsPOcreatedearlierthanthistimeandforany reservationswhoseLO>stream(CMSclass)cannotbe ascertained.*IfyouomittheO date-time< parameter,VDEdoesnotretrieve reservationsDOfromtheCMSlibrary,onlymodulesand generations.,n OOIfthis qualifierisomitted,VDEcreatesanewCMSlibraryTOineach delta-filefacilityroot directoryitcreates.(Thisqual-KO5ifierhasnoeffectunlessyoualsousethe /DELTA_FILESO qualifier.oa?OIfthisqualiferis specified,allVDEstreams mustXbecre-Oated prior@toissuingthiscommand,andthesestreamnamesKO5mustmatch(asubsetof)theCMSclassnamesinuseinFOtheCMS libraries;thesestreamnamesmustmatchtheJOCMSclassestobeuploadedfromwithintheCMSlibrary.QO>Inorderto correctly establishthemainandvariantlinesofHOdescentandthecorrectCMS generationnumber sequence,KOallstreamsinvolvedmustbecreatedwiththe appropriate?OH/MAIN,/NOMAIN,/PARENTand /SUCCESSOR settings.p UO/LOG (default)O(/NOLOGLOControlswhetherlogmessagesareprintedwhendiskdirec-MOtoriesarecreated.(The/LOG qualifiercausessuchmessagesIO2tobeprintedandthe/NOLOG qualifier suppressesthem.KOThesemessagesindicatethenamesofthedisk directoriesKOthatVDEcreates.(The/BRIEFand/FULL qualifierscontrol1O<howmanylogmessagesareprinted.Nq M $OExamples O1. VDE>CREATE% LIBRARY/DEFERG Enter%the%name%you%want%for%the&new%library:%LIBNAMEM Enter% directory% specification%for%the&new%library:% [PROJDIR]Ve Enter%your&full%name%(first%and&last%names):% Zrebhasha% FulkutznodoyT Enter%the%remark&for%new%library:%Library%for%the&mumble%projectK Library&LIBNAME%to%be%created%in%root& directory% [PROJDIR]GD< Library&root% directory&DEV$:[PROJDIR]&has%been&created.ID Logical&name% VDE$LIBRARY%now&points%to%the%new&library.7D Creating%library& database;%please%wait...0D Library&database&has%been&created.' Library&creation& completed.4 VDE>4SHOW%LOCATION2| Directory% locations&for%stream%MAIN:BD Stream%root% directory%is%not&recorded&in&databaseT VDE>$TSHOW%LOCATION/DELTA_FILES2 Directory% locations&for%delta%files:FD Delta-file&root% directory&is&not%recorded%in%databaseEInthisexample,the/DEFER qualifiertotheCREATEDLIBRARYcommandpreventsdisk directoriesfrombeingOLcreatedforthe library'sdeltafilesanditsdefaultstream=MAIN.TheCREATELIBRARYcommandonlycreatesIthelibraryroot directoryDEV$:[PROJDIR],whereitalsoAU createstheVDE database.'TheSHOWLOCATIONcom-I mandsconfirmthatnoother directoriesarerecordedin theVDE database. O 2. VDE>/ SET%DIRECTORY/DELTA_FILES% [PROJDIR]Y %VDE-I-DIRADDED,& directory% specification& [PROJDIR]%added%to%the%databaseM %VDE-I-COMMIT,%database% transaction%has% successfully& committed\ VDE>1\ SET%DIRECTORY/STREAM&DISK2:[MAIN_DIR]` %VDE-I-DIRADDED,& directory% specification&DISK2:[MAIN_DIR]%added%to%the&databaseM %VDE-I-COMMIT,%database% transaction%has% successfully& committed4 VDE>nr! D;ASET DIRECTORYcommandthen specifiesthatGtheroot directory forthe library'sdeltafiles(itsA5CMS libraries)shouldbe directory [PROJDIR].TheBnormalruleusedwithinVDEistomake directoryBDEV$:[PROJDIR.VDE$CMS]the delta-fileroot directoryI>andtomakesubdirectorieswithinthat directorycontainKtheCMS librariesfor individual facilities.)AsecondSETC DIRECTORYcommand specifiesthattheroot directoryBHforstreamMAINis directoryDISK2:[MAIN_DIR].VDE? typicallymakesthe directoryDEV$:[PROJDIR.MAIN]Ntheroot directoryforstreamMAIN.Inthiscase,theuserHRwantsstreamMAIN'swhole directorytreeonaseparatedisk.sf 7)KThissequencesetsupthelibraryforthe followingcom-mands: OT3.T VDE>,TCREATE%DIRECTORY_TREE/DELTA_FILES7 Creating% directory%tree%for%delta%files:;D Root& directory%WORK4:[PROJDIR]%already%existsRD, Facility%CODE&root% directory&DEV$:[PROJDIR.CODE]%has&been%created?t CMS%library%for%facility%CODE%has%been%created9D All% directories%for&delta&files&now%existML %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE> VDE>'CREATE%DIRECTORY_TREE/STREAM7$ Creating% directory%tree%for%stream&MAIN:?Dl Root& directory%DISK2:[MAIN_DIR]&has%been&createdTD Facility%CODE&root% directory&DISK2:[MAIN_DIR.CODE]%has%been%created9D All% directories%for&stream%MAIN&now%existM %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE> VDE>$SHOW%LOCATION/DELTA_FILES2c Directory% locations&for%delta%files:6D Delta-file&root% directory:%DEV$:[PROJDIR]4D; Directory% locations&for%facility%CODE:/ Root& directory:%DEV$:[PROJDIR.CODE] VDE>SHOW%LOCATION/STREAM2[ Directory% locations&for%stream%MAIN:4D Stream%root% directory:&DISK2:[MAIN_DIR]D Subdirectory:pDISK2:[MAIN_DIR.VDE$BLD]&(symbol%VDE$BLD)4D{ Directory% locations&for%facility%CODE:1 Root& directory:%DISK2:[MAIN_DIR.CODE]A Subdirectory:pDISK2:[MAIN_DIR.CODE.OBJ]%(symbol&OBJ)AS Subdirectory:pDISK2:[MAIN_DIR.CODE.SRC]%(symbol&SRC)I Subdirectory:pDISK2:[MAIN_DIR.CODE.VDE$COM]%(symbol%VDE$COM)I Subdirectory:pDISK2:[MAIN_DIR.CODE.VDE$LOG]%(symbol%VDE$LOG)r VDE>= This section shows the results of two CREATE:: DIRECTORY_TREE commands.-Thefirstonecre-L atesthe directorytreeforthe library'sdeltafilesandJ createtheCMSlibraryforfacilityCODEinthatdirec-JC torytree.&Thesecondcommandcreatesthe directorytreeH forstreamMAIN.Asthelogmessagesshow,thedirec-E torytreebeginswithroot directoryDISK2:[MAIN_DIR]?Mas requested.(The subsequentSHOWLOCATIONcom-Kmandsconfirmthatalldisk directorieshavebeencreated&inthedesired locations. Ov4.v VDE>*vCREATE%FACILITY/DEFER%NEWFACILI Please%supply&required& information&for%facility% NEWFACIL:C Enter%a&remark%for%the&new% facility:%New&facilityHN %VDE-I-FACADDED,&facility&NEWFACIL&added&to&the%databaseM %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE>& VDE>9&SET%DIRECTORY/FACILITY=NEWFACIL% [PROJDIR.NEW]]n %VDE-I-DIRADDED,& directory% specification& [PROJDIR.NEW]%added%to%the&databaseM %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE>F VDE>CFCREATE%1DIRECTORY_TREE/FULL/FACILITY=NEWFACIL/DELTA_FILES7 Creating% directory%tree%for%delta%files:ZD Facility%NEWFACIL%root& directory%DEV$:[PROJDIR.NEWFACIL]%has%been%createdC CMS%library%for%facility%NEWFACIL%has&been%created9Df All% directories%for&delta&files&now%existM %VDE-I-COMMIT,%database% transaction%has% successfully& committed> VDE> VDE>7CREATE%%DIRECTORY_TREE/FULL/FACILITY=NEWFACIL7 Creating% directory%tree%for%stream&MAIN:UD Facility%NEWFACIL%root& directory%DEV$:[PROJDIR.NEW]%has&been%createdB] Subdirectory%DEV$:[PROJDIR.NEW.OBJ]%has%been%createdB Subdirectory%DEV$:[PROJDIR.NEW.SRC]%has%been%createdF Subdirectory%DEV$:[PROJDIR.NEW.VDE$COM]%has&been%createdF5 Subdirectory%DEV$:[PROJDIR.NEW.VDE$LOG]%has&been%created9D} All% directories%for&stream%MAIN&now%existM  %VDE-I-COMMIT,%database% transaction%has% successfully& committedU VDE>BInthisexample,theCREATEFACILITYcommandcre-Gatesanewfacility NEWFACIL,butdefersthecreationHuofdisk directoriesforthat facility.)ASET DIRECTORYBcommandthen specifiesthat directory [PROJDIR.NEW]O&shouldbethefacilityroot directoryforthedefaultstream6~MAIN.TwoCREATEDIRECTORY_TREEcommandsMfollow.)Thefirstonecreatesthe delta-fileroot directoryK0andCMSlibraryforthe facility.)ThesecondonecreatesLthedefaultstream's directorytreeforthe facility.*ThisP directorytreeconsistsofafacilityroot directoryandfourG9facilitysubdirectories.*The/FULL qualifiercausesVDEQtoprintslogmessagesforall directoriesitcreatesfortheM facility;withoutthis qualifier,VDEomitsthe subdirectoryClog messages. O5. VDE>$CREATE%STREAM% V2.0/DEFERC Please%supply&required& information&for%stream%V2.0:@P Enter%a&remark%for%the&new%stream:&Version%2.0C %VDE-I-STRMADDED,%stream%V2.0%added%to%the%databaseM %VDE-I-COMMIT,%database% transaction%has% successfully& committed( VDE>p VDE>pSET%STREAM%V2.0 VDE>SHOW%LOCATION/STREAM2 Directory% locations&for%stream%V2.0:BDH Stream%root% directory%is%not&recorded&in&database VDE>0SET%DIRECTORY/STREAM&[PROJDIR.VER_2]_ %VDE-I-DIRADDED,& directory% specification&[PROJDIR.VER_2]%added%to%the%databaseMh %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE> VDE>' CREATE%DIRECTORY_TREE/STREAM7@! Creating% directory%tree%for%stream&V2.0:CD! Root& directory%DEV$:[PROJDIR.VER_2]%has%been%createdXD! Facility%CODE&root% directory&DEV$:[PROJDIR.VER_2.CODE]%has&been%createdXD" Facility%SPEC&root% directory&DEV$:[PROJDIR.VER_2.SPEC]%has&been%createdXD_" Facility%TOOL&root% directory&DEV$:[PROJDIR.VER_2.TOOL]%has&been%created9D" All% directories%for&stream%V2.0&now%existM7# %VDE-I-COMMIT,%database% transaction%has% successfully& committed# VDE>?#TheCREATESTREAMcommandcreatesanewstreamJG$calledV2.0,butdeferscreatingthedisk directorytree>$forthatstream.+TheSETSTREAMcommandmakes?$V2.0thedefaultstream,andtheSHOWLOCATIONGP%commandshowsthatno directoriesarerecordedinthe@%VDEdatabaseforthatstream.+TheSET DIRECTORY>&command specifiesthat directory[PROJDIR.VER_2]JZ&shouldbetheroot directoryforthestream.'TheCREATE=&DIRECTORY_TREEcommandcreatesthefulldirec-N 'torytreeforstreamV2.0.'This directorytreeincludestheEd'streamroot directory specifiedbytheSET DIRECTORYN'command,afacilityroot directoryforeachfacilityintheI(system,andseveralfacilitysubdirectoriesforeachfa-Km(cility.)Becausethe/FULL qualifierisnot specified,VDEL(onlyprintslogmessagesforthestreamandfacilityrootE) directories,andnotforthefacilitysubdirectories.`6+*,DtOCREATEFACILITY*uvKOCreatesanewfacility definitionandits associateddisk6O( directoriesinthecurrentVDElibrary.&ORequiresCREFAC privilege.twJOFormat:OsCREATEFACILITYM facil-name[,facil-name...]x =O ParameterOs facil-nameROThenameofthenewfacilitytobecreated.'ThisnamecanbeMO$upto39 characterslongandmustfollowVDEnamesyntax.yNOOVDE prohibitsthecreationofany facilitieswithnamesthatKObeginwiththe character sequences ``VDE$'', ``VSC$'',andBO5 ``VTSC$'',astheseprefixesareusedwithinVDE.z gO DescriptionUOsAfacilityisthehighestlevelof organizationinaVDElibraryLOand identifiesasetofrelatedmodules.,Forexample,theOO$RMSfacilityiscomposedofallthemodulesneededtobuildFO|theRecord ManagementServicesportionoftheOpenVMSO operatingsystem.u{ KNOAllmoduleswithinagivenfacilitymusthaveuniquenames;OOnotwomodulesinthesamefacilitycanhavethesamemod-LO5ulenameandmoduletype.(If,however,twomodulesbelongNOto different facilities,theycanhavethesamemodulenameOandtype.E|LOTheVDElibrarystoresmodulesfromseparate facilitiesinLOseparatedisk directories.* Therefore,youmaywanttocre-NO5ateaseparatefacilityforeach componentofyoursoftware5Osystemthatis developedindependently.} aFOWhenyoucreatea facility,theCREATEFACILITYcom-POmandfirstcreatesanentryforthenewfacilityintheVDEPO5 database.+Itthencreatesadisk directorytoholdthedeltaPOfilesofthe facility'ssourcemodules.(VDEusescallableCMSMOtocreateaCMSlibraryinthat directory.+WhenyoulaterOO>createsourcemodulesinthe facility,VDEusescallableCMSTOtocreatedeltafilesforthosemodules.*Adeltafile(whichisPO identicaltoaCMS ``element'')containsallpastandpresentDOHversionsofyoursourcefileina compressedform.~ aEOTheCREATEFACILITYcommandalsocreatesadiskdi-ROrectory structure (directorytree)forthenewfacilityfortheNO5defaultstream.*This directory structureisrepeatedforallOOstreamsthatare successorsofthedefaultstream.)Thesedi-WO rectorieswillholdallfiles associatedwiththefacilitythatareLO>stream-specific.*Suchfilesinclude clear-copysourcefiles,ROobjectfiles,object libraries, executableimages,andotherde-OOrivedfiles.,Foreachstream,this structureconsistsofthe!OH following directories:!  `mLmafacilityroot directory,whichisa subdirectoryofthe!streamroot directory `EPEseveralfacilitysubdirectoriesthatwillcontainsourcefiles,Uderivedfiles,buildlogfiles,andcertainotherkindsoffiles.GThesubdirectoriesthatarecreateddependontheSETAO DIRECTORYcommandsyouhaveusedaswellasVDE defaults.,! NOIfthedefaultdisk directory structureisnotsuitableforOOthenew facility,youcandeferitscreationuntilyouhavePO5definedthe structureyouwant.)Todefercreationofthedi-KOrectory structure,usethe/DEFER qualifier.+ThenusetheHOSET DIRECTORYcommandtodefinethe directory structure@O>youwant.+Finally,usetheCREATEDIRECTORY_TREEBOcommandtocreatethedesired directory structure.FPO QualifiersOs/DEFERO/NODEFER (default)MO$ Specifieswhetherthecreationofthedisk directorystruc-LO|tureforthenewfacilityshouldbe postponed.*The/DEFERMO qualifier postponescreationofthedisk directory structureJO-andthe/NODEFER qualifiercausesthe directory structureJOtobecreated immediately.*Usethe/DEFER qualifierwhenNOthedefault directory structureis inappropriateforthenewO7 facility. kpMOIfthe/NODEFER qualifieris specified(or/DEFERisomit-DOted),theCREATEFACILITYcommandfirstcreatestheNO5 delta-file directoryforthefacilityandcreatesaCMSli-QObrarywithinthat directory.*ItthencreatesthefacilityrootQO directoryforthedefaultstream.)NextitcreatesthefacilityMO>subdirectorieswithinthatroot directory.)ThesubdirectoriesFOthatarecreatedare determinedbytheSET DIRECTORYOOcommandsenteredforthestreamandbythedefaultrulesofNOHtheVDEutility.*Oncethe directory structureexists,sourceROmodulesandotherfilescanbeaddedtothenew facility.(TheNOdirectory-creationsequenceisrepeatedforall successorsofORthedefaultstream.! afKOIfthe/DEFER qualifieris specified,theCREATEFACILITYKOcommanddoesnotcreatethe delta-file directory,northeNO5stream-specificroot directories,northe associated subdirec-GOtories.'Youcan thereforeenterSET DIRECTORYcommandsVOtospecifythedisk directoriesyouwantcreatedforthe facility.>O>YouthenusetheCREATEDIRECTORY_TREEcommandMOtocreatethe directory structureondisk accordingtotheGOrules specifiedbytheSET DIRECTORYcommandsandVDEOH defaults.! ^O/DELETEO( /NODELETE OControlswhethertheddelete0 attributeissetforthenewfa-UOcility.(This attributeallowsthefacilitytobedeletedwiththeCO2DELETEFACILITYcommand.(The/DELETE qualifiersetsQOthedelete attributesothatthenewfacilitycanbedeleted.MOThe /NODELETE qualifierclearsthedelete attributesothatRO<thenewfacilitycannotbedeletedunlessyoufirstresetthisDO attributewithaMODIFYFACILITYcommand.'MarkingaNOfacilityas /NODELETEmakesitharderto accidentallydeleteOEthe facility.zPROIfthis qualifierisnot specified,VDEusesthevalueoftheKOallow-deletionlibrary attribute.*Thelibraryallow-deletionNO5default attributecanbesetorresetbyusingthe/ALLOW_BODELETE qualifierontheCREATELIBRARYoronthe#OMODIFYLIBRARYcommand. h'O/FROM_CMS_LIBRARY[=date-time]TO( Specifiesthatthe delta-fileroot directoryforthenewfacilityKOalreadycontainsaCMSlibraryandthatVDEshouldenterMOallmodulesandmodule generationspresentinthatCMSli-PO2braryintothecurrentVDE database.'This qualifiergivesyouJOawayto automaticallypopulateaVDElibrarywithmod-TOulesfromanexistingCMSlibrary.'Ifthis qualifierisomitted,MO<VDEcreatesanewCMSlibraryinthe facility's delta-fileOroot directory. n)OIfyouspecifytheoptional date-time parameter,VDEad-KO ditionally retrievesall reservationsfromtheCMSlibraryPO5thatwerecreatedsincethedateandtimegivenbythatpa-JOrameter.(VDEprintswarningmessagesforany reservationsPOcreatedearlierthanthistimeandforany reservationswhoseLO>stream(CMSclass)cannotbe ascertained.*IfyouomittheO date-time< parameter,VDEdoesnotretrieve reservationsDOfromtheCMSlibrary,onlymodulesand generations.yOOOThis qualifierhasnoeffectifyoualsospecifythe/DEFERJO qualifier./Ifyoudefer directory creation,youmustuseInorderto correctly establishthemainandvariantlinesofHOdescentandthecorrectCMS generationnumber sequence,KOallstreamsinvolvedmustbecreatedwiththe appropriate?OH/MAIN,/NOMAIN,/PARENTand /SUCCESSOR settings.L! "O/LOG (default)O(/NOLOGNOControlswhetherlogmessagesareprintedafterthenewfa-NOcilitiesarecreated.)The/LOG qualifiercausesthemessagesNO2tobeprintedandthe/NOLOG qualifier suppressesthem.'TheLOmessagesindicatethateachnewfacilityhasbeencreated,QOthatitsCMSlibraryhasbeencreated,thatitsdiskdirecto-PO<rieshavebeencreated,andthatthedatabase transactionhas"O successfully committed.! ]O /PROPAGATE (default)O( /NOPROPAGATEEO Specifieswhether automaticchange propagationisal-MOlowedbydefaultfornewmodulescreatedinthis facility.LO2 /PROPAGATEcausesnewmodulesaddedtothefacilitytobeIOmarkedasallowing automaticchange propagationwhenre-DOservedand replaced.' /NOPROPAGATEmarkssuchmodulesIO<asnotallowingchange propagation.)WhenyoucreatenewROmodules,youcanoverridethesedefaultswith qualifierstothe"OCREATEMODULEcommand.! O/REMARK="string"PO( Specifiesaremarkstringtobestoredforthenew facility.OOThequotedremarkstring,whichcanbeupto132 charactersHOlong,maycontainany explanatoryremarkaboutthenewOO2facilitythatyouwantstoredintheVDE database.) TypicallyQOtheremark describesthefunctionorcontentsofthe facility. NPOAlthoughthis qualifieris required,youcanspecifyanemptyNOremarkstring.'Ifyoudonotspecifythe/REMARK qualifier,4O5VDEpromptsyouforaremarkstring. ] }OExamples O1. VDE>BCREATE%FACILITY%ACCTNG%/REMARK="Accounting% function"7 Creating% directory%tree%for%delta%files:^D" Facility%ACCTNG%root% directory%DEV$:[PROJDIR.VDE$CMS.ACCTNG]%has&been%createdAj CMS%library%for%facility%ACCTNG&has%been&created9D All% directories%for&delta&files&now%exist7B Creating% directory%tree%for%stream&MAIN:[D Facility%ACCTNG%root% directory%DEV$:[PROJDIR.MAIN.ACCTNG]%has&been%createdJ Subdirectory%DEV$:[PROJDIR.MAIN.ACCTNG.OBJ]&has%been&createdJ Subdirectory%DEV$:[PROJDIR.MAIN.ACCTNG.SRC]&has%been&createdNb Subdirectory%"DEV$:[PROJDIR.MAIN.ACCTNG.VDE$COM]%has%been%createdN Subdirectory%"DEV$:[PROJDIR.MAIN.ACCTNG.VDE$LOG]%has%been%created9D All% directories%for&stream%MAIN&now%existF %VDE-I-FACADDED,&facility&ACCTNG%added%to%the%databaseM %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE>HThisexamplecreatesanewfacilitycalledACCTNG.TheLremarkstring indicatesthatthisfacilityperformsanac-J1countingfunctionintheuser'ssoftwaresystem.)ThelogImessagesindicatethatthe delta-filedisk directoryhasGbeencreated,thataCMSlibraryhasbeen establishedM;inthat directory,thatafacilityroot directoryandvar-JiousfacilitysubdirectorieshavebeencreatedforstreamLMAIN,andthatthefacilitywas successfullyaddedtotheD  database.#,+-@OCREATEFOLD*U+IOCreatesanewfoldrecordintheVDE database..AfoldLO(recordisareminderthatasourcechangeshouldbeman-OOually ``folded''intoagiven developmentstreaminorderto!O propagatethechange.&OuRequiresRESREP privilege.lBOFormat2OsCREATEFOLDMmod-name[, mod-name...] P}O ParameterOsmod-nameMO Specifiesamoduleforwhichafoldrecordistobecre-HO$ated./ThemodulenameconsistsofanoptionalfacilityFO|nameenclosedinsquare brackets,amodulename,andFOanoptionaltypenameprecededbyaperiod(suchasGO-[FACIL]MOD1.MAR).Ifthefacilitynameisomitted,theOOmoduleisassumedtobelongtothedefault facility.,IftheQOtypenameisomitted,VDEcreatesfoldrecordsforallsourcePO7moduleswiththe specifiedmodulenameinthegiven facility.K !POYoucancreatefoldrecordsformorethanonemodulebyus-LOingwildcard charactersinanyofthethree componentsofOO5themodulename.'Thepercentsign( % )inanamematchesPOanysingle characterinthepositionitoccupiesandtheas-Oterisk( ]*C)matcheszeroormore charactersinthepositionOO>it occupies.)VDEcreatesfoldrecordsforthesourcemodules6Owhosenamesmatchthewildcardpattern. cxO DescriptionOOsAfoldrecordisarecordintheVDEdatabasethatremindsOOausertomanually``fold''asourcechangefromonedevel-LO$opmentstreamintoanother.)Afoldrecordiscreatedwhen9O|theREPLACEorPERFORM REPLACEMENTcommandNOattemptsto propagateasourcechangefromagivendevelop-SO-mentstreamtooneofits successors,butfindsthatitcannotKO automatically propagatethechangebecausethesourcemod-MOulehasalreadydivergedbetweenthetwostreams.(TheuserMO7mustthenreservethemoduleinthe successorstream,man-QOuallyeditthechangeintothat generationofthemodule,andNOthenreplaceit.,This operationisknownas ``folding''theKOAchangeintothe successorstream.+Oncethefold operationMOhasbeen performed,itsfoldrecordshouldbedeletedfromKOtheVDEdatabasewiththe/FOLD qualifiertotheREPLACE8OJcommandorwiththeCANCELFOLDcommand. COTheCREATEFOLDcommandletsyoumanuallyenteraOOfoldrecordintotheVDE database.*ThisfoldrecordanditsMO5remarkstringcanserveasaremindertoperformsomeac-NOtionona specifiedmoduleina specifiedstream.*OnceyouMOhave performedthisaction,youcandeletethefoldrecordCO>withtheCANCELFOLDcommand.*ThenewfoldrecordHOrecordsthatsomechangeshouldbe propagatedfromtheOOlatest generationofthe specifiedmoduleinthedefaultde-JOH velopmentstreamintoanother developmentstreamthatyouOspecify.! O QualifiersOs/CONFIRMO /NOCONFIRM (default)LO$ControlswhetherVDEasksyoutoconfirmthatyouwantaIO|foldrecordcreatedforeachmodule.(The/CONFIRMqual-NOifiercausesVDEtoprintamessageforeachmoduleaskingQO-whetheryouwanttocreateafoldrecordforthatmodule.(IfQOyouanswerYES(orY),VDEcreatesafoldrecordforit.)IfQOyouanswerNO(orN),VDEdoesnotcreateafoldrecordforMO7it.+Ifyouenteramodulenamewithawildcard specifica-UOtion,VDEasksyoutoconfirmthecreationofafoldrecordforKOeachmodulewhosenamematchesthewildcardspecification.HOAThe /NOCONFIRM qualifiercausesVDEtocreatethefold6Orecordswithoutaskingfor confirmation.W U-"O/FROM_STREAM=stream-nameGO( Specifiesthe developmentstreamfromwhichthesource*Ochangeshouldbefolded.,The stream-name parameterMOgivesthenameofthestream.-Ifyouomitthis qualifier,KO2VDE determineswhat generationyouwanttofoldbylook-OOingupthelatest generationforthecurrentdefaultstream.OOVDEthenrecordsthatyouwanttofoldthechangefromthe\CREATE%FOLD&X.FOR/STREAM=V1.0/REMARK="Fix&access% violation%in%sort%routine"[ %VDE-I-FOLDADDED,%fold&record%1&for%module% [CODE]X.FOR%added%to%databaseM" %VDE-I-COMMIT,%database% transaction%has% successfully& committedj VDE> VDE>SHOW%FOLD; Fold&1%of%[CODE]X.FOR;2(2)%into&stream%V1.0 26-JUN-1990%JONESB VDE>CThisexamplecreatesanewfoldrecordformoduleC  [CODE]X.FOR.Theremark indicatesthatasortrou-Lbtineaccess violationshouldbefixedinthatmodule.)TheHchangeshouldbemadeinstreamV1.0.(ThelogmessageJshowsthatVDEassignedtheuniquefold identifier1toBkthenewfoldrecord.(TheSHOWFOLDcommandshowsCthatthefoldrecordisnowintheVDE database.$"-,.AOCREATEGROUP*& ?OOCreatesanewgroup definitionintheVDE database.'AgroupNO(iseitherasourcegrouporabuildgroup.+AsourcegroupSOconsistsofasetofsourcemodulestobeacteduponwhentheJOgroupnameis specifiedwithvarioussourcecontrolcom-SO2mands.)AbuildgroupconsistsofasetofmodulestobebuiltIOwhenthegroupnameis specifiedwithaBUILDcommand.&O&RequiresCREGRP privilege.|ROFormatBOsCREATEGROUPM group-name=mod-name[, mod-name...] =O ParametersOs group-nameOOThenameofthenewgrouptobecreated.'ThisnamemaybeMO$upto39 characterslongandmustfollowVDEnamesyntax.! Omod-namePO(Thenameofamoduletobeincludedinthegroup.'Themod-MOulenameconsistsofanoptionalfacilitynameenclosedinLOsquare brackets,amodulename,andanoptionaltypenameIO2precededbyaperiod.)Anexampleis[FACIL]MOD1.PAS.IfVOnofacilitynameis specified,thecurrentdefaultfacilityisas-SOsumed.'Ifnotypenameis specified,allsourcemodules(foraSO<sourcegroup)orallmodule(forabuildgroup)withthegivenPOmodulenameinthegivenfacilityareincludedinthegroup. aAOYoucanaddmanymodulestothegroupwithonemod-OnameBP parameterby specifyingwildcard charactersinanyJO5ofthethree componentsofthemodulename.*ThepercentSOsign( % )inanamematchesanysingle characterinthepo-5Ositionitoccupiesandtheasterisk( 2*$d)matcheszeroormoreNO> charactersinthepositionit occupies.)ThosesourcemodulesMO(forasourcegroup)ormodules(forabuildgroup)whoseHOnamesmatchthewildcardpatternbecomemembersoftheOHnewgroup. Z`O DescriptionKOsAgroupconsistsofthesetofmodulesthataremembersMOofthegroup.*Asourcegrouponlyconsistsofsourcemod-PO$ules.(Whenthenameofasourcegroupis specifiedwiththe:O|RESERVE,REPLACE,FETCH, UNRESERVE,orSHOWCO RESERVATIONcommand,thatcommandactsonallmod-IO-ulesthataremembersofthegroup.-AbuildgroupcanJOconsistsofbothsourcemodulesandderivedmodules,al-KOthoughitnormallyonlyconsistsof executableimagesandMO7otherderivedmodulesthatcanbetheoutputsofasystemPObuild.)Whenthenameofabuildgroupis specifiedwiththeIOBUILDcommand,thatcommandbuildsallmodulesthatare"OAmembersofthegroup. NTOWhenanewgroupiscreated,itisonlydefinedinthedefaultJO developmentstream.+Youcanrefertothenewgrouponlygroupwithinthestream.B! NOWhenanew developmentstreamiscreated,allgroupdefini-POtionsfromtheparentstreamarecopiedtothechildstream.QO5If modified,thegroup definitionsthenevolve independentlyin)Othetwo developmentstreams. F{O QualifiersOs/BUILDO/SOURCE (default)NO$ Specifieswhetherasourcegrouporbuildgroupiscreated.LO|The/SOURCE qualifiercausesVDEtocreateasourcegroupPOandthe/BUILD qualifiercausesVDEtocreateabuildgroup.QO-Ifneither qualifieris specified,VDEcreatesasourcegroup.i??OOf/BUILDand/SOURCE,/SOURCEisthedefault.! ^O/CONFIRMO( /NOCONFIRM (default)IOControlswhetherVDEasksyoutoconfirmthatyouwant%Oeachmodulematchingthe'mod-name parametersaddedtoJO2thegroup.)The/CONFIRM qualifiercausesVDEtoprintaJOmessageforeachmatchingmoduleaskingwhetheryouwantKOthatmoduleadded.*IfyouanswerYES(orY),themoduleNO<isaddedtothegroup.*IfyouanswerNO(orN),themod-JOuleisnotaddedtothegroup.*The /NOCONFIRM qualifier;OcausesVDEtoaddallmodulesmatchingthemod-nameIOE parameterstothegroupwithoutaskingfor confirmation." O/LOG (default)O(/NOLOGIOControlswhetherlogmessagesareprintedafterthenewMOgrouphasbeencreated.(The/LOG qualifiercausesthemes-IO2sagestobeprintedandthe/NOLOG qualifier suppressesJOthem.*ThemessagesindicatethatthenewgrouphasbeenHOcreated,thatthe requestedmodulesaremembersoftheGO<group,andthatthedatabase transactionhas committedO successfully. O/REMARK="string"RO( Specifiesaremarkstringtobestoredforthenewgroup.'TheJOquotedremarkstring,whichcanbeupto132 charactersHOlong,maycontainany explanatoryremarkaboutthenewLO2groupthatyouwantstoredintheVDE database.* TypicallyMOtheremark describesthepurposeorcontentsofthegroup.[ OExamples O1. VDE>ECREATE%GROUP/REMARK="Two%modules"%GRP1&=%A.PAS,&B.MARA %VDE-I-GRPADDED,&group&GRP1%added%to%the&databaseI" %VDE-I-GRPADD,%module% [CODE]A.PAS%is%added%to%group%GRP1Ij %VDE-I-GRPADD,%module% [CODE]B.MAR%is%added%to%group%GRP1M %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE>FhThiscommandcreatesanewsourcegroupcalledGRP1.CThenewgroupcontainstwomembers,sourcemodulesDA.PASandB.MAR.ThesemodulesarereservediftheBrgroupnameis specifiedwiththeRESERVEcommand,Dforexample.,BothmodulesareassumedtobelongtoK#thecurrentdefault facility,facilityCODEinthisexam-J|ple.*Theremarkstring``Two modules''isstoredintheMdatabasewiththerestofthegroup definitionandcanbeA- retrievedlaterwiththeSHOWGROUPcommand.)TheHexampleshowsthe informationalmessagescreatedbytheF/LOG qualifier, specifiedbydefaultinthisexample. OV2.V VDE>?VCREATE% GROUP/BUILD%SYSGRP%=%X.EXE,%Y.EXE,&Z.HLBC %VDE-I-GRPADDED,&group&SYSGRP%added%to%the%databaseQ %VDE-I-GRPADD,%module%[BUILD_TEST]X.EXE%is%added%to%group%SYSGRPQ. %VDE-I-GRPADD,%module%[BUILD_TEST]Y.EXE%is%added%to%group%SYSGRPQv %VDE-I-GRPADD,%module%[BUILD_TEST]Z.HLB%is%added%to%group%SYSGRPM %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE>Gu ThiscommandcreatesanewbuildgroupcalledSYSGRP.G Thebuildgroupcontainsthreemembers, executableim-F& agesX.EXEandY.EXEandthehelplibraryZ.HLB.IfE~ groupnameSYSGRPis specifiedasa parametertoaC BUILDcommand,VDEwillbuildthesethreemodules. 0 /1G$OCREATE REPLACEMENT*%&mGOCreatesanewqueued replacementintheVDE database.&OkRequiresRESREP privilege.s'IOFormat9OsCREATE REPLACEMENTNrep-name[, rep-name...](O ParameterOsrep-nameLOThenameofthenew replacementtobecreated.(ThisnameMO$canbeupto39 characterslongandmustfollowVDEnameO|syntax.)O DescriptionJOsWhenauserhasreservedandmodifiedoneormoremod-HOulesandthenusestheREPLACEcommandtoreplacetheLO$modulesintotheVDElibary,VDEeitherreplacesthemod-LO|ules immediatelyorcreatesaqueued replacementforthem.GOAqueued replacementisarecordintheVDEdatabaseLO-thatrecordsthatthemodulesshouldbereplacedintotheMOlibraryatafuturetime,afterthemoduleshavebeenre-EOviewedandwhenan authorizeduserentersaPERFORM?O7 REPLACEMENTcommandforthe replacement.)WhetherDOtheREPLACEcommandreplacesthemodules immediatelyOOorcreatesaqueued replacementis determinedbya qualifierNOAtothatcommandorbyan attributeonthestreamsaffectedObythe replacement.,* IOAlthoughqueued replacementsarenormallycreatedbytheBOREPLACEcommandwhenyoureplacemodules,youcanEO5createaqueued replacementdirectlywiththeCREATE=O REPLACEMENTcommand..AfteryouhavecreatedaJOqueued replacementwiththiscommand,youcanaddmoduleFO> reservationstothe replacementwiththeREPLACEcom-IOmandbyusingthe /REPLACEMENT qualifiertospecifytheO replacementname.+O QualifiersOs/LOG (default)O/NOLOGIO$ControlswhetherlogmessagesareprintedafterthenewHO| replacementsarecreated.,The/LOG qualifiercausestheLOmessagestobeprintedandthe/NOLOG qualifier suppressesFO-them.+Themessagesindicatethateachnew replacementHOhasbeencreatedandthatthedatabase transactionhas"O successfully committed.,VO/REMARK="string"OO( Specifiesaremarkstringtobestoredforthenewreplace-JOment.+Thequotedremarkstring,whichcanbeupto132JO characterslong,maycontainany explanatoryremarkaboutFO2thenew replacementthatyouwantstoredintheVDEO database.- NPOAlthoughthis qualifieris required,youcanspecifyanemptyNOremarkstring.'Ifyoudonotspecifythe/REMARK qualifier,4O5VDEpromptsyouforaremarkstring.. |OExamples O1. VDE>BCREATE% REPLACEMENT%NEWREP/REMARK="Replacement%remark"I %VDE-I-REPADDED,& replacement&NEWREP%added%to%the%databaseM" %VDE-I-COMMIT,%database% transaction%has% successfully& committedj VDE> VDE>K REPLACE/QUEUE/REPLACEMENT=NEWREP&A.REQ&"Fix%access& violation"S %VDE-I-FILCOPSTAG,%file%DEV$:[MYDIR]A.REQ;13%copied%to%staging%areaPB %VDE-I-REPLQUE,%module& [CODE]A.REQ&queued%for% replacement%NEWREPM %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE> VDE>&PERFORM% REPLACEMENT%NEWREPXb %VDE-I-REPLACED,& generation%[CODE]A.REQ;8(6A2)&replaced&into%stream&V2.09 %VDE-I-REPPERF,% replacement%NEWREP& performedM %VDE-I-COMMIT,%database% transaction%has% successfully& committed9 VDE>=Thisexamplecreates a new replacement calledBNEWREPand specifiesaremarkstringforit.-TheAYREPLACEcommandthenaddsa reservationformod-Bule [CODE]A.REQtothe replacement.+The subsequent7 PERFORM REPLACEMENTcommandreplacesthat*cmoduleintotheVDElibrary.2 13CQOCREATESESSION*RZS! 0HOCreatesanew reservationsessionintheVDE database.OO(Sessionsareusedtogroup reservationsintheVDE database.QO Attributesofasessionincludethesessionnamenameandthe"Osessionremarkstring.&OuRequiresRESREP privilege.wTMOFormat=OsCREATESESSIONM session-name[,session-name...]U =O ParameterOs session-nameQOThenameofthenewsessiontobecreated.'ThisnamecanbeMO$upto39 characterslongandmustfollowVDEnamesyntax.V ZO DescriptionDOsWhenauserreservesoneormoremoduleswiththeDO/SESSION qualifiertotheRESERVEcommand,VDEcre-NO$atesa reservationsessionandmakesthemodule reservationsPO|membersofthatsession.)A reservationsessionisthusasetMOofmodule reservationsthatbelong together.( Additionalmod-OO-ule reservationscanbeaddedtothesessionwith additionalFORESERVE commands.(WhenthemodulesarelaterreplacedQOintotheVDElibrary,theusercanspecifythesessiontobeFO7replaced(usingthe/SESSION qualifiertotheREPLACEMOcommand)insteadoflistingallthemodules individually.)AROsessionthusmakesiteasytoreplaceasetofrelatedmodule,OA reservationsasasingleunit.WauJOAlthough reservationsessionsarenormallycreatedbytheCORESERVEcommand,youcancreateasessiondirectlyCO5withtheCREATESESSIONcommand.,Thissessionini-KOtiallycontainsnomodule reservations.+YoucanlateraddJOmodule reservationstothesessionwiththeRESERVEcom-KO>mand,usingthe/SESSION qualifiertospecifythesessionHOname.+Toremoveanexisting non-emptysession,usethe?OUNRESERVE/SESSIONcommand.*Toremoveanexisting>OHemptysession,usetheCANCELSESSIONcommand.X! O QualifiersOs/LOG (default)O/NOLOGOO$Controlswhetherlogmessagesareprintedafterthenewses-OO|sionsarecreated.(The/LOG qualifiercausesthemessagestoJObeprintedandthe/NOLOG qualifier suppressesthem.)TheNO-messagesindicatethateachnew reservationsessionhasbeenKOcreatedandthatthedatabase transactionhas successfullyO committed.zY KPO/REMARK="string"RO( Specifiesaremarkstringtobestoredforthenew reservationMOsession.*Thequotedremarkstring,whichcanbeupto132JO characterslong,maycontainany explanatoryremarkaboutMO2thenewsessionthatyouwantstoredintheVDE database.Z NPOAlthoughthis qualifieris required,youcanspecifyanemptyNOremarkstring.'Ifyoudonotspecifythe/REMARK qualifier,4O5VDEpromptsyouforaremarkstring.[ OExamples O1. VDE>NCREATE%SESSION& FIX-SORT-BUG% /REMARK="Fix%bug&in&sort%routine"K %VDE-I-SESADDED,&session% FIX-SORT-BUG&added&to&the%databaseM" %VDE-I-COMMIT,%database% transaction%has% successfully& committedj VDE> VDE>IRESERVE% [SYS]SORT.PAS%/SESSION=FIX-SORT-BUG%"Fix%sort&bug"S %VDE-I-FETCHED,% generation%[SYS]SORT.PAS;4(2A2)%fetched&from%libraryBB %VDE-I-OUTFILE,%output&file%is%DEV$:[MYDIR]SORT.PAS;b %VDE-I-RESERVED,&module% generation&[SYS]SORT.PAS;4(2A2)&reserved&from%stream&MAINM %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE>?Thisexamplecreatesanewsession calledFIX-DSORT-BUGand specifiesaremarkstringforit.,TheC9RESERVEcommandthenaddsa reservationformodule* [SYS]SORT.PAStothesession.I;324@\OCREATESTEP*]!^! 5NODefinesanewbuildstepintheVDE database.'ThiscommandPO(letsyoudefineacopysteporspecifytheinputandoutput2Omodulesofacompileorlinkstep.'ORequiresCRESTEP privilege.~_ TOFormatDOsCREATESTEPM step-mod-name=mod-name[, mod-name...]U`! +O ParametersOs step-mod-nameNOThenameofthemodulethatis compiled,copied,orlinkedOO$bythebuildstep.(ThisnameconsistsofamodulenameandLO|atypename separatedbyaperiod(suchas MOD1.PAS)andPOmayincludeafacilitynameenclosedinsquarebrackets(suchCO-as[FACNAM]MOD1.PAS).Themodulenamemaynotcon-ROtainwildcard characters.(Ifnofacilitynameis specified,the2Ocurrentdefaultfacilityisassumed.ajROIfthestepisacompilestep,thismoduleisrecordedasanTOinputtothestep.,Ifthestepisalinkstep,thismoduleisUO5recordedasanoutputofthestep.*Ifthestepisacopystep,QOthismoduleisrecordedasthemodulethatiscopied(fetchedOout)bythestep.bOmod-nameQO(ThenameofamodulethatyoudeclaretobeaninputtoorLOoutputfromthebuildstep.+Thisnameconsistsofamod-GOulenameandatypename(forexample, MOD1.OBJ)andIO2mayincludeafacilitynameenclosedinsquarebracketsHO(forexample,[FACNAM]MOD1.OBJ).IfnofacilitynameisCO specified,thecurrentdefaultfacilityisassumed.c cKOYoucandeclaremanymodulestobeinputstooroutputsOOfromthebuildstepby specifyingwildcard charactersinanyJO5ofthethree componentsofthemodulename.*ThepercentSOsign( % )inanamematchesanysingle characterinthepo-5Ositionitoccupiesandtheasterisk( 2*$d)matcheszeroormoreMO> charactersinthepositionit occupies.*ThosemoduleswhoseMOnamesmatchthewildcardpatternarerecordedasinputsto.Ooroutputsfromthebuildstep.dVMOIfanoutputmoduleyouspecifydoesnotalreadyexistinGOthe database,theCREATESTEPcommandaddsittotheHO5 database.-InputmodulesmustalreadybedefinedintheMO database,however.(Also,youcannotspecifyasourcemodule-Oasanoutputofabuildstep.eROIfyouspecifythe/COPY qualifiertocreateacopystep,youOmustomitthegmod-name)H parametersandthe precedingRO5equalsign( = ).*AcopystepfetchesamodulefromitsCMSOOlibrary,buthasnoinputsoroutputsotherthanthemoduleOgivenbythe step-mod-name parameter.f! ZO DescriptionKOsTobeabletoperformminimalsystembuilds,VDErecordsLOallinputsandoutputsforeachbuildstep.,Thisinforma-NO$tionisknownas``build dependencyinformation.''(ThebuildKO| dependency informationfromallbuildstepsisknowncol-KO lectivelyasthe``build dependencygraph.''* Normally,VDEGO-collectsbuild dependency information automaticallywhenNOyouperformsystembuilds.)However,forsomebuildstepsitQOisnotpossibletocollectthis informationautomatically;somePO7 compilersandothertoolsdonotmakethis informationavail-OOabletoVDE.Forsuchbuildsteps,youmustusetheCREATEGOSTEPcommandtoenterthebuild dependency information#OAintotheVDE database.gWMOYoucandefinethreekindsofbuildstepswiththeCREATEMOSTEPcommand:(compilesteps,linksteps,andcopysteps.)AO5compilestepu5 processesthe_5 step-mod-name5moduleandMOpossiblyotherinputmodulestoproduceoneormoreoutputMOmodules.* Typically,acompilesteprunsacompilerofsomeQO>sortonasourcemodule,buttheexact semanticsofthestepJOare determinedbytheVDEscriptthat generatestheDCL-Ocommandsthatperformthestep.ph! F OAlinkstepproducesthe step-mod-namemoduleandLOpossiblyotheroutputmodulesfromoneormoreinputmod-MO5ules.- Typically,alinksteprunsthelinkertoproduceaNO shareableor executableimage,butagaintheexact semanticsMOare determinedbytheVDEscript associatedwiththestep.MO>Sinceascriptcanperformanyactionyouwant,acompileTOstepneednotrunacompilerandalinkstepneednotruntheMOlinker.*ToVDE,theonlyreal differencebetweenacompileWOHstepandalinkstepisthatacompilestepisnamedforoneofQOtheinputmoduleswhilealinkstepisnamedforoneoftheOoutputmodules.i! t OAcopystep4copiesthe step-mod-name^modulefromoneTOplacetoanother.( Normally,acopystepisusedtofetchoutaQO5sourcemodulefromitsdeltafile(CMSelement)intoaclear-ROcopyfilethatcanbeuseddirectlyby subsequentbuildsteps.LOForexample,Cprograms generallyincludevarious.HfilesTO>intheircompilesteps.)Acopystepisneededforeach.HfileSOtofetchitfromitsCMSlibraryintoatextfilethatsubse-MOquentcompilestepscanuse.+ Likewise,linkeroptionsfilesQOH(.OPTfiles)mustbefetchedoutbeforeyoucanusethemforNO subsequentlinksteps.*YoumustcreateacopystepforanyOOmodulethatmustbefetchedintotheVDE library's directoryPORtreeduringbuildsbutwhichdoesnotneedanyseparatepro-QOcessingtoproduceotheroutputmodules.'Foracopystep,theRO specifiedmodulecanbeseenasboththeinputandtheoutputO[ofthestep.j WCOTheCREATESTEPcommanddeletesall dependencyin-OO formationforthebuildstepbefore recordingtheinputsandIO5outputsyouspecify.*Thus,youcanusetheCREATESTEPEOcommandto completelyreplacethe dependencyinforma-QOtionforabuildstep.(Tochangeonlysomeofthe dependencyFO> informationforastep,usetheMODIFYSTEPcommand.Ok%LOBuild dependency informationisalwaysspecifictothede-JOfault developmentstream.( Different developmentstreamsinOO5asoftwaresystemcontain differentversionsofthecodeand@O generallyhave differentbuild dependencygraphs.l! WOOTodefinethesamebuildstepformorethanone developmentHOstream,youmustusetheCREATESTEPcommandforeachKO5stream.'Foreachstream,firstentertheSETSTREAMcom-LOmandtosetthe developmentstream,thenentertheCREATEJOSTEPcommandtoenterthedesired build-step dependenciesO>intothe database.2mJOWhenanew developmentstreamiscreated,thebuildde-IOpendencygraphfromtheparentstreamiscopiedtotheFO5childstream.-Thebuild dependencygraphthenevolves/O independentlyinthetwostreams.cn 9O QualifiersOs/COMPILE (default)O/COPYO$/LINKRO| Specifieswhetherthebuildstepisacompilestep,copystep,JOorlinkstep.)The/COMPILE qualifiercausesVDEtomark?O-thestepasacompilestepandtorecordthe- step-mod-OnameCP parameterasaninputmoduletothecompilestep.NOThe/COPY qualifiercausesVDEtomarkthestepasacopy$O7stepandtorecordthe|7 step-mod-name27 parameterastheQOmodulethatiscopiedbythestep.'The/LINK qualifiercausesKOVDEtomarkthestepasalinkstepandtorecordthestep-OAmod-name:1A parameterasanoutputmoduleofthelinkOstep.ro HHOOf /COMPILE,/COPYand/LINK,/COMPILEisthedefault.p O/INPUT (default)O(/OUTPUT!O Specifieswhetherthedmod-name#D parametersarerecordedKOasinputstooroutputsfromthebuildstep.,The/INPUTQO2 qualifierrecordsmodulesasinputstothebuildstepandthePO/OUTPUT qualifierrecordsthemasoutputsofthestep.'IfnoPO qualifieris specified,allmodulesareassumedtobeinputs.tq JOOTosetthedefaultforthecommandasawhole,specifytheFO qualifieraftertheCREATESTEP keywords.,TooverrideUO5thatdefaultforasinglemodule,specifythe qualifieraftertheOmod-name=0 parameteryouchoosetomarkasaninputorOoutput.hr>>OOf/INPUTand/OUTPUT,/INPUTisthedefault.=s O/LOG (default)O(/NOLOGKOControlswhetherlogmessagesareprintedafterthebuildNOstepisrecordedinthe database.)The/LOG qualifiercausesKO2themessagestobeprintedandthe/NOLOG qualifiersup-NOpressesthem.)ThemessagesindicatethatthebuildstephasQObeencreated,thatthe specifiedmodulesareinputsoroutputsPO<forthestep,andthatthedatabase transactionhas committedO successfully.6t  OExamples O1. VDE>3CREATE%STEP&FOO.MAR%=%FOO.$OBJ/OUTPUTV %VDE-I-COMSTEPADDED,%compile&step%for& [CODE]FOO.BAR%added%to%databaseW' %VDE-I-MODINSTEP,%module% [CODE]FOO.MAR%is%an%input%to%the%build%step\o %VDE-I-MODOUTSTEP,%module&[CODE]FOO.$OBJ&is&an&output%from&the%build%stepM %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE>FnThiscommandcreatesabuildstep definitionfortheC compilationofmoduleFOO.MAR.Thestepisacom-Jpilestepbecausethe/COMPILE qualifieristhedefault.JxFOO.MARisrecordedasaninputtothestepandmoduleKFOO.$OBJisrecordedasanoutputfromthestep,asthe)logmessagesshow. O2. VDE>JCREATE% STEP/LINK%MOD1.EXE%=% MOD1.$OBJ,& MOD2.$OBJ,%FOO.$OBJT %VDE-I-LNKSTEPADDED,%link&step%for&[CODE]MOD1.EXE&added&to&database\; %VDE-I-MODOUTSTEP,%module&[CODE]MOD1.EXE&is&an&output%from&the%build%stepY %VDE-I-MODINSTEP,%module%[CODE]MOD1.$OBJ&is&an&input&to&the%build%stepY %VDE-I-MODINSTEP,%module%[CODE]MOD2.$OBJ&is&an&input&to&the%build%stepX %VDE-I-MODINSTEP,%module%[CODE]FOO.$OBJ%is%an%input%to%the&build&stepM[ %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE>BThiscommandcreatesthebuild dependencyinforma-Ejtionforthebuildstepthatlinksmodule MOD1.EXE.HModuleMOD1.EXEistheoutputofthestepandmodulesB  MOD1.$OBJ, MOD2.$OBJ,andFOO.$OBJaretheinputs. O 3. VDE>T CREATE%STEP/COMPILE/OUTPUT&[CODE]MOD4.FOR&=% MOD4.$OBJ,%[CODE]MOD4.LISW %VDE-I-COMSTEPADDED,%compile&step%for&[CODE]MOD4.FOR&added&to&databaseX. %VDE-I-MODINSTEP,%module%[CODE]MOD4.FOR%is%an%input%to%the&build&step]v %VDE-I-MODOUTSTEP,%module&[CODE]MOD4.$OBJ%is%an%output%from%the%build%step\ %VDE-I-MODOUTSTEP,%module&[CODE]MOD4.LIS&is&an&output%from&the%build%stepM %VDE-I-COMMIT,%database% transaction%has% successfully& committedN VDE>#N SHOW% STEP/FULL&MOD4.FOR4 Compile&Step%for&module%[CODE]MOD4.FOR6D Dependency&links&for%stream%V2.1%follow'D& Inputs%to%the&build&step: n Module%[CODE]MOD4.FOR*D Outputs&from%the&build&step:! Module%[CODE]MOD4.$OBJ F Module%[CODE]MOD4.LIS6D Build%step&has%1&inputs%and%2%outputs VDE>ATheCREATESTEPcommanddefinesthecompilestepDformoduleMOD4.FORinfacilityCODEashavingone>=inputmodule (MOD4.FOR)andtwooutputmodules< (MOD4.$OBJand MOD4.LIS).TheSHOWSTEPcom-Fmandconfirmsthatthesebuild dependencieshavebeen,GenteredintotheVDE database. O4. VDE>)CREATE% STEP/COPY% [CODE]MOD5.HR  %VDE-I-COPSTEPADDED,%copy&step%for& [CODE]MOD5.H%added%to%databaseVT %VDE-I-MODINSTEP,%module% [CODE]MOD5.H&is&an&input&to&the%build%stepZ %VDE-I-MODOUTSTEP,%module& [CODE]MOD5.H%is%an%output%from%the%build%stepM %VDE-I-COMMIT,%database% transaction%has% successfully& committed, VDE>HThisexamplecreatesacopystepformoduleMOD5.HinIfacilityCODE.VDErecordsthe specifiedmoduleasbothQLtheinputandtheoutputofthestepsinceacopystepsim-Kplycopiesthe specifiedmodulefromoneformtoanotherG (normallyfromits delta-fileformto text-fileform).8 `!OTable3-1:8KeyNames O OFKey-nameFVT100*F LK201,LK401DefaultVDEUsage Ob  OPF1 PF1 PF1,SetsGOLDstate O$PF2 $PF2 $PF2,$GetsHelp OPF3 PF3 PF3,none OPF4 PF4 PF4,SetsBLUEstate$OKP0,KP1-KP9ukeypad0-9keypad0-9,NoneO PERIOD periodkey periodkey, NoneOCOMMA&commakeycommakeyNoneOMINUSminuskeyminuskey,NoneOxENTER&xENTERkeyENTERkeyNoneOE1,E2 -! Find,InsertHereKNoneOlE3,E4 l-l Remove,SelectNone OE5 - PreviousScreen`None O_E6 _-_NextScreenNoneOHELP -Help/F15,GetsHelp OSDO S-SDo/F16,SNoneOF17-F20 -F17-F20',Setsdefaultsto libraries O 6 57BODEFINE/COMMAND*AGODefinesacommand abbreviationby associatingasymbol@O(namewithalistofoneormoreVDE commands.pFOFormat6OsDEFINE/COMMANDMsymbol-name="command-string" FO ParametersOs symbol-nameLO Specifiesthesymbolnamethatyouwant associatedwithaLO$listofVDE commands.*Thesymbolcanbeupto255char-OO|acterslongandcanincludeletters,digits, underscores,and@Odollarsigns.)Itcannotstartwithadigit.)Ifi symbol-name tisRO-alreadydefined,thenew definitionreplacestheold definition. ]Ocommand-stringMO( SpecifiesthestringofVDEcommandsto associatewiththeEOsymbolname.,ThecommandstringmustbeenclosedinQO quotationmarksandconsistsofthefirstpartofaVDEcom-MO2mand,awholecommand,oralistofcommands separatedbyO semicolons. O Description;OsTheDEFINE/COMMANDcommand associatesasym-AObolnamewithaVDEcommandstring..ThecommandHO$stringconsistsofzeroormoreVDEcommands separatedIO|by semicolonsandmustendwithapartialorfullVDEOcommand.EOpWhenthesymbolnameappearsatthe beginningofaFOVDEcommand,thesymbolnameisreplacedbyitsas-FO!sociatedcommandstring./The resultingstringisthenGOzparsedandexecutedasanormalcommandlinebyVDE.>ODEFINE/COMMANDthusgivesyouthesamecommandJO+ abbreviation capabilityasthesymbol assignment statementFO (symbol-name:=command-string)inDCL.Symbolsubsti-MOtutiononlyhappensonceatthe beginningofeachcommand.GO4Asymbol's associatedcommandstringcan thereforenot0Obeginwithanothercommandsymbol.EOTodisplaythe currentsymbol definitionscreated by;ODEFINE/COMMAND,usetheSHOWSYMBOLcommand.M#O QualifiersOs None. OExamples O1. VDE>/DEFINE/COMMAND&SM&=%"SHOW%MODULE" VDE>SM&MOD1! Module%[FACIL]MOD1.MARe VDE>8ThisDEFINE/COMMANDcommand associatesthe@,symbolSMwiththeVDEcommand``SHOW MODULE''.AWhentheSMcommandisused,SMisexpandedto>the equivalentcommandstring..ThemodulenameM5MOD1isthen concatenatedtothatstringtoformthefull8commandSHOWMODULEMOD1,whichVDEthen executes. O_2.d VDE>NdDEFINE/COMMAND&STRMFAC%=%"SET&STREAM%V5.3;%SET%FACILITY%RMS" VDE>STRMFAC VDE>SHOW%DEFAULTS?< Library&LIBNAME%in%root% directory%DEV$:[PROJDIR]. Default& directory%is% DEV$:[SMITH]$ Current&session%context:#D Default&stream%is%V5.3$D\ Default&facility&is&RMS VDE> VDE>JZThisexampleshowsthatasymbolcanbe associatedwith?multiple commands.+HeresymbolSTRMFACisasso-B ciatedwithbothaSETSTREAMcommandandaSETBd FACILITYcommand,wherethetwocommandsaresep-D aratedbya semicolon.'WhentheSTRMFACcommandisI entered,thecommandstringis substitutedforthesym->n bolnameandtheSETSTREAMandSETFACILITYD commandsare executed.)Theoutputfroma subsequent< SHOWDEFAULTScommandshowsthatthedefaultGw streamandthedefaultfacilityhavebeensetbythe STRMFACcommand.-769>O DEFINE/KEY*<LODefinesakeytoexecuteaVDEcommand.)Akey definitionNO(letsyoutoenteracommandbypressingakeyratherthanHOtypingthecommand.,The/KEY qualifierisrequiredand0Omustprecedeanyother qualifiers.`6OFormat&Os DEFINE/KEYNkey-namestring=O ParametersOskey-nameAO Specifiesthenameofthekeyyouare defining.Table3-1EO$containsalistofcommonkeysoncommon keyboards.*c? _UNote _EYoucannotredefinethearrowkeysorfunctionkeysvF1throughF14. p KFOstringOO( Specifiesthestringthatisenteredwhenyoupressthede-Ofinedkey.String5canbeanyVDEcommand,suchasSHOW@ODEFAULTSorSETCONTEXT.TopreservespacesandMO2 lowercase characters,enclosethestringin quotationmarks.# MO DescriptionEOsThe DEFINE/KEYcommand,oncertain terminals,enablesSOyoutoassign definitionstokeysotherthanthoseonthemainLO$ keyboard.)Thecommandcanbeusedonavarietyoftermi-JO|nals includingtheVT340,VT510andtheDECtermterminalO emulator.COpThestring parametertothe DEFINE/KEYcommandcanLOcontain differenttypesof informationandusuallyconsistsHO!ofanentireVDEcommand.+Forexample,youcanassignBOztheSHOWDEFAULTScommandtoKP0.)Then,whenyouNOpresszeroonthekeypad,VDEdisplaysyourcurrentdefaultUO+ settings.'Other definitionscanconsistoftextstringstobeap-LOpendedtocommandlines.*WhenyoudefineakeytoinsertKOatextstring,usethe /NOTERMINATE qualifiersoyoucanPO4continuetypingmoredataafterthestringhasbeen inserted.! NQOInmost instancesyouwillwanttousetheechofeature.'TheQO/ECHO qualifierdisplaysthekey definitiononthescreeneachHO5timeyoupressthekey.&Thedefaultsettingis/ECHO.! aQOYoucancreateasmany definitionsforakeyasyouwantasOOlongasyouspecifyanewcontextforeach definition.+This%O5newcontextiscalleda5 state/A5.)Tocreate additionalkeydefi-NOnitionsyoumustusetwosteps.'First,usingthe /SET_STATEVO qualifier,youmustdefineakeythat establishesastatefortheOO> definitionyouwanttocreate.(ThenyoumustcreatethenewPO definitionforyourkeyandspecifyitsstateusingthe/IF_OSTATE qualifier.! WQOStatenamescanincludeletters,digits,dollarsigns,andun-NO derscores.'CreatestatenamesthatareeasytorememberandRO5typeandthatremindyouofthetypesof definitionsyoucre-LOated.)Forexample,youcancreateastatecalledSETSHOW.QOThekey definitionsforthisstatemightrefertovariousVDE#O>SETandSHOW commands.Z 0MOLikevariousother utilitiesonOpenVMS,VDEsuppliesthreeIObuilt-instatescalledDEFAULT,GOLD,andBLUE.YoucanOO5assign different definitionstokeysusedin combinationwithKOtheGOLDandBLUEkeysbyusingthe /IF_STATE qualifier.! QOBy convention,theGOLDstateisselectedbypressingthePF1POkey,andtheBLUEstateisseectedbypressingthePF4key.HOTheSETKEYcommandchangesthekeypadstate.)UsetheIOSHOWKEYcommandtodisplaykey definitionsandstates.=O QualifiersOs/ECHO (default)O/NOECHOIO$ Specifieswhetherthecommandlineis displayedonyourOO|screenafteryoupressthedefinedkey.)Youcannotdefinea+ DEFINE/KEY%KP1&"SHOW& DEFAULTS"FThisexampleshowshowtodefinethekeypadkeyKP1@YastheVDEcommandSHOW DEFAULTS.ToentertheASHOWDEFAULTScommand,pressKP1followedbythe RETURNkey. O2. VDE>= DEFINE/KEY%KP6&"SET%CONTEXT%BUGFIX"& /TERMINATEAThisexampleshowshowtodefinethekeypadkey9O6astheSETCONTEXTBUGFIXcommand..The: /TERMINATE qualifiercausestheSETCONTEXT@BUGFIXcommandtoexecutewhenyoupresskeypad5Ykey6withouthavingtopressRETURN. O3. VDE>B DEFINE/KEY%MINUS%"SHOW% DEFAULTS"& /TERMINATE%/NOECHOD@Thisexampleshowshowtodefinetheminuskeyon=thekeypadastheSHOWDEFAULTScommand.+The< /TERMINATE qualifiercausestheSHOWDEFAULTSGIcommandtoexecutewhenyoupresstheminuskey.'TheF/NOECHO qualifierpreventsthedisplayofthecommandJlineonthescreen.*Youseetheoutputofthecommand,/Sbutnotthecommandlineitself. O4. VDE>3DEFINE/KEY/TERMINATE&KP7%"SHOW%MODULE": VDE>-: DEFINE/KEY/SET_STATE=TEXAS&PF3%"" VDE>D #DEFINE/KEY/IF_STATE=TEXAS/TERMINATE&KP7%"SHOW% FACILITY"K Thisexampleshowshowtocreatetwo definitionsfortheAI KP7keyusingthe /SET_STATEand /IF_STATEqual-C ifiers.,ThefirstcommanddefinesKP7astheSHOW< MODULEcommandandexecutesthecommandwhenNS thekeyispressed.)Thisisthedefaultkey definitionforJ KP7.&Thesecondcommand establishesanewstatefortheL key:(whenyoupressPF3,thestateissettoTEXAS.TheF\ thirdcommandcreatesanew definitionforKP7:)when> youpressKP7,VDEexecutestheSHOWFACILITYG commandifthestatehasbeensettoTEXAS.YoucanAf thusexecutetheSHOWMODULEcommandbypressingG KP7byitself,andyoucanexecutetheSHOWFACILITYFcommandbypressingthePF3keyfollowedbytheKP7pkey. O5. VDE>6 DEFINE/KEY%PF3&"SET%"%/SET_STATE=ALTERED5 VDE>K5 DEFINE/KEY%KP7&"CONTEXT&BUGFIX"% /TERMINATE%/IF_STATE=ALTERED} VDE>N} DEFINE/KEY%KP8&"CONTEXT& FEATURE_1"% /TERMINATE%/IF_STATE=ALTERED VDE>B DEFINE/KEY%KP9&"VERIFY"& /TERMINATE%/IF_STATE=ALTEREDK4Thisexampleshowshowtodefinefour differentkeysand: associatethemwithastatenamedALTERED:! Jm1.JThefirst definitiondefinesthekeyPF3astheSETDYcommandand associatesthiskeywithastatenamedYALTERED.G2.JThesecond definitiondefinesthekeypadkey7as?Y ``CONTEXTBUGFIX''andmakesit dependentonaAYOstatenamedALTERED.WhenyoupressPF3followed?Ybykeypadkey7,VDEexecutestheSETCONTEXTYBUGFIXcommand.A3.JThe third definitiondefines keypadkey 8 as;Y ``CONTEXT FEATURE_1''andalsomakesitde-=Y0pendentontheALTEREDstate.,WhenyoupressEYPF3followedbykeypadkey8,VDEexecutestheSET&YCONTEXT FEATURE_1command.Ba4.JThefourth definitiondefineskeypadkey9as>Y ``VERIFY''andalsomakesit dependentonthe:YALTEREDstate..WhenyoupressPF3followed>Yjbykeypadkey9,VDEexecutestheSETVERIFYYcommand.97:BODELETE/COMMAND* AaOODeletescommand definitions establishedwiththeDEFINE/COMMANDO(command.pFOFormat6OsDELETE/COMMANDNsymbol-name[,symbol-name...]O ParameterOs symbol-nameIO Specifiesthenameofacommandsymbolwhose definitionPO$istobedeleted.)Thissymbolmusthavebeendefinedwitha,O|previousDEFINE/COMMANDcommand.M#O QualifiersOs None.mOExamples O1. VDE>#DELETE/COMMAND&FOO,%FEEFThisexampleshowshowtodeletethecommanddefini--TtionsforsymbolsFOOandFEE. : 9;>O DELETE/KEY* KODeleteskey definitionsthathavebeen establishedbytheGO( DEFINE/KEYcommand.(The/KEY qualifierisrequiredand0Omustprecedeanyother qualifiers.Z0OFormat Os DELETE/KEYM [key-name] =O ParameterOskey-nameVO Specifiesthenameofthekeytobedeleted.'Ifyouspecifythis9O$ parameter,donotusethe/ALL qualifier.C! O QualifiersOs/ALLVODeletesallkey definitionsinthe specifiedstate;thedefaultisSO$thecurrentstate.'(Usethe/STATE qualifiertospecifystates.)NO|Ifyouusethe/ALL qualifier,donotspecifyakeyname.3 K O/LOG (default)O(/NOLOGLOControlswhethermessagesare displayed indicatingthattheOO specifiedkey definitionshavebeendeleted.'/LOGcausessuchEO2messagestobe displayedand/NOLOG suppressesthem.#O/STATE=(state-name[,...])O(/NOSTATE (default)OO Specifiesthenameofthestateforwhichthe specifiedkeyNO definitionistobedeleted..Thedefaultstateisthecur-KO2rentstate./Ifyouspecifyonlyonestatename,youcanJOomitthe parentheses.*Statenamescanbeany appropriateO alphanumericstring.{ OExamples O1. VDE>6 DEFINE/KEY%PF3&"SHOW&LIBRARY"& /TERMINATE? %VDE-I-DEFKEY,%DEFAULT&key%PF3%has&been%defined) VDE>  M 'PF3 #M ?q VDE>&SHOW%LIBRARY? Library&LIBNAME%in%root% directory%DEV$:[PROJDIR] VDE> DELETE/KEY%PF3?I %VDE-I-DELKEY,%DEFAULT&key%PF3%has&been%deleted VDE> _ aM PF3 #aM  VDE>DOInthisexample,the DEFINE/KEYcommanddefinestheCPF3keyonthekeypadasSHOWLIBRARY.Laterthe> DELETE/KEYcommand undefinesthePF3key.(WhenJYtheuserpressesPF3 thereafter,onlytheVDEpromptis displayed. O)2.) VDE>)DELETE/KEY/ALL?q %VDE-I-DELKEY,%DEFAULT&key%PF1%has&been%deleted? %VDE-I-DELKEY,%DEFAULT&key%PF2%has&been%deleted? %VDE-I-DELKEY,%DEFAULT&key%PF3%has&been%deleted?I %VDE-I-DELKEY,%DEFAULT&key%PF4%has&been%deleted VDE>AKeysPF1throughPF4hadbeendefinedforstate=XDEFAULT.Inthisexample,the DELETE/KEYcom-Nmanddeletesallkey definitionsinthecurrentstate,thatC is,stateDEFAULT.Thelogmessagesshowwhatkey+b  definitionshavebeendeleted.9; :<HODELETE ARCHITECTURE*LODeletesoneormore architecturetableentriesintheVDE8O( database.'Each architecturetableentry...,ORequirestheDELARCH privilege.g==O ARCHITECTUREsupportisnotfully implemented.vLOFormat:DELETE% ARCHITECTURE%VAXPDP/REMARK="Version%n" VDE> IUnderConstruction...<;=EODELETE BUILD_JOB*~FODeletesoneormorebuildjobsfromthecurrentVDEO( database.%ORequiresBUILD privilege.wMOFormat=OsDELETE BUILD_JOBM stream-name[,stream-name...]FO ParameterOs stream-nameFOThenameofa developmentstream.-OneormorebuildNO$jobsinthisstreamaredeletedfromthe database.+UsetheGO|/IDENTIFICATION qualifiertospecifythebuildjobstoQOdelete.+Ifyoudonotspecifythis qualifier,themostrecent3O-buildjobinthestreamisdeleted.WPOYoucandeletebuildjobsformorethanonestreambyusingJOwildcard charactersinthestreamname.*ThepercentsignRO5( % )inanamematchesanysingle characterintheposition-Oitoccupiesandtheasterisk( [*+)matcheszeroormorechar-ROactersinthepositionit occupies.*BuildjobsaredeletedforFO>thosestreamswhosenamesmatchthewildcardpattern. UO DescriptionDOsTheDELETE BUILD_JOBcommanddeleteseachbuildjobOOthatmatchesthe specifiedstreamnameandbuildjobidenti-QO$ficationnumbers.(Whenabuildjobisdeleted,all informationRO|aboutthatbuildjobisdeletedfromthedatabaseofthecur-SOrentVDElibrary.'YoucannotdeleteabuildjobthatisqueuedMO-for executionorthatis currentlyrunning.+TodeletesuchHOabuildjob,stopitusingtheSTOP BUILD_JOBcommand"Obeforeyoudeleteit. }O QualifiersOs/CONFIRMO /NOCONFIRM (default)IO$ControlswhetherVDEasksyoutoconfirmthatyouwantKO|eachbuildjobdeleted.(The/CONFIRM qualifiercausesVDELOtoprintamessageforeachbuildjobaskingwhetheryouOO-wantthatbuildjobdeleted.+IfyouanswerYES(orY),theQObuildjobisdeletedfromthe database.)IfyouanswerNO(orMON),thebuildjobisnotdeleted.(The /NOCONFIRM qualifierOO7causesVDEtodeletethe specifiedbuildjobswithoutaskingOfor confirmation.! "O/IDENTIFICATION=id-rangeTO( Specifiesthejobidentificationnumbersofthebuildjobstobe5Odeletedfromthe specifiedstream.+Theid-rangeVparam-SOetercanbeasingleintegervalue,arangeof integers,oraPO2wildcard character.(Ifthe parameterisasingleinteger(forIOexample, /IDENT=5),VDEdeletesthebuildjobwiththatQOidentificationnumber.'Ifthe parameterisarangeofintegersMO< (specifiedastwobuildjobidentificationnumbers separatedRObyacolonasin /IDENT=3:5),VDEdeletesallbuildjobswithFOidentificationnumbersinthatrange.'Finally,iftheid-rangeBOE parameteristheasteriskwildcard(asin/IDENT= uQ*E),VDEAOdeletesallbuildjobsforthe specifiedstream. WSOIfyouspecifyazeroornegativebuildjobidentificationnum-Oberintheid-range4C parameter,thatnumberisrelativetoQO5theidentificationnumberofthemostrecentbuildjobinthePOstream.+Forexample,ifthemostrecentbuildjobisjob5,FOthen/IDENT=0is equivalentto/IDENT=5and /IDENT=-1'O>is equivalentto /IDENT=4.FOIfyoudonotusethe/IDENTIFICATION qualifier,VDENOdeletesthemostrecentbuildjobforthe specifiedstream. UO/LOG (default)O(/NOLOGLOControlswhetherlogmessagesareprintedaftereachbuildMOjobisdeleted.+The/LOG qualifiercausessuchmessagestoJO2beprintedandthe/NOLOG qualifier suppressesthem.)TheROmessagesindicatethatthebuildjobhasbeendeletedfromtheLOdatabaseandthatthedatabase transactionhas successfullyO< committed.u ! KKO/REMARK="string"SO( SpecifiesadeletionremarkstringtobestoredinthedatabaseROforthedeletedbuildjob.&Thequotedremarkstring,whichcanLObeupto132 characterslong,maycontainany explanatory@O2remarkthatyouwanttostoreinthe database.@  OExamples O1. VDE>4DELETE% BUILD_JOB%V2.0-3/IDENTIFICATION=7X %VDE-I-BLDJOBDEL,%build%job%7%for%stream&V2.0-3%deleted&from%databaseM" %VDE-I-COMMIT,%database% transaction%has% successfully& committedj VDE>MInthisexample,buildjob7forstreamV2.0-3isdeletedF1fromtheVDE database.*ThelogmessagesconfirmthatNthebuildjobwasdeletedandthatthedatabase transaction" successfully completed.= <>C ODELETECONTEXT* h  >MODeletesoneormorecontextsfromthecurrentVDElibrary.NO(Eachcontextcanbeusedtospecifythedefault developmentMOstream,default architectureanddefaultfacilityforaVDEOsession.DOuRequiresCRECTX privilegetodeletepublic contexts.oEOFormat5OsDELETECONTEXTMctx-name[, ctx-name...]y OO ParameterOsctx-nameMOThenameofacontexttobedeletedfromthecurrentVDEOO$library.*YoucandeletemorethanonecontextatatimebyLO|usingwildcard charactersinthecontextname.(ThepercentSOsign( % )inanamematchesanysingle characterinthepo-5O-sitionitoccupiesandtheasterisk( 29*$d-)matcheszeroormoreNO charactersinthepositionit occupies.)Thosecontextswhose=Onamesmatchthewildcardpatternaredeleted.uKO Description>OsTheDELETECONTEXTcommanddeleteseachspeci-FOfiedcontextfromthecurrentVDE database.-Thecom-OO$manddeleteseitherpubliccontextsoryourprivate contexts,EO| dependingonwhetheryouspecifythe/PUBLICortheO/PRIVATE qualifier.b Z8O QualifiersOs/CONFIRMO /NOCONFIRM (default)IO$ControlswhetherVDEasksyoutoconfirmthatyouwantHO|eachcontextdeleted.)The/CONFIRM qualifiercausesVDEOOtoprintamessageforeachcontextaskingwhetheryouwantPO-thatcontextdeleted.)IfyouanswerYES(orY),thatcontextOOisdeletedfromthe database.)IfyouanswerNO(orN),theOOcontextisnotdeleted.+IfyouenteracontextnamewithaNO7wildcardspecification,VDEasksyoutoconfirmthedeletionLOofeachcontextwhosenamematchesthewildcard specifica-IOtion.)The /NOCONFIRM qualifiercausesVDEtodeletetheBOA specifiedcontextswithoutaskingfor confirmation. UO/LOG (default)O(/NOLOGNOControlswhetherlogmessagesareprintedaftereachcontextOOhasbeendeleted.'The/LOG qualifiercausessuchmessagestoLO2beprintedandthe/NOLOG qualifier suppressesthem.'TheseOOmessagesindicatethatthecontexthasbeendeletedfromtheLOdatabaseandthatthedatabase transactionhas successfullyO< committed. O/PRIVATE (default)O(/PUBLICOOControlswhetheraprivateorpubliccontextisdeleted.)TheLO/PRIVATE qualifiercausesVDEtodeleteacontextthatisPO2privatetoyou.'The/PUBLIC qualifiercausesVDEtodeleteaTOcontextthatis availabletoallusersofthelibrary.(YoumustIOhavetheCRECTX privilegetousethe/PUBLIC qualifier.o KEO/REMARK="string"SO( SpecifiesadeletionremarkstringtobestoredinthedatabaseOOforthedeletedcontext.'Thequotedremarkstring,whichcanLObeupto132 characterslong,maycontainany explanatory=O2remarkthatyouwantstoredinthe database. OExamples O1. VDE> DELETE%CONTEXT&V2RMSF %VDE-I-CTXDEL,%context&V2RMS&deleted%from%the%databaseM" %VDE-I-COMMIT,%database% transaction%has% successfully& committedj VDE>@ThisexampledeletesthecontextV2RMSfromtheJ1 database.(Becausethe/PUBLIC qualifierisnot specified,>VDEdeletestheprivatecontextbythisname.w> =?DODELETEFACILITY* PODeletesoneormoredelete-enabled facilitiesfromthecurrentO(VDElibrary.&ORequiresDELFAC privilege.tJOFormat:OsDELETEFACILITYM facil-name[,facil-name...] VO ParameterOs facil-nameNOThenameofafacilitytobedeletedfromthecurrentVDEPO$library.*YoucandeletemorethanonefacilityatatimebyMO|usingwildcard charactersinthefacilityname.(ThepercentSOsign( % )inanamematchesanysingle characterinthepo-5O-sitionitoccupiesandtheasterisk( 29*$d-)matcheszeroormorePO charactersinthepositionit occupies.)Those facilitieswhose=Onamesmatchthewildcardpatternaredeleted.! PO DescriptionBOsTheDELETEFACILITYcommanddeleteseach specifiedHOfacilityfromthecurrentVDEdatabaseandcommitstheSO$ transaction.'Itthendeletesalldisk directories associatedwithOO|each facility.'Whenthedeletioncommand completes,thefilesNOandCMSlibrary associatedwiththefacilitywillhavebeenOO- vaporized.(Should protection violationsorothererrorsoccur,NOVDEcanbe preventedfromdeletingall associatedfilesandNO directories,andVDEwillgenerateoneormore informational=O7messagesthatwillprovide additionaldetails.o! E6OYoucanonlydeleteafacilityifthe7delete O attributeisenabledSOonthe facility.*Ifthis attributeis disabled,youmustenableAO5this attribute,usingtheMODIFYFACILITY/DELETEKOcommand,beforeyouwillbeabletodeletethe facility.j! Z@O QualifiersOs/CONFIRMO /NOCONFIRM (default)IO$ControlswhetherVDEasksyoutoconfirmthatyouwantIO|eachfacilitydeleted.)The/CONFIRM qualifiercausesVDEPOtoprintamessageforeachfacilityaskingwhetheryouwantVO-thatfacilitydeleted.'IfyouanswerYES(orY),thatfacilityisROdeletedfromthelibrary.'IfyouanswerNO(orN),thefacil-VOityisnotdeleted.'IfyouenterafacilitynamewithawildcardNO7specification,VDEasksyoutoconfirmthedeletionofeachLOfacilitywhosenamematchesthewildcardspecification.(TheHO /NOCONFIRM qualifiercausesVDEtodeletethe specified9OA facilitieswithoutaskingfor confirmation. UO/LOG (default)O(/NOLOGOOControlswhetherlogmessagesareprintedaftereachfacilityOOhasbeendeleted.'The/LOG qualifiercausessuchmessagestoLO2beprintedandthe/NOLOG qualifier suppressesthem.'ThesePOmessagesindicatethatthefacilityhasbeendeletedfromtheKOlibraryandthatthedatabase transactionhas successfullyO< committed.i K?O/REMARK="string"SO( SpecifiesaremarkstringtobestoredinthedatabasefortheNOdeleted facility.)Thequotedremarkstring,whichcanbeupLOto132 characterslong,maycontainany explanatoryremark8O2thatyouwanttostoreinthe database.5   OExamples O1. VDE>"DELETE%FACILITY%ACCTNGH %VDE-I-FACDEL,%facility%ACCTNG%deleted%from&the%databaseM %VDE-I-COMMIT,%database% transaction%has% successfully& committede VDE>FInthisexample,facilityACCTNGisdeletedfromtheH,currentVDElibrary.)ThelogmessagesconfirmthattheGfacilitywasdeletedandthatthedatabase transaction" successfully completed. OU2.Z VDE>.ZDELETE%FACILITY%FAC1,%FAC2,%FAC3F %VDE-I-FACDEL,%facility%FAC1&deleted%from%the%databaseF %VDE-I-FACDEL,%facility%FAC2&deleted%from%the%databaseF2 %VDE-I-FACDEL,%facility%FAC3&deleted%from%the%databaseMz %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE>K1Thisexampleshowshowyoucandeletemultiple facilitiesQfromalibrary.'Thelogmessageslistthe facilitiesthataredeleted.? >@@!ODELETEFOLD*"\#2MODeletesoneormorefoldrecordsfromtheVDE database.)ALO(foldrecordisareminderthatasourcechangeshouldbeNOmanually ``folded''intoagiven developmentstreaminorder%Oto propagatethechange.&OuRequiresRESREP privilege.l$BOFormat2OsDELETEFOLDMmod-name[, mod-name...]% P}O ParameterOsmod-nameGO Specifies a!module for which a fold record is!to beIO$deleted..Themodulenameconsistsofanoptionalfacil-FO|itynameenclosedinsquare brackets,amodulename,KOandanoptionaltypenameprecededbyaperiod(suchasGO-[FACIL]MOD1.MAR).Ifthefacilitynameisomitted,theOOmoduleisassumedtobelongtothedefault facility.,IftheQOtypenameisomitted,VDEdeletesfoldrecordsforallsourcePO7moduleswiththe specifiedmodulenameinthegiven facility.K& !POYoucandeletefoldrecordsformorethanonemodulebyus-LOingwildcard charactersinanyofthethree componentsofOO5themodulename.'Thepercentsign( % )inanamematchesPOanysingle characterinthepositionitoccupiesandtheas-Oterisk( ]*C)matcheszeroormore charactersinthepositionOO>it occupies.*VDEdeletesfoldrecordsforallsourcemodules6Owhosenamesmatchthewildcardpattern.' FO DescriptionOOsAfoldrecordisareminderthatasourcechangeshouldbeNOmanuallyfoldedintoagiven developmentstreaminordertoHO$ propagatethechangeintothatstream.(TheDELETEFOLDIO|commanddeleteseach specifiedfoldrecordfromtheVDEDO database.,ThiscommandisasynonymfortheCANCELO-FOLDcommand.(mO QualifiersOs/CONFIRMO /NOCONFIRM (default)IO$ControlswhetherVDEasksyoutoconfirmthatyouwantHO|eachfoldrecorddeleted.+The/CONFIRM qualifiercausesNOVDEtoprintamessageforeachfoldrecordaskingwhetherKO-youwantthatrecorddeleted.,IfyouanswerYES(orY),MOthatfoldrecordisdeletedfromthe database.,Ifyouan-ROswerNO(orN),thefoldrecordisnotdeleted.*IfyouenterGO7amodulenamewithawildcardspecification,VDEasksMOyoutoconfirmthedeletionoffoldrecordsforeachmod-GOulewhosenamematchesthewildcardspecification.,TheHOA /NOCONFIRM qualifiercausesVDEtodeletethe specified+DELETE%FOLD&[CODE]X.FOR/IDENT=1X %VDE-I-FOLDDEL,%fold%record%1%for%module& [CODE]X.FOR&has%been&deletedM" %VDE-I-COMMIT,%database% transaction%has% successfully& committedj VDE>>This example deletes fold!record!1!for moduleD1 [CODE]X.FOR.Thelogmessagesconfirmthatthefold3recordhasbeen successfullydeleted.E@?AF.ODELETE GENERATION*/0! PODeletesthemostrecent generationofa specifiedmodulefrom,O(a specified developmentstream.'ORequiresPERFREP privilege.r1HOFormat8OsDELETE GENERATIONNmod-name[, mod-name...]2! PO ParameterOsmod-nameMOThenameofamodulewhoselatest generationinthespec-MO$ified developmentstreamistobedeleted.)ThemodulenameRO|consistsofanoptionalfacilitynameenclosedinsquarebrack-MOets,amodulename,andanoptionaltypenameprecededbyLO-aperiod,suchas[FACIL]MOD1.MAR.IfnofacilitynameisRO specified,thedefaultfacilityisassumed.*IfnotypenameisQO specified,thelatest generationsofallsourcemodulesoftheJO7 specifiedmodulenameinthegivenfacilityaredeleted.x3! NIOYoucandeletethelatest generationsofmorethanoneJOmodulebyusingwildcard charactersinanyofthethreePO5 componentsofthemodulename.(Thepercentsign( % )inaMOnamematchesanysingle characterinthepositionitoccu-%Opiesandtheasterisk( o*4)matcheszeroormore charactersinQO>thepositionit occupies.)VDEdeletesthelatest generationinMOthe specifiedstreamofeachmodulewhosenamematchestheOwildcardpattern.4HOUsingthe /GENERATION qualifier,youcanalsodeletea?O generationthatdoesnotbelongtoanystream.?5O Description@OsTheDELETE GENERATIONcommandremovesthelatestLO generationofa specifiedmodulefroma specifieddevelop-IO$mentstreamandmakestheprevious generation(thenextLO|mostrecent generation)intothelatest generationfortheQOstream.(Theresultisthatthemostrecent generationisdis-MO-cardedfromthestream,sothattheeffectoftheREPLACEAO operationthatcreatedthat generationisundone.6 GOTheremoved generationremainsintheVDEdatabaseasMOlongasitremains reachablefromatleastone developmentKO5streamorhasatleastone successor generation.+However,GOoncearemoved generationbecomes unreachablefromallEOstreamsandhasno successors,theDELETE GENERATIONIO>commanddeletesit completelyfromtheVDEdatabaseandOlibrary..7NOYoucannotdeletethefirst generationofamodule(genera-QOtion1)usingthiscommand.(TheonlywaytodeletethefirstKO5 generationistodeletethewholemodulewiththeDELETEOMODULEcommand.8! QOIfthe specifiedmoduleis currentlyreservedinthe specifiedROstream,VDE terminatesthat reservationsinceitisbasedonaPO5module generationthatnolongeristhelatest generationforPOthestream.'VDEsendsamailmessagetonotifytheownerof=Othe reservationthatthe reservationislost.9 WPOIfyouwanttodeleteamodule generationthatdoesnotbe-DOlongtoany developmentstream,usethe /GENERATIONMO5 qualifier.(Donotusethe /GENERATION qualifierforagen-MOerationthatbelongstoastream;VDEwillnotdeleteanyTO generationthatbelongstoastreamorthatisnotaleafnode$O>inthe generationtree.:! O QualifiersOs/CONFIRMO /NOCONFIRM (default)IO$ControlswhetherVDEasksyoutoconfirmthatyouwantFO|each generationdeleted.+The/CONFIRM qualifiercausesLOVDEtoprintamessageforthelatest generationofeachEO-modulegivingthenameofthe generationandaskingHOwhetheryouwanttodeletethe generation..Ifyouan-QOswerYES(orY),the generationisdeleted.'IfyouanswerNOGO7(orN),the generationisnotdeleted.+The /NOCONFIRMOO qualifiercausesVDEtodeleteeach generationwithoutaskingOfor confirmation.@; O/GENERATION=gen-exprKO( Specifiesthatthe generationwiththeCMS generationex-"OpressiongivenbytheWgen-expr* parameterbedeleted.'IfyouOOspecifythis qualifier,donotspecifythe/STREAM qualifier.< UO/LOG (default)O(/NOLOGLOControlswhetherlogmessagesareprintedafter generationsMOaredeleted.)The/LOG qualifiercausessuchmessagestobeGO2printedand/NOLOG suppressesthem.)Themessagesindi-QOcatethatthe generationshavebeendeletedfromthe specifiedIO developmentstreamandthatthedatabase transactionhas"O< successfully committed.=O/REMARK="string"IO( SpecifiesaremarkstringthatexplainswhyyoudeletedMOthe generation.)Thequotedremarkstringcanbeupto132O characterslong.m> KCO/STREAM=stream-namePO( Specifiesthatthelatest generationinthe developmentstreamOgivenbythe" stream-name+h parameterbedeleted.+IfbothJOthis qualifierandthe /GENERATION qualifierareomitted,4O2VDEpromptsyouforthestreamname.P? &OExamples O1. VDE>;DELETE% GENERATION&[FACIL]MODNAM.C% /STREAM=V2.0W %VDE-I-GENDEL,% generation&[FACIL]MODNAM.C;5(5)&deleted%from%stream%V2.0MC %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE> VDE>+SHOW% GENERATION%[FACIL]MODNAM.C* Generation&[FACIL]MODNAM.C;4(4)_ by&user%SMITHo  onK 9-MAY-1990&19:43c VDE>EThisexampledeletesthelatest generationofmodule>*[FACIL]MODNAM.CfromstreamV2.0.*Thelogmes-Jsageshowsthat generation5wasdeleted.'The subsequent9SHOW GENERATIONcommandshowsthatgenera-M4tion4isnowthelatest generationofthemoduleinthestream.A @BA@ODELETEGROUP*ABrLODeletesoneormoregroupsfromthecurrentVDE database.&OkRequiresCREGRP privilege.oCEOFormat5OsDELETEGROUPM group-name[,group-name...]DO ParameterOs group-nameMOThenameofasourcegrouporbuildgroupdefinedintheLO$default developmentstreamthatistobedeletedfromtheO| database.E WQOYoucandeletemorethanonegroupatatimebyusingwild-ROcard charactersinthegroupname.'Thepercentsign( % )inLO5agroupnamematchesanysingle characterintheposition-Oitoccupiesandtheasterisk( [*+)matcheszeroormorechar-OOactersinthepositionit occupies.(Thosegroupswhosenames6O>matchthewildcardpatternaredeleted.5F  O DescriptionMOsThiscommanddeletesthedatabase definitionofeachsourceNOgrouporbuildgrouplistedasa parameter.'The/SOURCEorKO$/BUILD qualifier determineswhethersourcegroupsorbuildPO|groupsaredeleted.)Group definitionsaredeletedonlyintheIOdefault developmentstream.)ThiscommanddoesnotaffectPO-themodulesthataremembersofthedeletedgroups,onlythe'O definitionsofthegroups.GO QualifiersOs/BUILDO/SOURCE (default)NO$ Specifieswhethersourcegroupsorbuildgroupsaredeleted.GO|The/SOURCE qualifiercausesVDEtodeletethesourceFOgroupswiththe specifiednames..The/BUILD qualifierKO-causesVDEtodeletethebuildgroupswiththe specifiedNOnames.*Ifneither qualifieris specified,VDEdeletessourceOgroups.iH??OOf/BUILDand/SOURCE,/SOURCEisthedefault.UI +O/CONFIRMO( /NOCONFIRM (default)IOControlswhetherVDEasksyoutoconfirmthatyouwantFOeachgroupdeleted.*The/CONFIRM qualifiercausesVDEOO2toprintamessagegivingthenameofthegroupandaskingQOifyouwantitdeleted.*IfyouanswerYES(orY),thegroupQO definitionisdeletedfromthe database.(IfyouanswerNO(orSO<N),thegroupisnotdeleted.)Ifyouuseagroup specificationLOthatcontainswildcard characters,VDEasksyoutoconfirmPOthedeletionofeachgroupthatmatchesthewildcardspecifi-KOEcation.(The /NOCONFIRM qualifiercausesVDEtodeleteall@O specifiedgroupswithoutaskingfor confirmation.J O/LOG (default)O(/NOLOGLOControlswhetherlogmessagesareprintedaftereachgroupOOhasbeendeleted.'The/LOG qualifiercausessuchmessagestoLO2beprintedandthe/NOLOG qualifier suppressesthem.'TheseMOmessagesindicatethatthegrouphasbeendeletedandthatCOthedatabase transactionhas successfully committed.K jO/REMARK="string"SO( SpecifiesaremarkstringtobestoredinthedatabasefortheOOdeletedgroup.'Thequotedremarkstring,whichcanbeuptoHO132 characterslong,maycontainany explanatoryremarkSO2aboutthegrouporitsdeletionthatyouwanttostoreintheO database.2L OExamples O1. VDE>DELETE%GROUP%GRPNAME %VDE-I-GRPDEL,%group%GRPNAM%deleted%from&the%databaseM %VDE-I-COMMIT,%database% transaction%has% successfully& committede VDE>DInthisexample,thesourcegroupcalledGRPNAMisF,deletedfromtheVDEdatabaseinthedefaultstream.JThelogmessagesconfirmthatthegroupwasdeletedandDthatthe correspondingdatabase transaction completed5 successfully. O2. VDE>2DELETE% GROUP/BUILD%GRP1,%GRP2,%GRP33C %VDE-I-GRPDEL,%group%GRP1&deleted%from%the%databaseCC %VDE-I-GRPDEL,%group%GRP2&deleted%from%the%databaseD %VDE-I-GRPDEL,%group%GRP33%deleted&from%the&databaseM %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE>KThisexampleshowshowtospecifyalistofgroupnames@withtheDELETEGROUPcommand.(ThelogmessagesG;listthegroupsthatweredeleted.+Becausethe/BUILDH qualifieris specified,thiscommandonlydeletesbuildgroups. Od3.i VDE>2iDELETE% GROUP/CONFIRM&GROUP_1,&GROUP_2* Delete%group%GROUP_1%?&[No]: YF %VDE-I-GRPDEL,%group%GROUP_1&deleted%from%the%database*A Delete%group%GROUP_2%?&[No]: A NM %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE>E@ Thisexample illustratesthe/CONFIRM qualifier.)ThisJ  qualifiercausesVDEtoasktheuserwhethereachspec-B ifiedgroupshouldbedeleted.-ForgroupGROUP_1,JI theuseranswersY(forYES)andthatgroupisdeletedI fromthe database,asthelogmessageshows.)ForgroupF GROUP_2,theuseranswersN(forNO),thatgroupisOS notdeleted,andnologmessageis displayed.'ThefinallogH message indicatesthatthedatabase transactionforthe7 wholecommandhas successfully committed. O| 4. VDE> DELETE%GROUP%GRP*C %VDE-I-GRPDEL,%group%GRP1&deleted%from%the%databaseC %VDE-I-GRPDEL,%group%GRP2&deleted%from%the%databaseDY %VDE-I-GRPDEL,%group%GRP22%deleted&from%the&databaseD %VDE-I-GRPDEL,%group%GRP33%deleted&from%the&databaseM %VDE-I-COMMIT,%database% transaction%has% successfully& committed1 VDE>=Inthisexample,thegroup specification(GRP 4*Z)containsIawildcard character.'Theasteriskmatcheszeroormore@Q characters.+SourcegroupsGRP1,GRP2,GRP22,andHGRP33matchthegroup specificationandaredeletedas#thelogmessagesshow. Oz5.z VDE>zDELETE%GROUP%GRP%C %VDE-I-GRPDEL,%group%GRP1&deleted%from%the%databaseC  %VDE-I-GRPDEL,%group%GRP2&deleted%from%the%databaseMR %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE>J Thisexampleis identicaltothepreviousexampleexceptNathatthepercentsignisusedasawildcard character.'TheFpercentsignmatchesexactlyone character.+Asare-Fsult,sourcegroupsGRP1andGRP2(butnotGRP22orDkGRP33)matchthegroup specification(GRP%)andaredeleted.BACBMODELETEMODULE*NOLODeletesoneormoremodulesfromthecurrentVDElibrary. occupies.*Thosemoduleswhosenamesmatchthewildcard Opatternaredeleted.S P~O Description@OsTheDELETEMODULEcommanddeleteseach specifiedHOmodulefromthecurrentVDElibrary.+WhenamoduleisJO$deleted,VDEdeletesitsdatabaserecordandremovestheEO|modulefromthebuild dependencygraphandfromanyMOgroup definitions.(After committingthedatabase transaction,PO-VDEalsodeleteseach specifiedmodule'sdeltafile(CMSele-JOment).'However,VDEdoesnotremovethemodulefromanyMOstream-specificdisk directoriessuchas clear-copyareasorO7object directories.T! tdHO Normally,youmusthavetheDELMOD privilegetodeleteKOamodule.*However,ifyouhavecreateda particularmod-QO5uleandyouhavenotyetcreatedthefirst generationoftheNOmodule (normallydoneby replacingthefirst generationintoPOtheVDE library),youareallowedtodeletethemodulewith-NO>outtheDELMOD privilege.'Inthis particularcase,youmustGOhavetheCREMOD privilege,whichwasrequiredfortheLOinitialmodule creation.+ThecreatorofamodulecanthusKOHcorrectsimple mistakes,suchas misnamingthemodule,byNOsimplydeletingthemodulebeforetheinitial replacementisHO performed.,The outstanding reservationonthemoduleisNOR canceled,themoduleisremovedfromany reservationsessionNOthatitmightbeincludedin,andthemoduleneverappearsLOintheVDElibrary.(Forfurther informationontheCREATEO[MODULEcommand,see[CREATEMODULE.*T?UMOIfyouarenotthecreatorofamoduleorifthemoduleIOalreadyhasatleastone generation,youmusthavetheHO5DELMOD privilegetodeleteitandyoucanonlydeleteOamoduleifthedelete3 attributeissetforthemodule.,IfOOthis attributeisnotset,youmustsetitwiththeMODIFYAO>MODULE/DELETEcommandbeforeyoucandeletetheOmodule.RV! Z(O QualifiersOs/CONFIRMO /NOCONFIRM (default)IO$ControlswhetherVDEasksyoutoconfirmthatyouwantGO|eachmoduledeleted.(The/CONFIRM qualifiercausesVDENOtoprintamessageforeachmoduleaskingwhetheryouwantLO-thatmoduledeleted.*IfyouanswerYES(orY),thatmod-SOuleisdeletedfromthelibrary.'IfyouanswerNO(orN),theMOmoduleisnotdeleted.+IfyouenteramodulenamewithaNO7wildcardspecification,VDEasksyoutoconfirmthedeletionMOofeachmodulethatmatchesthewildcardspecification.(TheHO /NOCONFIRM qualifiercausesVDEtodeletethe specified6OAmoduleswithoutaskingfor confirmation.W UO/LOG (default)O(/NOLOGMOControlswhetherlogmessagesareprintedaftereachmoduleOOhasbeendeleted.'The/LOG qualifiercausessuchmessagestoLO2beprintedandthe/NOLOG qualifier suppressesthem.'TheseNOmessagesindicatethatthemodulehasbeendeletedfromtheKOlibraryandthatthedatabase transactionhas successfullyO< committed.gX K=O/REMARK="string"SO( SpecifiesaremarkstringtobestoredinthedatabasefortheLOdeletedmodule.)Thequotedremarkstring,whichcanbeupLOto132 characterslong,maycontainany explanatoryremark8O2thatyouwanttostoreinthe database.Y YOExamples O1. VDE>"DELETE%MODULE%MOD1.PASN %VDE-I-MODDEL,%module%[CODE]MOD1.PAS%deleted%from&the%databaseM" %VDE-I-COMMIT,%database% transaction%has% successfully& committedj VDE>FInthisexample,moduleMOD1.PASisdeletedfromtheK1currentVDElibrary.)Sincenofacilitynameis specified,IthemoduleisassumedtobelongtothecurrentdefaultG facility,facilityCODE.ThelogmessagesconfirmthatJ;themodulewasdeletedandthatthedatabase transaction" successfully completed. O 2. VDE>BDELETE%MODULE%[FACIL]FOO.MAR,&FOO.OBJ,& [RMS]MOD2.FORNY %VDE-I-MODDEL,%module%[FACIL]FOO.MAR%deleted%from&the%databaseN %VDE-I-MODDEL,%module%[FACIL]FOO.OBJ%deleted%from&the%databaseM %VDE-I-MODDEL,%module% [RMS]MOD2.FOR%deleted&from%the&databaseM1 %VDE-I-COMMIT,%database% transaction%has% successfully& committedy VDE>HThisexampleshowshowtodeletemultiplemodulesfromI@thelibrary.'Thelogmessageslistthedeletedmodules.SCBDGZODELETE REPLACEMENT*[ \5FODeletesoneormorequeued replacementsfromtheVDELO(databasetofreeupdatabasespace.*Mostusersshoulduse'OCANCEL REPLACEMENTinstead.&ORequiresDELREP privilege.s]IOFormat9OsDELETE REPLACEMENTNrep-name[, rep-name...]^! PzO ParameterOsrep-nameKOThenameofaqueued replacementtobedeletedfromtheHO$currentVDElibrary.,Youcandeletemorethanonere-JO| placementatatimebyusingwildcard charactersintheOO replacementname.'Thepercentsign( % )inanamematchesPO-anysingle characterinthepositionitoccupiesandtheas-Oterisk( ]*C)matcheszeroormore charactersinthepositionIOit occupies.(Thosequeued replacementswhosenamesmatch/O7thewildcardpatternaredeleted._|ODonotspecifytherep-name& parameterifyouusethe%O/IDENTIFICATION qualifier.`! O DescriptionAOsTheDELETE REPLACEMENTcommanddeleteseachspec-HOifiedqueued replacementfromthecurrentVDE database.IO$Thiscommandisusedtoremove replacementrecordsfromNO|thedatabasetofreeupdatabasespace.-ItcanbeusedtoKOdeletebothcurrent replacementrecordsand historicalre-IO- placementdata.+Forthisreason,itrequirestheDELREPO privilege._a 5GOUserswhosimplywanttocancelacurrent replacement?OshouldusetheCANCEL REPLACEMENTcommand.(ThisJO5commandrequirestheRESREP privilegetocancelyourownGO replacementorthePERFREP privilegetocancelanotherOuser's replacement.b! `O QualifiersOs/CONFIRMO /NOCONFIRM (default)IO$ControlswhetherVDEasksyoutoconfirmthatyouwantGO|each replacementdeleted.)The/CONFIRM qualifiercausesMOVDEtoprintamessageforeach replacementaskingwhetherKO-youwantthat replacementdeleted.*IfyouanswerYES(orQOY),that replacementisdeletedfromthe database.'Ifyouan-QOswerNO(orN),the replacementisnotdeleted.(IfyouenterLO7a replacementnamewithawildcardspecification,VDEasksMOyoutoconfirmthedeletionofeach replacementwhosenameAOmatchesthewildcardspecification.-The /NOCONFIRMJOA qualifiercausesVDEtodeletethe specified replacements-Owithoutaskingfor confirmation.c O/HISTORYJO( Specifiesthat replacementhistorybedeleted.* ReplacementKOhistoryconsistsofdatabaserecordsforpast replacementsGOthathavealreadybeen performed; itdoesnotincludeAO2 currentlyqueued replacements.0WhenusedwiththeHO/IDENTIFICATION qualifier,the/HISTORY qualifierdeletesJO informationfor chronologicalrangesofpast replacements.dpKOIfyouomitthe/HISTORY qualifier,VDEdeletes currently%Oqueued replacementsonly.Ye K/"O/IDENTIFICATION=id-rangeLO( Specifiesthatthe replacementswiththeunique ReplacementOIdsgivenbytheid-range*) parameterbedeleted.,DonotOspecifytherep-name1 parameterwhenyouusethisquali-O2fier.%fGOVDEassignsaunique ReplacementIdtoeach immediateIOorqueued replacementintotheVDElibrary.*VDEassignsOO5 ReplacementIdsin chronologicalordersothatthefirstre-OO placementintothelibraryhasIdvalue1,thenexthasIdMOvalue2,andsoon.-Whenyouusethis qualifier,allre-LO> placementsthathaveIdvaluesintherangegivenbytheOid-range" parameteraredeleted.ga OTheid-range;r parametercanbeasingleintegervalue,aOOrangeof integers,orawildcard character.(Ifthe parameterOO5isasingleinteger(forexample, /IDENT=5),VDEdeletestheKO replacementwiththat ReplacementId.)Ifthe parameterisQOarangeofintegers (specifiedastwointegers separatedbyaLO>colonasin /IDENT=3:5),VDEdeletesthe replacementswith2OIdsinthatrange.(Finally,iftheid-range^ parameteristhe9Oasteriskwildcard character(asin/IDENT= x*),VDEdeletesOHall replacements.h! WBOIfyouspecifyazeroornegativenumberintheid-range jpa-MOrameter,thatnumberisrelativetothelargest ReplacementMO5IdvaluefortheVDElibrary(thelatest replacement).+ForLOexample,ifthelatest replacementhas ReplacementId250,HOthen/IDENT=0is equivalentto /IDENT=250and /IDENT=-1)O>is equivalentto /IDENT=249.1iCOThe/IDENTIFICATION qualifiercanbeusedwiththeJO/HISTORY qualifiertodelete historical replacementinfor-HO5mationfromtheVDE database.*Deletingsuch information2Oallowsdatabasespacetobereused.j! UO/LOG (default)O(/NOLOGJOControlswhetherlogmessagesareprintedaftereachre-LO placementhasbeendeleted.)The/LOG qualifiercausessuchLO2messagestobeprintedandthe/NOLOG qualifier suppressesMOthem.'Thesemessagesindicatethatthe replacementhasbeenMOdeletedfromthedatabaseandthatthedatabase transaction'O<has successfully committed."k6 OExamples O1. VDE>)DELETE% REPLACEMENT% ANDERSON-1O %VDE-I-REPDEL,% replacement% ANDERSON-1&deleted%from%the%databaseM" %VDE-I-COMMIT,%database% transaction%has% successfully& committedj VDE>BInthisexample, replacement ANDERSON-1isdeleted@1fromtheVDE database..ThelogmessagesconfirmHthatthe replacementwasdeletedandthatthedatabase/ transaction successfully completed.E DF@ODELETESTEP*"5FODeletes build-step dependency informationfromtheVDEJO( database.,This information specifiestheinputandoutputAOmodulesofagivencompile,copy,orlinkstep.'ORequiresCRESTEP privilege.lBOFormat2OsDELETESTEPMmod-name[, mod-name...]! PO ParameterOsmod-nameNOThenameofthemodulethatis compiled,copied,orlinkedQO$bythebuildsteptobedeletedfromthe database.)ThisnameRO|consistsofanoptionalfacilitynameenclosedinsquarebrack-MOets,amodulename,andanoptionaltypenameprecededbyIO-aperiod(forexample,[FACNAM]MOD1.PAS).IfnofacilityQOnameis specified,thecurrentdefaultfacilityisassumed.*IfTOnotypenameis specified,allbuildstepsformoduleswiththeAO7givenfacilitynameandmodulenamearedeleted.< NOYoucandeletemorethanonebuildstepatatimebyus-LOingwildcard charactersinanyofthethree componentsofOO5themodulename.'Thepercentsign( % )inanamematchesPOanysingle characterinthepositionitoccupiesandtheas-Oterisk( \*G)matcheszeroormore charactersinthepositionitJO> occupies.)Thosebuildstepswhosemodulenamesmatchthe*Owildcardpatternaredeleted.tO DescriptionCOsTheDELETESTEPcommanddeletesall dependencyin-LO formationforagivenbuildstepsothatthedatabasenoLO$longerrecordstheinputandoutputmodulesforthestep.KO|Themodules themselvesremaininthe database;onlytheir9O relationshipstothebuildsteparelost.! DOThecommanddeletes build-step dependency informationKOfromonlythedefault developmentstream.*TodeletebuildMO5stepsinmorethanonestream,youmustrepeattheDELETEFOSTEPcommandforeachstream.,Foreachstream,firstEOentertheSETSTREAMcommandtosetthe developmentFO>stream,thenentertheDELETESTEPcommandtodeleteFOthedesired build-step dependenciesfromthe database.XF.O QualifiersOs/COMPILE (default)O/COPYO$/LINKKO| Specifiesthekindofbuildsteptobedeleted.,/COMPILEMOdeletesthecompilestep,/COPYdeletesthecopystep,andGO-/LINKdeletesthelinkstepforthe specifiedmodule.r HHOOf /COMPILE,/COPYand/LINK,/COMPILEisthedefault.! O/CONFIRM (default)O( /NOCONFIRMNOControlswhetherVDEasksyoutoconfirmthatyouwanttheLO build-step definitiondeleted.'The/CONFIRM qualifiercausesMO2VDEtoprintamessageforeachbuildstepaskingwhetherNOyouwantthatstepdeleted.+IfyouanswerYES(orY),theRO build-step definitionisdeleted.(IfyouanswerNO(orN),theKO< build-step definitionisnotdeleted.'The /NOCONFIRMqual-QOifiercausesVDEtodeleteall specified build-step definitions-Owithoutaskingfor confirmation. UO/LOG (default)O(/NOLOGJOControlswhetherlogmessagesareprintedwhen build-stepOO definitionsaredeletedfromthe database.(The/LOG qualifierJO2causesthemessagestobeprintedandthe/NOLOGquali-MOfier suppressesthem.)ThemessagesindicatethateachbuildNOstephasbeendeletedandthatthedatabase transactionhas"O< committed successfully.A OExamples O1. VDE>$DELETE%STEP& [RMS]FOO.MAR_ %VDE-I-COMSTEPDEL,%compile%step&for%module% [RMS]FOO.MAR&deleted%from%databaseM" %VDE-I-COMMIT,%database% transaction%has% successfully& committedj VDE>JThisexampledeletesallbuild dependency informationforC1the compilationofmoduleFOO.MARinfacilityRMS. O2. VDE>/DELETE% STEP/LINK%FOO.EXE,%MOD1.EXE] %VDE-I-LNKSTEPDEL,%link%step&for%module% [CODE]FOO.EXE%deleted&from%database^? %VDE-I-LNKSTEPDEL,%link%step&for%module%[CODE]MOD1.EXE%deleted%from&databaseM %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE>C=Thiscommanddeletesthe dependency informationforDthelinkstepsformodulesFOO.EXEandMOD1.EXEin;thecurrentdefault facility,facilityCODE.H5 M1KThisassumesthattheVDElibraryoptionthatallowsau-O5tomaticadditionofnewusersuponfirstaccessis disabled.F EGBODELETESTREAM*JODeletesoneormore developmentstreamsfromthecurrentO(VDElibrary.'ORequiresDELSTRM privilege.tJOFormat:OsDELETESTREAMM stream-name[,stream-name...]a7O ParameterOs stream-nameLOThenameofastreamtobedeletedfromthecurrentVDENO$library.*YoucandeletemorethanonestreamatatimebyPO|usingwildcard characters.(Thepercentsign( % )inanameOOmatchesanysingle characterinthepositionitoccupiesandO-theasterisk( 19*>c-)matcheszeroormore charactersinthepo-IOsitionit occupies.,Thosestreamswhosenamesmatchthe*Owildcardpatternaredeleted. bO DescriptionEOsTheDELETESTREAMcommanddeleteseach specifiedde-GO velopmentstreamfromthecurrentVDElibrary.+WhenaQO$streamisdeleted,alldatabase information associatedwiththeMO|streamisdeleted.(Thedeleteddatabase informationincludesNOthestream'sgroup definitions,scripts,andbuild dependencyLO-graph.(Thestreamisalsoremovedfromanystreamsucces-QOsorchainsitbelongsto.'Thestream'sdisk directoriesremain8O unchanged,however;theyarenotdeleted. 4OYoucanonlydeleteastreamiftheOdelete!j attributeissetforTOthestream.*Ifthis attributeisnotset,youmustsetitwithAO5theMODIFYSTREAM/DELETEcommandbeforeyoucanKOdeletethestream.+Unlessthe library'sallow-deletionat-QOtributeisset,thestreammustalsobeclosedbeforeitcanCO>bedeleted.,(UseMODIFYSTREAM/CLOSEDtocloseaOstream.)Y Z/O QualifiersOs/CONFIRMO /NOCONFIRM (default)IO$ControlswhetherVDEasksyoutoconfirmthatyouwantGO|eachstreamdeleted.)The/CONFIRM qualifiercausesVDENOtoprintamessageforeachstreamaskingwhetheryouwantNO-thatstreamdeleted.)IfyouanswerYES(orY),thatstreamNOisdeletedfromthelibrary.+IfyouanswerNO(orN),theMOstreamisnotdeleted.+IfyouenterastreamnamewithaNO7wildcardspecification,VDEasksyoutoconfirmthedeletionKOofeachstreamwhosenamematchesthewildcard specifica-IOtion.)The /NOCONFIRM qualifiercausesVDEtodeletetheAOA specifiedstreamswithoutaskingfor confirmation. UO/LOG (default)O(/NOLOGMOControlswhetherlogmessagesareprintedaftereachstreamOOhasbeendeleted.'The/LOG qualifiercausessuchmessagestoLO2beprintedandthe/NOLOG qualifier suppressesthem.'TheseNOmessagesindicatethatthestreamhasbeendeletedfromtheKOlibraryandthatthedatabase transactionhas successfullyO< committed.g K=O/REMARK="string"SO( SpecifiesaremarkstringtobestoredinthedatabasefortheLOdeletedstream.)Thequotedremarkstring,whichcanbeupLOto132 characterslong,maycontainany explanatoryremark8O2thatyouwanttostoreinthe database.e ;OExamples O1. VDE> DELETE%STREAM%V3.1-1G %VDE-I-STRMDEL,%stream&V3.1-1%deleted&from%the&databaseM" %VDE-I-COMMIT,%database% transaction%has% successfully& committedj VDE>FInthisexample, developmentstreamV3.1-1isdeletedE1fromthecurrentVDElibrary.+Thelogmessagescon-Ifirmthatthestreamwasdeletedandthatthedatabase/ transaction successfully completed. OZ2.` VDE>8`DELETE%STREAM% V2.0-BL1,& V2.0-BL2,%V2.0-BL3I %VDE-I-STRMDEL,%stream&V2.0-BL1&deleted%from%the%databaseI %VDE-I-STRMDEL,%stream&V2.0-BL2&deleted%from%the%databaseI8 %VDE-I-STRMDEL,%stream&V2.0-BL3&deleted%from%the%databaseM %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE>L6ThisexampleshowshowtospecifyalistofstreamnamesFtodeletemultiplestreamsfromthelibrary.-Thelog0messageslistthedeletedstreams. GFI@ODELETEUSER*x NLODeletesuserrecordsfromthedatabaseinthecurrentVDELO(library.)ThiscommanddeletesthedatabaserecordforeachKOuserwhoseOpenVMSusernameislistedasa parameterandEOdeniesthatuseraccesstothecurrentVDElibrary.&OuRequiresCREUSR privilege.lBOFormat2OsDELETEUSERNusername[, username...]PtO ParameterOsusernameCOTheOpenVMSusernameoftheVDEuserwhoserecordKO$isdeletedfromthedatabaseofthecurrentVDElibrary.MO|YoucandeletemorethanoneusernameatatimebyusingMOwildcard characters.*Thepercentsign( % )inausernameOO-matchesanysingle characterinthepositionitoccupiesandOtheasterisk( 1*>c)matcheszeroormore charactersinthepo-KOsitionit occupies.)Thoseuserswhose usernamesmatchthe*O7wildcardpatternaredeleted.6  O DescriptionHOsTheDELETEUSERcommanddisablesaccessby,anddisal-QOlowsanycommand specificationof,the specifieduser.(ItalsoOO$cancelsallreviewand notificationentriesforthe specifiedO|user.= EOThecommandmarksthe specifieduserrecordsintheNOdatabaseasdeleted,thoughtheuserrecordsarenotphysi-SO5callydeletedfromthe database.'Asaresultofthis behaviour,ROrecordsintheVDEdatabasecancontinuetorefertotheuserNOrecordsmarkedasdeleted.(Forexample,therecordforeachGO>module indicateswhocreatedthemodule,andtheSHOWEOMODULEcommandshowsthe creator'susernameandfullOOnamestring.(That informationisfoundinthe creator'suserQOHrecord,evenifthecreatorhassincelefttheprojectandaCODELETEUSERcommandhasmarkedthe associateduserOrecordasdeleted.! WNOAuserthatlacksamatchinguserentry,orhasadeletedGOuserentry,willbeunabletoaccesstheVDEutility ^1Further,4O5 usernamesthathavebeendeletedwill 5 notZ5beacceptedonGOVDE commands.'However,theusernamerecorddoesremainOOwithinthe database,shouldmanualrecoveryberequiredataO>laterdate.*^/! *POVListsofvalidVDEuserscanalsobe automatically maintained:Ousingthe VDE/READ_UAFcommand., VDE/READ_UAFQOcomparesthecurrentlistofusersstoredintheVDEdatabaseFO`withthosestoredintheOpenVMSsystem authorization=Odatabase (SYSUAF).The VDE/READ_UAFcommandisO describedin  VDE/READ_UAF.* }JZ WJOAsan alternativetotheDELETEUSERcommand,onecouldNOclearallbitsinthe associated privilegemask,and/oroneAO5couldusetheMODIFY USER/USERcommandtorenameMOtheuser.)Thesestepspreventtheuserfrom performingop-OOerationsontheVDE database,buttheseoptionspreservetheAO>abilitytospecifytheusernameinVDE commands.! O QualifiersOs/CONFIRMO /NOCONFIRM (default)IO$ControlswhetherVDEasksyoutoconfirmthatyouwantJO|eachuserrecorddeletedfromthe database.'The/CONFIRMPO qualifiercausesVDEtoprintamessageforeachuserrecordFO-givingtheusernameandaskingwhetheryouwantthatROrecorddeleted.(IfyouanswerYES(orY),thatuserrecordisQOdeletedfromthe database.'IfyouanswerNO(orN),theuserPO7recordisnotdeleted.)Ifyouenterausernamewithawild-NOcardspecification,VDEasksyoutoconfirmthedeletionofKOeachusernamethatmatchesthewildcardspecification.(TheHOA /NOCONFIRM qualifiercausesVDEtodeletethe specifiedIOusersfromthedatabasewithoutaskingfor confirmation.! UO/LOG (default)O(/NOLOGKOControlswhetherlogmessagesareprintedaftereachuserKOrecordhasbeendeleted.+ThesemessagesindicatethattheQO2userhasbeendeletedfromthedatabaseandthatthedatabaseJO transactionhas successfully committed.)The/LOG qualifierNOcausessuchmessagestobeprintedandthe/NOLOG qualifierO< suppressesthem.mKCO/REMARK="string"SO( SpecifiesaremarkstringtobestoredinthedatabasefortheJOdeleteduserrecord.*Thequotedremarkstring,whichcanLObeupto132 characterslong,maycontainany explanatory@O2remarkthatyouwanttostoreinthe database.M  # OExamples O1. VDE>DELETE%USER&SMITHD %VDE-I-USERDEL,%user%SMITH%deleted&from%the&databaseM %VDE-I-COMMIT,%database% transaction%has% successfully& committede VDE>HInthisexample,therecordforuserSMITHisdeletedH,fromthedatabaseofthecurrentVDElibrary.*ThelogGmessagesconfirmthattheuserrecordwasdeletedandDthatthedatabase transaction successfully completed. OU2.U VDE>+UDELETE%USER&SMITH,%DOE,&JONESD %VDE-I-USERDEL,%user%SMITH%deleted&from%the&databaseB %VDE-I-USERDEL,%user%DOE%deleted%from&the%databaseD- %VDE-I-USERDEL,%user%JONES%deleted&from%the&databaseMu %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE>K,ThisexampleshowshowtodeletemultipleusersfromtheJ database.(Thelogmessageslisttheuserswhohavebeendeleted. OU3.U VDE>+UDELETE% USER/CONFIRM%SMITH,&DOE' Delete%user%SMITH%?&[No]: YD %VDE-I-USERDEL,%user%SMITH%deleted&from%the&database%- Delete%user%DOE%?%[No]: T-NMu %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE>E+ Thisexample illustratesthe/CONFIRM qualifier.)ThisK  qualifiercausesVDEtoasktheuserwhethereachspeci-L fieduserrecordshouldbedeletedfromthe database.'ForG5 userSMITH,theanswerisY(forYES)andthatuserI recordisdeletedfromthe database.*ForuserDOE,theN answerisN(forNO)andthatuserrecordisnotdeleted.N? HencethereisnologmessageforuserDOE.ThefinallogH message indicatesthatthedatabase transactionforthe7 wholecommandhas successfully committed. Oh 4.m VDE>m DELETE%USER&%O*B %VDE-I-USERDEL,%user%DOE%deleted%from&the%databaseD %VDE-I-USERDEL,%user%JONES%deleted&from%the&databaseME %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE>? Inthisexample,theusername specification(%O * )con-KTtainswildcard characters.(All usernameswithan``O''inIthesecondpositionmatchthespecification.)Henceusers=DOEandJONESaredeletedfromthe database.N*IGJ?O DIFFERENCES*w! MMODisplaysthe differencesbetweenanytwomodule generations.i?OFormat/Os DIFFERENCESM gen-spec-1 [gen-spec-2]?O ParameterOs gen-spec-1KO Specifiesthefirstmodule generationtobe compared.+TheMO$ generation specificationconsistsofthe followinginorder: `Fanoptionalfacilitynameenclosedinsquarebrackets `((amodulename `atypename `&F&anoptional generationnumberprecededbya semicolonw{ MMOAnexampleofa generation specificationis[RMS]MOD1.MAR;5.I! OOIfyouomitthefacilityname,amodule generationfromthePOdefaultfacilityis compared.'Ifyouomitthe generationnum-RO5ber,themostrecent generationofthemoduleinthe specified.O(ordefault)streamis compared.  LOIfyouspecifyazeroornegative generationnumber,thatPOnumberisrelativetothemostrecent generationofthemod-PO5uleinthestream specifiedbythe/STREAM qualifier(orthePOdefaultstreamifthat qualifieris omitted).*Forexample,ifPOthemostrecent generationis generation5,then generation0RO>isthesameas generation5and generation-1isthesameasO generation4.GOIfyouspecifythe /GENERATION qualifier,VDEcomparesHOthe generationwiththegivenCMS generation expression8O5andignoresthe generationnumberonthek5 gen-spec-1O parameter. O gen-spec-2MO# Specifiesthesecondmodule generationtobe compared.(ThisJO| parametercanhavethesameformasthefirst parameter O(j gen-spec-1B$)tofullyspecifyaVDE generation.*Ifthefa-QO-cility,module,andtypenamesarethesameasforthefirstMO parameter,thissecond parametercanbe abbreviatedtojustKOthe generationnumber, optionallyprecededbya semicolon.UO6Forexample,``;5''orjust``5''isenoughtospecify generation,O5ofthemodulegivenbythed gen-spec-18 parameter.gOIfthe3 gen-spec-20 parameterisomitted,VDEcompares)Othe generationgivenbytheH gen-spec-1 parameterwithLO5the immediately preceding generation.)YoucanalsousetheCO /GENERATIONand/STREAM qualifierstocompareother-O generationsofthesamemodule.! FO DescriptionAOsThe DIFFERENCEScommand determinesthe differencesLObetweenanytwomodule generationsintheVDElibrary.)ItPO$fetchesthetwo specified generationsintoascratch directoryFO|andrunstheDCL DIFFERENCEScommandina subprocessSOtocomparethetextsofthetwo generationsandtodisplaythe9O- differencesbetweenthemonyour terminal.m! ~CEOThecommandfetchesthe specified generationsintoaIOscratch directory determinedasfollows.-IflogicalnameHO5 VDE$SCRATCHisdefined,VDEfetchesthefilesintotheQO directorythatthislogicalnameisboundto.+IfthislogicalJOnameisnotdefined,VDEfetchesthefilesintoaVDE-DO>created subdirectory[.VDE$SCRATCH]underthecurrentFO SYS$SCRATCH directory.'(Bydefault, SYS$SCRATCHisde-LOfinedasyour SYS$LOGINlogin directory.'ThislogicalnameOOHcanbe redefinedbyauserto referencea user-createdsub-UO directory;allscratchfilescanthusbecorraledina particularFOsubdirectory.))VDEcreatesthe[.VDE$SCRATCH] subdirec-TORtoryifitdoesnotalreadyexist,anddefinesthelogicalnameHO VDE$SCRATCHto referenceit.'VDEthenspawnsasubpro-EOcesstoruntheDCL DIFFERENCEScommandanddisplayUO[the differences.'VDEdeletesthefetchedfilesattheendoftheJOcommandunlessyouspecifythe/KEEP qualifier.)Thedif-PO ferenceoutputgoestoyourterminalbydefault,butyoucanBOedirectittoafileusingthe/OUTPUT qualifier.q G@OAlthoughthe DIFFERENCEScommandcancomputetheMO differencesbetweenanytwo generationsintheVDElibrary,NO5itisalmostalwaysusedtocomparetwo generationsoftheJOsamemodule.+Forthisreason,youcanreducethesecondMO generation specification parametersoitconsistsofonlyaHO> generationnumber.(The followingexamplecomparesgener-KOations5and2ofmodule[FACIL]MOD.TYPforyourdefaultOstream:1Ot VDE>& DIFFERENCES&[FACIL]MOD.TYP;5%;2y+OKOYoucanalsoomitthesecond generation specificationpa-IOrameter entirely./Inthiscase,the specified generationHO5iscomparedtoits immediate predecessor.,The followingFOcommandthuscompares generation5with generation4:-O VDE>& DIFFERENCES&[FACIL]MOD.TYP;5 FOWhenyouomitthesecond parameter,youcanusetheHO /GENERATION qualifiertospecifytheCMS generationex-KO5 pressionsofthetwo generationstocompare.*Forexample,HOthe followingcommandcomparesthe generationswithCMS3O generation expressions10A2and11B1:BOk VDE>& DIFFERENCES&%[FACIL]MOD.TYP/GENERATION=(10A2,11B1)P &NOYoucanalsousethe/STREAM qualifiertospecifythattheKOlatest generationsfromtwostreamsbe compared.)Thefol-OO5lowingexample illustratesthisuseofthe/STREAM qualifier:>O VDE>& DIFFERENCES&![FACIL]MOD.TYP/STREAM=(V2.0,V2.2)zKOThisexamplecomparesthelatest generationsofthegiven/OmoduleinstreamsV2.0andV2.2.r! HNOInadditionto acceptingcertain VDE-specific qualifiers,theHO DIFFERENCEScommandacceptsall qualifiersthattheDCLFO5 DIFFERENCEScommandaccepts.'These qualifiersaresim-MOplypassedthroughtothe subprocessthatrunstheOpenVMSO DIFFERENCESprogram.kAO QualifiersOs/GENERATION=gen-exprMO Specifiesthatthemodule generationthathastheCMSgen--O$eration expressiongivenbythe$gen-expr\$ parameterbeNO| compared.*Ifthis qualifierisomitted,VDEusesthegener-IOationgivenbythe generationnumberonthe module-nameMO- parameter.(Ifboththis qualifierandthe generationnumberMOareomitted,thecommandusesthelatest generationofthe;Omoduleforthe specified developmentstream.! _O/KEEPOO( Specifiesthatoneorbothofthefetchedandcomparedmod-QOule generationsberetainedinthescratch directoryaftertheROcommand completes.'Ifthis qualifierisomitted,thefilescon-QO2tainingthose generationsaredeletedafterthe differencesareHO computed.(Ifyouspecifythe/KEEP qualifierafterthegen-Ospec-1Hi parameter,thefile containingthat generationiskept.HO< Likewise,ifyouspecifythe/KEEP qualifierafterthe<gen-Ospec-2Ht parameter,thefile containingthat generationiskept.LOIfyouspecifythe qualifierafterthe DIFFERENCESkeywordQOEorafterboth parameters,thefiles containingboth generationsOarekept. iO/STREAM=stream-nameOO( Specifiesthatthe generationtobecomparedshouldbetaken8Ofromthe developmentstreamgivenbythei stream-nameSO parameter.'Ifthis qualifierisomitted,the generationistakenIO2fromyourdefaultstreamunlessyouusethe /GENERATIONO qualifier. {dO /CHANGE_BARO(/COMMENT_DELIMITERO/IGNOREO/MAXIMUM_DIFFERENCESO2/MATCHO/MERGEDO/MODEO</NUMBERO /NONUMBERO/OUTPUTOE /PARALLELO /SEPARATEDO/SLPOO/WIDTHO/WINDOWHOThese qualifiersarepassedthroughtothespawnedDCLDOY DIFFERENCEScommandwithoutchange.'Seethedescrip-6Otionofthe DIFFERENCEScommandinthe OpenVMSDCLO  DictionaryA manualfora descriptionofthese qualifiersandObtheir parameters.Hf OExampleO VDE>#  DIFFERENCES& [FACIL]A.B32O ************0O" File& DEVD$:[SMITH.VDE$SCRATCH]A.REQ;2j 9p!;j declarations.JHere%is%an% additional&comment. 10p!O ******0OB File& DEVD$:[SMITH.VDE$SCRATCH]A.REQ;1 9p! declarations. 10p!O ************5O Number%of% difference%sections%found:%14O Number%of% difference%records&found:%1+O DIFFERENCES%/IGNORE=()/MERGED=1-+ !DEVD$:[SMITH.VDE$SCRATCH]A.REQ;2-* DEVD$:[SMITH.VDE$SCRATCH]A.REQ;1OY VDE>IOThisexamplecomparesthedefaultstream'stwomostre-KO cent generationsofmodule [FACIL]A.B32anddisplaystheir)Oy differencesonthe terminal.JIK8OEXIT*AhKOEndstheVDEsessionorends executionofcommandsinaO(command procedure.HOFormatOsEXITM#O ParametersOs None.O DescriptionGOsWhenyouentertheEXITcommandatthe terminal,youLOendthecurrentVDEsession.+ (PressingCtrl/ZalsoendsaDO$VDE session.)+WhenVDEexecutesanEXITcommandinHO|acommand procedure,itreturnscontroltothecommandEOstreamthatinvokedthecommand procedure.*Thatcom-DO-mandstreammaybetheterminaloranothercommandO procedure.! PO QualifiersOs /KEPT_PROCESSBOIfyouentertheEXIT/KEPT_PROCESScommandattheHO$terminal(notinaVDEcommand procedure)andtheVDEQO|utilityisrunninginakept subprocess,this qualifiercausesLOVDEto terminatethat subprocessbeforeitreturnsyoutoMO-DCLlevel.'The advantageof terminatingthekept subprocessKOisthatitnolongerconsumes resources.+The disadvantageKOisthatyournextVDEcommandwillrequiremoretimetoNO7 reactivatetheVDEimageand reconnecttotheVDE database.OExamples O1. VDE>EXIT  $@CThisexampleshowshowtheEXITcommandreturnscontroltoDCL. KL%KM9OFETCH*AqLO Retrievesa generationofoneormoresourcemodulesfrom%O(thecurrentVDElibrary.qGOFormat7OsFETCHMgen-spec[, gen-spec...]' ["remark"]1 O ParameterOsgen-specKO Specifiesa generationofasourcemoduleinthedefaultQO$streamtobe retrievedfromthelibrary.'A generationspecifi-:O|cationconsistsofthe followinginorder: `Fanoptionalfacilitynameenclosedinsquarebrackets `amodulename `;anoptionaltypenameprecededbyaperiod `Fanoptional generationnumberprecededbya semicolonw{ MMOAnexampleofa generation specificationis[RMS]MOD1.MAR;5.L! "ROIfyouomitthefacilityname,modulesfromthedefaultfacil-SOityarefetched.'Ifyouomitthetypename,allsourcemodulesOO5withthe specifiedmodulenameinthe specifiedfacilityareKOfetched.+Ifyouomitthe generationnumber,themostre-LOcent generationofthemoduleinthe requested developmentSO>streamisfetched.'Thisiseitherthestream specifiedwiththeDO/STREAM qualifierorthedefault developmentstream. WLOIfyouspecifyazeroornegative generationnumber,thatPOnumberisrelativetothemostrecent generationofthemod-OO5uleinthe requested developmentstream.(Forexample,iftheOOmostrecent generationis generation5,then generation0isNOthesameas generation5and generation-1isthesameasO> generation4.NKOIfyouspecifythe /GENERATION qualifier,VDEfetchestheHO generationwiththegivenCMS generation expressionand3O5ignoresthe generationnumberonthe5gen-spec?5 parameter.r! HGOYoucanfetchmorethanonemodulebyusingwildcardNO charactersinthefacilityname,modulename,ortypename.MO5 (Wildcard charactersarenotallowedinthe generationnum-OOber.)*Thepercentsign( % )inanamematchesanysingleKO characterinthepositionitoccupiesandtheasterisk( * &)KO>matcheszeroormore charactersinthepositionitoccu-KOpies.'Thosesourcemoduleswhosenamesmatchthewildcard Opatternarefetched.WMOYoucanalsofetchmultiplemodulesby specifyingthenameOOofasourcegroupinsteadofa generation expression.)SourceBO5groupsarecreatedwiththeCREATEGROUPcommand.NOIfyouspecifyagroupname,thelatest generationofeachKOmodulethatisamemberofthegroupiscopiedtoyourO> directory.z! KPO"remark"TO( SpecifiesaremarkstringtobeloggedinthehistoryfilewithFOthiscommand,usuallytoexplainwhythecommandwas#Oentered.) Specifyingtheremark' parameteris equivalenttoJO2 specifyingthe/REMARK qualifieraftertheFETCHkeyword. FO DescriptionHOsTheFETCHcommandcopiesthe specified generationofaQOmodulefromtheVDElibrarytoafileinyourdefaultdirec-MO$toryorthe directory specifiedwiththe/OUTPUT qualifier.SO|Themoduleisnotreservedfromthelibrarynorcanitbere-OOplacedintotheVDElibrary.'Youcanfetchamodulewhether$O-ornotitis reserved.! ~MOThepresenceorabsenceofaremark determineswhethertheLOFETCH transactionisrecordedintheCMShistoryfileforQO5the facility.'Ifyouenteraremark,VDErecordsthetransac-TOtioninthehistoryfile.(Ifyouenteranullremark,VDEdoes@Onotrecordthe transactioninthehistoryfile. KOWhenyoufetcha generationofamodulefromaVDEli-NObrary,VDErestoresthefile'screationtime,revisiontime,PO5recordformat,andrecord attributes.*ThefilethatisplacedQOinyour directoryhasthesamecreationandrevisiontimesasNOthefilethatcreatedthe generationthatyouare fetching.O QualifiersOs/CONFIRMO /NOCONFIRM (default)IO$ControlswhetherVDEasksyoutoconfirmthatyouwantGO|eachmodulefetched.(The/CONFIRM qualifiercausesVDEIOtoprintamessageforeachmodule generationthatyouLO-have specifiedaskingwhetheryouwanttofetchthatgen-MOeration.+IfyouanswerYES(orY),themoduleisfetched.LOIfyouanswerNO(orN),themoduleisnotfetched.+TheHO7 /NOCONFIRM qualifiercausesVDEtofetcheach specifiedAOmodule generationwithoutaskingfor confirmation. ~O/GENERATION=gen-exprKO( Specifiesthatthemodule generationwiththeCMSgenera-*Otion expressiongivenbytheHgen-expr  parameterbefetchedNOfromtheVDElibrary.*Whenthis qualifieris specified,the0O2 generationnumber specifiedonthe[2gen-spec2 parameterisOignored.:! UO/HISTORY[="string"]TO( Specifiesthathistory informationistobeincludedinthefileQOplacedinyour directory.)ThehistoryofthemoduleliststheNO generationsthatprecededthecurrent generationofthemod-OO2ule.'Each generationproducesonelineofhistory informationOOintheoutputfile.(ThislinegivestheCMS generationnum-MOber,username,date,time,andremark associatedwiththeO< generation.! kSOThequotedstring specifiestheformatofthehistoryline.'TheLOquotedstringmustcontainthe characters#Hor#B(lowerLO5caseisallowed)andcancontainotherprinting charactersOO(suchascomment delimiters).'EachhistorylineisformedbyOO insertingthehistory informationwhereyouspecify#Hor#BRO>inthehistorystring.'Ifyouspecify#H,thehistoryinforma-XOtionisinsertedattheendofthefileandifyouspecify#BitUOisinsertedatthe beginningofthefile.(Toincludea quotationEOHmarkintheoutputhistorystring,typeittwice( H""H).(Toin-VOcludeanumbersign( # )intheoutputhistorystring,typeit#Otwice( ## ).'Ifthestring1 parameterisomitted,VDEusesthe-ORmodule'sdefaulthistorystring.f <JOIfthe/HISTORYand /NOHISTORY qualifiersarebothomit-DOted,theFETCHcommand generateshistory informationQO5onlyifthehistory attributeisenabledforthemodule.*ThisCO attributeissetwiththeCREATEMODULEorMODIFYOMODULEcommand. O /NOHISTORYSO( Specifiesthathistory informationisnottobeappendedtothe4Ooutputfileplacedinyour directory.O/LOG (default)O(/NOLOGKOControlswhetherlogmessagesareprintedaftereachmod-KOule generationisfetched.,The/LOG qualifiercausessuchHO2messagestobeprintedand/NOLOG suppressesthem.*TheJOmessagesindicatethatthemoduleshavebeenfetchedandIOthatthedatabase transactionhas successfully committed.#^O/MERGE=stream-nameO(/MERGE=(gen-expr)JOControlswhetheranother generationofthemodule(calledLOthemerge generation)istobemergedwiththe generationRO2thatisbeingfetched(calledthe retrieved generation).(Ifyou4Ospecifythe/MERGE qualifierwiththe stream-name pa-POrameter,themerge generationisthelatest generationoftheLO<moduleinthe specifiedstream.*Ifyouspecifythe/MERGEO qualifierwiththegen-expr)g parameterenclosedinparen-IOtheses,themerge generationisthe generationwiththeFOE specified generation expression(forexample, ``2A3'').! aGOWhenyouspecifythe/MERGE qualifier,VDEmergestheQOlinesofthe retrieved generationwiththelinesofthemergeOO5 generationanddeliversthemergedtextasasinglefiletoQOyouroutput directory.)Thefilethatisplacedinyourdirec-NOtoryhasthecurrentcreationandrevisiontimes.(ThemergePO> generationcannotbeonthesamelineofdescentasthere-QOtrieved generation.'WhenthereisaconflictbetweenblocksofSOoneormorelines,VDEincludesthe conflictinglinesandflagsOHthe conflict.\ 2OOVDEusesthecallable interfacetoCMStoprovidethemergeOO capability.(Foradetailed explanationofhowtwo generationsIO5aremergedandhowCMS(and thereforeVDE)treatscon-KOflictsbetweenthe generations,seetheCMSdocumentation.! O/NOTES[="string"]UO( SpecifiesthatCMSnotesaretobeappendedtothelinesoftheKOoutputfile.*CMSnotesindicateinwhatmodule generation+Oeachsourcelinewascreated.! kROThequotedstring specifiestheformatofthenote.'ThequotedKOstringcancontaintext (includingthe appropriatecommentMO5 delimiter)andthe characters#Gor#g.'TheCMS generationPO expressionofthe generationinwhichthelinefirstappearedPOininsertedwhereyouspecify#Gor#g.(The resultingstringTO>isappendedtotheendoftheoutputline.'Toincludeaquota-IOtionmarkintheoutputnotesstring,typeittwice( "").*ToROincludeanumbersign( # )intheoutputnotesstring,type'OHittwice( ## ).)IftheGHstring,GH parameterisomitted,VDEusesPOthemodule'sdefaultnotesstring.)(Yousetthedefaultnotes?OstringwiththeCREATEMODULEorMODIFYMODULEOR command.)K !IOIfthe/NOTESand/NONOTES qualifiersarebothomitted,JOtheFETCHcommand generatesCMSnotesonlyifthenotesSO5 attributeisenabledforthemodule.(This attributeissetwith;OtheCREATEMODULEorMODIFYMODULEcommand.O/NONOTESQO( SpecifiesthatCMSnotesarenottobeappendedtothelines5Oofthefileplacedinyour directory.O /NOOUTPUTNO( Specifiesthatthefetch operationistobe performedalongMOwithanyhistory processinganderrorcheckingbutthatno,Ooutputfileistobecreated.]U3$O/OUTPUT=file-specificationRO(DirectsVDEtowritethefetchedmoduletothe specifiedfile.MOIfyouomitthe directoryfromthefilespecification,VDETOwritesthefiletoyourdefault directory.*IfyouomitthefileLO2nameorfiletype,VDEusesthemodulenameandtypebyFOdefault.)Ifyouomitthe/OUTPUTand /NOOUTPUTqual-NOifiers entirely,VDEcreatesafileinyourcurrentdefaultthemodule.t  KJO/REMARK="string"SO( SpecifiesaremarkstringtobeloggedintheCMShistoryfileJObythiscommand,usuallytoexplainwhythecommandwasLOentered.*Theremarkisenclosedin quotationmarks.*IfnoGO2remarkisentered,thefetch operationisnotlogged.  O/STREAM=stream-nameLO( Specifiesthatthemodulesbefetchedfromthe development Ostreamgivenbythe2 stream-name%w parameter.'Ifthisqual-MOifierisomitted,themodulesarefetchedfromthedefaultNO2 developmentstream.*Ifthis qualifierisomittedandnode-JOfaultstreamisdefined,VDEpromptsyouforthestreamOname.l  B OExamples O1. VDE>9FETCH&[FACIL]MODNAM.MAR/REMARK="Just%curious"a %VDE-I-FETCHED,%module& generation%[FACIL]MODNAM.MAR;17(15A2)%fetched%from&libraryD" %VDE-I-OUTFILE,%output&file%is%DEV$:[MYDIR]MODNAM.MAR;j VDE>DThisFETCHcommand retrievesthemostrecentgener-@1ationofmodule[FACIL]MODNAM.MARinthedefaultC developmentstream.+ThelogmessageshowsthattheGmostrecent generationis generation17.)ItsCMSgen-C;eration expressionis15A2.)Thefile MODNAM.MARis7createdintheuser'sdefault directory. O 2. VDE>FETCH& FOO.BAR;5YY %VDE-I-FETCHED,%module& generation%[CODE]FOO.BAR;5(5)&fetched%from%libraryA %VDE-I-OUTFILE,%output&file%is%DEV$:[MYDIR]FOO.BAR; VDE>DWThisexamplefetches generation5ofmoduleFOO.BARHinthedefaultstream., Generation5isnot necessarilyJ themostrecent generationofthemoduleinthedefaultMastream.(Sincenofacilitynameis specified,themoduleisGassumedtobeinthedefault facility,facilityCODE. O23.7 VDE>7FETCH& FOO.BAR;-1Y %VDE-I-FETCHED,%module& generation%[CODE]FOO.BAR;5(5)&fetched%from%libraryA %VDE-I-OUTFILE,%output&file%is%DEV$:[MYDIR]FOO.BAR; VDE>J~ ThisexampleisthesameasthepreviousexampleexceptK thattheuser specifiesarelative generationnumber,-1.E/ This generationnumbercausesVDEtofetchthegen-J erationbeforethemostrecent generation.*Inthiscase,K  generation6isthemostrecent generation.*Asaresult,F8 theFETCHcommand retrieves generation5,asthelog messageshows. O 4. VDE>( FETCH&MOD1,&MOD2,&MOD3,&X*XV %VDE-I-FETCHED,%module& generation%[CODE]MOD1.C;4(4)%fetched%from&library@ %VDE-I-OUTFILE,%output&file%is%DEV$:[MYDIR]MOD1.C;Z %VDE-I-FETCHED,%module& generation%[CODE]MOD2.C;8(7C1)%fetched&from%library@. %VDE-I-OUTFILE,%output&file%is%DEV$:[MYDIR]MOD2.C;Xv %VDE-I-FETCHED,%module& generation%[CODE]MOD3.C;1(1)%fetched%from&library@ %VDE-I-OUTFILE,%output&file%is%DEV$:[MYDIR]MOD3.C;Z %VDE-I-FETCHED,%module& generation%[CODE]MOD3.PLI;1(1)%fetched&from%libraryBN %VDE-I-OUTFILE,%output&file%is%DEV$:[MYDIR]MOD3.PLI;a %VDE-I-FETCHED,%module& generation%[CODE]XAVIER.PAS;25(5A2B8)%fetched%from&libraryD %VDE-I-OUTFILE,%output&file%is%DEV$:[MYDIR]XAVIER.PAS;\& %VDE-I-FETCHED,%module& generation%[CODE]XERXES.FOR;5(5)&fetched%from%libraryDn %VDE-I-OUTFILE,%output&file%is%DEV$:[MYDIR]XERXES.FOR; VDE>I%Inthisexample,theFETCHcommand retrievesthelatestB} generationsofmodulesMOD1.C,MOD2.C,MOD3.C,andD MOD3.PLI,alongwithallsourcemoduleswhosenamesL.beginwiththeletterX.Themoduletypedefaultstothe@wildcardstringthatmatchesallmoduletypes( *).'Hence=thecommandfetchesbothMOD3.Cand MOD3.PLI.MLN8OHELP*FOTheHELPcommandallowsuserstoobtaincommandsyn-KO(taxand functional informationabouttheVDEandtheVSCO utilities.Q'OFormatOsHELPN[topic]=O ParameterOstopicKO SpecifiesthetopicorcommandnameaboutwhichyouwantO$ information.\2O DescriptionQOsTodisplaythelistofall availableVDEcommandsandtopics,DOentertheHELPcommandwithouta parameter.,Toob-LO$tain informationabout individualcommandsortopics,enterHELPBThiscommandcausesVDEtolistallcommandsand<Ttopicsforwhichyoucanrequesthelptext. O2. VDE>HELP%BUILDI;ThiscommandcausesVDEtodisplayhelptext explainingtheBUILDcommand. O 3.  VDE>% HELP%CREATE& MODULE/REMARKGzThiscommandcausesVDEtodisplayhelptextexplain-?ingthe/REMARK qualifiertotheCREATEMODULE+command. O4. VDE>HELP% LOGICAL_NAMESIThiscommandcausesVDEtodisplayhelptext explaining=klogicalnamesandhowtheyareusedbyVDE.`'NMOFOINSERT GENERATION* 5IOInsertsamodule generationintoa specified developmentQO(stream,makingitthelatest generationofthemoduleinthatOstream.'ORequiresPERFREP privilege.nOFormat8OsINSERT GENERATIONNgen-spec[, gen-spec...]&targ-stream-name ["remark"]h>O ParameterOsgen-specIO Specifiesamodule generationina specified developmentJO$streamthatshouldbeinsertedintothestreamgivenby O|the| stream-name2"| parameter.+A generation specification2Oconsistsofthe followinginorder:6  `mFmanoptionalfacilitynameenclosedinsquarebrackets `amodulename `l;lanoptionaltypenameprecededbyaperiod `Fanoptional generationnumberprecededbya semicolonw{ MMOAnexampleofa generation specificationis[RMS]MOD1.MAR;5.% SOIfyouomitthefacilityname,thedefaultfacilityisassumed.NOIfyouomitthetypename, generationsforallsourcemod-PO5uleswiththe specifiedmodulenameinthe specifiedfacilityOOareinsertedintothegivenstream.)Ifyouomitthegenera-POtionnumber,themostrecent generationofthemoduleintheNO>stream specifiedwiththe/STREAM qualifierisinsertedintoOthegivenstream.! WLOIfyouspecifyazeroornegative generationnumber,thatPOnumberisrelativetothemostrecent generationofthemod-HO5uleinthestreamgivenbythe/STREAM qualifier.-ForOOexample,ifthemostrecent generationis generation5,thenRO generation0isthesameas generation5and generation-1is'O>thesameas generation4. NKOIfyouspecifythe /GENERATION qualifier,VDEinsertstheHO generationwiththegivenCMS generation expressionand3O5ignoresthe generationnumberonthe5gen-spec?5 parameter.!! }LOYoucaninsertmorethanone generationbyusingwildcardNO charactersinthefacilityname,modulename,ortypename.OO5Thepercentsign( % )inanamematchesanysinglechar-GOacterinthepositionitoccupiesandtheasterisk( 9*k)matchesPOzeroormore charactersinthepositionit occupies.(WildcardLO> charactersarenotallowedinthe generationnumber.(ThoseJOmodule generationswhosenamesmatchthewildcardpattern"Oareinsertedintothe< stream-namestream."! aEOUnlessthe WILD_INS_GENlibrary attributeisenabled,JOVDEdoesnotallowwildcard charactersinthe generationIO5 specificationwhenyouusethe /GENERATION qualifier.)ItMOseldommakessensetoselect generationswiththesameCMSKO generation expressionfrom differentmodules.)ForthesameLO>reason,VDEdoesnotallowyoutousewildcard charactersIOandanon-zero generationnumberinthesame generation O specification(asin * . -*1R;-2),againunlessthe WILD_INS_GEN&OHlibrary attributeisset.#Otarg-stream-nameLO# Specifiesthe developmentstreamintowhichthe generationsO|givenbythe|gen-spec+| parametersshouldbe inserted.$NMOOnecanspecifythesource generationforthe operationinOOseveralways,oneofwhichisbasedonthe generationinaAO5 specifiedsource stream-seethe/STREAM qualifier.%O"remark"JO( SpecifiesaremarkstringthatexplainswhyyouinsertedMOthe generationintothe specifiedstream.(ThequotedremarkJOstringcanbeupto132 characterslong.) Specifyingthe re-O2markA@2 parameteris equivalentto specifyingthe/REMARK>O qualifieraftertheINSERT GENERATION keywords.P&&O Description>OsTheINSERT GENERATIONcommandinsertsthemod-3Oule generationsyouspecifywiththexgen-spec parametersAO$intothe developmentstreamyouspecifywiththeY$stream-O|nameBO| parameter.)Eachsuch generationbecomesthelatest=O generationofthe correspondingmoduleinthestream-O-name>P-stream.+Thecommandthusletsyoumovemodule>O generationsfromonestreamtoanotherstream.'! QOIfthe specifiedmoduleis currentlyreservedinthe specifiedROstream,VDE terminatesthat reservationsinceitisbasedonaPO5module generationthatnolongeristhelatest generationforPOthestream.'VDEsendsamailmessagetonotifytheownerof=Othe reservationthatthe reservationislost.(QONotethattherearetwostreamspecificationspossibleonthisGOcommand.+The destinationstream-specifiedbythetargetDO5streamname parameter-andtheoptionalsourcestreamO qualifier.A) ZO QualifiersOs/CONFIRMO /NOCONFIRM (default)IO$ControlswhetherVDEasksyoutoconfirmthatyouwantHO|each generationinsertedintothe specifiedstream..TheLO/CONFIRM qualifiercausesVDEtoprintamessageforeachIO- generationgivingthenameofthe generationandaskingMOwhetheryouwanttoinsertthe generationintothestream.ROIfyouanswerYES(orY),the generationisinsertedintotheOO7stream.)IfyouanswerNO(orN),the generationisnotin-HOsertedintothestream.(The /NOCONFIRM qualifiercausesIOVDEtoinserteach generationintothe specifiedstream-OAwithoutaskingfor confirmation.*lO /NOCMS_CLASSKO(Preventstheinserted generationsfrombeinginsertedintoIOtheCMSclassforthe specifiedstream,evenifaCMSIOclassisnormally maintainedforthestream.*TheINSERTDO2 GENERATIONcommandexecutesfasterthan otherwiseif5OCMSclass membershipsarenotupdated.+|O/GENERATION=gen-exprKO( Specifiesthatthe generationwiththeCMS generationex-"Opressiongivenbythe\gen-expr' parameterbeinsertedintoMOthe specifiedstream.,Whenthis qualifieris specified,the0O2 generationnumber specifiedonthe[2gen-spec2 parameterisOignored.,UO/LOG (default)O(/NOLOGJOControlswhetherlogmessagesareprintedafterthegen-KOerationsareinsertedintothestream.,The/LOG qualifierJO2causessuchmessagestobeprintedand/NOLOG suppressesFOthem.-Themessagesindicatethatthe generationshavePObeeninsertedintothe specifiedstreamandthatthedatabase4O< transactionhas successfully committed.-O/REMARK="string"JO( SpecifiesaremarkstringthatexplainswhyyouinsertedMOthe generationintothe specifiedstream.(Thequotedremark9Ostringcanbeupto132 characterslong.{. QO/STREAM=stream-namePO( Specifiesthestreaminwhichthe generationshouldbelookedGOupifyouomitthe /GENERATION qualifier.,Thisquali-OOfierthusaffectstheinterpretationofthe generationnumber O2inthe command-level2gen-spec 2 parameterwhentheHO /GENERATION qualifierisomitted.+IfyouomitboththeDO/STREAM qualifierandthe /GENERATION qualifier,VDEPO<promptsyouforthenameofthestreaminwhichtolookup"Othe generationnumber./ OExamples O1. VDE>BINSERT% GENERATION&[FACIL]MODNAM.C;4/STREAM=V2.0&BL-22\ %VDE-I-GENINSERT,% generation&[FACIL]MODNAM.C;4(4)&inserted&into%stream&BL-22MC %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE> VDE>SET%STREAM%BL-22 VDE>+SHOW% GENERATION%[FACIL]MODNAM.C*c Generation&[FACIL]MODNAM.C;4(4)_c by&user%JONESo c onK 9-MAY-1990&19:43 VDE>LThisexampleinserts generation4ofmodule[FACIL]MODNAM.C@rfromstreamV2.0intostreamBL-22,makingthatA generationthelatest generationinstreamBL-22.'P OQ8KOLINK*LMJOLinksthe specifiedmodulesusingthe appropriatescriptsO(fromthe database.%ORequiresBUILD privilege.dN:OFormat*OsLINKNmod-name[, mod-name...]O O ParameterOsmod-namePO Specifiesamoduletobelinked.(ThemodulenameconsistsofPO$anoptionalfacilitynameenclosedinsquare brackets,amod-MO|ulename,andanoptionaltypenameprecededbyaperiod,LOsuchas[FACIL]MOD1.EXE.Ifnofacilitynameis specified,RO-thedefaultfacilityisassumed.)Ifnotypenameis specified,)OmoduletypeEXEisassumed. P WMOYoucanlinkmorethanonemodulebyusingwildcardchar-MOactersinanyofthethree componentsofthemodulename.OO5Thepercentsign( % )inanamematchesanysinglechar-GOacterinthepositionitoccupiesandtheasterisk( 9*k)matchesROzeroormore charactersinthepositionit occupies.'VDElinks?O>moduleswhosenamesmatchthewildcardpattern.,QO DescriptionFOsTheLINKcommandlinksamodulethesamewayitisNOlinkedinabuildjob.(TheLINKcommand retrievesthelinkLO$scriptforeach specifiedmoduleand generatesaDCLcom-KO|mandfilefromthescript.)ThecommandthenexecutestheMOcommandfileina subprocess.)Ifthemodulelinkssuccess-MO-fully,VDEupdatesthebuild dependency informationforthe(Olinkstepinthe database.R \IOTheLINKcommandcanbeusedtolinkamodulewithoutZOstartingabuildjob.(Itisoftenusedtotestlinkscripts.'ItcanQO5alsobeusedtocollecttheinitial dependency informationforPOalinkstepthatdoesnotyethave dependency informationinOthe database.6SP O QualifiersOs/LOG (default)O/NOLOGJO$ControlswhetherlogmessagesareprintedafterthelinkGO|step executes.-The/LOG qualifiercausessuchmessagesIOtobeprintedandthe/NOLOG qualifier suppressesthem.KO-Thesemessagesindicatethatthelinkstephas completed,IOeither successfullyorwitherrors,andthatthedepen-NOdency informationforthestephasbeenupdatedintheVDEO7 database./T! O/STREAM=stream-namePO( Specifiesthatthemodulesbelinkedforthestreamgivenby Othe stream-name< parameter.'Ifthis qualifierisomitted,the:Omodulesarelinkedforthedefaultstream.lU6 BOExamples O1. VDE>LINK% [CODE]X.EXE= $& DEFINE/NOLOG%OBJ$&DEV$:[PROJDIR.MAIN.CODE.OBJ]6" $&LINK%/EXE=OBJ$:X.EXE&/MAP=OBJ$:X.MAP%-;j 1OBJ$:OBJLIB.OLB/INCLUDE=C,OBJ$:OBJLIB.OLB/LIBRARY $&!= $&SET%NOVERIFYp!% Successful%script% completionJB %VDE-I-LINKSUCC,&link%of% [CODE]X.EXE% completed& successfullyO %VDE-I-DEPUPDATE,% dependency& information&updated%for&build&step VDE>G@ThisexamplelinksmoduleX.EXEinfacilityCODE.TheLoutputfromthe executionofthelinkscriptis displayedHonthe terminal.+ThefinallogmessagesshowthattheIJlinkstep completed successfullyandthatits dependency7 informationwasupdatedinthe database.I QPRHVOMODIFY ARCHITECTURE*WXMOModifiesoneormore architecturetableentriesintheVDE8O( database.'Each architecturetableentry...,ORequirestheCREARCH privilege.gY==O ARCHITECTUREsupportisnotfully implemented.;Z NOAn architectureisa constructthat encompassesoneormoreMO facilities,andallowsmodulestoexistina ``common''orRO5 ``default'' facility,andzeroormore architecturespecificfa-HO cilities.,Inmustthesamefashionasthe SYS$SYSROOT:MOlogicalnameallowsonetosupportbothsystem-specificandLO>cluster-commonfiles,an architectureallowsonetosupportCOarchitecture-specificandarchitecture-commonmodules.v[LOFormat:MODIFY% ARCHITECTURE%VAXPDP/REMARK="Version%n" VDE> IUnderConstruction...+RQSEdOMODIFY BUILD_JOB*ef NOModifiesthebatchqueues,processcount,remarkstring,andOO(other attributesofexistingbuildjobsintheVDE database.%ORequiresBUILD privilege.ygOOFormat?OsMODIFY BUILD_JOBM [stream-name[,stream-name...]]hFhO ParameterOs stream-nameGOThenameofa developmentstream containingthebuildKO$jobstobe modified.1Tospecifythebuildjobs, usetheAO|/IDENTIFICATION qualifier.2IfyoudonotusetheDO/IDENTIFICATION qualifier,themostrecentbuildjob)O-forthestreamis modified.iWOOYoucanmodifybuildjobsinmorethanonestreambyusingJOwildcard charactersinthestreamname.*ThepercentsignRO5( % )inanamematchesanysingle characterintheposition-Oitoccupiesandtheasterisk( [*+)matcheszeroormorechar-SOactersinthepositionit occupies.)BuildjobsinthosestreamsEO>whosenamesmatchthewildcardpatternare modified.jNOIfyouomitthe stream-name  parameter,VDEmodi-ROfiesthe attributesofoneormorebuildjobsforthedefaultO5 developmentstream.k! Z|O DescriptionDOsTheMODIFY BUILD_JOBcommandmodifiesthe attributesQOofbuildjobshavingthe specifiedstreamnamesandbuildjobIO$identificationnumbers.+Youcanmodifythe followingat-PO| tributes:*thebatchqueuestowhichthejobis submittedforJO execution,thetotalnumberofbatch processes submitted,KO-theremarkstring,the step-delay interval,andthetime-MOout interval.)VDEmodifiesthese attributesbyupdatingtheLOdatabasewiththe informationyouspecify.(Youcannotmod-UO7ifythequeuesorprocesscountofabuildjobthathasstartedHOrunningorthathas completed execution.,Youcan,how-ROever,suspendarunningbuildjob,modifythose attributes,andOArestartthejob.l O QualifiersOs/CONFIRMO /NOCONFIRM (default)IO$ControlswhetherVDEasksyoutoconfirmthatyouwantGO|eachbuildjob modified.+The/CONFIRM qualifiercausesLOVDEtoprintamessageforeachbuildjobaskingwhetherPO-youwantthatbuildjob modified.)IfyouanswerYES(orY),UOthe attributesofthebuildjobaremodifiedinthe database.(IfNOyouanswerNO(orN),the attributesarenot modified.)TheIO7 /NOCONFIRM qualifiercausesVDEtomodifythe attributesNOofthe specifiedbuildjobswithoutaskingfor confirmation.m "O/IDENTIFICATION=id-rangeSO( SpecifiesthebuildjobidentificationnumbersofthebuildjobsJOtobemodifiedforthe specified developmentstream.(The Yid-OrangeFP parametercanbeasingleintegervalue,arangeofQO2 integers,orawildcard character.(Ifthe parameterisasin-MOgleintegervalue(forexample, /IDENT=5),VDEmodifiestheMObuildjobwiththatidentificationnumber.*Ifthe parameterUO<isarangeofintegers (specifiedastwobuildjobidentificationKOnumbers separatedbyacolonasin /IDENT=3:5),VDEmod-ROifiesallbuildjobswithidentificationnumbersinthatrange.OEFinally,iftheLEid-range0E parameteristheasteriskwildcardO(asin/IDENT= ~*B),VDEmodifiesallbuildjobsforthe specifiedOstream.n WSOIfyouspecifyazeroornegativebuildjobidentificationnum-Oberintheid-range4C parameter,thatnumberisrelativetoRO5theidentificationnumberofthemostrecentbuildjobforthePOstream.+Forexample,ifthemostrecentbuildjobisjob5,FOthen/IDENT=0is equivalentto/IDENT=5and /IDENT=-1'O>is equivalentto /IDENT=4.oNFOIfyoudonotusethe/IDENTIFICATION qualifier,VDEPOmodifiesthe attributesofthemostrecentbuildjobfortheO5 specifiedstream.p UO/LOG (default)O(/NOLOGLOControlswhetherlogmessagesareprintedaftereachbuildNOjobis modified.)The/LOG qualifiercausessuchmessagestoLO2beprintedandthe/NOLOG qualifier suppressesthem.'TheseQOmessagesindicatethatthebuildjobhasbeenmodifiedintheLOdatabaseandthatthedatabase transactionhas successfullyO< committed.q! #O/PROCESS_COUNT=proc-countNO( Specifiesthenumberof processestoexecutethebuildjob.GOWhenthebuildjobisstartedwithaSTART BUILD_JOBMOcommand,VDEcreatesthe processesby submittingbatchjobsRO2tothequeues specifiedbythe/QUEUE qualifierortothede-OOfaultqueuesforthedefaultstream.(Thenumberof processesOOthatVDEcreates(thatis,thenumberofOpenVMSbatchjobs.O<itsubmits)is specifiedbyther< proc-countR< parameter.)AsaLOresult,this parameter determinesthedegreeof parallelismOforthebuildjob.4r^ /O/QUEUE=(queue-name[,queue-name...])LO( SpecifiestheOpenVMSbatchqueuestowhichthebuildjobBOis submittedbya subsequentSTART BUILD_JOBcom-Omand.+Each+ queue-name)Q parameter specifiesthename%O2ofonebatchqueue.(The2 queue-name2 parametermayop-OOtionallybefollowedbyaprocesscountin parentheses.*ThisNOcount specifiesthenumberof processesthatarestartedonLO<thequeuetorunthebuildjob.(Forexample, SYS$BATCH(3)KOcausesthree build-job processestobe submittedtoqueueMO SYS$BATCH.Iftheprocesscountisomitted,oneprocessis$OE submittedtothequeue.s }%OIfyouonlyspecifyone queue-name! parameter,theparen-#Othesesmaybeomitted.St! )JOIfyoualsousethe/PROCESS_COUNT qualifier,thatqual-ROifierstatesthetotalnumberof build-job processestocreate.1O5TheprocesscountsattachedtotheA5 queue-namef5parame-QOtersonthe/QUEUE qualifierarethenusedasscalingfactorsKOto distribute build-job processesamongthequeuespropor-LO> tionally.'Forexample,ifyouspecifyqueues HI_BATCH,HO_OO BATCH(3),andatotalprocesscountofeight,thentwopro-JOcessesare submittedtoqueueHI_BATCHandsix processesNOHtoqueue HO_BATCH.Ifthetotalprocesscountdoesnotdi-ROvideevenlyintothesumofthescalingfactors,the remainingQO processesare allocatedtothequeuesintheorderthequeuesUORarelisted.(Ifthetotalprocesscountisnine,forexample,theJOoneextraprocessis allocatedtoqueueHI_BATCHbecause&OHI_BATCHislistedfirst.uUO/REMARK="string"NO( SpecifiesaremarkstringtobestoredinthedatabaseforKOeach specifiedbuildjob.+Thequotedremarkstring,whichNOcanbeupto132 characterslong,maycontainanyexplana-LO2toryremarkthatyouwanttostoreinthe database.,ThisKOstringreplacestheremarkstringfromtheoriginalBUILD=OcommandorfromanypreviousMODIFY BUILD_JOBO<command.qvG#O/STEP_DELAY=time-intervalJO( Specifiesthe step-delaytimeintervalusedby VDE$BUILD.HO VDE$BUILDistheprogramthatexecutesthebuildstepsJO belongingtothebuildjob.+If VDE$BUILDcannotfindanNO2 availablebuildstepinthe database,theprogramwaitstheKOamountoftime specifiedbythe /STEP_DELAY qualifierbe-OOforeitlooksinthedatabaseagain.-Seethe descriptionofLO<theBUILDcommandforamoredetailed descriptionofthisO qualifier.0w! U O/TIMEOUT=time-intervalQO( Specifiesthetimeoutintervalforthebuildjob.,IfnobuildKOstepscompleteduringthis interval,the VDE$BUILDutilityPOstopsthebuildjobandassignsitTIMEOUTstatus.& Therefore,MO2thetimeoutintervalmustbelongerthanthetimerequiredROtocompletethelongestbuildstep.)Seethe descriptionoftheGOBUILDcommandforamoredetailed descriptionofthisO< qualifier.x; rOExamples O1. VDE>IMODIFY% BUILD_JOB%V2.0-3/IDENT=15/REMARK="New&remark%string"X %VDE-I-BLDJOBMOD,%build%job%15%for&stream%V2.0-3%modified%in%databaseM" %VDE-I-COMMIT,%database% transaction%has% successfully& committedj VDE>JThisexamplemodifiestheremarkstringofbuildjob151forstreamV2.0-3. O2. VDE>MMODIFY%BUILD_JOB/QUEUE=(PHI_BATCH,%FOO_BATCH(3))/PROCESS_COUNT=10V %VDE-I-BLDJOBMOD,%build%job%12%for&stream%V5.2&modified&in&databaseM? %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE>CThiscommandmodifiesthebatchqueuesandprocessJNcount associatedwiththemostrecentbuildjobforthe=defaultstream,buildjob12ofstreamV5.2.T"SRTCyOMODIFYCONTEXT*z{ ?NOModifiesthe attributesofoneormorecontextsintheVDEQO( database.'The attributesofacontextthatyoucanmodifyin-HOcludeitsname,remark,default developmentstream,andPOdefault facility.,OnecontextcanbeusedtosetthedefaultOO2streamandfacilitywhenfirst connectingtoaVDE database.>ORequirestheCRECTX privilegetomodifypublicO& contexts.o|EOFormat5OsMODIFYCONTEXTMctx-name[, ctx-name...]}! XO ParameterOsctx-nameNOThenameofanexistingcontextwhose attributesaretobePO$ modified.'YoucanmodifymorethanonecontextatatimebyLO|usingwildcard charactersinthecontextname.(ThepercentROsign( % )inacontextnamematchesanysingle characterinOmodifyacontextusingtheMODFYCONTEXTcom-LO$mand,youspecifythenameofthecontext,the associated?O| developmentstream,andthe associated facility.WOOToapplythedefaults associatedwithacontext,specifytheFOcontextnameasa parametertotheSETCONTEXTcom-PO5mand.)Toseta particularcontextasthedefaultcontextforFOusewhenyouissuetheSETLIBRARYcommand,usethe@OSETCONTEXT/DEFAULTcommandtomarka particular-O>contextasthedefaultcontext.d::OTherearetwokindsofcontexts available:6!   `m mthe^mprivatecontext8mis availabletoandonlyvisibletothe!userwhocreatedit. `E Ethe^Epubliccontext9Eis availabletoallusersofthecurrentVDElibrary.WQOYoudonotneedspecialVDE privilegestocreateormodifyaJOprivatecontext,butyoumusthavetheVDECRECTXpriv-OO5ilegetocreateormodifyapubliccontext.*WhileaprivateOOcontextcanhavethesamenameasapubliccontext,neitherMOtwoprivatecontextsnortwopubliccontextscansharetheO>samename.uKO QualifiersOs /ARCHITECTURE OUnderConstruction...! O/CONFIRMO( /NOCONFIRM (default)IOControlswhetherVDEasksyoutoconfirmthatyouwantHOeachcontext definition modified.*The/CONFIRM qualifierPO2causesVDEtoprintamessageforthe specifiedcontextgiv-OOingthenameofthecontextandaskingwhetheryouwanttoQOmodifythatcontext.'IfyouanswerYES(orY),the attributesRO<are modified.'IfyouanswerNO(orN),the attributesarenotHO modified.'The /NOCONFIRM qualifiercausesVDEtomodifyPOthe attributesofthecontextwithoutaskingfor confirmation.* UO/FACILITY=facil-nameO( /NOFACILITYNOThe /FACILITY qualifier specifiesthatthe indicatedfacilityNObecomesthedefaultfacilitywhenthecontextis establishedGO2withtheSETCONTEXTcommand.*ThedefaultfacilityisROthefacilitythatisassumedwhenthefacilitynameisomittedHOfromamodulename.(The /NOFACILITY qualifier specifiesPO<thatthedefaultfacility establishedbythecontextisnull. UO/LOG (default)O(/NOLOGJOControlswhetherlogmessagesareprintedafterthecon-OOtext definitionsare modified.'The/LOG qualifiercausessuchHO2messagestobeprintedand/NOLOG suppressesthem.*TheIOmessagesindicatethatthecontext definitionshavebeenLOmodifiedandthatthedatabase transactionhas successfullyO< committed. O/NAME=ctx-nameNO( Specifiesanewnameforthecontext.'ThenewcontextnameMOcanbeupto39 characterslongandmustfollowVDEnameJOsyntax.+Afterthecontextnameischanged,youmustre-MO2fertothecontextbyitsnewnameinall subsequentVDECO commands.'Theoldnameislostfromthe database. O/PRIVATE (default)O(/PUBLICOO SpecifieswhetherthecontextthatismodifiedisprivateorJOpublic.)The/PRIVATE qualifiercausesVDEtomodifyyourLO2privatecontextbythatname.(The/PUBLIC qualifiercausesKOVDEtomodifythepubliccontextbythatname.*YoumustIOhavetheCRECTX privilegetousethe/PUBLIC qualifier.lBBOOf/PRIVATEand/PUBLIC,/PRIVATEisthedefault.X! .O/REMARK="string"RO( Specifiesaremarkstringforthecontext.'ThisstringreplacesCOtheremarkstringfromtheoriginalCREATECONTEXTAOcommandorfromanypreviousMODIFYCONTEXTcom-JO2mand.+Thequotedremarkstring,whichcanbeupto132CO characterslong,maycontainany explanatoryremarkOOaboutthecontextthatyouwantstoredintheVDE database.PO< Typicallytheremark describesthefunctionorpurposeoftheOcontext.}O/STREAM=stream-nameO( /NOSTREAMGOThe/STREAM qualifier specifiesthatthe indicatedde-EO velopmentstreambecomesthedefaultstreamwhentheEO2contextis establishedwiththeSETCONTEXTcommand.JOThe /NOSTREAM qualifier specifiesthatthedefaultstream2O establishedbythecontextisnull.0a OExamples O1. VDE>@MODIFY%CONTEXT&%DEFAULT/STREAM=V2.2-BL1/FACILITY=COPYY %VDE-I-CTXMOD,% information%for%context%DEFAULT&modified&in&the%databaseM" %VDE-I-COMMIT,%database% transaction%has% successfully& committedj VDE>?j DEFINE/KEY%KP6&"SET%CONTEXT% DEFAULTS"% /TERMINATE VDE> x {M KP6 #{M  VDE>SHOW%DEFAULTS?B Library&LIBNAME%in%root% directory%DEV$:[PROJDIR]. Default& directory%is% DEV$:[SMITH]6 Context&DEFAULT%(private%to%user%SMITH)'D Default&stream%is%V2.2-BL1%Db Default&facility&is&COPY VDE>:`TheMODIFYCONTEXTcommand specifiesstreamEV2.2-BL1asthedefaultstreamandfacilityCOPYasGthedefaultfacilityforprivatecontextDEFAULT.ThisLjcontextisthedefaultatthestartofeachVDEsession.BTheSETCONTEXTcommand establishesthesedefaultsCforthecurrentVDEsession,astheSHOWDEFAULTStcommand confirms. O2. VDE>6MODIFY%CONTEXT/PUBLIC/FACILITY=EXEC&PUBCTXX4 %VDE-I-CTXMOD,% information%for%context%PUBCTX%modified%in%the&databaseM| %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE>SHOW%CONTEXT%PUBCTX3 Context&PUBCTX%(public&to&all%users)#DS Default&stream%is%V2.0%D Default&facility&is&EXEC+ VDE>> TheMODIFYCONTEXTcommand establishesfacilityI EXECasthedefaultfacilityforpubliccontextPUBCTX.?K TheSHOWCONTEXTcommandshowsthatthechange hastakeneffect.T SUDOMODIFYFACILITY*5POModifiesthe attributesofoneormore facilitiesintheVDEQO( database.*The attributesofafacilityyoucanmodifyareits$Onameandremarkstring.&ORequiresCREFAC privilege.tJOFormat:OsMODIFYFACILITYM facil-name[,facil-name...] PO ParameterOs facil-namePOThenameofafacilityinthecurrentVDElibrarywhoseat-MO$tributesaretobe modified.*YoucanmodifymorethanoneQO|facilityatatimebyusingwildcard charactersinthefacil-QOityname.)Thepercentsign( % )inafacilitynamematchesPO-anysingle characterinthepositionitoccupiesandtheas-Oterisk( \*G)matcheszeroormore charactersinthepositionitQO occupies.(VDEmodifiesthe attributesofthose facilitieswhose/O7namesmatchthewildcardpattern.! O QualifiersOs/CONFIRMO /NOCONFIRM (default)IO$ControlswhetherVDEasksyoutoconfirmthatyouwantJO|eachfacility modified.'The/CONFIRM qualifiercausesVDEUOtoprintamessageforthe specifiedfacilitygivingthenameofOO-thefacilityandaskwhetheryouwanttomodifythatfacil-SOity.(IfyouanswerYES(orY),the attributesare modified.)IfNOyouanswerNO(orN),the attributesarenot modified.)TheIO7 /NOCONFIRM qualifiercausesVDEtomodifythe attributes@Oofthefacilitywithoutaskingfor confirmation.3 U O/DELETEO( /NODELETE (default)OSetsorclearsthedelete3 attributeforthe facility.*Thisat-LOtributeallowsthefacilitytobedeletedwiththeDELETEHO2FACILITYcommand.(The/DELETE qualifiersetsthedeleteOO attributesothatthefacilitycanbedeleted.'The /NODELETETO qualifierclearsthedelete attributesothatthefacilitycannotAO<bedeletedwithoutfirst resettingthe attribute.UO/LOG (default)O(/NOLOGIOControlswhetherlogmessagesareprintedafterthefa-KOcility definitionsare modified.,The/LOG qualifiercausesIO2suchmessagestobeprintedand/NOLOG suppressesthem.OOThemessagesindicatethatthefacility definitionshavebeenLOmodifiedandthatthedatabase transactionhas successfullyO< committed. O/NAME=facil-namePO( Specifiesanewnameforthe facility.(ThenewfacilitynameOOcanbeupto39 characterslongandmustfollownormalVDEMOnamesyntax.(Afterthefacilitynamehasbeenchanged,youQO2mustrefertothefacilitybyitsnewnameinall subsequentHOVDE commands.&Theoldnameislostfromthe database.|! RO /PROPAGATEO( /NOPROPAGATEEO Specifieswhether automaticchange propagationisal-MOlowedbydefaultfornewmodulescreatedinthis facility.LO2 /PROPAGATEcausesnewmodulesaddedtothefacilitytobeIOmarkedasallowing automaticchange propagationwhenre-DOservedand replaced.' /NOPROPAGATEmarkssuchmodulesIO<asnotallowingchange propagation.)WhenyoucreatenewROmodules,youcanoverridethesedefaultswith qualifierstothe"OCREATEMODULEcommand.^! 4O/REMARK="string"SO( Specifiesaremarkstringforthe facility.(ThisstringreplacesDOtheremarkstringfromtheoriginalCREATEFACILITYBOcommandorfromanypreviousMODIFYFACILITYcom-JO2mand.+Thequotedremarkstring,whichcanbeupto132CO characterslong,maycontainany explanatoryremarkPOaboutthefacilitythatyouwantstoredintheVDE database.QO< Typicallytheremark describesthefunctionorcontentsoftheO facility.> < OExamples O1. VDE>AMODIFY%FACILITY%ACCTNG% /REMARK="New&remark%string"Y %VDE-I-FACMOD,% information%for%facility%ACCTNG&modified&in&the%databaseM" %VDE-I-COMMIT,%database% transaction%has% successfully& committedJInthisexample,theuser specifiesanewremarkstringJforfacilityACCTNG.Thisremarkstringcanbe retrieved7Bwitha subsequentSHOWFACILITYcommand. O2. VDE>2MODIFY%FACILITY/NAME=ACCOUNTING%ACCTNG] %VDE-I-FACMOD,% information%for%facility% ACCOUNTING%modified%in%the%databaseMJ %VDE-I-COMMIT,%database% transaction%has% successfully& committedJInthisexample,thenameoffacilityACCTNGischangedHto ACCOUNTING.Youmustrefertothefacilitybythis8jnewnameinall subsequentVDE commands. O3. VDE>KMODIFY%FACILITY/CONFIRM&ACCTNG/REMARK="New%remark%string",%-/ _VDE>-/FUMBLE/REMARK="New&remark%string",w Modify%facility%ACCTNG&?%[No]: YwYG %VDE-I-FACMOD,%facility%ACCTNG%modified%in%the&database, Modify%facility%FUMBLE&?%[No]: YNMO %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE>EThisexample illustratesthe/CONFIRM qualifier.)ThisJ^ qualifiercausesVDEtoasktheuserwhethereachspec-Hifiedfacilityshouldbe modified.+ForfacilityACCTNG,J theuseranswersY(forYES)andtheremarkstringforNh thatfacilityismodifiedinthe database,asthelogmes-E sageshows.)ForfacilityFUMBLE,theuseranswersNJ (forNO)andthatfacilityisnot modified.+HencethereKq isnologmessageforthat facility.,Thefinallogmes-L sage indicatesthatthedatabase transactionforthewhole0# commandhas successfully committed.3UTV@OMODIFYFOLD* ROModifiestheremarkstringofoneormorefoldrecordsintheO(VDE database.&ORequiresRESREP privilege.lBOFormat2OsMODIFYFOLDMmod-name[, mod-name...]! PO ParameterOsmod-nameMO Specifiesamoduleforwhichafoldrecordistobemod-IO$ified./ThemodulenameconsistsofanoptionalfacilityFO|nameenclosedinsquare brackets,amodulename,andFOanoptionaltypenameprecededbyaperiod(suchasGO-[FACIL]MOD1.MAR).Ifthefacilitynameisomitted,theOOmoduleisassumedtobelongtothedefault facility.,IftheROtypenameisomitted,VDEmodifiesfoldrecordsforallsourcePO7moduleswiththe specifiedmodulenameinthegiven facility.I KOYoucanmodifyfoldrecordsformorethanonemodulebyNOusingwildcard charactersinanyofthethree componentsofOO5themodulename.'Thepercentsign( % )inanamematchesPOanysingle characterinthepositionitoccupiesandtheas-Oterisk( ]*C)matcheszeroormore charactersinthepositionPO>it occupies.(VDEmodifiesfoldrecordsforallsourcemodules6Owhosenamesmatchthewildcardpattern.O DescriptionCOsTheMODIFYFOLDcommandmodifiestheremarkstringDOofeach specifiedfoldrecordintheVDE database.pO QualifiersOs/CONFIRMO /NOCONFIRM (default)IO$ControlswhetherVDEasksyoutoconfirmthatyouwantIO|eachfoldrecord modified.)The/CONFIRM qualifiercausesNOVDEtoprintamessageforeachfoldrecordaskingwhetherLO-youwantthatrecord modified.*IfyouanswerYES(orY),OOthatfoldrecordismodifiedinthe database.*IfyouanswerPONO(orN),thefoldrecordisnot modified.,IfyouenteraIO7modulenamewithawildcardspecification,VDEasksyouLOtoconfirmthe modificationoffoldrecordsforeachmod-GOulewhosenamematchesthewildcardspecification.,TheHOA /NOCONFIRM qualifiercausesVDEtomodifythe specifiedHMODIFY%FOLD&[CODE]X.FOR/IDENT=1/REMARK="New%remark&string"\ %VDE-I-FOLDMOD,%fold%record%1%for%module& [CODE]X.FOR&modified&in&databaseM" %VDE-I-COMMIT,%database% transaction%has% successfully& committedj VDE>EThisexample specifiesanewremarkstringforfoldB1record1formodule [CODE]X.FOR.ThelogmessagesEshowthatthefoldrecordwas successfully modified.&0VUWFOMODIFY GENERATION*! OOModifiesthe attributes associatedwithspecificmodulegener-)O(ationsintheVDE database.&ORequiresRESREP privilege.rHOFormat8OsMODIFY GENERATIONNgen-spec[, gen-spec...]7 O ParameterOsgen-specPO Specifiesamodule generationina specified(orthedefault)KO$ developmentstreamwhose attributesaretobe modified.*AMO| generation specificationconsistsofthe followinginorder:6  `mFmanoptionalfacilitynameenclosedinsquarebrackets `amodulename `l;lanoptionaltypenameprecededbyaperiod `Fanoptional generationnumberprecededbya semicolonw{ MMOAnexampleofa generation specificationis[RMS]MOD1.MAR;5. WMOIfyouomitthefacilityname,module generationsfromtheROdefaultfacilityare modified.'Ifyouomitthetypename,gen-MO5erationsforallmoduleswiththe specifiedmodulenameinOOthe specifiedfacilityare modified.+Ifyouomitthegenera-POtionnumber,themostrecent generationofthemoduleinthe*O> specifiedstreamis modified." LOIfyouspecifyazeroornegative generationnumber,thatPOnumberisrelativetothemostrecent generationofthemod-MO5uleinthestream specifiedwiththe/STREAM qualifier(orQOthedefaultstreamifthat qualifieris omitted).)Forexample,QOifthemostrecent generationis generation5,then generationQO>0isthesameas generation5and generation-1isthesameOas generation4. NLOIfyouspecifythe /GENERATION qualifier,VDEmodifiestheHO generationwiththegivenCMS generation expressionand3O5ignoresthe generationnumberonthe5gen-spec?5 parameter. IOYoucanmodifymorethanone generationbyusingwild-MOcard charactersinthefacilityname,modulename,ortypeMO5name.*Thepercentsign( % )inanamematchesanysin-POgle characterinthepositionitoccupiesandtheasterisk( c* )OOmatcheszeroormore charactersinthepositionit occupies.O>Anasterisk( (J*)inplaceofthe generationnumbermatchesMOall generationsofamodule.'Thosemodule generationswhose>Onamesmatchthewildcardpatternare modified. =O DescriptionAOsTheMODIFY GENERATIONcommandallowsyoutomod-QOifythe attributes associatedwithaspecificmodule generation O$intheVDElibrary.H eJO AttributesthatcanbealteredviatheMODIFY GENERATIONOcommandinclude: v `mFmThe generation'sremarkstring.,Thisstringisorigi->nallycreatedbytheCREATEMODULEorREPLACEcommand. `IThemodule'sstatusinthe specified developmentstream.IThiscommandcanbeusedtomarkaspecific generationLOofthemoduleasasobsoleteinthe specified developmentHstream.'AnobsoletemoduleremainsintheVDEdatabaseOsinceitmaynotbeobsoleteforoldstreams,onlyfornewIYones.*OnceamoduleismarkedasobsoleteforagivenHstream,thatmoduleisnotcarriedovertoanyfutureA streamthathasthegivenstreamasitsparent. `OThemodule'sstatusasthemainlineofdescentinthethe) specified developmentstream. O QualifiersOs/CONFIRMO /NOCONFIRM (default)IO$ControlswhetherVDEasksyoutoconfirmthatyouwantIO|the attributesofeach generation modified.(The/CONFIRMNO qualifiercausesVDEtoprintamessageforeach generationKO-givingthenameofthe generationandaskingwhetheryouLOwanttomodifythe generation.*IfyouanswerYES(orY),LOthe generation's attributesare modified.*IfyouanswerNOIO7(orN),the attributesarenot modified.)The /NOCONFIRMPO qualifiercausesVDEtomodifythe attributesofeachgenera-3Otionwithoutaskingfor confirmation.KVO/GENERATION=gen-exprKO( Specifiesthatthe generationwiththeCMS generationex-"Opressiongivenbythecgen-expr" parameterbe modified.HOWhenthis qualifieris specified,the generationnumberO2 specifiedonthe2gen-spec!2 parameterisignored.UO/LOG (default)O(/NOLOGIOControlswhetherlogmessagesareprintedaftertheat-IOtributesof generationsare modified.-The/LOG qualifierJO2causessuchmessagestobeprintedand/NOLOG suppressesLOthem.(Themessagesindicatethatthe generationshavebeenLOmodifiedandthatthedatabase transactionhas successfullyO< committed.- h"O/MAIN_STREAM=stream-nameHO( Specifiesthestreamthat``owns''themain developmentKOthreadforthe specified generation..Ifthe generationisOOlaterreservedandits successorisreplacedintothestreamO2givenbythe2 stream-name+d2 parameter (directlyorthroughIOchange propagation),the successor generationwillgetaGO``whole-number''CMS generation expression.*Ifthecur-KO<rent generationhas generation expression10,forexample,OOthe generationcreatedby replacingintothe specifiedstreamMOgets generation expression11.(A replacementintoanyotherLOEstreamgetsa generation expressionsuchas10A1or10B1.OO Similarly,ifthecurrent generationhas generation expressionNO5A2,the specifiedstreamgetsthe``whole-number'' successorGOO5A3insteadofa generation expressionsuchas5A2A1.! aIOVDE automatically maintains informationaboutwhatstreamLOownsthe whole-number successorforeach generationintheMO5library.+This informationis determinedbyyouruseoftheBO/MAIN qualifiertotheCREATESTREAMcommand.*ForJOthisreason,youwillseldomneedthe /MAIN_STREAMqual-@O>ifiertotheMODIFY GENERATIONcommand.*However,KOthereare exceptionalcaseswhereyoumayneedtochangeIOwhatstreamownsthe whole-number successorforagivenSOH generation,andthenthis qualifierletsyousetthat attribute.O/NOTE=note-number O(The( note-number17( parameter specifiesthenotenumberKOforthe(previously-entered)SCTnote associatedwiththisO replacement.QOVDEcanalsoenterthenoteintothe conference directly,see1Othe/SCT qualifierfor information.[ 1O /OBSOLETEO( /NOOBSOLETELO SpecifieswhetherthemoduleismarkedasobsoleteintheDO specified developmentstream.,The /OBSOLETE qualifierRO2 specifiesthatthemoduleisobsoleteinthatstream.(Anobso-OOletemoduleisnot propagatedtofuturestreamscreatedfromJOthatstream.)The /NOOBSOLETE qualifier specifiesthattheQO<moduleisnot obsolete.+Ifneither qualifieris specified,the=Ocurrentstatusofthemoduleisnotchanged. O/REMARK="string"RO( Specifiesanewremarkstringtobestoredforthe generation.MOThisstringreplacesthe generation'scurrentremarkstring.LOThequotedremarkstring,whichcanbeupto132charac-IO2terslong,maycontainany explanatoryremarkabouttheFO generationthatyouwantstoredintheVDE database. NUOTheremarkstringisusedasthetitleoftheSCTnote,ifVDEPOwasaskedtoentertheSCTnotebythe specificationoftheO5/SCT qualifier.eK;O /SCT=filename O(The(filename>{( parameter specifiesthenameofafiletobeOOloadedintotheSCTnotes conference.)ThisfilecontainstheJOpreviously-editedtextofanSCTentryfortheSCTnote.O2 associatedwiththis replacement.SOIfthis qualifierisused,thedefaultnotes conferencefortheO stream-SCT-D stream-name?-isassumed.zQOIfthis qualifieris specified,the/REMARKstringisusedas)OthetitleoftheSCTnote.NOFor informationonthepropercreationand protectionofan+OSCTnotes conference,seethe GuidetoUsingVDE S.R((OAlsosee/FOLDand/OTHER.O/STREAM=stream-nameLO( Specifiesthat generationsforthe developmentstreamgivenObytheD stream-name3 parameterbe modified.(This qualifierNOthusaffectstheinterpretationof generationnumbersontheO2 command's2gen-spec42 parameter.*Ifthis qualifierisomit-JOted,VDEmodifies generationsforthedefault developmentOstream. OExamples O1. VDE>LMODIFY% GENERATION&[FACIL]MODNAM.C;5/REMARK="New&remark%string"\ %VDE-I-GENMOD,% information%for% generation%[FACIL]MODNAM.C;5%modified%in%theC databaseM %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE>GBThisexamplechangestheremarkstring associatedwithC generation5ofmoduleMODNAM.CinfacilityFACIL.KThelogmessagesconfirmthatthe attributesofthemod-DKuleweremodifiedandthatthedatabase transaction" successfully completed. O2.= VDE>3=MODIFY% GENERATION& MODNAM.MAR% /OBSOLETE\ %VDE-I-GENMOD,% information%for% generation%[RMS]MODNAM.MAR;6%modified%in%the databaseM %VDE-I-COMMIT,%database% transaction%has% successfully& committed] VDE>LThisexample illustrateshowtomarkamoduleasobsoleteI$inthedefaultstream.)ThemodulewillbedroppedfromK}allfuturestreams descendedfromthedefaultstream,but=willremain accessibleinthedefaultstream.Q*WVXAOMODIFYGROUP* NOModifiesthe attributesand membershipofasourcegrouporNO(buildgroupintheVDE database.)The attributesofagroupFOthatyoucanmodifyarethegroup'snameandremarkROstring.'The membershipofagroupisthelistofmodulesthat'O2aremembersofthegroup.&ORequiresCREGRP privilege.~TOFormatDOsMODIFYGROUPM group-name[=mod-name[, mod-name...]]1 O ParametersOs group-nameQOThenameofagroupwhose definitionistobe modified.(ThisJO$groupmustbedefinedinthedefault developmentstream.DO|Thegroupnamemaynotcontainwildcard characters.I! ^Omod-nameLO(ThenameofamodulethatshouldbeaddedtoorremovedSOfromthe specifiedgroup.(Ifthegroupisasourcegroup,thisKOmodulemustbeasourcemodule.'ThemodulenameconsistsNO2ofanoptionalfacilitynameenclosedinsquare brackets,aLOmodulename,andanoptionaltypenameprecededbyape-FOriod(forexample,[FACNAM]MODNAM.MAR).IfnofacilityRO<nameis specified,thedefaultfacilityisassumed.*IfnotypeQOnameis specified,allsourcemodules(forasourcegroup)orNOallmodules(forabuildgroup)withthegivenmodulenameROEinthegivenfacilityareaddedtoorremovedfromthegroup.! |MOYoucanaddorremovemorethanonemoduleatatimebyNOusingwildcard charactersinanyofthethree componentsofOO5themodulename.'Thepercentsign( % )inanamematchesPOanysingle characterinthepositionitoccupiesandtheas-Oterisk( \*G)matcheszeroormore charactersinthepositionitOO> occupies.(Thosesourcemodules(forasourcegroup)orthoseMOmodules(forabuildgroup)whosenamesmatchthewildcardAOpatternareaddedtoordeletedfromthegroup.yHOIfno module-name parametersare specified,themember-1Oshipofthegroupisnotchanged.f <O DescriptionNOsAgroupisalwaysdefinedinaspecific developmentstream.POYoucanonlyrefertothegroupfromwithinthatstream.(AsFO$aresult,theMODIFYGROUPcommandonlymodifiestheCO|group definitioninthedefault developmentstream. WrKOTomodifygroup definitionsformorethanone developmentCOstream,youmustusetheMODIFYGROUPcommandforKO5eachstream.(Foreachstream,firstentertheSETSTREAMFOcommandtosetthe developmentstreamthenentertheBOMODIFYGROUPcommandtochangethegroupinthatO>stream.WNOToapplya qualifiertothecommandasawhole,placetheEO qualifier immediatelyaftertheMODIFYGROUPkeywordsO5andbeforethel5 group-name(5 parameter.*Withthisplace-NOment, qualifierssuchasthe/REMARK qualifierapplytotheQOentire specifiedgroupor,aswithsuch qualifiersas/ADDorIO>/REMOVE,toallmodules specifiedaftertheequalsign.! IOOnlythe/ADDand/REMOVE qualifierscanmodifyanin-DOdividual module-name parameter.,ToaddorremoveanLO5 individualmodule,placethe/ADDor/REMOVE qualifierim-GO mediatelyafterthe module-name parameter.)The/ADDorHO/REMOVE qualifierplacedafteran individual module-nameHO> parameter overridesthe command-level qualifierforthatOone parameter.' O QualifiersOs/ADD (default)O/REMOVENO$Controlswhetherthemodules specifiedinthe parameterlistNO|areaddedtoorremovedfromthegroup.'The/ADD qualifierJOaddsthe specifiedmodulestothegroupandthe/REMOVELO- qualifierdeletesthemfromthegroup.,TosetthedefaultOOforthecommandasawhole,specifythe qualifieraftertheGOMODIFYGROUP keywords.)Tooverridethatdefaultfora>O7singlemodule,specifythe qualifierafterthe7mod-name d7pa-TOrameteryouchoosetoaddordelete.'IfyoudonotspecifyoneFOofthese qualifiers,modulesareaddedtothegroup.d::OOf/ADDand/REMOVE,/ADDisthedefault.O/BUILDO(/SOURCE (default)OO Specifieswhetherasourcegrouporbuildgroupis modified.GOThe/SOURCE qualifiercausesVDEtomodifythesourceLO2groupwiththe specifiedname.(The/BUILD qualifiercausesMOVDEtomodifythebuildgroupwiththe specifiedname.*IfNOneither qualifieris specified,VDEmodifiesasourcegroup.i??OOf/BUILDand/SOURCE,/SOURCEisthedefault.! ^O/CONFIRMO( /NOCONFIRM (default)NOControlswhetherVDEasksyoutoconfirmthatyouwanttheHOgroup definition modified.)The/CONFIRM qualifiercausesNO2VDEtoprintamessageforthegroupitisabouttomod-KOifygivingthenameofthegroupandaskingwhetheryouKOwantthatgroup modified.,IfyouanswerYES(orY),theNO<group definitionis modified.*IfyouanswerNO(orN),theHOgroup definitionisnot modified.)The /NOCONFIRMquali-POfiercausesVDEtomodifythegroup definitionwithoutaskingOEfor confirmation.UO/LOG (default)O(/NOLOGKOControlswhetherlogmessagesareprintedafterthegroupMO definitionis modified.)The/LOG qualifiercausessuchmes-IO2sagestobeprintedandthe/NOLOG qualifier suppressesKOthem.(Themessagesindicatethatthegrouphasbeenmod-IOifiedandthatthedatabase transactionhas successfullyO< committed.! O/NAME=group-nameQO( Specifiesanewnameforthe indicatedgroup.'AfterthegroupNOnameischanged,thegroupmustbereferredtobythenewMOnameinall subsequentVDE commands.'TheoldnameislostOO2fromthe database.'Thenewnamecanbeupto39 characters=OlongandmustfollownormalVDEnamesyntax. O/REMARK="string"SO( Specifiesaremarkstringtobestoredforthe specifiedgroup.KOThisremarkstringreplacestheremark specifiedwiththeAOCREATEGROUPcommandthatcreatedthegroup.+TheMO2quotedremarkstringcanbeupto132 characterslongandIOmaycontainany explanatoryremarkaboutthegroupthat7OyouwanttostoreintheVDE database.   OExamples O1. VDE><MODIFY%GROUP/REMARK="New%remark%string"%GRPNAMV %VDE-I-GRPMOD,% information%for%group%GRPNAM&modified&in&the%databaseM" %VDE-I-COMMIT,%database% transaction%has% successfully& committedj VDE>BThiscommandmodifiestheremarkstring associated@1withsourcegroupGRPNAM.Thelogmessagescon-Kfirmthatthegroup definitionwasmodifiedandthatthe9database transaction successfully committed. OZ2.Z VDE>7ZMODIFY%GROUP/BUILD/NOLOG/NAME=NEWNAM%OLDNAM VDE>SHOW% GROUP/BUILD Build%group%NEWNAM2 VDE>AInthisexample,thenameofbuildgroupOLDNAM@ischangedtoNEWNAM.The/NOLOG qualifiersup-BRpressesthelog messages.)A subsequentSHOWGROUP9commandshowsthenewnameofthegroup. O#3.( VDE>9(MODIFY% GROUP/SOURCE%GRP1%=&A,& B.MAR/REMOVETp %VDE-I-GRPMOD,% information%for%group%GRP1%modified%in%the%databaseI %VDE-I-GRPADD,%module% [CODE]A.PAS%is%added%to%group%GRP1M %VDE-I-GRPREM,%module% [CODE]B.MAR%is%removed%from&group&GRP1MH %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE>DThiscommandaddsmoduleA.PAStothesourcegroup?W namedGRP1andremovesmoduleB.MARfromGRP1.L Notypenameis specifiedformoduleA;henceallsourceH modulesnamedAinthedefaultfacilityareadded.+AsLa thelogmessages indicate,thereisonlyonesuchmodule,$ A.PAS,inthisexample. O2 4.7 VDE>:7 MODIFY% GROUP/REMOVE%GRP1%=& A.PAS/ADD,%B.MART %VDE-I-GRPMOD,% information%for%group%GRP1%modified%in%the%databaseI %VDE-I-GRPADD,%module% [CODE]A.PAS%is%added%to%group%GRP1M %VDE-I-GRPREM,%module% [CODE]B.MAR%is%removed%from&group&GRP1MW %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE>C ThiscommandalsoaddsmoduleA.PAStogroupGRP1=f andremovesmoduleB.MAR.Becausethe/REMOVE=  qualifier immediatelyfollowstheMODIFYGROUPK keywords,allmodules specifiedinthe parametersarere-Hpmovedbydefault.(ThisdefaultappliestomoduleB.MARKbecauseitisnot overridden.(However,the/ADD qualifierK! specifiedformoduleA.PAS overridesthedefaultforthatAymoduleandA.PASbecomesamemberofthegroup.IY(XZBOMODIFYMODULE*oIOModifiesthe attributesofmodulesintheVDE database.&OkRequiresCREMOD privilege.nDOFormat4OsMODIFYMODULENmod-name[, mod-name...]! PkO ParameterOsmod-nameMOThenameofanexistingmoduleinthecurrentVDElibraryLO$whose attributesaretobe modified.(ThemodulenamemustNO|consistofamodulenameandamoduletype separatedbyaFOperiod(asin MODNAM.FOR)andmay optionallybepre-OO-cededbyafacilitynameenclosedinsquarebrackets(asin>O[ACCTNG]MODNAM.FORwhereACCTNGisthefacilityROname).'Ifnofacilitynameis specified,themoduleisassumed:O7tobelongtothecurrentdefault facility.0HOYoucanmodifymorethanonemodulebyusingwildcardJO charactersinanyofthethree componentsofthemoduleMO5name.*Thepercentsign( % )inanamematchesanysin-POgle characterinthepositionitoccupiesandtheasterisk( c* )OOmatcheszeroormore charactersinthepositionit occupies.JO>VDEmodifiesthe attributesofthosemoduleswhosenames(Omatchthewildcardpattern.0  O Description?OsTheMODIFYMODULEcommandallowsyoutomodifyHOvarious attributes associatedwithamodule.*TheMODIFYHO$MODULEcommandsapplyto attributesthatspananumber"O|ofmodule generations. ! POFor informationonchangingthe attributesspecifictoapar-+Oticularmodule generation,seeMODIFY GENERATION. eThe5O5MODIFYGENERATION/MAIN_STREAM, /OBSOLETE,GOand/REMARK qualifiersallowyoutomarkamoduleasOOthemainlineofdescent,tomarkamoduleas obsolete,orJO>tochangetheremark associatedwitha particularmoduleO generation.* ? ! pO QualifiersOs/BINARYO /NOBINARYPO$ Specifieswhetherthesourcemoduleisabinaryfileornot.NO|The/BINARY qualifier specifiesthatthesourcemoduleisaPObinary (non-text)file.'Binarysourcefilescannotbereviewed?O-or differencedwiththeREVIEW REPLACEMENTcom-POmandbecausetheydonotconsistofordinaryASCIItext.'TheLO /NOBINARY qualifier specifiesthatthesourcemoduleisanPO7ordinaryASCIItextfile.'These qualifiersareonly meaningfulOforsourcemodules. WGOLargefilesthatundergo extensivechangesatfrequentMO intervals,oraretheoutputofalanguageor application,QO5maynotbesuitedforstorageasstandarddeltafilesastheNOfiledeltaisneverused,occupiesa considerableamountofGOdiskspace,andgrowsrapidly.,Seethe/MARKERquali-OO>fier.) Executableimages,objectmodules, Postscriptfiles,andKOBACKUPsavesetsareallexampleof ``source''modulesforCOwhichthe marker-file mechanismmaybe appropriate. UO /CONCURRENTO( /NOCONCURRENTJO Specifieswhetherthemodulecanbereserved concurrentlyFObymorethanoneuser.)The /CONCURRENT qualifieral-LO2lowsthemoduletobereserved concurrentlyunlessauserMO overridesthisdefaultwithforaspecific reservation.,The@O /NOCONCURRENT qualifier specifiesthatthemodule-O<cannotbereserved concurrently.! ^O/CONFIRMO( /NOCONFIRM (default)IOControlswhetherVDEasksyoutoconfirmthatyouwantEOthe attributesofeachmodule modified.,The/CONFIRMPO2 qualifiercausesVDEtoprintamessageforeachmodulegiv-JOingthenameofthemoduleandaskingwhetheryouwantMOtomodifythemodule.*IfyouanswerYES(orY),themod-OO<ule's attributesare modified.*IfyouanswerNO(orN),theEO attributesarenot modified.+The /NOCONFIRM qualifierMOcausesVDEtomodifythe attributesofeachmodulewithout$OEaskingfor confirmation.)! UO/DELETEO( /NODELETE (default)OSetsorclearsthedelete1 attributeforthemodule.)Thisat-JOtributeallowsthemoduletobedeletedwiththeDELETEFO2MODULEcommand.'The/DELETE qualifiersetsthedeleteMO attributesothatthemodulecanbedeleted.'The /NODELETERO qualifierclearsthedelete attributesothatthemodulecannotAO<bedeletedwithoutfirst resettingthe attribute. O/HISTORY[="string"]O(/NOHISTORY[="string"]MO SpecifiestheCMShistorystringtobe associatedwiththeEOmoduleandwhetherhistory informationshouldbein-MO2cludedinsourcefileswhenmodulesare retrievedwiththeFOFETCHorRESERVEcommand.'History informationgivesaEO historicalrecordofpreviouschangestothemodule.! IOThe/HISTORY qualifier specifiesthathistory informationQOshouldbeincludedinsourcefilesbydefaultwhensuchfilesFO5are retrievedwiththeFETCHorRESERVEcommand.(TheFO /NOHISTORY qualifier specifiesthathistory information#Oshouldbeomitted.,Thestring' parametertoeitherquali-RO>fier specifiesthedefaulthistorystringiftheuser specifiesSOthathistory informationshouldbeincludedina retrievedfile.HO(Ifyouspecifythe /NOHISTORY qualifierontheMODIFYAOHMODULEcommand,youmustusethe/HISTORYquali-KOfierontheFETCHorRESERVEcommandtousethedefault9Ohistorystring.)&Ifyoudonotspecifyastring parameter,VDEOORsuppliesadefaulthistorystringthatdependsonthemoduleOtype.uIOSeetheCMS documentationfora descriptionoftheCMS,Ohistorystringanditsformat.! O/LOG (default)O(/NOLOGIOControlswhetherlogmessagesareprintedaftertheat-MOtributesofmodulesare modified.)The/LOG qualifiercausesIO2suchmessagestobeprintedand/NOLOG suppressesthem.KOThemessagesindicatethatthemoduleshavebeenmodifiedNOandthatthedatabase transactionhas successfully committed.! hO/MARKERO( /NOMARKERLO SpecifieswhetherthesourcemoduleusesamarkerfileorKOnot.)The/MARKER qualifier specifiesthatthesourcemod-OO2uleusesamarkerfile.&WhenasourcemoduleusesamarkerROfile,themoduleisstoredasanordinaryfileinoneoftheUO delta-file directories.(Asmalltextfile,calledthemarkerfile,UO<containsthefullfilenameofthatsourcefile,andthismarkerOOfileisstoredinthemodule'sdeltafile(CMS element).,InYOshort,thedeltafilecontainsasmalltextfilethatpointstotheJOEmodule'sactualsourcefile.)The marker-file mechanismisKOnormallyonlyusedforlargeor frequentlychangedbinaryGOsourcemodules,forwhichthe delta-file mechanismmayCOOgivepoor performanceoruse excessivediskspace.S)IOThe /NOMARKER qualifier specifiesthatthesourcemoduleUOdoesnotuseamarkerfileandthatitstextisstoreddirectlyKO5inthedeltafile(CMSelement)forthemodule.+Ordinary@OASCIItextmodulesshouldnotusemarkerfiles.[11OAlsoseethe /[NO]BINARY qualifier.! O/NOTES[="string"]O(/NONOTES[="string"]QO SpecifiestheCMSnotesstringtobe associatedwiththemod-POuleandwhetherCMSnotesshouldbeincludedinsourcefilesFO2whenmodulesare retrievedwiththeFETCHorRESERVEFOcommand.*CMSnotesindicateinwhatmodule generation+Oeachsourcelinewascreated. kMOThe/NOTES qualifier specifiesthatnotes informationshouldNObeincludedinsourcefilesbydefaultwhensuchfilesareAO5 retrievedwiththeFETCHorRESERVEcommand.,TheJO/NONOTES qualifier specifiesthatnotes informationshouldObeomitted.'Thestring5 parametertoeither qualifier specifiesTO>thedefaultnotesstringiftheuser specifiesthatnotesinfor-ROmationshouldbeincludedina retrievedfile.)(IfyouspecifyAOthe/NONOTES qualifierontheMODIFYMODULEcom-KOHmand,youmustusethe/NOTES qualifierontheFETCHorKORESERVEcommandtousethedefaultnotesstring.)(IfyouOdonotspecifyastring/ parameter,VDEsuppliesadefault>ORnotesstringthatdependsonthemoduletype.sIOSeetheCMS documentationfora descriptionoftheCMS*Onotesstringanditsformat.^ U4,O/NOTIFY=(username[,username...])0O(/NONOTIFY[=(username[,username...])]UOThe/NOTIFY qualifier specifiesalistofuserstonotifyofallNOchangestothe specifiedmodule.'VDEappendstheseuserstoname,keepinmindthatthelogicalnamemustbedefinedROwhenitislaterusedtosend notification messages.(ItshouldSOthusbeagrouporsystemlogicalnameoralogicalnamethatTOHisinsomeotherwaydefinedforallusersoftheVDElibrary.! WQOThe /NONOTIFY qualifier specifiesthatalistofusersalreadyQOonthemodule's notificationlistberemovedfromthatnotifi-O5cationlist.(Each5username(]5 parametergivestheOpenVMSNOusernameormailaddressofausertoremovefromtheno-/O tificationlist.*Ifyouomitthewusername( parameters,VDEEO>removestheentire notificationlistforthemodule. NOOIfyouspecifyboth qualifiers,VDEremovestheusersspeci-NOfiedwiththe /NONOTIFY qualifierfromthe notificationlistOO5beforeaddingtheusers specifiedwiththe/NOTIFY qualifier.%OIfyouspecifyonlyoneusername!G parameterwitheitherDO qualifier,youmayomitthe surrounding parentheses.~T!O/POSITION=column-numberHO( SpecifiesthedefaultcolumnnumberinwhichCMSnotesQOaretobeplacedwhenthissourcemoduleis retrievedwithaAOFETCHorRESERVEcommand.(ThecolumnnumbermustVO2beanintegerintherange1to511.)Ifthis qualifierisomit-OOted,thedefaultcolumnnumberis81.)This qualifierhasnoOOeffectunlessnotesareenabledwiththe/NOTES qualifieron?O<theCREATEorMODIFYMODULEcommandoronthe&OFETCHorRESERVEcommand. KOSeetheCMS documentationfora descriptionofCMSnotesLOandhownotesare formattedattheendsofsourcelines.!! WO /PROPAGATEO( /NOPROPAGATEIO Specifieswhether automaticchange propagationisallowedMOforthismodulewhenitisreservedandreplacedintotheCO2library.+ /PROPAGATEallows automaticchangepropaga-FOtionand /NOPROPAGATE disallowschange propagation.(IfLOchange propagationis disallowed,VDE automaticallyinhibitsLO<change propagationwhenthemoduleisreservedorreplacedNOasifthe /NOPROPAGATE qualifierhadbeen specifiedforthe(ORESERVEorREPLACEcommand.d"! :O/REMARK="string"OO( Specifiesaremarkstringtobestoredforthemodule.*ThisLOstringreplacestheremarkstringfromtheoriginalCREATE:OMODULEcommandorfromanypreviousMODIFY?O2MODULEcommand.-Thequotedremarkstring,whichNOcanbeupto132 characterslong,maycontainanyexplana-LOtoryremarkaboutthemodulethatyouwantstoredintheNO<VDE database.' Typicallytheremark describesthefunctionor$Ocontentsofthemodule./#G IOThis qualifieraltersthe module-levelremarkstring.-ToJOchangetheremarkona particularmodule generation,see@O5the documentationontheMODIFYGENERATION/REMARKOcommandin-MODIFY GENERATION.*#-P?$ h.O/REVIEWER=(username[,username...])2O(/NOREVIEWER[=(username[,username...])]POThe /REVIEWER qualifier specifiesalistof reviewersforallLOchangestothe specifiedmodule.'VDEappendsthesereview-AO2erstothemodule'sexistingreviewerlist.*Each2usernameDO parametergivestheOpenVMSusernameofauserwhoNOshouldreviewallchangestothemodule.(Theusermustal-IO<readyberecordedintheVDE database.+WhenthemoduleSOisreplacedintotheVDElibrary,VDEnotifiestheuseroftheLOchangebymailmessage.*Ifthe replacementisqueued,theNOEusershouldthenreviewthequeued replacementbeforeitisNO performed.'Ifthe replacementis immediate,VDEnotifiestheOOuserofthenewmodule generationthatwascreated,andthe5OOusermaytheninspectthat generation.% WMOThe /NOREVIEWER qualifier specifiesthatalistofexistingMO reviewersforthe specifiedmoduleberemovedfromthere-O5viewerlist.(Each5username(v5 parametergivestheOpenVMSIOusernameofauserwhoshouldberemovedfromthere-+Oviewerlist.,Ifyouomitthe9username parameters,VDEAO>removestheentirereviewerlistforthemodule.&NOIfyouspecifyboth qualifiers,VDEremovestheusersspec-GOifiedwiththe /NOREVIEWER qualifierfromthereviewerKO5listbeforeaddingtheusers specifiedwiththe /REVIEWERO qualifier.'%OIfyouspecifyonlyoneusername!G parameterwitheitherDO qualifier,youmayomitthe surrounding parentheses.[(A 1OExamples O1. VDE>8MODIFY%MODULE%MODNAM.C/REMARK="New%Comment"_ %VDE-I-MODMOD,% information%for%module&[CODE]NEWNAM.C&modified&in&the%databaseM %VDE-I-COMMIT,%database% transaction%has% successfully& committede VDE>GThisexamplechangestheremarkpresentonthemoduleC, MODNAM.C.Sincenofacilityis specified,themod-Muleisassumedtobelongtothedefault facility,facilityGCODEinthiscase.*ThelogmessagesconfirmthattheE5 attributesofthemoduleweremodifiedandthatthe9database transaction successfully completed. O2.- VDE>3-MODIFY% MODULE/NOLOG%[TAPE]DEVDRV.MAR%-u _VDE>-yu /REMARK="Old&tape%device&driver" VDE>1MODIFY% GENERATION&[TAPE]DEVDRV.MAR%- _VDE>//NOLOG% /OBSOLETEM VDE>JInthisexample,theuserchangestheremarkstringforBmodule DEVDRV.MARinfacilityTAPE,andthenuses9ltheMODIFY GENERATIONcommandtomarktheJmoduleas obsolete.(The/NOLOG qualifieris specifiedonGboth commands;the qualifier suppressesthedisplayof!vmessagesfromeither.%ZY[G)OMODIFY REPLACEMENT**+! LOModifiesthe attributesofoneormorequeued replacementsPO(intheVDE database.'The attributesofa replacementyoucanHOmodifyareitsname,remarkstring,andreviewerlist.AORequiresRESREP privilegetomodifyyourownre->Ou placement.,RequiresPERFREP privilegetomodify'Oanotheruser's replacement.s,IOFormat9OsMODIFY REPLACEMENTNrep-name[, rep-name...]-! PO ParameterOsrep-nameOOThenameofaqueued replacementwhose attributesaretobeJO$ modified.*Youcanmodifymorethanone replacementataLO|timebyusingwildcard charactersinthe replacementname.MOThepercentsign( % )ina replacementnamematchesanyPO-single characterinthepositionitoccupiesandtheasterisk O( w*N)matcheszeroormore charactersinthepositionitoccu-OOpies.'VDEmodifiesthe attributesofthose replacementswhose/O7namesmatchthewildcardpattern..|ODonotspecifytherep-name& parameterifyouusethe%O/IDENTIFICATION qualifier./! ZO QualifiersOs/CONFIRMO /NOCONFIRM (default)IO$ControlswhetherVDEasksyoutoconfirmthatyouwantHO|eachqueued replacement modified.'The/CONFIRM qualifierLOcausesVDEtoprintamessageforeach replacementaskingKO-whetheryouwantthat replacement modified.'IfyouanswerMOYES(orY),the replacementis modified.)IfyouanswerNOPO(orN),the replacementisnot modified.*Ifyouenterare-LO7 placementnamewithawildcardspecification,VDEasksyouLOtoconfirmthe modificationofeach replacementwhosenameAOmatchesthewildcardspecification.-The /NOCONFIRMJOA qualifiercausesVDEtomodifythe specified replacements-Owithoutaskingfor confirmation.Z0 K0"O/IDENTIFICATION=id-rangeLO( Specifiesthatthe replacementswiththeunique ReplacementOIdsgivenbytheid-range+% parameterbe modified.+DonotOspecifytherep-name1 parameterwhenyouusethisquali-O2fier.&1GOVDEassignsaunique ReplacementIdtoeach immediateIOorqueued replacementintotheVDElibrary.*VDEassignsOO5 ReplacementIdsin chronologicalordersothatthefirstre-OO placementintothelibraryhasIdvalue1,thenexthasIdMOvalue2,andsoon.-Whenyouusethis qualifier,allre-LO> placementsthathaveIdvaluesintherangegivenbytheOid-range# parameterare modified.2! a OTheid-range;r parametercanbeasingleintegervalue,aMOrangeof integers,orawildcard character.)Iftheparame-PO5terisasingleinteger(forexample, /IDENT=5),VDEmodifiesJOthe replacementwiththat ReplacementId.)Iftheparame-SOterisarangeofintegers (specifiedastwointegers separatedNO>byacolonasin /IDENT=3:5),VDEmodifiesthe replacements8OwithIdsinthatrange.+Finally,iftheid-range&parame-GOteristheasteriskwildcard character(asin/IDENT= *),VDE&OHmodifiesall replacements.3! WBOIfyouspecifyazeroornegativenumberintheid-range jpa-MOrameter,thatnumberisrelativetothelargest ReplacementMO5IdvaluefortheVDElibrary(thelatest replacement).+ForLOexample,ifthelatest replacementhas ReplacementId250,HOthen/IDENT=0is equivalentto /IDENT=250and /IDENT=-1)O>is equivalentto /IDENT=249.]4 3"O/INFORMATION[=file-spec]NO( Specifiesthatanew informationfileshouldbeattachedtoHOthequeued replacementorthattheexisting information(Ofileshouldbeedited.,The file-specu parametergivestheJO2OpenVMSfile specificationofanew informationfileforQOthe replacement.,If specified,thisfileiscopiedtothere-JO placement'sstagingareaandthen supercedesanypreviousLO< informationfileforthe replacement.,Ifthis parameterisMOomitted,VDEasksyouwhetheryouwanttoedittheinfor-MOmationfile.(IfyouanswerYES,VDEinvokesyour preferredROEeditortoeditthe replacement's informationfile.(Ifaninfor-TOmationfilealreadyexists,theeditoreditsthatfile; otherwiseSOitcreatesanew informationfile.(The informationfileisusedLOOtopass informationaboutthe replacementto reviewersandOothers.05 QOToeditan informationfilethroughVDE,youshouldfirstde-JOclareyour preferrededitorwiththeSETEDITORcommand.KO5Ifyoudonotdeclareaneditor,VDEinvokedthesystem Odefaulttexteditor.6! O/LOG (default)O(/NOLOGIOControlswhetherlogmessagesareprintedafterthere-HO placementsare modified.+The/LOG qualifiercausessuchHO2messagestobeprintedand/NOLOG suppressesthem.*TheKOmessagesindicatethatthe replacementshavebeenmodifiedNOandthatthedatabase transactionhas successfully committed.7 O/NAME=rep-nameKO( Specifiesanewnameforthequeued replacement.(ThenewMO replacementnamecanbeupto39 characterslongandmustEOfollownormalVDEnamesyntax.,Afterthe replacementKO2namehasbeenchanged,youmustrefertothe replacementKObyitsnewnameinall subsequentVDE commands.(Theold.Onameislostfromthe database. 8UO/REMARK="string"IO( Specifiesanewremarkstringforthe replacement.,ThisDOstring replacestheremarkstring fromtheoriginal7OREPLACEorCREATE REPLACEMENTcommandortheentirereviewerlistforthe replacement.;NOIfyouspecifyboth qualifiers,VDEremovestheusersspec-GOifiedwiththe /NOREVIEWER qualifierfromthereviewerKO5listbeforeaddingtheusers specifiedwiththe /REVIEWERO qualifier.<%OIfyouspecifyonlyoneusername!G parameterwitheitherDO qualifier,youmayomitthe surrounding parentheses.= OExamples O1. VDE>CMODIFY% REPLACEMENT%SMITH-2/REMARK="New&remark%string"] %VDE-I-REPMOD,% information%for% replacement%SMITH-2%modified%in%the%databaseM" %VDE-I-COMMIT,%database% transaction%has% successfully& committedj VDE>EThisexamplemodifies replacementSMITH-2togiveitF1anewremarkstring.+Thelogmessagesshowthatthe9 replacementhas successfullybeen modified.<[Z\G>OMODIFY RESERVATION*?@KOModifiesthe attributesofmodule reservationsintheVDEO( database.&ORequiresRESREP privilege.qAGOFormat7OsMODIFY RESERVATIONMmod-name[,mod-name...]B O ParameterOsmod-nameIO Specifiesareservedsourcemodulewhose reservationat-OO$tributesaretobe modified.)ThemodulenameconsistsofanNO|optionalfacilitynameenclosedinsquare brackets,amoduleNOname,andanoptionaltypenameprecededbyaperiod(suchKO-as[FACIL]MOD1.MAR).Ifthefacilitynameisomitted,theUOmoduleisassumedtobelongtothedefault facility.'IfthetypeQOnameisomitted,the reservation attributesofallsourcemod-MO7uleswiththegivenmodulenameinthegivenfacilityareO modified.PC &MOYoucanmodifythe reservation attributesofmorethanoneJOmoduleusingwildcard charactersinany componentoftheOO5modulename.'Thepercentsign( % )inanamematchesanyPOsingle characterinthepositionitoccupiesandtheasterisk O( w*N)matcheszeroormore charactersinthepositionitoccu-NO>pies.)The reservation attributesofthesourcemoduleswhose>Onamesmatchthewildcardpatternare modified.8D QOIfyouusethe/SESSION qualifier,those reservationsthatareOOmembersofthe specified reservationsessionare modified.(In+O5thiscase,youmustomitthe]5mod-name=5 parametersfromOthecommand. EO DescriptionFOsWhenyoureserveamodulefromtheVDElibrary,theCORESERVEcommandrecordsthe reservationintheVDEAO$ database.(TheMODIFY RESERVATIONcommandletsyouMO|modifyvarious attributesofoneormoresuch reservations.KOThecommandmodifiesonly reservationsthatcoverthede-KO-fault developmentstreamorthestream specifiedwiththeO/STREAM qualifier.\F2JOIfyouhavemorethanone reservationofamodule,youGOmustspecifytheexact reservationtobemodifiedus-?O5ingthe/IDENTIFICATION qualifier./UsetheSHOWBO RESERVATIONcommandto determinetheidentification Oofeach reservation."GHOTomodifyanotheruser's reservation,usethe /USERNAMEIO qualifiertospecifytheOpenVMSusernameofthatotherHO5user.*YoumusthavetheUSERNAME privilegetousetheO /USERNAME qualifier.)HO QualifiersOs /CONCURRENTLO SpecifiesthatthemodulecanbereservedbyanotheruserHO$whileyouhaveit reserved./This qualifierchangestheBO|concurrent-reservation attributeofthe reservation.I! cO/CONFIRMO( /NOCONFIRM (default)IOControlswhetherVDEasksyoutoconfirmthatyouwantHOeach reservation modified.(The/CONFIRM qualifiercausesKO2VDEtoprintamessageforeachmodulethatyouspecifyLOaskingwhetheryouwanttomodifyits reservation.*IfyouQOanswerYES(orY),the reservationis modified.'IfyouanswerGO<NO(orN),itisnot modified.+The /NOCONFIRMquali-NOfiercausesVDEtomodifyeach specified reservationwithout$Oaskingfor confirmation.J hO/FOLD[=fold-ident]O(/NOFOLDNOThe/FOLD qualifier specifiesafoldrecordtobe cancelledNOwhenthismodule reservationis eventuallyreplacedintotheO2library.)The2 fold-ident12 parametergivesthefold identifierOOofafoldrecordforthemodulebeingreservedandfortheOOstreaminwhichthe reservationisdone.'Whenyoulaterre-HO<placethemoduleandVDEperformsthe replacement,VDEJOwillcancelthisfoldrecordfromtheVDE database.-YouOcanomitthe/ fold-ident3 parameterifthereisonlyonefoldOOErecordforthe specifiedmoduleandstream.(YoucanusetheQO/FOLD qualifierifyouare modifyingthemoduletosatisfyanQOexistingfoldrecord.'Youcanalsospecifythe/FOLD qualifierFOOwiththeREPLACEcommandtoachievethesameeffect.}K SNOThe/NOFOLD qualifier specifiesthatnofoldrecordbecan-JOcelledwhenthismodule reservationisreplacedintotheRO5library.(This qualifiercancelstheeffectofa/FOLD qualifierDOonapreviousMODIFY RESERVATIONcommandoronthe%OoriginalRESERVEcommand.L! #O/IDENTIFICATION=res-identRO( Specifiesthe reservationtobe modified.(This qualifierisre-HOquiredwhenyouhavemultiple reservationsofthesame=Omoduleinthedefault developmentstream.)The! res-identSO2 parameteristhe reservation identifierofthe reservationtobeRO modified.'The reservation identifieristhe identifieryouspec-NOifiedwhenyoureservedthemodule,usuallyasmallintegerDO<value.'UsetheSHOW RESERVATIONScommandtodisplay>Othe reservation identifierofeach reservation.M! O/LOG (default)O(/NOLOGMOControlswhetherlogmessagesareprintedaftereachreser-POvationis modified.'The/LOG qualifiercausesthemessagestoJO2beprintedandthe/NOLOG qualifier suppressesthem.)TheJOmessagesindicatethateach reservationhasbeenmodifiedNOandthatthedatabase transactionhas successfully committed.0N#O/NEW_SESSION=session-nameNO( SpecifiesthatVDEshouldaddthemodule reservationtothe.O reservationsessiongivenbythe session-name! parameter.POIfnosessionbythatnameexists,VDEcreatesanewreser-OO2vationsessionbythatnameandaddsthe reservationtoit.TOIfthe reservationalreadybelongstoanexistingsession,itisJOremovedfromthatsessionandaddedtothenewsession.O YO /NOCONCURRENTIO( SpecifiesthatthemodulecannotbereservedbyanotherNOuserwhileyouhaveit reserved.)Youmustreplaceorunre-POservethemodulebeforeotherscanreserveit.)This qualifierLO2changestheconcurrent-reservation attributeofthereserva-Otion.MP# O/PROPAGATE=stream-nameO( /NOPROPAGATEKOThis qualifiercontrolsthedefaultmodule propogationbe-BOhaviourofthe subsequentREPLACEcommand,anditOO2controlsthe reservation ``shadow''forthis particularreser-Ovation.QXGOWhen specified,the /PROPAGATE qualifiercausesVDEtoLO propagatethechanged module(s)tothestream specifiedby O5the5 stream-name 5 parameter,but R5 not!5toany successorsofKOthat stream-change propagationthusstopsatthe specifiedOstream.REOThe /NOPROPAGATE qualifiercausesVDEtodisableallHO propagateofthechangebeyondthecurrentstream(theIO5defaultstreamorthestream specifiedwiththe/STREAMO qualifier).SNGOIfyouomitboth qualifiers,theREPLACEcommandwillHO propagatethechangedmodulestoall successorsoftheO5currentstream.TWIOBecausethese qualifiers determinewhatstreamsasubse-GOquentREPLACEcommandwillaffect,theyalso determineFO5what streams-the``shadow''-thenewmodule reservationsMOcover.)A reservationthatcoversfewerstreamsallowsotherOOuserstoreservethesamemoduleinotherstreamswithless#O> likelihoodof conflict.lUKBO/REMARK="string"JO( Specifiesanewremarkstringtobe associatedwiththeJOmodule reservation.)This qualifierchangestheremarkat-OOtributeandtheprevious reservationremarkislostfromtheEO2 database.'Theremarkisenclosedin quotationmarks.]V! U3O/SESSION=session-nameOO(Sessionsareusedto logicallygroupasetofmodulereser-POvations together, typicallytogroupallmodulesrelatedtoaNO particularsourcecode alterationor enhancement together.'ItQO2allowsall componentmodulesreservedtobetreatedasasin-LOgleentityfor subsequent replacement operations.*AsessionPOalsoallows additionalmodulestobereservedand incorporated:O<intoanexistingsessionatalatertime.WNPOIfthis qualifieris specified,themodules referencedbytheO session-name;sessionarethetarget;donotspecifytheO5mod-name#.5modulename parameters.XZ WqFOSessionscanbe manipulatedviatheREPLACE,RESERVE,combinedintothesamesession.UY! K+O/STREAM=stream-nameMO( Specifiesthat reservationsforthe developmentstreamgivenObythe@ stream-name7 parameterbe modified.'Ifthis qualifierLOisomitted, reservationsforthedefault developmentstreamO2are modified.\Z K2O/USERNAME=usernameMO( Specifiesthat reservationsmadebyanotheruseraretobeO modified.(The\username,  parameteristheOpenVMSuser-EOnameoftheotheruser.+YoumusthavetheUSERNAME.O2 privilegetousethis qualifier.[f OExamples O1. VDE>DMODIFY% RESERVATION%FOO% /REMARK="Fix&QARS%32%and&33"_ %VDE-I-RESMOD,% reservation%for%module&[FACIL]FOO.MAR&modified&in&the%databaseM" %VDE-I-COMMIT,%database% transaction%has% successfully& committedj VDE>%jSHOW% RESERVATION%FOO/FULL, Reservation%1&of&[FACIL]FOO.MARDB Reservation%created&by&user%SMITH%(Jane%Smith)>D Generation&29&(27B2)%reserved%from&stream%V5.4ED Expected% generation& expression%at% replacement%is%27B30D Concurrent& reservations%are%allowed)Db Remark:&Fix%QARS&32&and%33 VDE>E`Thisexamplemodifiesthe reservationremarksofallLsourcemodulesinthedefaultfacilitywiththenameFOO.EInthiscase,onlymodule[FACIL]FOO.MARmatchestheDjmodulename,andits reservationremarkischanged.>TheSHOW RESERVATIONcommandconfirmsthatthe2 reservationnowhasthenewremark. O2. VDE>;MODIFY%RESERVATION/NOCONCURRENT%[FACIL]MOD1.FOR` %VDE-I-RESMOD,% reservation%for%module&[FACIL]MOD1.FOR%modified%in%the%databaseM( %VDE-I-COMMIT,%database% transaction%has% successfully& committedp VDE>*pSHOW%RESERVATION/FULL%MOD1.FOR- Reservation%1&of&[FACIL]MOD1.FORDH Reservation%created&by&user%SMITH%(Jane%Smith):D Generation&3%(3)&reserved&from%stream&MAINBD Expected% generation& expression%at% replacement%is%44D No% concurrent& reservations%are%allowed/Dh Remark:&Add%new%look-up% algorithm VDE><g TheMODIFY RESERVATIONcommand specifiesthatB  concurrent reservationsarenotallowedformoduleF MOD1.FORinfacilityFACIL.Theoutputfromthesub->p sequentSHOW RESERVATIONcommandshowsthatno1  concurrent reservationsareallowed. OA 3.F VDE>TF MODIFY% RESERVATION%MOD1.FOR/IDENT=2/REMARK="Fix& uninitialized%pointer"` %VDE-I-RESMOD,% reservation%for%module&[FACIL]MOD1.FOR%modified%in%the%databaseM %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE>,SHOW% RESERVATION%MOD1.FOR%/FULL-f Reservation%1&of&[FACIL]MOD1.FORD Reservation%created&by&user%SMITH%(Jane%Smith):D> Generation&1%(1)&reserved&from%stream&MAINBD Expected% generation& expression%at% replacement%is%20D Concurrent& reservations%are%allowed)D Remark:&Fix%access% violation- Reservation%2&of&[FACIL]MOD1.FORD6 Reservation%created&by&user%SMITH%(Jane%Smith):D~ Generation&1%(1)&reserved&from%stream&MAINBD Expected% generation& expression%at% replacement%is%20D  Concurrent& reservations%are%allowed.DU Remark:&Fix% uninitialized&pointer VDE>ITThisexamplemodifiesoneoftwo concurrent reservationsIofthesamemodule.'Becausethereare concurrentreser-;vations,theMODIFY RESERVATIONcommandmustC^havethe/IDENTIFICATION qualifiertospecifywhichH reservationtomodify.(Inthiscase,thecommandmodi-Ffiestheremarkfor reservation2of[FACIL]MOD1.FOR.9gTheSHOW RESERVATIONcommandconfirmsthat5 reservation2nowhasthenewremark.O] \^CyOMODIFYSESSION*z{ mQOModifiesthe attributesofoneormore reservationsessionsinPO(theVDE database.'The attributesofasessionyoucanmodify.Oareitsnameandremarkstring.BORequiresRESREP privilegetomodifyyourownses-BOusion.)RequiresPERFREP privilegetomodifyanotherOuser'ssession.w|MOFormat=OsMODIFYSESSIONM session-name[,session-name...]} P{O ParameterOs session-namePOThenameofa reservationsessionwhose attributesaretobePO$ modified.'YoucanmodifymorethanonesessionatatimebyLO|usingwildcard charactersinthesessionname.(ThepercentROsign( % )inasessionnamematchesanysingle characterinOdatabase transactionhas successfully committed. O/NAME=session-nameLO( Specifiesanewnameforthe reservationsession.*ThenewOOsessionnamecanbeupto39 characterslongandmustfol-IOlownormalVDEnamesyntax.*AfterthesessionnamehasPO2beenchanged,youmustrefertothesessionbyitsnewnameMOinall subsequentVDE commands.(TheoldnameislostfromOthe database.! UO/REMARK="string"MO( Specifiesanewremarkstringforthesession.+ThisstringEOreplacestheremarkstringfromtheoriginalRESERVE?OorCREATESESSIONcommandorfromanypreviousAO2MODIFYSESSIONcommand.*Thequotedremarkstring,POwhichcanbeupto132 characterslong,maycontainanyex-MO planatoryremarkaboutthesessionthatyouwantstoredinO<theVDE database.a OExamples O1. VDE>?MODIFY%SESSION&SMITH-2/REMARK="New%remark&string"Y %VDE-I-SESMOD,% information%for%session%SMITH-2&modified&in&the%databaseM" %VDE-I-COMMIT,%database% transaction%has% successfully& committedj VDE>IThisexamplemodifiessessionSMITH-2togiveitanewG1remarkstring.)Thelogmessagesshowthatthesession,has successfullybeen modified.*^]_@OMODIFYSTEP*L "LOModifiesa build-step definitionintheVDE database.*ThisMO(commandletsyouaddorremove individualinputandoutputMOmodulestothebuild-dependency informationofacompileorOlinkstep.'OuRequiresCRESTEP privilege.~ TOFormatDOsMODIFYSTEPM step-mod-name=mod-name[, mod-name...] O ParametersOs step-mod-nameMOThenameofthemodulethatiscompiledorlinkedbytheIO$buildstep.-ThisnameconsistsofamodulenameandaIO|typename separatedbyaperiod(suchas MOD1.PAS)andKO optionallymayincludeafacilitynameenclosedinsquareDO-brackets(suchas[FACNAM]MOD1.PAS).ThemodulenameJOmaynotcontainwildcard characters.,IfnofacilitynameLOis specified,thedefaultfacilityisassumed.-ThismoduleOO7mustalreadyexistinthedatabaseanditmustalreadyhave(Obuild-dependency information.Omod-nameLO(ThenameofamodulethatyouwanttoaddorremoveasQOaninputoroutputforthebuildstep.*ThisnameconsistsofHOamodulenameandatypename(forexample, MOD1.OBJ)NO2andmayincludeafacilitynameenclosedinsquarebracketsHO(forexample,[FACNAM]MOD1.OBJ).Ifnofacilitynameis:O specified,thedefaultfacilityisassumed.J!  IOYoucanaddorremovemanyinputoroutputmodulesbyMO specifyingwildcard charactersinany componentofthemod-LO5ulename.+Thepercentsign( % )inanamematchesanyNOsingle characterinthepositionitoccupiesandtheaster-Oisk( *G*)matcheszeroormore charactersinthepositionitGO> occupies.*ThosemoduleswhosenamesmatchthewildcardGOpatternareaddedtoorremovedfromthebuildstep.ZNOIftheoutputmoduleyouspecifydoesnotalreadyexistinGOthe database,theMODIFYSTEPcommandaddsittotheJO5 database.)Inputmodules,however,mustalreadybedefinedPOinthe database.(Also,youcannotspecifyasourcemoduleas+Oanoutputfromabuildstep.d :O DescriptionKOsTobeabletoperformminimalsystembuilds,VDErecordsSOallinputsandoutputsforeachbuildstep.'This informationisHO$knownas``build dependencyinformation.'') Normally,VDEGO|collectsbuild dependency information automaticallywhenKOyouperformsystembuilds.*Forsomebuildsteps,however,IO-thisisnotpossibleandyoumustusetheCREATESTEPLOcommandtoenterthebuild dependency informationintotheOVDE database. YIOTheMODIFYSTEPcommandisnormallyusedtoeditbuildGOstep definitionscreatedwiththeCREATESTEPcommand.DO5TheMODIFYSTEPcommandallowsyoutochangebuildIO dependency informationintheVDEdatabasebyaddingor! KOBuild dependency informationisalwayscreatedinthede-MOfault developmentstream.*Tomodifyabuildstep definitionMO5foruseinmorethanone developmentstream,youmustuseCOtheMODIFYSTEPcommandforeachstream.+ForeachHOstream,firstentertheSETSTREAMcommandtosettheDO> developmentstream,thenentertheMODIFYSTEPcom-MOmandtomodifythebuild dependency informationintheVDEO database.|! ZRO QualifiersOs/ADD (default)O/REMOVENO$Controlswhetherthemodules specifiedinthe parameterlistNO|areaddedtoorremovedfromthe build-step definition.(TheOO/ADD qualifieraddsthe specifiedmodulestothebuildstep.IO-The/REMOVE qualifierremovesthe specifiedmodulesfromTOthebuildstep.&Tosetthedefaultforthecommandasawhole,JOspecifythe qualifieraftertheMODIFYSTEP keywords.)ToSO7overridethatdefaultforasinglemodule,specifythe qualifierOafterthemod-name6~ parameteryouchoosetoaddtoorre-ROmovefromthebuildstep.)IfyoudonotspecifyoneoftheseAOA qualifiers,modulesareaddedtothebuildstep.d::OOf/ADDand/REMOVE,/ADDisthedefault.}SO/COMPILE (default)O(/COPYO/LINKPO SpecifieswhetherthebuildsteptobemodifiedisacompileMO2step,copystep,orlinkstep.)/COMPILEmodifiesacompileOOstep,/COPYmodifiesacopystep,and/LINKmodifiesalink,Ostepforthe specifiedmodule.r HHOOf /COMPILE,/COPYand/LINK,/COMPILEisthedefault.M! #O/CONFIRM (default)O( /NOCONFIRMIOControlswhetherVDEasksyoutoconfirmthatyouwantJOthe build-step definition modified.(The/CONFIRM qualifierMO2causesVDEtoprintamessageaskingwhetheryouwanttheQObuildstep modified.(IfyouanswerYES(orY),the build-stepOO definitionis modified.*IfyouanswerNO(orN),thebuild-NO<step definitionisnot modified.(The/CONFIRM qualifieralsoPOcausesVDEtoaskyoutoconfirmtheadditionorremovalofROeach individualinputoroutputmoduleforthebuildstep.'TheIOE /NOCONFIRM qualifiercausesVDEtomodifythe build-step9O definitionwithoutaskingfor confirmation.! ^O/INPUT (default)O(/OUTPUT!O Specifieswhetherthedmod-name%D parametersareinputstoLOoroutputsfromthebuildstep.+The/INPUT qualifierdes-KO2ignatesthe specifiedmodulesasinputsinthe build-stepJO definition.*The/OUTPUT qualifier designatesthe specifiedSOmodulesasoutputsinthe build-step definition.'Tosetthede-QO<faultforthecommandasawhole,specifythe qualifierafterHOtheMODIFYSTEP keywords.*TooverridethatdefaultforAOasinglemodule,specifythe qualifierafterthemod-nameFOE parameteryouchoosetomarkasaninputoroutput.h>>OOf/INPUTand/OUTPUT,/INPUTisthedefault.U +O/LOG (default)O(/NOLOGKOControlswhetherlogmessagesareprintedafterthebuildROstep definitionismodifiedinthe database.'The/LOG qualifierJO2causesthemessagestobeprintedandthe/NOLOGquali-LOfier suppressesthem.*ThemessagesindicatethatthebuildOOstephasbeen modified,thatthe specifiedmoduleshavebeenLO<addedtoorremovedfromthestep,andthatthedatabase4O transactionhas committed successfully. f x OExamples O1. VDE>DMODIFY%STEP&MOD4.FOR&=%FOO.FOR/INPUT,%MOD4.ANA/OUTPUT` %VDE-I-COMSTEPMOD,%compile%step&for%module%[CODE]MOD4.FOR%modified%in%databaseW" %VDE-I-MODINSTEP,%module% [CODE]FOO.FOR%is%an%input%to%the%build%step\j %VDE-I-MODOUTSTEP,%module&[CODE]MOD4.ANA&is&an&output%from&the%build%stepM %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE>#SHOW% STEP/FULL&MOD4.FOR4B Compile&Step%for&module%[CODE]MOD4.FOR6D Dependency&links&for%stream%V2.1%follow'D Inputs%to%the&build&step:  Module%[CODE]MOD4.FORb Module% [CODE]FOO.FOR*D Outputs&from%the&build&step:! Module%[CODE]MOD4.$OBJ 9 Module%[CODE]MOD4.LIS  Module%[CODE]MOD4.ANA6D Build%step&has%2&inputs%and%3%outputsY VDE>CThisexamplemodifiesthebuild dependencyinforma-H tionforthebuildstepthatcompilesmodule MOD4.FOR.EyThecommandaddsmoduleFOO.FORasaninputtotheFstepandaddsmoduleMOD4.ANAasanoutputfromthe@*step.*TheSHOWSTEPcommandshowsthatthenewHinputandoutputmoduleshavebeenaddedtothebuild2 dependency informationforthestep. OS 2.^ VDE>U^ MODIFY% STEP/LINK%MOD1.EXE%=%FOO.$OBJ/REMOVE/INPUT,&MOD1.MAP/ADD/OUTPUT] %VDE-I-LNKSTEPMOD,%link%step&for%module%[CODE]MOD1.EXE%modified%in%database_ %VDE-I-MODREMINSTEP,%module%[CODE]FOO.$OBJ%removed%as%an%input%to%build%step\6 %VDE-I-MODOUTSTEP,%module&[CODE]MOD1.MAP&is&an&output%from&the%build%stepM~ %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE>( SHOW%STEP/LINK/FULL%MOD1.EXE1 Link&Step%for&module%[CODE]MOD1.EXE6DV Dependency&links&for%stream%V2.1%follow'D Inputs%to%the&build&step:! Module%[CODE]MOD1.$OBJ!. Module%[CODE]MOD2.$OBJ*Dv Outputs&from%the&build&step:  Module%[CODE]MOD1.EXE  Module%[CODE]MOD1.MAP6DM Build%step&has%2&inputs%and%2%outputs VDE>@LThisMODIFYSTEPcommandmodifiesthebuildde-Kpendency informationforthebuildstepthatlinksmodule< MOD1.EXE.ThecommandremovesFOO.$OBJasanHVinputtothebuildstepandaddsMOD1.MAPasanout-Cputfromthestep.'TheSHOWSTEPcommandconfirmsFthatthechangeshavebeenmadetothestep'sbuild"_ dependency information.%T_,^`BOMODIFYSTREAM*LOModifiesthe attributesofoneormore developmentstreams!O(intheVDE database.4ORequiresCRESTRMorMODSTRM privilege.tJOFormat:OsMODIFYSTREAMM stream-name[,stream-name...] PO ParameterOs stream-nameNOThenameofastreaminthecurrentVDElibrarywhoseat-MO$tributesaretobe modified.*YoucanmodifymorethanoneOO|streamatatimebyusingwildcard charactersinthestreamOOname.'Thepercentsign( % )inastreamnamematchesanyPO-single characterinthepositionitoccupiesandtheasterisk O( w*L)matcheszeroormore charactersinthepositionitoc-LOcupies.)VDEmodifiesthe attributesofthosestreamswhose/O7namesmatchthewildcardpattern.R(MOThestreamnamecanbeupto39 characterslong.)ItmustEOfollowVDEnamesyntax.-UnlikeotherVDEnames,theTO5streamnamecancontainperiods( . ).(TheuseofthefacilityOprefix9 VDE$$is expressly prohibited.| RO QualifiersOs /CMS_CLASSO /NOCMS_CLASSLO$Setsorclearsthe CMS-class attributeofthestream.+TheGO| /CMS_CLASS qualifiercausesVDEtocreateaCMSclassPOwiththesamenameasthestreamineach facility'sCMSli-IO-braryandtothenmaintainthatclasswhentheREPLACEDOcommandandcertainothercommandschangewhatmod-GOule generationsbelongtothestream.)The /NOCMS_CLASSLO7 qualifiercausesVDEtonotmaintainaCMSclassfortheOstream.NFOThe /CMS_CLASS qualifier interactswiththe /INIT_CMS_COCLASSand/NOINIT_CMS_CLASS qualifiers;seethede-:O5 scriptionsofthese qualifiersfordetails.ZJOYoumusthavetheCRESTRM privilegetousethesequali-Ofiers.! ^O/CONFERENCE=file-specO( /NOCONFERENCEIO SpecifieswhetheraNotes conferencefor replacementin-IO formationshouldbe associatedwiththenewstream.+TheIO2 /CONFERENCE qualifier specifiesthatthenotes conferenceOgivenbythe file-spec6 parametershouldbeusedtorecordallKO replacementsintothestream.)VDEthenentersanewnoteKO<intothe conferenceforeachqueuedor immediatereplace-KOmentandareplytothatnotewhenaqueued replacementAOisactually performed.,The /NOCONFERENCE qualifierIOE specifiesthatnosuchnotes conferenceshouldbeused.FOUndernormalcircumstances,justthefilenameshould Obe specifiedinthe file-spec'k parameter.+VDEappliesde-QO5faultstothenotes conferencefile specificationbasedontheEO translationofthelogicalnameVDE$NOTES_LIBRARY.IfPOthislogicalnameisnotdefined,thedefaultfile specifica-=O>tion``NOTES$LIBRARY:.NOTE''isappliedtothe^> file-specO parameter.! O/CONFIRMO( /NOCONFIRM (default)IOControlswhetherVDEasksyoutoconfirmthatyouwantGOeachstream definition modified.*The/CONFIRM qualifierOO2causesVDEtoprintamessageforthe specifiedstreamgiv-NOingthenameofthestreamandaskingwhetheryouwanttoPOmodifythatstream.(IfyouanswerYES(orY),its attributesRO<are modified.'IfyouanswerNO(orN),its attributesarenotHO modified.'The /NOCONFIRM qualifiercausesVDEtomodifyOOthe attributesofthestreamwithoutaskingfor confirmation.x! NO/DELETEO( /NODELETE (default)OSetsorclearsthedelete1 attributeforthestream.*Thisat-JOtributeallowsthestreamtobedeletedwiththeDELETEFO2STREAMcommand.)The/DELETE qualifiersetsthedeleteMO attributesothatthestreamcanbedeleted.'The /NODELETERO qualifierclearsthedelete attributesothatthestreamcannotRO<bedeletedwithoutfirst resettingthe attribute.&Youmusthave>OtheCRESTRM privilegetousethese qualifiers.UO/LOG (default)O(/NOLOGLOControlswhetherlogmessagesareprintedafterthestreamIO definitionsare modified.,The/LOG qualifiercausessuchHO2messagestobeprintedand/NOLOG suppressesthem.*TheHOmessagesindicatethatthestream definitionshavebeenLOmodifiedandthatthedatabase transactionhas successfullyO< committed.u KO/INIT_CMS_CLASSO(/NOINIT_CMS_CLASSIO SpecifieswhetherVDE initializestheCMSclassfortheFOstreamineach facility'sCMSlibrarywhenthe/CMS_NO2CLASS qualifier specifiesthatsuchaclassshouldbemain-JOtained.'/INIT_CMS_CLASSsetsan attributethatcausesthe@OMODIFYSTREAMcommandwiththe /CMS_CLASSquali-OO<fiertocreateandpopulateaCMSclasswiththesamenameIOasthestreamineach facility.'/NOINIT_CMS_CLASSclearsJOthis attributesothatMODIFYSTREAMdoesnotcreateorFOEpopulatesuchCMSclasses.'/NOINIT_CMS_CLASSisusefulOOforverylargeVDE librarieswheretheinitializationofCMSPOclassestakean excessivelylongtime.*Forsuch libraries,itNOOisbettertouseaseparatecommand procedureto initializeLOthedesiredCMSclasses;sucha procedurecanprocesstheOO facilitiesofyourlibraryinparallelforfaster completion.ZJOYoumusthavetheCRESTRM privilegetousethesequali-Ofiers.  O/NAME=stream-nameLO( Specifiesanewnameforthestream.(ThestreamnamecanJObeupto39 characterslongandmustfollownormalVDEKOnamesyntax,exceptthatastreamnamecancontainperi-SO2ods( . ).(Afterthestreamnamehasbeenchanged,youmustNOrefertothestreambyitsnewnameinall subsequentVDECO commands.'Theoldnameislostfromthe database. 7O/NOSUCCESSOR[=(succ-name[,succ-name...])]JO( Specifiesstreamsthatshouldnolongerbe successorstoMOthestreambeing modified.*A successortoastreamisan-MOotherstreamtowhichsourcechangesare propagatedbythe!O2REPLACEcommand.)EachY2 succ-name42 parameterspeci-TOfiesthenameofastreamthatis currentlya successortothe Ostreamgivenbythe6 stream-name#{ parameter,butthatnoOO<longershouldbea successor.(The specifiedstreamsarethusNOremovedfromthelistof successorsstoredinthe database.NOIfthelistof  succ-name0 parametersisomitted,allcurrentJO successorsofthestreambeingmodifiedareremovedfrom*O5thatstream's successorlist.wMMOYoumusthavetheCRESTRM privilegetousethis qualifier.b,O/NOTIFY=(username[,username...])0O(/NONOTIFY[=(username[,username...])]POThe/NOTIFY qualifier specifiesalistofuserstonotifyofMOall replacementsintothe specifiedstream,andofallfa-LO2cilitycreation operations.+VDEappendstheseuserstothe7Ostream'sexisting notificationlist.(Eachusernameparame-LOtergivestheOpenVMSusernameormailaddressofauserMO<whoshouldbenotifiedbymailmessageeachtimeamodule*Oisreplacedintothestream.! aOEach username7 parametercanspecifytheusernameofaFOuseralreadyrecordedintheVDE database,aOpenVMSDO5mailaddresswithoneormorenodenames(suchasMO NODE::SMITH),amail forwardingalias,oradefinedlogicalXOnameboundtoalistofuserstonotify.'IfyouspecifyalogicalLO>name,keepinmindthatthelogicalnamemustbedefinedROwhenitislaterusedtosend notification messages.(ItshouldSOthusbeagrouporsystemlogicalnameoralogicalnamethatTOHisinsomeotherwaydefinedforallusersoftheVDElibrary.! WQOThe /NONOTIFY qualifier specifiesthatalistofusersalreadyQOonthestream's notificationlistberemovedfromthatnotifi-O5cationlist.(Each5username(]5 parametergivestheOpenVMSNOusernameormailaddressofausertoremovefromtheno-/O tificationlist.*Ifyouomitthewusername( parameters,VDEEO>removestheentire notificationlistforthestream. NOOIfyouspecifyboth qualifiers,VDEremovestheusersspeci-NOfiedwiththe /NONOTIFY qualifierfromthe notificationlistOO5beforeaddingtheusers specifiedwiththe/NOTIFY qualifier.%OIfyouspecifyonlyoneusername!G parameterwitheitherDO qualifier,youmayomitthe surrounding parentheses.} SO/OPENO(/FROZENO/CLOSEDLOSetsthestatusofthestreamtoopen,frozen,orperma-OO2nentlyclosed.+Ifyouspecifythe/OPEN qualifier,allusersMOcanreserveandreplacesourcemodulesfromthestreamand:Otherebymodifythecontentsofthestream.JOIfyouspecifythe/FROZEN qualifier,allusersmayre-KOservemodulesfromthestream.'However,ausermusthaveJO5theFROZEN privilegetoreplacemodulesintothestream;GOnon-privilegeduserscannotchangethecontentsoftheLOstream.*Youcanlaterchangethestatustoopenwithan-CO>otherMODIFYSTREAMcommand,sothestreamisnotO permanentlyfrozen.j @NOIfyouspecifythe/CLOSED qualifier,modulescannotbere-NOservedfromorreplacedintothestream.(ThisstatuscannotCO5bechangedwitha subsequentMODIFYSTREAMcommandHOunlessyouhavetheUNCLOSE privilege.'Usethe/CLOSEDOO qualifierwhenyouneverwantthecontentsofthestreamtoKO>changeagain,forexample,when capturinga base-levelofOOyoursoftwaresystemorwhen capturingthefinalstateofa0Oreleasedversionofyour software. KOYoumusthavetheUNCLOSE privilegetousethe/OPENor5O/FROZEN qualifierforaclosedstream.I O/OWNER=usernameO(/NOOWNERKOThe/OWNER qualifier specifiestheownerofthe specifiedOstream.,The.username( parametergivestheOpenVMSNO2usernameofauserwhoshouldberecordedasthe ``owner''NOofthestream.(VDEassignsnospecialmeaningtotheownerHOofastream,buttheSHOWSTREAMcommanddisplaystheMO<owner.)Theownercouldthusbethepersontocontactwith(O questionsaboutthestream.NEOThe/NOOWNER qualifier specifiesthatthestreamhasFOnoowner..Both qualifiersremovethepreviousowner's%O5 ownershipofthestream.UO /POPULATEO( /NOPOPULATEOO Specifieswhetherthestreamisallowedtobe populatedwithBO generationsfromanotherstreamusingthePOPULATEBO2STREAMcommand.) /POPULATEallows subsequentuseofCOthePOPULATESTREAMcommandtopopulatethestreamGOand /NOPOPULATE disallowssuchuse.(Youmusthavethe9O<CRESTRM privilegetousethese qualifiers. m#O/PROCESS_COUNT=proc-countLO( Specifiesthedefaultnumberof processestoexecutebuildKOjobsforthestream.*This parameter determinesthedegreeOOof parallelismforthestream'sbuildjobs.+Seethedescrip-PO2tionoftheBUILDcommandforadetailed descriptionofthisO qualifier.u/O/QUEUE=(queue-name[,queue-name...])RO( SpecifiesthedefaultbatchqueuestowhichbuildjobsfortheHOstreamare submitted.-Seethe descriptionoftheBUILDOOcommandforadetailed descriptionofthis qualifierandforIO2a descriptionofits interactionwiththe/PROCESS_COUNTO qualifier.s IO/REMARK="string"KO( Specifiesaremarkstringforthestream.+Thequotedre-LOmarkstring,whichcanbeupto132 characterslong,mayJOcontainany explanatoryremarkaboutthestreamthatyouLO2wantstoredintheVDE database.( Typicallytheremarkde-OOscribeswhatversionor base-levelofyoursystemthestreamMO represents.)ThisstringreplacestheremarkstringfromtheDO<originalCREATESTREAMcommandorfromanyprevious"OMODIFYSTREAMcommand. ^O/REPLACEMENT=keywordO(Setsorclearsthe(queued-replacementN( attributefortheIOstream.'This attributecontrolswhethertheREPLACEcom-GOmandpermits immediate replacementsintothestreamor2O2requiresqueued replacements.*Ifthe2keyword2 parameterBOis IMMEDIATE,theREPLACEcommandwill immediatelyOOreplacemodulesintothestreambydefault.(Ifthe parameterEO<isQUEUE,theREPLACEcommandwillalwaysqueuere-MO placementsforthestreamsothatmodulesarenotreplacedKOintothestreamuntila privilegeduserentersaPERFORMOE REPLACEMENTcommand..! h.O/REVIEWER=(username[,username...])2O(/NOREVIEWER[=(username[,username...])]KOThe /REVIEWER qualifier specifiesalistof reviewersforLOallmodule replacementsintothe specifiedstream.)VDEap-OO2pendsthese reviewerstothestream'sexistingreviewerlist.OEachusername2 parametergivestheOpenVMSusernameQOofauserwhoshouldreviewall replacementsintothestream.IO<TheusermustalreadyberecordedintheVDE database.OOWhenamoduleisreplacedintothestream,VDEnotifiestheNOuserofthe replacementbymailmessage.'Ifthe replacementMOEisqueued,theusershouldthenreviewthequeuedreplace-POmentbeforeitis performed.'Ifthe replacementis immediate,OOVDEnotifiestheuserofthenewmodule generationthatwasIOOcreated,andtheusermaytheninspectthat generation. WMOThe /NOREVIEWER qualifier specifiesthatalistofexistingMO reviewersforthe specifiedstreamberemovedfromthere-O5viewerlist.(Each5username(v5 parametergivestheOpenVMSIOusernameofauserwhoshouldberemovedfromthere-+Oviewerlist.,Ifyouomitthe9username parameters,VDEAO>removestheentirereviewerlistforthestream.NOIfyouspecifyboth qualifiers,VDEremovestheusersspec-GOifiedwiththe /NOREVIEWER qualifierfromthereviewerKO5listbeforeaddingtheusers specifiedwiththe /REVIEWERO qualifier.%OIfyouspecifyonlyoneusername!G parameterwitheitherDO qualifier,youmayomitthe surrounding parentheses.,#O/STEP_DELAY=time-intervalNO( Specifiesthedefault step-delaytimeintervalusedbybuildNOjobsforthestream.)Seethe descriptionoftheBUILDcom-COmandforadetailed descriptionofthis qualifier.3O/SUCCESSOR=(succ-name[,succ-name...])JO( Specifiesnew successorstothestreambeing modified.-AJO successortoastreamisanotherstreamtowhichsourceDOchangesare propagatedbytheREPLACEcommand.)EachO2 succ-name>*2 parameter specifiesthenameofastreamthat@Obecomesa successortothestreamgivenbythestream-OnameEO parameter.(The specified successorsareaddedtotheNO<listof successorsalreadystoredinthe database.*YoumustBOhavetheCRESTRM privilegetousethis qualifier.  O/TIMEOUT=time-intervalPO( SpecifiesthedefaulttimeoutintervalusedbybuildjobsforNOthestream.&Seethe descriptionoftheBUILDcommandfora5Odetailed descriptionofthis qualifier. A OExamples O1. VDE>AMODIFY%STREAM%V3.3-FT1% /REMARK="New&remark%string"Z %VDE-I-STRMMOD,% information%for&stream%V3.3-FT1%modified%in%the%databaseM" %VDE-I-COMMIT,%database% transaction%has% successfully& committedJInthisexample,theuser specifiesanewremarkstringDforstream V3.3-FT1.+Thisremarkstringcanbere->Btrievedwitha subsequentSHOWSTREAMcommand. O2. VDE>+MODIFY%STREAM/NAME=V5.3&HICKORYV %VDE-I-STRMMOD,% information%for&stream%V5.3&modified&in&the%databaseMO %VDE-I-COMMIT,%database% transaction%has% successfully& committed@Inthisexample,thenameofstreamHICKORYisIchangedtoV5.3.+Youmustrefertothestreambythis8onewnameinall subsequentVDE commands. O3. VDE>IMODIFY%STREAM/CONFIRM%BLVL-7/REMARK="New%remark&string",&-4 _VDE>-4BLVL-9/REMARK="New&remark%string"*| Modify%stream&BLVL-7%?&[No]: |YF %VDE-I-STRMMOD,%stream&BLVL-7%modified%in%the%database*  Modify%stream&BLVL-9%?&[No]:  NMT %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE>E Thisexample illustratesthe/CONFIRM qualifier.)ThisJc qualifiercausesVDEtoasktheuserwhethereachspec-Difiedstreamshouldbe modified.+ForstreamBLVL-7,J theuseranswersY(forYES)andtheremarkstringforLm thatstreamismodifiedinthe database,asthelogmes-C sageshows.+ForstreamBLVL-9,theuseranswersNH (forNO)andthatstreamisnot modified.*HencethereIw isnologmessageforthatstream.,Thefinallogmes-L sage indicatesthatthedatabase transactionforthewhole0( commandhas successfully committed.}a`bHOPERFORM REPLACEMENT*FOPerformsoneormorequeued replacementssothattheIO( correspondingmodulesarereplacedintotheVDElibrary.'ORequiresPERFREP privilege.tJOFormat:OsPERFORM REPLACEMENTNrep-name[, rep-name...]! UO ParameterOsrep-nameMOThenameofaqueued replacementtobe performed.'YoucanNO$performmorethanone replacementatatimebyusingwild-KO|card charactersinthe replacementname.(ThepercentsignRO( % )inanamematchesanysingle characterintheposition-O-itoccupiesandtheasterisk( [9*+-)matcheszeroormorechar-OOactersinthepositionit occupies.'Thosequeued replacementsFOwhosenamesmatchthewildcardpatternare performed.  O Description;OsThePERFORM REPLACEMENTcommandreplacestheLOmodulesthataremembersofa specifiedqueued replacementHO$intotheVDElibrary.,Oncethiscommandhas completed,IO|eachmembermodulehasanew generationinthelibraryPOandisnolongermarkedasreservedintheaffectedstreams.OO-In addition,the replacementisnolongerqueuedintheVDEO database. usewildcard charactersinthestreamnameyouspecifywith"Othe/STREAM qualifier.O! %:OThePERFORM REPLACEMENTcommandisnormallyNOusedbyauserwhois authorizedto determinewhenchangedMO5modulesshouldbereplacedintotheVDElibrary.)Otherde-LOvelopersreservesourcemodules,makechangestothem,andEOqueuethemfor replacementwiththeREPLACEcommand.BO>TheREPLACEcommandqueuesmodulesfor replacementPO(asopposedto replacingthem immediately),iftheuserspec-KOifiesthe/QUEUE qualifierorifanyaffected developmentHOHstreamhasthequeued-replacement attribute.+Onceare-OO placementisqueued,itcan optionallybereviewedusingthe>OREVIEW REPLACEMENTcommandandits subcommands.MORWhenthe authorizeduserdecidesthatthemodulesthatareHOmembersofthequeued replacementarereadytobere-KOplacedintotheVDElibrary,theuserentersthePERFORMDO[ REPLACEMENTcommandtoactuallyperformthereplace-GOment.)When replacementsarequeued,itisthePERFORMBO  REPLACEMENTcommandthatactuallycreatesnewgen-IOeerationsforthemodulesandthat terminatesthemoduleO reservations. IOWhetheryoushouldusequeued replacementsornotisaNOpolicydecisionthatmaybe differentfor differentVDEli-LO5brariesorfor different developmentstreamwithinagivenNOlibrary.(Ifyoudecidetoalwaysuse immediate replacements,EOtheREPLACEcommandwillperformtheactualreplace-AO>mentandyoudonotusethePERFORM REPLACEMENTOcommand. `O QualifiersOs/CONFIRMO /NOCONFIRM (default)IO$ControlswhetherVDEasksyoutoconfirmthatyouwantAO|each replacement performed.-The/CONFIRM qualifierJOcausesVDEtoprintamessageforeach replacementask-IO-ingwhetheryouwantthat replacement performed.*IfyouKOanswerYES(orY),that replacementis performed.*IfyouNOanswerNO(orN),the replacementisnot performed.'IfyouMO7entera replacementnamewithawildcardspecification,VDELOasksyoutoconfirmthatVDEshouldperformeachreplace-HOmentwhosenamematchesthewildcardspecification.*TheIOA /NOCONFIRM qualifiercausesVDEtoperformthe specified;O replacementswithoutaskingfor confirmation.( O/LOG (default)O(/NOLOGJOControlswhetherlogmessagesareprintedaftereachre-HO placementhasbeen performed.*The/LOG qualifiercausesLO2suchmessagestobeprintedandthe/NOLOG qualifiersup-JOpressesthem.+Thesemessagesindicatethatthe associatedKOmoduleshavebeen replaced,thatthe replacementhasbeenNO< performed,andthatthedatabase transactionhas successfullyO committed.U ^+O/STREAM=stream-nameOO( Specifiesthatonlythose replacementsthatbelongtocertain&Ostreamsbe performed.(The: stream-name parameterspec-JOifiesastreamnameandcancontainwildcard characters.OO2Thepercentsign( % )inanamematchesanysinglechar-GOacterinthepositionitoccupiesandtheasterisk( 9*k)matchesKOzeroormore charactersinthepositionit occupies.,VDEOO<performsagiven replacementonlyifitbelongstoastream#Owhosenamematchesthe stream-name> parameter.(IfyouJOomitthis qualifier,VDEperformsonlythose replacements2OEthatbelongtoyourdefaultstream.N $2OForeach replacementthatmatchesarep-namef parameter>Obutdoesnotbelongtoastreammatchingthe stream-nameKO5 parameter,VDEprintsan informationalmessagesayingthat/Othe replacementisnot performed.x NOExamples O1. VDE>'PERFORM% REPLACEMENT%SMITH-2X %VDE-I-REPLACED,& generation%[FACNAM]A.REQ;9(9)&replaced&into%stream&V2.0X" %VDE-I-REPLACED,& generation%[FACNAM]B.REQ;6(6)&replaced&into%stream&V2.0:j %VDE-I-REPPERF,% replacement%SMITH-2% performedM %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE>ChThisexampleperformsthequeued replacementSMITH-:2.'ThePERFORM REPLACEMENTcommandreplacesBthetwomodulesthataremembersofthereplace-?rment,A.REQandB.REQinfacilityFACNAM,intoGtheVDElibrary.* Thereafter,thesetwomodulesarenoE#longer reserved.(Thecommandalsodeletes replacement,|SMITH-2fromtheVDE database.#bacDOPOPULATESTREAM*DO Populatesa developmentstreamwith generationsfromO(anotherstream.'ORequiresPERFREP privilege.vLOFormatOsThePOPULATESTREAMcommand populatesaspeci-MOfied developmentstream(thetargetstream)withthelatestIO$ generationsfromanotherstream(thesourcestream).)TheIO|targetstreamis specifiedwithacommand parameterandEOthesourcestreamis specifiedwiththe /FROM_STREAMPO- qualifier.)Thelatest generationofeachmoduleinthesourceQOstreamisinsertedintothetargetstreamandanymodulesnotMO representedinthesourcestreamareremovedfromthetar-LO7getstream.'Afterthecommand completes,thetargetstreamMOcontainsexactlythesame generationsasthesourcestream. aAOUsingtheCREATESTREAMcommandtocreateanewNOstreamwiththesamecontentsasaparentstreamcanbeaMO5time-consuming operationiftheVDElibraryislarge.(UsingBOthePOPULATESTREAMcommandtoupdateanexistingPOstreamwhosecontentsarealreadyclosetothedesiredsourceOO>streamis generallyamuchfasterwaytomakeacopyofaJOstream.)Thiscommandallowsyoutocreatenew base-levelOOstreamsbyreusingold base-levelstreamsthatarenolongerBOHneeded,thussavingbothtimeanddatabasespace.s! kIAOThePOPULATESTREAMcommandupdatesonlytheVDEPO database.)Itdoesnotinserttheupdated generationsintotheQO5CMSclassforthestream,notevenifthe attributetomain-ROtaintheCMSclassissetforthetargetstream.(NeitherdoesKOthecommandupdatethesource directoriesforthestream.IO>Ifsuch operationsareneeded,theymustbedonemanu-LOallyoutsideofVDE. AlternativelyyoucanusetheINSERTGO GENERATIONcommandtoinsert generationsintoastreamIOHwhile maintainingCMSclassesandstreamsourcedirecto-HOries.'Becauseitdoesmorework,theINSERT GENERATIONCOcommandis generallymuchslowerthanthePOPULATEORSTREAMcommand.! JOVDE populatesthetargetstreamsinthreephases.,First,JOit determineswhatstreamstopopulateusinga read-onlyKO5database transaction.*Second,it determinesthe differencesOObetweenthesourceandtargetstreamsforonetargetstream.NOThisstepisdoneusinga read-only transaction.(Third,VDEOO>loopsoverthe differencesitfoundtoupdatethe generationMO membershipofthetargetstream.(Thisphasegivesthetar-IOgetstreamthesame generation membershipasthesourceFOHstreamhadduringthe preceding read-only transaction.KODuringthisphase,VDEupdates20modulesatatime(byKO default),commitsthe transaction,andrepeatstheprocessOORuntilallmodulesareupdated.'VDEusesmultipleshortread-OOwrite transactionsinordernottolockthedatabaseagainstSOotherusersmorethanafewsecondsatatime.'Afterthetar-QO[getstreamisfully populated,VDEloopstopopulatethenext&Ostreamuntilnoneremain.' =OYoucanonlypopulateanopenstreamifthepopulate .at-VOtributeissetforthestream.*Ifthis attributeisnotset,youCO5mustsetitwiththeMODIFYSTREAM /POPULATEcom-HOmandbeforeyoucanpopulatethestream.,Youcanonly.OpopulateafrozenstreamifthepopulateQ attributeissetKO>andyouhavetheFROZEN privilege.(YoucannotpopulateaOclosedstream.FO QualifiersOs/COMMIT_LIMIT=numberFO SpecifiesthemaximumnumberofmodulesVDEwillup-QO$datein,insertinto,orremovefromthetargetstreambeforeGO| committingthedatabase transactionandstartinganewO transaction.,Thenumber*# parametermustbeaninteger8O-valueintherangefrom1to 1,000,000.! NO SpecificationofasmallervaluereducestheintervalduringPOwhichthedatabaseislocked,allowingaccesstothedatabaseSO5byotherusers.' SpecificationofalargervaluedoesreducetheMOoverheadinvolvedwith recyclinglocksandrepeatedcommits,KObut restrictstheaccesstothedatabasebyotherusers. tLOBydefault,VDEcommitsandrestartsa read-writetransac-(Otionforevery20modules.o! EO/CONFIRMO( /NOCONFIRM (default)IOControlswhetherVDEasksyoutoconfirmthatyouwantDOeachtargetstream populated.,The/CONFIRM qualifierGO2causesVDEtoprintamessageforeachstreamaskingGOwhetheryouwantthatstream populated.,IfyouanswerPOYES(orY),thatstreamis populatedfromthesourcestream.IO<IfyouanswerNO(orN),thestreamisnot populated.HOIfyouenterastreamnamewithawildcard specifica-NOtion,VDEasksyoutoconfirmthepopulateactionforeachJOEstreamwhosenamematchesthewildcardspecification.(TheJO /NOCONFIRM qualifiercausesVDEtopopulatethe specified6Ostreamswithoutaskingfor confirmation. "O/FROM_STREAM=stream-nameNO( SpecifiesthesourcestreamfromwhichthetargetstreamisIOtobe populated.)VDEmakesthe generation membershipofSOthetargetstream identicaltothatofthissourcestream.'ThisSO2 qualifieris required;ifyouomitit,VDEpromptsyouforthe(Onameofthesourcestream._ 5O/LOG (default)O(/NOLOGMOControlswhetherlogmessagesareprintedaftereachstreamIOhasbeen populated.+The/LOG qualifiercausessuchmes-IO2sagestobeprintedandthe/NOLOG qualifier suppressesHOthem.+ThesemessagesindicatethenumberofmodulestoPOupdate,insert,orremovetopopulatethetargetstream,thatLO<thestreamhasbeen populatedfromthesourcestream,andIOthatthedatabase transactionhas successfully committed.S M)OExamples O1. VDE>4POPULATE&STREAM%BLD_12/FROM_STREAM=BIRCH\ %VDE-I-STRMPOPCOUNT,%populate%module%counts:%update%5,%insert&2,&remove%1I" %VDE-I-STRMPOP,%stream&BLD_12% populated%from%stream%BIRCHMj %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE>A!Inthisexample,streamBLD_12is populatedfromEystreamBIRCH.Fivemodule generationsinstreamBLD_K12areupdated,twoare inserted,andoneisremovedtoF*makethe generation membershipofthatstreamidenti-IcaltostreamBIRCH.ThelogmessagesconfirmthattheGstreamwas populatedandthatthedatabase transaction"4 successfully completed.$cbdGOREJECT REPLACEMENT*5COMarksaqueued replacementasrejectedintheVDEKO( database.+Youcanonlymarka replacementasrejectedif8Oyouareareviewerforthat replacement.&ORequiresRESREP privilege. UOFormatEOsREJECT REPLACEMENTNrep-name[, rep-name...]' ["remark"]! PrO ParameterOsrep-nameNOThenameofaqueued replacementtobemarkedas rejected.PO$Youcanrejectmorethanone replacementatatimebyusingIO|wildcard charactersinthe replacementname.)ThepercentSOsign( % )inanamematchesanysingle characterinthepo-5O-sitionitoccupiesandtheasterisk( 29*$d-)matcheszeroormoreOO charactersinthepositionit occupies.(Thosequeuedreplace-IOmentswhosenamesmatchthewildcardpatternaremarkedO7as rejected. UO"remark"KO( Specifiesaone-lineremarkforthe replacement.* TypicallyGOthisremark summarizeswhyyourejectthe replacement.O Specifyingthe_remark3 parameteris equivalentto specifyingBO2the/REMARK qualifieraftertheREJECT REPLACEMENTJO keywords.)This parameterorthe/REMARK qualifierisre-POquired;ifyoudonotspecifyeither,VDEpromptsyouforaO<remarkstring. FO Description>OsTheREJECT REPLACEMENTcommandupdatestheVDEMOdatabasetorecordthatyouhavereviewedthecodechangesMO$ina specifiedqueued replacementandthatyoujudgethoseNO|changesnot acceptablefor replacementintotheVDElibrary.NOYoumustbeareviewerfora replacementinordertomarkO-itas rejected.! the/INPUT qualifier,VDEasksyouwhetheryouwanttoOOeditacommentfileforthe replacement.'IfyourespondYESLO(thedefaultanswer),VDEinvokesyour preferrededitortoOOHcreatethecommentfile.(Ifyouspecifyboththe/INPUTandROthe/EDIT qualifier,VDEcopiestheinputfiletothereplace-NOment'sstagingareaandtheninvokesyoureditortofurtherPORmodifythatfile.)IfyouhavealreadycreatedacommentfileFOforthe replacementwithanearlierACCEPTorREJECTLOcommand,VDEletsyoueditthatfileagain.+Thiscapabil-OO[ityisusefulifyouchangeyourmindorwanttoaddmoreO information.LOIfyouwishtomarka replacementas acceptable,usethe?OACCEPT REPLACEMENTcommand.+IfyouwishtoseeJO5thereviewstatusofaqueued replacement,usetheSHOWO REPLACEMENTcommand.! qO QualifiersOs/CONFIRMO /NOCONFIRM (default)IO$ControlswhetherVDEasksyoutoconfirmthatyouwantHO|each replacement rejected.(The/CONFIRM qualifiercausesMOVDEtoprintamessageforeach replacementaskingwhetherNO-youwanttorejectthat replacement.)IfyouanswerYES(orLOY),that replacementismarkedas rejected.*IfyouanswerLONO(orN),the replacementstatusisnotchanged.+IfyouHO7entera replacementnamewithawildcardspecification,IOVDEasksyoutoconfirmthe rejectionofeachreplace-HOmentwhosenamematchesthewildcardspecification.*TheFOA /NOCONFIRM qualifiercausesVDEtomarkthe specifiedIO replacementsasrejectedwithoutaskingfor confirmation.L! "O/EDITKO( SpecifiesthatVDEshouldinvokeyour preferrededitorsoKOthatyoucanedityourcommentfileforeachqueuedre-NO placement.*Ifsuchacommentfilealreadyexists(duetoaDREJECT% REPLACEMENT%BROWN-3&"Bug%found%in%sort%code"U %VDE-I-REPREJECT,% replacement%BROWN-3&marked%as%rejected%in%databaseM" %VDE-I-COMMIT,%database% transaction%has% successfully& committedYj Do%you%wish%to%edit&a%comment%file&for% replacement%BROWN-3&?%[Yes]: jYES+D ...Comment&file%edited&here... VDE>AThiscommandmarksthatthecurrentuserrejectsAQqueued replacementBROWN-3.(Theremarkstringin-Hdicatesthereasonforthe rejection.+Sincethe/INPUTM qualifierisomitted,VDEaskstheuserwhetherheorsheJ[wantstoeditacommentfile.'TheuseranswersYESand/isplacedinaneditingsession. O+2.1 VDE>=1REJECT% REPLACEMENT%SMITH-1/INPUT=COMMENT_FILE.TXTKy Please%supply&required& information&for% replacement%SMITH-1:0 Enter%a&remark%for%the& rejection:;Code%does&not%conform&to&coding% conventionsU  %VDE-I-REPREJECT,% replacement%SMITH-1&marked%as%rejected%in%databaseMP %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE>CInthisexample,theusermarks replacementSMITH-G`1asrejectedandprovidesacommentfilethatgivesG additional informationtotheuserwhoqueuedthere-F  placement.)Thecommentfilemayexplain,forexample,Li whatdefectsinthecodecausedittobe rejected.*SinceE the/REMARK qualifierisomitted,VDEpromptsfora remarkstring.fQ OTable3-2:8Reasons O OChangeOCodeFDefectCount. CollectionReasonFor Replacement O  OEBF EYes+EThe replacementisaBugFix ONF No'NewFeatureor Enhancement O8PI 8No"8 Performance Improvement OCS NoCommonSources O,CU ,YesC,CodeCleanup, Retrofit,orafixfora Regression ONH No NewHardwareSupport O FE  No!  Functional Equivalence OOT NoOther O dceF OREMOVE GENERATION* 5EORemovesamodulefroma specified developmentstreamPO(sothatthemodulenolongerhasalatest generationintheOstream.'ORequiresPERFREP privilege.rHOFormat8OsREMOVE GENERATIONMmod-name[, mod-name...] O ParameterOsmod-nameQOThenameofasourcemodulewhoselatest generationistobeJO$removedfromthe specified developmentstream.'ThemodulePO|nameconsistsofanoptionalfacilitynameenclosedinsquareJO brackets,amodulename,andanoptionaltypenamepre-MO-cededbyaperiod,suchas[FACIL]MOD1.MAR.IfnofacilityROnameis specified,thedefaultfacilityisassumed.*IfnotypeOOnameis specified,thelatest generationsofallsourcemod-OO7ulesofthe specifiedmodulenameinthegivenfacilityareOremoved.? JOYoucanremovemorethanonemodulefromthestreambyNOusingwildcard charactersinanyofthethree componentsofOO5themodulename.'Thepercentsign( % )inanamematchesPOanysingle characterinthepositionitoccupiesandtheas-Oterisk( \*G)matcheszeroormore charactersinthepositionitEO> occupies.*VDEremoveseachmodulewhosenamematches4Othewildcardpatternfromthestream. O Description>OsTheREMOVE GENERATIONcommandremovesaspeci-NOfiedmodulefroma specified developmentstreamsothatthePO$modulenolongerhasalatest generationinthatstream.'TheRO|resultisthatthemodulenolonger ``belongs''tothatstreamTOandcannolongerbefetched, reserved,orbuiltinthestream.WCOTheremoved generationremainsintheVDEdatabasePOandtheVDElibrary,anditcanstillbethelatestgenera-GO5tionofthemoduleforsomeotherstream.+TheREMOVEBO GENERATIONcommandthusbreaksthe associationbe-JOtweenthemodule generationandthe specifiedstreambut-O>doesnotdeletethe generation.! QOIfthe specifiedmoduleis currentlyreservedinthe specifiedROstream,VDE terminatesthat reservationsinceitisbasedonaPO5module generationthatnolongeristhelatest generationforPOthestream.'VDEsendsamailmessagetonotifytheownerof=Othe reservationthatthe reservationislost.! O QualifiersOs/CONFIRMO /NOCONFIRM (default)IO$ControlswhetherVDEasksyoutoconfirmthatyouwantFO|each generationremoved.)The/CONFIRM qualifiercausesLOVDEtoprintamessageforthelatest generationofeachEO-modulegivingthenameofthe generationandaskingKOwhetheryouwanttoremovethe generation.)IfyouanswerPOYES(orY),the generationisremoved.(IfyouanswerNO(orIO7N),the generationisnotremoved.'The /NOCONFIRMqual-KOifiercausesVDEtoremoveeach generationwithoutaskingOfor confirmation. UO/LOG (default)O(/NOLOGLOControlswhetherlogmessagesareprintedafter generationsJOareremovedfromstreams.)The/LOG qualifiercausessuchHO2messagestobeprintedand/NOLOG suppressesthem.*TheIOmessagesindicatethatthe generationshavebeenremovedMOfromthe specified developmentstreamandthatthedatabase4O< transactionhas successfully committed. O/REMARK="string"NO( SpecifiesaremarkstringthatexplainswhyyouremovedtheHO generationfromthe specifiedstream.+Thequotedremark9Ostringcanbeupto132 characterslong.9 O/STREAM=stream-nameLO( Specifiesthatthe generationberemovedfromthedevelop-&Omentstreamgivenbythe stream-nameM parameter.(IfthisMO qualifierisomitted,VDEpromptsyouforthestreamname. OExamples O1. VDE><REMOVE% GENERATION&[FACIL]MODNAM.C% /STREAM=MANGOX %VDE-I-GENREM,% generation&[FACIL]MODNAM.C;4(4)&removed%from%stream%MANGOMC %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE>EThisexampleremovesthelatest generationofmodule9R[FACIL]MODNAM.CfromstreamMANGO.ThelogKmessageshowsthat generation4hadbeenthelatestgen-Merationofthemoduleinthatstream,andisnowremoved.G\Afterthecommandhas completed,no generationofthe-modulebelongstostreamMANGO.}eOdg;OREPLACE*/! 5MOReturnseach specifiedmoduletothelibraryandcreatesaNO(new generationofthemodule.'EachmodulemustbeasourceDOmodule previouslyreservedwiththeRESERVEcommand.&ORequiresRESREP privilege.sIOFormat9OsREPLACEMmod-name[, mod-name...]' ["remark"]! PpO ParameterOsmod-nameMO SpecifiesareservedsourcemoduletobereplacedintotheIO$library..Themodulenameconsistsofanoptionalfacil-FO|itynameenclosedinsquare brackets,amodulename,KOandanoptionaltypenameprecededbyaperiod(suchasGO-[FACIL]MOD1.MAR).Ifthefacilitynameisomitted,theUOmoduleisassumedtobelongtothedefault facility.'IfthetypePOnameisomitted,allsourcemoduleswiththe specifiedmodule8O7nameinthegivenfacilityare replaced."IOYoucanreplacemorethanonemodulebyusingwildcardJO charactersinanyofthethree componentsofthemoduleMO5name.*Thepercentsign( % )inanamematchesanysin-POgle characterinthepositionitoccupiesandtheasterisk( c* )OOmatcheszeroormore charactersinthepositionit occupies.GO>VDEreplacesthesourcemoduleswhosenamesmatchtheOwildcardpattern.u ! KOOYoucanalsoreplacemultiplemodulesby specifyingthenameMOofasourcegroupinsteadofamodulename.(SourcegroupsCO5arecreatedwiththeCREATEGROUPcommand.+IfyouNOspecifyagroupname,eachmodulethatisamemberoftheOgroupis replaced.8! QOIfyouusethe/SESSION qualifier,those reservationsthatareOOmembersofthe specified reservationsessionare replaced.(In+O5thiscase,youmustomitthe]5mod-name=5 parametersfromOthecommand."iO"remark"KO( Specifiesaremarkstringforthe replacement.+VDEstoresIOthisremarkstringwitheachmodule generationthatthe5OREPLACEcommandcreates.* Specifyingtheremark pa-JO2rameteris equivalentto specifyingthe/REMARK qualifier'OaftertheREPLACEkeyword.#! ZyO DescriptionFOsForeachmoduleyouhave specified,theREPLACEcom-NOmandcreatesanew generationofthemoduleby transferringRO$afilefromyourdefault directorytothecurrentVDElibrary,LO|possiblybywayofan intermediatestagingarea.*ThisnewMO generationbecomesthemostrecent generationofthesourceIO-moduleinthedefault developmentstream(orthestreamJO specifiedwiththe/STREAM qualifier)andreceivesanewGO generationnumber.)Thenew generationnumberisformedOO7byadding1tothenumberoftheprevious generation.)AfterEOcreatingthenewmodule generation,theREPLACEcom-KOmand terminatesthe reservationofthatmoduleunlessyou,OAspecifythe/RESERVE qualifier.v$ LLOAfterthereservedmoduleisreplacedintheVDElibrary,OOVDEmaydeletethefileusedtocreatethemodule(aswellTO5asanyearlierversionsofthefileinthesame directory).'TheSOfileisonlydeletedifthelibrary administratorhasdefinedaKONOKEEPscriptforyourVDElibraryandthe specifiedde-KO> velopmentstream.+Ifyouspecifyeitherthe/KEEPortheNO/RESERVE qualifier,VDEdoesnotdeletethefileevenifa&ONOKEEPscriptisdefined.%WKOThefileinyourdefault directorynormallyhasthesameNOnameasthemoduleinthelibrary.(However,youcandirectSO5VDEtoreplaceafilewitha differentnameorafileinan-OOother directorythanyourdefault directoryby specifyingtheO/INPUT qualifier.&gPOVDEstoresthe following informationaboutthefilethatcre-KOatesthenew generation:,thecreationdateandtime,theNO5revisiondateandtime,therecordformat,andotherrecordJO attributes.-Whenyoufetchorreservea generationofaOOmodulefromaVDElibrary,thefilethatisplacedinyourLO> directoryhasthesamecreationandrevisiontimes,recordNOformat,andrecord attributesasthefilethatwasusedtoKOcreatethe generationthatyouarefetchingor reserving. '! MOIfyouspecifythe/QUEUE qualifieroroneofthestreamsIOthatyouare replacingthemoduleintohasthequeued-IO5 replacement attribute,thentheREPLACEcommanddoesnotIOactuallyperformthe replacementofyourmodule.*InsteadROitcopiesyourfilestoa ``stagingarea''ondiskandqueuesIO>the replacementintheVDE database.+An authorizeduser@Omustthenentera subsequentPERFORM REPLACEMENTJOcommandinordertoactuallyperformthe replacement.)InAOHthiscase,itisthePERFORM REPLACEMENTcommandJOthecreatesthenewmodule generationand terminatestheOmodule reservation.h( >NOIfyouhavemorethanone concurrent reservationofamod-MOule,youmustspecifytheexact reservationtobereplacedAO5usingthe/IDENTIFICATION qualifier.-UsetheSHOWFO RESERVATIONcommandto determinetheidentificationofOeach reservation.)! WOOIfyouoranotheruserhasa concurrent reservationfortheLOmodulebeingreplacedandthat reservationcoversatleastKO5onestreamaffectedbyyour replacement,thentheREPLACEFOcommand terminatesthat reservation.+VDEsendsamailKOmessagetonotifytheownerofthat reservationthatthe O> reservationislost.* NJOToreplaceanotheruser's reservation,youmusthavetheFOUSERNAME privilegeandusethe /USERNAME qualifierto5O5specifyOpenVMSusernameofthatuser.+! 7OSourceTrackingand Statistics CollectionNO4VDEcancollect replacement statisticsand associatedchange-OOrelated information, includingthereasonforthechange,theTOprojectthechangeis associatedwith,andcanalsobeaskedtoLO>addanentrytothesourcecodetracking(SCT)DECNotes.O conference describingthechange.R,(SO Statistics collectionisenabledordisabledonalibrarybasis.OOIf collectionisenabledandthe informationisnotprovidedKO5viaREPLACE qualifiers,VDEwillprompttheuserforthe;O informationduringthe replacement operation.-JOForfurther information,seethe/FOLD,/OTHER,and/SCT>O qualifiers,aswellasthe/PROJECT qualifier..! 1OChange PropagationtootherStreamsHO4 Replacingamodulemakesthenewmodule generationtheLOlatest generationinthedefault developmentstreamortheJOstream specifiedwiththe/STREAM qualifier.)Thatgenera-SO>tionisthusthe generationyougetbydefaultina subsequentJOFETCHorRESERVEcommand,andisthe generationthatisEOcompiledwhenyoubuildyoursysteminthatstream.S/ )JOIfthe specifiedstreamhas successors,theREPLACEcom-LOmand propagatesthenewmodule generationtoall successorOO5streams.(Forexample,ifstreamV2isa successorofstreamPOV1,thenanymodulethatisreplacedintostreamV1isalsoLOreplacedinstreamV2automatically.*IfstreamV2hasad-IO>ditional successors(suchasstreamV3),thenewmoduleNO generationis propagatedtothosestreams,andsoonrecur-Osively.0! thQO Propagationworksasfollows.(Ifthelatest generationsoftheNOmodulefortheoriginalstreamandthe successorstreamareJO5thesame,thenthenewmodule generationcreatedbytheGOREPLACEcommandbecomesthelatest generationforbothLOstreams.(Bothstreamsarethusequally up-to-datewithre-MO>specttothechangesmadetothatmodule.*However,iftheOOlatest generationsofthemoduledifferforthetwostreams,MOwhichmeansthatthemodulehasdivergedbetweenthosetwoKOHstreams,VDEdoesnot propagatethenewmodule generationUOtothe successorstream.'Instead,itcreatesa``fold''recordinLOthedatabasetoremindthe developerthatthechangemadeRORtothemoduleforthefirststreammustbemanually ``folded''OOintothe successorstream.( Outstandingfoldscanbe displayedKOwiththeSHOWFOLDcommandandafoldrecordisdeleted+O[withtheCANCELFOLDcommand.k1 `AEO ReplacingaModulewithHistoryorNotes InformationLO4Ifyoureservea generationofamodulewithanembeddedJOhistoryandthenreplaceit,theREPLACEcommandignoresROthehistory;thatis,VDEdoesnotcopythehistoryintoyourWO>VDElibrary.'IfyouaddtexttothefileinorabovethehistorySO (relativeto#B),orinorbelowthehistory (relativeto#H),EOtheREPLACEcommandissuesanerrormessageandthe%OGcommandisnot executed.~2 TSOIfyoureserveafilewithembeddednotesandthenreplaceit,JOtheREPLACEcommanddoesnotcopythenotestotheVDESO5library.,If,whileeditingthefile,youinserttextthatlooksQOlikeanembeddednote,thattextisdeletedwhenthefileisO replaced.3eO QualifiersOs/CONFIRMO /NOCONFIRM (default)IO$ControlswhetherVDEasksyoutoconfirmthatyouwantCO|eachmodule replaced.-The/CONFIRM qualifiercausesJOVDEtoprintamessageforeach specifiedmoduleaskingPO-whetheryouwanttoreplacethatmoduleintothelibrary.(IfQOyouanswerYES(orY),itis replaced.(IfyouanswerNO(orION),itisnot replaced.*The /NOCONFIRM qualifiercausesIO7VDEtoreplaceeach specifiedmodulewithoutaskingforO confirmation.4 (O/DEFECTS_CORRECTED=error-countO(/NODEFECTS_CORRECTEDPO Specifiesthenumberofdefects correctedbythis replacement:MOthesedefectscouldduetoproblemswiththespecification,@O2design,logic,implementationand/ortesting.-TheG2error-OcountGO parameterisavalue indicatingthenumberofdefectsO corrected.5\>O/NODEFECTS_CORRECTEDsetsthenumberofdefectsO correctedtozero.P6! &SOThis qualifierispartofthe statistics collection componentofQOVDE. Statistics collectionisenabledordisabledonalibraryBO5basis,usingtheMODIFYLIBRARY/STATISTICScommand.TOIf statistics collectionis disabled,these qualifiersareignored=Oandhavenoadverseeffects.'Thiscommandis required*whenJO>certainkeywordsare specifiedonthe/REASONS qualifier; OseeTable3-2$Mforfurther information.*6Za?Q7NQOIf statistics collectionisenabledonthecurrentlibraryandIOyoudonotspecifythe/REASONS qualifier,youwillbe*O5promptedforthe information.78 ^ O/FOLD[=fold-ident]OO( Specifiesthatafoldrecordbe cancelledwhenthisreplace-#Omentis performed.+The fold-ident parametergivestheROfold identifierofafoldrecordforthemodulebeingreplacedKO2andforthestreaminwhichthe replacementtakesplace.NOWhenVDEperformsthe replacement,itwillcancelthisfold@OrecordfromtheVDE database.'YoucanomittheK fold-identPO< parameterifthereisonlyonefoldrecordforthe specifiedKOmoduleandstream.+Youshouldusethe/FOLD qualifierifNOthecurrent replacementisdonetosatisfyanexistingfold$OErecordinthe database.Q9''OAlsosee/OTHERand/SCT.: #O/IDENTIFICATION=res-identRO( Specifiesthe reservationtobe replaced.(This qualifierisre-HOquiredwhenyouhavemultiple reservationsofthesame0Omoduleinthedefaultstream.)TheE res-ident parameterisOO2the reservation identifierofthe reservationtobe replaced.OOThe reservation identifieristhe identifieryou specifiedorMOVDEassignedwhenyoureservedthemodule,usuallyasmallCO<integervalue.(UsetheSHOW RESERVATIONcommandtoIO determinethe reservation identifierofeach reservation.l; B"O/INFORMATION[=file-spec]O(/NOINFORMATIONHOThe /INFORMATION qualifier specifiesthatan informationROfilebeattachedtothecurrent replacementifitisaqueuedO2 replacement.(The2 file-spec(g2 parametergivestheOpenVMSSOfile specificationofthe informationfile.)Ifthis parameterisLOomitted,VDEasksyouwhetheryouwanttoeditaninfor-MO<mationfile.(IfyouanswerYES,VDEinvokesyour preferredOOeditortoeditthe informationfile.*Youmayusetheinfor-JOmationfiletopass informationaboutthe replacementtoAOE reviewersandothers.+The/NOINFORMATION qualifierRO specifiesthatyoudonotwanttoprovidean informationfile.<! MOIfyouomitboth qualifiers,VDE'sbehaviordependsontheFOlibrary attributethatissetwiththe/ASK_INFO_FILEFO5orclearedwiththe/NOASK_INFO_FILE qualifiertotheDOCREATEorMODIFYLIBRARYcommand.'Ifthis attributeQOisset,VDEasksyouwhetheryouwanttoeditan informationRO>file.)Ifthis attributeisnotset,VDEqueuesthe replacement)Owithoutan informationfile.=! LOFor immediate replacements,VDEignoresboth qualifiersand3Odoesnotcreatean informationfile.0> QOToeditan informationfilethroughVDE,youshouldfirstde-JOclareyour preferrededitorwiththeSETEDITORcommand.KO5Ifyoudonotdeclareaneditor,VDEinvokesthesystem Odefaulttexteditor.?! O/INPUT=file-specTO( Specifiesafiletobeusedasinputforthe replacementopera-UOtion.'Ifyouomitthe directory specificationfromthis qualifier,SOthefileistakenfromyourdefault directory.(IfyouomitthePO2filenameorfile extension,themodulenameandmoduletypeIO specifiedinthecommand parameterareusedbydefault.@! ^O/KEEPO(/NOKEEP (default)NOIfthe administratorforyourVDElibraryhas establishedaLONOKEEPscriptthatdeletesfilesfromyour directory,thisMO2 qualifiercontrolswhetherthefileusedtocreatethenewMOmodule generationisdeletedfromyour directory.'The/KEEPRO qualifierkeepsthefileinyour directorywithoutdeletingit.HO<The/NOKEEP qualifierrunstheNOKEEPscripttodeleteQOthefileprovidedyoudidnotalsospecifythe/RESERVEqual-MOifier.*IfyourVDElibrarydoesnothaveaNOKEEPscript,&OEthefileisnotdeleted.AO/LOG (default)O(/NOLOGKOControlswhetherlogmessagesareprintedaftereachmod-MOuleis replaced.+The/LOG qualifiercausesthemessagestoJO2beprintedandthe/NOLOG qualifier suppressesthem.)TheJOmessagesindicatethateachmodulehasbeenreplacedandIOthatthedatabase transactionhas successfully committed.BO/NOTE=note-number O(The( note-number17( parameter specifiesthenotenumberKOforthe(previously-entered)SCTnote associatedwiththisO replacement.CQOVDEcanalsoenterthenoteintothe conference directly,see1Othe/SCT qualifierfor information.oD KEO/OTHER="other-reason"2O( Specifiesthetypeof check-in.*TheS( other-reasonD(parame-ROter specifiesthereasonforthis check-in,andshouldindicateLOwhythis particularcheck-inwasnot classifiedasafold/O2check-innorasanSCT check-in.PE&&OAlsosee/FOLDand/SCT.aF7 O/PROPAGATE=stream-nameO( /NOPROPAGATEKOThis qualifiercontrolsthedefaultmodule propogationbe-LOhaviourofthe replacement operation.*ThedefaultforthisOO2 qualifiercanbealteredbythe propogation qualifierontheORESERVEcommand.GgGOWhen specified,the /PROPAGATE qualifiercausesVDEtoLO propagatethechanged module(s)onlyasfarasthestreamO5 specifiedbythe5 stream-name5 parameter,but 5 not5toanyKO successorsofthat stream-change propagationthusstopsat!Othe specifiedstream.HEOThe /NOPROPAGATE qualifiercausesVDEtodisableallHO propagateofthechangebeyondthecurrentstream(theIO5defaultstreamorthestream specifiedwiththe/STREAMO qualifier).INGOIfyouomitboth qualifiers,theREPLACEcommandwillHO propagatethechangedmodulestoall successorsoftheO5currentstream.QJ 'BOBydefault,neither /NOPROPOGATEnor /PROPOGATEisQO specified,andthemodulechangeswill propogatetoallsubse-OO5quentstreams.(The behaviourisaffectedbythe specificationEOofthe propogation qualifierontheRESERVEcommand.NK! $O/QARO(/NOQARLOIfyouhaveenabledthelibrary attributethatcausestheDOREPLACEcommandtoaskforthereasonforthere-JO2 placement,these qualifierscontrolwhetherVDEalsoasksJOforproblemreportsrelatedtothe replacement.+The/QARKO qualifiercausesVDEtopromptforrelatedQARsandCLDsQO<(Digitalproblemreports)evenifyougivethereasonasFOLDJOorOTHER.The/NOQAR qualifiercausesVDEtonotpromptLOforQARandCLD informationevenifyougiveanSCTen-NOEtryasthereason.)Ifyouspecifyneither/QARnor/NOQAR,HOtheREPLACEcommandpromptsforQARsandCLDsonlyifOOyouspecifyanSCTentryasthereasonforthe replacement.QOONeither qualifierhasanyeffectifyouhavedisabledtheli-HObrary attributethatcausestheREPLACEcommandtoask2Oforthereasonforthe replacement.\L2O/QUEUEO( /IMMEDIATE (default)MOControlswhethereachmoduleisreplacedintothe specifiedLOstream immediatelyorisqueuedforlater replacement.(TheBO2 /IMMEDIATE qualifiercausestheREPLACEcommandtoJOreplaceeachmoduleintothe specifiedstream immediatelyNOsothatthe replacementiscompleteassoonasthecommandGO< finishes.(The/QUEUE qualifiercausestheREPLACEcom-GOmandtoqueuethe replacementintheVDE database-andNOcausesacopyofthemoduletobeplacedintothestagingJOEarea-sothatthemoduleremainsreserveduntilanautho-?OrizeduserentersaPERFORM REPLACEMENTcommandJOtocausetheactual replacementtooccur.-IfanystreamAOOintowhichyouare replacingthemodulehastheDOqueued-O replacementOfor replacementandthe /IMMEDIATEisignored.oM! EEOOf/QUEUEand /IMMEDIATE, /IMMEDIATEisthedefault.=N! O/PROJECT=project-nameSO(This qualifierallowstheusertospecifytheprojectnamethisOO replacementis associatedwith.&TheprojectnamecanbeusedROtotracktheworkandchangesrelatedtoa particularproject.@O SOThis qualifierispartofthe statistics collection componentofQOVDE. Statistics collectionisenabledordisabledonalibraryBO5basis,usingtheMODIFYLIBRARY/STATISTICScommand.UOIf statistics collectionis disabled,the statistics qualifiersareJOignoredandhavenoadverseeffects.*CertainkeywordsonO>thiscommandl> require0>the specificationofthe /DEFECTS_9O CORRECTEDor/NODEFECTS_CORRECTED qualifier.{PKQO/REASONS=reason-codeRO(This qualifierallowstheuserawaytosecifythereasonthe'O replacementisbeingmade:F reason-code[ specifiesthepar-ROticularreasoncodeforthis replacement,basedonthelistof O2reasons containedinB2Table3-2.*PBa?QfR< OThe reason-code islistedinTable3-2, asisabriefex-NO plainationofthecode,andan indicationastowhetherorGO<notthenumberofdefectsis collected(see /DEFECTS_9O CORRECTED)forthe particularreasoncode.*RMc?Q@S SOThis qualifierispartofthe statistics collection componentofQOVDE. Statistics collectionisenabledordisabledonalibraryBO5basis,usingtheMODIFYLIBRARY/STATISTICScommand.UOIf statistics collectionis disabled,the statistics qualifiersareJOignoredandhavenoadverseeffects.*CertainkeywordsonO>thiscommandl> require0>the specificationofthe /DEFECTS_9O CORRECTEDor/NODEFECTS_CORRECTED qualifier.TNQOIf statistics collectionisenabledonthecurrentlibraryandTOyoudonotspecifythis qualifier,youwillbepromptedfortheO5 information.qUKGO/REMARK="string"OO( Specifiesa characterstringtobe associatedwiththenewlyLOcreated generationintheVDE database.(Theremarkisen-POclosedin quotationmarks.(Ifnoremarkisentered,thentheBO2remarkfromthe corresponding reservationisused.V NUOTheremarkstringisusedasthetitleoftheSCTnote,ifVDEPOwasaskedtoentertheSCTnotebythe specificationoftheO5/SCT qualifier.\W! 2O/REPLACEMENT=rep-nameNO( Specifiesthatthe reservationsforthe specifiedmodulesbeLOaddedtoaqueued replacementwiththenamegivenbytheOrep-name: parameter.,Ifaqueued replacementbythatNO2namealreadyexists,the reservationsareaddedtothatre-HO placement.-Ifnosuch replacementexists,anewqueuedLO replacementbythatnameiscreatedandthemodulereser-TO<vationsareaddedtoit.'This qualifierisignoredfor immediateNO replacements;itisonly meaningfulifyoualsospecifytheMO/QUEUE qualifieroroneofthestreamsintowhichyouare,OE replacingthemoduleshavetheEqueued-replacementO attribute.eX ;COQueued replacementsare implicitlyand automaticallyEOcreatedwheneveraREPLACEis performedonastreamGO5markedforqueued replacements.)Forfurther informationMOon explicitlycreatingaqueued replacement,seetheCREATEO REPLACEMENTcommand.Y O/RESERVEO( /NORESERVE (default)KOControlswhetherthereplacedmoduleiskept reserved.*IfLOyouspecifythe/RESERVE qualifier,themoduleremainsre-NO2servedandtheinputfileisnotdeletedfromyourdefaultHO directory.,Ifyouspecify /NORESERVE,themoduleisno3Olongerreservedafterbeing replaced.?Z ^.O/REVIEWER=(username[,username...]){( parameter specifiesthenameofafiletobeOOloadedintotheSCTnotes conference.)ThisfilecontainstheJOpreviously-editedtextofanSCTentryfortheSCTnote.O2 associatedwiththis replacement.]SOIfthis qualifierisused,thedefaultnotes conferencefortheO stream-SCT-D stream-name?-isassumed.^zQOIfthis qualifieris specified,the/REMARKstringisusedas)OthetitleoftheSCTnote._NOFor informationonthepropercreationand protectionofan+OSCTnotes conference,seethe GuidetoUsingVDE S.R`((OAlsosee/FOLDand/OTHER.]a! U3O/SESSION=session-nameOO(Sessionsareusedto logicallygroupasetofmodulereser-POvations together, typicallytogroupallmodulesrelatedtoaNO particularsourcecode alterationor enhancement together.'ItQO2allowsall componentmodulesreservedtobetreatedasasin-LOgleentityfor subsequent replacement operations.*AsessionPOalsoallows additionalmodulestobereservedand incorporated:O<intoanexistingsessionatalatertime.8b QOIfyouusethe/SESSION qualifier,those reservationsthatareOOmembersofthe specified reservationsessionare replaced.(In+O5thiscase,youmustomitthe]5mod-name=5 parametersfromOthecommand.cZ WqFOSessionscanbe manipulatedviatheREPLACE,RESERVE,combinedintothesamesession.Pd! U&O/STREAM=stream-nameMO( Specifiesthatthemodulesbereplacedintothe development Ostreamgivenbythe- stream-name"p parameter.&ThechangedPOmodulesarealso propagatedtoany successorsofthatstream,UO2if appropriate.&Ifthis qualifierisomitted,themodulesarere-SOplacedintothedefault developmentstream.&Ifthis qualifierisLOomittedandnod>. .efaultstreamisdefined,VDEpromptsyou!O<forthestreamname.e O/USERNAME=usernamePO( Specifiesthatmodulesbereplacedonbehalfofanotheruser. OTheusername6 parameter specifiestheOpenVMSusernameNOoftheotheruser.'Thatusermusthavethemodulereserva-PO2tionsthatthereplace operationwillend.(Youmusthavethe8OUSERNAME privilegetousethis qualifier. f  OExamples O1. VDE>:REPLACE%MOD1%/REMARK="Fixed% list-update%bug"N %VDE-I-FILCOPLIB,%file&DEV$:[MYDIR]MOD1.PAS;2%copied&to&library\" %VDE-I-REPLACED,& generation%[FACIL]MOD1.PAS;8(7A1)%replaced%into&stream%V2.0Mj %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE>C!ThisexamplereplacesthemoduleMOD1.PASintotheLycurrentVDElibrary.(Becausenofacilityis specifiedwithJthecommand,themoduleisassumedtoexistinthede-K*fault facility,FACIL.Becausenotypenameis specified,JallsourcemoduleswithnameMOD1are replaced;inthisHcasethereisonlyonesuchmodule, MOD1.PAS.ThelogH4messagesshowthatthemodulewas successfullyreplacedintostreamV2.0. O2.  VDE>% REPLACE%[COPY]COPYMAIN.B32QR Please%supply&required& information&for%module%[COPY]COPYMAIN.B32:* Enter%the% replacement%remark:&4ADD%THE&/FUMBLE% QUALIFIERR %VDE-I-FILCOPLIB,%file&DEV$:[MYDIR]COPYMAIN.B32;3&copied%to%library_* %VDE-I-REPLACED,& generation%[COPY]COPYMAIN.B32;23(23)%replaced%into&stream%V3.0_r %VDE-I-REPLACED,& generation%[COPY]COPYMAIN.B32;23(23)%replaced%into&stream%V3.1M %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE>;pThiscommandreplacesmodule COPYMAIN.B32inDfacilityCOPYintothecurrentlibrary..BecausetheA! /REMARK qualifierisnot specifiedwiththecom-Bz mand,VDEpromptsfortheremarkbefore replacingE themodule.(ThelogmessagesshowsthattheREPLACEG+ commandreplacedthemoduleintostreamV3.0andthen?  propagatedthenew generationintostreamV3.1. O 3. VDE><  REPLACE/QUEUE%FEE.MAR,%FOO.MAR%"Remark&string"TI %VDE-I-FILCOPSTAG,%file%DEV$:[MYDIR]FEE.MAR;3%copied&to&staging%areaT %VDE-I-FILCOPSTAG,%file%DEV$:[MYDIR]FOO.MAR;3%copied&to&staging%areaT %VDE-I-REPLQUE,%module&[FACIL]FEE.MAR&queued%for% replacement%SMITH-1T! %VDE-I-REPLQUE,%module&[FACIL]FOO.MAR&queued%for% replacement%SMITH-1Mi %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE>@ Inthisexample,theREPLACEcommandqueuestheBx  replacementofmodulesFEE.MARandFOO.MARinfa-I cilityFACIL.ThemodulesarecopiedtoastagingareaG)thatVDEmanages,buttheyarenotreplacedintotheBVDElibraryandtheyremain reserved.)TheREPLACE?commandgivesthequeued replacementthegener-@3atednameSMITH-1..ToactuallyreplacesthetwoAmodules,an authorizedusermustenteraPERFORM: REPLACEMENTcommandfor replacementSMITH-1.Uh giEOREVIEW BUILD_JOB*xNNOReviewsthe build-steplogfilesfora specifiedbuildjob.d:OFormat*OsREVIEW BUILD_JOBN [stream-name] eO ParameterOs stream-nameLOThenameofa developmentstream.'VDEreviewstheresultsRO$ofthemostrecentbuildjobforthe specifiedstream.*IfyouO|omitthe| stream-name0| parameter,VDEreviewstheresultsGOofthemostrecentbuildjobforthedefaultstream.! [O Description?OsTheREVIEW BUILD_JOBcommandallowsyoutore-TOviewthelogfilesofthe individualbuildstepsofa specifiedNO$buildjob.(Thecommandentersyouintoa subsystemofVDE.JO|Onceinthe subsystem,youarepromptedwiththestringFO VDEREVBLD>andyoucanthenusea restrictedsetofHO- commands, differentfromusualVDE commands,todisplayROselectedlogfiles.(After reviewingbuildresults,usetheEXITHOcommandtoexitfromthe subsystemandreturntoVDE.5OzTheREVIEW BUILD_JOBcommandcreatesa#z build-stepOreviewlistEwhichisalistofbuildstepstobe reviewed.)ByRO+default,thelistincludesonlythosestepsthat completedwith@Oerrors.+CommandsintheREVIEW BUILD_JOBsubsys-ZOtemlistthestepsinthereviewlistanddisplaythelogfilesforMO4thosesteps.(The subsystemthusgivesyoua convenientwayMOto determinewhichbuildstepsfailedandwhytheyfailed.JOThe subsystemcanalsoreviewbuildstepsthat completedLO> successfully.+Usethe/STEP qualifiertoinclude successful3Ostepsinthe build-stepreviewlist.B EOWhenyouareintheREVIEW BUILD_JOB subsystem,youBOentercommandsatthe VDEREVBLD>prompt.*Thecom-RO5mandscandisplayeitherthe build-stepreviewlistorthelog?Ofilesfor individualbuildstepsonthatlist.! COTheREVIEW BUILD_JOB subsystemacceptsthecommandsO documentedin'xReviewBuildJob Commands.*x?qO Qualifiers,Os/STEP [=(status[, status...])]HOReviewseitherallbuildstepsor,ifyouspecifythesta- O$tusG$ parameter,thosestepswhosestatusis specified.+EachO|statusA[| parametermustbeoneofthe following keywords:6O NOTSTARTED,RUNNING,SUCCESS,orERRORS.N%OIfyouspecifyonlyonestatus& parameter,the parenthesesQOmaybeomitted.)Ifyoudonotspecifya parameter,allbuild:O5stepsof specifiedbuildjobare reviewed.POIfyouomitthe/STEP qualifier,onlythosebuildstepsthat1O completedwitherrorsare reviewed.n NDOExamples O1. VDE>REVIEW% BUILD_JOBA Reviewing%steps%of%build%job&38&for%stream%MAIN0 Number%of%build%steps% selected:&1 VDEREVBLD>o DIRECTORYH Steps%being%reviewed%in%build%job%38%for&stream%MAIN:7D< Compile&step%for&module%[BUILD_TEST]E.B32 VDEREVBLD>oNEXT+ Build%job%38%for&stream%MAING\ Log%file%of%compile&step%for&module%[BUILD_TEST]E.B32:F 1:&--->>&ERROR:%MISSING&SCRIPT%IN%VDE%DATABASE%<<---G4 2:&No&script%found%in%database%to%perform&build&step| [End&of&file]  VDEREVBLD>o NEXTFT %VDE-E-NOMORESTEP,%no%more%build%steps%in%review%list VDEREVBLD>oEXIT VDE>KRInthisexample,onestep completedwitherrorsinbuild=job38forstreamMAIN.TheREVIEW BUILD_JOBFcommanddisplaysmessagesthatidentifythebuildjobH\andgivesthenumberofstepsselectedforreview.+ByDdefault,thecommandincludesonlythosestepsfromK the build-stepreviewlistthat completedwitherrors;inGf thiscase,thereisonesuchstep.*Atthe VDEREVBLD>A prompt,theuserentersthe DIRECTORYcommandtoK displaythebuildstepsonthecurrentreviewlist.+ThenHp theuserenterstheNEXTcommandtoseethelogfileH forthenextbuildstep.) (PressingtheRETURNkeyhasH! thesameeffect.)-ThelogfileshowsthatthecompileNy stepfailedbecausenoscriptforitwasfoundintheVDEA  database.*AsecondNEXTcommandshowsthatthereH* arenomorebuildstepsonthereviewlist.,TheEXIT< commandthenexitsfromtheREVIEW BUILD_JOBD  subsystemandreturnstheusertotheVDE>prompt. OT 2.T VDE>(T REVIEW%BUILD_JOB/STEP=SUCCESSA Reviewing%steps%of%build%job&39&for%stream%MAIN0 Number%of%build%steps% selected:&5s VDEREVBLD>os DIRECTORYH Steps%being%reviewed%in%build%job%39%for&stream%MAIN:7D Compile&step%for&module%[BUILD_TEST]B.REQ7DK Compile&step%for&module%[BUILD_TEST]C.B327D Compile&step%for&module%[BUILD_TEST]D.B327D Compile&step%for&module%[BUILD_TEST]E.B324D# Link&step%for&module%[BUILD_TEST]X.EXE VDEREVBLD>oSELECT%X+ Build%job%39%for&stream%MAINDC Log%file%of%link&step%for&module%[BUILD_TEST]X.EXE:D 1:&$%DEFINE&OBJLIB%#DISK$:[LIBROOT.MAIN.BUILD_TEST.OBJ]: 2:&$%&LINK/EXE=OBJLIB:X.EXE/MAP=OBJLIB:X.MAPK- c 3:?)c 5OBJLIB:OBJLIB.OLB/INCLUDE=C,OBJLIB:OBJLIB.OLB/LIBRARY! 4:&$%DEASSIGN%OBJLIB 5:&$%!A; 6:&$%SET&NOVERIFYp!% Successful&script% completion [End&of&file] VDEREVBLD>oEXITZ VDE>CInthisexample,the /STEP=SUCCESS qualifiercauses<"theREVIEW BUILD_JOBcommandtoincludeonlyLzthosestepsfromthe build-stepreviewlistthat completedA successfully.'The subsystem DIRECTORYcommandthenG+listsallsuchsteps.)TheSELECTcommanddisplaystheLlogfileofthelinkstepformoduleX.EXE.Finally,the<EXITcommandexitsfromtheREVIEW BUILD_JOBD5 subsystemandreturnstheusertotheVDE>prompt.<ihjP&&OReviewBuildJobCommands*GOTheReviewBuildJobcommandsareusedtoreviewtheIO(resultsofabuildjob.0ThecommandsarevalidatthepromptduringtheREVIEW BUILD_JOBOcommand. OFormat1Os DIRECTORYN [mod-name[, mod-name...]]OSELECTN [mod-name]O:NEXTM[STEP]OBACKOCURRENTOeFIRSTOLASTO,SPAWNOATTACHOEXITz! PO DescriptionQOsThereviewcommandsallowyoutoreviewthelogfilesoftheOO individualbuildstepsofa specifiedbuildjob.)ThecommandNO$entersyouintoa subsystemofVDE.Onceinthe subsystem,EO|youarepromptedwiththestring VDEREVBLD>andyouLOcanthenusea restrictedsetof commands, differentfromOO-usualVDE commands,todisplayselectedlogfiles.(Afterre-KOviewingbuildresults,usetheEXITcommandtoexitfrom/Othe subsystemandreturntoVDE.5OzTheREVIEW BUILD_JOBcommandcreatesa#z build-stepOreviewlistEwhichisalistofbuildstepstobe reviewed.)ByRO+default,thelistincludesonlythosestepsthat completedwith@Oerrors.+CommandsintheREVIEW BUILD_JOBsubsys-ZOtemlistthestepsinthereviewlistanddisplaythelogfilesforMO4thosesteps.(The subsystemthusgivesyoua convenientwayMOto determinewhichbuildstepsfailedandwhytheyfailed.JOThe subsystemcanalsoreviewbuildstepsthat completedLO> successfully.+Usethe/STEP qualifiertoinclude successful3Ostepsinthe build-stepreviewlist.~TEOWhenyouareintheREVIEW BUILD_JOB subsystem,youBOentercommandsatthe VDEREVBLD>prompt.*Thecom-MO5mandscandisplayeitherthe build-stepreviewlistortheTOlogfilesfor individualbuildstepsonthatlist.(The subsystem,Oacceptsthe following commands:nD `mm DIRECTORY&m [mod-name[, mod-name...]]a7OWDisplaysalistofallbuildstepsonthe build-stepreviewOlist,givingthetypeofeachstep (compile,link,orcopy)Gandthenameofthemodulethatis compiled,linked,6aorcopied.*Ifyouspecifyoneormoreamod-name apa-F rameters,thecommanddisplaysonlythosebuildstepsAwhosemodulenamesmatchthe parameters.+Youcan!kuse wildcardsinthekmod-namek parameter. `SELECT( [mod-name]-! zHWSelectsthefirstbuildstepwhosemodulenamematches the_mod-name7@ parameteranddisplaysthelogfilefor?thatbuildstep.'Youcanuse wildcardsinthe)mod-namea parameter..! WIfyouomitthe Wmod-name"W parameter,thecommandUdisplaysthelogfileofthenextbuildsteponthereviewlistEthatmatchesthemostrecently specifiedmodulenameDafromapreviousSELECTcommand.)Usingthisfeature,6youcanenteraSELECTcommandwithamod-nameK parameter containing wildcardstodisplaythelogfileofKkthefirstbuildstepthatmatchesthe parameter.(Youcan@thenenterSELECTcommandswithout parameterstoRdisplaythelogfilesofallotherbuildstepsthatmatchtheEtoriginal parameter,onelogfileperSELECTcommand. `NEXT[STEP]!PWDisplaysthenextpageofthelogfileofthecurrentbuildLstep.)IfyouspecifytheoptionalSTEPkeyword,thefirstMpageofthelogfileofthenext build-stepis displayed.b! 8JWPressingtheKP0key(the0keyonthenumerickeypad)JisthesameasenteringtheNEXTcommand.'Asaresult,Syoucanreviewthelogfilesofallbuildstepsonthereview8alistby repeatedlypressingtheKP0key. `BACKHKWDisplaysthelogfileofthepreviousbuildsteponthe# build-stepreviewlist. `//CURRENTHzQWDisplaysthefirstpageofthelogfileofthecurrentbuildstep. `//FIRST! HTWDisplaysthelogfileofthefirstbuildsteponthe build-stepreviewlist. `//LAST HSWDisplaysthelogfileofthelastbuildstepinthe build-stepreviewlist. `//SPAWNGWSpawnsa subprocessandattachestheterminaltothatA subprocess..Seethe descriptionoftheVDESPAWN commandfordetails. `ATTACHHGWAttachestheterminaltoa specifiedprocess.-SeetheC descriptionoftheVDEATTACHcommandfordetails. `//EXITk=WExitsfromtheREVIEW BUILD_JOB subsystemand.returnsyoutotheVDE>prompt.j ikGOREVIEW REPLACEMENT* AOOReviewsthemodules,commentfiles, informationfile,andlogDO(file associatedwitha specifiedqueued replacement.a7OFormat'OsREVIEW REPLACEMENTMrep-nameO ParameterOsrep-nameIOThenameofthequeued replacementtoreview.+Thispa-LO$rameteris required;ifyouomitit,VDEpromptsyoufor O|it.~ TO DescriptionAOsTheREVIEW REPLACEMENTcommandallowsyoutore-LOviewallfiles associatedwithagivenqueued replacement.LO$Thesefilesincludethemodulesbeing replaced,theinfor-MO|mationfilethatthe replacingusermayhave provided,theJOcommentfilesthatother reviewersmayhavewritten,andRO-possiblyalogfileforanattempttoperformthe replacement.ROThelogfileisonlypresentifanearlierattempttoperformQOthe replacementfailed;thelogfilethentellsyouwnatwentHO7wrong.*Foreachmodulebeing replaced,youmayexamineMOthenewversionqueuedfor replacement,theoldversioninGOtheVDElibrary,andthe differencesbetweenthetwo.AOTheREVIEW REPLACEMENTcommandentersyouintoaLO subsystemofVDE.Onceinthe subsystem,youarepromptedIO4withthestring VDEREVREP>andyoucanthenuseare-HOstrictedsetof commands, differentfromtheusualVDEMO commands,todisplaythefiles associatedwiththereplace-KO>ment.+After reviewingthesefiles,youmustusetheEXITHOcommandtoexitfromthe subsystemandreturntoVDE.! kAOTheREVIEW REPLACEMENTcommandcreatesalistof.Ofilestobereviewedcalledthe# replacementreviewlist G.QO5Thislistincludesthe replacement's informationfile(ifany),QOthecommentfileforeachreviewerthathasprovidedone,theROlogfileforthelastattempttoperform replacement(ifany),LO>andthemodulesthatarequeuedfor replacement.' SubsystemLOcommandslist,display,andnavigateamongtheelementsinKOthereviewlist.'Oneelementisalways designatedasthe:cur-OHrentelementDeH.* Initially,thefirstelementonthelististheKOcurrentelement,butvariouscommandcanchangethatdes-DO ignation.+TheSHOWandEDIT subcommandsdisplaythe*ORtextofthecurrentelement.N$O QualifiersOs/COMMENTOO Specifiesthatreviewercommentfilesbeincludedinthere-NO$ placementreviewlist.*Ifthis qualifierisomitted,commentRO|filesareonlyincludedifallother qualifiersareomittedasOwell.QK'O /INFORMATIONPO( Specifiesthatthequeuinguser's informationfilebeincludedPOinthe replacementreviewlist.,Ifthis qualifierisomitted,UOthe informationfileisonlyincludedifallother qualifiersareO2omittedaswell.U K+O/MODULELO( SpecifiesthatallmodulesthataremembersofthequeuedLO replacementbeincludedinthe replacementreviewlist.*IfUOthis qualifierisomitted,modulesareonlyincludedifallother-O2 qualifiersareomittedaswell.! O/STREAM=stream-nameRO(This qualifier specifiesthenameofthestream associatedwith8Othe replacement.&Itis currentlyignored.  sOExamples O1. VDE>&REVIEW% REPLACEMENT%SMITH-1Q Reviewing% replacement%SMITH-1%queued%by%user%SMITH%(Jane%Smith)7" Number%of%modules%and%files% selected:&4 VDEREVREP>o DIRECTORYJ Modules&and%files%being%reviewed%for% replacement%SMITH-1:;DB Information%file&by&user%SMITH%(Jane%Smith)SD Comment&file%by%reviewer%BROWN%(Bill%Brown)& rejecting% replacementD Module% [FACIL]A.REQD Module% [FACIL]C.B32 VDEREVREP>oCURRENT;9 Information%file&by&user%SMITH%(Jane%Smith) VDEREVREP><8Inthisexample,theREVIEW REPLACEMENTcom-Bmanddisplayssome information identifyingthere-@questedqueued replacementandenterstheREVIEW7B REPLACEMENT subsystem.+The DIRECTORYsub-Fcommanddisplaystheelementsonthereviewlistand@theCURRENT subcommandprintsaline identifyingKKthecurrentelementofthereviewlist(namelythefirst element). O 2. VDEREVREP>o SHOWM Text&of&the%queuing&user's% information%file& displayed%here.4 This&file%may&consist%of%many%lines. VDEREVREP>o NEXTS Comment&file%by%reviewer%BROWN%(Bill%Brown)& rejecting% replacement VDEREVREP>o SHOWQ4 Text&of&comment%file%written&by&reviewer&BROWN& displayed%here.4| This&file%may&consist%of%many%lines. VDEREVREP>@z Thisexample continuesthepreviousexample..TheG SHOWcommanddisplaysthetextofthecurrentreview-F+listelement,userSMITH's informationfile.(TheNEXTCcommandmakesthenextelementthecurrentelementAandprintsitsname.*The subsequentSHOWcommandL5thendisplaysthetextofthatfile,thecommentfilebyreviewerBROWN. O3. VDEREVREP>oNEXT Module% [FACIL]A.REQ% VDEREVREP>o%SHOWPm %VDE-I-FETCHED,% generation%[FACIL]A.REQ;7(7)%fetched&from%libraryX %VDE-I-OUTFILE,%output&file%is%+DEV:[VDELIB.VDE$STAGE.VDE$STG_0.VDE$REP_11. FACIL]A.REQ_VDE$OLD;5 Number%of% difference%sections%found:%04 Number%of% difference%records&found:%0Re DIFFERENCES%;/IGNORE=()/MERGED=1/OUTPUT=DEV:[VDELIB.VDE$STAGE.VDE$STG_0., "VDE$REP_11.FACIL]A.REQ_VDE$DIFF;1-Ci 9DEV:[VDELIB.VDE$STAGE.VDE$STG_0.VDE$REP_11.FACIL]A.REQ;1-Ji= @DEV:[VDELIB.VDE$STAGE.VDE$STG_0.VDE$REP_11.FACIL]A.REQ_VDE$OLD;1 VDEREVREP>oNEXT] Module% [FACIL]C.B32 VDEREVREP>oNEXT@5 %VDE-E-NOMOREMOD,%no%more&modules%in%review&list} VDEREVREP>o}EXIT VDE>B3YetanotherNEXTcommandmakesmodule [FACIL]A.REQHthecurrentelementofthereviewlist.(TheSHOWcom-Lmanddisplaysthe differencesfileforthatmodule.(TodoN=so,itfirstfetchesouttheold generationofthemodule,G differencesitwiththenew generationqueuedforre-G placement,anddisplaysthe differencesfile.*TheEDITJFcommandcouldhavebeenusedjustaswell,andismoreGsuitableforlong differencesfiles.)AnotherNEXTcom-Amandmakemodule [FACIL]C.B32thecurrentelementCPanddisplaysitsname.*AfinalNEXTcommandshowsKthattherearenomoreelementsinthereviewlist.*TheEuserthenenterstheEXITcommandtoreturntotheZVDE>prompt.*kjlQ''OReview ReplacementCommands* HOTheReview ReplacementCommandsareusedtoreviewre-GO( placementsqueuedtothecurrentlibrary.*ThecommandsFOarevalidatthe VDEREVREP>promptduringtheREVIEWO REPLACEMENTcommand.tJOFormat1Os DIRECTORYN [mod-name[, mod-name...]]OSELECTN [mod-name]O:SHOWN [keyword]OEDITN [keyword]ONEXTOeBACKOCURRENTO,FIRSTOLAST#OACCEPTN["remark-string"]!OWREJECTN"remark-string"OSPAWNOATTACHOEXITO Description;OTheREVIEW REPLACEMENT subsystemacceptsthe;Of followingcommandsatthe VDEREVREP>prompt:nD `mm DIRECTORY&m [mod-name[, mod-name...]]8 oOWDisplaysalistofall informationfiles,commentfiles,re-D placementlogfiles,andmodulesonthe replacementMreviewlist.'Foreachfile,thiscommanddisplaysthetypeEa (information,comment,log,module,orbinarymodule)Iandthenameofuserwhocreatedthefile(forinfor-Gmationandcommentfiles)orthenameofthemodule.)kIfyouspecifyoneormorekmod-namek parameters,DthecommanddisplaysonlythosemoduleswhosenamesDmatchthe parameters.,Youcanuse wildcardsinthetmod-name8t parameter.'An informationorcommentfileIhastheauthor'sOpenVMSusernameasitsfilename,so5%thesefilescanalsobeselectedwith%mod-name%param-L~eters.*The replacementlogfile(ifpresent)hasthefilename LOG.VDE$LOG. `VVSELECT(V [mod-name]x NMWSelectsthefirstreviewlistelementwhosemoduleorfilenamematchesthemod-namel parameterandmakesCthatthecurrentreviewlistelement.-ThiscommandOaprintsoneline identifyingtheselectedmoduleorfile.'YouGcanselectan informationorcommentfilebyspecify-8ingtheauthor'sOpenVMSusernameinthemod-nameIk parameter.,Youcanselectthelogfile(ifpresent)by" specifyingLOGinthemod-name parameter.+! WIfyouomitthe Wmod-name"W parameter,thecommandLdisplaysthenextelementonthereviewlistthatmatchesGthemostrecently specifiedmodulenamefromaprevi-GaousSELECTcommand.'Usingthisfeature,youcanenter%aSELECTcommandwithamod-name parameterK containing wildcardstoselectthefirstmodule(orotherFkfile)thatmatchesthe parameter.+YoucanthenenterASELECTcommandswithout parametersto successivelyMselectallothermodulesandfilesthatmatchtheoriginalBt parameter,onemoduleorfileperSELECTcommand. `SHOW [keyword]w >MMWPrintsthetextofthecurrent review-listelementonyourG terminal.,Ifthecurrentelementisan informationorKcommentfile,VDEreadsthatfileandprintsitonyourKa terminal.(Ifthecurrentelementisamodule,VDEprintsJthenewversionofthemodule(theversionabouttobeJreplacedintothe library),theoldversionofthemod-Fkule(the generationthatwasfetchedwhenthemoduleHwas reserved),orthe differencesbetweenthetwo.*Thekeyword9@ parameter determineswhatis displayedforBtamodule;this parametermaybethekeywordNEW,COLD,or DIFFERENCES.This parameterisignoredfor2% information,comment,andlogfiles.x! 5NKWIfyouspecifytheOLDkeyword,VDEfetchesouttheoldImodule generationunlessapreviousreviewerhasalreadyJfetcheditintothe replacement'sstagingarea.(VDEthenIadisplaysthatfile.'Ifyouspecifythe DIFFERENCESkey-Jword,VDEfetchesouttheoldmodule generationifnec-=essary.*VDEthenrunstheOpenVMS DIFFERENCESHkcommandtocreatea differencesfileunlessapreviousIreviewerhasalreadycreatedit.)VDEthendisplaysthatfile. HLWThiscommandwillnotdisplayanyfilesforbinarysourcemodules. `//EDIT/ [keyword]IWInvokesyour preferrededitorin read-onlymodetodis-Kplaythetextofthecurrent review-listelement.+IftheHcurrentelementisan informationorcommentfile,VDENaspawnstheeditortodisplaythatfile.)Ifthecurrentel-Fementisamodule,VDEspawnstheeditortodisplayJthenewversionofthemodule(theversionabouttobeJkreplacedintothe library),theoldversionofthemod-Fule(the generationthatwasfetchedwhenthemoduleHwas reserved),orthe differencesbetweenthetwo.*Thetkeyword9@t parameter determineswhatis displayedforBamodule;this parametermaybethekeywordNEW,C%OLD,or DIFFERENCES.This parameterisignoredfor2~ information,comment,andlogfiles.x! 5NKWIfyouspecifytheOLDkeyword,VDEfetchesouttheoldImodule generationunlessapreviousreviewerhasalreadyJfetcheditintothe replacement'sstagingarea.(VDEthenIadisplaysthatfile.'Ifyouspecifythe DIFFERENCESkey-Jword,VDEfetchesouttheoldmodule generationifnec-=essary.*VDEthenrunstheOpenVMS DIFFERENCESHkcommandtocreatea differencesfileunlessapreviousIreviewerhasalreadycreatedit.)VDEthendisplaysthatfile. ^LWThiscommandwillnotdisplayanyfilesforbinarysourcemodules.?WUsetheSETEDITORcommandattheVDE>promptNtospecifyyour preferrededitor.)Ifyoudonotdeclarean>editor,VDEinvokesthesystemdefaulteditor. `NEXTHWMakesthenextelementonthereviewlistthecurrent?elementanddisplaysthenameofthatelement.I! [GWPressingtheKP0key(the0keyonthenumerickey-Gpad)isthesameasenteringtheNEXTcommand.)AsaJresult,youcanstepfromelementtoelementbyrepeat-IaedlypressingtheKP0key.* Similarly,theCOMMA( , )EkeyonthenumerickeypadenterstheNEXTandSHOWHcommandswithasingle keystrokeandtheMINUS( - )EkkeyonthenumerickeypadenterstheNEXTandEDIT commands. `BBBACK! HLWMakesthepreviouselementonthereviewlistthecurrent?elementanddisplaysthenameofthatelement. `//CURRENT HKWDisplaysthenameofthecurrentelementofthereplace-mentreviewlist. `//FIRSTHIWMakesthefirstelementonthereviewlistthecurrent?elementanddisplaysthenameofthatelement. `//LASTHHWMakesthelastelementonthereviewlistthecurrent?elementanddisplaysthenameofthatelement. `//ACCEPT8/ ["remark-string"]! KWRecordsintheVDEdatabasethatyouacceptthereplace-Gment currentlybeing reviewed.)YoumustbeareviewerKforthe replacementtousethiscommand.'YoucanspecifyJatheoptionalremarkstringtogiveareasonforaccept-Cingthe replacement.+Thiscommandacceptsthesame= qualifiersasthe VDE-levelACCEPT REPLACEMENTkcommand. `REJECT( "remark-string"! KWRecordsintheVDEdatabasethatyourejectthereplace-Gment currentlybeing reviewed.)YoumustbeareviewerEforthe replacementtousethiscommand.*TheremarkKastringshouldspecifyareasonfor rejectingthereplace-Ement.(Ifyouomittheremark parameter,VDEpromptsAyouforaremark..Thiscommandacceptsthesame=k qualifiersasthe VDE-levelREJECT REPLACEMENT;command.'LikeREJECT REPLACEMENT,theREJECTHcommandletsyouspecifyacommentfiletomorefullyCtexplainyourreasonsfor rejectingthe replacement. `SPAWNGWSpawnsa subprocessandattachestheterminaltothatA subprocess..Seethe descriptionoftheVDESPAWN commandfordetails. `ATTACHHGWAttachestheterminaltoa specifiedprocess.-SeetheC descriptionoftheVDEATTACHcommandfordetails. `//EXITm:WExitsfromtheREVIEW REPLACEMENT subsystem3andreturnsyoutotheVDE>prompt.oCz { $OTable3-3:8ScriptTypes O OFScriptTypeF Description Ob OBUILD\$TheBUILDscriptsetsupoptional build-job definitions.&AnyDCLsymbolsb|equatedinaBUILDscriptmustbesetupasglobalsymbolsiftheyaretoUremainvisibleto subsequentCOMPILEandLINKscripts.(DCLsymbolsZ-requiredasinputstoCOMPILEandLINKscriptsshouldbedefinedonly]intheBUILDscript,asanypartialbuildsmaynotexecutea particular[subsetoftheCOMPILEorLINKscripts.)Thisscriptisexecutedatthe.7startofeach build-jobprocess.OCOMPILEX+TheCOMPILEscriptcontainsthe command(s)usedtocompileamodule.YDCLsymbolsrequiredasinputstocompileandlinkscriptsshouldbe]definedonlyintheBUILDscript,asanypartialbuildsmaynotexecuteW4a particularsubsetoftheCOMPILEorLINKscripts.(COMPILEscriptsQareinvokedduringbuilds,andbyanexplicitCOMPILEcommand.OCOPY[Thecopycommandisusedtocopyamodule.(TheCOPYscriptiscalledeaspartofabuildjob,andiscalledaspartofthe processingoftheCOPY2command.OCREATE_FACILITYS% TheCREATE_FACILITYscriptcontainsthe command(s)tobeexecuted)~ whenafacilityiscreated.O DELETE_GENERATIONRq TheDELETE_GENERATIONscriptperformsoptional processingforthe& DELETE GENERATIONcommand.OC FETCHS TheFETCHscriptperformsoptional processingfortheFETCHcom- mand.O INSERT_GENERATIONR TheINSERT_GENERATIONscriptperformsoptional processingforthe&b INSERT GENERATIONcommand."Dz  O OScriptType Description O OxLINK_Thelinkscriptlinksamodule.'DCLsymbolsrequiredasinputstocompilebKandlinkscriptsshouldbedefinedonlyinthebuildscript,asanypartial`buildsmaynotexecutea particularsubsetofthecompileorlinkscripts.QThisscriptiscalledbybuildjobsandbytheLINKcommand.Ou NEW_STREAM_The new-streamscriptcopiesfilesfora particularfacilityfromthepar-`Hentstreamintoanewstream.'Thisscriptiscalledwhenanewstreamiscreated.ONOKEEPPThenokeepscriptperformsoptional processingfortheREPLACEMcommand.6 Specifically,#the!nokeep!script!is"called"when!the1EREPLACE/NOKEEPcommandis specified.OREPLACEU8Thereplacescriptperformsoptional processingfortheREPLACEorF(onqueued-replacementstreams)thePERFORM REPLACEMENTcommand.\cIfstream-specific reference directoriesare required,thisscriptcanbeMusedtoupdatethe reference directoryoneach replacement.O6 RESERVEP Thereservescriptperformsoptional processingwhenaRESERVE commandisentered.\ Should notificationofa reservationbe required,a site-specificreserve1 scriptcanbecodedtosendmail.OT  SET_FACILITYR The set-facility script performs optional processing for theSET& FACILITYcommand.O  SET_STREAMX The set-streamscriptperformsoptional processingfortheSETSTREAMr command.Em j O OScriptType Description O OxSTAGING`ThestagingscriptcopiesasourcefiletoastagingareafortheREPLACE6Kcommandwhenthe replacementisqueued.O UNRESERVEU>The unreservescriptperformsoptional processingforthe UNRESERVEcommand. O QpnqEGOSET ARCHITECTURE*HxINOSets...=Ok ARCHITECTUREsupportisnotfully implemented.`J6OFormat&OsSET ARCHITECTUREM arch-nameK! =O ParameterOs arch-nameQOThenameofthe architecturetobeset.&ThisnamemaybeupIO$to39 characterslongandmustfollowVDEnamesyntax._L5O Description OsUnderConstruction...M\}OExamples O1. VDE>#SET% ARCHITECTURE%VAXPDP VDE> CUnderConstruction...sa!OTable3-4:8 Parameters O OF ParameterKF Description Ob OLOCKO$NOMAILOSHOWOSYNCHONONOTES O qpr@NOSETCONTEXT*OOP%LO EstablishesthecontextofthecurrentVDEsessionortheLO(defaultcontextforfutureVDE sessions.,AcontextcanbeHOusedtospecifythedefault developmentstream,defaultEO architectureanddefaultfacilityforaVDEsession.ZQ0OFormat OsSETCONTEXTMctx-nameRR(O ParameterOsctx-namePO SpecifiesthecontextforthecurrentVDEsessionorthede-KO$faultcontextforfutureVDE sessions.)The parametermustPO|bethenameofanexistingpublicorprivatecontextintheOVDE database.S! AwO DescriptionNOsThiscommand establishesacontextforthecurrentVDEses-QOsionor establishesthedefaultcontextforfuture sessions.*A7O$contextsetsthe followingtwo defaults: `Cthedefault developmentstreamfortheVDEsession `(3(thedefaultfacilityforthesessionT NIOUsingaSETCONTEXTcommandis equivalenttousingin-AOdividualSETSTREAMandSETFACILITYcommandsto)O5 establishthesame settings.UWLOIfyouspecifythe/DEFAULT qualifier,thecontextbecomesKOthedefaultforfutureVDEsessionsandVDErecordsthatNO5settinginthe database.+ThecontextofthecurrentsessionMOdoesnotchange.(Ifyoudonotspecifythe/DEFAULTqual-LOifier,thecommand establishesthecontextforthecurrentO>VDEsession.mVCCOTodisplay contexts,usetheSHOWCONTEXTcommand.W O QualifiersOs/DEFAULTSO Establishesthe specifiedcontextasthedefaultcontextforfu-PO$tureVDE sessions.)ThecontextofthecurrentsessionisnotO|changed.XSOIfyoudonotusethis qualifier,the specifiedcontextbecomes4Othecontextforyourcurrentsession.Y! UO/PRIVATE (default)O(/PUBLICUO Specifieswhetherthecontexttosetisaprivateorpubliccon-POtext.)The/PRIVATE qualifier specifiesthatthecontextisanOO2existingprivatecontext.'The/PUBLIC qualifier specifiesthatVOthecontextisanexistingpubliccontext.'Ifneither qualifierisROnotused,VDEassumesthatthe specifiedcontextisprivatetoO<you.lZBBOOf/PRIVATEand/PUBLIC,/PRIVATEisthedefault.[[1OExamples O1. VDE> SET%CONTEXT&BUGFIXES VDE>SHOW%DEFAULTS? Library&LIBNAME%in%root% directory%DEV$:[PROJDIR].e Default& directory%is% DEV$:[SMITH]7 Context&BUGFIXES&(private&to&user%SMITH)'D Default&stream%is%V2.2-BL1$D< Default&facility&is&RMS VDE>?;TheSETCONTEXTcommandtakesthedefaultsfor>thecurrentVDEsessionfromcontext BUGFIXES.=TheSHOWDEFAULTScommandconfirmsthatthose?Edefaultshavebeen establishedforthesession. O2. VDE>#SET%CONTEXT/DEFAULT%FOO VDE>CsThiscommandmakescontextFOOthedefaultcontext;forthecurrentuser'sfutureVDE sessions.|rqtB\OSET DEVELOPER*]^POSetsormodifiesthecurrentsettingsofthe developerflags.COkUsethiscommandonlyundertheexplicit directionBOof,andwiththe assistanceof,aVDE developer.]_3OFormat#OsSET DEVELOPERN dev-flags` |O Description OsUnderConstruction...sTable3-4#Vscontainsvariousparam-Oeters.*`6a?abQOExamples O`1.` VDE>`SET% DEVELOPER Under%Construction... VDE> SET% DEVELOPER%SCRIPT8 VDE>u tv?{OSETEDITOR*|}AvIO SpecifiestheeditorthatVDEshoulduseforthoseVDE-O(commandsthatinvokeaneditor.`~6OFormat&OsSETEDITORg"editor-string"}! SO ParameterOs editor-stringFOTheDCLcommandthatVDEshouldspawntoinvoketheQO$desirededitor.&ThisstringshouldincludetheeditornameandPO|anydesired qualifiers.)VDEwillappendthenameofthefileBOtoedittothisstringwheninvokingtheeditor. t \O DescriptionFOsTheSETEDITORcommand specifiestheeditorthatVDECOshouldusewhena subsequentVDEcommandmustin-MO$vokeaneditorforyou.+VDEcaninvokeaneditorforyouKO|whenyoureviewqueued replacements,forexample,orwhenFOyoucreateacommentfilewiththeACCEPTorREJECT>O- REPLACEMENTcommand.+Insuchcases,VDEspawnsIOaDCLcommandtoplaceyouinaneditingsession.,TheDOspawnedDCLcommandisformedby concatenatingyourSO7editorstring,aspace,andthenameofthefiletoedit.*TheJOeditorstringthatyouspecifywiththeSETEDITORcom-JOmandshouldthusgivetheDCLcommandthatinvokesyourPOA preferrededitor,alongwithany qualifiersthatyouwantforOthatcommand.JO4VDE maintainstwoeditorstringsinmemoryforthecur-NOrentVDEsession.)Onestringisusedfor read-writeeditingIOandtheotherfor read-onlyediting.(Usethe /READ_ONLYSO> qualifiertospecifythe read-onlyeditorstring.(IfyoudonotQOspecifya read-onlyeditorstring(orifyouspecifythenullQOstringforthiscase),VDEassumesthattheeditoryouspeci-POHfiedwiththe read-writeeditorstringwillacceptthe/READ_NOONLY qualifier(mostDigitaleditorsdo).*Inthiscase,VDEIOappendsthe /READ_ONLY qualifiertoyour read-writeedi-SOQ torstringtoformthe read-onlyeditorstring.'Forexample,ifPO youspecifyTPUasthe read-writeeditorstringbutnoread-IO onlyeditor,thenVDEusesthestring TPU/READ_ONLYforO[  read-onlyediting. FOTheSETEDITORcommandalwaysmodifiesthe read-writeROor read-onlyeditorstringforthecurrentVDEsession.'IfyouHO5specifythe/DEFAULT qualifier,thecommandinadditionMOwritesyourcurrenteditorsettingstotheVDEdatabasetoPO establishyourdefaulteditorstringsforfutureVDE sessions.NO>VDE retrievestheseeditorstringseachtimeyouconnecttoOtheVDE database. MOIfyoudonotusetheSETEDITORcommandtodeclareyourLO preferrededitor,VDEusesthesystemdefaulttexteditor.<O QualifiersOs/DEFAULTNO SpecifiesthatVDEshouldwritetheeditorstringsforyourMO$currentsessiontotheVDEdatabaseandthatthosestringsQO|shouldbeyourdefaulteditorstringsforfutureVDE sessions.]3O/LOG (default)O(/NOLOGMOControlswhetherlogmessagesareprintedafteryoureditorNOstringsarewrittentotheVDE database.)The/LOG qualifierKO2causessuchmessagestobeprintedandthe/NOLOGquali-LOfier suppressesthem.(These messages,whichonlyappearifLOyouspecifythe/DEFAULT qualifier,indicatethattheedi-NO<torstringshavebeenupdatedinthedatabaseandthatthe>Odatabase transactionhas successfully committed.% O /READ_ONLYTO( Specifiesthatyouare establishingtheeditorstringtouseforRO read-onlyediting.'Ifthis qualifierisomitted,VDE establishesAOtheeditorstringtousefor read-writeediting. OExamples O1. VDE>SET%EDITOR%"LSEDIT" VDE>SHOW%EDITOR#> Current&editor%strings:-D Read-write&editor%string:&LSEDIT6D Read-only%editor&string:KLSEDIT/READ_ONLY VDE>BThisexample establishesLSEDIT(whichinvokestheCLanguage-SensitiveEditor)asyour read-writeeditorC5string.'TheSHOWEDITORcommandconfirmsthatthisMisnowyourcurrent read-writeeditorstring,anditshowsGthatVDEwillappendthe /READ_ONLY qualifiertothis*?stringfor read-onlyediting. O2. VDE>0SET%EDITOR/READ_ONLY&"EDIT/EDT/READ"  VDE> SHOW%EDITOR#h Current&editor%strings:-D Read-write&editor%string:&LSEDIT3D Read-only%editor&string:K EDIT/EDT/READ@ VDE>NThisexampledefinestheeditorstringtousefor read-onlyediting. O3. VDE>$SET%EDITOR/DEFAULT%"TPU"Z %VDE-I-EDITUPDATE,%default%editor% definition%updated&in&the%VDE%databaseM1 %VDE-I-COMMIT,%database% transaction%has% successfully& committedy VDE> VDE> SHOW% EDITOR/FULL# Current&editor%strings:*DQ Read-write&editor%string:&TPU3D Read-only%editor&string:K TPU/READ_ONLY# Default&editor%strings:*D( Read-write&editor%string:&TPU3Dp Read-only%editor&string:K TPU/READ_ONLY VDE>J' Thisexample establishesTPUasyoureditor.'BecausetheF /DEFAULT qualifieris specified,VDEthenwritesyourL currenteditorstringstotheVDEdatabasetobeusedin<1 futureVDE sessions.,TheSHOWEDITORcommandJ showsthatthesesettingshavebeen establishedbothforN thecurrentsessionandasthedefaultforfuture sessions.vuwAOSETFACILITY* K[OO EstablishesthedefaultfacilityforthecurrentVDEsession.RO(Thedefaultfacilityisthefacilitytowhichamoduleisas-OOsumedtobelongwhennofacilityis specifiedinthemodulePOname.(ThedefaultfacilityalsocanbeassignedwiththeSETO2CONTEXTcommand.]3OFormat#OsSETFACILITYM facil-name=O ParameterOs facil-nameNO Specifiesthenameofthefacilitythatbecomesthedefault4O$facilityforthecurrentVDEsession.M#O QualifiersOs None.! mOExamples O1. VDE>SET%FACILITY%RMS VDE> SHOW%MODULE&MOD1.MAR Module% [RMS]MOD1.MARe VDE>eSHOW%DEFAULTS? Library&LIBNAME%in%root% directory%DEV$:[PROJDIR]. Default& directory%is% DEV$:[SMITH]$< Current&session%context:#D Default&stream%is%MAIN$D Default&facility&is&RMS VDE>@TheSETFACILITYcommandmakesfacilityRMStheHdefaultfacilityforthecurrentVDEsession.)TheSHOWB4MODULEcommandthen specifiesamodulenamewith-Eoutafacilityname.-Themoduleisthusassumedto?belongtofacilityRMS.TheSHOWDEFAULTScom-G>mandalsoshowsthatRMShasbeen establishedasthe7defaultfacilityinthecurrentsession.Bwvx<OSETKEY*AsPOSetsandlocksthekey-definitionstateforkeysdefinedwith#O(the DEFINE/KEYcommand.L"OFormatOsSETKEY% O DescriptionEOsUsingthe DEFINE/KEYcommandyoucancreateasmanyNO definitionsforakeyasyouwant.)However,each definitionDO$ofthekeymustbeassignedaseparatecontextorR$state$.(ForOO|example,ifyoucreatefive definitionsforthePF4keyyouPOmustcreatefive differentstates,oneforeach definitionofSO-thekey.*Ifyoudonotspecifyitsstatebeforeyouprocessa@O definition,the definitiondoesnottakeeffect.GO!TheSETKEYcommandletsyouswitchfromthecurrentSOzstatetoanyotherstate;youthencanusethekey definitions$Ocreatedforthatstate.: O QualifiersOs/LOG (default)O/NOLOGJO$Controlswhetherthesystemdisplaysamessage indicatingPO|thatthekeystatehasbeenset.(/LOGcausessuchamessage9Otobe displayedand/NOLOG suppressesit.K! K!O/STATE=state-nameO(/NOSTATE (default)SO Specifiesthenameofthestatetobeset.(ThestatenamecanOObeany alphanumericstring.'Ifyouomitthe/STATE qualifierGO2oruse /NOSTATE,thecurrentstateisleft unchanged./OExamples O1. VDE>SET%KEY/STATE=GOLDCTheSETKEYcommandinthisexamplesetsthekeyKTstatetoGOLD.Youcannowusethekey definitionsthat.aredefinedfortheGOLDstate.txwy@OSETLIBRARY*yOOOConnectsthecurrentVDEsessiontoa specifiedVDElibrary.Z0OFormat OsSETLIBRARYMdir-spec! DO ParameterOsdir-specNOThenameoftheroot directoryofaVDElibrary.*TherootMO$ directoryisthedisk directorythatcontainsthe library'sNO| database.'VDEconnectsthecurrentVDEsessiontothespec-NOifiedlibrary.'UsetheOpenVMS directory specificationformat'O-tospecifythis parameter.JOVDEalsoacceptsmnemonicnamesforthe libraries,basedRO!onthecontentsofvariouslogicalnames,andthelistofli-JOzbrariesandthe particular mnemonicscanbetailoredforRO individualusers,forgroupsofusers,andcanbe defaultedon O+a system-widebasis.d :O DescriptionBOsTheSETLIBRARYcommand disconnectsyourVDEses-LOsionfromthecurrentVDElibraryandconnectsittotheKO$VDElibrarywhoseroot directoryormnemonicyouspecify.LO| SubsequentVDEcommandsthenactonthe specifiedlibrary.=LOToconnecttothe specifiedlibrary,theSETLIBRARYcom-IOmandfirstdefineslogicalname VDE$LIBRARYtopointtoOO5the specified directory.+Itthenconnectstothelibraryyou/O specifiedandreadsits database.%! GOBasedonthe information containedintheVDElibraryQO database,VDEcheckstoseeifyouare authorizedtousetheRO5newlibrary.'Ifyouare presentlylistedasan authorizeduserXOofthelibrary,ifthelibraryissettoallowthe automaticaddi-NOtionofusers,orifyoushouldpossesstheOpenVMSBYPASSJO> privilege,VDEpermitsaccess,andyoucancontinueyour!OVDEsession normally.KO UseoftheOpenVMS privilegeoverrideisaudited,andan6O informationalmessagewillbe displayed.COVSCalsosupportstheSETLIBRARYcommand,butit3OdefaultstotheOpenVMSVAXlibrary. ^S0Ia AutomaticLibraryFormat Conversion ^SAThiscommandcancausean automaticlibrarycon-C>versioniftheformatoftheVDElibrarypredatesDtheversionofVDE currentlyinuse.+ Automaticli-Hbrary conversionwillonlybe performedifthelibrary@Hhasthe automatic conversionoptionenabled.,See4theSHOWLIBRARY,CONVERTLIBRARYand/theMODIFYLIBRARY/[NO]AUTO_CONVERTR commands.  WPOShouldthe filename,file extensionand/orfileversionnumberLObe erroneously specifiedinthe parameter,theSETLIBRARYHO5commandwillsilentlyignorethem.,OnlythedeviceandIO directoryspecificationsaregermanetothecommand;theMO appropriatefilenameandfile extensionwillbeappendedto5O>thedeviceand directoryspecification.y OKOForfurther informationon mnemonics,seethe VDE$LIBRARY_6O DEFAULTS,VDE$LIBRARY_DEFAULTS_LABELS,and9O5VDE$LIBRARY_DEFAULTS_MNEMONICSlogicalnames.OOToseethelistof mnemonics available,andthe translationsFO associatedwitheach,usethe followingDCL commands: :OIftheVDE$LIBRARY_DEFAULTS_MNEMONICSlogicalIOnameisdefined,SETLIBRARYcommandsare availableviaO5keyboard  T 2F17 ;T K =5, i iT u2F18 T iK 5, " "T -2F19 T "K 5and k kT w2F20 T kK%5keys.+Uptotwelvekey-OOboard definitionscanbepresent, dependingonthenumberof:O translationsofVDE$LIBRARY_DEFAULTS_MNEMONICSHO>present;thefirstfour mnemonicsare availableinthe> default4Okeypadstate,thesecondfourinthee gold!state,andthethirdOfourinthe bluestate. Ot $IO $!%These%logical&names&can%be% (re)defined%in%the%site-IO $!%specific%VDE%system&startup%command% procedure,&or&onFOL $!%a& process-,%job-,%group-%or%system-specific&basis. O $HO $!%Each&logical%name%is%a&search%list,%and%the&firstCO$ $!%entry%in%VDE$LIBRARY_DEFAULTS% corresponds%to%theDOl $!%first%entry%in%VDE$LIBRARY_DEFAULTS_MNEMONICS,&and4O $!%in%VDE$LIBRARY_DEFAULTS_LABELS,&etc. O $!BOD $!%Display&the%list&of&known/predefined% libraries:0O $&SHOW%LOGICAL%VDE$LIBRARY_DEFAULTS O $=O $!%Display&the%mnemonic%name&of&each%library:Od $&SHOW%LOGICAL%VDE$LIBRARY_DEFAULTS_MNEMONICS O $&SET%LIBRARY&DEV$:[PROJDIR] VDE>KNThisexampleconnectstheVDEsessiontotheVDElibraryFwhoseroot directoryisDEV$:[PROJDIR].All subsequentDVDEcommandsactonthatlibraryuntilthecurrent&Xlibraryisagainchanged.yxz<OSETLOG*g==ORecordsVDEinputandoutputinalogfile.Y/OFormatOsSETLOGM [file-spec]FO ParameterOs file-specOOThenameofthelogfiletobecreated.*All subsequentVDETO$inputandoutputisrecordedinthisfileuntilloggingisdis-O|abled.@| File-spec7|isanyvalidOpenVMSfilespecification.SOThedefaultfile extensionisLOG.Ifthefile specificationisAO-omitted,thedefaultfilenameisVDELOGFILE.LOG.0 O DescriptionKOsTheSETLOGcommandrecordsallVDEinputandoutputinSOthe specifiedlogfile.)Inputisrecordedasentered.)OutputisPO$recordedwithaleading exclamationpoint( ! ).)BecausetheIO| exclamationpointistheVDEcomment character,youcanPOusethelogfileasacommand proceduretoreruntheloggedDO-VDEsession.+UsetheCANCELLOGcommandtodisable&Oinputandoutputlogging.M#O QualifiersOs None. OExamples O1. VDE>SET%LOG%MYLOG VDE>SHOW%LOG= Output%logging%on%file:%DEV$:[MYDIR]MYLOG.LOG;1e VDE>>TheSETLOGcommandcreatestheVDElogfile;,[MYDIR]MYLOG.LOG.All subsequentcommandsandHtheiroutputsarerecordedinthisfile.*TheSHOWLOGMcommandconfirmsthatoutputisbeingloggedtothisfile.(|p !OTable3-5:8 Privileges O OF PrivilegebF Description Ob OBUILDGbPermitsausertocreatebuildjobsinthislibrary.OO$CRECTXAllowsausertocreate,modify,anddelete contexts.KOCREFACAllowsthecreationand modificationof facilities.YOCREGRPPermitsthe creation, modification,andthedeletionofgroups.HOCREMODAllowsthecreationand modificationofmodules.\O CRESCRPRequiredforthe creation, modification,anddeletionofscripts._OCRESTEPAllowsthe creation, modification,andthedeletionofbuildsteps.JOCRESTRMxPermitsthecreationand modificationofstreams.XOxCREUSRPermitsthe creation, modification,andthedeletionofusers.8ODELFACAllowsthedeletionof facilities.5OlDELMODAllowsthedeletionofmodules.;ODELREPPermitsthedeletionof replacements.5O_DELSTRM~Permitsstreamstobedeleted.YOFROZENAllowstheusertopeplacemodulesintostreamsmarkedfrozen.]OSMODLIBAllowstheusertomodify attributes associatedwiththislibrary.:OMODSTRMXAllowsthe modificationofstreams.HOF PERFREPAllowstheusertodequeuequeued replacements.cO RESREPAllowstheusertoreserveandreplacemodules,andto manipulatefoldb records.ZO UNCLOSE~Permitstheusertoopenastream currentlymarkedasclosed.TO USERNAME.Allowstheusertoreserveandreplaceforotherusers.)O  Aggregate Privilege Keywords:lO ADMINThe privilegesusually associatedwithaproject administrator privileges;allofTbX the above-listed privilegesexceptDELFAC,DELMOD,DELREP,DELSTRM, b FROZEN,andUNCLOSE. O+ ALLb+ All privileges.O NONEb No privileges. O ~zy{AOSETNOVERIFY*A\IODisablesthedisplay(orecho)ofcommandinputtotheO( terminal.Q'OFormatOsSETNOVERIFYM#O ParametersOs None.>O DescriptionGOsTheSETNOVERIFYcommanddisablesthedisplayofcom-QOmandinputtothe terminal.)ItcancelstheeffectoftheSET;O$VERIFYcommand.+TheSETNOVERIFYandCANCEL,O|VERIFYcommandsare equivalent.M#O QualifiersOs None.J g OExamples O1. VDE>SET%VERIFY VDE> SHOW%MODULE&MOD1.FOR  SHOW&MODULE%MOD1.FOR!e Module%[FACIL]MOD1.FOR VDE>SET%NOVERIFY SET%NOVERIFY< VDE><SHOW%FACILITY%FACIL Facility%FACIL VDE>?;TheSETVERIFYcommandenablescommandechoing.? Therefore,theSHOWMODULEcommandis displayedLontheterminalbeforetheoutputofthecommandisdis-@Eplayed.+TheSETNOVERIFYcommandisalsoechoedIbutthecommanddisablesthedisplayof subsequentcom-Amands.(TheSHOWFACILITYcommandthatfollowsisLNnotechoedonthe terminal;onlyitsoutputis displayed.}{~?OSETPROMPT*AaJOChangestheVDEpromptstringfromVDE>toastringofO(yourchoice.^4OFormat$OsSETPROMPTM prompt-stringH! O ParameterOs prompt-stringRO Specifiesthestringthatistobecomethenewprompt.)IftheRO$stringcontainsblanks,special characters,or lowercaseletters,9O|youmustencloseitin quotationmarks( |" >|).O DescriptionDOsTheSETPROMPTcommandletsyoutochangetheVDE.Oprompttooneofyour choosing.7 OExamples O1. VDE>(SET%PROMPT%"Hello&Dolly:%" Hello%Dolly:HIInthisexample,theVDEpromptischangedto``HelloH Dolly:''.-VDEusesthisstringtopromptforthenextcommand.~}?OSETSTREAM*HHO Establishesthedefault developmentstreamforthecur-LO(rentVDEsession.( Specifyingastream determinesthegroupHO definitionsandmodule-dependencydataVDEusesfortheGOcurrentsession:*group definitionsandmodule-dependencyIO2dataarestream-specific., EstablishingthedefaultstreamDOalso determineswhatstreamcommandssuchasCREATE=OGROUP,SHOWGROUP,COMPILE,andBUILDoperateHO<on;thosecommandsexecuteonlyinthedefaultstream.HOThedefaultstreamalsocanbe specifiedwiththeSETO/CONTEXTcommand.\2OFormat"OsSETSTREAMM stream-name yO ParameterOs stream-nameQO SpecifiesthenameofthedefaultstreamfortheVDEsession.M#O QualifiersOs None.]OExamples O1. VDE>SET%STREAM%V5.3-FT2 VDE>SHOW%DEFAULTS?" Library&LIBNAME%in%root% directory%DEV$:[PROJDIR].j Default& directory%is% DEV$:[SMITH]$ Current&session%context:'D Default&stream%is%V5.3-FT2$DB Default&facility&is&RMS VDE>?TheSETSTREAMcommand establishesstreamV5.3-EQFT2asthecurrentstreamfortheVDEsession.,The=SHOWDEFAULTScommandshowsthatV5.3-FT2hasAbeensetasthedefaultstreamforthesession. ~AOSETTERMINAL*! AbQOChangesthelinewidthandpagesizethatVDEusestoformatO(output.Q'OFormatOsSETTERMINALM#O ParametersOs None. FO DescriptionCOsTheSETTERMINALcommandsetsthenumberofchar-NOactersperlineandthenumberoflinesperpagethatVDESO$usestoformatoutput.'ItdoesnotchangethesettingsofyourLO| terminal.+Thedefaultlinewidthandpagesizearedeter-IOminedbyyourdevicetypeorbythelastSETTERMINAL5O-commandyouenteredattheDCLlevel.O QualifiersOs/PAGE=nCO Specifiesthenumberoflinesonapage.)Normally q nis24orQO$thepagesizeofyour workstation,butyoucanuseanyvalueO|from11to100.! O/WIDTH=nGO( Specifiesthemaximumnumberof charactersonaline.O Typically  nGis80or132butyoucanuseanyvaluefrom20toO255.rOExamples O1. VDE>!SET%TERMINAL/WIDTH=132KThiscommand specifiesthatthelengthofalineis132Y characters.G?OSETVERIFY*! A^POEnablesthedisplay(orecho)ofcommandinputtothetermi-O(nal.O%OFormatOsSETVERIFYM#O ParametersOs None. xO DescriptionGOsTheSETVERIFYcommandenablesthedisplayofcommandOOinputtothe terminal.)ThisdisplayisusefulwhenyouwantHO$toseethecommandsissuedbyacommand procedurebe-PO|foretheyare executed.(Youcandisablethedisplaywiththe5OCANCELVERIFYorSETNOVERIFYcommand.M#O QualifiersOs None. OExamples O1. VDE>SET%VERIFY VDE>@X.VDE @X.VDEe SET%FACILITY%COPY SHOW&MODULE%FOO  Module%[FACIL]FOO.MAR< VDE><TheSETVERIFYcommandenablescommandecho-Ging.' Therefore,thenextcommand(@X.VDE)is displayedB\onthe terminal.*ThenaSETFACILITYandaSHOW>MODULEcommandarereadfromthecommandpro-A cedureX.VDE.Bothcommandsare displayedonthe@f terminal.(TheoutputoftheSHOWMODULEcommand.followstheechoedcommandline. FOSHOW ARCHITECTURE*JOShowsoneormore architecturetableentriesintheVDE8O( database.'Each architecturetableentry...=O ARCHITECTUREsupportisnotfully implemented.tJOFormat:OsSHOW ARCHITECTUREM arch-name[, arch-name...] O ParameterOs arch-nameJOThenameofthe architecturetobe displayed.+ThisnameMO$maybeupto39 characterslongandmustfollowVDEnameO|syntax._5O Description OsUnderConstruction...nDO QualifiersOs/BRIEF OUnderConstruction...\A2O/CURRENT O(UnderConstruction...YA/O/FULL O(UnderConstruction...\A2O/OUTPUT= O(UnderConstruction...ZA0O/TOTAL O(UnderConstruction...\~OExamples O1. VDE>$SHOW% ARCHITECTURE&VAXPDP VDE> CUnderConstruction...>COSHOW BUILD_JOB*xNNODisplays informationaboutoneormore specifiedbuildjobs.wMOFormat=OsSHOW BUILD_JOBM [stream-name[,stream-name...]] O ParameterOs stream-nameDOThenameofa developmentstream.- InformationaboutPO$oneormorebuildjobsinthisstreamis displayed.*UsetheKO|/IDENTIFICATION qualifiertospecifythebuildjobstobeNO displayed.,Ifyoudonotspecifythis qualifier, informationPO-aboutthemostrecentbuildjobforthestreamis displayed.QOYoucandisplaybuildjobsformorethanonestreambyusingJO!wildcard charactersinthestreamname.*ThepercentsignROz( % )inanamematchesanysingle characterintheposition-Oitoccupiesandtheasterisk( [*+)matcheszeroormorechar-TO+actersinthepositionit occupies.)Buildjobsare displayedforFOthosestreamswhosenamesmatchthewildcardpattern.NOIfyouomitthe stream-name# parameter,VDEdisplaysKO informationaboutoneormorebuildjobsforthedefaultO5stream. FO Description>OsTheSHOW BUILD_JOBcommanddisplays informationNOabout specifiedbuildjobs.,Youcanspecifybuildjobswith O$the$ stream-name.$ parameterandthe/IDENTIFICATIONGO| qualifier.(Bydefault,theSHOW BUILD_JOBcommanddis-QOplays informationaboutthemostrecentbuildjob belongingtoO-thedefaultstream.nAOTheSHOW BUILD_JOBcommanddisplaysthe following-O informationforeachbuildjob:v `m%mitsidentificationnumber `itsstreamname `llitsstatus MO Optionally,thecommandcanalsoshowallother informationPO availableintheVDEdatabaseaboutthebuildjob, including:#!  `mJmthenumberofbuildstepsineachstate(thenumberofIstepsthatarenotyetstarted,arerunning,havecom-Ipletedwitherrors,andhave completed successfully)and<wthetotalnumberofbuildstepsinthejob `2thetypeofbuild,fullorminimal `vvtheremarkstring `Cthenameofthepersonwhostartedthebuildjob `t<tthenumberofbuildstepsinthebuildjob `Rthedatesandtimesof transitionsforthebuildjob(forex-JLample,whenthejobwasenteredonthe executionqueue,5whenitstarted,andwhenitstopped)NMOThecommandcanalsodisplaythelistofbatchqueuesandSOprocesscountsusedtorunthebuildjob,anditcanshowall8O5buildstepsthatmakeupthebuildjob. PkO QualifiersOs/BEFORE=date-timeSODisplaysonlythosebuildjobscreatedbeforethe specifieddateLO$andtime.*ThedateandtimecanbestatedusingstandardJO|OpenVMS date-timeformatorcanbeoneofthe following?O keywords:* YESTERDAY,TODAY,or TOMORROW.IfyouLO-useaspacetoseparatethedatefromthetime,rememberOOtoenclosetheentire date-timestringindoublequotes.*ForEOfurther informationabout specifyingOpenVMS date-time4O7format,seetheOpenVMSDCL Concepts.! KO/BRIEF (default)O(/SUMMARYO/FULLOO Determinesthetypeof information displayedabouteachbuildO2job.JOThe/BRIEF qualifierdisplaysthe build-jobidentificationIOnumber,thestreamname,andstatusofeachbuildjob.K !DOThe/SUMMARY qualifierdisplaysthe informationpro-ROvidedbythe/BRIEF qualifier,butitalsodisplaysthenumberSO5ofbuildsteps currentlyineachstate(thatis,thenumberofNOstepsthatarenotyetstarted,arerunning,have completedKOwitherrors,andhave completed successfully)sothatyouIO>canfollowtheprogressofthebuildjob.+The/SUMMARYVO qualifieralsoprintsthetotalnumberofstepsinthebuildjob.[1NOThe/FULL qualifierdisplaysall informationinthedatabaseMOaboutthebuildjobexceptqueue informationand build-stepGO5 information.,(Toseequeue information,usethe/QUEUEOO qualifier;toseestep information,usethe/STEP qualifier.)NJOSeetheExamplesectionofthiscommandforsampleout-GOputofthe/BRIEF, /SUMMARY,and/FULL qualifiers.*OfCO5/BRIEF,/SUMMARYand/FULL,/BRIEFisthedefault.! "O/IDENTIFICATION=id-rangeRO( Specifiesthe build-jobidentificationnumbersofthebuildjobs>Otobe displayedforthe specifiedstream.)Theid-range pa-SOrametercanbeasingleintegervalue,arangeof integers,orSO2awildcard character.&Ifthe parameterisasingleinteger(forJOexample, /IDENT=5),VDEdisplaysthebuildjobwiththatQOidentificationnumber.'Ifthe parameterisarangeofintegersLO< (specifiedastwo build-jobidentificationnumbers separatedSObyacolonasin /IDENT=3:5),VDEdisplaysallbuildjobswithFOidentificationnumbersinthatrange.'Finally,iftheid-range7OE parameterisanasterisk(asin/IDENT= Q* /E),VDEdisplaysall3Obuildjobsforthe specifiedstream.! WROIfyouspecifyazeroornegative build-jobidentificationnum-Oberintheid-range4C parameter,thatnumberisrelativetoRO5theidentificationnumberofthemostrecentbuildjobforthePOstream.+Forexample,ifthemostrecentbuildjobisjob5,FOthen/IDENT=0is equivalentto/IDENT=5and /IDENT=-1'O>is equivalentto /IDENT=4.FOIfyoudonotusethe/IDENTIFICATION qualifier,VDEOOdisplaysthemostrecentbuildjobforthe specifiedstream.\K2O/QUEUEOO(Displaysqueue informationforthe specifiedbuildjobs.)ThisLO informationincludesthenameofeachbatchqueueusedtoQOrunthebuildjob,theprocesscountforeachqueue,andthe6O2totalprocesscountforthebuildjob.UO/SINCE=date-timeRO(Displaysonlythosebuildjobscreatedafterthe specifieddateLOandtime.*ThedateandtimecanbestatedusingstandardJOOpenVMS date-timeformatorcanbeoneofthe following?O2 keywords:* YESTERDAY,TODAY,or TOMORROW.IfyouLOuseaspacetoseparatethedatefromthetime,rememberOOtoenclosetheentire date-timestringindoublequotes.*ForEO<further informationabout specifyingOpenVMS date-time4Oformat,seetheOpenVMSDCL Concepts. ]*O/STATUS=(status[, status...])MO(Displaysonlythosebuildjobsthathaveoneofthespec-&Oifiedstatusvalues.-Eachstatus" parametermustbeoneOofthe following keywords:- NOTSTARTED,RUNNING,OSUCCESS,orERRORS.&  N%OIfyouspecifyonlyonestatus& parameter,the parentheses/Omaybeomitted.(Ifyouomitthestatus! parameters,allbuildAO5stepsinthe specifiedbuildjobsare displayed.  O/TOTALMO(Showsthetotalnumberofbuildjobsthatmatchthespec-JOified constraints.,These constraintsarethestreamname,LOtherangeofbuildjobidentificationnumbers specifiedbyKO2the/IDENTIFICATION qualifier,thebuildjobstatusvaluesNO specifiedbythe/STATUS qualifier,andthetime constraintsHO specifiedbythe/BEFOREand/SINCE qualifiers.+Noin-OO< formationaboutthe individualbuildjobsisshown;onlytheSOtotalcountis displayed.'AseparatecountisprovidedforeachO stream-name parameter.4  OExamples O1. VDE>SHOW% BUILD_JOBI Build%job%11%for&stream%MAIN&has% completed%with%errors VDE>GThisexampleshowsthebriefformoftheSHOWBUILD_JJOBoutput.(Thebuildjobidentificationnumber(11)andK<streamname(BL22)ofthebuildjobare displayed,alongLwiththestatusofthejob (suspended).'BecausenostreamCnameor/IDENTIFICATION qualifieris specifiedwithIFthecommand,themostrecentbuildjobforthedefault streamis displayed. O2. VDE>!SHOW%BUILD_JOB/SUMMARYI_ Build%job%11%for&stream%MAIN&has% completed%with%errors6D Number%of%build%steps%not&yet%started:  07D Number%of% currently&running%build%steps:  0C}ThisexampleshowsthesummaryoutputoftheSHOWA BUILD_JOBcommand.,Inadditionto identifyingtheK.buildjob,theoutputshowshowmanybuildstepsareinPeachstateandgivesthetotalnumberofbuildstepsintheKjob.)Inthisexample,onestep completedwitherrorsand58 allothersteps completed successfully. O 3. VDE> SHOW%BUILD_JOB/FULLI Build%job%11%for&stream%BL22&has% completed%with%errors6D@ Number%of%build%steps%not&yet%started: @ 07D Number%of% currently&running%build%steps:  0@ThisexampleshowsthefulloutputoftheSHOWA BUILD_JOBcommandforthebuildjobusedintheopreviousexample. O4. VDE>/SHOW%BUILD_JOB/QUEUE&V2.0-3/IDENT=2R4 Build%job%2%for%stream&V2.0-3%is%not%yet&queued%for% executionGD| Batch%queues%to%run&20& processes%for%this%build%job:C Submit%3% processes%(scaled%from&1)&on&queue&QUE_AC  Submit%7% processes%(scaled%from&3)&on&queue&QUE_BCT Submit%2% processes%(scaled%from&1)&on&queue&QUE_CC Submit%8% processes%(scaled%from&4)&on&queue&QUE_D, VDE>EThisexampledisplaysbuildjob2 (specifiedbythe@/IDENTIFICATION qualifier)forstreamV2.0-3.+TheGL/QUEUE qualifierdisplaysthenamesandprocesscountsSofthebatchqueuesusedtorunthebuildjob.'Atotalof20P processeswillrunthebuildjob, distributedoverfourbatchVqueues. O5. VDE>$SHOW% BUILD_JOB& BL22/STEPQ Build%job%11%for&stream%BL22&is&not%yet%queued&for% execution=Dc Build%steps%that&are%part&of&the%build%job:= Compile&step%for& [CODE]FOO.MAR%is%not&started: Link&step%for& [CODE]FOO.EXE%is%not&started4D; Number%of%build%steps% displayed&is&2 VDE>F9Thisexampledisplays informationforthemostrecentHbuildjobinstreamBL22.+The/STEP qualifierdisplaysKbuildstep information.*TwostepsarepartofthisbuildJCjob:(acompilestepformoduleFOO.MARandalinkstepHformoduleFOO.EXE.Thenumberofbuildstepsisalsoshown. Ol6.r VDE>3rSHOW%BUILD_JOB/TOTAL&*/IDENTIFICATION=*6 Number%of%build%jobs%for%stream&*:&14 VDE>HpThe/TOTAL qualifierdisplaysthenumberofbuildjobsPthatmatchthe selection criteria,inthisexample,allbuildN!jobsforallstreams.*Thereare14suchbuildjobsinthezVDE database. AOSHOWCONTEXT*0 NODisplaysthenamesand definitionsofoneormore specifiedQO( contexts.)Acontextcanbeusedtospecifythedefaultdevel-POopmentstream,default architectureanddefaultfacilityforaOVDEsession.oEOFormat5OsSHOWCONTEXTM [ctx-name[, ctx-name...]]W :-O ParameterOsctx-nameOOThenameofacontextwhose attributesaretobe displayed.MOfYoucandisplaymorethanonecontextusingwildcardchar-MOacters.,Thepercentsign( % )inacontextnamematchesPOanysingle characterinthepositionitoccupiesandtheas-Opterisk( \|*Gp)matcheszeroormore charactersinthepositionitHO occupies.*Thosecontextswhosenamesmatchthewildcard"O!patternare displayed. NMOIfno parameteris specifiedforthecommand,VDEdisplaysSOthe definitionsofallcontextstowhichyouhaveaccess.&ThesePO5includeallpubliccontextsandallofyourprivate contexts.! FO DescriptionJOs Dependingonthe qualifiersyouselect,theSHOWCONTEXTKOcommandcandisplaythe following:*thenameonlyofeachPO$selectedcontext;thenameandthedefaultsettings associatedNO|withthecontext;orall informationaboutthecontext.*TheJOcommandalsocanshowthetotalnumberofcontextsthat1O-matchacontextnamespecification.x! NO QualifiersOs/ALL (default)O/PRIVATEO$/PUBLICRO|Controlswhetherpublic,private,orallcontextsare displayed.NOThe/PRIVATE qualifiercausesVDEtodisplayonlyyourpri-IO-vatecontextsthatmatchthe context-name parameter.(TheOO/PUBLIC qualifiercausesVDEtodisplayonlythepubliccon-KOtextsthatmatchthe parameter.)The/ALL qualifiercausesKO7VDEtodisplaybothyourprivatecontextsandthepublic0Ocontextsthatmatchthe parameter.oEEOOf/ALL,/PRIVATEand/PUBLIC,/ALListhedefault. ^tO/BRIEFO(/NORMAL (default)O/FULLHO Determinesthe informationthatis displayedabouteachOO2context.+The/BRIEF qualifierlistsonlythetype(publicorJOprivate)andnameofeachcontext.(The/NORMAL qualifierOOdisplaysthename,type,anddefaultsettings associatedwithKO<eachcontext.)The/FULL qualifierliststhesameinforma-OOtionasthe/NORMAL qualifierandalsothecreationdateofOOthecontext,aremarkstring,andthenameoftheuserwho OEcreatedthecontext.q GGOOf/BRIEF,/NORMALand/FULL,/NORMAListhedefault. rO/TOTALLO(Showsthetotalnumberofcontextsthatmatcheachparam-NOeter.)Other informationaboutthe individualcontextsisnot=Oshown.,Aseparatecountisprovidedforeachctx-nameGO2 parameter.,Wildcard charactersareusuallyusedinthe2O parameterwhenusingthis qualifier.! OExamples O1. VDE>SHOW% CONTEXT/BRIEF0 Context&BAR%(public&to&all%users)6 Context&DEFAULT%(private%to%user%SMITH)4e Context&DEFAULT%(public%to%all%users)2 Context&FOO%(private%to%user&SMITH)5 Context&NEWCTX%(private%to%user&SMITH)3< Context&PUBCTX%(public&to&all%users) VDE>?ThisexampleshowsthebriefformoftheSHOWALCONTEXToutput.+Onlythecontextnamesandtypes0(publicorprivate)are displayed. O2. VDE>SHOW%CONTEXT%PUBCTX3d Context&PUBCTX%(public&to&all%users)%D Default&stream%is%V2.0-1%D Default&facility&is&EXEC VDE>@ThisexampleshowsthenormalformoftheSHOWBKCONTEXToutput.'ThecommanddisplaysthenameandKtypeofcontextPUBCTXanditshowsthedefaultsettings) associatedwiththecontext. Ou3.z VDE>+zSHOW%CONTEXT/FULL/PRIVATE%V3RMS4 Context&V3RMS&(private&to&user%SMITH)&D Default&stream%is%V3.1-FT$DR Default&facility&is&RMSDD Context&added&to&database&on& 19-APR-1989& 09:08:20.92FD Context&added&to&database&by&user%SMITH%(Jane%Smith).D* Remark:&Version%3.1&of&RMS%code VDE>B( TheSHOWCONTEXTcommanddisplaysthefulloutput' forprivatecontextV3RMS. O 4. VDE>  SHOW% CONTEXT/TOTAL%*5F Number%of%contexts%matching%name%*:%6 VDE>H The/TOTAL qualifierdisplaysthetotalnumberofcon-FU textsinthe database./Becausethe/ALL qualifierisL  specifiedbydefault,thiscountincludesbothallprivateHcontextsforthecurrentuserandallpublic contexts. BOSHOWDEFAULTS*nDDODisplaysthedefaultsforyourcurrentVDEsession.R(OFormatOsSHOWDEFAULTSM #O ParametersOs None.!! UO DescriptionDOsTheSHOWDEFAULTScommanddisplaysthenameoftheNOcurrentVDElibrary,thecurrentdefault directory,thecur-RO$rentcontext,thedefaultstream,andthedefault facility.'YouSO|can establishthedefaultstreamandfacilityatonetimeusing?OtheSETCONTEXT/DEFAULTcommand,youcancre-GO-atemultipledefaultcontextsusingCREATECONTEXTandDOMODIFYCONTEXT,andyoucanset individualdefaults?OwiththecommandsSETSTREAMandSET FACILITY.M"#O QualifiersOs None.p#!  FOExamples O1. VDE>SHOW%DEFAULTS? Library&LIBNAME%in%root% directory%DEV$:[PROJDIR]. Default& directory%is% DEV$:[SMITH]6e Context&DEFAULT%(private%to%user%JONES)%D Default&stream%is%V2.0-1%D Default&facility&is&EXEC VDE>KThisexampleshowsthatthedefaultstreamisV2.0-1andKLthecurrentdefaultfacilityisEXEC.ThesesettingscomeHfrom(andare identicalto)contextDEFAULT,acontextKprivatetothecurrentuser.'ThecurrentVDElibraryandAUthecurrentdefault directoryarealso displayed. O2. VDE>SHOW%DEFAULTS? Library&LIBNAME%in%root% directory%DEV$:[PROJDIR].] Default& directory%is% DEV$:[SMITH]$ Current&session%context:%D Default&stream%is%V2.0-1$D5 Default&facility&is&RMS VDE>E4ThiscommandshowsthatthedefaultstreamisV2.0-M1andthedefaultfacilityinthecurrentsessionisRMS.KThesesettingsdonotcomefromaspecificnamedcontextJ= because individualsettingshavechangedeithersincetheE lastSETCONTEXTcommandorsincethestartofthe VDEsession.C$OSHOW DEVELOPER*%&COShowsthecurrentsettingsofthe developerflags.COkUsethiscommandonlyundertheexplicit directionBOof,andwiththe assistanceof,aVDE developer.S')OFormatOsSHOW DEVELOPER_(5O Description OsUnderConstruction...)6sOExamples O1. VDE>SHOW% DEVELOPER Under%Construction... VDE>_&C*OSHOW DIRECTORY*+, AQODisplays directory templatesforthedefaultstreamorforthe0O(currentVDE library'sdeltafiles.S-)OFormatOsSHOW DIRECTORY.! O DescriptionBOsTheSHOW DIRECTORYcommanddisplays directorytem-FOplatesfromtheVDE database.. Directory templatesareHO$definedwiththeSET DIRECTORYcommandandspecifytheMO|namesthatVDEshouldassigntodisk directorieswhencre-KOating directoriesfornewstreamsor facilities.+TheSHOWGO- DIRECTORYcommanddisplaysthe directorycreationflagsROforthedefaultstream,thetemplateforthestream(ordelta-MOfileor staging-area)root directory,thetemplateforeachOO7stream subdirectory,thetemplateeachfacilityroot directoryQO(ifany),andthetemplateforeachfacility subdirectory.(YouQOcanusethe /FACILITY qualifiertolimitthedisplaytothose=OA templatesthatapplytoa specified facility.IOFor additional informationon directory creation,andonO4 directorysymbols(4 dir-symbol)4)and directorysymbolpro-Ocessing,seeCANCEL DIRECTORY,SET DIRECTORY, ?andOScript Functions.*.P\?*.P?c*.OLOd/! P:O QualifiersOs/BRIEF (default)O/FULLNO$ Determinesthe informationthatis displayedforeachdirec-KO|tory template.+The/BRIEF qualifierdisplaysthe directoryOO specificationandthe directorysymbolforeach template.'TheJO-/FULL qualifierliststhesame informationasthe/BRIEFPO qualifier,butalsoshowsthecreationdateofeach directoryPO template,thenameoftheuserwhocreatedthe template,and*O7the template'sremarkstring.k0AAOOf/BRIEFand/FULL,theformeristhedefault. 1 O /DELTA_FILESO(/STAGINGO/STREAM (default)HO Determineswhether directory templatesforthe library'sQO2deltafiles,itsstagingarea,orthedefaultstreamaredis-KOplayed.(The /DELTA_FILES qualifier specifiesthat directoryQO templatesfortheVDE library'sdeltafiles(CMS libraries)beLO< displayed.*The/STAGING qualifier specifiesthatthedirec-POtorytemplateforthe library's staging-arearoot directorybeOO displayed.((Stagingareasholdfilesforqueuedreplacements.)MOEThe/STREAM qualifier specifiesthat directory templatesfor.Othedefaultstreambe displayed.2XAOOf /DELTA_FILES,/STAGINGand/STREAM,/STREAMisOthedefault.^3 K4O/FACILITY=fac-nameRO( Specifiesthatonlythose directory templatesthatapplytothe"Ofacilitygivenbythe-fac-name' parameterbe displayed.*IfQOthis qualifierisomitted,VDEdisplays directory templatesforO2all facilities.E4 POYoucandisplay directory templatesformultiple facilitiesby.Ousingwildcard charactersinthefac-name parameter.'TheRO5percentsign( % )inanamematchesanysingle characterinplatesforthose facilitieswhosenamesmatchthewildcard"Opatternare displayed.5 :#`OExamples O1. VDE>SHOW% DIRECTORY= Directory-creation% templates&for%stream%V2.1-1:%D Directory%creation%flags:He Do%not%defer%creation%of% directory&tree%for& substreams@ Do%not%prompt&for%root& directory%for% substreams=D< Stream%root% directory%is% [.V2_1-1]&by&default6 Subdirectory:p [.VDE$BLD]%(symbol&VDE$BLD)=D Directory% templates&for% unspecified% facilities:.\ Subdirectory:p[.OBJ]&(symbol%OBJ). Subdirectory:p[.SRC]&(symbol%SRC)6 Subdirectory:p [.VDE$COM]%(symbol&VDE$COM)64 Subdirectory:p [.VDE$LOG]%(symbol&VDE$LOG)AD All%other% directories%created%using%default&rulesT VDE>AThisexampleshowsthebriefoutputoftheSHOW8 DIRECTORYcommand..ThiscommandshowstheGt directory templatesforthedefaultstreambecausethe7/STREAM qualifierisassumedbydefault. OD2.D VDE>%DSHOW%DIRECTORY/DELTA_FILES; Directory-creation% templates&for%delta%files:BD Delta-file&root% directory&is& [.VDE$CMS]%by%defaultADd All%other% directories%created%using%default&rules VDE>Ac ThisexampleshowsthebriefoutputoftheSHOW5  DIRECTORYcommandwhenthe /DELTA_FILESE  qualifieris specified.,Thecommandshowsthedirec-Ll tory templatesfortheVDE library'sdeltafiles(itsCMS  libraries). O= 3.= VDE>&= SHOW%DIRECTORY/FACILITY=RMS= Directory-creation% templates&for%stream%V2.1-1:%D Directory%creation%flags:H Do%not%defer%creation%of% directory&tree%for& substreams@] Do%not%prompt&for%root& directory%for% substreams=D Stream%root% directory%is% [.V2_1-1]&by&default65 Subdirectory:p [.VDE$BLD]%(symbol&VDE$BLD)=D Directory% templates&for% unspecified% facilities:.  Subdirectory:p[.OBJ]&(symbol%OBJ).U Subdirectory:p[.SRC]&(symbol%SRC)6 Subdirectory:p [.VDE$COM]%(symbol&VDE$COM)6 Subdirectory:p [.VDE$LOG]%(symbol&VDE$LOG)3Dt Directory% templates&for%facility%RMS:' Root& directory:% [MYDIR.RMS]4 Subdirectory:p[.ANA]&(symbol% ANA_FILES).L Subdirectory:p[.COM]&(symbol%COM). Subdirectory:p[.SRC]&(symbol%SRC)6 Subdirectory:p [.VDE$COM]%(symbol&VDE$COM)6$ Subdirectory:p [.VDE$LOG]%(symbol&VDE$LOG)AD All%other% directories%created%using%default&rulesD VDE>FThisexampleshowsthose directory templatesthatap-L plytofacilityRMS.Notethatallgeneric informationisHdshown, includingthe templatesforthestreamrootdi-Mrectoryandfor unspecified facilities,beforethe templatesKspecifictofacilityRMSare displayed.) TemplatesspecificJmto facilitiesotherthanRMSarenot displayed.+InthisJcase,facilityRMShas templatesforan explicitlyspec-Lifiedroot directoryanda differentsetofsubdirectoriesKwthanother facilities.)VDEusesthese templatestocreateJthe directorytreeforfacilityRMSwhenyoucreatenew( developmentstreams. O4. VDE>SHOW%DIRECTORY/FULL= Directory-creation% templates&for%stream%V2.1-1:%D0 Directory%creation%flags:Hx Do%not%defer%creation%of% directory&tree%for& substreams@ Do%not%prompt&for%root& directory%for% substreams=DP Stream%root% directory%is% [.V2_1-1]&by&default6 Subdirectory:p [.VDE$BLD]%(symbol&VDE$BLD)D$ Template%added%to%database%onJ 9-DEC-1989% 20:27:58.02G$( Template%added%to%database%by%user&SMITH&(Jane&Smith)$p Remark:=D Directory% templates&for% unspecified% facilities:.H Subdirectory:p[.OBJ]&(symbol%OBJ)E$ Template%added%to%database%on% 11-DEC-1989% 20:37:30.45G$ Template%added%to%database%by%user&JONES&(John&Jones).$  Remark:&Remark%string%shown%here.h Subdirectory:p[.SRC]&(symbol%SRC)E$ Template%added%to%database%on% 12-DEC-1989% 20:45:22.37G$ Template%added%to%database%by%user&SMITH&(Jane&Smith)*$? Remark:&Another%remark&string6 Subdirectory:p [.VDE$COM]%(symbol&VDE$COM)D$ Template%added%to%database%onJ 9-DEC-1989% 20:27:58.02G$ Template%added%to%database%by%user&SMITH&(Jane&Smith)$_ Remark:6 Subdirectory:p [.VDE$LOG]%(symbol&VDE$LOG)D$ Template%added%to%database%onJ 9-DEC-1989% 20:27:58.02G$7 Template%added%to%database%by%user&SMITH&(Jane&Smith)$ Remark:AD All%other% directories%created%using%default&rules VDE>@!ThisexampleshowsthefulloutputoftheSHOW>f! DIRECTORYcommand.+Foreach directory template,L!thefulloutputshowsthedateandtimethetemplatewasJ"created,theusernameandfullnameofthecreator,andEp"the template'sremarkstring.+For templatesthatVDEO"suppliesbydefault,thetemplatecreatorissimplytheuser*!#whocreatedtheVDElibrary. @6OSHOWEDITOR*78 AhKODisplaywhateditorVDEusesforthoseVDEcommandsthatO(invokeaneditor.P9&OFormatOsSHOWEDITORM:#O ParametersOs None./;! O DescriptionDOsTheSHOWEDITORcommanddisplaystheeditorstringsHOthatvariousVDEcommandsusetoinvokeyour preferredTO$editor,eithertocreatenewfilesortodisplayexistingfiles.LO|WhenVDEinvokesaneditor,itspawnsaDCLeditingcom-IOmandina subprocess.)VDEformstheeditingcommandbyLO- concatenatingyour read-writeor read-onlyeditorstring,aMOspace,andthenameofthefiletoedit.)TheSHOWEDITORJOcommanddisplaysthecurrent read-writeand read-onlyed-JO7itorstringsforyourVDEsession.+ThecommandcanalsoNOdisplayyourdefaulteditorstringsforfutureVDE sessions.;<O QualifiersOs/BRIEF (default)O/FULLHO$ControlwhetherVDEdisplaysthedefaulteditorstringsMO|storedintheVDE database.)The/BRIEF qualifieronlydis-MOplaysthetwoeditorstringsforyourcurrentVDEsession.OO-The/FULL qualifierdiplaystheeditorstringsforyourcur-NOrentVDEsessionandyourdefaulteditorstringsforfutureOVDE sessions.SHOW%EDITOR# Current&editor%strings:*D Read-write&editor%string:&TPU3De Read-only%editor&string:K TPU/READ_ONLY VDE>GThisexample illustratesthebriefoutputoftheSHOWtEDITORcommand. O2. VDE>SHOW% EDITOR/FULL#4 Current&editor%strings:*D| Read-write&editor%string:&TPU3D Read-only%editor&string:K TPU/READ_ONLY#  Default&editor%strings:/DT Read-write&editor%string:&EDIT/EDT8D Read-only%editor&string:KEDIT/EDT/READ_ONLY VDE>FRThisexample illustratesthefulloutputoftheSHOWFEDITORcommand.+Inthiscase,theeditorstringsforJthecurrentVDEsessionspecifytheTPUeditor,buttheL\defaulteditorstringsforfuturesessionsspecifytheEDTeditor. B>OSHOWFACILITY*?@AbMODisplaysthenamesand attributesofoneormore specifiedO( facilities.tAJOFormat:OsSHOWFACILITYM [facil-name[,facil-name...]]^B :4O ParameterOs facil-namePOThenameofafacilitywhose attributesaretobe displayed.NOfYoucandisplaymorethanonefacilityusingwildcardchar-NOacters.,Thepercentsign( % )inafacilitynamematchesPOanysingle characterinthepositionitoccupiesandtheas-Opterisk( \|*Gp)matcheszeroormore charactersinthepositionitJO occupies.*Those facilitieswhosenamesmatchthewildcard"O!patternare displayed.CNOIfyoudonotspecifyafacilitynameorusethe/CURRENTPO qualifier,VDEdisplaysall facilitiesinthecurrentlibrary.D FO DescriptionKOs Dependingonthe qualifiersyouselect,theSHOWFACILITYMOcommanddisplayseitherthenameofeachselected facility,LO$thenameandremarkstringofeach facility,orthenameMO|andallother attributesofeach facility.*ThecommandcanSOalsoshowthetotalnumberof facilitiesthatmatcha specifiedO-facilityname.E! gO QualifiersOs/BRIEFO/NORMAL (default)O$/FULLMO| Determinesthe informationthatis displayedabouteachfa-ROcility.'The/BRIEF qualifierdisplaysthenameofeachfacilityGO-thatmatchesthefacilityname parameters.(The/NORMALRO qualifierdisplaysthenameandremarkstringofeach facility.POThe/FULL qualifierlistsall informationabouteach facility,PO7 includingitsname,itscreationdate,itsremarkstring,and@Othenameoftheuserwhocreatedthe facility.qF GGOOf/BRIEF,/NORMALand/FULL,/NORMAListhedefault.GO/CURRENTOO(Displays informationforthedefault facility.*Donotspecify Othe facil-name3 parameterifyouusethis qualifier.H O/OUTPUT=file-specSO(Directstheprintedoutputofthiscommandtoa specifiedfile. OThe file-spec>s parameter specifiesthenameofthefile.(VDEKOcreatesanewfilewiththatname,directsthe command'sSO2printoutputtothatfile,andprintsnothingonyour terminal.UOIfthis qualifierisomitted,alloutputappearsonthe terminal.IO/TOTALKO(Showsthetotalnumberof facilitiesthatmatcheachpa-JOrameter.,Other informationaboutthe individual facilitiesFOisnotshown.+Aseparatecountisprovidedforeachfacil-O2nameBO2 parameter.)Wildcard charactersareusuallyusedin7Othe parameterwhenusingthis qualifier.J1 SqOExamples O1. VDE>SHOW%FACILITY Facility%CODEy "Code%modules" Facility%DELETE&y "Code%for&DELETE%command"e Facility%EXEC$ye "VMS% Executive% routines" Facility%RMS(y "Record% Management& Services" Facility%SMG'y "Screen% Management&Package"< VDE>PThisexamplelistsall facilitiesinthecurrentVDElibrary,Jwhichisthedefaultwhennofacilityname parameterisH\present.)Thenormalformoftheoutputgivesthename2andremarkstringofeach facility. O-2.- VDE>-SHOW%FACILITY/BRIEFu Facility%CODE Facility%DELETE Facility%EXECM Facility%RMS Facility%SMG VDE>EKThisexample illustratesthebriefformoftheSHOWDFACILITYoutput,whichshowsonlythenameofeach facility. Ou3.u VDE>"uSHOW% FACILITY/FULL%RMS Facility%RMSDD Facility%added%to%database%onJ 4-APR-1989% 14:57:14.12GDL Facility%added%to%database%by%user&SMITH&(Jane&Smith)$D Facility%can%be%deleted/D Remark:&Record% Management&Servicesl VDE>@ ThisexampleshowsthefulloutputoftheSHOW4 FACILITYcommand. O 4. VDE># SHOW%FACILITY/TOTAL%%M*9 Number%of% facilities%matching%name&%M*:%2A VDE>D The/TOTAL qualifierdisplaysthenumberoffacili-G tiesthatmatchthe specified parameter.)The parametera ( %M m *Fa )matchesallfacilitynamesthathaveanMintheL second character position.'Usingthelibraryintheprevi-Iousexample,thecommandfindstwosuch facilities,RMSjandSMG. O5. VDE> SHOW%FACILITY/CURRENT+ Facility%CODEy+ "Code%modules"r VDE>@The/CURRENT qualifierdisplaysthenameofthe:default facility.>KOSHOWFOLD*L{MQQODisplaysthe attributesofoneormore specifiedfoldrecords.lNBOFormat2OsSHOWFOLDM [mod-name[, mod-name...]]O O ParameterOsmod-nameLO Specifiesamoduleforwhichfoldrecordsaretobedis-HO$played..Themodulenameconsistsofanoptionalfacil-FO|itynameenclosedinsquare brackets,amodulename,KOandanoptionaltypenameprecededbyaperiod(suchasGO-[FACIL]MOD1.MAR).Ifthefacilitynameisomitted,theOOmoduleisassumedtobelongtothedefault facility.,IftheROtypenameisomitted,VDEdisplaysfoldrecordsforallsourcePO7moduleswiththe specifiedmodulenameinthegiven facility.LOYoucandisplayfoldrecordsformorethanonemodulebyNO+usingwildcard charactersinanyofthethree componentsofOOthemodulename.'Thepercentsign( % )inanamematchesPOanysingle characterinthepositionitoccupiesandtheas-O4terisk( ]@*C4)matcheszeroormore charactersinthepositionPOit occupies.)VDEdisplaysfoldrecordsforallsourcemodules6Owhosenamesmatchthewildcardpattern.POIfyouomitthemod-name)i parameter,VDEdisplaysfoldAOrecordsforallmodulesinthedefault facility.jQ@O DescriptionGOs Dependingonthe qualifiersyouselect,theSHOWFOLDJOcommanddisplayseitheraone-linesummaryforeachfoldLO$recordorall attributesofeachfoldrecord.+ThecommandMO|canalsoshowthetotalnumberoffoldrecordsthatmatchKOa specifiedmodulename.,YoucanselectthefoldrecordsPO-tobe displayedorcountedwith qualifiersthatspecifyvari-ROous selection criteria.)Thesecriteriaincludethefoldrecord'sROcreationdateandtime,itsfold identifier,its associatedde-JO7 velopmentstream,andtheusertowhomitbelongs.+OnlyROthosefoldrecordsthatsatisfyall specified selectioncriteria&Oare displayedorcounted.R! PuO QualifiersOs/BEFORE=date-timeLODisplaysonlythosefoldrecordscreatedbeforethespeci-PO$fieddateandtime.+ThedateandtimecanbestatedintheIO|standardOpenVMS date-timeformatorcanbeoneoftheAO following keywords:' YESTERDAY,TODAY,or TOMORROW.PO-Ifyouuseaspacetoseparatethedatefromthetime,re-IOmembertoenclosetheentire date-timestringindoubleHOquotes.)Forfurther informationabout specifyingOpenVMS?O7 date-timeformat,seetheOpenVMSDCL Concepts.S O/BRIEF (default)O(/FULLNO Determinesthe informationthatis displayedabouteachfoldIOrecord.*The/BRIEF qualifierdisplaysaone-linesummaryLO2foreachfoldrecordthatmatchesthemodulenameparame-SOtersandtheother selection criteria.'The/FULL qualifierlists>Oalldatabase informationforeachfoldrecord.T O/OUTPUT=file-specSO(Directstheprintedoutputofthiscommandtoa specifiedfile. OThe file-spec>s parameter specifiesthenameofthefile.(VDEKOcreatesanewfilewiththatname,directsthe command'sSO2printoutputtothatfile,andprintsnothingonyour terminal.UOIfthis qualifierisomitted,alloutputappearsonthe terminal.U $O/IDENTIFICATION=fold-identRO(Displaysonlythosefoldrecordswiththefold identifiergivenObytheC fold-ident; parameter.'Thefold identifieristheiden-LOtifieryou specifiedorVDEassignedwhenyoucreatedtheTO2foldrecord,usuallyasmallintegervalue.)Ifthis qualifierisOOomitted,VDEdisplaysfoldrecordswithallfold identifiers.V! _O/SINCE=date-timeNO(Displaysonlythosefoldrecordscreatedafterthe specifiedQOdateandtime.(Thedateandtimecanbestatedinthestan-KOdardOpenVMS date-timeformatorcanbeoneofthefol-BO2lowing keywords:' YESTERDAY,TODAY,or TOMORROW.IfQOyouuseaspacetoseparatethedatefromthetime,rememberOOtoenclosetheentire date-timestringindoublequotes.*ForEO<further informationabout specifyingOpenVMS date-time4Oformat,seetheOpenVMSDCL Concepts.rW KHO/STREAM=stream-nameHO( Specifiesthe developmentstreamforwhichfoldrecords%Oshouldbe displayed.'The stream-name parametergivestheROnameofthestream.(Ifthis qualifierisomitted,VDEdisplays8O2foldrecordsforall developmentstreams.XO/TOTALIO(ShowsthetotalnumberoffoldrecordsthatmatcheachKO module-name parameterandsatisfytheother selectioncri-KOteria.,Other informationaboutthe individualfoldrecordsFO2isnotshown.*Aseparatecountisprovidedforeach2mod-OnameBO parameter.)Wildcard charactersareusuallyusedin7Othe parameterwhenusingthis qualifier.Y! O/USERNAME[=username]EO( SpecifiestheOpenVMSusernameofauserwhosefoldWOrecordsaretobeshown.'Ifthis qualifieris specified,onlythat5Ouser'sfoldrecordsareshown.'Ifthexusername& parameterisOO2omitted,onlyyourownfoldrecordsareshown.(IfthewholeNO qualifierisomitted,foldrecordsforallusersareshown.9Z OExamples O1. VDE>SHOW%FOLD; Fold&1%of%[CODE]X.FOR;2(2)%into&stream%V1.0 26-JUN-1990%JONES VDE>GThisexampleshowsthebriefoutputoftheSHOWFOLDJcommand.(Thisoutputgivesthefold identifier,themod-G<ulename,the developmentstreamthechangeshouldbeNfoldedinto,thedatethefoldrecordwascreated,andthe3usernameofthefoldrecord'sowner. Of2.f VDE>fSHOW% FOLD/FULL' Fold&1%of%[CODE]X.FOR;2(2)HD Module%to%be%folded&from%stream&MAIN%into%stream%V1.0>D> Fold&record%created&by&user%JONES%(Jon%Jones)=D Fold&record%created&on& 26-JUN-1990& 12:40:21.90FThisexampleshowsthefulloutputoftheSHOWFOLDH%command.(Thisoutputgivesalldatabase informationfor}thefoldrecord.]H$D[OSHOW GENERATION*\]ANODisplayscurrent, differentialor historical informationabout8O(oneormore specifiedmodule generations.r^HOFormat8OsSHOW GENERATIONN [gen-spec[, gen-spec...]]_?O ParameterOsgen-specMO Specifiesamodule generationtobe displayed.)A generationAO$ specificationconsistsofthe followinginorder: `Fanoptionalfacilitynameenclosedinsquarebrackets `((amodulename `;anoptionaltypenameprecededbyaperiod `&F&anoptional generationnumberprecededbya semicolonw`{ MMOAnexampleofa generation specificationis[RMS]MOD1.MAR;5.a! WMOIfyouomitthefacilityname,module generationsfromtheSOdefaultfacilityare displayed.'Ifyouomitthetypename,gen-MO5erationsforallmoduleswiththe specifiedmodulenameinPOthe specifiedfacilityare displayed.)Ifyouomitthegenera-POtionnumber,themostrecent generationofthemoduleinthe:O> specified(ordefault)streamis displayed. b LOIfyouspecifyazeroornegative generationnumber,thatPOnumberisrelativetothemostrecent generationofthemod-PO5uleinthestream specifiedbythe/STREAM qualifier(orthePOdefaultstreamifthat qualifieris omitted).*Forexample,ifPOthemostrecent generationis generation5,then generation0RO>isthesameas generation5and generation-1isthesameasO generation4.c NLOIfyouspecifythe /GENERATION qualifier,VDEdisplaystheHO generationwiththegivenCMS generation expressionand3O5ignoresthe generationnumberonthe5gen-spec?5 parameter.d aJOYoucandisplaymorethanone generationbyusingwild-MOcard charactersinthefacilityname,modulename,ortypeFO5name,orby specifyingawildcardonthe /GENERATIONRO qualifier.(Thepercentsign( % )inanamematchesanysin-POgle characterinthepositionitoccupiesandtheasterisk( c* )OO>matcheszeroormore charactersinthepositionit occupies.OAnasterisk( (*s parameter specifiesthenameofthefile.(VDEKOcreatesanewfilewiththatname,directsthe command'sSO2printoutputtothatfile,andprintsnothingonyour terminal.UOIfthis qualifierisomitted,alloutputappearsonthe terminal.t! ]O/SINCE=date-timeLO(Displaysonlythose generationscreatedafterthe specifiedQOdateandtime.(Thedateandtimecanbestatedinthestan-KOdardOpenVMS date-timeformatorcanbeoneofthefol-BO2lowing keywords:' YESTERDAY,TODAY,or TOMORROW.IfQOyouuseaspacetoseparatethedatefromthetime,rememberOOtoenclosetheentire date-timestringindoublequotes.*ForEO<further informationabout specifyingOpenVMS date-time4Oformat,seetheOpenVMSDCL Concepts.)u 0O/STATISTICS=(keyword[, keyword...])KO(Computesanddisplayscertains statisticsaboutthemoduleKO generationsthatmatchthe generation specificationparame-MOtersandany selection qualifiers(suchas/SINCE,/BEFORE,2O2or /USERNAME)thatyouspecify.)The2keywordi2parame-QOtersspecifywhat statisticstodisplayandhowtosortthem.GOThe qualifieracceptsthe followingkeyword parameters:v! V `m?mALPHABETICALLY-SortthedisplayalphabeticallybyIfacilityname,modulename,ortypename.)Ifthiskey-Mwordisomitted,VDEsortsthedisplayin descendingorder wby generationcount. `BFACILITY-Computeanddisplaythenumberofgenera-$Otionsineach facility. `@MODULE-Computeanddisplaythenumberofgenera-#'tionsforeachmodule. `C TYPES-Computeanddisplaythenumberof generations)thathaveeachmoduletype.wuMOIfyouspecifyonlyoneofthese keywords,the surrounding(O parenthesesmaybeomitted.xx NQOWhenthis qualifierisused,other informationabouttheindi-OOvidual generationsisnotshown.)Use selection qualifiersandJO5wildcard charactersinthe generation specificationparam-OOeterstoselectthe generation populationforwhichyouwantO statistics.y! O/STREAM=stream-nameLO( Specifiesthat generationsforthe developmentstreamgivenObytheD stream-name4 parameterbe displayed.(This qualifierNOthusaffectstheinterpretationof generationnumbersontheO2 command's2gen-spec72 parameter.'Ifthis qualifierisomitted,MOVDEdisplays generationsforthedefault developmentstream.z O/TOTALFO(Showsthetotalnumberof generationsthatmatchthe(gen-OspecA  parameters.+Other informationaboutthe individualMO generationsisnotshown.*AseparatecountisprovidedforO2each2gen-spec82 parameter.'Wildcard charactersareusuallyBOusedinthe parameterswhenusingthis qualifier.*{ UO/TREELO(Showsthewhole generationtreeforeach specifiedmodule.KOThisdisplayshowstheCMS generation expressionforeachPO generation,thedateitwascreated,whocreatedit,andtheMO2 generationremark.(Italsoshowsforwhatstreamsthegen-SOerationisthelatest generation.)ThisistheonlydisplaythatOOshowsall generationsofamodule regardlessofwhatstreamsO<theybelongto.]| 3'SHOW%GENERATION/STREAM=BIRCH= Generation&[RMS]MODULE_A.REQ;2(2)by&user%SMITH o  on& 12-DEC-1989&08:44A Generation&[RMS]MODULE_B.REQ;25(23A2)&by&user%JONESo  onK 9-DEC-1989&20:34?e Generation&[RMS]MODULE_C.B32;14(14)pby&user%BROWNo e onK 9-DEC-1989&20:34Z Generation&[RMS]MODULE_D.B32;1(1)by&user% MORELIKEREDKonK 9-DEC-1989&20:34? Generation&[RMS]MODULE_E.B32;8(7E1)pby&user%JONES o  on& 29-DEC-1989&13:12< VDE>AThisexampleshowsthebriefoutputoftheSHOW6 GENERATIONcommand./ThecommanddisplaysD\onelineper generation.+The/STREAM qualifiersaysDtodisplay generationsforstreamBIRCH.BecausenoI  generation specification parameteris specified,thecom-Kfmandshowsthelatest generationforthatstreamofeach-moduleinthedefault facility. O72.< VDE>*<SHOW% GENERATION%MODULE_E.B32;*= Generation&[RMS]MODULE_E.B32;8(8)by&user%JONES o  on& 29-DEC-1989&13:12= Generation&[RMS]MODULE_E.B32;7(7)by&user%JONES o  on& 26-DEC-1989&14:00= Generation&[RMS]MODULE_E.B32;6(6)by&user%SMITH o  on& 19-DEC-1989&15:37>\ Generation&[RMS]MODULE_E.B32;5(5)by&user%PORTER o \ on& 12-DEC-1989&13:10X Generation&[RMS]MODULE_E.B32;4(4)by&user%DINGDONGon& 12-DEC-1989&08:43= Generation&[RMS]MODULE_E.B32;3(3)by&user%SMITH o  on& 12-DEC-1989&08:37=4 Generation&[RMS]MODULE_E.B32;2(2)by&user%JONES o 4 on& 12-DEC-1989&08:35=| Generation&[RMS]MODULE_E.B32;1(1)by&user%JONESo | onK 9-DEC-1989&20:34 VDE>D2 Thisexampledisplays generationsformoduleMODULE_M E.B32infacilityRMS.Itusestheasteriskwildcardchar- acter(  *D )inplaceofthe generationnumber.(Asaresult,J< VDEdisplaysthelatest generationofthemoduleintheJ currentdefaultstreamandallprevious generationslead-N inguptothat generationofthemodule.'ThisdisplaythusIF  summarizesthe historical developmentofthatmodulefor thedefaultstream. O 3. VDE>4 SHOW% GENERATION%[RMS]MODULE_E.B32;8/FULL,d Generation&[RMS]MODULE_E.B32;8(8);D Generation&created%on% 29-DEC-1989% 13:12:51.55=D Generation&created%by%user%JONES%(John%Jones)'D; Module%is%a%source%module.D CMS% generation% expression&is&"8"(D Delta%letters&in&use:KNone2D Generation&created%in%stream&HICKORY:D[ Latest% generation%for%stream&HICKORY,&BIRCH3D Module%is%current%for%stream&HICKORY4D Main&thread%belongs&to&stream%HICKORY2D3 Remark:&Add%the% mumble-fratz&feature VDE>F2Thisexample illustratesthefulloutputoftheSHOWB GENERATIONcommand.(VDEdisplaysall attributesofIthe specifiedmodule generation.'The generationshownis<; generation8relativetothedefaultstream. O4. VDE>+SHOW%GENERATION/TREE& [RMS]E.B324 Generation&tree%for&module% [RMS]E.B32:LDI (4) 28-JUN-1990% 16:15:13.95%JONES%"Make%comments% meaningful"/ Latest% generation%for%stream&MAINOD (3) 27-JUN-1990% 14:14:21.71%BROWN%"Convert%to%new%QCB&format"GD! (1A1) 22-JUN-1990% 14:56:28.43%ANDERSON%"Fix&timing%bug"2i Latest% generation%for%stream&HICKORYFD (2) 22-JUN-1990% 14:55:01.29%SMITH%"Add&widget%feature"ED (1) 18-JUN-1990% 17:46:47.60%SMITH%"Initial% generation" VDE>IThisexampleshowsthewhole generationtreeformoduleKPE.B32infacilityRMS. Generation4isthelatestgener-HationinstreamMAINand generation1A1isthelatest* generationinstreamHICKORY. Oy5.~ VDE>1~SHOW%GENERATION/TOTAL/SOURCE%[RMS]*;*C Number%of% generations%matching%name% [RMS]*.*;*:%237 VDE>G}Inthisexample,the/TOTAL qualifiershowsthetotalDnumberof source-module generationsinfacilityRMS.-.Thereare237such generations.x?OSHOWGROUP*ApNODisplaysthenames,members,andother attributesofoneor"O(more specifiedgroups.qGOFormat7OsSHOWGROUPM [group-name[,group-name...]] pO ParameterOs group-nameMOThenameofasourcegrouporbuildgroupinthedefaultIO$ developmentstreamwhose attributesaretobe displayed.KOYoucandisplaymorethanonegroupusingwildcardchar-POacters.)Thepercentsign( % )inagroupnamematchesanyPOpsingle characterinthepositionitoccupiesandtheasterisk O( w*N)matcheszeroormore charactersinthepositionitoccu-KO!pies.(ThosegroupswhosenamesmatchthewildcardpatternOzare displayed.LOIfnogroupname parameteris specified,VDEdisplaysall8Ogroup definitionsforthedefaultstream.z PO DescriptionHOs Dependingonthe qualifiersyouselect,theSHOWGROUPJOcommanddisplaysthenames,members,andother attributesNO$ofthe specifiedsourcegroupsorbuildgroups.'The/SOURCEHO|or/BUILD qualifier determineswhetherthecommanddis-MOplayessourcegroupsorbuildgroups.'ThecommandcanalsoJO-showthetotalnumberofgroupsthatmatcha group-nameKOspecification.)Thiscommandonlydisplaysgroup definitions1Oforthedefault developmentstream.( O QualifiersOs/BRIEF (default)O/FULLJO$ Determinesthetypeof informationthatis displayedforMO|agroup.+The/BRIEF qualifierlistsonlythenamesoftheGOgroupsthatmatchthe group-name parameters.'The/FULLPO- qualifierliststhenameofeachgroupandalsoitscreationPOdate,itsremarkstring,thestreamtowhichitbelongs,andBOthenameofthecreatorofthegroup definition.f<SHOW%GROUP  Source%group%ALLMODS  Source%group%GROUP-2e Source%group%GRPNAM Source%group%GRP_1 Source%group%GRP_2< Source%group%GRP_3 Source%group%GRP_4 VDE>A;Thisexample illustrateshowtheSHOWGROUPcom-Fmandwithout parametersor qualifiersliststhenamesIofallsourcegroupsdefinedinthedefault developmentEstream. O2. VDE>.SHOW% GROUP/BUILD%BLDGRP,%BLDGRP-2  Build%group%BLDGRP R Build%group%BLDGRP-2 VDE>!SHOW% GROUP/BUILD%BLD* Build%group%BLDGRP * Build%group%BLDGRP-2r VDE>GInthisexample, individual build-groupnamesareusedJ9as parameterstolisttwobuildgroups,bothdefinedin?thedefaultstream.*ThesecondSHOWGROUPcom-Dmand illustratestheuseofawildcard character( *)to(C listmultiplebuildgroups. O 3. VDE>* SHOW% GROUP/SOURCE& ALLMODS/FULL  Source%group%ALLMODSADK Group%added%to%database%onJ 4-AUG-1988% 15:15:31.49@D Group%added%to%database%by%user&DOE%(John%Doe)*D Group%defined&in&stream%MAIND# Remark: VDE>A! Herethe/FULL qualifiershowswhensourcegroupEz ALLMODSwasaddedtothe database,thenameoftheH userwhoaddedit,thenameofthe developmentstreamH+ inwhichthegroupwascreated,andtheremarkstring'  associatedwiththegroup. O 4. VDE>+ SHOW%GROUP/BUILD/MEMBERS%SYSGRPD Build%group%SYSGRP"D Members&of&the%group:# Module%[BUILD_TEST]X.EXE# Module%[BUILD_TEST]Y.EXE#c Module%[BUILD_TEST]Z.HLB VDE>DbHerethe/MEMBERS qualifierliststhenamesofallEmodulesthataremembersofbuildgroupSYSGRP.TheEfacilityname,modulename,andmoduletypeofeach!lmemberare displayed. O5. VDE>0SHOW%GROUP/BUILD/FULL/MEMBERS&SYSGRP, Build%group%SYSGRPADt Group%added%to%database%onJ 4-AUG-1988% 15:15:31.49@D Group%added%to%database%by%user&DOE%(John%Doe)*D Group%defined&in&stream%MAIN8DL Remark:&All%images%for& conversion%program"D Members&of&the%group:# Module%[BUILD_TEST]X.EXE;$$ Added%by%user&DOE%onJ 4-AUG-1988% 15:15:31.49#k Module%[BUILD_TEST]Y.EXE;$ Added%by%user&DOE%onJ 4-AUG-1988% 15:15:31.49# Module%[BUILD_TEST]Z.HLB>$C Added%by%user&SMITH&on& 19-OCT-1988& 16:10:40.05 VDE>@BThisexampleshowstheoutputofthe/FULLandC/MEMBERS qualifiersused together.)TheoutputshowsCalldatabase informationaboutthe specifiedgroup. Ok6.q VDE>qSHOW% GROUP/TOTAL%*3 Number%of%groups&matching&name%*:%7 VDE>EoThisexampleshowshowthe/TOTAL qualifierdisplaysJthenumberofsourcegroupsforthedefaultstreamthatF matchagiven group-namespecification.+Inthiscase,#yawildcard character( *.=y)is specifiedthatmatchesallJsourcegroupnames.'Thedefaultstreamthushasatotal-*ofsevensourcegroupsdefined._ =OSHOWKEY*A[IODisplaysthekey definitionscreatedwiththe DEFINE/KEYO(command.Y/OFormatOsSHOWKEYN [key-name]=O ParameterOskey-nameQOThenameofthekeywhose definitionistobe displayed.(ForIO$alistofvalidkeynames,seethe DEFINE/KEYcommand.}SO DescriptionEOsTheSHOWKEYcommandliststhekey definitionscre-AOatedwith DEFINE/KEYcommand.,WhenusedwiththeKO$ /DIRECTORY qualifier,thecommandliststhestatesassoci-KO|atedwiththosekey definitions.(UsetheSETKEYcommand"Otochangekeystates..O QualifiersOs/ALLUODisplaysallofthekey definitionsforthecurrentstateorforRO$thestates specifiedwiththe/STATE qualifier.)Ifyouusethe;O|/ALL qualifier,donotspecifyakeyname.`O/BRIEF (default)O(/NOBRIEFMOThe/BRIEF qualifierdisplaysthekeyname,key definition,KOandstate associatedwiththe specifiedkey.)The/NOBRIEFQO2 qualifierdisplaysany qualifiers associatedwiththekeydefi-JOnition.'The/BRIEFand/NOFULL qualifiersare equivalent.=O /DIRECTORYLO(DisplaysthenamesofallthestatesforwhichkeyshaveGObeendefined..Ifyouhavenotdefinedanykeys,SHOWSHOW%KEY&KP4/FULL' DEFAULT&keypad% definitions:;" KP4%=&"SHOW& DEFAULTS"%(echo,terminate,nolock)DInthisexample,theSHOWKEYcommanddisplaystheEcomplete definitionoftheKP4key.+Usingthe/FULLFB qualifierliststhe qualifiers(/ECHO, /TERMINATE,andH/NOLOCK)entered,either explicitlyorbydefault,with;theSHOWDEFAULTScommandwhentheKP4keyKwasdefined. O2. VDE>6DEFINE/KEY/TERMINATE&COMMA&"SHOW&LIBRARY"A- %VDE-I-DEFKEY,%DEFAULT&key%COMMA%has%been%definedu VDE>uSHOW%KEY&COMMA' DEFAULT&keypad% definitions:# COMMA&=%"SHOW%LIBRARY"M VDE>MSHOW%KEY/FULL%COMMA' DEFAULT&keypad% definitions:< COMMA&=%"SHOW%LIBRARY"K(echo,terminate,nolock)EKInthisexample,thefirstSHOWKEYcommandistheLdefaultversionofthecommand:(itdisplaysboththedef-AinitionoftheCOMMAkey(SHOWLIBRARY)andtheDUstateinwhichitisdefined (DEFAULT).Thesecond@SHOWKEYcommand(withthe/FULL qualifier)ad-K  ditionallydisplaysall qualifiers associatedwiththekeyA^  definition,whichinthisexampleare /TERMINATE,F /ECHO,and/NOLOCK;the qualifierseithercanbeex-I plicitlystatedwhenthekeyisdefined(as /TERMINATE)Ch orcanbedefaults(as/ECHOand/NOLOCK)ofthe  DEFINE/KEYcommand. O9 3.9 VDE>9 SHOW%KEY/ALL' DEFAULT&keypad% definitions:: PF1%=&""&$(echo,noterminate,nolock,state=GOLD)1 PF2%=&"Help"%(echo,terminate,nolock)8Y PF3%=&"SET%VERIFY"%(echo,terminate,nolock): PF4%=&""&$(echo,noterminate,nolock,state=BLUE); KP4%=&"SHOW& DEFAULTS"%(echo,terminate,nolock)C1 COMMA&=%"SET%CONTEXT&BUGFIX"%(echo,terminate,nolock): ThisexampletheSHOWKEYcommanddisplaysG allofthekey definitionsthatyoucreatedwiththeP DEFINE/KEYcommand.A AOSHOWLIBRARY*nDDODisplaysthe attributesofthecurrentVDElibrary.Q'OFormatOsSHOWLIBRARYM#O ParametersOs None.6!  O DescriptionEOsTheSHOWLIBRARYcommanddisplaysthenameandrootNO directoryofthecurrentlibraryand optionallyshowsinfor-MO$mationfromthedatabase-headerrecordofthelibrary.(ThisNO| additional informationincludesthecreationdateoftheli-QObrary,aremarkstring,thenameoftheuserwhocreatedtheLO-library,andthestandard authorizedanddefault privileges,Ofornewusersofthelibrary. :O QualifiersOs/BRIEF (default)O/FULLLO$ Determineswhat informationaboutthelibraryis displayed.JO|The/BRIEF qualifierliststhenameandtherootdirec-QOtoryofthelibraryonly.)The/FULL qualifierliststhename,LO-theroot directory,andall information availablefromthe4Odatabase-headerrecordofthelibrary.SHOW%LIBRARY? Library&LIBNAME%in%root% directory%DEV$:[PROJDIR] VDE>EThisexample illustratesthebriefformoftheSHOWLIBRARYoutput. O\2.\ VDE>\SHOW% LIBRARY/FULL? Library&LIBNAME%in%root% directory%DEV$:[PROJDIR]?D Created&by&user%SMITH%onK 4-APR-1989% 14:52:58.62 D4 Remark:&Test%library.D| Created&using&VDE%Version&X0.1-11D Automatic%library% conversion&enabled8D  Initial&default% privileges%for%new&users:!T CREMOD%CRESTEP%RESREP;D Initial& authorized% privileges%for%new&users:) CREMOD%CRESTEP%CREUSR%RESREP, VDE>GThisexampleshowsthefullformoftheSHOWLIBRARYoutput. BOSHOWLOCATION*.NODisplaysthenamesofthedisk directoriesthatcontainei-NO(therthefilesofthedefault developmentstream,thedeltaQOfilesofthecurrentlibrary,orthestagingareasforqueuedO replacements.R(OFormatOsSHOWLOCATIONM#O ParametersOs None.U! D+O DescriptionDOsTheSHOWLOCATIONcommanddisplaysthe locationsofMOthedisk directoriesthatcontainthemodulesthatmakeupOO$yoursoftwaresystem.'Youcandisplaythe directory locationsRO|ofallfilesinthedefault developmentstream,ofthecurrentWO library'sdeltafiles(storedintheformofCMS libraries),orof6O-thequeued replacement ``stagingarea.''KOThe directoriesforthedefault developmentstreamcontainRO!derivedfilesandclearcopiesofsourcefiles.)VDEusestheseOOz directorieswhenitbuildsyoursystem.'Bydefault,theSHOWGOLOCATIONcommanddisplaysthenamesofall directories$O+forthedefaultstream.! |POEachsourcemoduleinyoursoftwaresystemhasadeltafile.QOAdeltafileisacompactrepresentationforstoringallpastTO5andpresent generationsofasourcemodule.'AdeltafileistheBOsameasaCMSelement.'TheSHOWLOCATIONcommandEOcandisplaythenamesofall delta-file directories.NQOEachfacilityhasaseparatedisk directorytreeforboththePOdefaultstreamandthedeltafiles.*YoucanspecifythatyouRO5wanttodisplayonlythose directoriesforaspecific facility. HOTheVDElibraryalsohasaroot directoryforqueued-LO replacementstagingareas.'EachtimeauserqueuesmodulesKO5for replacement,VDEcreatesanew subdirectory(calledaJOstagingarea)forthatqueued replacementandcopiestheGOmodulestobereplacedtothestagingarea..TheSHOWHO>LOCATIONcommandcanshowtheroot directoryfortheseOstagingareas. O QualifiersOs /DELTA_FILESO/STAGINGO$/STREAM (default)NO| Specifieswhethertodisplay directory locationsfortheVDESO library's delta-files,the library'sstagingarea,orthedefaultFO- developmentstream.(The /DELTA_FILES qualifierdisplaysOO directory locationsofthe library's delta-files(itsCMSli-MO braries).)The/STAGING qualifierdisplaystheroot directoryMO7ofthe library'sstagingareasforqueued replacements.)TheOO/STREAM qualifierdisplays directory locationsforthedefaultO developmentstream.XAOOf /DELTA_FILES,/STAGINGand/STREAM,/STREAMisOthedefault.;O/FACILITY=facil-nameNO( Specifiesthatonlythose directory locationsthatholdmod-VOulesforthe indicatedfacilitybe displayed.)Ifthis qualifierisOOomitted, directory locationsforall facilitiesare displayed.;  OExamples O1. VDE>%SHOW%LOCATION/FACILITY=RMS2 Directory% locations&for%stream%V2.0:7D Stream%root% directory:&DEV$:[PROJDIR.V2_0]Ge Subdirectory:pDEV$:[PROJDIR.V2_0.VDE$BLD]&(symbol%VDE$BLD)3D Directory% locations&for%facility%RMS:3< Root& directory:%DEV$:[PROJDIR.V2_0.RMS]C Subdirectory:pDEV$:[PROJDIR.V2_0.RMS.OBJ]&(symbol%OBJ)C Subdirectory:pDEV$:[PROJDIR.V2_0.RMS.SRC]&(symbol%SRC)K Subdirectory:pDEV$:[PROJDIR.V2_0.RMS.VDE$COM]%(symbol&VDE$COM)K\ Subdirectory:pDEV$:[PROJDIR.V2_0.RMS.VDE$LOG]%(symbol&VDE$LOG) VDE>G[Thisexampledisplaysthedisk directory locationsforBfacilityRMSinthedefaultstream(streamV2.0). O,2., VDE>1,SHOW%!LOCATION/FACILITY=RMS/DELTA_FILES2s Directory% locations&for%delta%files:>D Delta-file&root% directory:%DEV$:[PROJDIR.VDE$CMS]3DK Directory% locations&for%facility%RMS:6 Root& directory:%DEV$:[PROJDIR.VDE$CMS.RMS]# VDE>LThisexampledisplaysthedisk directory locationsforthe* delta-filesforfacilityRMS.==OSHOWLOG* ! ROShowswhetherVDEinputandoutputisrecordedinalogfile.VO(Ifloggingisenabled,thenameofthelogfileis displayed.(To8Oenablelogging,usetheSETLOGcommand.M#OFormatOsSHOWLOGM#O ParametersOs None.M#O QualifiersOs None.tOExamples O1. VDE>SHOW%LOGB Output%logging%on%file:%DEV$:[MYDIR]VDELOGFILE.LOG;1 VDE>GThiscommandshowsthatoutputloggingisenabledand/givesthenameofthelogfile. O\2.\ VDE>\SHOW%LOG No%output%logging VDE>D[Thiscommandshowsthatoutputloggingis disabled. @OSHOWMEMORY*g==ODisplays informationaboutVDE'smemoryusage.P&OFormatOsSHOWMEMORYM#O ParametersOs None.C! O DescriptionBOsTheSHOWMEMORYcommanddisplays informationaboutIOthememorypoolsthatVDEuses.,Itdisplays information/O$aboutthe followingmemoryareas: `GVDE'sinternalmemorypool.'VDEusesthismemorypoolFforitsowndynamicmemoryneeds.'VDE allocatesmem-HZoryinthispool primarilyforcommand processing,butKalsousesitformore permanentstorage,suchasstoringK thenamesofthedefaultstreamand facility.)Theinfor-Icmation displayedincludesthetotalsizeofthismemoryKpool,theamountofmemory allocated,theamountoffree+memory,andother information. `>Thesizeofthe LIB$GET_VMandLIB$GET_VM_PAGE@memorypools.,ThesememorypoolsaremanagedbyEERun-TimeLibraryroutinesandareusedbyCMS,Rdb,Dandsystem componentssuchasRMS.CMS,inpartic-@ular,uses substantialamountsofLIB$GET_VM_PAGEOmemory. `FThesizeoftheVDE utility'saddressspaceandtheE&amountofvirtualmemorybywhichtheaddressspacecanbe expanded.L "JOIfyourunoutofvirtualmemorywhenrunningVDE,theBOSHOWMEMORYcommandcanbehelpfulin determiningPO5wherememoryisbeing consumed.'ItisofcoursealsohelpfulFOtoVDE developersin identifyinghowmemoryisused.M#O QualifiersOs None.J OExamples O1. VDE>SHOW%MEMORY$ Memory%usage% statistics:3D Number%of%bytes%in%VDE&memory%pool:d 655363De Number%of%areas%in%VDE&memory%pool: e 1D Number%of%bytes%in%VDE&pool%free%list:63548DT Number%of%LIB$GET_VM_PAGE&pages& allocated:1836@D Number%of%LIB$GET_VM_PAGE&bytes& allocated:p940032AD First%free&address%at%end&of&P0&space:0063EE00AD, First%free&address%at%end&of&P1&space:7FDD6200?Dt Number%of%pages% available&for% expansion:182835 VDE>BrThisexampleshowstheoutputoftheSHOWMEMORYIcommand.'Thefirstpartoftheoutputcontainsinforma-J# tionaboutVDE'sinternalmemorypool.'ThisincludestheO| totalsizeofthepool,theamountofmemorythatisallo-P cated,theamountthatisfree,thelengthofthefreelistH- (whichshouldbethesameastheamountoffreemem-J oryexceptfora16-bytelisthead),andtheamountofB  ``temporarymemory'' allocated.) TemporarymemoryisG7  allocatedmemorythatis automaticallyreleasedatthe) endofthecurrentcommand.4  FThemiddlesectionoftheoutputdisplays information6aboutthe LIB$GET_VMandLIB$GET_VM_PAGEG5memorypools.'This informationcomesfromlibraryrou-Htine LIB$STAT_VM.Finally,thelastfewlinesgivetheKsizesoftheVDE utility'sP0andP1addressspacesandI>thenumberofpagesbywhichthevirtualaddressspaceHcanstillbeexpandedbeforereachingthevirtualpage#limitfortheprocess.,"@OSHOWMODULE*uKKODisplaysthe attributesofoneormore specifiedmodules.nDOFormat4OsSHOWMODULEN [mod-name[, mod-name...]]k AO ParameterOsmod-nameHOThenameofamodulewhose attributesaretobedis-JO$played.-ThemodulenameconsistsofanoptionalfacilityJO|nameenclosedinsquare brackets,amodulename,andanIOoptionaltypenameprecededbyaperiod.-AnexampleisLO-[FACIL]MOD1.PAS.Ifnofacilitynameis specified,thede-POfaultfacilityisassumed.-Ifnotypenameis specified,allOOmoduleswiththe specifiedmodulenameinthegivenfacilityO7are displayed.IOYoucandisplaymorethanonemodulebyusingwildcardJO+ charactersinanyofthethree componentsofthemoduleMOname.*Thepercentsign( % )inanamematchesanysin-POgle characterinthepositionitoccupiesandtheasterisk( c* )OO4matcheszeroormore charactersinthepositionit occupies.JOThosemoduleswhosenamesmatchthewildcardpatternareO displayed.OIfyouomitthemod-name(l parameter,VDEdisplaysall.Omodulesinthedefault facility.. O DescriptionIOs Dependingonthe qualifiersyouselect,theSHOWMODULEHOcommanddisplaysthenameofeachselectedmodule,theJO$nameandremarkstringofeachmodule,orthenameandLO|allother attributesofeachmodule.*ThecommandcanalsoGOshowthetotalnumberofmodulesthatmatchamoduleQO-name specificationorcertain statisticsaboutthemodulesthat0Omatchamodulenamespecification.NHOToobtaingeneration-related informationononeormore=Omodules,usetheSHOW GENERATIONcommand.,SeeO5SHOW GENERATION$5forfurther information.*OG?[e ;O QualifiersOs/ALLO/SOURCE (default)O$/DERIVEDIO|Controlswhethersourcemodules,derivedmodules,orallHOmodulesare displayed.)The/SOURCE qualifiercausesVDEKO-todisplayonlysourcemodulesthatmatchthe module-nameFO parameters.+The/DERIVED qualifiercausesVDEtodis-JOplayonlyderivedmodulesthatmatchthe parameters.)TheOO7/ALL qualifiercausesVDEtodisplaybothsourceandderived0Omodulesthatmatchthe parameters.r HHOOf/ALL,/SOURCEand /DERIVED,/SOURCEisthedefault.^O/BRIEFO(/NORMAL (default)O/FULLLO Determinesthe informationthatis displayedforeachmod-MO2ule.(The/BRIEF qualifierdisplaysthenameofeachmoduleCOthatmatchesthe module-name parameter.(The/NORMALMO qualifierdisplaysthenameandremarkstringofeachmod-JO<ule..The/FULL qualifierdisplaysall attributesofeachNOmodule, includingitsname,creationdate,historyandnotesNO attributes,andremarkstring.*Italso indicateswhetherthe@OEmoduleisasourcemoduleoraderivedmodule.q GGOOf/BRIEF,/NORMALand/FULL,/NORMAListhedefault. O/OUTPUT=file-specSO(Directstheprintedoutputofthiscommandtoa specifiedfile. OThe file-spec>s parameter specifiesthenameofthefile.(VDEKOcreatesanewfilewiththatname,directsthe command'sSO2printoutputtothatfile,andprintsnothingonyour terminal.UOIfthis qualifierisomitted,alloutputappearsonthe terminal.l0O/STATISTICS=(keyword[, keyword...])LO(Computesanddisplayscertains statisticsaboutthemodules9Othatmatchthe module-name parameters.+The keywordJO parametersspecifywhat statisticstodisplayandhowtoGO2sortthem..The qualifieracceptsthe followingkeywordO parameters:! @ `m?mALPHABETICALLY-SortthedisplayalphabeticallybyGfacilitynameortypename.,Ifthiskeywordisomit-Kted,VDEsortsthedisplayin descendingorderbymodulewcount. `BFACILITY-ComputeanddisplaythenumberofmodulesOineach facility. `E TYPES-Computeanddisplaythenumberofmodulesthat#'haveeachmoduletype.uMOIfyouspecifyonlyoneofthese keywords,the surrounding(O parenthesesmaybeomitted.; QOWhenthis qualifierisused,other informationabouttheindi-NOvidualmodulesisnotshown.(Usewildcard charactersintheKO5 module-name parameterstoselectthemodule populationfor'Owhichyouwant statistics.O/TOTALKO(Showsthetotalnumberofmodulesthatmatchthemodule-GOname parameters.+Other informationaboutthe individualOOmodulesisnotshown.)AseparatecountisprovidedforeachO2mod-name522 parameter.-Wildcard charactersareusu-IOallyusedinthe module-name parameterswhenusingthisO qualifier.`  -6 OExamples O1. VDE>"SHOW% MODULE/SOURCE%*.* Module% [CODE]FOO.BAR_ "Nonsense%module" " Module%[CODE]MOD1.FOR"_" "First%Fortran&module" j Module%[CODE]MOD2.FOR#_j "Second%Fortran%module"  Module%[CODE]MOD3.FOR"_ "Third%Fortran&module"  Module%[CODE]MOD4.FOR_ "Sorting& routines" B Module%[CODE]MOD5.FOR)_B "Random% scrambling% algorithm"  Module%[CODE]MOD6.FOR%_ "Destabilization% routines" VDE>@@ThisSHOWMODULEcommanddisplaysthenamesandMremarkstringsofallsourcemodulesinthedefaultfacil-Dity.(ThisisanexampleofthenormalSHOWMODULEJoutput. O2. VDE>!SHOW% MODULE/BRIEF&FOO  Module% [CODE]FOO.MARR Module% [CODE]FOO.EXE Module% [CODE]FOO.LIS Module% [CODE]FOO.OBJ* VDE>EThisexample illustratesthebriefformoftheSHOWEMODULEoutput.*ItdisplaysthenamesofallmodulesHJnamedFOOinthedefault facility.)Bothsourcemodules-andderivedmodulesarelisted. O 3. VDE>+ SHOW%MODULE&[CODE]MOD1.FOR/FULL h Module%[CODE]MOD1.FORBD Module%added%to%database%onK 4-APR-1989% 14:58:39.66ED Module%added%to%database%by%user%SMITH%(Jane%Smith)'D@ Module%is%a%source%module%D Module%cannot&be&deleted>D History& information&is&not%provided%by%default!D History&string:%CJ#BL6 Thisexample illustratestheoutputofthe/FULL qualifier@ totheSHOWMODULEcommand.(ThemodulenameisM fully specifiedonthecommandinthiscase, includingtheD@facilityname,themodulename,andthetypename. O4. VDE>+SHOW%MODULE/TOTAL/SOURCE%[RMS]*; Number%of%modules%matching%name& [RMS]*.*:%7M VDE>GInthisexample,the/TOTAL qualifiershowsthetotal9numberofsourcemodulesinfacilityRMS.  DOSHOW PRIVILEGES*T**ODisplaysyourVDE privileges.T*OFormatOsSHOW PRIVILEGESM#O ParametersOs None.`:6O DescriptionGOsTheVDE privilegesyouhaveinyourcurrentVDEses-IOsion determinetheVDEcommands(andinsomecasestheFO$command qualifiers)youareallowedtouse.,TheSHOWGO| PRIVILEGEScommanddisplaysthe privilegesyouhaveinHOthecurrentsession., Optionally,thecommandalsoshowsGO-yourdefault privilegesandyour authorized privileges.ROForalistofall privilegenamesandtheir meanings,seethe#O!SET PRIVILEGEScommand.R Z(O QualifiersOs/BRIEF (default)O/FULLRO$ Specifieswhethertoshowall privilegesoronlythosesetforLO|thecurrentsession.*The/BRIEF qualifiershowstheprivi-POlegessetforyourcurrentsession.'The/FULL qualifiershowsOO-the privilegessetforyourcurrentsessionaswellasyourLOdefault privileges(the privilegesyouget automaticallyatKOthestartofeachVDEsession)andyour authorizedpriv-OO7ileges(the privilegesyouareallowedtosetusingtheSETHO PRIVILEGES command).+Ifyoudonotspecifya qualifierBOwiththeSHOW PRIVILEGEScommand,youreceivethe=OA information displayedbythe/BRIEF qualifier.f<SHOW% PRIVILEGES% Currently%set& privileges:8 BUILD%CREFAC%CREGRP&CREMOD%CRESTEP&RESREPe VDE>?ThisexampleshowsthebriefformoftheSHOW, PRIVILEGESoutput. O2. VDE>SHOW%PRIVILEGES/FULL% Currently%set& privileges:84 BUILD%CREFAC%CREGRP&CREMOD%CRESTEP&RESREP| Default& privileges:Q BUILD%CRECTX%CREFAC&CREGRP%CREMOD%CRESTEP%CREUSR%CRESTRM%RESREP!  Authorized& privileges:QT BUILD%CRECTX%CREFAC&CREGRP%CREMOD%CRESTEP%CREUSR%CRESTRM%FROZEN RESREP%USERNAME VDE>IRThisexampleshowstheuseofthe/FULL qualifierwith)theSHOW PRIVILEGEScommand.7EOSHOW REPLACEMENT*AlMODisplaysthenamesand attributesofoneormore specifiedO(queued replacements.sIOFormat9OsSHOW REPLACEMENTN [rep-name[, rep-name...]]! DO ParameterOsrep-nameOOThenameofaqueued replacementwhose attributesaretobeLO$ displayed.(Youcandisplaymorethanone replacementusingIO|wildcard charactersinthe replacementname.)ThepercentNOsign( % )ina replacementnamematchesanysinglechar-GO-acterinthepositionitoccupiesandtheasterisk( 99*k-)matchesROzeroormore charactersinthepositionit occupies.'Thosere-FO placementswhosenamesmatchthewildcardpatternareO7 displayed.ODonotspecifytherep-name& parameterifyouusethe%O+/IDENTIFICATION qualifier. NCOIfyou specify neithera replacement namenor theGO/IDENTIFICATION qualifier,VDEdisplaysall replacements!O5intheVDE database.! FO DescriptionAOs Depending on the! qualifiers you select,"the SHOWCO REPLACEMENTcommanddisplayseitheraone-linesum-LO$maryforeach specifiedqueued replacementoralldatabaseGO| informationforeach replacement.*ThecommandcanalsoOOshowthetotalnumberof replacementsthatmatcha specifiedO- replacementname. O QualifiersOs /ACCEPTEDO /REJECTEDO$ /IN_REVIEWO| /NOT_REVIEWEDIOSpecifythatonlythosequeued replacementswithcertainKO-reviewstatusesbe displayed.(The /ACCEPTED qualifierdis-HOplaysthose replacementsacceptedbyall reviewers.,TheKO /REJECTED qualifierdisplaysthose replacementsrejectedbyIO7atleastone reviewer.+The /IN_REVIEW qualifierdisplaysPOthose replacementsthatareacceptedbyatleastonereviewerNObutarenotyetacceptedorrejectedbyall reviewers.+TheFOA /NOT_REVIEWED qualifierdisplaysthose replacementsnot5Oacceptedorrejectedbyany reviewers. WOOIfoneormoreofthese qualifiersare specified,thosere-NO placementsthathaveoneofthe specifiedstatusvaluesareMO5 displayed.*These qualifierscanthusbeusedin combinationROtoshow replacementsofseveral differentstatusvalues.'IfallPOofthese qualifiersareomitted,VDEdisplaysall replacements!O> regardlessofstatus.! _O/BEFORE=date-timeJO(Displaysonlythose replacementsqueuedbeforethespeci-POfieddateandtime.+ThedateandtimecanbestatedintheIOstandardOpenVMS date-timeformatorcanbeoneoftheAO2 following keywords:' YESTERDAY,TODAY,or TOMORROW.POIfyouuseaspacetoseparatethedatefromthetime,re-IOmembertoenclosetheentire date-timestringindoubleHO<quotes.)Forfurther informationabout specifyingOpenVMS?O date-timeformat,seetheOpenVMSDCL Concepts.= O/BRIEF (default)O(/FULLO/MODULEHO Determinesthe informationthatis displayedabouteachKO2 replacement.'The/BRIEF qualifierdisplaysaone-linesum-HOmaryforeach replacement.+The/FULL qualifierdisplaysMOall availabledatabase informationforeach replacement.(TheDO</MODULE qualifierdisplaysthe replacementname,thePOstaging directory,themodulelist,andtheremarkstringforOeach replacement.pFFOOf/BRIEF,/FULLand/MODULE,/BRIEFisthedefault. ! ^O/HISTORYLO( Specifiesthat replacementhistorybe displayed.( ReplacementOOhistoryconsistsofallpast replacements,both immediateandPOqueued,thathavealreadybeen performed;itdoesnotincludeHO2 currentlyqueued replacements.) ReplacementhistoryallowsUOyoutoseea historicalrecordofallpast modificationstoyourLOsoftwaresystem.'This information complementsthe historicalCO< information availablefromtheSHOW GENERATIONcom-COmand.+Whenusedwiththe/IDENTIFICATION qualifier,ROthe/HISTORY qualifierdisplaysalistofallpast replacements#OEin chronologicalorder.qLOIfyouomitthe/HISTORY qualifier,VDEdisplays currently%Oqueued replacementsonly.zAPO/MODULE?O(Displaysallmodules comprisingthe replacement.X K."O/IDENTIFICATION=id-rangeLO( Specifiesthatthe replacementswiththeunique ReplacementOIdsgivenbytheid-range'- parameterbe displayed..DoOnotspecifythetrep-name), parameterwhenyouusethisO2 qualifier.aGOVDEassignsaunique ReplacementIdtoeach immediateIOorqueued replacementintotheVDElibrary.*VDEassignsOO5 ReplacementIdsin chronologicalordersothatthefirstre-OO placementintothelibraryhasIdvalue1,thenexthasIdROvalue2,andsoon.)Whenyouusethis qualifier,allreplace-QO>mentsthatfityourother selectioncriteriaandthathaveId0Ovaluesintherangegivenbytheid-ranger parameterareNO displayedin ascendingorderby ReplacementId.)Thisisthe)OHsameas chronologicalorder. V OTheid-range;r parametercanbeasingleintegervalue,aMOrangeof integers,orawildcard character.)Iftheparame-PO5terisasingleinteger(forexample, /IDENT=5),VDEdisplaysJOthe replacementwiththat ReplacementId.)Iftheparame-SOterisarangeofintegers (specifiedastwointegers separatedNO>byacolonasin /IDENT=3:5),VDEdisplaysthe replacements8OwithIdsinthatrange.'Finally,iftheid-range parameteris>Otheasteriskwildcard character(asin/IDENT= *$),VDEdis-JOHplaysall replacements.+Tobe displayed,each replacementTOmustalsofitall selectioncriteriathatyouspecifywithotherO qualifiers.! WBOIfyouspecifyazeroornegativenumberintheid-range jpa-MOrameter,thatnumberisrelativetothelargest ReplacementMO5IdvaluefortheVDElibrary(thelatest replacement).+ForLOexample,ifthelatest replacementhas ReplacementId250,HOthen/IDENT=0is equivalentto /IDENT=250and /IDENT=-1)O>is equivalentto /IDENT=249. NGOThe/IDENTIFICATION qualifieris especiallyusefulwhenPOusedwiththe/HISTORY qualifierbecausethenitdisplaysall7O5past replacementsin chronologicalorder.tO /IN_REVIEWCO(Displaysall replacement componentmodules presentlyO undergoingreview.oO /NOT_REVIEWEDCO(Displaysall replacement componentmodules presentlyO unreviewed. O/OUTPUT=file-specSO(Directstheprintedoutputofthiscommandtoa specifiedfile. OThe file-spec>s parameter specifiesthenameofthefile.(VDEKOcreatesanewfilewiththatname,directsthe command'sSO2printoutputtothatfile,andprintsnothingonyour terminal.UOIfthis qualifierisomitted,alloutputappearsonthe terminal.vO /REJECTEDJO(Displaysallmodules comprisingthe replacementthathaveObeen rejected. O/REVIEWER[=username]PO( Specifiesthatonlythose replacementsforwhichagivenuser.Oisareviewerbe displayed.(Theusernames parametergivesIOtheOpenVMSusernameofthat reviewer.+IfyouomittheO2username;2 parameter,onlythose replacementsforwhichKOyouareareviewerare displayed.-IfyouomitthewholeHO qualifier, replacementsforall reviewersare displayed.! eO/SINCE=date-timePO(Displaysonlythose replacementsqueuedatorafterthespec-QOifieddateandtime.)ThedateandtimecanbestatedintheIOstandardOpenVMS date-timeformatorcanbeoneoftheAO2 following keywords:' YESTERDAY,TODAY,or TOMORROW.POIfyouuseaspacetoseparatethedatefromthetime,re-IOmembertoenclosetheentire date-timestringindoubleHO<quotes.)Forfurther informationabout specifyingOpenVMS?O date-timeformat,seetheOpenVMSDCL Concepts. O/STREAM[=stream-name]QO( Specifiesthatonlythosequeued replacementsthatareforthe-O developmentstreamgivenbythe stream-nameS parameter!Obe displayed.'Ifthe stream-name&S parameterisomitted,re-MO2 placementsforthedefault developmentstreamare displayed.ROIfthewhole qualifierisomitted, replacementsforallstreamsOare displayed.! zO/TOTALHO(Showsthetotalnumberof replacementsthatmatcheachJO parameter.(Other informationaboutthe individualreplace-MOmentsisnotshown.*AseparatecountisprovidedforeachO2rep-name>2 parameter.'Wildcard charactersareusuallyused;Ointhe parameterwhenusingthis qualifier. O/USERNAME[=username]PO( Specifiesthatonlythose replacementsqueuedbyagivenuserObe displayed.(Theusername( parametergivestheOpenVMS7Ousernameofthatuser.)Ifyouomittheusernameparam-NO2eter,onlyyourown replacementsare displayed.(IfyouomitKOthewhole qualifier, replacementsqueuedbyallusersareO displayed.  _ OExamples O1. VDE>SHOW% REPLACEMENT( Replacement% ANDERSON-1BIRCH) 26-JUN-1990%ANDERSONAccepted( Replacement% ANDERSON-2BIRCH. 27-JUN-1990%ANDERSONNot%reviewede Replacement%SORT_BUG4e V2.0-UPD 27-JUN-1990% CHURCHILLAccepted Replacement%SMITH-1 V2.0 27-JUN-1990%SMITHO  Rejected VDE>AcThisexampleshowsthebriefoutputoftheSHOW9 REPLACEMENTcommand.-ThisoutputshowstheE replacementname,thestreamname,thedatethere-Dm placementwasqueued,theusernameoftheuserwho(queuedit,anditsstatus. O>2.C VDE>)CSHOW%REPLACEMENT/FULL%SMITH-1& Queued% replacement%SMITH-1=D Replacement%queued%by%user%SMITH%(Jane%Smith);D Replacement%queued%on% 27-JUN-1990% 15:10:27.20,Dc Replacement%is%for%stream&V2.0-D Unique% replacement%number&is&16\D Replacement%staging& directory%is%-DEV$:[LIBROOT.VDE$STAGE.VDE$STG_0.VDE$REP_16](D; Reservations%in% replacement:/ Reservation%1&of&[BUILD_TEST]C.B32/ Reservation%1&of&[BUILD_TEST]D.B320D Replacement%contains%2& reservations0DZ Replacement%review%status:%Rejected-D Remark:&Add% mumble-fratz%feature2 VDE>@ ThisexampleshowsthefulloutputoftheSHOW@  REPLACEMENTcommand,whichincludesall available/R  informationaboutthe replacement. O 3. VDE>+ SHOW% REPLACEMENT%SMITH-1/MODULE& Queued% replacement%SMITH-1\D_ Replacement%staging& directory%is%-DEV$:[LIBROOT.VDE$STAGE.VDE$STG_0.VDE$REP_16](D Reservations%in% replacement:/ Reservation%1&of&[BUILD_TEST]C.B32/7 Reservation%1&of&[BUILD_TEST]D.B320D Replacement%contains%2& reservations-D Remark:&Add% mumble-fratz%featureW VDE>C Thisexample illustratestheoutputofthe/MODULE qualifier. O4. VDE>!SHOW%REPLACEMENT/TOTAL9 Number%of% replacements&matching&name%*:%4& VDE>JThisexampleshowsthatthe/TOTAL qualifiercandisplayJthetotalnumberofqueued replacementsinthe database.)EOSHOW RESERVATION*S))ODisplaysmodule reservations.sIOFormat9OsSHOW RESERVATIONM [mod-name[, mod-name...]] zO ParameterOsmod-nameJOThenameofasourcemodulewhose reservationistobeIO$ displayed..Amodulenameconsistsofanoptionalfacil-KO|itynameenclosedinsquare brackets,amodulename,andHOanoptionaltypenameprecededbyaperiod(forexam-HO-ple,[FACIL]MOD1.MAR).Ifthefacilitynameisomitted,QOthedefaultfacilityisassumed.*Ifthetypenameisomitted,NO reservationsforallmoduleswiththe specifiednameinthe*O7givenfacilityare displayed.LOYoucandisplay reservationsformorethanonemoduleus-LO+ingwildcard charactersinanyofthethree componentsofOOthemodulename.'Thepercentsign( % )inanamematchesPOanysingle characterinthepositionitoccupiesandtheas-O4terisk( \@*G4)matcheszeroormore charactersinthepositionitJO occupies.) Reservationsforthesourcemoduleswhosenames8Omatchthewildcardpatternare displayed. tKOYoucanalsodisplay reservationsformultiplemodulesbyMO specifyingthenameofasourcegroupinsteadofamoduleGO5name.'SourcegroupsarecreatedwiththeCREATEGROUPMOcommand.(Ifyouspecifyagroupname,each reservationforHOamodulethatisamemberofthegroupis displayed. OIfyouomitthemod-name(l parameter,VDEdisplaysallOBydefault,theSHOW RESERVATIONcommandshowsJO reservationsforall developmentstreams,butthe/STREAMOO5 qualifierletsyouseeonlythose reservationsforacertainIOstream.) Likewise,bydefault,thecommandshowsreserva-QOtionsforallusers,butthe /USERNAME qualifierletsyouseeSO>onlythose reservationsthatbelongtoaspecificuser,suchasNO yourself.'Other qualifiers,suchas/BEFOREand/SINCE,letsMOyou additionallyrestrictthesetof reservations displayed. ! PtO QualifiersOs/BEFORE=date-timeKODisplaysonlythose reservationscreatedbeforethespeci-PO$fieddateandtime.+ThedateandtimecanbestatedintheIO|standardOpenVMS date-timeformatorcanbeoneoftheAO following keywords:' YESTERDAY,TODAY,or TOMORROW.PO-Ifyouuseaspacetoseparatethedatefromthetime,re-IOmembertoenclosetheentire date-timestringindoubleHOquotes.)Forfurther informationabout specifyingOpenVMS?O7 date-timeformat,seetheOpenVMSDCL Concepts.~ TO/BRIEF (default)O(/FULLHO Determinesthetypeof information displayedabouteachJO reservation.+The/BRIEF qualifierdisplaysthe reservationLO2 identifier,thenameofthereservedmodule,the reservingNOuser,thedateofthe reservation,andthestreaminwhichLOthemoduleis reserved.,ThisdisplaynormallyfitsononeLO<line.*The/FULL qualifierdisplaysalldatabase informationPOaboutthe reservation;thisdisplayrequiresseverallinesperO reservation.  O/OUTPUT=file-specSO(Directstheprintedoutputofthiscommandtoa specifiedfile. OThe file-spec>s parameter specifiesthenameofthefile.(VDEKOcreatesanewfilewiththatname,directsthe command'sSO2printoutputtothatfile,andprintsnothingonyour terminal.UOIfthis qualifierisomitted,alloutputappearsonthe terminal.] ! U3O/SESSION=session-nameOO(Sessionsareusedto logicallygroupasetofmodulereser-POvations together, typicallytogroupallmodulesrelatedtoaNO particularsourcecode alterationor enhancement together.'ItQO2allowsall componentmodulesreservedtobetreatedasasin-LOgleentityfor subsequent replacement operations.*AsessionPOalsoallows additionalmodulestobereservedand incorporated:O<intoanexistingsessionatalatertime.Y /JODisplaysonlythose reservationsthataremembersofthe.O reservationsessiongivenbythe session-name'parame-DO5ter.*Ifyouspecifythis qualifier,donotspecify5mod-name:O parametersontheSHOW RESERVATIONcommand. Z WqFOSessionscanbe manipulatedviatheREPLACE,RESERVE,combinedintothesamesession. ! ^O/SINCE=date-timeMO(Displaysonlythose reservationscreatedafterthe specifiedQOdateandtime.(Thedateandtimecanbestatedinthestan-KOdardOpenVMS date-timeformatorcanbeoneofthefol-BO2lowing keywords:' YESTERDAY,TODAY,or TOMORROW.IfQOyouuseaspacetoseparatethedatefromthetime,rememberOOtoenclosetheentire date-timestringindoublequotes.*ForEO<further informationabout specifyingOpenVMS date-time4Oformat,seetheOpenVMSDCL Concepts. ! O/STREAM[=stream-name]QO(Displaysonlythose reservationsthatwerecreatedforthede-+O velopmentstreamgivenbythe stream-name  parameter.OIfyouomitthe stream-name% parameter,VDEonlydis-PO2plays reservationscreatedforyourcurrentdefaultstream.'IfROyouomitthewhole qualifier,VDEdisplays reservationsforallOstreams.e  K;O/TOTALOO(Showsthetotalnumberof reservationsthatmatchthespeci-IOfiedmodulenamesand usernames.(Other informationaboutPOthe individual reservationsisnotshown.(AseparatecountisO2providedforeach2mod-name2 parameter. O/USERNAME[=username]IO( SpecifiestheOpenVMSusernameofauserwhosereserva-UOtionsaretobeshown.)Ifthis qualifieris specified,onlythat4Ouser's reservationsareshown.+IftheusernameMparam-LO2eterisomitted,onlyyourown reservationsareshown.,IfQOthewhole qualifierisomitted, reservationsforallusersareOshown.  . OExamples O1. VDE>$SHOW% RESERVATION%FOO.MAR, Reservation%1&of&[FACIL]FOO.MAR? SMITH$  23-MAR-1989%V5.4, Reservation%1&of&[FACIL]FOO.MAR? JONES$  24-MAR-1989%V5.5e VDE>@Thiscommanddiplaysthe reservationsformoduleD,FOO.MARinthecurrentdefault facility,FACIL.TheBoutputshowsthatusersSMITHandJONEShavere-@servedmoduleFOO.MARinstreamsV5.4andV5.5,5 respectively. O2. VDE> SHOW%RESERVATION/FULL, Reservation%1&of&[FACIL]FOO.MAR Reservation%created&on& 23-MAR-1989& 18:09:51.80>D Reservation%created&by&user%SMITH%(Jane%Smith)>D Generation&29&(27B2)%reserved%from&stream%V5.4ED Expected% generation& expression%at% replacement%is%27B30D] Concurrent& reservations%are%allowed&D Remark:&Fix%QAR%23%again-5 Reservation%1&of&[FACIL]MOD1.PASD Reservation%created&by&user%JONES%(John%Jones)G Thisexampleshowstheoutputofthe/FULL qualifier.B< Becauseno module-name parameteris specified,theE commanddisplays reservationsforallmodulesinthe% currentdefault facility. Oe 3.e VDE>/e SHOW%RESERVATION/USERNAME=SMITH%FOO, Reservation%1&of&[FACIL]FOO.MAR? SMITH$ 23-MAR-1989%V5.4 VDE>Ed Inthisexample,only reservationsofmoduleFOO.MARB foruserSMITHare displayed.+UserSMITHhasoneG  outstanding reservation (reservation1)ofthismodule.=/@ OSHOWSCRIPT*   ATODisplaysthetype, attributes,andtextofoneormore specified1O(VDEscriptsfromtheVDE database.P &OFormatOsSHOWSCRIPT ! O DescriptionROsScriptsareusedtotailorthe processingofVDEtolocalre-HO quirements.+The descriptionoftheScriptCommands(seeO$Script Keywords,8$andthe descriptionoftheCREATESCRIPTGO|commandprovidemorecomplete explanationsoftheusesQOandtypesofscripts available,andhow particularscriptsare8O-selectedusingthe script-type qualifiers.EOTheSHOWSCRIPTcommandcanbeusedtodisplaytheUO!type,thescripttext,andvariousother attributesofthespeci-YOzfiedVDEscript,ortodisplayalistofofallscriptsthatmatch/Oa particularmodulespecification.* OKO  WFOThe/BRIEF,/FULL,and/TEXT qualifiers determinehowBOmuch informationis displayedbythecommand.0TheKO5commandonlydisplaysscriptsthatbelongstothedefaultIO developmentstream.(The/BRIEFand/FULL qaulifiersdis-LOplay informationaboutthe specifiedscript,andthe/TEXTVO> qualifierisusedtodisplaythecontentsofthe specifiedscript.  aPOScriptsare specifiedbytheirtypesand,formosttypes,byGOtheir module-nameor facility-name templates.*Acompile8O5scriptwiththe selectiontemplate[CODE] @*B5.FOR,forexam-POple,isusedtocompileallmodulesoftypeFORinfacilityMOCODE.However,ifthereisalsoacompilescriptwiththeHO>template [CODE]X.FOR,thenthatmorespecificscriptisJOusedtocompilemoduleX.FORinfacilityCODEwhiletheROmore generically specifiedscriptisusedforallotherFortran%OHmodulesinthe facility.  DOWhenyouspecifya module-nameor facility-namepa-IOrameteronascript-selection qualifier,theSHOWSCRIPTHO5command interpretswildcard charactersinthat parameterSOinoneoftwowaystoselectscriptsfordisplay.)Ifthecom-Omanduses exactmatching3"toselectscriptsfromthe database,FO>eachwildcard characterinthe parametermustexactlyLOmatchawildcard characterinascript'stemplateforthethewildcard character( J*3>)inthe qualifiermatchesboththeOasterisk( *D)andtheXinthescript templates.*Asthisex-MOampleshows,exactmatchingcanatmostdisplayonescriptFOHwhilewildcardmatchingcandisplaymanyscripts.,UseDOthe /EXACT_MATCH qualifiertorequestexactmatchingDOorthe/WILDCARD_MATCH qualifiertorequestwildcard:OR matching;wildcardmatchingisthedefault., JOWhenyouuseexact matching,youmustspecifyascript-NOtype qualifiertoselectthescriptyouwant displayed.,YouHO5mustalsospecifythescriptsegmentnumberunlessthe"Odefaultvalueapplies. W>OCommandsusedwithinscriptsare documentedinScriptO Keywords,+whilescript functionsareinScript Functions, Vand O5scripttypesarein5ScriptTypes.$5Forotherscript-relatedO commands,alsosee(CREATESCRIPT,DELETESCRIPT,OEXTRACTSCRIPT,UINVOKESCRIPT, andMODIFYO>SCRIPT.n DHVHVOO* LO* O:* (P?/* P?l* O?* U?0n \D  zz>O>O ! FO QualifiersOs/ALLVO SpecifiesthatallscriptsofalltypesforthedefaultstreambePO$ displayed.'This qualifiermayonlybeusedifwildcardmatch-QO|ingis specified(thatis,ifyoudonotspecifythe/EXACT_MOMATCH qualifier).,Ifnootherscript selection qualifieris=O- specified,this qualifierisusedbydefault.i  ?O/BRIEF (default)O(/FULLOO Determinesthe informationthatis displayedforeachscript.QOThe/BRIEF qualifierdisplaysthetypeofeachscriptandtheJO2 module-nameor facility-name specificationthatthescriptQOis associatedwith.(Inadditiontothe informationprovidedbyPOthe/BRIEF qualifier,the/FULL qualifieralsoliststhecre-TO<ationdateofthescript,thenameoftheuserwhocreatedthe6Oscript,andthescript'sremarkstring. jNOThe/TEXT qualifierisusedtodisplaythecontentsoftheO specifiedscript.f <OOf /EXACT_MATCHand/WILDCARD_MATCH,thelatterOisthedefault.% O/FETCH=mod-nameKO( Specifiesthatthedefaultstream'sFETCHscriptsmatchingOthe specifiedmod-name' specificationbe displayed.& %O/INSERT_GENERATION=mod-nameDO( Specifiesthatthedefaultstream'sINSERT_GENERATION+Oscriptsmatchingthe specifiedmod-names specificationbeO displayed.' O/LINK=mod-nameOO( Specifiesthatthedefaultstream'sLINKscriptsmatchingtheO specifiedmod-name's specificationbe displayed.( O/NEW_STREAM=fac-nameFO( Specifiesthatthedefaultstream's NEW_STREAMscripts"Omatchingthe specifiedfac-name'1 specificationbe displayed.)  O/NOKEEP=mod-nameLO( Specifiesthatthedefaultstream'sNOKEEPscriptsmatchingOthe specifiedmod-name' specificationbe displayed.*  O/REPLACE=mod-nameKO( Specifiesthatthedefaultstream'sREPLACEscriptsmatch-Oingthe specifiedmod-name' specificationbe displayed.+ O/RESERVE=mod-nameKO( Specifiesthatthedefaultstream'sRESERVEscriptsmatch-Oingthe specifiedmod-name' specificationbe displayed.,  O/SEGMENT=seg-numMO( Specifiesthesegmentnumberofthescripttodisplay.*TheOseg-num> parameter specifiestheintegersegmentnumber.MOIfyouomitthis qualifierandrequestexact matching,VDEPO2displaysthescriptwithsegmentnumber10.(IfyouomitthisNO qualifierandrequestwildcard matching,VDEdisplaysscripts&Owithallsegmentnumbers.-  O/SET_FACILITY=fac-nameHO( Specifiesthatthedefaultstream's SET_FACILITYscripts"Omatchingthe specifiedfac-name'1 specificationbe displayed.. rO /SET_STREAMIO( Specifiesthatthedefaultstream's SET_STREAMscriptbeO displayed./ ! O/STAGING=mod-nameMO( Specifiesthatthedefaultstream'sSTAGINGscriptsmatchingOthe specifiedmod-name' specificationbe displayed.0 A_O/TEXTPO( Specifiesthatthetextofthe specifiedscriptbe displayed.1 O/TOTALMO(Showsthetotalnumberofscriptsthatmatchthe specifiedGOscripttypeand module-nameor facility-name templates.LOThisisthenumberofscriptsthatwouldbe displayedifOO2youomitthe/TOTAL qualifierbutleaveallother qualifiersFOthesameonthecommand.,Other informationaboutthe.O individualscriptsisnotshown.2 ! O/UNRESERVE=mod-nameEO( Specifiesthatthedefaultstream's UNRESERVEscripts"Omatchingthe specifiedmod-name'l specificationbe displayed. 3 Jl OExamples O1. VDE>'SHOW%SCRIPT/COMPILE=[*]*.FOR> Script%to%compile%module%[*]*.FOR%(segment%10)A" Script%to%compile%module% [CODE]*.FOR%(segment%10)Aj Script%to%compile%module% [CODE]X.FOR%(segment%10)B Script%to%compile%module% [ACCTNG]*.FOR%(segment%9)C Script%to%compile%module% [ACCTNG]*.FOR%(segment%10)CB Script%to%compile%module% [ACCTNG]*.FOR%(segment%20) VDE>AThisexampleshowsthebriefoutputoftheSHOW?QSCRIPTcommand.+Becausethiscommanduseswild-Kcardmatchingbydefault,itdisplaysallcompilescripts?whose module-name templatesmatchthe wildcarded[string[ f* [] f*=4[.FOR, includingscriptswithallsegmentnum-Jbers.+Inthisexample,therearesixscriptsthatmatch these criteria. O2. VDE>;SHOW%+SCRIPT/EXACT_MATCH/FULL/COMPILE=[CODE]*.FORA Script%to%compile%module% [CODE]*.FOR%(segment%10)BD Script%added%to%database%onK 9-DEC-1989% 20:34:25.44EDa Script%added%to%database%by%user%JONES%(John%Jones))D Remark:&SCRIPT%REMARK%STRING9 VDE>HThisexampleshowsthefulloutputoftheSHOWSCRIPTG command.(ThescripttocompileFortranmodulesinfa-KY cilityCODEwascreatedbyuserJonesontheshowndateK andtime.(Theoutputincludesthescript'sremarkstring.E Becausethe /EXACT_MATCH qualifieris specified,onlyGb thecompilescriptwiththeexact module-nametemplate [CODE]  *  .FORis displayed. O3 3.:8 VDE>&SHOW%$SCRIPT/EXACT_MATCH/TEXT/NEW_STREAM=*I Script%to%create&new%stream%for&facility&*%(segment%5)D Text&of&script:N 1:&!%VDE&script%to%populate%the% directories%for&a%facility3X 2:&!%when%a&new%stream%is%created. 3:&!L 4:&EMIT%"$% DEFINE/NOLOG&OLDOBJ%",%$DIR(OBJ,%CURRENT,%PARENT)M0 5:&EMIT%"$% DEFINE/NOLOG&NEWOBJ%",%$DIR(OBJ,%CURRENT,%CURRENT)4x 6:&EMIT%"$%COPY% OLDOBJ:*.OLB%NEWOBJ:"C 7:&EMIT%"$%COPY%!",$DIR(SRC,%CURRENT,%PARENT),"*.H%-" 8:&EMIT%"' ",$DIR(SRC,%CURRENT,%CURRENT)P 9:&EXIT VDE>BOThisexampledisplaysa NEW_STREAMscriptfortheFdefault developmentstream.-Thescriptappliestoall facilities (facility 7 *3\)anditssegmentnumberis5.+TheLX/TEXT qualifierdisplaystheactualtextofthescriptonthe terminal. O)4.) VDE>)SHOW% SCRIPT/TOTAL<q Number%of%scripts%matching%specifications:%17 VDE>H(Inthisexample,the/TOTAL qualifierdisplaystheto-Ktalnumberofscriptsforthedefaultstream.)BecausenoTscripttypeis specified,thiscountincludesallscriptsofall1types.&A4 OSHOWSESSION*5 6 AmMODisplaysthenamesand attributesofoneormore specified O( reservation sessions.w7 MOFormat=OsSHOWSESSIONM [session-name[,session-name...]]8  O ParameterOs session-namePOThenameofa reservationsessionwhose attributesaretobeOO$ displayed.'Youcandisplaymorethanonesessionusingwild-PO|card charactersinthesessionname.)Thepercentsign( % )MOinasessionnamematchesanysingle characterinthepo-5O-sitionitoccupiesandtheasterisk( 29*$d-)matcheszeroormoreNO charactersinthepositionit occupies.*Thosesessionswhose?Onamesmatchthewildcardpatternare displayed.OzDonotspecifythez session-name&5z parameterifyouusethe%O/IDENTIFICATION qualifier.9 POIfyouspecifyneitherasessionnamenorthe/IDENTIFICATIONKO qualifier,VDEdisplaysallsessionsintheVDE database.:  uTOIfyoudonotspecifyasessionname,VDEdisplaysallsessions!OintheVDE database.; O DescriptionJOs Dependingonthe qualifiersyouselect,theSHOWSESSIONKOcommanddisplayseitheraone-linesummaryforeachspec-PO$ified reservationsessionoralldatabase informationforeachIO|session.+Thecommandcanalsoshowthetotalnumberof=Osessionsthatmatcha specifiedsessionname.< NOOSessionsareusedtogroupasetofmodule reservationsto-QOgether, typicallytogroupallmodulesrelatedtoa particular>O5sourcecode alterationor enhancement together.= PjO QualifiersOs/BEFORE=date-timePODisplaysonlythosesessionscreatedbeforethe specifieddateNO$andtime.*ThedateandtimecanbestatedinthestandardJO|OpenVMS date-timeformatorcanbeoneofthe following?O keywords:* YESTERDAY,TODAY,or TOMORROW.IfyouLO-useaspacetoseparatethedatefromthetime,rememberOOtoenclosetheentire date-timestringindoublequotes.*ForEOfurther informationabout specifyingOpenVMS date-time4O7format,seetheOpenVMSDCL Concepts.k>  AO/BRIEF (default)O(/FULLNO Determinesthe informationthatis displayedabouteachses-GOsion.,The/BRIEF qualifierdisplaysaone-linesummaryNO2foreachsession.*The/FULL qualifierdisplaysall available4Odatabase informationforeachsession.k? AAOOf/BRIEFand/FULL,theformeristhedefault.D@ "O/IDENTIFICATION=id-rangePO( SpecifiesthatthesessionswiththeuniqueSessionIdsgivenObytheEid-range: parameterbe displayed.(DonotspecifytheO session-name5 parameterwhenyouusethis qualifier.-A  NOVDEassignsauniqueSessionIdtoeach reservationsessionNOfortheVDElibrary.)VDEassignsSessionIdsin chronologi-VO5calordersothatthefirstsessionforthelibraryhasIdvalueSO1,thenexthasIdvalue2,andsoon.)SessionIdssharetheJOsamenumberspaceas ReplacementIds,soyoushouldex-SO>pectgapsintheSessionIds.)Whenyouusethis qualifier,allPOsessionsthatfityourother selectioncriteriaandthathave4OIdvaluesintherangegivenbytheQid-range parameterarePOH displayedin ascendingorderbySessionId.)Thisisthesame#Oas chronologicalorder.aB  7 OTheid-range;r parametercanbeasingleintegervalue,aMOrangeof integers,orawildcard character.)Iftheparame-PO5terisasingleinteger(forexample, /IDENT=5),VDEdisplaysROthesessionwiththatSessionId.(Ifthe parameterisarangeROofintegers (specifiedastwointegers separatedbyacolonasMO>in /IDENT=3:5),VDEdisplaysthesessionswithIdsinthat#Orange.,Finally,iftheZid-range& parameteristheasterisk/Owildcard character(asin/IDENT= F*&k),VDEdisplaysallses-TOHsions.(Tobe displayed,eachsessionmustalsofitall selection@Ocriteriathatyouspecifywithother qualifiers.C WBOIfyouspecifyazeroornegativenumberintheid-rangeOO parameter,thatnumberisrelativetothelargestSessionIdPO5or ReplacementIdvaluefortheVDElibrary(thelatestses-NOsionor replacement).+Forexample,ifthelatestsessionorHO replacementhasId250,then/IDENT=0is equivalenttoEO> /IDENT=250and /IDENT=-1is equivalentto /IDENT=249.D  O/OUTPUT=file-specSO(Directstheprintedoutputofthiscommandtoa specifiedfile. OThe file-spec>s parameter specifiesthenameofthefile.(VDEKOcreatesanewfilewiththatname,directsthe command'sSO2printoutputtothatfile,andprintsnothingonyour terminal.UOIfthis qualifierisomitted,alloutputappearsonthe terminal.E ! bO/SINCE=date-timeNO(Displaysonlythosesessionscreatedatorafterthespeci-POfieddateandtime.+ThedateandtimecanbestatedintheIOstandardOpenVMS date-timeformatorcanbeoneoftheAO2 following keywords:' YESTERDAY,TODAY,or TOMORROW.POIfyouuseaspacetoseparatethedatefromthetime,re-IOmembertoenclosetheentire date-timestringindoubleHO<quotes.)Forfurther informationabout specifyingOpenVMS?O date-timeformat,seetheOpenVMSDCL Concepts.F  O/STREAM[=stream-name]PO( Specifiesthatonlythose reservationsessionscreatedforthe-O developmentstreamgivenbythe stream-nameXparame-&Oterbe displayed.(Ifthe stream-name! parameterisomitted,KO2sessionsforthedefault developmentstreamare displayed.SOIfthewhole qualifierisomitted,sessionsforallstreamsareO displayed.G O/TOTALIO(Showsthetotalnumberofsessionsthatmatcheachpa-LOrameter.*Other informationaboutthe individualsessionsisBOnotshown.)AseparatecountisprovidedforeachNsession-O2nameBO2 parameter.)Wildcard charactersareusuallyusedin7Othe parameterwhenusingthis qualifier.H ! O/USERNAME[=username]MO( Specifiesthatonlythose reservationsessionscreatedbya*Ogivenuserbe displayed.'Thedusername parametergivesthe@OOpenVMSusernameofthatuser.'IfyouomittheZusernameOO2 parameter,onlyyourownsessionsare displayed.'IfyouomitLOthewhole qualifier,sessionsforallusersare displayed.I V OExamples O1. VDE>SHOW%SESSIONC Reservation%session& FIX-SORT-BUG 28-JUN-1990%ANDERSON' Reservation%session&SMITH-19 25-JUN-1990%SMITH'e Reservation%session&SMITH-29e 27-JUN-1990%SMITH VDE>AThisexampleshowsthebriefoutputoftheSHOW>tSESSIONcommand..ThisoutputshowsthesessionKname,thedatethesessionwascreated,andtheusername/%oftheusertowhomitbelongs. O2. VDE>*SHOW% SESSION/FULL& FIX-SORT-BUG, Reservation%session& FIX-SORT-BUG@D- Session&created%by%user%ANDERSON%(Andy% Anderson)8Du Session&created%on% 28-JUN-1990% 17:49:40.71(D Session&is&for%stream%V2.0)D Unique%session%number%is%26$DM Reservations%in%session:+ Reservation%1&of& [SYS]SORT.PAS,D Session&contains&1% reservations.D% Remark:&Fix%bug%in%sort%routine VDE>@#ThisexampleshowsthefulloutputoftheSHOWA|SESSIONcommand,whichincludesall availablein-) formationaboutthesession. OL 3.L VDE>L SHOW% SESSION/TOTAL5 Number%of%sessions%matching%name%*:%4 VDE>JK Thisexampleshowsthatthe/TOTAL qualifiercandisplayK thetotalnumberof reservationsessionsinthe database.)>J OSHOWSTEP*K L ! LODisplays build-step dependency informationforthe specifiedOO(buildsteps.' Build-step dependency informationconsistsoftheROkindofeachbuildstep (compile,copy,orlink),thenameofTOthemodulethatis compiled,copied,orlinkedbythestep,andQO2thenamesofthemodulesthatareinputstoandoutputsfromOthebuildstep.jM @OFormat0OsSHOWSTEPMmod-name[, mod-name...]N ! O ParameterOsmod-nameNOThenameofthemodulethatis compiled,copied,orlinkedPO$bythebuildsteptobe displayed.+ThisnameconsistsofanLO|optionalfacilitynameenclosedinsquare brackets,amod-LOulename,andanoptionaltypenameprecededbyaperiodHO-(forexample,[FACNAM]MOD1.PAS).IfnofacilitynameisRO specified,thedefaultfacilityisassumed.*IfnotypenameisTO specified,allbuildstepswiththe specifiedmodulenameinthe+O7statedfacilityare displayed.QOYoucandisplaymorethanonebuildstepatatimebyusingLO+wildcard charactersinanyofthethree componentsoftheOOmodulename.'Thepercentsign( % )inanamematchesanyPOsingle characterinthepositionitoccupiesandtheasterisk O4( w@*L4)matcheszeroormore charactersinthepositionitoc-POcupies.(Thosebuildstepsthatcompile,copy,orlinkmodulesFOwhosenamesmatchthewildcardpatternare displayed.O NLOIfno module-name parameteris specified,VDEdisplaysallRObuildstepsthatcompile,copy,orlinkmodulesinthedefaultO5 facility.P O DescriptionDOsTheSHOWSTEPcommanddisplaysbuild dependencyin-LO formationforthe specifiedbuildsteps.(ThecommandshowsPO$thekind (compile,copy,orlink)ofeachstep,thenameofNO|themodulethatis compiled,copied,orlinked,andoption-POallythenamesofallmodulesthatareinputsoroutputsofNO-thestep.*Thisisthebuild dependency informationthattheDOBUILDcommandusestoperformminimalsystembuildsMOandto determine sequencing constraintsbetweenbuildsteps.@O7TheSHOWSTEPcommandalwaysdisplays build-step>O informationforthedefault developmentstream.Q  PO QualifiersOs/ALL (default)O/COMPILEO$/COPYO|/LINKTODisplayscompilesteps,copysteps,linksteps,orallstepsforLO-the specifiedmodules.(The/COMPILE qualifierdisplaysonlyNOcompilesteps;the/COPY qualifierdisplaysonlycopysteps;MOthe/LINK qualifierdisplaysonlylinksteps;andthe/ALLputmodulehasahigherchangelevelvaluethantheoutputKOmodules,thoseoutputmodulesarenot up-to-datewithre-VOspecttothatinputmodule.'Asaresult,thebuildstepneedstoPOHbe performedto propagatethechangestotheinputmoduletoLOtheoutputmodules.(VDEusesthis informationto determineHOwhatbuildstepstoperformforminimalsystembuilds.~W  KTO/TOTALOO(Showsthetotalnumberofbuildstepsthatmatcheachspec-Oifiedmod-name4 parameter.*Other informationabouttheNOstepsisnotshown.)Wildcard charactersareusuallyusedin O2the2mod-name32 parameterswhenusingthis qualifier.X _OExamples O1. VDE>SHOW%STEP3 Compile&Step%for&module% [CODE]FOO.MAR0 Link&Step%for&module% [CODE]FOO.EXE1e Link&Step%for&module%[CODE]MOD1.EXE4 Compile&Step%for&module%[CODE]MOD1.FOR4 Compile&Step%for&module%[CODE]MOD2.FOR1< Link&Step%for&module%[CODE]MOD4.EXE4 Compile&Step%for&module%[CODE]MOD4.FOR1 Link&Step%for&module%[CODE]MOD6.EXE VDE>>Thisexample illustratestheSHOWSTEPcommandFwithout parametersor qualifiers.(Becauseno parameterM4is specified,thecommanddisplaysthedefaultformofitsNoutput:*allbuildstepsformodulesinthedefaultfacility+ (facilityCODE)are displayed. O]2.c VDE>2cSHOW% STEP/FULL& FOO/COMPILE,% MOD1/LINK3 Compile&Step%for&module% [CODE]FOO.MAR6D Dependency&links&for%stream%V2.1%follow'D; Inputs%to%the&build&step: Module% [CODE]FOO.MAR*D Outputs&from%the&build&step: Module% [CODE]FOO.OBJ6DZ Build%step&has%1&inputs%and%1%outputs1 Link&Step%for&module%[CODE]MOD1.EXE6D2 Dependency&links&for%stream%V2.1%follow'Dz Inputs%to%the&build&step:  Module%[CODE]MOD1.OBJ  Module%[CODE]MOD2.OBJ*DR Outputs&from%the&build&step:  Module%[CODE]MOD1.EXE  Module%[CODE]MOD1.MAP6D* Build%step&has%2&inputs%and%2%outputs VDE>B( ThiscommanddisplaysthecompilestepformoduleE FOO.MARandthelinkstepformodule MOD1.EXE,bothI inthecurrentdefaultfacility (facilityCODE).BecauseG2 the/FULL qualifieris specified,thecommanddisplaysL all dependencylinksforthesebuildstepsinthedefaultI stream,showingwhichmodulesareinputstoandoutputs"<fromeachbuildstep. O3. VDE>5SHOW%STEP/FULL/CHANGE_LEVEL%A.REQ,%D.B32/ Copy&Step%for&module% [FACIL]A.REQ6DI Dependency&links&for%stream%MAIN%follow'D Inputs%to%the&build&step:7 Module% [FACIL]A.REQ&with%change&level&30*D! Outputs&from%the&build&step:Ei Module% [FACIL]A.REQ&with%change&level&30& (up-to-date)6D Build%step&has%1&inputs%and%1%outputs2A Compile&Step%for&module% [FACIL]D.B326D Dependency&links&for%stream%MAIN%follow'D Inputs%to%the&build&step:7 Module% [FACIL]A.REQ&with%change&level&307a Module% [FACIL]D.B32&with%change&level&207 Module% [FACIL]B.L32&with%change&level&39*D Outputs&from%the&build&step:89 Module% [FACIL]D.$OBJ%with&change%level%397 Module% [FACIL]D.ANA&with%change&level&396D Build%step&has%3&inputs%and%2%outputsX VDE>CThisexampleshowstheoutputofthe /CHANGE_LEVELL  qualifier.'ThechangelevelvalueformoduleA.REQis30,Jxandthe``up-to-date''tagshowsthatthecopystephasEbeen performedsincethelasttimemoduleA.REQwasG)modifiedforstreamMAIN.Fromthe perspectiveoftheFVDEbuilder,A.REQisthus up-to-dateforthestreamHandthecopystepisnotneededforaminimalsystemG3build.)ThechangelevelvaluesformoduleD.B32showsJthattheoutputsofthecompilestep(withchangelevelNvalue39)are up-to-datewithrespecttoalltheinputstoL=thestepbecausetheinputshavechangelevelvaluesthatMarelessorequalto39.)Inotherwords,noinputmoduleIhaschangedsincethelasttimethestepwas performedFforstreamMAIN.R#@Y OSHOWSTREAM*Z [ AlMODisplaysthenamesand attributesofoneormore specifiedO( developmentstreams.t\ JOFormat:OsSHOWSTREAMM [stream-name[,stream-name...]]}] SO ParameterOs stream-nameHOThenameofa developmentstreamwhosenameandother-O$ attributesaretobe displayed.LOYoucandisplaymorethanonestreamusingwildcardchar-LOacters.,Thepercentsign( % )inastreamnamematchesPOpanysingle characterinthepositionitoccupiesandtheas-Oterisk( \*G)matcheszeroormore charactersinthepositionitGO! occupies.*Thosestreamswhosenamesmatchthewildcard"Ozpatternare displayed.^ &OIfyoudonotspecifya stream-name parameter,VDEO-matchesthe stream-name parameters.,The/NORMALGO qualifierdisplaysthenameandremarkstringofeachGOstream.-The/FULL qualifierdisplaysthenameandall.O7other attributesofeachstream.ra ! HHOOf/BRIEF,/NORMAL,and/FULL,/NORMAListhedefault.Db  UO /DESCENDANTSPO(Displaysall descendantsofeach specifiedstream.(Thisquali-POfierdisplaysthenameofeachstreamcreatedfromthespec-POifiedstream(thatis,whoseparentisthe specifiedstream),PO2the descendantsofeachsuchchildstream,the descendantsofQOthose descendants,andsoon.(ThedisplayisindentedsothatMOallstreamswiththesameparentareindentedbythesame&O<amountunderthatparent.c  YO/OPENO(/FROZENO/CLOSEDRO Specifiesthatonlystreamswithacertainstatusbe displayed.HO2/OPEN specifiesthatopenstreamsbe displayed,/FROZENHO specifiesthatfrozenstreamsbe displayed,and/CLOSEDPO specifiesthat permanentlyclosedstreamsbe displayed.'IfyouRO<specifya combinationofthese qualifiers,allstreamswithoneQOofthe specifiedstatusvaluesare displayed.+IfyouomitallSOthree qualifiers,allstreamsare displayed regardlessofstatus.d  O/OUTPUT=file-specSO(Directstheprintedoutputofthiscommandtoa specifiedfile. OThe file-spec>s parameter specifiesthenameofthefile.(VDEKOcreatesanewfilewiththatname,directsthe command'sSO2printoutputtothatfile,andprintsnothingonyour terminal.UOIfthis qualifierisomitted,alloutputappearsonthe terminal.e  hO/QUEUEPO(DislaysthedefaultbatchqueuestowhichbuildjobsfortheNO specifiedstreamare submitted.'This informationincludestheROnameofeachbatchqueueusedtorunthebuildjob,thepro-SO2cesscountforeachqueue,andthetotalprocesscountfortheObuildjob.Uf K+O /SUCCESSORNO(Displaysall successorchainsofeach specifiedstream.*ThisRO qualifierdisplayslistsofstreams separatedbyarrows( -> )KOtoshowhowsourcechangesare propagatedfromstreamto,O2streambytheREPLACEcommand.g O/TOTALKO(Showsthetotalnumberofstreamsthatmatchthestream-GOname parameters.+Other informationaboutthe individualOOstreamsisnotshown.)AseparatecountisprovidedforeachO2 stream-name52 parameter.*Wildcard charactersareusu-Oallyusedinthe stream-name' parameterswhenusingthisO qualifier.h OExamples O1. VDE>SHOW%STREAMC Stream% BASE-LEVEL-3"Base&level&3%for&version%2.1" Stream%V1.0(/ "Version&1.0%final%release"e Stream%V1.0-FT1//e "Version&1%Field%Test%1&release" Stream%V1.0-FT2// "Version&1%Field%Test%2&release" Stream%V1.0-FT3// "Version&1%Field%Test%3&release"< Stream%V1.1//< "Version&1.1%as%finally& released" Stream%V2.0(/ "Version&2.0%final%release" Stream%V2.0-FT,/ "Version&2%Field%Test%release" VDE>HThisexample illustratesthenormaloutputoftheSHOWFSTREAMcommand.'VDElistsallstreamsinthecurrentF4VDElibrary(thedefaultwhennostreamnameparame-Jterispresent)anddisplaysthenameandremarkstringforeachstream. O]2.] VDE>]SHOW% STREAM/BRIEF Stream% BASE-LEVEL-3 Stream%V1.05 Stream%V1.0-FT1} Stream%V1.0-FT2 Stream%V1.0-FT3  Stream%V1.1U Stream%V2.0 Stream%V2.0-FT VDE>AT ThisexampleshowsthebriefoutputoftheSHOW; STREAMcommand..VDEshowsthenameofeach! stream,butnomore. O} 3. VDE>) SHOW% STREAM/FULL% BASE-LEVEL-3 Stream% BASE-LEVEL-36D Stream%created%onJ 4-APR-1989% 14:58:16.139DZ Stream%created%by%user&SMITH&(Jane&Smith)"D Parent%stream&is&V2.0%D Stream%has&no& successorsCD2 Stream%is%not&part%of%the&main% development%thread%Dz Stream%cannot&be&deleted6D CMS%class%is%not& maintained%for&stream3D Replacements%are& immediate%for%stream)DR Stream%is%open%for%checkins?D Default& build-step%delay% interval:0& 00:00:03.22@D Default& build-job%timeout& interval:0& 00:45:05.004D* Remark:&Base%level%3%for%version%2.1 VDE>@(ThisexampleshowsthefulloutputoftheSHOWSTREAMcommand. O4. VDE> SHOW% STREAM/TOTAL&V*5F Number%of%streams%matching%name&V*:%7 VDE>DThe/TOTAL qualifierdisplaysthenumberofstreamsLUthatmatchthenamespecification.'Inthiscase,thename specification( V *00)matchesallstreamswhosenamesEbeginwiththeletterV.Thereare7suchstreams. O5. VDE>8SHOW%STREAM& MAIN/DESCENDANTS/SUCCESSOR/QUEUE Stream%MAIN%/ "Main& development&stream"D Descendant&streams:W MAIN&(main)$ V1.0&(main) V1.0-1. V1.0-2v V1.0-3 V2.0&(main) V2.1-1N V2.1-2-BL1 SUBDIR_TEST$ HICKORYD& Successor%chains:"n MAIN&->&V1.0%->%V2.0CD Default& build-job%batch%queues%to%run&1% processes:G Submit%1% processes%(scaled%from&1)&on&queue& SYS$BATCH VDE>BThisexampleshowstheoutputofthe /DESCENDANT,BU /SUCCESSOR,and/QUEUE qualifiers.'The /DESCENDANTSC qualifiershowsthewholetreeof descendantscre-Dated,directlyor indirectly,fromstreamMAIN.The@_ /SUCCESSOR qualifiershowsthattheREPLACEcom-Bmandwill propagatechangesfromstreamMAINintoHstreamsV1.0andV2.0.&The/QUEUE qualifiershowsthatHhbuildjobsforstreamMAINwillsubmitoneprocessto(queue SYS$BATCHbydefault.<@i OSHOWSYMBOL*j k DODisplays!all symbol definitions established with theO Specifiesthenameofthesymboltoshow.*If symbol-name O$includes asterisks( 0*:4$),eachasteriskistreatedasawildcardMO| characterthatmatcheszeroormore characters.'AllsymbolsBOwhosenamesmatchthewildcardpatternareshown.$n  O Description?OsTheDEFINE/COMMANDcommandallowsyoutocreateGOcommand abbreviationsintheVDEcommand language.'TheGO$SHOWSYMBOLcommandletsyouseeallthesymbolsyouO|havedefined.Mo #O QualifiersOs None.|p ! ROExamples O1. VDE>/DEFINE/COMMAND&SM&=%"SHOW%MODULE" VDE>SHOW%SYMBOL&SM Defined& commands:e SM&=%"SHOW%MODULE" VDE>:Inthisexample,theDEFINE/COMMANDcommandEtcreatesacommand abbreviationthatbindsthestring>``SHOWMODULE''tosymbolSM.TheSHOWSYMBOLE%commandthendisplaysthecommand definitionforSM. O2. VDE>SHOW%SYMBOL&* Defined& commands:C2 SETSTRMFACIL%=&"SET%STREAM&MAIN;&SET%FACILITY%RMS"z SM&=%"SHOW%MODULE" VDE>;1TheSHOWSYMBOLcommandcontainsawildcardJ characterforthesymbolname.'Asaresult,thecommand@displaysthe definitionsofalldefinedsymbols.Bq OSHOWTERMINAL*r s PODisplaysthelinewidthandpagesizethatVDEusestofor-MO(matterminaloutput.(Tochangethese settings,usetheSETOTERMINALcommand.Rt (OFormatOsSHOWTERMINALMu #O ParametersOs None.Mv #O QualifiersOs None.~w ! UTOExamples O1. VDE>SHOW%TERMINAL: Terminal%page&size:&50,%Terminal%width:%80 VDE>>TheSHOWTERMINALcommandshowsthatVDEcur-Qrentlyusesapagesizeof50linesandalinewidthof809<columnstoformatoutputtothe terminal. >x OSHOWUSER*y z  AiRODisplaysthedatabaserecordsof specifiedusersofthecurrentO(VDElibrary.l{ BOFormat2OsSHOWUSERN [username[, username...]]|  O ParameterOsusernameJOTheOpenVMSusernameofanexistinguserofthecurrentGO$VDElibrary.'VDEdisplaysthisuser'sdatabaserecord.LOYoucandisplay informationformanyusersbyusingwild-OOcard charactersinthe username.*Thepercentsign( % )inMOpausernamematchesanysingle characterinthepositionit)Ooccupiesandtheasterisk( *-B)matcheszeroormorecharac-SO!tersinthepositionit occupies.(VDEdisplaysalluserrecords:Ozwhose usernamesmatchthewildcardpattern.} NDOIfyou donot specifyausername parameteror theJO/CURRENT qualifier,VDEdisplaysalluserrecordsintheO5 database.~ ! FO DescriptionGOs Dependingonthe qualifiersyouselect,theSHOWUSERIOcommanddisplaystheOpenVMS username,fullnamestring,OO$creatorandcreationdateoftheuser'sdatabaserecord,re-MO|markstring,and authorizedanddefault privilegesforeachMO specifieduser.'ThecommandalsocanshowthetotalnumberDO-ofusersthatmatchagivenusernamespecification.f P<O QualifiersOs/BRIEF (default)O/FULLNO$ Determinesthetypeof informationaboutthe specifiedusersLO|thatis displayed.*The/BRIEF qualifierliststheusernameOOandfullnamestringofeachuser.(The/FULL qualifierdis-NO-playsthesame informationasthe/BRIEF qualifierandalsoLOthenameofthecreatoroftheuserrecordandthedateLOtherecordwascreated,theremarkstring,andtheuser's/O7 authorizedanddefault privileges.k AAOOf/BRIEFand/FULL,theformeristhedefault. O/CURRENTPO(Displaystheuserrecordofthecurrentuser.)Donotspecify Otheusername3 parameterifyouusethis qualifier.  O/OUTPUT=file-specSO(Directstheprintedoutputofthiscommandtoa specifiedfile. OThe file-spec>s parameter specifiesthenameofthefile.(VDEKOcreatesanewfilewiththatname,directsthe command'sSO2printoutputtothatfile,andprintsnothingonyour terminal.UOIfthis qualifierisomitted,alloutputappearsonthe terminal.  O/TOTALJO(ShowsthetotalnumberofusersthatmatchtheusernameMO parameters.'Other informationabouttheusersisnotshown.5OAseparatecountisprovidedforeachusernameTparame-AO2ter.(Wildcard charactersareusuallyusedinthe52username3O parameterswhenusingthis qualifier. ! bbOExamples O1. VDE>SHOW%USER  User&DOE%(John%Doe)* User&DOLOMITE&(Rock& Dolomite)%e User&JONES&(Frank%Jones)$ User&SMITH&(Jane&Smith) VDE>>cThisexample illustratestheSHOWUSERcommandHwithout parametersor qualifiers.(ThecommandliststheH usernamesandfullnamesofallusersrecordedinthemcurrent database. O2. VDE>!SHOW%USER%SMITH,%DO*$2 User&SMITH&(Jane&Smith) z User&DOE%(John%Doe)* User&DOLOMITE&(Rock& Dolomite)  VDE>CyInthisexample,theSHOWUSERcommandwithuser-Fname parametersgivesabrieflistingforuserSMITHA*andalluserswhose usernamesbeginwith``DO''. O3. VDE> SHOW%USER% SMITH/FULL$ User&SMITH&(Jane&Smith)AD2 User&added&to&database&on& 20-OCT-1988& 17:56:23.83?Dz User&added&to&database&by&user%DOE&(John&Doe)%D Remark:&OpenVMS% DeveloperD Default& privileges:R BUILD%CREFAC%CREMOD!D Authorized& privileges:' BUILD%CREFAC%CREMOD&CREUSRK VDE>M Herethe/FULL qualifierlistsalldatabase informationfor userSMITH. O 4. VDE> SHOW% USER/TOTAL%D*3 Number%of%users%matching%name%D*:%2 VDE>G Thisexampleshowshowthe/TOTAL qualifierliststheD numberofuserswhose usernamesmatchagivennameL? specification.'Inthiscase,ausername containingawild- card character( D h *2 )selectsalluserswhose usernamesN beginwith``D.''Theoutputshowsthattherearetwosuch#Iusersinthe database.Y@ OSHOWVERIFY*  MO Indicateswhethercommandinputisverified(echoed)atthePO(terminalbeforetheinputis executed.)Toenable verification,)OusetheSETVERIFYcommand.P &OFormatOsSHOWVERIFYM #O ParametersOs None.M #O QualifiersOs None. OExamples O1. VDE>SHOW%VERIFY" Not% verifying&commands VDE>:TheSHOWVERIFYcommandshowsthatcommand% verificationis disabled.  A OSHOWVERSION*  AeNODisplaystheVDEversionstringfortheversionofVDEyouO(arerunning.Q 'OFormatOsSHOWVERSIONM #O ParametersOs None.M #O QualifiersOs None. ikKK-?ONNONONL? 9OExamples O1. VDE>SHOW%VERSION< Executing%VDE&for%OpenVMS&VAX%Version&V1.5-0 VDE>BOTheSHOWVERSIONcommanddisplayswhatversionof!O VDEyouarerunning.J i&K@ KK o 9 OSPAWN* r KHNOCreatesa subprocessofthecurrentprocess.*ThecontextofMO(the subprocessiscopiedfromthecurrentprocess.*YoucanFOusetheSPAWNcommandtoleaveVDE temporarily,per-MOformother functions(suchasreadingyourmail),andthenO2returntoVDE.T *OFormatOsSPAWNN [command]  FO ParameterOscommandGO SpecifiestheDCLcommandstringthatexecutesintheIO$created subprocess.(Whenthecommand completes,thesub-JO|process terminatesandcontrolisreturnedtotheparentOOprocess.,Ifthis parameterisnot specified,a subprocessisJO-createdthat transferscontroltotheDCLcommandlevel. O QualifiersOs/INPUT=filespecJO Specifiesaninputfile containingoneormoreDCLcom-LO$mandstringstobeexecutedbythespawned subprocess.*IfNO|youspecifyacommandstringalongwithaninputfile,theHOcommandstringis processedbeforethecommandsintheMO-inputfile.-After processingis complete,the subprocessisO terminated.~ T#O/LOGICAL_NAMES (default)O(/NOLOGICAL_NAMESPO SpecifieswhetherthelogicalnamesoftheparentprocessareNOcopiedtothe subprocess.(Whenyoudonotwantthesubpro-SO2cesstousethelogicalnamesoftheparentprocess,enterthe&O qualifier/NOLOGICAL_NAMES.Y ! U/O/OUTPUT=filespecPO( IdentifiestheoutputfiletowhichtheresultsoftheSPAWNKO operationarewritten.+Ifyouomitthe/OUTPUT qualifier,MOoutputiswrittenbydefaulttothecurrent SYS$OUTPUTde-JO2vice.(Wheneveryouusethe/NOWAIT qualifier,youshouldOOalsousethe/OUTPUT qualifiertospecifyanewoutputdes-LO tination.*Doingsopreventsoutputfrombeing displayedonHO<yourterminalwhileyouareenteringnewVDE commands. ! "O/PROCESS=subprocess-nameQO( Specifiesthenameofthe subprocess.&Thedefaultnameofthe#O subprocessis USERNAME_ C n s. O/SYMBOLS (default)O( /NOSYMBOLSKO DetermineswhetherthesystempassesDCLglobalandlocalDOsymbolstothe subprocess.'Thedefaultis /SYMBOLS. nO/WAIT (default)O(/NOWAITIOControlswhetherVDEwaitsuntilthe subprocessiscom-IOpletedbeforeallowingmoreVDEcommandstobeentered.IO2The/NOWAIT qualifierallowsyoutoenternewVDEcom-IOmandswhilethe specified subprocessisrunning.-IfyouIOspecify/NOWAIT,youshouldalsousethe/OUTPUTquali-TO<fiertodirecttheoutputstreamtoafileratherthantoyourKO terminal.*Doingsopreventsyourterminalfrombeingused7Obymorethanoneprocesssimultaneously.W   - OExamples O1. VDE>SPAWN  $SHOW%TIME 24-MAR-1989&16:35:14 e $eLOGOUTE Process%JONES_1%logged%out&at& 24-MAR-1989& 16:35:17.37. %VDE-I-SPAWNED,% subprocess%spawnedA< %VDE-I-RETURNED,&control%returned%to%process%JONES VDE>>TheSPAWNcommandwithout parameterscreatesaCL subprocessthatpromptsforDCLcommandinput.*The>userenterstheSHOWTIMEcommandattheDCLGpromptandthetimeis displayed.,TheuserthenlogsJUoutofthe subprocess,whichreturnscontroltotheVDEsession. O&2.& VDE>&SPAWN&SHOW%TIMEn 15-OCT-1988%15:34:07. %VDE-I-SPAWNED,% subprocess%spawnedA %VDE-I-RETURNED,&control%returned%to%process%JONESF VDE>IThisexampleshowshowtocreatea subprocessthatex-@ ecutestheDCLcommandSHOWTIMEwhileyouareDfusingVDE.Afterthecommandis completed,youare6returned immediatelytotheVDEprompt. O6 3.6 VDE>i6 SPAWN%MAIL~ MAIL>~ READ/NEW D . D . DV . MAIL> EXIT. %VDE-I-SPAWNED,% subprocess%spawnedA. %VDE-I-RETURNED,&control%returned%to%process%SMITHv VDE>I Thisexampleshowshowtocreatea subprocessthatin-G= vokestheOpenVMSMAILUtilitywhileyouareinVDE.E WhenyouexitfromtheMAILUtility,the subprocess6  disappearsandtheVDE>promptreturns. Of 4.f VDE>-f SPAWN&/OUTPUT=TIME.DAT%SHOW%TIME. %VDE-I-SPAWNED,% subprocess%spawnedA %VDE-I-RETURNED,&control%returned%to%process%SMITH> VDE>>EXIT  $TYPE%TIME.DAT 15-OCT-1988%15:34:07  $JThisexampleshowshowtocreatea subprocesstoinvoke?theDCLcommandSHOWTIMEwhileyouareusingF6theVDEUtility.*The/OUTPUT qualifier specifiesthatHtheresultsoftheSHOWTIMEcommandbewrittentoa filenamed TIME.DAT. O_5._ VDE>,_SPAWN&/NOLOGICAL_NAMES%SET&HOST _Node:MARS D. D7. D.  $LOGOUT' CRAMMER&logged%out%at%...;x %REM-S-END,%control&returned&to&node%_BETA::. %VDE-I-SPAWNED,% subprocess%spawnedA %VDE-I-RETURNED,&control%returned%to%process%JONESP VDE>EThisexampleshowshowtousetheSPAWNcommandtoEcreatea subprocesswhichusestheSETHOSTcommandIptologontoanothernode.(ToleavenodeMARSandmoveBbacktonodeBETA,entertheDCLcommandLOGOUT.@!The/NOLOGICAL_NAMES qualifierpreventsthelogi-Lycalnamesoftheparentprocessfrombeingcopiedtothe subprocess.&-D OSTART BUILD_JOB*  POStartsthe executionofabuildjobby submittingbuildpro--O(cessestoOpenVMSbatchqueues.%ORequiresBUILD privilege.x NOFormat>OsSTART BUILD_JOBM [stream-name[,stream-name...]] =O ParameterOs stream-nameJOThenameofa developmentstream.)Themostrecentbuild-O$jobinthisstreamisstarted.%  IOYoucanstartbuildjobsformorethanone developmentIOstreambyusingwildcard charactersinthestreamname.OO5Thepercentsign( % )inanamematchesanysinglechar-GOacterinthepositionitoccupiesandtheasterisk( 9*k)matchesMOzeroormore charactersinthepositionit occupies.,BuildKO>jobsarestartedforthosestreamswhosenamesmatchtheOwildcardpattern. OIfyouomitthe stream-name& parameter,VDEstartsthe>Omostrecentbuildjobforthedefaultstream.. O DescriptionEOsTheSTART BUILD_JOBcommandstartsthemostrecentlyKOcreatedbuildjobineachstreamthatmatchesthespeci-LO$fiedstreamnames.+(Tocreateabuildjob,usetheBUILDO| command.)" ! IOTostartabuildjob,theSTART BUILD_JOBcommandsub-KOmitsoneormorebatchjobstotheOpenVMSbatchqueuesMO5 associatedwiththebuildjob.,TheneachbatchjobrunsaLOprogramcalled VDE$BUILDthatexecutesthebuildstepsbe-VOlongingtothebuildjob.'ThestepsareexecutedinaloopuntilIO>allthestepsaredone.*The VDE$BUILDprogramdoesthe,O followingforeachbuildstep:  ] `mHmTheprogramlooksinthedatabaseforthenextavail-Vablebuildstep.'(Abuildstepis availableifitisnotwaitingOforanotherstepto complete.))Ifnostepis available,theHwprogramwaitsafewsecondsbeforelookingforanother! availablebuildstep. `OLOWhentheprogramfindsabuildsteptorun,itlooksupKtheVDEscriptforthatstepand,fromthescript,gen-FeratestheDCLcommandsneededtorunthestep.*TheBYprogramthensendstheDCLcommandstoasubpro-Qcessthatexecutesthebuildstep,andwaitsforthestepto  complete. `HAfterthestep completes,theprogramrecordsthecom-Ppletionstatusofthestepinthe database.'Astep completesK:either successfullyorwitherrors.*Ifthestep completesG successfully,theprogramupdatesthestep'sbuildde-Ipendency informationinthedatabaseandthenlooksfor%Danothersteptoperform.S  )IOByrunningthisprograminmany processessimultaneouslyUOforasinglebuildjob,youcan distributethe executionofyourJO5buildacrossseveral processors(whetherinasinglema-JOchineorinmultiplemachinesina cluster).+The/QUEUERO qualifier specifiesthebatchqueuestorunthebuildjob.)TheFO>/PROCESS_COUNT qualifier specifiesthetotalnumberofJO processesVDEsubmitstothebatchqueues performingtheObuildjob.E ! DOIfyouspecifythe/QUEUEand/PROCESS_COUNTquali-FOfierswiththeSTART BUILD_JOBcommand,theyoverrideOO5anypreviousspecifications.)IfyoudonotspecifythemwithFOtheSTART BUILD_JOBcommand,VDEusesthequeuesandJOprocesscount specifiedwiththeBUILDcommandthatcre-OO>atedthebuildjob.*Ifneitherwas specifiedwiththeBUILDMOcommand,VDEusesthedefaultqueuesandprocesscountforOthestream. JOYoucannotstartabuildjobthatis currentlyrunning.EOHowever, youcansuspendsuchabuildjobwiththeDO5SUSPEND BUILD_JOBcommandandthenrestartitusingGOtheSTART BUILD_JOBcommand.)(Thisisuseful,forex-MOample,ifyouwanttochangethebatchqueuesrunningtheTO>buildjob.))Also,youcannotstartabuildjobthathasalreadyO completed execution. mO QualifiersOs/AFTER=date-timeQO Indicatesthatthebuildjobbegins executionafterthespeci-QO$fieddateandtime.'ThedateandtimearestatedinstandardMO|OpenVMS date-timesyntax.'This qualifier specifiesthestartPOtimeforeachofthebatchjobsthatexecutethebuildjob.u ! KO/CONFIRMO( /NOCONFIRM (default)IOControlswhetherVDEasksyoutoconfirmthatyouwantKOeachbuildjobstarted.(The/CONFIRM qualifiercausesVDELO2toprintamessageforeachbuildjobaskingwhetheryouOOwantthatbuildjobstarted.+IfyouanswerYES(orY),theVObuildjobisstarted.(IfyouanswerNO(orN),thebuildjobisKO<notstarted.'The /NOCONFIRM qualifiercausesVDEtostartJOthe specifiedbuildjobswithoutaskingfor confirmation. ! UO/LOG (default)O(/NOLOGLOControlswhetherlogmessagesareprintedaftereachbuildNOjobhasstarted.(The/LOG qualifiercausessuchmessagestoLO2beprintedandthe/NOLOG qualifier suppressesthem.'TheseMOmessagesindicatethatthebuildjobhasstartedandshowsMOhowmany processeshavebeen submittedtoeachbatchqueue,O< associatedwiththebuildjob.  r#O/PROCESS_COUNT=proc-countOO( Specifiesthetotalnumberof processestoexecutethebuildROjob.'VDEcreatesthe processesby submittingbatchjobstotheMOqueues specifiedbythe/QUEUE qualifierortothedefaultNO2queuesforthedefaultstream.(Thenumberof processesthatMOVDEcreates(thatis,thenumberofOpenVMSbatchjobsit,Osubmits)is specifiedwiththev proc-countW parameter.*ThisMO< parameterthus specifiesthedegreeof parallelismyouwantOforthebuildjob. ! /O/QUEUE=(queue-name[,queue-name...])PO( SpecifiestheOpenVMSbatchqueuestowhichthebuildjobisO submitted.'Each queue-name* parameter specifiesonebatchOqueue.(The queue-name.! parametermay optionallybefol-PO2lowedbyaprocesscountin parentheses.'Thiscount specifiesNOthenumberof processesstartedonthequeuethatrunstheLObuildjob.'Forexample, SYS$BATCH(3)causesthree build-jobLO< processestobe submittedtoqueue SYS$BATCH.Ifthepro-QOcesscountisomitted,oneprocessis submittedtothequeue.  }%OIfyouonlyspecifyone queue-name! parameter,theparen-#Othesesmaybeomitted.l  tBBOIfyoualsousethe/PROCESS_COUNT qualifier, theCO/PROCESS_COUNT qualifierstatesthetotalnumberofQO5 build-job processestocreate.'Inthatcase,theprocess-countsOattachedtothe queue-name% parametersonthe/QUEUEQO qualifierareusedasscalingfactorsto distributethebuild-LO>job processesamongthequeuesproportionally.(Forexample,GOifyouspecifyqueues HI_BATCH, HO_BATCH(3)andato-SOtalprocesscountofeight,thentwo processesare submittedtoDOHqueueHI_BATCHandsix processestoqueue HO_BATCH.SOIfthetotalprocesscountdoesnotdivideevenlyintothesumOOofthescalingfactors,the remaining processesare allocatedTORtothequeuesintheorderthequeuesarelisted.*IfthetotalPOprocesscountisnine,forexample,theoneextraprocessisGO allocatedtoqueueHI_BATCHbecauseHI_BATCHislistedO[first.l BOExamples O1. VDE>START& BUILD_JOBY %VDE-I-BLDJOBSIZ,%build%job%15%for&stream%V2.0-3%consists%of%25%stepsO %VDE-I-BLDJOBSTARTING,&starting&build&job%15%for%stream&V2.0-3Pe %VDE-I-BLDJOBENT,%entry%number%549& submitted%to%queue% SYS$BATCHYD Job% VDEBUILD_0001%(queue%CLUSTER_BATCH,%entry%549)%started&on& FOO_BATCHP %VDE-I-BLDJOBENT,%entry%number%550& submitted%to%queue% SYS$BATCHYD< Job% VDEBUILD_0001%(queue%CLUSTER_BATCH,%entry%550)%started&on& PHI_BATCHa %VDE-I-BLDJOBSTARTED,%build%job&15&for%stream%V2.0-3&started%with%2& processes VDE>M;Thiscommandstartsthemostrecentbuildjobforthede-Kfault developmentstream,inthiscase,buildjob15forFstreamV2.0-3.*Twobatch processesare submitted,one@Etobatchqueue FOO_BATCHandonetoqueuePHI_BATCH. O2.  VDE>L START& BUILD_JOB%0V5.3/AFTER=15:00/PROCESS_COUNT=1/QUEUE=SYS$BATCHVh %VDE-I-BLDJOBSIZ,%build%job%12%for&stream%V5.3&consists&of&2%stepsM %VDE-I-BLDJOBSTARTING,&starting&build&job%12%for%stream&V5.3[ %VDE-I-BLDJOBAFTER,&build&job%to%be%started&after& 12-JUL-1989& 15:00:00.00P@ %VDE-I-BLDJOBENT,%entry%number%583& submitted%to%queue% SYS$BATCHaD Job% VDEBUILD_0001%(queue% FOO_BATCH,%entry%583)&holding%until% 12-JUL-1989%15:00_ %VDE-I-BLDJOBSTARTED,%build%job&12&for%stream%V5.3%started&with%1% processes VDE>KThisexamplestartsthemostrecentbuildjob(buildjobJ12)forstreamV5.3.(The/AFTER qualifier specifiesthatK8 thebatchjobstartsafter15:00hours(3:00pm)ofthe9 currentday.,The/PROCESS_COUNTand/QUEUEM  qualifiersspecifythatasinglebatchjobis submittedtoIA queue SYS$BATCHtorunthebuildjob.&Thelogmessages4 showthatthishappenedas requested.5 C OSTOP BUILD_JOB*  ! VOStopsthe executionofanexistingbuildjob.&Astoppedbuildjob O(cannotbe restarted.%ORequiresBUILD privilege.w MOFormat=OsSTOP BUILD_JOBM [stream-name[,stream-name...]] =O ParameterOs stream-nameJOThenameofa developmentstream.)Themostrecentbuild.O$jobforthisstreamisstopped. WNOYoucanstopbuildjobsformorethanonestreambyusingJOwildcard charactersinthestreamname.*ThepercentsignRO5( % )inanamematchesanysingle characterintheposition-Oitoccupiesandtheasterisk( [*+)matcheszeroormorechar-ROactersinthepositionit occupies.*BuildjobsarestoppedforFO>thosestreamswhosenamesmatchthewildcardpattern. OIfyouomitthe stream-name% parameter,VDEstopsthe>Omostrecentbuildjobforthedefaultstream.  ZO DescriptionCOsTheSTOP BUILD_JOBcommandstopsthemostrecentlyMOcreatedbuildjobforeachstreamthatmatchesa specifiedNO$streamname.*Whenabuildjobisstopped,itismarkedasQO|stoppedinthe database.'Any processes executingthebuildjobPOstop executingassoonastheyreadthenewjobstatusfromKO-the database.*Thiscommandstopsabuildjob permanently:IOitcanneverbe restarted.(UsetheSTOP BUILD_JOBcom-SOmandtostoparunningbuildjobortomarkanexistingbuildRO7jobasstopped(evenifithasneverbeen started).*AftertheTOmostrecentbuildjobforastreamisstopped,youarefreetoSOcreateanewbuildjobforthatstreambecausethestoppedjob?OAcannotexecuteand interferewiththenewjob.  NMOYoucannotstopabuildjobthathasalreadybeenstoppedLOorthathasalready completed execution.)BecausesuchjobsGO5cannotexecuteagain,thereisnoneedtostopthem.  P^O QualifiersOs/CONFIRMO /NOCONFIRM (default)IO$ControlswhetherVDEasksyoutoconfirmthatyouwantKO|eachbuildjobstopped.'The/CONFIRM qualifiercausesVDELOtoprintamessageforeachbuildjobaskingwhetheryouOO-wantthatbuildjobstopped.*IfyouanswerYES(orY),theVObuildjobisstopped.(IfyouanswerNO(orN),thebuildjobisJOnotstopped.'The /NOCONFIRM qualifiercausesVDEtostopJO7the specifiedbuildjobswithoutaskingfor confirmation. ! O/LOG (default)O(/NOLOGLOControlswhetherlogmessagesareprintedaftereachbuildQOjobisstopped.'The/LOG qualifiercausessuchmessagestobeHO2printedandthe/NOLOG qualifier suppressesthem.*TheseROmessagesindicatethatthebuildjobhasbeenstoppedandthatCOthedatabase transactionhas successfully committed. V *uOExamples O1. VDE>STOP% BUILD_JOBJ %VDE-I-BLDJOBSTOP,%build%job&15&for%stream%V2.0-3&stopped VDE>LThiscommandstopsthemostrecentbuildjobforthede-Lfault developmentstream.'Inthiscase,thedefaultstreamM<isV2.0-3anditsmostrecentbuildjobisbuildjob15. O2. VDE>STOP% BUILD_JOB&V5.3H %VDE-I-BLDJOBSTOP,%build%job&12&for%stream%V5.3%stoppedJ VDE>MThiscommandstopsthemostrecentbuildjobfor specifiedstreamV5.3.MD OSTOP SUBPROCESS*   NOStopsthe subprocessthatVDEusestoexecutetheDCLcom-MO(mandfilesit generatesfromVDEscripts.'VDE automaticallyMO terminatesthis subprocesswhenyouexitfromVDE(orfromKOtheVDEkept subprocess),butthiscommandallowsyoutoOO2 explicitly terminatethescript subprocessinordertoreduce9Othenumberofopen subprocessesyouhave.T *OFormatOsSTOP SUBPROCESSM #O ParametersOs None.M #O QualifiersOs None. mOExamples O1. VDE>STOP% SUBPROCESSGThiscommandstopsthe subprocessVDEusestoexecute;TDCLcommandfiles generatedbyVDEscripts. F OSUSPEND BUILD_JOB*  OOSuspendsthe executionofanexistingbuildjob.)A suspended)O(buildjobcanbe restarted.%ORequiresBUILD privilege.z POFormat@OsSUSPEND BUILD_JOBM [stream-name[,stream-name...]] =O ParameterOs stream-nameJOThenameofa developmentstream.)Themostrecentbuild0O$jobforthisstreamis suspended."  OOYoucansuspendbuildjobsformorethanonestreambyus-IOingwildcard charactersinthestreamname.+ThepercentSO5sign( % )inanamematchesanysingle characterinthepo-5Ositionitoccupiesandtheasterisk( 2*$d)matcheszeroormoreNO charactersinthepositionit occupies.,Buildjobsaresus-IO>pendedforthosestreamswhosenamesmatchthewildcardOpattern. OIfyouomitthe stream-name( parameter,VDEsuspendsthe>Omostrecentbuildjobforthedefaultstream.N ! $O Description?OsTheSUSPEND BUILD_JOBcommandsuspendsthemostLOrecentlycreatedbuildjobforeachstreamthatmatchesaOO$ specifiedstreamname.*Whenabuildjobis suspended,itisLO|markedas suspendedinthe database.'Any processesexecut-SOingthebuildjobstop executingassoonastheyreadthenewTO-jobstatusfromthe database.'A suspendedbuildjobisnotper-NOmanentlystopped,however:'itcanbe restartedwithaSTART;O BUILD_JOBcommand.+UsetheSUSPEND BUILD_JOBKO7commandto temporarilystoparunningbuildjob;youcanTOrestartthe suspendedjoblaterorrestartiton differentbatchUOqueues.'YoushouldalsosuspendabuildjobifoneofthenodesUOAitisrunningonfails; suspendingabuildjobandthenrestart-ROingitallowsthebuildstepsthatwererunningonthefailedOnodeto reexecute.   NROYoucanonlysuspendabuildjobthatis currentlyqueuedforRO executionorrunning.(ThereisnoneedtosuspendabuildjobRO5thathasnotyetbeenstartedorthathas completed execution. ! qO QualifiersOs/CONFIRMO /NOCONFIRM (default)IO$ControlswhetherVDEasksyoutoconfirmthatyouwantHO|eachbuildjob suspended.*The/CONFIRM qualifiercausesLOVDEtoprintamessageforeachbuildjobaskingwhetherQO-youwantthatbuildjob suspended.'IfyouanswerYES(orY),TOthebuildjobis suspended.'IfyouanswerNO(orN),thebuildFOjobisnot suspended.+The /NOCONFIRM qualifiercausesMO7VDEtosuspendthe specifiedbuildjobswithoutaskingforO confirmation.  O/LOG (default)O(/NOLOGLOControlswhetherlogmessagesareprintedaftereachbuildOOjobis suspended.(The/LOG qualifiercausessuchmessagestoLO2beprintedandthe/NOLOG qualifier suppressesthem.'TheseROmessagesindicatethatthebuildjobis suspendedandthatthe>Odatabase transactionhas successfully committed. OExamples O1. VDE>SUSPEND% BUILD_JOBL %VDE-I-BLDJOBSUSP,%build%job&15&for%stream%V2.0-3& suspended VDE>JThiscommandsuspendsthemostrecentbuildjobfortheMdefault developmentstream,inthiscase,buildjob15for<streamV2.0-3. O2. VDE>"SUSPEND% BUILD_JOB&V5.3J %VDE-I-BLDJOBSUSP,%build%job&12&for%stream%V5.3% suspendedJ VDE>EThiscommandsuspendsthemostrecentbuildjobforJstreamV5.3.(Thestreamnameis specifiedinthisexam-jple.#= O UNRESERVE*  HOCancelsoneormoremodule reservationsinthedefaultO( developmentstream.&ORequiresRESREP privilege.i ?OFormat/Os UNRESERVENmod-name[, mod-name...] ! PxO ParameterOsmod-nameHO Specifiesoneormoresourcemoduleswhose reservationsOO$aretobe canceled.)ThemodulenameconsistsofanoptionalKO|facilitynameenclosedinsquare brackets,amodulename,KOandanoptionaltypenameprecededbyaperiod(suchasGO-[FACIL]MOD1.MAR).Ifthefacilitynameisomitted,theUOmoduleisassumedtobelongtothedefault facility.'IfthetypePOnameisomitted,allsourcemoduleswiththe specifiedmodule:O7nameinthegivenfacilityare unreserved.2  MOYoucancancel reservationsformorethanonemoduleusingLOwildcard charactersinanyofthethree componentsoftheOO5modulename.'Thepercentsign( % )inanamematchesanyPOsingle characterinthepositionitoccupiesandtheasterisk O( w*N)matcheszeroormore charactersinthepositionitoccu-IO>pies.)Thesourcemoduleswhosenamesmatchthewildcard#Opatternare unreserved.y  OKOYoucanalso unreservemultiplemodulesby specifyingtheKOnameofasourcegroupinsteadofamodulename.*SourceFO5groupsarecreatedwiththeCREATEGROUPcommand.(IfNOyouspecifyagroupname,eachmodulethatisamemberof%Othegroupis unreserved.{ ! QO DescriptionBOsThe UNRESERVEcommandcancelsanexistingreserva-POtionforeach specifiedmodule.'EachmodulemustbeasourceCO$module currentlyreservedwiththeRESERVEcommand.IO|Themodule reservationiscanceledonlyforthedefaultO developmentstream.m  CJOIfyouhavemorethanone reservationofamodule,youROmustspecifytheexact reservationtobe replaced.'YoudothisEO5byusingthe/IDENTIFICATION qualifier.)UsetheSHOWFO RESERVATIONcommandto determinetheidentificationofOeach reservation.-  HOTocancelanotheruser's reservation,youmustusetheGO /USERNAME qualifiertospecifytheOpenVMSusernameofKO5thatotheruser.'YoumusthavetheUSERNAME privilegeto)Ousethe /USERNAME qualifier.& AO ReservationscreatedbytheCREATEMODULEcommandO cannot:[becanceledwiththe UNRESERVEcommand.+ToOO5cancelthereservation(s)anddeletethese module(s),usethe"ODELETEMODULEcommand. O QualifiersOs/CONFIRMO /NOCONFIRM (default)IO$ControlswhetherVDEasksyoutoconfirmthatyouwantEO|eachmodule unreserved.*The/CONFIRM qualifiercausesIOVDEtoprintamessageforeachmodulethatyouspec-KO-ifyaskingwhetheryouwantto unreservethatmodule.+IfNOyouanswerYES(orY),the reservationis canceled.+IfyouIOanswerNO(orN),the reservationisnot canceled.-TheAO7 /NOCONFIRM qualifiercausesVDEto unreserveeach@O specifiedmodulewithoutaskingfor confirmation. p#O/IDENTIFICATION=res-identOO( Specifiesthe reservationthatis canceled.+This qualifierisJOrequiredwhenyouhavemultiple reservationsofthesame0Omoduleinthedefaultstream.)TheE res-ident parameterisOO2the reservation identifierofthe reservationtobe replaced.MOThe reservation identifierisasmallintegervalueortheHO identifieryou specifiedwhen reservingthemodule.,Use=O<theSHOW RESERVATIONcommandto determinethe9O reservation identifierofeach reservation.  O/LOG (default)O(/NOLOGKOControlswhetherlogmessagesareprintedaftereachmod-OOuleis unreserved.'The/LOG qualifiercausesthemessagestoJO2beprintedandthe/NOLOG qualifier suppressesthem.)TheLOmessagesindicatethateachmodulehasbeen unreservedandIOthatthedatabase transactionhas successfully committed.] ! U3O/SESSION=session-nameOO(Sessionsareusedto logicallygroupasetofmodulereser-POvations together, typicallytogroupallmodulesrelatedtoaNO particularsourcecode alterationor enhancement together.'ItQO2allowsall componentmodulesreservedtobetreatedasasin-LOgleentityfor subsequent replacement operations.*AsessionPOalsoallows additionalmodulestobereservedand incorporated:O<intoanexistingsessionatalatertime. tKOThe/SESSION qualifiercausesallmodule reservationscom-Oprisingthe session-name.5 reservationsessionare canceled,MO5andthatthesessionbedeletedfromtheVDE database.+If>Oyouspecifythis qualifier,youcannotspecifymod-name2O parametersonthe UNRESERVEcommand. Z WqFOSessionscanbe manipulatedviatheREPLACE,RESERVE,combinedintothesamesession.  O/STREAM=stream-nameLO( Specifiesthatthemodulesbe unreservedfromthedevelop-&Omentstreamgivenbythe stream-nameM parameter.(IfthisPO qualifierisomitted,themodulesare unreservedfromthede-PO2fault developmentstream.(Ifthis qualifierisomittedandnoLOdefaultstreamisdefined,VDEpromptsyouforthestreamOname.O  K%O/USERNAME=usernameNO( Specifiesthatanotheruser's reservationistobe canceled. OTheusername8 parameteristheOpenVMSusernameoftheJOotheruser.'YoumusthavetheUSERNAME privilegetouseO2this qualifier. OExamples O1. VDE># UNRESERVE%[FACIL]FOO.MARP %VDE-I-UNRESERVED,% reservation%for&module%[FACIL]FOO.MAR%canceledM" %VDE-I-COMMIT,%database% transaction%has% successfully& committedj VDE>HThisexamplecancelsanexisting reservationformoduleG1FOO.MARinfacilityFACIL.Thelogmessagesshowthat8the reservationwas successfully canceled. O2. VDE> UNRESERVE%MOD1PO %VDE-I-UNRESERVED,% reservation%for&module%[COPY]MOD1.PAS%canceledM %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE>ENThiscommandcancelsthe reservationsforallsourceBmodulescalledMOD1inthecurrentdefaultfacil-City,COPY.Becausethereisonlyonesuchmodule,GW MOD1.PAS,the reservationforthatmoduleis canceled. O3. VDE>5"UNRESERVE/IDENTIFICATION=2/CONFIRM%FOO.MAR5 Unreserve%module&[FACIL]FOO.MAR&?%[No]: YESPe %VDE-I-UNRESERVED,% reservation%for&module%[FACIL]FOO.MAR%canceledM %VDE-I-COMMIT,%database% transaction%has% successfully& committedAInthisexample, reservation2ofmoduleFOO.MARAtin the!current default facility is canceled.3TheA/IDENTIFICATION qualifierisrequiredifyouhaveF% morethanone reservationofthesamemoduleatthe@~ sametime.-The/CONFIRM qualifiercausesVDEtoG askfor confirmationbefore unreservingthemodule.)InN/ thiscase,theuseranswers``YES'',andthe reservationis  canceled.:F OVERIFY GENERATION*   KXOOVerifiesthata specifiedsetofmodule generationsexistinGO(the correspondingCMS librariesand optionallyrecoversHOanymissing generations.)ThiscommandthusensuresthatOOCMS librarieswithintheVDElibraryare consistentwiththe+O2contentsoftheVDE database.r HOFormat8OsVERIFY GENERATIONMmod-name[, mod-name...]  bO ParameterOsmod-nameIOThenameofamodulewhose generationsaretobever-IO$ified./ThemodulenameconsistsofanoptionalfacilityFO|nameenclosedinsquare brackets,amodulename,andIOanoptionaltypenameprecededbyaperiod.,AnexampleKO-is[FACIL]MOD1.PAS.Ifnofacilitynameis specified,theROdefaultfacilityisassumed.*Ifnotypenameis specified,allOOmoduleswiththe specifiedmodulenameinthegivenfacilityO7are verified.NOYoucanverify generationsformorethanonemodulebyus-LO+ingwildcard charactersinanyofthethree componentsofOOthemodulename.'Thepercentsign( % )inanamematchesPOanysingle characterinthepositionitoccupiesandtheas-O4terisk( \@*G4)matcheszeroormore charactersinthepositionitJO occupies.( Generationsforthosemoduleswhosenamesmatch0Othewildcardpatternare verified. OIfyouomitthemod-name+b parameter,VDEverifiesgener-@Oationsforallmodulesinthedefault facility. ! mmO Description?OsTheVERIFY GENERATIONcommandverifiesthattheMO generationsyouspecifyactuallyexistintheCMS librariesGO$ belongingtoyourVDElibrary.,ThiscommandshouldbeOO|usedifthereisreasontothinkthatoneormoreCMSli-MObrariesintheVDElibrarymaynotbe consistentwiththeNO-VDE database.(Sucha situationcanariseanytimeyouhaveOOhadtorestoretheVDE library'sdatabasefromback-upfilesMOoritsCMS librariesfromback-uptapes.(ProvidedyouhaveNO7enabled journalling,theVDEdatabasecanbefully recoveredSOafterafailureuptoand includingthelast completeddatabaseNO transactionbeforethefailure.)However,thecontentsoftheLOA associatedCMS librariescannotbe recoveredpastthelastOO availableback-up.(Ifyoubackupyourdisksdaily,theCMSTO librariesmaythusbeasmuchasadayoutofdate.(Asare-POJsult,theCMS librariesmaybemissing generationscreatedby;OREPLACEorPERFORM REPLACEMENTcommandsthatOOwereenteredafterthatlastback-up,whiletheVDEdatabaseGOTcontains up-to-date informationaboutthose generations. ! `>OTheVERIFY GENERATIONcommand thereforeassumesIOthattheVDEdatabasecontainscorrect informationaboutGO5what generationsshouldbefoundintheCMS librariesQOforyourVDElibrary.(Ifitfindsany differencesbetweentheRO generationsthatthedatabasesaysoughttoexistandthegen-SO>erationsthatactuallyexistintheCMS libraries,VDEprintsaLOmessageforeachsuch generation.) Optionally,VDEcanalsoPOprintamessageforeach generationthatwas correctlyfound.9 ! BOIfyouspecifythe/RECOVER qualifier, theVERIFYEO GENERATIONcommandwillattempttorecoveranymiss-MO5ing generations.)Ifthemissing generationswerecreatedbyFOREPLACEcommandsandifthe replacementswerequeued,MOVDE retrievesthetextofeachmissing generationfromtheJO>stagingareaforthequeued replacementthatcreatedtheOO generation.(The retrievedtextistheninsertedintotheCMSKOlibrary.'For immediate replacements,VDEdoesnotmaintainXOHstagingareas,butifyouhaveafilethatcontainsthetextofaNOmissing generation,youcanspecifythatthemissinggenera-ROtionbe recoveredfromthatfile.'UsingeithertheVDEstagingOORareasorfilesyou explicitlyspecify,the/RECOVER qualifierKOthusallowsyoutorepairanyinconsistenciesbetweenthe2OVDEdatabaseanditsCMS libraries.  a}COTheVERIFY GENERATIONcommandisusuallyusedwithJOwildcard charactersinthemodulename parametersbecauseQO5younormallywanttoverifyall generationsinaspecificfa-ROcility(iftheCMSlibraryforthatfacilitywasrestoredfromROaback-uptape)orall generationsforall facilities(ifyourNO>wholediskwas restored).*Tospeedupthe verification,youQOcanusethe/SINCE qualifiertoverifyandrecoveronlythoseHO generationscreatedsincetheback-updatefortheCMSOH libraries.t ! JO QualifiersOs/GENERATION=gen-exprKO Specifiesthatthe generationwiththeCMS generationex-"O$pressiongivenbytheP$gen-expr($ parameterbe verified.'WhenNO|youusethis qualifier,youwouldnormallynotusewildcardMO charactersinthemodulename parameter.'IfyouspecifyanO-asterisk( 9*-)forthe-gen-expr+- parameterorifyouomittheSOentire qualifier,VDEverifiesall generationsforeach specifiedOmodule. O/LOGO(/NOLOG (default)KOControlswhetherlogmessagesareprintedfor successfullyJOverified generations.*The/LOG qualifiercausessuchmes-JO2sagestobeprintedand/NOLOG suppressesthem.*ThelogLOmessagesfor generationsthatarenot successfullyverifiedOOarealwaysprintedandarenotaffectedbythese qualifiers.  O/OUTPUT=file-specSO(Directstheprintedoutputofthiscommandtoa specifiedfile. OThe file-spec>s parameter specifiesthenameofthefile.(VDEKOcreatesanewfilewiththatname,directsthe command'sSO2printoutputtothatfile,andprintsnothingonyour terminal.UOIfthis qualifierisomitted,alloutputappearsonthe terminal.'  ^O/RECOVER[=file-spec]JO( Specifiesthateach generationthatisfoundintheVDEJOdatabasebutismissinginthe correspondingCMSlibraryMOshouldbe recoveredintotheCMSlibrary.*IfyouomittheO2 file-spec;2 parameter,VDErecoverseachmissinggenera-QOtionbytakingitstextfromthestagingareaforthequeuedIO replacementthatcreatedthe generation,providedsucha8O<stagingareaexists.)Youshouldomitthe < file-spec<param-OOeterwhenyouwanttorecoverallmissing generationsforaSOgivensetof facilitiesandthose generationsare availablefromOEstagingareas. ]OIfyouspecifythe file-spec)V parameter,VDErecoverseachPOmissing generationbytakingitstextfromthefile specifiedKO5bythat parameter.,Ifthe parameter specifiesa directoryKOnamewithoutafilename,VDEassumesthatthefilehasHOthesamenameasthemodulebeing recovered.*WhenyouO>usethek> file-spec5> parameter,youwouldnormallyalsouseJOthe /GENERATION qualifiertoidentifythespecificgener-MOationtorecoverandyouwouldomitwildcard charactersin>OHthemodulename parameter.)YoushouldusetheSH file-specIO parameterwhenyouwanttorecoveran individualmoduleIO generationthatcannotbefoundinVDE'sstagingareas.g ==OThis qualifierrequiresthePERFREP privilege. ! O/SINCE=date-timeMO(Verifies(andif requested, recovers)onlythose generationsROcreatedonorafterthe specifieddateandtime.(ThedateandLOtimecanbestatedinthestandardOpenVMS date-timefor-JO2matorcanbeoneofthe following keywords:) YESTERDAY,JOTODAY,or TOMORROW.IfyouuseaspacetoseparatetheOOdatefromthetime,remembertoenclosetheentire date-timeNO<stringindoublequotes.(Forfurther informationaboutspec-EOifyingOpenVMS date-timeformat,seetheOpenVMSDCLO Concepts. A OExamples O1. VDE>*VERIFY% GENERATION& [FACIL]*/LOGU %VDE-I-GENFOUNDCMS,& generation%[FACIL]A.REQ;1(1)%found%in%CMS&libraryWC %VDE-I-GENFOUNDCMS,& generation%[FACIL]A.REQ;2(1A1)%found%in%CMS%libraryU %VDE-I-GENFOUNDCMS,& generation%[FACIL]A.REQ;2(2)%found%in%CMS&libraryU %VDE-I-GENFOUNDCMS,& generation%[FACIL]B.REQ;1(1)%found%in%CMS&library] %VDE-I-GENNOTFOUNDCMS,& generation%[FACIL]B.REQ;2(2)%not&found&in&CMS%libraryZc %VDE-I-ELENOTFOUNDCMS,&element%[FACIL]C.B32;1(1)%not&found&in&CMS%libraryU %VDE-I-GENFOUNDCMS,& generation%[FACIL]D.B32;1(1)%found%in%CMS&libraryU %VDE-I-GENFOUNDCMS,& generation%[FACIL]E.B32;1(1)%found%in%CMS&libraryU; %VDE-I-GENFOUNDCMS,& generation%[FACIL]F.B32;1(1)%found%in%CMS&library Summary& statistics::D Number%of% generations% successfully& verified:  70D[ Number%of%CMS&elements&not%found: [ 13D Number%of%CMS& generations&not%found:  12D Total%number%of% generations%scanned:  9z VDE>HThisexampleverifiesall generationsinfacilityFACILJBtomakesurethateachsuch generationisfoundintheJCMSlibraryforthat facility.(The/LOG qualifiercausesIVDEtoprintlogmessagesforthe generationsthatareNK successfullyverifiedaswellasthosethataremissing.(InMthiscase, generation2ofB.REQisnotfoundintheCMSDlibraryandthewholeCMSelementformoduleC.B32GU ismissing.+Thesummary statisticsindicatethatsevenI  generationswere successfullyverifiedandtwowerenot. O& 2.L VDE>6L VERIFY%GENERATION/SINCE=TODAY/RECOVER%[*]*] %VDE-I-GENNOTFOUNDCMS,& generation%[FACIL]B.REQ;2(2)%not&found&in&CMS%libraryV %VDE-I-GENRECOVERED,% generation&[FACIL]B.REQ;2(2)& successfully% recoveredH$ from&8DISK$:[LIBDIR.VDE$STAGE.VDE$STG_0.VDE$REP_3.FACIL]B.REQ;Zl %VDE-I-ELENOTFOUNDCMS,&element%[FACIL]C.B32;1(1)%not&found&in&CMS%libraryP %VDE-I-GENNOTRECOVERED,% generation&[FACIL]C.B32;1(1)&not% recoveredZ -VDE-I-GENNOTQUEREPL,% replacement%was&not%queued;&no&staging%area%exists Summary& statistics::D Number%of% generations% successfully& verified:  70D Number%of%CMS&elements&not%found:  13Dd Number%of%CMS& generations&not%found: d 12D Total%number%of% generations%scanned:  9-D Number%of% generations% recovered:  12D< Number%of% generations%not& recovered: < 1 VDE>I:Thisexampleverifiesall generationscreatedsincelastGmidnightinall facilities.)Becausethe/RECOVERqual-Iifieris specified,VDErecoversallmissing generationsGDfromtheirqueued-replacementstagingareasandinsertsIthemintotheirCMS libraries.(Inthisexample,genera-Htion2ofmoduleB.REQwas successfully recoveredfromFNitsstaging directory.,However, generation1ofC.B32Lcouldnotbe recoveredbecausenostagingareaexistsforGthe replacementthatcreatedthat generation.*Thisex-IWample illustratesatypicalrecovery operationaftertheIdisk containingyourVDElibraryhasbeenrestoredfromGback-uptapesandtheVDEdatabasehasbeen recovered2afromitsback-upandjournalfiles. O3. VDE>PVERIFY% GENERATION&2[SYS]FOO.MAR/GENERATION=10A2/RECOVER=DISK$:[MYDIR]^M %VDE-I-ELENOTFOUNDCMS,&element%[SYS]FOO.MAR;12(10A2)&not%found%in%CMS%libraryZ %VDE-I-GENRECOVERED,% generation&[SYS]FOO.MAR;12(10A2)% successfully% recovered% from&DISK$:[MYDIR]FOO.MAR;m Summary& statistics::D Number%of% generations% successfully& verified:  00D Number%of%CMS&elements&not%found:  13DE Number%of%CMS& generations&not%found: E 02D Total%number%of% generations%scanned:  1-D Number%of% generations% recovered:  12D Number%of% generations%not& recovered:  0 VDE>?Thisexampleverifies generation10A2ofmoduleDtFOO.MARinfacilitySYS.Becausethat generationisHmissingfromtheCMSlibraryinthisexample,VDEre-B%coversitstextfromfileDISK$:[MYDIR]FOO.MARandN}insertsitintotheCMSlibraryforfacilitySYS.Thisex-Gamplethus illustrateshowyoucanrecoveraspecificD.missing generationwhenthe generationisnotfoundFinanyVDEstagingareabuthappenstobe available elsewhere.c%  z v %OTableA-1:7LogicalNames O OFLogicalONamev Description O O VDE$LIBRARYGzq Referencesthedeviceand directoryofaVDElibrary.OVDE$LIBRARY_DEFAULTSgzeAsearchlistlogicalnamethatcontainszeroormoreVDE libraries availablebyQzdefault..Usedin conjunctionwithVDE$LIBRARY_DEFAULTS_LABELSandSzVDE$LIBRARY_DEFAULTS_MNEMONICS,andthenumberof translationsmustXznmatchthenumberof translationspresentinVDE$LIBRARY_DEFAULTS_LABELS.zandVDE$LIBRARY_DEFAULTS_MNEMONICS.ozAIfnotdefinedordefinedwithout translations,anattemptismadetoaccessalistofQzdefaultlibrarylabelslocatedintheXWindowsresourcefile.%OVDE$LIBRARY_DEFAULTS_LABELSlzAsearchlistlogicalnamethatcontainszeroormorelabelsforVDE libraries.(UsedZzin conjunctionwithVDE$LIBRARY_DEFAULTS,andthenumberof translationsXz>mustmatchthenumberof translationspresentinVDE$LIBRARY_DEFAULTS.ozIfnotdefinedordefinedwithout translations,anattemptismadetoaccessalistofHzdefaultlibrarylabelsintheXWindowsresourcefile.hzToavoiduser confusion,oneshould configuretheremarkineachlibrarytomatchXzthe associatedtranslation(s)oftheVDE$LIBRARY_DEFAULTS_LABELSlogical8z; name.&SeetheSETLIBRARY/REMARKcommand."O VDE$LIBRARY_DEFAULTS_CMShz/ Asearchlistlogicalnamethatcontainszeroormoreroot locationsfortheVDEcz CMS libraries.)Thislogicalisusedin conjunctionwiththeother VDE$LIBRARY_az DEFAULTSlogicalnames,andthenumberof translationsmustmatchthenumber>z8 of translationspresentinVDE$LIBRARY_DEFAULTS.oz Ifnotdefinedordefinedwithout translations,anattemptismadetoaccessalistofHz defaultlibrarylabelsintheXWindowsresourcefile.kz ThislogicalisusedbyaVDEmanagertoprovidethelocationoftheCMS librarieshz toprogramsand procedures associatedwithVDE,butthislogicalnameisnotusedz6 withinVDE.(O VDE$LIBRARY_DEFAULTS_MNEMONICS.  z   O OLogicalO+Namev Description OF czAsearchlistlogicalnamethatcontainszeroormoremnemomicnamesforVDEcz libraries.*CanbeusedintheSETLIBRARYcommand.)ThislogicalnameisusedZzwin conjunctionwithVDE$LIBRARY_DEFAULTS,andthenumberof translationsXzmustmatchthenumberof translationspresentinVDE$LIBRARY_DEFAULTS.NzI Mnemonicsarenot utilitizedundertheXWindows interfaces.kzToavoiduser confusion,oneshould configurethenameineachlibrarytomatchtheVz associatedtranslation(s)oftheVDE$LIBRARY_DEFAULTS_MNEMONICSlogical6ztname.&SeetheSET LIBRARY/NAMEcommand.OVDE$LIBRARY_LABELhzhContainstheremark associatedwiththelastVDElibrary accessed.)ThislogicalisHzintendedforusewithincommand procedurescallingVDE.hz:Toavoiduser confusion,oneshould configuretheremarkineachlibrarytomatchXzthe associatedtranslation(s)oftheVDE$LIBRARY_DEFAULTS_LABELSlogical8zname.&SeetheSETLIBRARY/REMARKcommand.sOeThislogicalnameis write-only;VDEdoesnot translateitandusersshouldnotmodifytheO contents.)O7VDE$LIBRARY_MNEMONICezContainsthe mnemonic,whenknown,orthe specification associatedwiththelast!z VDElibrary accessed.kz Toavoiduser confusion,oneshould configurethenameineachlibrarytomatchtheVz  associatedtranslation(s)oftheVDE$LIBRARY_DEFAULTS_MNEMONICSlogical6z4 name.&SeetheSET LIBRARY/NAMEcommand.pO Thislogicalisintendedforusewithincommand procedurescallingVDE.ThislogicalnamejO is write-only;VDEdoesnot translateitandusersshouldnotmodifythe contents.)O VDE$NOTES_LIBRARYiz Whendefined,the translationofthislogicalnameisusedtooverridethedefault^zS SCTnotes conference specificationofNOTES$LIBRARY:.NOTE.Amongtheobviouslz usein relocatingtheSCTnotes conferencestoaremotenodeorremotecluster,this`z logicalnamecanbedefinedas0::NOTES$LIBRARY:.NOTEtoforceallSCTnoteiz\ entriestomadeviathenotesserver process(es).(Onlyonenotes conferencedefault1z  specificationispossiblepernode.  z  O OLogicalO+Namev Description OF O VDE$OFFLINEfz?Whendefined,disablesVDE.The translationisassumedtocontainthereasonwhyeztheVDE environmentisoffline,andis displayedtoallVDEusers.-Onlyfully-Zz privileged definitionsofthislogicalnameareacceptedand processed.OjVDE$REPLACE_DEFAULTpzIfdefined,thislogicalcontains ``EDIT'', ``FILE'',or ``NOTE'',andselectsthedefaultjz= processingforthelocationoftheSCTnote.+If undefinedordefinedtoaninvalidrzvalue,VDEdefaultsto ``EDIT'',as indicatedbythebracketsinthe``EnterfiletoloaddzintoSCT:(filename/[EDIT]/NOTE)''prompt.(ThebracketswillindicatethedefaultzFfortheprompt.lOnot translateitandusersshouldnotmodifythe contents./Forfurther informationon[O promptingforSCTnotes,seethe documentationontheREPLACE command.)Oq VDE$SCRATCHizAlogicalnamethat translatesintothe directory specificationfortheVDEscratchczD directory.,Ifthislogicalnameisnot specified,a[.VDE$SCRATCH] subdirectory_zwillbecreated underneaththe SYS$SCRATCH: directory,andthelogicalname V OExamples O1. VDE>WAIT% BUILD_JOBI Waiting&until&build&job%34%for%stream&MAIN% completes...I Build%job%34%for&stream%MAIN&has% successfully% completede VDE>LThiscommandwaitsforthemostrecentbuildjobfortheN,defaultstreamto complete,inthiscase,buildjob34forHstreamMAIN.Thesecondlogmessage,printedaftertheMjob finished, indicatesthatthejob completed successfully. OU2.Z VDE>,ZWAIT%BUILD_JOB/TIMEOUT=5:00%V5.3I Waiting&until&build&job%33%for%stream&V5.3% completes...F Timeout&interval&has%expired& (interval:0% 00:05:00.00)2 VDE>GThiscommandwaitsforthemostrecentbuildjobforJstreamV5.3.)Thetimeoutintervalis5minutes.*InthisIRcase,thetimeoutintervalexpiredbeforethebuildjobC completed,as indicatedbythesecondlogmessage. ! c(O A.! Associated!Logical!NamesOOThisappendix describesvariouslogicalnamesusedwithintheQOVDEpackage.)Apartiallistoftheselogicalnamesispresent OBinBTableA-1. _UNote _CLThis interfaceisunder developmentandissubjectBtochange.+PleasecontactVDEsupportforfurther information.) G* l?  m (OTableB-1:7 DependencyCodes O OFValueSymbolF Description Ob  O1zVDE$K_DEPEND_BEGIN_zRECORD&Begin dependency recording O|2z|VDE$K_DEPEND_END_zRECORD$|End dependency recording OO3CzOVDE$K_DEPEND_VERSIONRecordcompilerortoolversion O4:zVDE$K_DEPEND_INPUT_FILE_Recordaninputfile OB5zBVDE$K_DEPEND_INPUT_zLIBRARY$BRecordaninputlibrary O6zVDE$K_DEPEND_INPUT_zmMODULE,Recordaninputlibrarymodule O7zVDE$K_DEPEND_OUTPUT_z?FILE"Recordanoutputfile O8zVDE$K_DEPEND_OUTPUT_zLIBRARY%Recordanoutputlibrary O9zVDE$K_DEPEND_OUTPUT_zMODULE-Recordanoutputlibrarymodule O  4 Z+O  -----%under% construction%-----/O thissectionunderconstruction...V ,,OB.! Recording!Build! Dependencies  KVLOThisappendix describesthecallable interfacethatrecordsKO(build dependenciesintheOpenVMS database.(This interfaceGOallowstheOpenVMSLINKERandvariouslanguageproces-QOsorstorecordtheinputandoutputmodulesofagivenbuild'O2stepintheVDE database. 8 n i&OTableC-1:7ItemlistCodes O OFSymbol; Description Ob OVDE$_CI_END_OF_LIST1z$ Signifiestheendofthe itemlist.O VDE$_CI_CHAIN%zReservedforfutureuse.OVDE$_CI_ITEMLISTnz  Signifiestheaddressofthe itemlist.(ThisentryallowsthecallbackroutinetolocateKzctheuser-specifieditemlistpassedintotheoriginalcall.OVDE$_CI_VERSION%zWReservedforfutureuse.OVDE$_CI_USER_CONTEXT@zJIgnoredbyVDE, availableforanyuserpurpose.OVDE$_CI_LIBRARYHz> Specifiesthedeviceand directoryoftheVDElibrary.OVDE$_CI_STREAM&z2 SpecifiestheVDEstream.OVDE$_CI_FACILITY(z%  SpecifiestheVDE facility.O VDE$_CI_MODULE&z  SpecifiestheVDEmodule.O VDE$_CI_REMARKBz  Specifiestheremark assocatedwiththe operation.O VDE$_CI_OUTPUTcz  Specifiestheoutputdeviceand directoryspecification..For operationssuchasnzX fetches,thisshouldcontainonlythedeviceand directory;VDEwill constructthefile7z nameand extensionbasedonthemodule.O+  VDE$_CI_INPUTiz  Specifiestheinputdeviceand directory.'Donotspecifyafilenameor extension.9 z   O OSymbol; Description O OxVDE$_CI_RESERVATION5z Specifiesthenameofthe reservation.OlVDE$_CI_RESERVEDgzReceivedbythecallbackroutine.-Abooleanflagthat specifiesifthemoduleisz> currently reserved.O VDE$_CI_CAUSEgz2 Specifiesthecauseforthe replacement.(Theitem referencesalongword containingOzthe replacementcausecode:,VDE$K_CI_CAUSE_FOLD,VDE$K_CI_CAUSE_)zSCT,orVDE$K_CI_CAUSE_OTHER. O\VDE$_CI_SCT_CONFERENCENz SpecifiestheSCT conference associatedwiththe replacement.OPVDE$_CI_SCT_NOTETz SpecifiestheSCT conferencenote associatedwiththe replacement.ODVDE$_CI_SCT_REMARKJz SpecifiestheSCTremark associatedwiththe replacement.O7VDE$_CI_QAR_DATABASELz SpecifiestheQARdatabase associatedwiththe replacement.O+  VDE$_CI_QARfz  SpecifiestheQARnumber associatedwiththe replacement.'Mustbe associatedwith4z a preceedingVDE$_CI_QAR_DATABASEitem.Ow  VDE$_CI_CLDJz  SpecifiestheCLDnumber associatedwiththe replacement. O F(n DO]LIB$REC_DEPENDENCY(O RecordingBuild Dependencies* g  =>OLIB$REC_DEPENDENCYrecordstheinputandoutputOO.modulesforthecurrentbuildstepand incorporatesthisin-JO formationintothebuild dependencygraphintheOpenVMSJO database.)YoumustmakeasequenceofcallsonLIB$REC_HO7 DEPENDENCYtorecordall dependency informationfortheOcurrentbuildstep.KO+Thisroutineperformsnoactionandconsumesnotimeun-ROlessabuildstepis currently executingaspartofaOpenVMSOsystembuild.{ QOFormatAOsLIB$REC_DEPENDENCYM func-code, name-string, lib-index UO ArgumentsOs func-codeOtype:%*longwordinteger(signed)O$access:readonly#O| mechanism:Fby referenceOOAfunctioncode indicatingthe informationthatispassedtoOpLIB$REC_DEPENDENCY.QpTableB-1!pcontainsthelistofOdefinedvalues.* Q3n?  qHOThemeaningsofthe remaining parametersdependonthe)Ovalueofthefunctioncode.0  RO name-stringO(type:*( characterstringOaccess:readonly$O mechanism:Fby descriptorNOuAnASCIItextstringwhosecontentsdependonthe function-:Ocode parameter.-FortheVDE$K_DEPEND_VERSIONJO& function,thisstringcontainsthenameandversionnum-GO~beroftheLINKERorlanguage processor(forexample,BO``VAXLinker V5.2-1'').'FortheVDE$K_DEPEND_BEGIN_:O/RECORDandVDE$K_DEPEND_END_RECORD functions,ROthis parameterisnotused.)Forallotherfunctioncodes,thisROstringcontainsthenameofafile,library,orlibrarymoduleMO9thatisaninputtooroutputofthecurrentbuildstep. O lib-indexO(type:%*(longwordinteger(signed)Oaccess:readwrite#O mechanism:Fby referenceMOuAlibraryindexwhoseusedependsonthe function-codepa-8Orameter.-FortheVDE$K_DEPEND_INPUT_LIBRARY database. ! 9WAlsomakeone callwiththe VDE$K_DEPEND_DVERSIONfunctioncode.+Thiscall specifiesthenameJandversionofthe compiler,LINKER,orothertoolthatMaperformsthebuildstep.'ThiscallmayappearatanytimeMwithrespecttothecallsthatspecifyinputsandoutputs.O(Ifseveraltoolsareusedinthebuildstep,youmaymake'kthiscallforeachtool.) `>MakeonefinalcallwiththeVDE$K_DEPEND_END_DBRECORDfunctioncode.*Thiscallendsthe dependency4 recordingsessionforthebuildstep.& ! *(OBegin Recording DependenciesRO4Tobegin recordingtheinputsandoutputsofthecurrentbuild@Ostep,makeacallasinthe followingexample:BO LIB$REC_DEPENDENCY(&%REF(VDE$K_DEPEND_BEGIN_RECORD)%);n ! DJOThisexample(showninBliss) illustrateshowacompilerKOorothertoolbegins recording dependency information.*The=O5functioncodeisVDE$K_DEPEND_BEGIN_RECORD.TheO name-string ]and lib-index. parametersarenotusedinthisOcall. [-O RecordingToolNameandVersionLO4TorecordthenameandversionnumberofthecompilerorPOothertool performingthecurrentbuildstep,makeacallas&Ointhe followingexample::Oj LIB$REC_DEPENDENCY(&%REF(VDE$K_DEPEND_VERSION),2: %ASCID%'VAX-11&BLISS-32& V4.2-761'%); xHOThisexample illustrateshowtheBlisscompilerrecordsHOitsownnameandversionnumber.-Thefunctioncodeis(O5VDE$K_DEPEND_VERSIONandthe5 name-string 5pa-KOrameteristhenameandversionnumberofthe processor. OThe lib-index3 parameterisnotusedinthiscall. A k!O RecordingInputFilesVO4Torecordaspecificfileasaninputtothecurrentbuildstep,functioncode,asinthe followingexample:@O LIB$REC_DEPENDENCY(&!%REF(VDE$K_DEPEND_INPUT_LIBRARY),6:  %ASCID%$'DEVD$:[DIR.SRCDIR]SYSMACLIB.MLB;1',:R LIB_INDEX%);  OThe name-string; parameteristhefullfile specificationofMOthelibrarythatcontainstheinputmodule.)Theinputmod-SO5ulecanbefromanobjectlibrary,atextlibrary,oramacroPOlibrary;inthisexamplethemoduleisfromamacrolibrary. OThe lib-index9 parameterisanoutput parameterthatre-O>ceivesa> libraryindex3n>thatuniquely identifiesthelibrary.KOAlibraryindexisanintegervalueselectedbyLIB$REC_2O DEPENDENCYto representthelibrary.!!  @OThesecondcall specifiestheVDE$K_DEPEND_INPUT_COMODULEfunctioncode,asinthe followingexample:?Oa LIB$REC_DEPENDENCY(& %REF(VDE$K_DEPEND_INPUT_MODULE),: %ASCID% 'INMODNAME',: LIB_INDEX%);v"  LOThistimetheM name-string+_ parameteristhenameofthethat specifiesthelibraryindexthatuniquely identifiesthePOlibrarytowhichthemodulebelongs.)Thisisthelibraryin-?OdexreturnedbythepreviousVDE$K_DEPEND_INPUT_KOHLIBRARYcall.+Thelibraryindexthus establishesthecon-JOnectionbetweenthelibrarymodule(orelementormacro)4Oandthelibrarytowhichitbelongs.# ! aJOIfyourecordmanyinputmodulesfromthesamelibrary,FOrecordthelibraryonlyonce,usingthe VDE$K_DEPEND_EO5 INPUT_LIBRARYfunctioncode.(Thenmakeone additionalQOcallforeachlibrarymodule(orelementormacro), specifying;Othesamelibraryindexforeachsuchcall.$ A #y"O RecordingOutputFilesRO4Torecordaspecificfileasanoutputfromthecurrentbuildexample:>O LIB$REC_DEPENDENCY(&%REF(VDE$K_DEPEND_OUTPUT_FILE),4:  %ASCID%'DEVD$:[DIR.OBJDIR]MOD1.LIS;3'%);#% N OThe name-string; parameteristhefullfile specificationofOOtheoutputfile;thisisthe resultantnamestringthatRMSO5returns.'The55 lib-index#5 parameterisnotused.& k4O RecordingOutputModulesfor LibrariesOO4TorecordaspecificmoduleinalibraryasanoutputfromFOthecurrentbuildstep,callLIB$REC_DEPENDENCYtwice.@OThefirstcall specifiestheVDE$K_DEPEND_OUTPUT_DO>LIBRARYfunctioncode,asinthe followingexample:AO LIB$REC_DEPENDENCY(&"%REF(VDE$K_DEPEND_OUTPUT_LIBRARY),6:  %ASCID%$'DEVD$:[DIR.OBJDIR]SYSOBJLIB.OLB;1',:R LIB_INDEX%);' !  OThe name-string; parameteristhefullfile specificationofOOthelibrarythatcontainstheoutputmodule.'Theoutputmod-SO5ulecanbefromanobjectlibrary,atextlibrary,oramacroROlibrary;inthisexamplethemoduleisfromanobjectlibrary. OThe lib-index9 parameterisanoutput parameterthatre-O>ceivesa> libraryindex4m>thatuniquely identifiesthislibrary.MOThelibraryindexisanintegervalueselectedbyLIB$REC_2O DEPENDENCYto representthelibrary.$(  AOThesecondcall specifiestheVDE$K_DEPEND_OUTPUT_COMODULEfunctioncode,asinthe followingexample:@Oa LIB$REC_DEPENDENCY(&!%REF(VDE$K_DEPEND_OUTPUT_MODULE),: %ASCID% 'OBJMODNAME',: LIB_INDEX%);x)  NOThistimetheM name-string+_ parameteristhenameofthe=Ooutputmoduleyouwishtospecify.*Thus,the name-stringOO5 parameteristhenameofanobjectmoduleinanobjectli-UObrary,atextelementinatextlibrary,oramacroinamacroOlibrary.,The" lib-index- parameterisaninput parameterOO>that specifiesthelibraryindexthatuniquely identifiesthePOlibrarytowhichthemodulebelongs.)Thisisthelibraryin-@OdexreturnedbythepreviousVDE$K_DEPEND_OUTPUT_KOHLIBRARYcall.+Thelibraryindexthus establishesthecon-JOnectionbetweenthelibrarymodule(orelementormacro)4Oandthelibrarytowhichitbelongs.{* QKOIfyourecordmanymodulesasoutputsfromthesameli-GObrary, recordthelibraryonlyonce, usingtheVDE$K_objectfile(suchas MOD1.OBJ)containsoneormore > ob-O jectmodules?.(Eachobjectmodulehasitsownmodulename;UOtheobjectmoduleistheunitthatiscopiedtoobject librariesHOGandislinkedbytheLINKER.OpenVMSstores dependencyNO informationforobjectcodeusingobjectmodules,notobjectOfiles., f UOIfanobjectfileisanoutputofthebuildstep,callLIB$REC_6O DEPENDENCYusingtheVDE$K_DEPEND_OUTPUT_OO5LIBRARYfunctioncodetospecifytheobjectfile,asintheO followingexample:AO LIB$REC_DEPENDENCY(&"%REF(VDE$K_DEPEND_OUTPUT_LIBRARY),4:Z %ASCID%"'DEVD$:[DIR.OBJDIR]OBJFILE.OBJ;1',: LIB_INDEX%);'- NOInthiscall,the name-string& parameteristhenameofDOtheobjectfile.*LIB$REC_DEPENDENCYreturnsaunique9O5libraryindexfortheobjectfiletothe5 lib-index5 parameter.g. b=call.2 ! 6O RecordingIsDoneOnlyforBuildStepsHO4Ifthelanguage processororothertoolcallsLIB$REC_CO DEPENDENCYwhenthe processorortoolisnotper-?Oformingabuildstep,LIB$REC_DEPENDENCYreturns?O>without performinganyaction.-The VDE$K_DEPEND_=O BEGIN_RECORDfunctioncheckswhetheraOpenVMSTObuildstepisbeing performed.)Ifnot,thefunctionsetsaflagJOGthatcausesthe remainingfunctioncodestoreturnimme-FOdiatelywithoutspendinganyfurthertimeinLIB$REC_5O DEPENDENCY.LIB$REC_DEPENDENCY determinesOOQwhetherabuildstepis currentlyactivebycheckingwhether?OlogicalnameVDE$RECORD_DEPENDENCYisdefinedtoBObe``TRUE''andwhetherlogicalname VDE$PAGEFILE_LO[SECTIONisdefinedatall.,Italsorequiresthe shareableJOimage VDE$RECDEPtobepresentonthesystem.'Theover-GO headofcallingLIB$REC_DEPENDENCYisthusdesignedtoPOdbe negligiblewhenthe processorortoolisnot performingaOOpenVMSbuildstep.k3 AOExample0OsEXAMPLE:4ClicktodisplayExample.*3 O6sO4 J / struct&VDEIL3%itmlst[MAX_ITEMLIST];43 $DESCRIPTOR(& sys$login,% "SYS$LOGIN:"&);J{ $DESCRIPTOR(&library,&$"VDE$RESD2$:[VDE-MOTIF-DEMO.TSTLIB]"%);+ $DESCRIPTOR(&stream,%"MAIN"&);-  $DESCRIPTOR(& facility,%"MAIN"%);7R $DESCRIPTOR(&module,%"[MAIN]BLISS1.B32"&); n%=&0;" itmlst[n].VDE$W_ItemCode =%VDE$_CI_LIBRARY;$* itmlst[n].VDE$W_ItemLength"* =%library.dsc$w_length;%r itmlst[n].VDE$A_ItemPointer#r =%library.dsc$a_pointer;3 "itmlst[n++].VDE$A_ItemReturnLength=%0;"# itmlst[n].VDE$W_ItemCode# =%VDE$_CI_STREAM;$k itmlst[n].VDE$W_ItemLength!k =%stream.dsc$w_length;% itmlst[n].VDE$A_ItemPointer" =%stream.dsc$a_pointer;3 "itmlst[n++].VDE$A_ItemReturnLength=%0;"d itmlst[n].VDE$W_ItemCoded =%VDE$_CI_FACILITY;$ itmlst[n].VDE$W_ItemLength# =%facility.dsc$w_length;% itmlst[n].VDE$A_ItemPointer$ =%facility.dsc$a_pointer;3< "itmlst[n++].VDE$A_ItemReturnLength=%0;" itmlst[n].VDE$W_ItemCode =%VDE$_CI_MODULE;$ itmlst[n].VDE$W_ItemLength! =%module.dsc$w_length;%5 itmlst[n].VDE$A_ItemPointer"5 =%module.dsc$a_pointer;3} "itmlst[n++].VDE$A_ItemReturnLength=%0;" itmlst[n].VDE$W_ItemCode =%VDE$_CI_OUTPUT;$. itmlst[n].VDE$W_ItemLength$. =%sys$login.dsc$w_length;%v itmlst[n].VDE$A_ItemPointer%v =%sys$login.dsc$a_pointer;3 "itmlst[n++].VDE$A_ItemReturnLength=%0;"' itmlst[n].VDE$W_ItemCode' =%0;$o itmlst[n].VDE$W_ItemLengtho =%0;% itmlst[n].VDE$A_ItemPointer =%0;3 "itmlst[n++].VDE$A_ItemReturnLength=%0;>h retstat%=&VDE$FetchModule(%0,%itmlst,%0,%0&);/O thissectionunderconstruction...K5 !!OC.!Callable" InterfaceW6 -COThisappendix describestheVDEcallable interface. R_UUNote R_GThis interfaceisunder developmentandissubjectto02change.'PleasecontactVDEsupport2 before2 attempting#tousethis interface. 7 ! OTableC-1EcontainstheitemlistcodesusedbyvariouscallbackUO routines.(Notall callbacksneednoruseallcodeslistedintheOitable.*7 Ozp?8 \ Z+O  -----%under% construction%-----/O thissectionunderconstruction..._: 5O0VDE$FetchModuleOFetchesaModule*; e< ;;OVDE$FetchModulefetchesthe specifiedmodule.= hOFormatIOsVDE$FetchModuleNcontext, itemlist, callback,callbackparam,-flagss> ! -IO ArgumentsOscontextOtype:%*longwordinteger(signed)O$access: read-write#O| mechanism:Fby referenceROThisistheaddressofalongwordusedbyVDEto referencea retstat%=&VDE$SetFacility(%0,%itmlst,%0,%0&);/O- thissectionunderconstruction...bK 8O0VDE$ReplaceModuleOReplacesaModule*L hM >>OVDE$ReplaceModulereplacesthe specifiedmodule.N jOFormat;OsVDE$ReplaceModuleNcontext, itemlist, callback,}callbackparam,flagssO ! -IO ArgumentsOscontextOtype:%*longwordinteger(signed)O$access: read-write#O| mechanism:Fby referenceROThisistheaddressofalongwordusedbyVDEto referencea test_length2&=%strlen&(test_remark);[t itmlst[n].vde$w_itemlengthK=% (unsigned&short)% (unsigned%char)% test_length2;6t itmlst[n].vde$w_itemcodeK=&VDE$_CI_REMARK;At itmlst[n].vde$a_itempointerK=&(char&*)& test_remark;3t] "itmlst[n++].vde$a_itemreturnlength%=&0;+t itmlst[n].vde$w_itemlengthK=%0;)t itmlst[n].vde$w_itemcodeK=&0;,tV itmlst[n].vde$a_itempointerK=&0;3t "itmlst[n++].vde$a_itemreturnlength%=&0;Y retstat%=&VDE$ShowProjects(&0,&itmlst,%VDE$InterfaceTestShow,%0x0048B&);/O thissectionunderconstruction...0d :O0VDE$ShowFacilitiesODisplays facilities*  G[JOVDE$ShowFacilitiesdisplays facilitieswithinthe specifiedO.stream. kOFormatLOsVDE$ShowFacilitiesNcontext, itemlist, callback,callbackparam,Mflagss ! -IO ArgumentsOscontextOtype:%*longwordinteger(signed)O$access: read-write#O| mechanism:Fby referenceROThisistheaddressofalongwordusedbyVDEto referencea retstat%=&VDE$ShowLibrary(%0,%itmlst,%VDE$InterfaceTestShow,&0x0048BK);/O thissectionunderconstruction...` 6O0VDE$ShowProjectsODisplaysprojects*  GWFOVDE$ShowProjectsdisplaysprojectswithinthe specifiedO.stream. iOFormatJOsVDE$ShowProjectsMcontext, itemlist, callback,callbackparam,7flagss ! -IO ArgumentsOscontextOtype:%*longwordinteger(signed)O$access: read-write#O| mechanism:Fby referenceROThisistheaddressofalongwordusedbyVDEto referencea  O DescriptionJOsVDE$ShowStreamsdisplaysthestreamspresentinthespec-OOifiedlibrary.-EachstreamlocatedresultsinacalltotheNO$callbackroutine.(Toperformthe operation,thelibrarymustO|be specified. EOAs parameters specifiedtoVDEcallbackroutinesareTO ``sticky'',ifarequired parameterisnot specified,itwillbeCOi defaultedtothevalueusedona preceedingcall.k AOExample0OsEXAMPLE:4ClicktodisplayExample.* O6sO   s )OTableD-1:7 VDE$UPLOADSyntax O OFLibraryBlock Ob abThelibraryblockcontainsgeneral informationonthelibrary, includingboth`b descriptiveandlocation information.)Thelibraryblockbeginsanewlibrarybb[creation operation,and subsequentliteralandstreamblocksapplytotheVDE`bdatabasecreatedbythe immediatelypreviouslibraryblock.'MultiplecreationGb  operationscanbe accomplishedinasingledatafile.OBEGINLIBRARYOENDLIBRARYdbzLibraryblock delimiters.'CausethecreationofaVDElibrary,usingtheother8b parametersinthissectionofthetable.OLMNEMONICFOOBAR]bThemnemonicnametobe associatedwiththenewlibrary.(Thisnamemust*bmeetVDEnaming requirements.,OCMSFOOBAR_CMS_LIB_ROOT$:[000000]_bThefull specificationoftheCMSlibrary (libraries)tobe uploaded..This\bj directorycontainsoneormoreCMSlibrarysubdirectories,eachoftheseUbsubdirectorieswitha[.CMS] subdirectory containingaCMSlibrary.)O= IDENTIFIERVMS_IDENTIFIER_NAMEZbThenameofanOpenVMSsecurity identifierrequiredforaccesstotheb createdVDElibary..O ROOT$11$DUA113:[VDE.FOOBAR.DBROOT]bb Theroot directory specificationforthenew database.*Thisistheareathat0b[ containstheVDE$DATABASE.RDBfile..O DATA$11$DUA113:[VDE.FOOBAR.DBDATA]bbO Thedata directory specificationforthenew database.*Thisistheareathat0b containstheVDE$DATABASE.RDAfile.1O! SNAPSHOT$11$DUA113:[VDE.FOOBAR.DBSNP]`b Thesnapshot directory specificationforthenew database.*Thisisthearea6b thatcontainstheVDE$DATABASE.SNPfile.0Om JOURNAL$11$DUA113:[VDE.FOOBAR.DBJNL] o U O OLibraryBlock O ebxThejournal directory specificationforthenew database.'Thisistheareathat0bcontainstheVDE$DATABASE.JNLfile.6OKSTAGING#$11$DUA113:[VDE.FOOBAR.VDE$STAGING]\bThestaging directory specificationforthenew database..Thisareawill6bcontainthestagingareasubdirectories.8OBUILDING$$11$DUA113:[VDE.FOOBAR.VDE$BUILDING]]bThebuilding directory specificationforthenew database.-Thisareawill7bicontainthebuildingareasubdirectories. s  O  O OStreamBlock O ^bAThestreamblockcontainsstream-related information, includingthespecificEbCMSclassesthatwillbeuploadedintoVDEstreams.OBEGINSTREAMOENDSTREAMbbStreamblock delimiters.'CausethecreationofaVDEstream,usingtheother8b_ parametersinthissectionofthetable.ONAMEV6.1_SSBXbSThenameofthenewstream.(MustmeetVDEnaming requirements.(Must_balsomatchthenameofaCMSclassthatispresentinthe specifiedCMSb libraries.O~MAINLINETRUEbb Indicatesthestreamis(TRUE)orisnot(FALSE)amemberofthemainline.bPofdescentintheVDE database.OPARENTMAINbbDThenameoftheparentofthenewstream,orMAINforthefirststreaminbthe database.O SUCCESSORSV6.2_SSBWbThenameofa successorstream,acomma-seperatedlistof successor]bstreams,orthekeywordNONEifthereareno successorstothisstream. Ob  CONFERENCE V61-YELLOWdb Thenameofthenotes conferenceused internallybyVDEtotrackallactivity2b4 forthisstream.(This conferenceis L4 not34 theSCT(SourceCode Tracking)notesb  conference. z =t O  O OLiteralBlock O abATheliteralblockcontainsVDEcommandsthataretobedirectlyexecutedas7bpartofthedatabasecreation operation.OBEGINLITERALOENDLITERALdbLiteralblock delimiters.(Thisblockcausesthe proceduretoemitthe specifiedcb_VDEcommandsthatwere specifiedinthisblockafterthecreationoftheVDE]blibraryandthe associatedstreams.+Mostoftenusedtoupdate replacementJbpolicyand pre-createdusersanduser privilege profiles. O7 e ;O0VDE$UnreserveModuleO UnreserveaModule* ~ GTEOVDE$UnreserveModulecancelsapreviousmodulereserva-O.tion. lOFormat=OsVDE$UnreserveModuleNcontext, itemlist, callback,callbackparam,flagss ! -IO ArgumentsOscontextOtype:%*longwordinteger(signed)O$access: read-write#O| mechanism:Fby referenceROThisistheaddressofalongwordusedbyVDEto referenceaO$stream,facilityandmodulemustbe specified. EOAs parameters specifiedtoVDEcallbackroutinesareTO ``sticky'',ifarequired parameterisnot specified,itwillbeCOi defaultedtothevalueusedona preceedingcall.k AOExample0OsEXAMPLE:4ClicktodisplayExample.* O6sO !   .$OD.!CMS"Library!Uploader=OdTheOpenVMS Development Environment(VDE)tool?O VDE$UPLOADassistOpenVMS engineersin uploadingAOthecontentsofmultipleCMS librariesintoVDE.  @O VDE$UPLOADrequires informationon environmenttoIObecreatedandtheCMS informationtobe uploaded,andKOithe location(s)wheretheVDEdatabaseistobecreated.FO VDE$UPLOADwillthencreateanewVDEdatabasebasedROonthe specifiedCMS libraries.(Aspartofthis, specifiedCMSMOrclassesfromthe specifiedCMS librarieswillformtheba-LOsisofnewVDEstreams,theusersfromtheCMS librariesLO#willbecreatedintheVDE database,andtheCMScommandmandifyoudonotwishtoseethemessage. ! i OARCHDEL,- architecture? architecture=deletedfromthe(database Facility:15VDE,OpenVMS Development Environment^ Explanation:9^Thismessageinformsyouthatthedefini-Ktionforthe indicated architecturehasbeendeletedfromItheVDE database.(ThismessageisonlyissuedwhenyouBhusethe/LOG qualifierontheDELETE ARCHITECTUREcommand.\UserAction:5\Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage.@ C#O ARCHEXISTS,, architecture architecturealreadyex-+(istsin database;notchanged Facility:15VDE,OpenVMS Development Environment^ Explanation:1^The indicated architecturenamewas: specifiedonaCREATE ARCHITECTUREcommand,Kbutanentryforthat architectureisalreadypresentinFhthe database.,HenceanewentrywasnotcreatedforHthat architecture.)Alternatively,the indicatednamewasH specifiedasthenewnameforanexisting architecture;rontheMODIFY ARCHITECTUREcommand,butan-Gother architecturealreadyhasthe requestednewname.K#Hencethenameoftheexisting architecturecouldnotbe&{changedtothenewname.UserAction:4Ifyouenteredthewrong architectureAoname,reenterthecommandwiththecorrectname.EIfyouenteredtheright architecturename,usethe7 SHOW ARCHITECTUREcommandtodisplaytheGydatabase informationforthat architecture.,IfyouareDnot satisfiedwiththat information,usetheMODIFY0* ARCHITECTUREcommandtochangeit.   s2OARCHMOD,- informationfor architecture architecture%(modifiedinthedatabase Facility:15VDE,OpenVMS Development Environment^ Explanation:3^Thismessageinformsyouthatinfor-Dmationforthe indicated architecturehasbeenmod-FifiedintheVDE database..Thismessageisonlyis-Ehsuedwhenyouusethe/LOG qualifierontheMODIFY  ARCHITECTUREcommand.\UserAction:5\Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage. uV#O ARCHNOTDEL,, architecture architecturenotdeletedk Facility:15kVDE,OpenVMS Development Environment Explanation:6Youare attemptingtodeleteanarchi-H^tecturethatcannotbedeleted.* AdditionalmessagesareHnormallyincludedwiththismessage,andthesemessages@indicatewhythe architecturecannotbedeleted.UserAction:/Resolvethe problem(s)flaggedbyAtheothererror messages,andreentertheDELETE \ ARCHITECTUREcommand.x uN%O ARCHNOTFOUND,, architecture architecture not2(foundin database; parameterignored Facility:15VDE,OpenVMS Development Environment^ Explanation:6^The indicated architecturenamewasen-=teredonaSHOW ARCHITECTUREcommand,butnoAsuch architecturewasfoundintheVDE database.UserAction:;Thisisnot necessarilyanerror;themes-Lsagesimplytellsyouthatthe indicated architecturedoes(\notexistinthe database. ;O ARCHSYNTAX,,invalid architecturenamesyntax:(name Facility:15VDE,OpenVMS Development Environment^ Explanation:4^Thenameorformat specifiedforthe< architecturenameisnotusingvalidsyntax.RUserAction:3R Respecifythe architecturenameusingEonly alphanumeric, underscore,dollarsignandhyphen characters. ! 0OAREASON,-accepted.checkin.reasonmask:'reasonk Facility:15kVDE,OpenVMS Development Environment Explanation:<ThismessageisusedtoformattextstringsO^withinVDE,andshouldnotbevisibletousersasanerrormessage.RUserAction::RContactVDEsupportfor assistance,astheNversionofVDEinuseshouldnotbe displayingthisasanerrormessage. ! 3OAREPLID,-accepted.checkin.replacementid:wreplidk Facility:15kVDE,OpenVMS Development Environment Explanation:<ThismessageisusedtoformattextstringsO^withinVDE,andshouldnotbevisibletousersasanerrormessage.RUserAction::RContactVDEsupportfor assistance,astheNversionofVDEinuseshouldnotbe displayingthisasanerrormessage. ! 0O AREPLNAME,,accepted.checkin.replname:Breplnamek Facility:15kVDE,OpenVMS Development Environment Explanation:<ThismessageisusedtoformattextstringsO^withinVDE,andshouldnotbevisibletousersasanerrormessage.RUserAction::RContactVDEsupportfor assistance,astheNversionofVDEinuseshouldnotbe displayingthisasanerrormessage.' ! u3O ARMPBCMSDIR,-accepted.module.cmslibrary:cms- (dir Facility:15VDE,OpenVMS Development Environment^ Explanation:<^ThismessageisusedtoformattextstringsOwithinVDE,andshouldnotbevisibletousersasanerrormessage.UserAction::ContactVDEsupportfor assistance,astheNversionofVDEinuseshouldnotbe displayingthisasan\errormessage. ! -O ARMPBCOUNT,,accepted.module.count:countk Facility:15kVDE,OpenVMS Development Environment Explanation:<ThismessageisusedtoformattextstringsO^withinVDE,andshouldnotbevisibletousersasanerrormessage.RUserAction::RContactVDEsupportfor assistance,astheNversionofVDEinuseshouldnotbe displayingthisasanerrormessage. ! u6O ARMPBGENNEW,,accepted.module.newgeneration:(newgen Facility:15VDE,OpenVMS Development Environment^ Explanation:<^ThismessageisusedtoformattextstringsOwithinVDE,andshouldnotbevisibletousersasanerrormessage.UserAction::ContactVDEsupportfor assistance,astheNversionofVDEinuseshouldnotbe displayingthisasan\errormessage. ! u6O ARMPBGENOLD,,accepted.module.oldgeneration:(oldgen Facility:15VDE,OpenVMS Development Environment^ Explanation:<^ThismessageisusedtoformattextstringsOwithinVDE,andshouldnotbevisibletousersasanerrormessage.UserAction::ContactVDEsupportfor assistance,astheNversionofVDEinuseshouldnotbe displayingthisasan\errormessage.( ! u2O ARMPBMODFLAG,-accepted.module.modflags:mod-(flags Facility:15VDE,OpenVMS Development Environment^ Explanation:<^ThismessageisusedtoformattextstringsOwithinVDE,andshouldnotbevisibletousersasanerrormessage.UserAction::ContactVDEsupportfor assistance,astheNversionofVDEinuseshouldnotbe displayingthisasan\errormessage.& ! ! u1O ARMPBMODNAME,,accepted.module.modname:(modname Facility:15VDE,OpenVMS Development Environment^ Explanation:<^ThismessageisusedtoformattextstringsOwithinVDE,andshouldnotbevisibletousersasanerrormessage.UserAction::ContactVDEsupportfor assistance,astheNversionofVDEinuseshouldnotbe displayingthisasan\errormessage.*" u:OARMPBREPLREMARK,,accepted.module.replaceremark:( replaceremark Facility:15VDE,OpenVMS Development Environment^ Explanation:<^ThismessageisusedtoformattextstringsOwithinVDE,andshouldnotbevisibletousersasanerrormessage.UserAction::ContactVDEsupportfor assistance,astheNversionofVDEinuseshouldnotbe displayingthisasan\errormessage.)# M u9OARMPBRESREMARK,,accepted.module.reserveremark:( reserveremark Facility:15VDE,OpenVMS Development Environment^ Explanation:<^ThismessageisusedtoformattextstringsOwithinVDE,andshouldnotbevisibletousersasanerrormessage.UserAction::ContactVDEsupportfor assistance,astheNversionofVDEinuseshouldnotbe displayingthisasan\errormessage.h$ ! u>1O ARMPBSTAGING,-accepted.module.staging:wstagingk Facility:15kVDE,OpenVMS Development Environment Explanation:<ThismessageisusedtoformattextstringsO^withinVDE,andshouldnotbevisibletousersasanerrormessage.RUserAction:5RContactVDEsupportfor assistance,asKtheversionofVDEinuseshouldnotbe displayingthisPasanerrormessage.*!*= == == == == == == == == == =\= == == == == =% ! ,OASTREAM,,accepted.checkin.stream:bstreamk Facility:15kVDE,OpenVMS Development Environment Explanation:<ThismessageisusedtoformattextstringsO^withinVDE,andshouldnotbevisibletousersasanerrormessage.RUserAction::RContactVDEsupportfor assistance,astheNversionofVDEinuseshouldnotbe displayingthisasanerrormessage.=& 9O ATTACHED,,terminalnowattachedtoprocess( process-name Facility:15VDE,OpenVMS Development Environment^ Explanation:1^TheSPAWNcommandissuesthismes-9sagebefore attachingtothenewprocess.' ! .OATYPCOD,-accepted.checkin.typecode:typek Facility:15kVDE,OpenVMS Development Environment Explanation:<ThismessageisusedtoformattextstringsO^withinVDE,andshouldnotbevisibletousersasanerrormessage.RUserAction::RContactVDEsupportfor assistance,astheNversionofVDEinuseshouldnotbe displayingthisasanerrormessage.( ! .OATYPNAM,,accepted.checkin.typename:typek Facility:15kVDE,OpenVMS Development Environment Explanation:<ThismessageisusedtoformattextstringsO^withinVDE,andshouldnotbevisibletousersasanerrormessage.RUserAction::RContactVDEsupportfor assistance,astheNversionofVDEinuseshouldnotbe displayingthisasanerrormessage.h) ! u>0O AUSERNAME,-accepted.checkin.username:Wusernamek Facility:15kVDE,OpenVMS Development Environment Explanation:<ThismessageisusedtoformattextstringsO^withinVDE,andshouldnotbevisibletousersasanerrormessage.RUserAction:5RContactVDEsupportfor assistance,asKtheversionofVDEinuseshouldnotbe displayingthisPasanerrormessage.*!*= == == == == == == == == == =\= == == == == =*  *OBADASSUMPTION,,bad assumption,Ename *,]value 8,(value Facility:15VDE,OpenVMS Development Environment^ Explanation:8^VDEhasdetectedan inconsistencyinits!internalmemorypool.RUserAction:9RPleasecontactVDEsupportfor assistance.FPleaseincludeany informationthatmaybeusefulor2releventin duplicatingtheproblem.+  3OBADCHAR,,illegal character encounteredk Facility:15kVDE,OpenVMS Development Environment Explanation:6An unanticipated characterwasfoundonH^thecommandline.(This charactermaybefoundtohaveImeaninginother syntaxes;however,itlacksmeaninginthiscontext.UserAction:9Verifythe appropriatesyntaxofthespe-cificcommand.B, w5O BADFILNAM,,illegalfile specification'ytext 'k Facility:15kVDE,OpenVMS Development Environment Explanation:6Theprovidedfilenamedoesnotfollow:^standardVMSfile specification conventions.  -  2O BADIMAFLA,-badimageflavordetectedk Facility:15kVDE,OpenVMS Development Environment Explanation:5VDEhasdetectedan inconsistentimage^flavorsetting.UserAction:9PleasecontactVDEsupportfor assistance.FRPleaseincludeany informationthatmaybeusefulor2releventin duplicatingtheproblem.. ! @O BADMARKER,,badmarkerfileformatfor generation( generation Facility:15VDE,OpenVMS Development Environment^ Explanation:3^TheCMSelementforamoduleshouldIcontainamarkerfilethatpointstotheactualsourceImodule,butthe indicated generationofthemoduledoesLhnotcontainavalidmarkerfile.+Thiserrorisalsoseen>when /OUTPUT=NLA0:,is specifiedonaFETCHor>RESERVEofamodulethatusesamarkerfile.UserAction:3ExaminethetextoftheCMSgenera-E tionusingCMSdirectlyto determinewhatiswrong.HeIfthemoduleshouldnotusemarkerfiles,changeitsA marker-file attributewiththeMODIFYMODULEcom-Imand.*Ifitshouldusemarkerfiles, determinewhatisDowrongwiththeCMSelementandrepairitwithCMSKsoitpointstothe appropriateactualsourcemodule.+IfA  /OUTPUT=NLA0:(was specified, respecifythecommand4ywithanon-nulldeviceand directory./  &5O BADQUESTAT,,badstatusforbatchqueueHqueue-(name Facility:15VDE,OpenVMS Development Environment^ Explanation:8^Abatchqueuetowhichyouareattempt-Oingtosubmitabuildjobisnot available.(ThereasonwhyNitisnot availableisgivenbyasecondmessage followinghthismessage.UserAction:9Thisisan informationalmessageonly.)IfI\youneedthe displayedbatchqueueforyourbuildjob,Ostopthebuildjobandresubmititlaterwhenthequeueis  availableagain.0  2O BADSCRATCH,-bad SYS$SCRATCH directoryp Facility:15pVDE,OpenVMS Development Environment  Explanation:9 The directory specification associatedwithAdthe SYS$SCRATCHlogicalnameisnot syntacticallyBcorrect.& AssociatedwiththeVDE$_INVDIRSPECerror.WUserAction:5WReentertheVDEcommandafterredefin-Cing SYS$SCRATCHtoavalid directoryspecification.1  1O BADSTATUS,,badstatusreturnedfrom routine-namek Facility:15kVDE,OpenVMS Development Environment Explanation:7VDEgotan unexpectederrorstatusfrom.^asystemserviceorRTLroutine^ routine-name^thatitcalled.RUserAction:3RExaminethe associatederrormessagesFand determineiftheproblemcanberemediedthroughGchangestoprocessquotasortoSYSGEN parameters,orJ\duetoa site-specific configurationproblem.'ContactVDE#supportfor assistance.2  ~>O BADVMSVERS,-unableto interpretOpenVMSversion(string:( VMS-version Facility:15VDE,OpenVMS Development Environment^ Explanation:1^VDEisunableto determineOpenVMSDversion informationfromtheversionstringreturnedIeitherfroma SYS$GETSYIservicecallorfromatrans-@hlationofthelogicalnameVDE$VMS_VERSION.ThisLmayindicateyouarerunninganinternal baselevelofthe operatingsystem.UserAction:.DefinethelogicalnameVDE$VMS_G VERSIONtoavalidOpenVMSversionstringvalue.'This?ewilloverridethevaluereturnedby SYS$GETSYI.h3 >?O BINSRCMOD,,binarysourcemodulescannotbedis-!(playedor differenced Facility:15VDE,OpenVMS Development Environment^ Explanation:/^YouhaveenteredaSHOWorEDITEcommandtodisplayabinary (non-text)sourcemoduleHorthe differencesbetweentwo generationsofabinaryEhsourcemodule.)Thesecommandsdonotworkonbinarymodules.\UserAction:4\DonotusetheSHOWorEDITcommand&onbinarysourcemodules.4 t0O BITRANGE,,bitrangeoutoflimitsk Facility:15kVDE,OpenVMS Development Environment5 ! "O BLDALRSTART,-buildjob job)forstreamstreamC(alreadystarted;buildjobcannotbestartedagain Facility:15VDE,OpenVMS Development Environment^ Explanation:>^Youare attemptingtostartabuildjobthatKcannotbestartedbecauseithasalreadybeenstarted.)ARbuildjobcanonlybestartedifitisnotqueuedforexecu-Vhtionorifitis suspended.&Asaresult,the specifiedbuildjob"couldnotbestarted.\UserAction:9\Thisisan informationalmessage.'Nouseractionis required.g6  u=!O BLDALRSTOP,-buildjob ^jobforstreamstream has<(alreadystopped;buildjobcannotbestoppedagain Facility:15VDE,OpenVMS Development Environment Explanation:=Youare attemptingtostopabuildjobthatIhasalreadybeenstoppedorthathasalready completed.ChAsaresult,thebuildjobcouldnotbestopped.UserAction:9Thisisan informationalmessage.'Nouser\actionis required.o7 E=O BLDINIFAIL,-buildinitialization completedwith(errors Facility:15VDE,OpenVMS Development Environment^ Explanation:<^ThebuildinitializationforabuildjoborIacompileorlink operation completedwithoneormoreAerrors.,TheDCLcommandsthatfailedweregener-Khatedfromthebuildinitializationscriptforthedefault developmentstream.\UserAction:2\Correcttheerrorsandresubmitthe& compilationorbuildjob.!8 ! >O BLDJOBACT,-buildjobalreadyactiveforstream(stream#(;newjobnotcreated Facility:15VDE,OpenVMS Development Environment^ Explanation::^YouhavetriedtocreateanewbuildjobCwiththeBUILDcommandwhenanotherbuildjobforHthesame developmentstreamisalreadyactive.)AbuildMhjobis ``active''unlessithas completed executionorhasKbeenstopped.'YoucannothavemorethanoneactivebuildMjobforthesamestreamatanyonetimesincethatcouldPrcausetwobuildjobstowritetothesameresult directoriesatthesametime.eUserAction:=eAllowthefirstbuildjobtocompletebeforeKyoucreatethenextone.)Alternatively,youcanstoptheCpreviousbuildjobwiththeSTOP BUILD_JOBcommand2oandthencreatethenewbuildjob. 9  u^:O BLDJOBAFTER,-buildjobtobestartedaftertimek Facility:15kVDE,OpenVMS Development Environment Explanation:=ThebuildjobyouarestartingwillactuallyC^start executingafterthe indicateddateandtime.UserAction:9Thisisan informationalmessageonly.)IfIRyoudonotwantthejobstartedaftertheshowntime,BstopthejobwiththeSTOP BUILD_JOBcommandandJrestartitwitha differenttimeusingtheSTARTBUILD_\JOBcommand.: | O BLDJOBCRE,-buildjob jobforstreamqstream has(beencreated Facility:15VDE,OpenVMS Development Environment^ Explanation:7^Thismessageinformsyouthattheindi-LcatedbuildjobhasbeencreatedintheVDEdatabaseforGthe indicated developmentstream.)ThismessageisonlyFhissuedwhenyouusethe/LOG qualifierontheBUILDcommand.\UserAction:5\Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage.; u] O BLDJOBDEL,,buildjob jobforstream`streamdeleted(fromdatabase Facility:15VDE,OpenVMS Development Environment^ Explanation:7^Thismessageinformsyouthattheindi-JcatedbuildjobhasbeendeletedfromtheVDE database.DThismessageisonlyissuedwhenyouusethe/LOG9h qualifierontheDELETE BUILD_JOBcommand.UserAction:5Usethe/NOLOG qualifierforthecom->\mandifyoudonotwishtoseethemessage.<  #O BLDJOBENT,-entrynumberentry submittedtoqueue(queue Facility:15VDE,OpenVMS Development Environment^ Explanation:8^Aprocesshas successfullybeen submittedLtothe indicatedbatchqueue.)Itreceivedthequeueentry*numbershowninthemessage.UserAction:9Thisisan informationalmessage.'Nouseractionis required.= ! /;O BLDJOBERR,,errorqueuingbuildjobonqueue(queue!(;processnotqueued Facility:15VDE,OpenVMS Development Environment^ Explanation:3^Anerroroccurredwhen attemptingtoIqueueaprocessonthe indicatedbatchqueueonbehalfMofabuildjobyouare starting.)ThemessagethatfollowsIhgivesmore informationonthereasonfortheerror.*InNthiscase,nomore processesare submittedtothe indicatedKqueue.(Yourbuildjobwillthusrunwithfewer processes rthanyour requested. UserAction:9 Thisisan informationalmessageonly.)IfOeyouneedthe displayedbatchqueueforyourbuildjob,stopPthebuildjob,correcttheerror,andresubmitthebuildjob8laterwhenthequeueis availableagain.> x O BLDJOBMOD,,buildjob 6jobforstreamstreammodi-(fiedindatabase Facility:15VDE,OpenVMS Development Environment^ Explanation:5^Thismessageinformsyouthatinforma-Mtionforthe indicatedbuildjobhasbeenmodifiedintheDVDE database.+Thismessageisonlyissuedwhenyou?husethe/LOG qualifierontheMODIFY BUILD_JOBcommand.\UserAction:5\Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage.? uj O BLDJOBSIZ,,buildjob job|forstreamBstreamwconsists (of>(steps(steps Facility:15VDE,OpenVMS Development Environment^ Explanation:5^ThismessagetellsyouhowmanybuildKstepsthereareinthe indicatedbuildjob.*ThismessageIisonlyissuedwhenyouusethe/LOG qualifieronthe/hBUILDorSTART BUILD_JOBcommand.UserAction:5Usethe/NOLOG qualifierforthecom->\mandifyoudonotwishtoseethemessage.@  $OBLDJOBSTARTED,,buildjob jobforstreamWstream(startedwith( processesl( processes Facility:15VDE,OpenVMS Development Environment^ Explanation:6^Thebuildjobwiththeshown build-jobBidentificationnumberforthe indicated developmentHstreamhas successfullybeenstarted.'ThemessageshowsKhtheactualnumberofparallel processesthatwillexecutethebuildjob.\UserAction:9\Thisisan informationalmessage.'Nouseractionis required.A ! &/OBLDJOBSTARTING,,startingbuildjob job forstream(stream Facility:15VDE,OpenVMS Development Environment^ Explanation:6^Thebuildjobwiththeshown build-jobBidentificationnumberforthe indicated developmentMstreamisabouttobestarted.'Thismessagecomesoutbe-Phforethe processesthatwillrunthebuildjobare submittedItobatchqueues.+Itspurposeistoletyouknowwhich)buildjobisbeingstarted.UserAction:9Thisisan informationalmessage.'Nouser actionis required.&B !O BLDJOBSTOP,,buildjob Yjobforstreamstream(stopped Facility:15VDE,OpenVMS Development Environment^ Explanation:9^The indicatedbuildjobhasbeenstopped.DThismessageisonlyissuedwhenyouusethe/LOG7 qualifierontheSTOP BUILD_JOBcommand.UserAction:5Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage.C y!O BLDJOBSUSP,-buildjob Njobforstreamstreamsus-(pended Facility:15VDE,OpenVMS Development Environment^ Explanation:5^The indicatedbuildjobhasbeensus-Jpended.)A suspendedbuildjobcanbe restartedwiththeBSTART BUILD_JOBcommand.(Thismessageisonlyis-Fhsuedwhenyouusethe/LOG qualifierontheSUSPEND BUILD_JOBcommand.\UserAction:5\Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage.^D  4 O BLDNOTRUN,,buildjob BjobforstreamstreamisnotA(queuedorrunning;buildjobcannotbe suspended Facility:15VDE,OpenVMS Development Environment^ Explanation::^Youare attemptingtosuspendabuildjobLthatisnot currentlyqueuedfor executionorrunning.(AsAaresult,thebuildjobcouldnotbe suspended.UserAction:9Thisisan informationalmessage.'Nouseractionis required.* E ! =O BLDSTEPNEED,-buildstepneededtomakeinputs( up-to-date:(stepstep Facility:15VDE,OpenVMS Development Environment^ Explanation::^The indicatedbuildstepneedstobeper-Eformedtomakeallinputmodules up-to-datefortheIcompileorlink operationyouhave requested.*Thissit-Hhuationcanoccurif,forexample,youhavemodifiedaHsourcemodulewithout compilingit(sothatthecorre-Ispondingobjectmoduleisnolonger up-to-date)andyouMrthenrequestalinkthatincludestheold, non-currentob-Hjectmodule.+Thisisan informationalmessagetoalertL#youthatyourcompileorlinkwillnotproducefullyup-P{to-dateoutputs,butthe requestedcompileorlinkwillstill,be performedasyou requested.oUserAction:?oIftheoutputsofthecompileorlinkdonotKneedtobe up-to-date,noactionis necessary.( Otherwise,A youcanuseCOMPILE,LINK,orBUILDcommandstoLyperformthebuildstepsneededtomakeallinputstotheKoriginalcompileorlink operation up-to-datewithrespectK*toallsourcechanges.)Youcanthenrepeatthatoriginal operation.tF ! 9JOBLDSTEPNOTSHO,steps#h additionalneededbuild(stepsnotshown Facility:15VDE,OpenVMS Development Environment^ Explanation:;^Ifmorethan30buildstepsareneededtoHmaketheinputstoa requestedcompileorlinkup-to-Ddate, BLDSTEPNEEDmessagesareonlyprintedfortheBhfirst30suchbuildsteps.*Thenthe BLDSTEPNOTSHOJmessageisprintedtoindicatehowmany additionalbuildIstepsareneeded,butthosebuildstepsarenotlistedr individually. UserAction:? IftheoutputsofthecompileorlinkdonotKeneedtobe up-to-date,noactionis necessary.( Otherwise,AyoucanuseCOMPILE,LINK,orBUILDcommandstoLperformthebuildstepsneededtomakeallinputstotheKooriginalcompileorlink operation up-to-datewithrespectKtoallsourcechanges.)Youcanthenrepeatthatoriginal  operation.nG  uD*O CMSBADGEN,-badCMS generation  generationfound(formodule(module(possibleCMSerror Facility:15VDE,OpenVMS Development Environment^ Explanation:3^The indicatedbadCMS generationex-KpressionwasfoundinanexistingCMSlibrary;thecauseJisprobablyanerrorinCMS.Theaffected generationis0hnotrecordedintheVDE database.UserAction:5ExaminetheCMSlibraryandconsulta\CMSexpert.H  $OCMSCLASSEXIST,,CMSclassclassalreadyexistsfor(CMSfacility(facility Facility:15VDE,OpenVMS Development Environment^ Explanation:9^The indicatedCMSclasswasfoundtoal-Kreadyexistinthe indicatedCMS facility,sowedonot"attempttocreateit.UserAction:None.yI uO>O CMSCRECLASS,-CMSerrorwhencreatingCMSclass(class(infacilityQ(facility Facility:15VDE,OpenVMS Development Environment^ Explanation:.^CMS(Code ManagementSystem)hasHreturnedanerrorstatuswhencreatingaCMSclassinHthe indicated facility.+The subsequentprintlineshows7hwhatspecificerrorstatusCMS returned.UserAction:8Iftheproblemappearstobeduetoan<\internalVDEerror,submitaproblemreport.aJ ! 7O CMSCRELIB,,CMSerrorwhencreatingCMSlibrary(forfacility(facility Facility:15VDE,OpenVMS Development Environment^ Explanation:.^CMS(Code ManagementSystem)hasHreturnedanerrorstatuswhencreatingtheCMSlibraryMforthe indicated facility.'The subsequentprintlineshowsDhwhatspecificerrorstatusCMS returned.-ThiserrorIshouldnotoccurunlessyouhave insufficient privilegesLtoaccesstheVDElibraryorunlessyouhaverunoutof0rsomeresourcesuchasdiskspace. UserAction:; Iftheerroriscausedbynothavingsuf-Leficient privilegesor resourcestoperformtheaction,youBmustcorrectthe deficiency.,ThentrythecommandJagain.+Iftheproblemappearstobeduetoaninternal2oVDEerror,submitaproblemreport.L :O CMSDELELEM,-CMSerrorwhendeletingelement(element Facility:15VDE,OpenVMS Development Environment^ Explanation:.^CMS(Code ManagementSystem)hasEreturnedanerrorstatuswhendeletingthe indicatedFmodule'sCMSelement.(The subsequentprintlineshowsDhwhatspecificerrorstatusCMS returned.-ThiserrorIshouldnotoccurunlessyouhave insufficient privilegesLtoaccesstheVDElibraryorunlessyouhaverunoutofrsome resource. UserAction:; Iftheerroriscausedbynothavingsuf-Leficient privilegesor resourcestoperformtheaction,youBmustcorrectthe deficiency.,ThentrythecommandJagain.+Iftheproblemappearstobeduetoaninternal2oVDEerror,submitaproblemreport.M  0O CMSDUPGEN,, duplicateCMS generation generation(foundformodule(module(possibleCMSerror Facility:15VDE,OpenVMS Development Environment^ Explanation:5^The indicatedCMS generationwasfoundImorethanonceforthesameCMSelement;thecauseisKprobablyanerrorinCMS.Theaffected generationisnot+hrecordedintheVDE database.UserAction:5ExaminetheCMSlibraryandconsulta\CMSexpert.O  =O CMSFETCH,,CMSerrorwhenfetchingCMSelement(formodule(module Facility:15VDE,OpenVMS Development Environment^ Explanation:.^CMS(Code ManagementSystem)hasEreturnedanerrorstatuswhenfetchingtheCMSele-Jmentforthe indicatedmodule.(The subsequentprintlineDhshowswhatspecificerrorstatusCMS returned.,ThisKerrorshouldnotoccurunlessyouhave insufficientpriv-KilegestoaccesstheVDElibraryorunlessyouhaverun9routofsomeresourcesuchasdiskspace. UserAction:; Iftheerroriscausedbynothavingsuf-Leficient privilegesor resourcestoperformtheaction,youBmustcorrectthe deficiency.,ThentrythecommandJagain.+Iftheproblemappearstobeduetoaninternal2oVDEerror,submitaproblemreport.P  u7O CMSINSGEN,,CMSerror inserting generationgenera-(tion(ofelementW(element(intoclass?(class Facility:15VDE,OpenVMS Development Environment^ Explanation:.^CMS(Code ManagementSystem)hasGreturnedanerrorstatuswhen insertingaCMSelementJ generationintothe indicatedclass.(The subsequentprintDhlineshowswhatspecificerrorstatusCMS returned.UserAction:8Iftheproblemappearstobeduetoan<\internalVDEerror,submitaproblemreport.f! Q k)O CMSLIBEMPTY,,theCMSlibrarylibrarycontainsno(elements Facility:15VDE,OpenVMS Development Environment^ Explanation:3^SincetheCMSlibrary specifiedwithDthe /CMS_LIBRARY qualifierisempty,nomodulesarecreated.UserAction:None.R ! ur?O CMSMODCLASS,,CMSerror modifyingtheclassname(class (to((class(infacility(facility Facility:15VDE,OpenVMS Development Environment^ Explanation:.^CMS(Code ManagementSystem)hasEreturnedanerrorstatuswhen modifyingaCMSclassKnameinthe indicated facility.)The subsequentprintline>hshowswhatspecificerrorstatusCMS returned.UserAction:8Iftheproblemappearstobeduetoan<\internalVDEerror,submitaproblemreport.S !O CMSNOCLASS,-CMSclassclassdoesnotexistfor(facility(facility.-(UnabletomodifyCMSclassname Facility:15VDE,OpenVMS Development Environment^ Explanation:6^The indicatedCMSclassdoesnotexistPinthe indicated facility,sowearenotabletomodifyitsname.UserAction:None.yT  uO3O CMSREMGEN,-CMSerrorremovingelement|element(fromclass(class Facility:15VDE,OpenVMS Development Environment^ Explanation:.^CMS(Code ManagementSystem)hasFreturnedanerrorstatuswhenremovingaCMSelementJ generationfromthe indicatedclass.'The subsequentprintDhlineshowswhatspecificerrorstatusCMS returned.UserAction:8Iftheproblemappearstobeduetoan<\internalVDEerror,submitaproblemreport.U  =O CMSREPLACE,,CMSerrorwhen replacingCMSele-(mentformodule(module Facility:15VDE,OpenVMS Development Environment^ Explanation:.^CMS(Code ManagementSystem)hasEreturnedanerrorstatuswhen replacingtheCMSel-Eementforthe indicatedmodule.+The subsequentprintJhlineshowswhatspecificerrorstatusCMS returned.(ThisKerrorshouldnotoccurunlessyouhave insufficientpriv-KilegestoaccesstheVDElibraryorunlessyouhaverun9routofsomeresourcesuchasdiskspace. UserAction:; Iftheerroriscausedbynothavingsuf-Leficient privilegesor resourcestoperformtheaction,youBmustcorrectthe deficiency.,ThentrythecommandJagain.+Iftheproblemappearstobeduetoaninternal2oVDEerror,submitaproblemreport.V  =O CMSRESERVE,,CMSerrorwhen reservingCMSele-(mentformodule(module Facility:15VDE,OpenVMS Development Environment^ Explanation:.^CMS(Code ManagementSystem)hasEreturnedanerrorstatuswhen reservingtheCMSel-Eementforthe indicatedmodule.+The subsequentprintJhlineshowswhatspecificerrorstatusCMS returned.(ThisKerrorshouldnotoccurunlessyouhave insufficientpriv-KilegestoaccesstheVDElibraryorunlessyouhaverun9routofsomeresourcesuchasdiskspace. UserAction:; Iftheerroriscausedbynothavingsuf-Leficient privilegesor resourcestoperformtheaction,youBmustcorrectthe deficiency.,ThentrythecommandJagain.+Iftheproblemappearstobeduetoaninternal2oVDEerror,submitaproblemreport.W ! /BO CMSSETLIB,-CMSerrorwhensettingCMSlibraryfor(facility(facility Facility:15VDE,OpenVMS Development Environment^ Explanation:.^CMS(Code ManagementSystem)hasFreturnedanerrorstatuswhenmakingtheCMSlibraryIforthe indicatedfacilitythecurrentCMSlibrary.*TheGh subsequentprintlineshowswhatspecificerrorstatusFCMS returned.*ThiserrorshouldnotoccurunlessyouHhave insufficient privilegestoaccesstheVDElibrary.UserAction:;Iftheerroriscausedbynothavingsuf-L ficient privilegestoperformtheaction,youmustcorrectKethe deficiency.'Thentrythecommandagain.'Iftheprob-MlemappearstobeduetoaninternalVDEerror,submitaproblemreport.X  ub:O CMSSHOWCLASS,-CMSerrorwhen retrievingCMS)(class informationinlibrary;(library Facility:15VDE,OpenVMS Development Environment^ Explanation:.^CMS(Code ManagementSystem)hasHreturnedanerrorstatuswhen retrievingCMSclassin-H formationforthe indicatedCMSlibrary.(The subsequentKhprintlineshowswhatspecificerrorstatusCMS returned.UserAction:8Iftheproblemappearstobeduetoan<\internalVDEerror,submitaproblemreport.Y h;OCMSSHOWDESGEN,,CMSerrorwhen retrievingCMS!( generationofelementw(element Facility:15VDE,OpenVMS Development Environment^ Explanation:.^CMS(Code ManagementSystem)hasDreturnedanerrorstatuswhen retrievingCMSgener-Eation informationforthe indicatedCMSelement.+TheGh subsequentprintlineshowswhatspecificerrorstatusCMS returned.\UserAction:8\Iftheproblemappearstobeduetoan<internalVDEerror,submitaproblemreport.Z `9O CMSSHOWELEM,,CMSerrorwhen retrievingCMS(elementinlibrary(library Facility:15VDE,OpenVMS Development Environment^ Explanation:.^CMS(Code ManagementSystem)hasEreturnedanerrorstatuswhen retrievingCMSelementF informationforthe indicatedCMSlibrary.*Thesubse-GhquentprintlineshowswhatspecificerrorstatusCMS returned.\UserAction:8\Iftheproblemappearstobeduetoan<internalVDEerror,submitaproblemreport.[ `9O CMSSHOWHIST,-CMSerrorwhen retrievingCMS(historyinlibrary(library Facility:15VDE,OpenVMS Development Environment^ Explanation:.^CMS(Code ManagementSystem)hasEreturnedanerrorstatuswhen retrievingCMShistoryF informationforthe indicatedCMSlibrary.*Thesubse-GhquentprintlineshowswhatspecificerrorstatusCMS returned.\UserAction:8\Iftheproblemappearstobeduetoan<internalVDEerror,submitaproblemreport.\ h8O CMSSHOWRES,,CMSerrorwhen retrievingCMS#( reservationsinlibraryg(library Facility:15VDE,OpenVMS Development Environment^ Explanation:.^CMS(Code ManagementSystem)hasDreturnedanerrorstatuswhen retrievingCMSreser-Fvation informationforthe indicatedCMSlibrary.+TheGh subsequentprintlineshowswhatspecificerrorstatusCMS returned.\UserAction:8\Iftheproblemappearstobeduetoan<internalVDEerror,submitaproblemreport.v ']  CO CMSSTART,-starting retrievalofCMS informationfor(facility(facility Facility:15VDE,OpenVMS Development Environment^ Explanation::^VDEisstartingtoretrievemodule,gener-Hation,and reservation informationfromtheexitingCMSOlibraryforthe indicated facility.(Afterthis informationisEh retrieved,itwillbeincludedintheVDE database.UserAction:None.^  u]FO CMSVARLET,,allCMSvariantlettersinuse;noneleft(formodule(module Facility:15VDE,OpenVMS Development Environment^ Explanation:;^AllCMSvariantlettersupto"Z"areal-Kreadyinuseforthe indicatedmodule.'Hencethecurrent4REPLACE operationcannotbe performed.UserAction:8Submitaproblemreport.+ThisisaveryFunlikely situation,butthereisnoknown workaround.I\ AdditionalVDEcodeisneededtohandlethis situation.j_ @\mandifyoudonotwishtoseethemessage.f &1O COMSTEPDEL,,compilestepformodulemodule!(deletedfromdatabase Facility:15VDE,OpenVMS Development Environment^ Explanation:6^Thismessageinformsyouthatthecom-Kpilestepforthe indicatedmodulehasbeendeletedfromHtheVDE database.)Thismeansthatallbuild dependencyHh informationforthatbuildstephasbeendeleted.,ThisImessageisonlyissuedwhenyouusethe/LOG qualifier)ontheDELETESTEPcommand.UserAction:5Usethe/NOLOG qualifierforthecom-> mandifyoudonotwishtoseethemessage.g m1O COMSTEPMOD,,compilestepformodule module (modifiedindatabase Facility:15VDE,OpenVMS Development Environment^ Explanation:7^Thismessageinformsyouthatbuildde-Hpendency informationforthe indicatedcompilestephasJbeenmodifiedintheVDE database.(ThismessageisonlyGhissuedwhenyouusethe/LOG qualifierontheMODIFYSTEPcommand.\UserAction:5\Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage.h  9Z:O COMTERMEOF,,command terminatedbyCTRL/Zor ( end-of-fileoninput Facility:15VDE,OpenVMS Development Environment^ Explanation:2^Thecurrentcommandhasbeentermi-EnatedbecausetheuserenteredaCTRL/ZinresponseItoaqueryfor additional informationneededtoexecuteChthecommand.+Alternatively,an end-of-filemayhaveLbeen encounteredinthecurrentinputfileinresponsetoNsuchaquery.(ThiserrorcanalsoappearifanattemptisDrmadetouseDCLcommand procedurewithaVDEkept subprocess.eUserAction:9eNotanerrorsinceausermay intention-Eally terminatecommandsinthisway.,ToexecutetheEoriginalcommand,reenterthecommandandsupplyallDorequired information.)IfusingaDCLcommandproce-JduretoissueVDE commands,disabletheuseoftheVDEH kept subprocess,orswitchtoaVDEcommand procedure. i &-O CONCURRES,- concurrent reservationm reservation Hof(module(byuserW(user!(alreadypresent Facility:15VDE,OpenVMS Development Environment^ Explanation:8^Youare reservingamodulewhichisal-Ireadyreservedbyanotheruser (possibly yourself).(That8 reservationallows concurrent reservations.UserAction:5Thisisan informationalmessagewhichDappearswhenyouarecreatinga concurrentreserva-I\tion.)ThismessageinformsyouofeachalreadyexistingK reservationforthesamemodulethatcoversatleastone commonstream.j 9OCONFACC,-unabletoaccessnotes conferencek Facility:15kVDE,OpenVMS Development Environment Explanation:5Checkthenotes conferenceforgeneralE^accessability,and-if conference membershipisneeded-G determineifyouareamemberofthe conferencefrom7thenodeonwhichyouarerunningVDE.UserAction:-Seethe accompanying message(s).k &=O CONFLICT,- conflicting qualifersand/orkeywords( specified Facility:15VDE,OpenVMS Development Environment^ Explanation:7^ThismessageisissuedwhenVDEdetectsF conflicting qualifiersand/orkeywordswithinthesamecommand.UserAction:3Verifythe intentionofyourcommandNandseeiftheuseofaspecific qualifierorkeywordmayN\excludetheuseofoneoftheother qualifiersand/orkey-Dwords.*SeeVDE ReferenceManualfor assistancewith thecommandsyntax.l ?OCONFMEM,,check conferencefile accessabilityand( membership Facility:15VDE,OpenVMS Development Environment^ Explanation:5^Checkthenotes conferenceforgeneralEaccessability,and-if conference membershipisneeded-G determineifyouareamemberofthe conferencefrom7hthenodeonwhichyouarerunningVDE.UserAction:-Seethe accompanying message(s).:m *OCONFNAM,, conferencefilenamenamek Facility:15kVDE,OpenVMS Development Environment Explanation::Thisisthenameofthenotes conference.UserAction:-Seethe accompanying message(s).n  2O CONKEYATR,- conflictingkey attributes key-attribute (and( key-attribute Facility:15VDE,OpenVMS Development Environment^ Explanation:2^TherecentlyissuedDEFINEKEYcom-Emandhas conflicting qualifierssuchas/NOSTATEand /LOCK_STATE.UserAction:9 Determinecorrect applicabilityandreissuethecommand. o ! .OCONQUAL,, conflicting qualifiers/ qualifier$and/quali-(fier Facility:15VDE,OpenVMS Development Environment^ Explanation:7^Theabove mentioned qualifiersaremutu-ally exclusive.RUserAction:8RVerifythe intentionofyourcommandandOseeiftheuseofaspecific qualifiermaymutuallyexclude*theuseofother qualifiers.p  u-O CONRESDEL,- concurrent reservation] reservation 9of(module(foruserq(user;(hasbeendeleted Facility:15VDE,OpenVMS Development Environment^ Explanation:7^Thismessageinformsyouthattheindi-Gcated concurrent reservationhasbeendeletedfromtheCVDEdatabasebecauseyoureplacedthesamemodule.UserAction:9None.(TheaffecteduserswillbeinformedIthattheir reservationsaredeleted.)Theyshouldreserve=\themoduleagainandmergeintheirchanges.q  -O CONTINUE,- attemptingtocontinuek Facility:15kVDE,OpenVMS Development Environment Explanation:8Oneormorequotasarebelowtherecom-F^mendedvaluesforVDE.VDEwillattemptto continue.UserAction:3Contactsystem managementandrequestHRthatthequotas associatedwiththecurrentprocessbeFcomparedtothevalues recommendedforusewithVDE.^r  u4(O COPSTEPADDED,,copystepforstep9addedto(database Facility:15VDE,OpenVMS Development Environment^ Explanation:7^Thismessageinformsyouthattheindi-LcatedcopystephasbeenaddedtotheVDE database.'ThisImessageisonlyissuedwhenyouusethe/LOG qualifier)hontheCREATESTEPcommand.UserAction:5Usethe/NOLOG qualifierforthecom->\mandifyoudonotwishtoseethemessage.s &.O COPSTEPDEL,,copystepformodule<moduledeleted(fromdatabase Facility:15VDE,OpenVMS Development Environment^ Explanation:6^ThismessageinformsyouthatthecopyJstepforthe indicatedmodulehasbeendeletedfromtheCVDE database.,Thismeansthatallbuild dependencyHh informationforthatbuildstephasbeendeleted.,ThisImessageisonlyissuedwhenyouusethe/LOG qualifier)ontheDELETESTEPcommand.UserAction:5Usethe/NOLOG qualifierforthecom-> mandifyoudonotwishtoseethemessage.t ! u.O COPSTEPMOD,,copystepformodule]modulemodi-(fiedindatabase Facility:15VDE,OpenVMS Development Environment^ Explanation:7^Thismessageinformsyouthatbuildde-Kpendency informationforthe indicatedcopystephasbeenImodifiedintheVDE database.)Thismessageisonlyis-Ehsuedwhenyouusethe/LOG qualifierontheMODIFYSTEPcommand.\UserAction:5\Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage. 7u   O COPYFAIL,,copyofmodule! completedwitherrorsk Facility:15kVDE,OpenVMS Development Environment Explanation:6Thecopystepforthe indicatedmoduleK^ completedwithoneormoreerrors.'Thestep'soutput(onNyourterminalorinthestep'slogfile)givesmoredetail(ontheerrorsit detected.UserAction:8Correcttheerrorsandresubmitthecopysteporbuildjob.Pv &O COPYSUCC,,copyofmodule! completed successfullyk Facility:15kVDE,OpenVMS Development Environment Explanation:6Thecopystepforthe indicatedmodule"^ completed successfully.UserAction:None.w /O CREDIRFAI,,create directoryfailedk Facility:15kVDE,OpenVMS Development Environment Explanation:7A directory specificationonaVDEcom-I^mandisnot syntacticallycorrect.*ThismessageisalsoFprintedifalogicalname(suchas VDE$LIBRARY)thatOissupposedtobeboundtoa directory specificationisnotIhboundtoa syntacticallycorrect directoryspecification.UserAction:4ReentertheVDEcommandwithavalidJ\ directory specificationordefinethelogicalnametobe8boundtoavalid directoryspecification.x  x7O CRELNMFAI,,failedtodefinelogicalnameBlnmdsck Facility:15kVDE,OpenVMS Development Environment Explanation:4Thismessageinformsyouofthepar-H^ticularlogicalnamecreationthatfailed.*ThismessageIisnormally associatedwithothermessagesorerrorsofsomesort.UserAction:=Ifunabletoresolvethebasicerror,pleaseGcontactVDEsupportfor assistance.*PleaseincludeanyK\ informationthatmaybeusefulorreleventin duplicatingtheproblem.^y 4O CTXADDED,,contextcontext"addedtothedatabasek Facility:15kVDE,OpenVMS Development Environment Explanation:5Thismessageinformsyouthatthein-F^dicatedcontext definitionhasbeenaddedtotheVDEI database.)Thismessageisonlyissuedwhenyouusethe=/LOG qualifierontheCREATECONTEXTcommand.UserAction:5Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage.vz uLOCTXDEL,-context;context&odeletedfromthedatabasek Facility:15kVDE,OpenVMS Development Environment Explanation:6Thismessageinformsyouthatthedef-I^initionforthe indicatedcontexthasbeendeletedfromDtheVDE database.-ThismessageisonlyissuedwhenByouusethe/LOG qualifierontheDELETECONTEXThcommand.UserAction:5Usethe/NOLOG qualifierforthecom->\mandifyoudonotwishtoseethemessage.{  VO CTXDELARCH,,context 0##&containsdeleted architec-(ture( architecture Facility:15VDE,OpenVMS Development Environment^ Explanation:7^Youhave attemptedtosetthe indicatedMcontext,butthedefault architecture specifiedbythecon-Mtexthasbeendeleted.)Asaresult,thecontextcannotbehset.UserAction:8Redefinethecontextto referenceanar-H\ chitecturethathasnotbeendeleted.+Thenreissuethecommand.R| ! (O CTXDELFAC,,contextcontext%containsdeletedfacility(facility Facility:15VDE,OpenVMS Development Environment^ Explanation:7^Youhave attemptedtosetthe indicatedQcontext,butthedefaultfacility specifiedbythecontexthasHbeendeleted.'Asaresult,thecontextcannotbeset.UserAction:<Redefinethecontextto referenceafacilityFthathasnotbeendeleted.'Thenreissuethecommand.T}  *O CTXDELSTRM,,context9contextqcontainsdeleted(stream(context Facility:15VDE,OpenVMS Development Environment^ Explanation:7^Youhave attemptedtosetthe indicatedJcontext,butthedefaultstream specifiedbythecontextMhasbeendeleted.&Asaresult,thecontextcannotbeset.UserAction::Redefinethecontextto referenceastreamFthathasnotbeendeleted.'Thenreissuethecommand.~ ! O CTXEXISTS,,contextcontextalreadyexistsin*( database;contextnotchanged Facility:15VDE,OpenVMS Development Environment^ Explanation:7^The indicatedcontextnamewas specified?onaCREATECONTEXTcommand,butanentryforKthatcontextisalreadypresentinthe database.*HenceaLhnewentrywasnotcreatedforthatcontext.(Alternatively,Gthe indicatednamewas specifiedasthenewnamefor?anexistingcontextontheMODIFYCONTEXTcom-Irmand,butanothercontextalreadyhasthe requestednewIname.(Hencethenameoftheexistingcontextcouldnot*#bechangedtothenewname.UserAction:6Ifyouenteredthewrongcontextname,Hreenterthecommandwiththecorrectname.(Ifyouen-Doteredtherightcontextname,usetheSHOWCONTEXTEcommandtodisplaythedatabase informationforthatO context.'Ifyouarenot satisfiedwiththat information,use8ytheMODIFYCONTEXTcommandtochangeit. `,OCTXMOD,- informationforcontextcontext#modified(inthedatabase Facility:15VDE,OpenVMS Development Environment^ Explanation:3^Thismessageinformsyouthatinfor-Gmationforthe indicatedcontexthasbeenmodifiedinDtheVDE database.-ThismessageisonlyissuedwhenBhyouusethe/LOG qualifierontheMODIFYCONTEXTcommand.\UserAction:5\Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage.V u,O CTXNOTFOUND,,contextcontextnotfoundin'( database; parameterignored Facility:15VDE,OpenVMS Development Environment^ Explanation:5^The indicatedcontextnamewasentered@onaSHOWCONTEXTcommand,butnosuchcontext-wasfoundintheVDE database.UserAction:;Thisisnot necessarilyanerror;themes-Lsagesimplytellsyouthatthe indicatedcontextdoesnot#\existinthe database.   5O CTXSYNTAX,,invalidcontextnamesyntax:Znamek Facility:15kVDE,OpenVMS Development Environment Explanation:4Thenameorformat specifiedforthe7^contextnameisnotusingvalidsyntax.UserAction:4 RespecifythecontextnameusingonlyFR alphanumeric, underscore,dollarsignandhyphenchar-acters. &OCULPRIT,,reservedbyuseruserk Facility:15kVDE,OpenVMS Development Environment Explanation:4themoduleisreservedbythespeci-I^fieduser.)The reservationwas requestedinthecurrentBstream,orinanancestorofthecurrentstream.RUserAction:8RThismessageisinformational,andshould; accompanyoneormoreothererror messages.  ?O DATETOOLONG,, date-timevalueistoolong;maxi-(mumlengthis24:(date x(... Facility:15VDE,OpenVMS Development Environment^ Explanation:6^A date-timevalueenteredasacommandF parameteristoolongbecauseitexceedsthemaximum.length indicatedinthemessage.UserAction:1Reissuethecommandwithashorter date-timevalue. k`4ODBCNV,, convertingdatabaseformatfromoldver ,to(newver Facility:15VDE,OpenVMS Development Environment^ Explanation:;^Thismessageisusedtodisplaythestatus1ofadatabase conversion operation.RUserAction:#RNoactionis required.  kO DBCREATED,-database +dbhasbeencreatedk Facility:15kVDE,OpenVMS Development Environment Explanation:9Thismessage indicatesthatanewlibraryI^ database,and associateddatabasefiles, directories,and-CMS librarieshasbeencreated.RUserAction:RNone required. kk&ODBFMT,-databaseformatis verk Facility:15kVDE,OpenVMS Development Environment Explanation:9Thismessageisusedtodisplaythecur-K^rentversionofa database,orthestatusofadatabase  conversion operation.RUserAction:#RNoactionis required.  uoO DBGCMSGEN,,at!codept,letflg6bool,item1itm1,item2 (did Facility:15VDE,OpenVMS Development Environment^ Explanation:4^ThismessagedisplaysvariousinternalDprocess-relatedvaluesusedwithinVDE.ThismessageFshouldappearonlyduringVDEtesting,andshouldbe<h displayedonlyby debuggingversionsofVDE.UserAction::ContactVDEsupportfor assistance,astheB\versionofVDEinusecontains debug-onlyimages.[  1O DBGCMSTXT,,at codept,expected genk Facility:15kVDE,OpenVMS Development Environment Explanation:4ThismessagedisplaysvariousinternalD^process-relatedvaluesusedwithinVDE.ThismessageFshouldappearonlyduringVDEtesting,andshouldbe< displayedonlyby debuggingversionsofVDE.UserAction::ContactVDEsupportfor assistance,astheBversionofVDEinusecontains debug-onlyimages.{  uQ&ODBGDB,, debugging database:!param1 W,param2k Facility:15kVDE,OpenVMS Development Environment Explanation:6Thismessageisusedduring developmentJ^anddisplayswherethe behaviourofa debuggingorpro-JtotypeVDEimagedatabase operationdiffersfromthatof$a productionVDEimage.UserAction::ContactVDEsupportfor assistance,astheNversionofVDEinuseshouldnotbe displayingthisasan\errormessage.  e6O DBGLNMBAT,-debuglogicalname VDE$BATCH_.MODE:.mode Facility:15VDE,OpenVMS Development Environmentd Explanation:4dThismessage indicatesthebatchmodeJsettingofVDE,andshouldappearonlyduringVDEtest-King.)Thismessageis displayedonlybydebugversionsofImVDE,andthislogicalnameis translatedonlybydebug versions.aUserAction::aContactVDEsupportfor assistance,astheBversionofVDEinusecontains debug-onlyimages.z  zP:O DBGLNMDAT,,debuglogicalnameVDE$DATE_TIME:.mode Facility:15VDE,OpenVMS Development Environmentd Explanation:8dThismessage indicatesthe date-timeset-JtingofVDE,andshouldappearonlyduringVDEtesting.KThismessageis displayedonlybydebugversionsofVDE,Nmandthislogicalnameis translatedonlybydebug versions.UserAction::ContactVDEsupportfor assistance,astheBaversionofVDEinusecontains debug-onlyimages.x  zN9O DBGLNMUSR,,debuglogicalname VDE$USERNAME:.mode Facility:15VDE,OpenVMS Development Environmentd Explanation:7dThismessage indicatestheusernameset-JtingofVDE,andshouldappearonlyduringVDEtesting.KThismessageis displayedonlybydebugversionsofVDE,Nmandthislogicalnameis translatedonlybydebug versions.UserAction::ContactVDEsupportfor assistance,astheBaversionofVDEinusecontains debug-onlyimages.V   *O DBGNOLNM,,unableto translate logicalnamek Facility:15kVDE,OpenVMS Development Environment Explanation:7VDEwasunableto translatea mandatory^logicalname.UserAction:5ContactVDEsupportfor assistance,asGRtheversionofVDErunningcontains debug-onlyimages.GCorrecttheerrorinthe date-timelogicalnamevalue%andreissuethecommand.  k&O DBGQUALMSK,, qualifiermaskZqualmsk1qualmsk2k Facility:15kVDE,OpenVMS Development Environment Explanation:8Thismessagedisplaysthecontentsofan8^internalbitmaskduringprogram execution.UserAction::ContactVDEsupportfor assistance,astheARversionofVDEinusecontains debuggingimages.  $O DBGWAYPT,,debugwaypointwaypointreachedk Facility:15kVDE,OpenVMS Development Environment Explanation:9Thismessagedisplaysa waypoint,andtheD^ associatedwaypointvalue, encounteredduringprogram execution.RUserAction::RContactVDEsupportfor assistance,astheAversionofVDEinusecontains debuggingimages.  ODBGXLAC,-debugEwaypointreached;text: textk Facility:15kVDE,OpenVMS Development Environment Explanation:9Thismessagedisplaysa waypoint,andtheD^ associatedwaypointvalue, encounteredduringprogram execution.RUserAction::RContactVDEsupportfor assistance,astheAversionofVDEinusecontains debuggingimages.  ODBGXLXL,-debugEwaypointreached;value:Uvaluek Facility:15kVDE,OpenVMS Development Environment Explanation:9Thismessagedisplaysa waypoint,andtheD^ associatedwaypointvalue, encounteredduringprogram execution.RUserAction::RContactVDEsupportfor assistance,astheAversionofVDEinusecontains debuggingimages.  l?O DCLBUFOVFL,-DCLcommandlinebeing generatedis (toolongforbuffer Facility:15VDE,OpenVMS Development Environment^ Explanation:1^Somecommandwhich generatesaDCLGcommandfiletoperformpartofitsactions generatedMaDCLcommandlinethatistoolongforitsbuffer;thisMhnormallymeansthatthelineis excessivelylongsincethe4buffersizeisamplefornormaluse.\UserAction:7\Changethecommandline specificationinthescriptforit.< u>O DCLERROR,,errorstatusreturnedbyspawnedDCL (DCL(command Facility:15VDE,OpenVMS Development Environment^ Explanation:/^VDEhasrunaDCLcommandinaDspawned subprocessandthatcommandhasreturnedanHerrorstatus.*The command'sstatusis displayedbythe"h followingstatusline.UserAction:2 Determinethecauseoftheproblem,6\correctit,andretrytheVDEcommand.c u9\mandifyoudonotwishtoseethemessage.w ! uM O DIRCREATED,- directoryU directoryhasbeencreatedk Facility:15kVDE,OpenVMS Development Environment Explanation:7Thismessageinformsyouthattheindi-L^cated directoryhasjustbeencreatedasyourVDEscratch directory.RUserAction:6RCheckthenewlycreated directoryspec-L ificationanddeletethe directoryifyoudonotwishtoFkeepit.+TochangethedefaultVDEscratch directory.\specification,define VDE$SCRATCH. |+ODIRDEL,- directory specificationspecPdeletedfrom(database Facility:15VDE,OpenVMS Development Environment^ Explanation:7^Thismessageinformsyouthattheindi-Kcatedstreamrootorfacilityroot directory specificationFhasbeendeletedfromtheVDE database.*ThismessageIhisonlyissuedwhenyouusethe/LOG qualifieronthe%CANCEL DIRECTORYcommand.\UserAction:5\Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage.k kA9O DIREXPBAD,- directoryfilename expansionbadk Facility:15kVDE,OpenVMS Development Environment Explanation:2internalstate informationforVDE$_^ INVDIRSPECerror.UserAction:-Correct the cause of the VDE$_R INVDIRSPECerror.n kD mandifyoudonotwishtoseethemessage. ! =ODIRNOTFOUSCRP,, directorylocationnotfoundby(scriptfunctionB(function Facility:15VDE,OpenVMS Development Environment^ Explanation:8^Thecurrentscripthasinvokedtheindi-Gcatedscriptfunction(suchas$DIRor $FACROOT),butJthe directorylocation specifiedwiththatfunctioninvo-JhcationisnotfoundintheVDE database.'ThismaymeanOthatthe directorytreeforthe specifiedstreamorfacilityNhasnotbeencreated,orthatthefunction invocationspec-Mrifiesa directorysymbolthatisnotusedforthatstreamand facility.eUserAction::eCreatethe directorytreeforthefacilityIorstream,orcorrectthe directorysymbolnameintheJfunctioncall.'Thenreissuethecommandthatinvokestheoscript.I 9>O DIRSPECREQ,, directory specificationrequiredfor(stream(stream Facility:15VDE,OpenVMS Development Environment^ Explanation::^Aroot directory specificationforthein-@dicatedstreamisrequiredontheCREATESTREAMEcommandbutwasnot specified.-YouneedtousetheGh /DIRECTORY qualifiertospecifytheroot directoryforKthestream,oryouneedtoenterthat directoryspecifi-Jcationwhenpromptedforit.)Thismessageisonlygiven>rifanearlierSETDIRECTORY/PROMPTcommandhas? specifiedthattheCREATESTREAMcommandshouldI#promptforthe directory specificationifthe /DIRECTORY!{ qualifierismissing.UserAction:6Entera directory specificationfortheLostreamroot directorywhenpromptedforitorreissuethe8CREATESTREAMcommandwiththe /DIRECTORY  qualifier. ?O DIRTOOLONG,, directory specificationistoolong;"(maximumlengthis255 Facility:15VDE,OpenVMS Development Environment^ Explanation:5^A directory specificationenteredasaFcommand parameteristoolongbecauseitexceedsthe7maximumlength indicatedinthemessage.UserAction:1Reissuethecommandwithashorter# directoryspecification.k kA9O DIRTREFAI,, directorytree conversionfailedk Facility:15kVDE,OpenVMS Development Environment Explanation:2internalstate informationforVDE$_^ INVDIRSPECerror.UserAction:-Correct the cause of the VDE$_R INVDIRSPECerror.r  uH@O DIRTRENOTDEL,,notallfilesdeletedin directory(tree(tree Facility:15VDE,OpenVMS Development Environment^ Explanation:5^ThismessageinformsyouthatnotallNfilesinthe indicated directorytreeweredeletedforsome6reason,suchas insufficient privileges.UserAction:6UseDCLcommandstocheckthesecurityNonthe remainingfilesinthe directorytree,andtakethe>\ appropriateactiontodeletethemif possible. =O DUPLNAME,, duplicatenameinlistnotallowed:(name Facility:15VDE,OpenVMS Development Environment^ Explanation:4^YouhaveenteredthesamenametwiceIinacommalistwheresuch duplicatesarenotallowed.C Possibly,youmayhavemistypedoneofthenames.UserAction:6Correcttheerrorandreissuethecom-)mandwithoutany duplicates.  &BO EDITUNDEF,-youreditoris undefined;editorcannot(beinvoked Facility:15VDE,OpenVMS Development Environment^ Explanation:3^Thecommandyouhaveenteredisat-Rtemptingtoinvokeaneditortoreadoreditafile,butyouKhavenot specifiedwhateditortoinvoke.'Youmustspec-KhifytheeditoryouwantVDEtousebyenteringtheSETEDITORcommand.\UserAction:4\UsetheSETEDITORcommandtodefineItheeditoryouwantVDEtoinvokeforallcommandsto# putyouinaneditor. ?O EDITUPDATE,,defaulteditor definitionupdatedin(theVDEdatabase Facility:15VDE,OpenVMS Development Environment^ Explanation:7^YourdefaulteditorhasbeenupdatedinNtheVDE database.)ThedefaulteditoristheeditorthatisF initiallydefinedeachtimeyoustartaVDEsession.UserAction:5None.*Thisisan informationalmessageonly. [ h"OELENOTFOUNDCMS,,elementGelementnotfoundin(CMSlibrary Facility:15VDE,OpenVMS Development Environment^ Explanation:7^Thismessageinformsyouthattheindi-Jcatedmodule generationdoesnothaveanelementintheCMSlibrary.UserAction:.UsetheVERIFYGENERATION/RECOVERFcommandtoattemptrecoveryofthemissing generationF\orlocatemissingelementfromabackupandmanuallyDinserttheelementand generationsinthe database.n ! DAO ERRASSIGN,-theattempttoacquireanI/Ochannel(forVDEfailed Facility:15VDE,OpenVMS Development Environment^ Explanation:0^AbadstatuswasreturnedfromaB SYS$ASSIGNservicecall.-VDEneedstoacquireI/OKchannelstodoI/O.Inthiscase,VDEfailedtoacquirehsuchachannel.UserAction::Checkyour process'squotas.(Ifthisprob-L\lemcannotberesolvedlocally,pleasecontactVDEsupportfor assistance.2  ! :O ERRCRELNM,,unabletocreatealogicalnamek Facility:15kVDE,OpenVMS Development Environment Explanation:7VDEcreateslogicalnamesforinputand^output redirection.UserAction::Checkyour process'squotas.(Ifthisprob-LRlemcannotberesolvedlocally,pleasecontactVDEsupportfor assistance.  ?O ERRDEASSIGN,,attempttodeassignanI/Ochannel#(acquiredbyVDEfailed Facility:15VDE,OpenVMS Development Environment^ Explanation:3^VDEwantedtodeassignanI/Ochan-Nnelthatwas acquired.(ThiserrornotesthefailureoftheF SYS$DASSGNsystemservice,probablyduetoaninvalidhchannel.UserAction:9PleasecontactVDEsupportfor assistance., DO ERRDIRSPEC,,errorin directoryorfile specification( file-name Facility:15VDE,OpenVMS Development Environment^ Explanation:7^ThereisasyntaxerrororothererrorKinthe indicated directoryorfilespecification.)TheRMSImessagethatfollowsexplainstheerrorinmoredetail.UserAction:;Correcttheerrorinthe directoryorfile4 specificationandreissuethecommand.P  &5OERRFAO,,unabletoformatoutputstringk Facility:15kVDE,OpenVMS Development Environment Explanation:5Anerrorwasreturnedfromacallto^SYS$FAO.UserAction:9PleasecontactVDEsupportfor assistance.J   )OERRQIOW,,errorfromSYS$QIOWp Facility:15pVDE,OpenVMS Development Environment  Explanation:: Abadstatuswasreturnedfromacalltod SYS$QIOW.UserAction:9PleasecontactVDEsupportfor assistance. {BOERRSMG,,errorreturnedfromacalltotheScreen%( ManagementFacility(SMG) Facility:15VDE,OpenVMS Development Environment^ Explanation::^AbadstatuswasreturnedfromacalltoKaSMGroutine.)Thiscouldbearesultofanynumberof@thingswhichmayormaynotbeaVDEproblem.UserAction:5CheckthesetupoftheterminalwhichJmightcauseSMGsomeproblem.(IftheerrorstillcannotJ\be explainedor resolved,pleasecontactVDEsupportfor assistance.   *O ERRWRIFIL,,errorwritingfileD file-namek Facility:15kVDE,OpenVMS Development Environment Explanation:7Theoutputcouldnotbewrittentothe^ appropriatefile.UserAction:6 Determineifthereisanyexternalin-KR terferencewithRMSwritingtothe specifiedfile.*IfnoK interferencecanbefound,pleasecontactVDEsupportfor assistance. /LOG qualifierontheCREATEFACILITYcommand.UserAction:5Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage.i r  HOFACDEL,,facilityfacility&?deletedfromthedatabasek Facility:15kVDE,OpenVMS Development Environment Explanation:7Thismessageinformsyouthatthedefi-N^nitionforthe indicatedfacilityhasbeendeletedfromtheIVDE database.'ThismessageisonlyissuedwhenyouuseCthe/LOG qualifierontheDELETEFACILITYcommand.UserAction:5Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage. ! nO FACEXISTS,,facilityfacility'alreadyexistsindatabasek Facility:15kVDE,OpenVMS Development Environment Explanation:8The indicatedfacilitynamewas specifiedF^onaCREATEFACILITYcommand,butanentryforthatLfacilityisalreadypresentinthe database.)Alternatively,Kthe indicatednamewas specifiedasthenewnameforanDhexistingfacilityusingtheMODIFYFACILITYcommand,Jbutanotherfacilityalreadyhasthe requestednewname.MIneithercase,thecommandfailsandthefacilityisnot rcreatedor modified. UserAction:7 Ifyouenteredthewrongfacilityname,Hereenterthecommandwiththecorrectname.(Ifyouen-Fteredtherightfacilityname,usetheSHOWFACILITYJcommandtodisplaythedatabase informationforthatfa-Nocility.)Ifyouarenot satisfiedwiththat information,use9theMODIFYFACILITYcommandtochangeit. ! u\-OFACMOD,, informationforfacilityfacilitymodifiedin(thedatabase Facility:15VDE,OpenVMS Development Environment^ Explanation:5^Thismessageinformsyouthatinforma-Ktionforthe indicatedfacilityhasbeenmodifiedintheIVDE database.'ThismessageisonlyissuedwhenyouuseChthe/LOG qualifierontheMODIFYFACILITYcommand.UserAction:5Usethe/NOLOG qualifierforthecom->\mandifyoudonotwishtoseethemessage.j ! u@O FACNOTDEL,-facilityfacilitynotdeletedk Facility:15kVDE,OpenVMS Development Environment Explanation:=Youare attemptingtodeleteafacilitythatH^cannotbedeleted.) Additionalmessagesarenormallyin-Fcludedwiththismessage,andthesemessagesindicate2whythefacilitycannotbedeleted.UserAction:;Resolvethe problem(s)flaggedbytheother?error messages,andreentertheDELETEFACILITY\command.\ u2 O FACNOTFOUND,,facility[facilitynot foundin'( database; parameterignored Facility:15VDE,OpenVMS Development Environment^ Explanation:6^The indicatedfacilitynamewasenteredBonaSHOWFACILITYcommand,butnosuchfacility-wasfoundintheVDE database.UserAction:;Thisisnot necessarilyanerror;themes-Msagesimplytellsyouthatthe indicatedfacilitydoesnot#\existinthe database.u K0O FACNOTMT,,facilitycontainsmodulesk Facility:15kVDE,OpenVMS Development Environment Explanation:6The specifiedfacilitycontainsmodules.UserAction:8The requested operationis prohibiteddue<tothepresenceofmodulesinthe facility.  6O FACSYNTAX,-invalidfacilitynamesyntax:0namek Facility:15kVDE,OpenVMS Development Environment Explanation:4Thenameorformat specifiedforthe8^facilitynameisnotusingvalidsyntax.UserAction:5 RespecifythefacilitynameusingonlyFR alphanumeric, underscore,dollarsignandhyphenchar-acters.0  uBOFAMILY,-unableto deallocate:*siblingsorchildren(present Facility:15VDE,OpenVMS Development Environment^ Explanation:0^ SomethingdeepwithinVDEhasat-Ntemptedto deallocateadata structurethathassiblingsor children.UserAction:9PleasecontactVDEsupportfor assistance.FPleaseincludeany informationthatmaybeusefulor2\releventin duplicatingtheproblem.  0OFCBERR,,internalVDEFCBerrorin1 VDE-internal-( identifier Facility:15VDE,OpenVMS Development Environment^ Explanation:5^VDEhasdetectedaninternal inconsis-tency.RUserAction:9RPleasecontactVDEsupportfor assistance.FPleaseincludeany informationthatmaybeusefulor2releventin duplicatingtheproblem.  %O FCBWRONG,-internalerror;access accessfailedin!(VDE-internal-identifier Facility:15VDE,OpenVMS Development Environment^ Explanation:5^VDEhasdetectedaninternal inconsis-tency.RUserAction:9RPleasecontactVDEsupportfor assistance.FPleaseincludeany informationthatmaybeusefulor2releventin duplicatingtheproblem.b  8OFETCHED,, generation generation fetchedfromlibraryk Facility:15kVDE,OpenVMS Development Environment Explanation:7Thismessageinformsyouthattheindi-G^catedmoduleand generationhasbeenfetchedfromtheGcurrentlibrary.*Thismessageisonlyissuedwhenyou=usethe/LOG qualifierontheFETCHcommand.UserAction:5Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage., ! &O FILCOPLIB,-filefilecopiedtolibraryk Facility:15kVDE,OpenVMS Development Environment Explanation:5Thismessageinformsyouthatthein-L^dicatedfilehasbeencopiedintotheVDElibrarybytheHREPLACEcommand.'Whenthisisdone,thefilehasbeenKincludedinthe appropriateCMSelement,buthasnotyetJhbeenrecordedintheVDE database.(ThismessageisonlyHissuedwhenyouusethe/LOG qualifierontheREPLACE3commandforan immediate replacement.UserAction:5Usethe/NOLOG qualifierforthecom-> mandifyoudonotwishtoseethemessage.  u`O FILCOPSTAG,,file[file#copiedtostagingareak Facility:15kVDE,OpenVMS Development Environment Explanation:7Thismessageinformsyouthattheindi-N^catedfilehasbeencopiedintoaVDEstagingareabytheBREPLACEcommand.(ThismessageisonlyissuedwhenCyouusethe/LOG qualifierontheREPLACEcommand&hforaqueued replacement.UserAction:5Usethe/NOLOG qualifierforthecom->\mandifyoudonotwishtoseethemessage. *O FILENOTFOUND,,filenotfound:filek Facility:15kVDE,OpenVMS Development Environment Explanation:7The indicatedfilewas requestedthroughC^aVDEcommand,butcouldnotbefound.,HencetheDcurrentcommandcannotperformthe requestedaction.RUserAction:9RDowithoutthefileor determinewhythe8fileismissingandcorrecttheproblem.  km*OFILQUE,,printfilequeuedto  queue-namek Facility:15kVDE,OpenVMS Development Environment Explanation:8Thisthismessageinformstheuserwhere0^thefilewasqueuedfor printing.UserAction:;Ensurethatthefileisplacedontheap-R propriatequeue. -O FILREADERR,,unabletoreadfilefilek Facility:15kVDE,OpenVMS Development Environment Explanation:5AnerroroccurredwhentryingtoreadM^alineoftextfromaninputfile.+Amorespecificerror*messagefollowsthismessage.RUserAction:5RExaminetheerrormessagethatfollowsItodiagnosethereasonfortheerror.+Thencorrecttheproblem accordingly.  .O FILWRITERR,-unabletowritefilefilek Facility:15kVDE,OpenVMS Development Environment Explanation:6AnerroroccurredwhentryingtowriteL^alineoftexttoanoutputfile.-Amorespecificerror*messagefollowsthismessage.RUserAction:5RExaminetheerrormessagethatfollowsItodiagnosethereasonfortheerror.+Thencorrecttheproblem accordingly.  &"O FIRGENNODEL,, generation generationisfirstgener-1(ationofmodule;cannotbedeleted Facility:15VDE,OpenVMS Development Environment^ Explanation:8^Youaretryingtodeletethefirstgen-?erationofamodulewiththeDELETE GENERATIONDcommand,whichVDEdoesnotallow.+IfyouwanttoJhdeleteall generationsofamodule,youmustdeletethe=entiremodulewiththeDELETEMODULEcommand.\UserAction:5\Ifyoumistypedthe generationnumber,Nreenterit correctly.)Ifyouwanttodeleteall generations> ofthemodule,usetheDELETEMODULEcommand. ! EO FIRNUMMAY,,firstnumberofarangemaynotbeless(than(number Facility:15VDE,OpenVMS Development Environment^ Explanation:4^Someintegersprovidedinthecommand7linemustbegreaterthanagiven"n".RUserAction:9RVerifythatthe appropriate"n"wasgiven!inthecommandline. AO FIRNUMRAN,-firstnumberofarangemustbeless(thanthesecond Facility:15VDE,OpenVMS Development Environment^ Explanation:4^When providingarangeintheformat1n[:m],"n"mustbelessthan"m".RUserAction:8RCorrecttherange descriptionandreissuethecommand.  u{O FLAVORPIDS,-flavorflavor,pid }pid,masterbmpid ,,(parent(ppid Facility:15VDE,OpenVMS Development Environment^ Explanation:4^ThismessagedisplaysvariousinternalDprocess-relatedvaluesusedwithinVDE.ThismessageFshouldappearonlyduringVDEtesting,andshouldbe<h displayedonlyby debuggingversionsofVDE.UserAction::ContactVDEsupportfor assistance,astheB\versionofVDEinusecontains debug-onlyimages. ! ud"O FOLDADDED,,foldrecordrecordformodulemodule(addedtodatabase Facility:15VDE,OpenVMS Development Environment^ Explanation:7^Thismessageinformsyouthattheindi-McatedmodulehashadafoldrecordcreatedinthecurrentIVDE database.'Thismessageisonlyissuedwhenyouuse?hthe/LOG qualifierontheCREATEFOLDcommand.UserAction:5Usethe/NOLOG qualifierforthecom->\mandifyoudonotwishtoseethemessage.  s OFOLDDEL,,foldrecordrecord formodulemodule Dhas(beendeleted Facility:15VDE,OpenVMS Development Environment^ Explanation:5^Thismessageinformsyouthatthein-HdicatedmodulehashadafoldrecorddeletedfromtheBcurrentVDE database./ThismessageisonlyissuedEhwhenyouusethe/LOG qualifierontheDELETEFOLDcommand.\UserAction:5\Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage.  %OFOLDEXP,,foldrecordforfoldJexpectedforstream(stream Facility:15VDE,OpenVMS Development Environment^ Explanation:5^ThismessageinformsyouthatVDEex-Lpectstogenerateafoldrecordforthe indicatedstream.DThefoldrecordwillbe generatedwhenthismoduleIhchangeisapprovedand performedbytheprojectleader-Awhenthequeued replacementis performed.,BecauseFtheremaybeadelaybeforethe replacementisper-FrformedbytheprojectleaderandbecausetheprojectIleadermayrejectthe replacement,thefoldrecordwillA#not immediatelyappearviacommandssuchasSHOWA{ REPLACEMENT.Thefoldwillbe generatedwhenVDEJsendsyouthe notificationthatthe replacementhasbeenE- performed.,ThismessageisonlyissuedwhenyouuseEthe/LOG qualifierontheREPLACEcommand,andonlyDforaqueued replacementfromwhichVDEexpectsto$6generateafoldrecord.UserAction:5Youmay/willneedtoresolvethefoldM*recordthatwill (eventually)be generatedbythisreplace-Hment.'Usethe/NOLOG qualifierforthecommandifyou/donotwishtoseethemessage.!   ~=O FOLDIDREQ,,fold identifierrequiredformodule(module Facility:15VDE,OpenVMS Development Environment^ Explanation:6^YouhavemultiplefoldrecordsfortheK indicatedmodule.'Youmust thereforespecifyafoldiden-Btifierwiththe/IDENTIFICATIONor/FOLD qualifierCh (dependingonthecommand)touniquelyindicatetoBwhichfoldrecordyouwantthecommandtoapply.\User Action:*\Reissue!the command!with theB/IDENTIFICATIONor/FOLD qualifiertoindicatetheH specificfoldrecordtowhichyouwantthecommandtoeapply.  /'O FOLDIDUSED,,fold identifier! identifieralreadyused(formodule(module+(attempttocreatefoldrecordhasfailed Facility:15VDE,OpenVMS Development Environment Explanation:<YouaretryingtocreateafoldrecordforLamoduleusingthesamefold identifierasyouhaveusedHhonapreviousfoldrecordforthesamemoduleintheJsame developmentstream.(Thisisnotallowed,sincefold( identifiersmustbeunique.UserAction:*ReissuetheCREATEFOLDcom-H mandwitha differentfold identifier specifiedontheEe/IDENTIFICATION qualifier.'Alternatively,youcanomitFthe/IDENTIFICATION qualifier,inwhichcaseVDEwill2assignaunique identifierforyou.  /!O FOLDINSTRM,, generation generationkmustbefolded(intostream(stream Facility:15VDE,OpenVMS Development Environment^ Explanation:6^ThismessageinformsyouthatyoumustGmanuallyfoldthe indicatedmodule generationintotheG indicated developmentstreaminorderto propagatetheFhchangesinthat generationintothestream.*VDEcan-Cnot propagatethechanges automaticallybecausetheDmodulehasalreadydivergedbetweenthatstreamandGrits predecessor.+ThismessageisonlyissuedwhenyouBusethe/LOG qualifierontheREPLACEorPERFORM# REPLACEMENTcommand.UserAction:5Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage.  u] OFOLDMOD,,foldrecord*recordFformodule)module (modifiedindatabase Facility:15VDE,OpenVMS Development Environment^ Explanation:9^ThismessageinformsyouthatfoldrecordHforthe indicatedmodulehasbeenmodifiedintheVDEI database.)Thismessageisonlyissuedwhenyouusethe:h/LOG qualifierontheMODIFYFOLDcommand.UserAction:5Usethe/NOLOG qualifierforthecom->\mandifyoudonotwishtoseethemessage. ! uv%O FOLDNOTFOUND,,foldrecordMrecordinotfoundfor(module#(moduleh(andstreamQ(stream Facility:15VDE,OpenVMS Development Environment^ Explanation::^Youhavetriedto referenceafoldrecordFforthe indicatedmoduleinthe indicated development:stream,butthereisnosuchfoldrecord.UserAction:;Thisisnot necessarilyanerror;themes-Osagesimplytellsyouthatthe indicatedmodulehasnofold.\recordsinthe indicatedstream. 'O FROMDIREMPTY,-the directory directory  specified*(with/FROM_DIRECTORYisempty Facility:15VDE,OpenVMS Development Environment^ Explanation:5^Sincethe directory specifiedwiththeB/FROM_DIRECTORY qualifierisempty,nomodulesarecreated.UserAction:None.  &mandifyoudonotwishtoseethemessage.c u9 O GENDELLIB,- generationS generationdeletedfrom(library Facility:15VDE,OpenVMS Development Environment^ Explanation:7^Thismessageinformsyouthattheindi-Jcated generationhasbeendeletedfromthelibrary.(ThisImessageisonlyissuedwhenyouusethe/LOG qualifier/hontheDELETE GENERATIONcommand.UserAction:5Usethe/NOLOG qualifierforthecom->\mandifyoudonotwishtoseethemessage.  } O GENINSERT,- generationc generation%insertedinto(stream(stream Facility:15VDE,OpenVMS Development Environment^ Explanation:5^Thismessageinformsyouthatthein-Hdicated generationhasbeeninsertedintothe indicatedE developmentstream.*ThismessageisonlyissuedwhenEhyouusethe/LOG qualifierontheCREATEMODULEor&INSERT GENERATIONcommand.\UserAction:5\Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage. /OGENMOD,- informationfor generationy generation%(modifiedinthedatabase Facility:15VDE,OpenVMS Development Environment^ Explanation:5^Thismessageinformsyouthatinforma-Ktionforthe indicated generationofthe indicatedmoduleEhasbeenmodifiedintheVDE database.+ThismessageIhisonlyissuedwhenyouusethe/LOG qualifieronthe&MODIFY GENERATIONcommand.\UserAction:5\Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage. ! uO GENNODEL,- generation@ generationcannotbedeletedk Facility:15kVDE,OpenVMS Development Environment Explanation:9Youaretryingtodeletea generationofL^amodulewhichisstill reachablebyatleastonestreamHand/orisnotaleaf generation(someother generationPpointstoitasitsprevious generation).'VDEdoesnotallowGha generationtobedeletedineitherofthesecases.UserAction:9Checkthatyouhave specifiedthecorrect$\ generationfor deletion.2 2 ! ~ O GENNOPRED,- generation generation Cofmodule has(no predecessor Facility:15VDE,OpenVMS Development Environment^ Explanation:3^The generationofthe indicatedmod-GulewiththeshownCMS generation expressiondoesnotFhavea predecessor generation.-Asaresult,thecur-Ehrent operationcannotbe performed.+Forexample,the> DIFFERENCEScommandcannotcompare generation1Dwithits predecessorbecauseithasno predecessor.UserAction:;Specifya generationthathasa predecessorH  (normallyany generationexcept generation1)andrerunethecommand. [ &%OGENNOTCLASSMEM,- generation generationrisnota (memberofCMSclassa(class Facility:15VDE,OpenVMS Development Environment^ Explanation:7^Thismessageinformsyouthattheindi-Hcated generationisnotamemberofthe indicatedCMSEclass.-ThismessageisoutputwhenaVDEstreamisCh maintainingCMSclass membership,butthe indicated? generationisnotamemberofthatCMSclass.\UserAction:.\UsetheVERIFYGENERATION/RECOVERGtoattemptrecoveryoftheclass memebershipforthis stream.{ [ Q%OGENNOTFOUNDCMS,- generation generation not!(foundinCMSlibrary Facility:15VDE,OpenVMS Development Environment^ Explanation:7^Thismessageinformsyouthattheindi-Gcatedmodule generationdoesnothavea generationintheCMSlibrary.UserAction:.UsetheVERIFYGENERATION/RECOVERFcommandtoattemptrecoveryofthemissing generationI\orlocatemissing generationfromabackupandmanually"insertthe generation. ! =OGENNOTINSTAGE,, generationnotfoundinstaging(area(area Facility:15VDE,OpenVMS Development Environment^ Explanation:8^Thismessageinformsyouthatthemodule> generationisnotinthelibrarystagingareaRUserAction::RTrytolocateapreviousmodule generationLbycheckingwithusersthatlasthadthemodule reserved.A  mandifyoudonotwishtoseethemessage.*  )O GENREPLDNF,,staging directory directorynotfoundk Facility:15kVDE,OpenVMS Development Environment Explanation:5ThismessageinformsyouthatreportedH^staging directorydoesnotexist.+Perhapsthe directory<wasdeletedaspartofacleanup operation.RUserAction::RTrytolocateapreviousmodule generationLbycheckingwithusersthatlasthadthemodule reserved.  "O GENRETAINED,, generation generationretainedin(library Facility:15VDE,OpenVMS Development Environment^ Explanation:7^Thismessageinformsyouthattheindi-Kcated generationhasbeenretainedinthelibrarybecauseNitisstill reachablebyatleastonestream.*ThismessageIhisonlyissuedwhenyouusethe/LOG qualifieronthe&DELETE GENERATIONcommand.\UserAction:5\Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage.9 u#O GENSUCVERIFY,, generation  generation successfully(verified Facility:15VDE,OpenVMS Development Environment^ Explanation:7^Thismessageinformsyouthattheindi-Fcatedmodule generationhasa corresponding generationJintheCMSlibraryanditisamemberofalltheCMSHhclassesthatarebeing maintainedforthe correspondingVDEstreams.\UserAction:\None required.   zCOGETJPI,, SYS$GETJPIsystemservicefailed,unableto.attach Facility:15VDE,OpenVMS Development Environmentd Explanation:0dTheATTACHcommandcouldnotcon-Gtinuebecauseafailedservicecallto SYS$GETJPIoc-curred.UserAction:6 Determineifthereisanyexternalin-J terference.)Ifno interferencecanbefound,thenplease%asubmitaproblemreport. &>O GETQUIERR,,getqueue informationsystemservice(errorforqueuea(queue Facility:15VDE,OpenVMS Development Environment^ Explanation:8^Youhave attemptedtostartabuildjobAandtheVMSgetqueue information ($GETQUI)sys-Htemservicereturnedanerrorstatus.)ThemessagethatEhfollowsgivesmore informationtoexplaintheerror.UserAction:=Theactiontotaketocorrecttheerrorde-H\pendsonthenatureoftheerror.,YouoryoursystemHmanagershouldcorrecttheerrorandrestartthebuild job. u[OGRPADD,-modulePmoduleisaddedtogroupvgroupk Facility:15kVDE,OpenVMS Development Environment Explanation:5Thismessageinformsyouthatthein-C^dicatedmodulehasbeenaddedasamemberoftheD indicatedgroup..ThismessageisonlyissuedwhenDyouusethe/LOG qualifierontheCREATEGROUPor!hMODIFYGROUPcommand.UserAction:5Usethe/NOLOG qualifierforthecom->\mandifyoudonotwishtoseethemessage.V ,O GRPADDED,,group{group"oaddedtothedatabasek Facility:15kVDE,OpenVMS Development Environment Explanation:5Thismessageinformsyouthatthein-D^dicatedgroup definitionhasbeenaddedtotheVDEI database.)Thismessageisonlyissuedwhenyouusethe;/LOG qualifierontheCREATEGROUPcommand.UserAction:5Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage. O GRPALRMEM,-modulemodule Wisalreadyamember(ofgroupB(group Facility:15VDE,OpenVMS Development Environment^ Explanation:6^ThismessageinformsyouthatyouhaveG attemptedtoaddthe indicatedmoduleasamemberofJthe indicatedgroup,butthemoduleisalreadyamemberKhofthatgroup.)Thismessageisonlyissuedwhenyouuse@the/LOG qualifierontheMODIFYGROUPcommand.\UserAction:5\Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage.f  <OGRPDEL,-groupgroup&deletedfromthedatabasek Facility:15kVDE,OpenVMS Development Environment Explanation:7Thismessageinformsyouthatthedefi-K^nitionforthe indicatedgrouphasbeendeletedfromtheIVDE database.'Thismessageisonlyissuedwhenyouuse@the/LOG qualifierontheDELETEGROUPcommand.UserAction:5Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage.  O GRPEXISTS,,groupgroup(alreadyexistsin database;(groupnotchanged Facility:15VDE,OpenVMS Development Environment^ Explanation:2^The indicatedgroupnamewasspeci-CfiedonaCREATEGROUPcommand,butanentryforIthatgroupisalreadypresentinthe database.+HenceaMhnewentrywasnotcreatedforthat facility.(Alternatively,Bthe indicatednamewas specifiedasthenewname@foranexistinggroupontheMODIFYGROUPcom-Grmand,butanothergroupalreadyhasthe requestednewKname.'Hencethenameoftheexistinggroupcouldnotbe&#changedtothenewname.UserAction:4Ifyouenteredthewronggroupname,Hreenterthecommandwiththecorrectname.(Ifyouen-@oteredtherightgroupname,usetheSHOWGROUPEcommandtodisplaythedatabase informationforthatM group.(Ifyouarenot satisfiedwiththat information,use6ytheMODIFYGROUPcommandtochangeit.z  uP*OGRPMOD,- informationforgroupgroupmodifiedin(thedatabase Facility:15VDE,OpenVMS Development Environment^ Explanation:5^Thismessageinformsyouthatinforma-Mtionforthe indicatedgrouphasbeenmodifiedintheVDEI database.)Thismessageisonlyissuedwhenyouusethe;h/LOG qualifierontheMODIFYGROUPcommand.UserAction:5Usethe/NOLOG qualifierforthecom->\mandifyoudonotwishtoseethemessage.J u O GRPNOTFOUND,,group;group#0notfoundin database;( parameterignored Facility:15VDE,OpenVMS Development Environment^ Explanation:3^The indicatedgroupnamewasenteredAonaSHOWGROUPcommand,butnosuchgroupwas(foundintheVDE database.UserAction:;Thisisnot necessarilyanerror;themes-Jsagesimplytellsyouthatthe indicatedgroupdoesnot#\existinthe database. O GRPNOTMEM,,modulemodule cisnotamemberof(group(group Facility:15VDE,OpenVMS Development Environment^ Explanation:6^ThismessageinformsyouthatyouhaveItriedtoremovethe indicatedmodulefromthe indicatedHgroup,butthemoduleisnotamemberofthatgroup.DhThismessageisonlyissuedwhenyouusethe/LOG5 qualifierontheMODIFYGROUPcommand.\UserAction:5\Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage.  ZOGRPREM,,moduleXmodule"isremovedfromgroup(group Facility:15VDE,OpenVMS Development Environment^ Explanation:7^Thismessageinformsyouthattheindi-GcatedmodulehasbeenremovedfrombeingamemberofLthe indicatedbuildset.(Thismessageisonlyissuedwhen@hyouusethe/LOG qualifierontheMODIFYGROUPcommand.\UserAction:5\Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage.  3O GRPSYNTAX,,invalidgroupnamesyntax:namek Facility:15kVDE,OpenVMS Development Environment Explanation:4Thenameorformat specifiedforthe5^groupnameisnotusingvalidsyntax.UserAction:2 RespecifythegroupnameusingonlyFR alphanumeric, underscore,dollarsignandhyphenchar-acters.q   kOHELLO,-Motif vdeversiondstartingupk Facility:15kVDE,OpenVMS Development Environment Explanation::Thismessagedisplaystheversion identifi-M^cationoftheVDEMotif interfaceinuse.'ThismessageisE displayed automaticallyduringtheVDEMotifstartup.RUserAction:RNone.  ! :O ICIBOGUS,- intermediate conference information(invalid Facility:15VDE,OpenVMS Development Environment^ Explanation:7^Thismessageis displayedin conjunctionHwithothererror messages,and indicatesthe particular"failurethat occurred.UserAction:>Resolvethebasicerror.'IfunabletoresolveFtheerror,pleasecontactVDEsupportfor assistance.  ! >OICIGONE,, intermediate conference informationnot(found Facility:15VDE,OpenVMS Development Environment^ Explanation:7^Thismessageis displayedin conjunctionHwithothererror messages,and indicatesthe particular"failurethat occurred.UserAction:>Resolvethebasicerror.'IfunabletoresolveFtheerror,pleasecontactVDEsupportfor assistance. ! @O ICIPARSE,-parseof intermediate conferenceinfor-(mationfailed Facility:15VDE,OpenVMS Development Environment^ Explanation:7^Thismessageis displayedin conjunctionHwithothererror messages,and indicatesthe particular"failurethat occurred.UserAction:>Resolvethebasicerror.'IfunabletoresolveFtheerror,pleasecontactVDEsupportfor assistance.}  /S;O ILLDEPFUN,-Illegal dependencyfunctionpassed7(tomoduleVDE$REC_DEPENDENCY.Theillegal) dependencyfunctionvalueisvalue Facility:15VDE,OpenVMS Development Environment Explanation:0Anillegal dependencyfunctionwasBpassedtothe dependency recordingmoduleVDE$REC_>h DEPENDENCY.Valid dependency recording functions4aredefinedinthemodule VDELIB.REQ.\UserAction:+\Checkthe dependency recordingBfunctionthatwaspassedonthecalltoVDE$REC_F  DEPENDENCY.Ifthatisok,checkthevaluesassignedAetotheVDE$K_DEPEND_xxxx dependency recordinglit-Deralsin VDELIB.REQ.Someonemayhaveassignedthem incorrectvalues. k[5O ILLFORUSE,- ill-formeduserdefinednamek Facility:15kVDE,OpenVMS Development Environment Explanation:+IntheDEFINE/COMMANDcommand,9^theprovided user-definednameisillegal.UserAction:3ReissuethecommandwiththecorrectRuserdefinedname. ! ~AO INCNOTVAL,,INPUTnotvalidonstreamsmarkedfor(queued replacement Facility:15VDE,OpenVMS Development Environment^ Explanation:9^The specifiedordefaultstreamismarked>forqueued replacements,andtheCREATEMODULEF/INPUTcommandcannotbe processedasitattemptstoLhdirectlycreatethe module(s)withoutregardtothereviewBand replacementpolicy associatedwiththestream.\UserAction:/\PerformaCREATEMODULEsanstheB/INPUT qualifier,andthenuseaREPLACEcommand.J [This restrictionmayberelaxedinafuturereleaseofeVDE.]  9%O INMODNOTFOU,-inputmodulevmoduleofbuildstep,(notfoundin database;ignored Facility:15VDE,OpenVMS Development Environment^ Explanation:3^The automatically collected dependencyK informationforthecurrentbuildstep specifiesthattheI indicatedmoduleisaninputtothestep.+However,theJhmoduleisnotfoundintheVDE database;itisneitherN specifiedasasourcemodulenorasanoutputofanypre-Jviousstep.*This indicatesthattheVDEdatabaseisnotLr consistentwiththeactualcontentsofthefacilitysubdi-Hrectoryinwhichthecompilerorother processorfound#themodule.UserAction:5 DeterminewhetherthemoduleshouldbeOintheVDElibrary.(Ifitshouldbethere,createthemod-BoulewiththeCREATEMODULEcommand.(IfitshouldLnotbethere,deleteitfromthefacility subdirectoryin@ whichthecompilerorother processorfoundit.\ u2$O INPNOTNAME,-inputstringtext isnot syntactically(valid Facility:15VDE,OpenVMS Development Environment^ Explanation::^AninputstringenteredinresponsetoanI interactivequeryforthenameofsomeentity(suchasIalibrary,module,orgroup)doesnothavethecorrect=h syntacticformforthatkindofentityname.UserAction:4Reentera correctly specifiednamein#\responsetothequery.( 9O INPTOOLONG,,inputstringtoolong; maximum(lengthisH(number( characters Facility:15VDE,OpenVMS Development Environment^ Explanation::^AninputstringenteredinresponsetoanJ interactivequeryfor informationistoolongbecauseitEexceedsthemaximumlength indicatedinthemessage.UserAction::Reenterashorterinputstringinresponsetothequery.; u;O INPTOOSHORT,,inputstringtooshort;minimum(lengthisH(number( characters Facility:15VDE,OpenVMS Development Environment^ Explanation:6^AninputstringenteredinresponsetoKan interactivequeryfor informationistooshortbecauseHitdoesnotreachtheminimumlength indicatedinthehmessage.UserAction:9Reenteralongerinputstringinresponse\tothequery.  +OINTERR,,internalVDEerrorinw VDE-internal-( identifier Facility:15VDE,OpenVMS Development Environment^ Explanation:5^VDEhasdetectedaninternal inconsis-tency.RUserAction:9RPleasecontactVDEsupportfor assistance.FPleaseincludeany informationthatmaybeusefulor2releventin duplicatingtheproblem.   .O INTERR_AZ,-internalVDEerrorin VDE-internal-( identifier Facility:15VDE,OpenVMS Development Environment^ Explanation:5^VDEhasdetectedaninternal inconsis-tency.RUserAction:9RPleasecontactVDEsupportfor assistance.FPleaseincludeany informationthatmaybeusefulor2releventin duplicatingtheproblem.  8O INTFUNCERR,,internalscriptfunctionerrork Facility:15kVDE,OpenVMS Development Environment Explanation:7Thescriptfunction encounteredanerror<^duringtheparsing,andcannotbe processed.UserAction:9PleasecontactVDEsupportfor assistance.FRPleaseincludeany informationthatmaybeusefulor2releventin duplicatingtheproblem.  6O INTMEMERR,-internal memory-poolerrorathex-2(virtual-addressVDE-internal-identifier Facility:15VDE,OpenVMS Development Environment^ Explanation:8^VDEhasdetectedan inconsistencyinits!internalmemorypool.RUserAction:9RPleasecontactVDEsupportfor assistance.FPleaseincludeany informationthatmaybeusefulor2releventin duplicatingtheproblem. ! )O INTTOOBIG,,integertoolargek Facility:15kVDE,OpenVMS Development Environment Explanation:6Integervaluesenteredfromthecommand-^linemustfitintoa longword.UserAction:= Determineifitis necessarytoprovidesuchSRalargenumber.&Ifitis necessary,thenthisisa restrictionofVDE.  O INVALANS,Qanswer!isaninvalidanswerk Facility:15kVDE,OpenVMS Development Environment Explanation:9Theresponsetoa confirmationmessageisK^invalid;onlythewordYESorthewordNOoranabbre-Pviationofoneofthosetwowordsisallowedasa response.C ConfirmationmessagesonlyappearwhenyouusetheBh/CONFIRM qualifieronacommandthatacceptsthis qualifier.\UserAction::\ReentereitherYESorNO(orYorN)in3responsetothe confirmationmessage.S  )7O INVDATLNM,,invalidVDE$DATE_TIME;useDD-'.MMM-YYYY:HH:MM:SS.CCformat:.time Facility:15VDE,OpenVMS Development Environmentd Explanation:7dTheformatofa date-timevalueenteredKasalogicalnameisinvalid.(ThismessageshouldappearJonlyduringVDEtesting,andisonly displayedbydebugKmversionsofVDE,andthelogicalnameisonly translatedbydebug versions.aUserAction::aContactVDEsupportfor assistance,astheKversionofVDEinusecontains debug-onlyimages.(IftheLlogicalnameisbeing specified,correcttheerrorintheFk date-timelogicalnamevalueandreissuethecommand. 7O INVDATTIM,-invalid date-time; useDD-MMM-#(YYYY:HH:MM:SS.CCformat:u(time Facility:15VDE,OpenVMS Development Environment^ Explanation:7^Theformatofa date-timevalueentered1asacommand parameterisinvalid.RUserAction:8RCorrecttheerrorinthe date-timevalue%andreissuethecommand.E  AO INVDBFORM,,invaliddatabaseformat;VDEisunable(toaccesslibrary Facility:15VDE,OpenVMS Development Environment^ Explanation:2^TheVDEdatabasedoesnothavetheIproperformat.'ThedatabaseheaderrecordcouldbereadK successfully,butthatrecorddoesnotcontaintheproperKhsentinelvalueoritsdatabaseversionvalue indicatesanI out-of-dateorinvaliddatabaseformat.(ThiserrorcouldGindicatethatthedatabasehasbeen corruptedinsome>rwayorthatVDEhas generatedit incorrectly. UserAction:; TrytoconnecttothedatabaseagainusingFetheSETLIBRARYcommand.(Ifthatdoesnotwork,youKmayhavetorecreatethelibrary(andthusthe database)AfromscratchwiththeCREATELIBRARYcommand.(IfKothatstilldoesnotwork,pleasecontactVDEsupportfor assistance. ! /O INVDIGDEC,,invaliddecimalnumber:numberk Facility:15kVDE,OpenVMS Development Environment Explanation::AdecimaldigitisoftenexpectedinmanyN^contextssuchasa parameter.'Iftheprovidedinputisnot?adigit,thiserrormessagewillbe generated.RUserAction:7RReissuethecommandwiththe appropriatenumber. 9O INVDIRSPEC,-invalid directoryspecification:textk Facility:15kVDE,OpenVMS Development Environment Explanation:7A directory specificationonaVDEcom-I^mandisnot syntacticallycorrect.*ThismessageisalsoFprintedifalogicalname(suchas VDE$LIBRARY)thatOissupposedtobeboundtoa directory specificationisnotIhboundtoa syntacticallycorrect directoryspecification.UserAction:4ReentertheVDEcommandwithavalidJ\ directory specificationordefinethelogicalnametobe8boundtoavalid directoryspecification. rinvalidinput,thecurrentcommandisaborted. UserAction:6 Reissuethecommandwithcorrectquali-Kefiersand parametersorwithcorrectinputto interactive-queriesforcommand information.} SAO INVINTVAL,,invalidintegervalueoncommandline:(integer Facility:15VDE,OpenVMS Development Environment^ Explanation:6^The indicatedintegervaluewasenteredLonthecurrentcommandlinebutitsvalueisnotintheKvalidrangeforthatkindofvalue.+Forexample,iftheLhnumberofsecondsina delta-timeintervalisexceeds59,/youwillgetthiserrormessage.\UserAction:8\Reissuethecommandwithavalidintegervalue.> u8O INVIPMTNAM,,invalidIPMT/CLDnumbersyntaxk Facility:15kVDE,OpenVMS Development Environment Explanation:5TheformatfortheCLDnumberisnot^valid.UserAction:6 RespecifytheCLDnumberintheformat=R ABC-12345, ABC-123456, ABC.12345or ABC.123456.GIftheIPMT/CLDnumberisnotinthisformat,orifIthisformatisnotacceptedbyVDE,pleasecontactVDE#\supportfor assistance.} kS5O INVKEYNAM,,invalidormissingkeynamek Facility:15kVDE,OpenVMS Development Environment Explanation:7Thenameofakeyonthekeyboardwas&^expectedinthiscommand.UserAction:5Reissuethecommandwithan acceptableRnameofakey. 5O INVNUMRNG,,numbernotvalid;numberisgnumber ,(validrangeis(number V(to(number Facility:15VDE,OpenVMS Development Environment^ Explanation:8^AnumericinputvalueisnotwithinitsLvalidrange.'Thevalidrangeis indicatedinthemessage.RUserAction:6RReenterthenumberwithavaluewithinthevalidrange.Z 0/O INVNUMSTG,,invalidnumericstring:fstringk Facility:15kVDE,OpenVMS Development Environment Explanation::Anumericinputvalueisnot syntactically^valid.UserAction:6Reenterthenumberwithcorrectsyntax. BOINVPAGE,,invalidscreenheight,valuemustbebe-(tween(minimum_height (andg(maximum_height Facility:15VDE,OpenVMS Development Environment^ Explanation:0^FortheSETTERMINALcommand,theG/PAGE qualifiermustprovideapagelengthbetween11!and100, inclusively.UserAction:.ReissuetheSETTERMINALcommand+withan acceptablepagesize.Y  u/3O INVPARAM,,invalid parameterpassedtoroutine-(name-plus-info Facility:15VDE,OpenVMS Development Environment^ Explanation:5^VDEhasdetectedininternal inconsis-Ltency,namelythatanillegalvaluehasbeenpassedasa/ parametertoaninternalroutine.UserAction:9PleasecontactVDEsupportfor assistance.FPleaseincludeany informationthatmaybeusefulor2\releventin duplicatingtheproblem.  9O INVQARDB,-invalidQARdatabasenamesyntaxk Facility:15kVDE,OpenVMS Development Environment Explanation:8TheformatfortheQARdatabasenameis^notvalid.UserAction:4 RespecifytheQARdatabasenameusingDRonly alphanumeric, underscore,dollarsignorhyphen characters.u kK8O INVQARNO,,invalidQARentrynumbersyntaxk Facility:15kVDE,OpenVMS Development Environment Explanation:6TheformatoftheQARentrynumberis^notvalid.UserAction:3 RespecifytheQARentrynumberusing$Ronlynumeric characters. 4O INVRANGE,-novaluesininvertedrangenumber #to(number Facility:15VDE,OpenVMS Development Environment^ Explanation:;^Thevalues specifiedforthe/IDENTIFICATION7 qualifier on the DELETE, MODIFY or SHOW= REPLACEMENTcommandareinreverseorderand,Mh therefore,donot representanyvalue.'Forthisreason,noE replacemententriesarefoundmatchingthis criteria.\UserAction:5\Reenterthecommand specifyingavalidDrangeof replacementidnumbersin ascendingorder.  tBO INVSOURCE,,Invalidsourceof information specified:(code Facility:15VDE,OpenVMS Development Environment^ Explanation:5^Thesourceofinformation-typicallythe/SCT,FOLDorOTHER-isnotvalid.RUserAction:8RReenteravalidsourceof informationonthischange.m  =O INVWIDTH,,invalidscreenwidth,valuemustbe(betweenH( minimum_width (and( maximum_width Facility:15VDE,OpenVMS Development Environment^ Explanation:0^FortheSETTERMINALcommand,theG/WIDTH qualifiercanprovideapagelengthbetween40!and255, inclusively.UserAction:.ReissuetheSETTERMINALcommand&withan acceptablewidth. O JOURDISA,,database journallingdisabledforVDE(library Facility:15VDE,OpenVMS Development Environment^ Explanation:3^Thismessageinformsyouthatafter-Jimage journallinghasbeendisabled(turnedoff)fortheFVDElibrary..When journallingis disabled,itcanbeGhveryhardtorecoverfromadamagedor corruptedVDE database.\UserAction:\None. & ! OLIBMOD,,library attributesmodifiedindatabasek Facility:15kVDE,OpenVMS Development Environment Explanation:7Thismessageinformsyouthat attributesH^forthecurrentlibraryhavebeenmodifiedintheVDEI database.)Thismessageisonlyissuedwhenyouusethe=/LOG qualifierontheMODIFYLIBRARYcommand.UserAction:5Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage., BO LIBNOTSET,-librarynotset;noVDEdatabasefound(in directory( directory Facility:15VDE,OpenVMS Development Environment^ Explanation:4^Youhave attemptedtosetaVDEli-Ibraryby specifyinga directory specificationorlibraryBmnemonic specificationontheSETLIBRARYcommand,Ihbutthe directoryormnemoniceitherdoesnotexistorJdoesnot referenceavalidVDElibrary database.*IfyouFareusingamnemonicforthelibrary,checktomakeDrsureyouhaveenteredavalid mnemonic,thencheck2toseethattheVDE$LIBRARY_DEFAULTS *UlogicalD#namesallincludethe appropriateandmatchingnum-K{bersof translations.*(Ifyouare uncertainhowtocheck#theVDE$LIBRARY_DEFAULTS ~*"logicalnames,consult#-theVDEuser'sguide.)UserAction:0Reenterthecommandwithadirec-I tory specificationthat specifiesavalidroot directoryJyforaVDElibrary,orenteracorrect mnemonic.*IftheJ directoryormnemoniciscorrect,contactthelocalsys-G*tem managementstaffandaskthatthe translationsof#theVDE$LIBRARY_DEFAULTS *logicalname(s)be corrected.- hAOLIBREQ,, specificationoflibrarymnemonicrequiredk Facility:15kVDE,OpenVMS Development Environment Explanation:4 VDE/LOCATIONSisunabletolocatethe=^targetforthelocation translation operation.UserAction:ESpecifythetargetvia VDE/LOCATIONS/MNEMONIC=mnemonic.. #O LIBRESET,,libraryresetk Facility:15kVDE,OpenVMS Development Environment Explanation:.YouhaveresettheVDElibrary.UserAction:#Noactionis required.6/   O LINKFAIL,,linkofTmodule! completedwitherrorsk Facility:15kVDE,OpenVMS Development Environment Explanation:6Thelinkstepforthe indicatedmoduleF^ completedwithoneormoreerrors.,Thelinker'sout-Pput(onyourterminalorinthestep'slogfile)givesmore0detailontheerrorsit detected.UserAction:8Correcttheerrorsandresubmitthelinkorbuildjob.L0 "O LINKSUCC,,linkoftmodule! completed successfullyk Facility:15kVDE,OpenVMS Development Environment Explanation:5Thelinkofthe indicatedmodulecom-^pleted successfully.UserAction:None.`1  u6(O LNKSTEPADDED,-linkstepfordmoduleaddedto(database Facility:15VDE,OpenVMS Development Environment^ Explanation:7^Thismessageinformsyouthattheindi-LcatedlinkstephasbeenaddedtotheVDE database.'ThisImessageisonlyissuedwhenyouusethe/LOG qualifier)hontheCREATESTEPcommand.UserAction:5Usethe/NOLOG qualifierforthecom->\mandifyoudonotwishtoseethemessage.2 &.O LNKSTEPDEL,,linkstepformodule(modulendeleted(fromdatabase Facility:15VDE,OpenVMS Development Environment^ Explanation:6^ThismessageinformsyouthatthelinkJstepforthe indicatedmodulehasbeendeletedfromtheCVDE database.,Thismeansthatallbuild dependencyHh informationforthatbuildstephasbeendeleted.,ThisImessageisonlyissuedwhenyouusethe/LOG qualifier)ontheDELETESTEPcommand.UserAction:5Usethe/NOLOG qualifierforthecom-> mandifyoudonotwishtoseethemessage.3 ! r.O LNKSTEPMOD,,linkstepformodule=modulemodified(indatabase Facility:15VDE,OpenVMS Development Environment^ Explanation:7^Thismessageinformsyouthatbuildde-Kpendency informationforthe indicatedlinkstephasbeenImodifiedintheVDE database.)Thismessageisonlyis-Ehsuedwhenyouusethe/LOG qualifierontheMODIFYSTEPcommand.\UserAction:5\Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage.4 ! 7OLOASTLM,- recommendedfreeASTLMvalueisvaluek Facility:15kVDE,OpenVMS Development Environment Explanation:2TheamountoftheASTLMquotacur-J^rently availableisbelowthe recommendedvalueforVDE.+VDEwillattemptto continue.RUserAction:2RContactyoursystem managementstaffIandrequestthattheprocessquotas associatedwiththeIcurrentusernameberesettothevalues recommendedforD\usewithVDE.Thismessageincludesthe recommended0minimumfreevalueforthequota.G" 5 ! 7OLOBIOLM,- recommendedfreeBIOLMvalueisvaluek Facility:15kVDE,OpenVMS Development Environment Explanation:2TheamountoftheBIOLMquotacur-J^rently availableisbelowthe recommendedvalueforVDE.+VDEwillattemptto continue.RUserAction:2RContactyoursystem managementstaffIandrequestthattheprocessquotas associatedwiththeIcurrentusernameberesettothevalues recommendedforD\usewithVDE.Thismessageincludesthe recommended0minimumfreevalueforthequota.6 ! 7OLOBYTLM,- recommendedfreeBYTLMvalueisvaluek Facility:15kVDE,OpenVMS Development Environment Explanation:2TheamountoftheBYTLMquotacur-J^rently availableisbelowthe recommendedvalueforVDE.+VDEwillattemptto continue.RUserAction:2RContactyoursystem managementstaffIandrequestthattheprocessquotas associatedwiththeIcurrentusernameberesettothevalues recommendedforD\usewithVDE.Thismessageincludesthe recommended0minimumfreevalueforthequota.7  ~7OLOCKED,,librarywriteaccessisdisabledk Facility:15kVDE,OpenVMS Development Environment Explanation:5Thismessageis displayedwhenanat-:^temptismadetowrite-RESERVE,REPLACEor?PERFORMREPLACEamodule,etc-intotoalockedlibrary.UserAction:=Contactthestaff responsibleforthelibraryMto determinewhyaccesstothelibraryis currentlylockedC\out.,Thelibrarymaybe currently undergoingmain-Gtenance operations,orthelibrarymaybea read-onlyI shadowcopyofalibrary.(OnlyauserwiththeMODLIB/e privilegecanunlockthelibrary.8 ! 7OLODIOLM,, recommendedfreeDIOLMvalueisvaluek Facility:15kVDE,OpenVMS Development Environment Explanation:2TheamountoftheDIOLMquotacur-J^rently availableisbelowthe recommendedvalueforVDE.+VDEwillattemptto continue.RUserAction:2RContactyoursystem managementstaffIandrequestthattheprocessquotas associatedwiththeIcurrentusernameberesettothevalues recommendedforD\usewithVDE.Thismessageincludesthe recommended0minimumfreevalueforthequota.9 ! 7OLOENQLM,, recommendedfreeENQLMvalueisvaluek Facility:15kVDE,OpenVMS Development Environment Explanation:2TheamountoftheENQLMquotacur-J^rently availableisbelowthe recommendedvalueforVDE.+VDEwillattemptto continue.RUserAction:2RContactyoursystem managementstaffIandrequestthattheprocessquotas associatedwiththeIcurrentusernameberesettothevalues recommendedforD\usewithVDE.Thismessageincludesthe recommended0minimumfreevalueforthequota.: ! 7OLOFILLM,, recommendedfreeFILLMvalueisvaluek Facility:15kVDE,OpenVMS Development Environment Explanation:2TheamountoftheFILLMquotacur-J^rently availableisbelowthe recommendedvalueforVDE.+VDEwillattemptto continue.RUserAction:2RContactyoursystem managementstaffIandrequestthattheprocessquotas associatedwiththeIcurrentusernameberesettothevalues recommendedforD\usewithVDE.Thismessageincludesthe recommended0minimumfreevalueforthequota.; uV%O LOGNAMUNDEF,,logicalname[logical} undefined;%( operationcannotcomplete Facility:15VDE,OpenVMS Development Environment^ Explanation:5^ThecurrentVDE operationrequirestheP indicatedlogicalnametobedefined,butitisnotdefined.?Asaresult,VDEcannotperformthe operation.UserAction:2ExittheVDEkeptprocesswiththe<EXIT/KEPT_PROCESScommand,definetherequiredD\logicalname,restartVDE,andretrythe operation.< ! 4O LOJTQUOTA,, recommendedfreeJTQUOTAisvaluek Facility:15kVDE,OpenVMS Development Environment Explanation:2TheamountoftheJTQUOTA currentlyG^ availableisbelowthe recommendedvalueforVDE.VDE&willattemptto continue.RUserAction:2RContactyoursystem managementstaffIandrequestthattheprocessquotas associatedwiththeIcurrentusernameberesettothevalues recommendedforD\usewithVDE.Thismessageincludesthe recommended0minimumfreevalueforthequota.= ! &4O LOPGFLQUOTA,, recommendedfree PGFLQUOTA(valueis(value Facility:15VDE,OpenVMS Development Environment^ Explanation:0^Theamountofthe PGFLQUOTAquotaG currently availableisbelowthe recommendedvaluefor1VDE.VDEwillattemptto continue.UserAction:2Contactyoursystem managementstaffIandrequestthattheprocessquotas associatedwiththeI\currentusernameberesettothevalues recommendedforDusewithVDE.Thismessageincludesthe recommended0 minimumfreevalueforthequota.> ! 7OLOPRCLM,, recommendedfreePRCLMvalueisvaluek Facility:15kVDE,OpenVMS Development Environment Explanation:2TheamountofthePRCLMquotacur-J^rently availableisbelowthe recommendedvalueforVDE.+VDEwillattemptto continue.RUserAction:2RContactyoursystem managementstaffIandrequestthattheprocessquotas associatedwiththeIcurrentusernameberesettothevalues recommendedforD\usewithVDE.Thismessageincludesthe recommended0minimumfreevalueforthequota.? /@OLOQUOTA,,oneormoreprocessquotasistoolowk Facility:15kVDE,OpenVMS Development Environment Explanation:7Thecurrently-freevalueofoneormoreE^quotasisbelowthe recommendedvaluesforVDE.VDE&willattemptto continue.RUserAction::RThe determinationofalowquotaisbasedHonthecurrently-freevalueofthequota.*ContactyourEsystem managementstaffandrequestthattheprocessE\quotas associatedwiththecurrentusernameberesetCtoprovidethe recommendedvaluewithVDE.OneorH moremessagesareoutputwiththismessagelistingtheGe particularquotafoundtobelow,andthe recommendedHminimumfreevalueforthequota.)VDEwillattemptto&continuefromthiserror.@ ! 7OLOTQELM,, recommendedfreeTQELMvalueisvaluek Facility:15kVDE,OpenVMS Development Environment Explanation:2TheamountoftheTQELMquotacur-J^rently availableisbelowthe recommendedvalueforVDE.+VDEwillattemptto continue.RUserAction:2RContactyoursystem managementstaffIandrequestthattheprocessquotas associatedwiththeIcurrentusernameberesettothevalues recommendedforD\usewithVDE.Thismessageincludesthe recommended0minimumfreevalueforthequota. A .OMAILERR,,errorfromMAILroutine- routine-namek Facility:15kVDE,OpenVMS Development Environment Explanation:1VDEhas encounteredanerrorwhile5^usingtheVMSMAILcallable interface.UserAction:7AttempttoresolvetheproblembasedonERanyothererrormessagesincludedwiththisoneand1contactVDEsupportfor assistance.sB uI2O MAILSENT,,mailmessagesenttouseruserk Facility:15kVDE,OpenVMS Development Environment Explanation:5ThismessageinformsyouthatVDEhasK^sentamailmessagetothe indicateduser notifyingthatGuserofyouraction.,ThismessageisissuedwhenyouFusethe/LOG qualifieronacommandthatsendsmailhnotifications.UserAction:5Usethe/NOLOG qualifierforthecom->\mandifyoudonotwishtoseethemessage.C k^2O MATQUOMIS,,matchingquoteismissingk Facility:15kVDE,OpenVMS Development Environment Explanation:7Allquotedstringsmustbe delimitedby7^eithertwosingleortwodoublequotes.UserAction:4Reenterthecommandwith appropriatelyRquotedstring.D  >O MAXIDVAL,,maximumallowedIdvalueindatabase( exceeded: (ID Facility:15VDE,OpenVMS Development Environment^ Explanation:5^EachentityintheVDE database,suchGaseachmodule,eachstream,andeachbuildjob,hasKanintegerIdvaluethatuniquely identifiesit.,ThisIdIhvaluemaynotassumeavaluelargerthan2,000,000,000,Ebutthe operationyouhave attemptedtoperformhasJtriedtocreateanentitywithanIdvaluelargerthanGrthismaximum.(The indicatednametellswhichIdvalueGis affected.-Thiserrorshouldneveroccurunlessthe)#databaseis extremelylarge.UserAction:9PleasecontactVDEsupportfor assistance.FMostlikelytheVDEdatabasehasbeendamagedbyanointernalerror.E ! >OMAXPARM,-toomany parameters-reentercommand!(withfewer parameters Facility:15VDE,OpenVMS Development Environment^ Explanation:/^InboththeSHOWKEYandDELETEGKEY commands,theusercannotprovideboth/ALLasa9 qualifierandakeynameasa parameter.UserAction:7Choosebetween/ALLorjustonekeyin<eithertheSHOWKEYorDELETEKEY commands.F &(O MERGEGEN,,merging generation generation U(pthis)into(that Facility:15VDE,OpenVMS Development Environment^ Explanation:6^Thismessageinformsyouthatthecur-=rentFETCHorRESERVEcommandwillmergetheH indicated ``merge'' generationintothe generationbeingLhfetchedorreservedtoproducetheoutputfile.(Thismes-Hsageisonlyissuedwhenyouusethe/MERGEand/LOG' qualifiersonthecommand.UserAction:5Usethe/NOLOG qualifierforthecom-> mandifyoudonotwishtoseethemessage.tG  uJ?O MISCONTSCRP,-missing continuationlineinscriptk Facility:15kVDE,OpenVMS Development Environment Explanation::Thecurrentscript specifiedthatthelastM^lineshouldbe continuedbutnosuch continuationlineex-Tists.(Ahyphen( - )attheendofaline indicatesthatthe&lineshouldbe continued.UserAction:7EitherremovethehyphenattheendofLthelastlineorsupplya continuationline, whicheveris\ appropriate.H >O MISHISPARM,,missinghistory parameterinstring ("(string (" Facility:15VDE,OpenVMS Development Environment^ Explanation:9^Ahistorystringwas specifiedwhichdoesInotcontainahistory parameter.)Ahistory parameteris7requiredaspartofthehistorystring.UserAction:4ReentertheVDEcommandwithavalidhistorystring.I ! 6O MISTYPNAM,,missingtypenameformodulestring ;(typenamerequired Facility:15VDE,OpenVMS Development Environment^ Explanation:8^Amodulenamehasbeen specifiedwithoutLamoduletypeinacontextwherethemoduletypeisre->quired.(Forexample,thecommandCREATEMODULEFhM1is incorrectbecauseamoduletype,asinCREATEBMODULEM1.FOR(whereFORisthemoduletype),isHrequiredforthiscommand.'Thetypenamemustbesep-Iraratedfromthemodulenamebyadot(.)*asshownintheexample.J kO MNEMONIC,,library(mnemonic `)library availablek Facility:15kVDE,OpenVMS Development Environment Explanation:4Thisisan informationalmessage,andN^ indicatesa particularlibraryis available,aswellasthe9mnemomicname associatedwiththelibrary.RUserAction:#RNoactionis required.CK ! umandifyoudonotwishtoseethemessage.& M ! O MODALRINSTEP,,modulemodule isalreadyaninput(tobuildstep Facility:15VDE,OpenVMS Development Environment^ Explanation:7^Thismessageinformsyouthattheindi-Lcatedmoduleisalreadyaninputtothebuildstep.*ThisImessageisonlyissuedwhenyouusethe/LOG qualifierEhontheMODIFYSTEPcommandandspecifyanewinput?modulewhichisalreadyaninputtothestep.\UserAction:5\Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage.N   OMODALROUTSTEP,-modulemodule:isalreadyan#(outputfrombuildstep Facility:15VDE,OpenVMS Development Environment^ Explanation:7^Thismessageinformsyouthattheindi-Icatedmoduleisalreadyanoutputfromthebuildstep.KThismessageisonlyissuedwhenyouusethe/LOGqual-EhifierontheMODIFYSTEPcommandandspecifyanewJoutputmodulewhichisalreadyanoutputfromthestep.\UserAction:5\Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage.4O !  O MODALRQUEREP,,modulemodulealreadyqueued(for replacement( replacement Facility:15VDE,OpenVMS Development Environment^ Explanation:9^Youhavetriedtoreplaceor unreserveaImodulethatalreadybelongstothe indicatedqueuedre-K placement.'A reservationthatalreadybelongstoaqueuedGh replacementcannotbe unreservedorqueuedforanotherG replacement;the reservationremainsuntiltheoriginalJ replacementis performedor cancelled.(Asaresult,yourHrattempttoreplaceor unreservethemodulehasfailed. UserAction:0 IfyouwanttoremovethemoduleDe reservationfromitscurrentqueued replacement,you<mustcancelthat replacementwiththeCANCEL: REPLACEMENTcommand.+Youcanthen unreserveKothemoduleorreplaceitaspartofanother replacement.HP  CO MODALRRES,,module moduleQalready reserved;"( reservationhasfailed Facility:15VDE,OpenVMS Development Environment^ Explanation:8^YouhavetriedtoreserveamodulethatIisalreadyreservedbyanotheruser (possibly yourself).HThat reservationdoesnotallow concurrent reservations,Ihoryouhavenot requesteda concurrent reservation.(TheJ reservationmaybeinthecurrentdefaultstream,orinManancestorstream.)Asaresultofthisprior reservation,?ryourattempttoreservethemodulehasfailed. UserAction:9 WaituntiltheuserwhohasreservedtheKemodulereplacesitinthelibrary.)Thenreserveityour-;self.-YoucanusetheSHOWRESERVATION/FULLAcommandtoseewho currentlyhasthemodulere-Aoserved,andinwhatstreamthemodulewasorig-?inally! reserved.4Alternatively,"you can use!the6 /OVERRIDE=CONCURRENT qualifiertoconcur-Gyrentlyreservethemodule,orthe/QUEUE qualifiertoJqueuearequestfor notificationwhenthemodulebecomes* available.jQ @OMODDEL,,moduleUmodule&deletedfromthedatabasek Facility:15kVDE,OpenVMS Development Environment Explanation:7Thismessageinformsyouthatthedefi-L^nitionforthe indicatedmodulehasbeendeletedfromtheIVDE database.'ThismessageisonlyissuedwhenyouuseAthe/LOG qualifierontheDELETEMODULEcommand.UserAction:5Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage.R ! O MODEXISTS,,modulemodule8alreadyexistsin)( database;modulenotchanged Facility:15VDE,OpenVMS Development Environment^ Explanation:3^The indicatedmodulenamewasspeci-DfiedonaCREATEMODULEcommand,butanentryforJthatmoduleisalreadypresentinthe database.)HenceaKhnewentrywasnotcreatedforthatmodule.'Alternatively,Kthe indicatednamewas specifiedasthenewnameforan=existingmoduleontheMODIFYMODULEcommand,JrbutanothermoduleinthesamefacilityalreadyhastheD requestednewname.,Hencethenameoftheexisting>#modulecouldnotbechangedtothenewname.UserAction:5Ifyouenteredthewrongmodulename,Hreenterthecommandwiththecorrectname.(Ifyouen-Boteredtherightmodulename,usetheSHOWMODULEEcommandtodisplaythedatabase informationforthatN module.'Ifyouarenot satisfiedwiththat information,use7ytheMODIFYMODULEcommandtochangeit.S  iO MODINSTEP,,modulemodule'0isaninputtothebuild(step Facility:15VDE,OpenVMS Development Environment^ Explanation:5^Thismessageinformsyouthatthein-LdicatedmoduleisrecordedasaninputtothebuildstepJbeingdefined.)ThismessageisonlyissuedwhenyouuseAhthe/LOG qualifierontheCREATESTEPorMODIFYSTEPcommand.\UserAction:5\Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage.T ! }O MODLOCKED,-modulemoduleYlockedforreplace-!(mentbyanotheruser Facility:15VDE,OpenVMS Development Environment^ Explanation:8^ThemoduleyouaretryingtoreplaceisJ currentlybeingreplacedbyanotheruserwhoisupdatingKthesame generationasyouwanttoupdate.(Asaresult,-hyour replacementattemptfailed.UserAction:<Waitaminuteortwoandthentrytheop-J\erationagain.)Iftheotheruserdeletedyour concurrentF reservationthroughhisorher replacement,yoursec-P ondattemptwillfailwithamessagetothateffect.(IftheJeotheruser's replacementfailedordidnotconflictwith@yours,yournew replacementattemptcansucceed.U  uY-O MODMODIF,- informationformodulebmodulemodi-!(fiedinthedatabase Facility:15VDE,OpenVMS Development Environment^ Explanation:5^Thismessageinformsyouthatinforma-Itionforthe indicatedmodulehasbeenmodifiedintheIVDE database.'ThismessageisonlyissuedwhenyouuseAhthe/LOG qualifierontheMODIFYMODULEcommand.UserAction:5Usethe/NOLOG qualifierforthecom->\mandifyoudonotwishtoseethemessage.]V ! u3O MODNOTDEL,-modulemoduleTnotdeletedk Facility:15kVDE,OpenVMS Development Environment Explanation:5Youare attemptingtodeleteamoduleI^thatcannotbedeleted.' AdditionalmessagesarenormallyHincludedwiththismessage,andthesemessagesindicate0whythemodulecannotbedeleted.UserAction:;Resolvethe problem(s)flaggedbytheother=error messages,andreentertheDELETEMODULE\command.PW u&O MODNOTFOUND,,modulemodulenotfoundin'( database; parameterignored Facility:15VDE,OpenVMS Development Environment^ Explanation:4^The indicatedmodulenamewasentered>onaSHOWMODULEcommand,butnosuchmodule-wasfoundintheVDE database.UserAction:;Thisisnot necessarilyanerror;themes-Ksagesimplytellsyouthatthe indicatedmoduledoesnot#\existinthe database.X ! &O MODNOTINSTEP,,modulemodule!isnotnowaninput(tobuildstep Facility:15VDE,OpenVMS Development Environment^ Explanation:5^Thismessageinformsyouthatthein-IdicatedmoduleisnotnowrecordedasaninputtotheHbuildstepwhose definitionyouare modifying.(RemovingIhitfromthebuildstepisthus redundant.*ThismessageIisonlyissuedwhenyouusethe/LOG qualifieronthe MODIFYSTEPcommand.UserAction:5Usethe/NOLOG qualifierforthecom-> mandifyoudonotwishtoseethemessage.  Y ! #O MODNOTINSTRM,, generationI generation notin(stream(stream Facility:15VDE,OpenVMS Development Environment^ Explanation:8^ThismessageinformsyouthatanattemptKwasmadetoupdatethe specifiedstreamwithanewgen-Oerationofthe specifiedmodule,butthe specifiedmoduleis=hnotpartofthe specified developmentstream.UserAction:0Usethe /NOPROPAGATE qualifierforG\thecommandorpopulatethe specifiedstreamwiththe? specified generationandtrythecommandagain.Z & OMODNOTOUTSTEP,,modulemoduleDisnotnowan#(outputfrombuildstep Facility:15VDE,OpenVMS Development Environment^ Explanation:7^Thismessageinformsyouthattheindi-JcatedmoduleisnotnowrecordedasanoutputfromtheHbuildstepwhose definitionyouare modifying.(RemovingIhitfromthebuildstepisthus redundant.*ThismessageIisonlyissuedwhenyouusethe/LOG qualifieronthe MODIFYSTEPcommand.UserAction:5Usethe/NOLOG qualifierforthecom-> mandifyoudonotwishtoseethemessage.[ O MODNOTRES,-modulemodule!Yisnot currentlyre-(served Facility:15VDE,OpenVMS Development Environment^ Explanation:7^Youaretryingtoreplacethe indicatedJmodulebutthatmoduleisnot currentlyreservedinthe/currentstream developmentstream.UserAction:7Reservethemodulebeforetryingtore-placeit.\  O MODNOTREV,,modulemodule ^notfoundinreview(list Facility:15VDE,OpenVMS Development Environment^ Explanation::^Youhave specifiedamodulethatdoesnotMexistinthecurrentreviewlist.*Asaresult,youcannot?selectthemodulewiththenameyou specified.UserAction:3ReentertheSELECTcommand specifyingPamodulethatispresentinthereviewlistforthecurrent;\REVIEWcommand.'Usethe DIRECTORY subcommandDto determinewhatmodulesarepresentinthelist.] ! &OMODOBS,,moduleY module-name supercededor(markedobsolete Facility:15VDE,OpenVMS Development Environment^ Explanation:;^Thelatest generationofthe specifiedmod-Kule indicatesthemodulewas supercededbyamorerecent,moduleorwasmarked obsolete.UserAction:8 Determineifthecurrent operationshouldGproceedwithamodulethathasbeen supercededorisJ\markedas obsolete.(Ifthe operationshouldproceed,de-Jtermineifany modificationsareneededtoany module(s)B thatmayhave supercededorreplacedthismodule.^  pO MODOUTSTEP,-module@module#isanoutputfromthe(buildstep Facility:15VDE,OpenVMS Development Environment^ Explanation:7^Thismessageinformsyouthattheindi-McatedmoduleisrecordedasanoutputfromthebuildstepJbeingdefined.)ThismessageisonlyissuedwhenyouuseAhthe/LOG qualifierontheCREATESTEPorMODIFYSTEPcommand.\UserAction:5\Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage._  O MODREMINSTEP,,modulemoduleremovedasan (inputtobuildstep Facility:15VDE,OpenVMS Development Environment^ Explanation:5^Thismessageinformsyouthatthein-KdicatedmoduleisnolongerrecordedasaninputtotheJbuildstepwhose definitionyouare modifying.(Thismes-Jhsageisonlyissuedwhenyouusethe/LOG qualifieron%theMODIFYSTEPcommand.\UserAction:5\Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage.`   OMODREMOUTSTEP,-modulemoduleGremovedasan#(outputfrombuildstep Facility:15VDE,OpenVMS Development Environment^ Explanation:7^Thismessageinformsyouthattheindi-LcatedmoduleisnolongerrecordedasanoutputfromtheJbuildstepwhose definitionyouare modifying.(Thismes-Jhsageisonlyissuedwhenyouusethe/LOG qualifieron%theMODIFYSTEPcommand.\UserAction:5\Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage.:a ! ~=O MUSTREPL,,youmustreplacethenewmoduleto((createitsfirst generation Facility:15VDE,OpenVMS Development Environment^ Explanation:9^Thismessageis displayedwhenyoucreate<anewmodulewiththeCREATEMODULEcommandBandthecommandmarksthemoduleas reserved.,ItFhremindsyouthatyoumustreplacethemodulewithaGREPLACEcommandtocreatethefirst generationoftheGmodule.+Thismessageisonlyissuedwhenyouusethe<r/LOG qualifierontheCREATEMODULEcommand. UserAction:5 Usethe/NOLOG qualifierforthecom->emandifyoudonotwishtoseethemessage.b +O NAMTOOLONG,,nameistoolong:text};maximum(lengthisH(number Facility:15VDE,OpenVMS Development Environment^ Explanation:2^Anameenteredasacommandparam-Ieteristoolongbecauseitexceedsthemaximumlength& indicatedinthemessage.UserAction:1Reissuethecommandwithashortername.c =O NEEDFACILITY,,thisrequestrequiresafacilityk Facility:15kVDE,OpenVMS Development Environment Explanation:4VDEwasunabletoperformthespeci-L^fiedrequestasafacilitywasnotselectednor otherwise specified.RUserAction:<RSelectorspecifya facility,andretrytherequest.d ;O NEEDLIBRARY,-thisrequestrequiresalibraryk Facility:15kVDE,OpenVMS Development Environment Explanation:4VDEwasunabletoperformthespeci-K^fiedrequestasalibrarywasnotselectednor otherwise specified.RUserAction:;RSelectorspecifyalibrary,andretrytherequest.~ e  k[(newmask Facility:15VDE,OpenVMS Development Environment^ Explanation:4^Thismessage indicatesthatthevalueGloadedintheVDE debuggingbitmaskisbeingchanged.DThismessageshouldappearonlyduringVDEtesting.UserAction::ContactVDEsupportfor assistance,astheBversionofVDEinusecontains debug-onlyimages.l ! ~@O NOACCLIB,-noaccesstolibraryallowedforuser(username Facility:15VDE,OpenVMS Development Environment^ Explanation:9^Youarenot authorizedtoaccesstheVDEClibrarythatlogicalname VDE$LIBRARYpointstoorFthatyouaretryingto establishwithaSETLIBRARYhcommand.UserAction:5Correctthe definitionoflogicalnameD\ VDE$LIBRARY,specifythenameofalibraryyouareE authorizedtoaccessontheSETLIBRARYcommand,orL requestthatthe administratorforthedesiredVDElibrary;egiveyoutherighttoaccessthatlibrary.m ?O NOARCHSPEC,-no architecture specifiedforopera-(tion Facility:15VDE,OpenVMS Development Environment^ Explanation:3^Youhaveenteredacommandthatre-Kquiresadefault architecturetoexist,butyouhavenotG establishedadefault architecture.+Usually,thismeansEhthatthecommandyouhaveenteredcontainsamoduleDnamewithanomitted architecturenameandthear-I chitecturecannotbe defaulted.*Asaresult,themodule8rcannotbelookedupinany architecture. UserAction:1 Either establishadefaultarchtec-5eture withtheSET ARCHITECTUREcommand@andreenterthecommand,orreenterthecommandFwithan explicitly specified architecturename,asin"oARCHNAM:[FACNAM]MOD.TYP.n kv>O NOATTACH,,failedtoattachtoprocessPID!XLk Facility:15kVDE,OpenVMS Development Environment Explanation:/TheATTACHcommandhasfailedto.^attachtothe requestedprocess.UserAction:8Verifythatthe requestedprocessexists.2RCheckspellingoftheprocessname.o  j9O NOAUTOCONV,, automatic conversiontocurrent$(databaseformatdisabled Facility:15VDE,OpenVMS Development Environment^ Explanation:2^TheVDEdatabasedoesnothavetheCproperformat,andthe automatic conversionofthe(databasehasbeen disabled.UserAction::IfuseofthenewversionofVDEisin-Ktended,performafulllibrarybackupusingthe database-E\providedbackuptools,andthenusetheVDECONVERT5commandtoupdatethedatabaseformat.p &>O NOBASENOTE,,nobasenotefoundfor replacement(replacement_id Facility:15VDE,OpenVMS Development Environment^ Explanation:7^Thismessageis displayedin conjunctionFwithothererror messages,and indicatestheparticu-Ilarfailurethat occurred.*VDEhas attemptedtofindaMhbasenotewitheitherakeywordoratitle containingthe7 specified replacementIDandhasfailed.\UserAction::\Resolvethebasicerror.*Ifunabletore-Lsolvetheerror,pleasecontacttheprojectleaderorVDE# supportfor assistance.( iq ! ~?8O NOBLDJOB,-nobuildjobsfoundforstream\streamk Facility:15kVDE,OpenVMS Development Environment Explanation:>NobuildjobispresentinthedatabasethatK^belongstothe indicatedstreamandmatchesthe selectionGcriteriayou specifiedontheSHOW BUILD_JOBorotherB BUILD_JOBcommand.)The selectioncriteriayouhaveJh specifiedmayincludethe build-jobidentificationnumber,Kthe build-jobstatus,orboundsonthe build-jobcreationdateandtime.UserAction:;Thisisnot necessarilyanerror;themes-O sagesimplytellsyouthatthenobuildjobexistsforthe;estreamand selectioncriteriayou specified.r ]>O NOBLDSTEPS,,buildjobcontainsnobuildsteps;&(buildjobisnotcreated Facility:15VDE,OpenVMS Development Environment^ Explanation::^YoutriedtocreateabuildjobwiththeHBUILDcommand,butthebuildjobturnsouttocontainRnobuildsteps.)Asaresult,thebuildjobisnotcreatedinKhthe database.*TheusualcauseofthiserroristhatyouG specifiedaminimalbuildofmodulesthatarealready@ up-to-datewithrespecttotheirsourcemodules.UserAction:4IfyouintendedtoperformaminimalJ build,thebuildjobis unnecessary.-IfyouintendedtoKeperformafullbuild,specifythe/FULL qualifierontheBUILDcommand.s ! /@ONOBUILD,-noBUILD privilege;cannotcreatebuild!(jobsinthislibrary Facility:15VDE,OpenVMS Development Environment^ Explanation:8^You attemptedtouseacommandorqual-JifierthatrequiresoneormoreVDE privileges,andyouIdidnothave sufficient privilegesenabled.*ThismessageFhisnormally displayedin conjunctionwithothererror5 messages,usuallya no-privilegeerror.\UserAction:<\Ifyouare authorizedtousethe privilege,EusetheVDESET PRIVILEGEScommandtogiveyourselfI the necessary privilege.*Thentrytheoriginal operationNeagain.)Ifyouarenot authorizedtousethe qualifier,youHshouldeitherrequestthe necessary privilegefromyourLproject administratororyoushouldnotusethe qualifier.t  /CO NOCANRES,-cannotcancel reservationtocreatefirst( generationof (module Facility:15VDE,OpenVMS Development Environment^ Explanation:1^Youhaveenteredan UNRESERVEcom-Nmandtocancelthe reservationthatwillcreatetheinitialH generationofthe indicatedmodule.)The reservationwas;hcreatedbyaCREATEMODULEcommandandVDEBdoesnotallowyoutocancelsucha reservation.\UserAction:5\Ifyounolongerwantthe reservationKthatwillcreatethefirst generationofthemodule,you> mustdeletethemodulewiththeDELETEMODULEDecommand.-Ifyoujustwanttochangethe attributesEofthe reservation,youmustdosowiththeMODIFY RESERVATIONcommand.u q;ONOCAUSE,- replacementcausenotknown;module(notreplaced Facility:15VDE,OpenVMS Development Environment^ Explanation:3^VDEwasnotprovidedwiththecauseDofthe replacementbeing performed.-Thecauseofa?replacement-usuallyaSourceCodeTracking(SCT)7hentryorasourcecodeFold-istracked.UserAction:7Selectthe appropriate replacementcause-E\SourceCodeTracking(SCT),Fold,or Other-usingtheEtogglebuttonsonthemodule replacementdialogbox.v AO NOCLOSEQ,,noclosing quotationmarkforaquoted(string Facility:15VDE,OpenVMS Development Environment^ Explanation:(^FortheDEFINE/COMMANDcom-Dmand,the parameterthat describesthecommandmustAbeenclosedwitheithersingleordoublequotes.UserAction:,ReentertheDEFINE/COMMANDcom-/mandwiththe appropriatequotes.9w ! @O NOCONFNAM,,nonotes conferencename specifiedin(callto( routine-name Facility:15VDE,OpenVMS Development Environment^ Explanation:7^VDEhasdetectedan inconsistencywithinNaninternalroutinewhichusesthenotescallable interface.RUserAction:9RPleasecontactVDEsupportfor assistance.FPleaseincludeany informationthatmaybeusefulor2releventin duplicatingtheproblem.x ! /=O NOCREARCH,,noCREARCH privilege;cannotcreate#(ormodify architectures Facility:15VDE,OpenVMS Development Environment^ Explanation:8^You attemptedtouseacommandorqual-JifierthatrequiresoneormoreVDE privileges,andyouIdidnothave sufficient privilegesenabled.*ThismessageFhisnormally displayedin conjunctionwithothererror5 messages,usuallya no-privilegeerror.\UserAction:<\Ifyouare authorizedtousethe privilege,EusetheVDESET PRIVILEGEScommandtogiveyourselfI the necessary privilege.*Thentrytheoriginal operationNeagain.)Ifyouarenot authorizedtousethe qualifier,youHshouldeitherrequestthe necessary privilegefromyourLproject administratororyoushouldnotusethe qualifier.y ! /?O NOCRECTX,,noCRECTX privilege;cannotcreateor(deletecontexts Facility:15VDE,OpenVMS Development Environment^ Explanation:8^You attemptedtouseacommandorqual-JifierthatrequiresoneormoreVDE privileges,andyouIdidnothave sufficient privilegesenabled.*ThismessageFhisnormally displayedin conjunctionwithothererror5 messages,usuallya no-privilegeerror.\UserAction:<\Ifyouare authorizedtousethe privilege,EusetheVDESET PRIVILEGEScommandtogiveyourselfI the necessary privilege.*Thentrytheoriginal operationNeagain.)Ifyouarenot authorizedtousethe qualifier,youHshouldeitherrequestthe necessary privilegefromyourLproject administratororyoushouldnotusethe qualifier.z ! /?O NOCREFAC,,noCREFAC privilege;cannotcreateor(modify facilities Facility:15VDE,OpenVMS Development Environment^ Explanation:8^You attemptedtouseacommandorqual-JifierthatrequiresoneormoreVDE privileges,andyouIdidnothave sufficient privilegesenabled.*ThismessageFhisnormally displayedin conjunctionwithothererror5 messages,usuallya no-privilegeerror.\UserAction:<\Ifyouare authorizedtousethe privilege,EusetheVDESET PRIVILEGEScommandtogiveyourselfI the necessary privilege.*Thentrytheoriginal operationNeagain.)Ifyouarenot authorizedtousethe qualifier,youHshouldeitherrequestthe necessary privilegefromyourLproject administratororyoushouldnotusethe qualifier.{ ! /?O NOCREGRP,,noCREGRP privilege;cannotcreateor(deletegroups Facility:15VDE,OpenVMS Development Environment^ Explanation:8^You attemptedtouseacommandorqual-JifierthatrequiresoneormoreVDE privileges,andyouIdidnothave sufficient privilegesenabled.*ThismessageFhisnormally displayedin conjunctionwithothererror5 messages,usuallya no-privilegeerror.\UserAction:<\Ifyouare authorizedtousethe privilege,EusetheVDESET PRIVILEGEScommandtogiveyourselfI the necessary privilege.*Thentrytheoriginal operationNeagain.)Ifyouarenot authorizedtousethe qualifier,youHshouldeitherrequestthe necessary privilegefromyourLproject administratororyoushouldnotusethe qualifier.| ! /?O NOCREMOD,,noCREMOD privilege;cannotcreateor(modifymodules Facility:15VDE,OpenVMS Development Environment^ Explanation:8^You attemptedtouseacommandorqual-JifierthatrequiresoneormoreVDE privileges,andyouIdidnothave sufficient privilegesenabled.*ThismessageFhisnormally displayedin conjunctionwithothererror5 messages,usuallya no-privilegeerror.\UserAction:<\Ifyouare authorizedtousethe privilege,EusetheVDESET PRIVILEGEScommandtogiveyourselfI the necessary privilege.*Thentrytheoriginal operationNeagain.)Ifyouarenot authorizedtousethe qualifier,youHshouldeitherrequestthe necessary privilegefromyourLproject administratororyoushouldnotusethe qualifier.* } ! /=O NOCRESCRP,,noCRESCRP privilege;cannotcreate(ordeletescripts Facility:15VDE,OpenVMS Development Environment^ Explanation:8^You attemptedtouseacommandorqual-JifierthatrequiresoneormoreVDE privileges,andyouIdidnothave sufficient privilegesenabled.*ThismessageFhisnormally displayedin conjunctionwithothererror5 messages,usuallya no-privilegeerror.\UserAction:<\Ifyouare authorizedtousethe privilege,EusetheVDESET PRIVILEGEScommandtogiveyourselfI the necessary privilege.*Thentrytheoriginal operationNeagain.)Ifyouarenot authorizedtousethe qualifier,youHshouldeitherrequestthe necessary privilegefromyourLproject administratororyoushouldnotusethe qualifier.~ ! /AO NOCRESTEP,,noCRESTEP privilege;cannotcreateor(deletesteps Facility:15VDE,OpenVMS Development Environment^ Explanation:8^You attemptedtouseacommandorqual-JifierthatrequiresoneormoreVDE privileges,andyouIdidnothave sufficient privilegesenabled.*ThismessageFhisnormally displayedin conjunctionwithothererror5 messages,usuallya no-privilegeerror.\UserAction:<\Ifyouare authorizedtousethe privilege,EusetheVDESET PRIVILEGEScommandtogiveyourselfI the necessary privilege.*Thentrytheoriginal operationNeagain.)Ifyouarenot authorizedtousethe qualifier,youHshouldeitherrequestthe necessary privilegefromyourLproject administratororyoushouldnotusethe qualifier. ! /=O NOCRESTRM,,noCRESTRM privilege;cannotcreate(ormodifystreams Facility:15VDE,OpenVMS Development Environment^ Explanation:8^You attemptedtouseacommandorqual-JifierthatrequiresoneormoreVDE privileges,andyouIdidnothave sufficient privilegesenabled.*ThismessageFhisnormally displayedin conjunctionwithothererror5 messages,usuallya no-privilegeerror.\UserAction:<\Ifyouare authorizedtousethe privilege,EusetheVDESET PRIVILEGEScommandtogiveyourselfI the necessary privilege.*Thentrytheoriginal operationNeagain.)Ifyouarenot authorizedtousethe qualifier,youHshouldeitherrequestthe necessary privilegefromyourLproject administratororyoushouldnotusethe qualifier. ! /@O NOCREUSR,,noCREUSER privilege;cannotcreateor(deleteusers Facility:15VDE,OpenVMS Development Environment^ Explanation:8^You attemptedtouseacommandorqual-JifierthatrequiresoneormoreVDE privileges,andyouIdidnothave sufficient privilegesenabled.*ThismessageFhisnormally displayedin conjunctionwithothererror5 messages,usuallya no-privilegeerror.\UserAction:<\Ifyouare authorizedtousethe privilege,EusetheVDESET PRIVILEGEScommandtogiveyourselfI the necessary privilege.*Thentrytheoriginal operationNeagain.)Ifyouarenot authorizedtousethe qualifier,youHshouldeitherrequestthe necessary privilegefromyourLproject administratororyoushouldnotusethe qualifier. ! /=O NODELARCH,-noDELARCH privilege;cannotdelete( architectures Facility:15VDE,OpenVMS Development Environment^ Explanation:8^You attemptedtouseacommandorqual-JifierthatrequiresoneormoreVDE privileges,andyouIdidnothave sufficient privilegesenabled.*ThismessageFhisnormally displayedin conjunctionwithothererror5 messages,usuallya no-privilegeerror.\UserAction:<\Ifyouare authorizedtousethe privilege,EusetheVDESET PRIVILEGEScommandtogiveyourselfI the necessary privilege.*Thentrytheoriginal operationNeagain.)Ifyouarenot authorizedtousethe qualifier,youHshouldeitherrequestthe necessary privilegefromyourLproject administratororyoushouldnotusethe qualifier. =O NODELDEF,,Attempttodeletedefault prohibitedk Facility:15kVDE,OpenVMS Development Environment Explanation:5Youare attemptingtodeleteaobjectJ^(architecture,stream, facility,etc.)'thatisadefault.UserAction:1Tomakethe architecture deleteable7RusetheMODIFY ARCHITECTUREcommandwith>the/DELETE qualifier./ThenreentertheDELETE  ARCHITECTUREcommand. ! /;O NODELFAC,,noDELFAC privilege;cannotdelete#( facilitiesfromlibrary Facility:15VDE,OpenVMS Development Environment^ Explanation:8^You attemptedtouseacommandorqual-JifierthatrequiresoneormoreVDE privileges,andyouIdidnothave sufficient privilegesenabled.*ThismessageFhisnormally displayedin conjunctionwithothererror5 messages,usuallya no-privilegeerror.\UserAction:<\Ifyouare authorizedtousethe privilege,EusetheVDESET PRIVILEGEScommandtogiveyourselfI the necessary privilege.*Thentrytheoriginal operationNeagain.)Ifyouarenot authorizedtousethe qualifier,youHshouldeitherrequestthe necessary privilegefromyourLproject administratororyoushouldnotusethe qualifier. ! /;O NODELMOD,,noDELMOD privilege;cannotdelete (modulesfromlibrary Facility:15VDE,OpenVMS Development Environment^ Explanation:8^You attemptedtouseacommandorqual-JifierthatrequiresoneormoreVDE privileges,andyouIdidnothave sufficient privilegesenabled.*ThismessageFhisnormally displayedin conjunctionwithothererror5 messages,usuallya no-privilegeerror.\UserAction:<\Ifyouare authorizedtousethe privilege,EusetheVDESET PRIVILEGEScommandtogiveyourselfI the necessary privilege.*Thentrytheoriginal operationNeagain.)Ifyouarenot authorizedtousethe qualifier,youHshouldeitherrequestthe necessary privilegefromyourLproject administratororyoushouldnotusethe qualifier. ! /;O NODELREP,,noDELREP privilege;cannotdelete( replacements Facility:15VDE,OpenVMS Development Environment^ Explanation:8^You attemptedtouseacommandorqual-JifierthatrequiresoneormoreVDE privileges,andyouIdidnothave sufficient privilegesenabled.*ThismessageFhisnormally displayedin conjunctionwithothererror5 messages,usuallya no-privilegeerror.\UserAction:<\Ifyouare authorizedtousethe privilege,EusetheVDESET PRIVILEGEScommandtogiveyourselfI the necessary privilege.*Thentrytheoriginal operationNeagain.)Ifyouarenot authorizedtousethe qualifier,youHshouldeitherrequestthe necessary privilegefromyourLproject administratororyoushouldnotusethe qualifier.Y  u/&O NODELSET,-marked /NODELETEk Facility:15kVDE,OpenVMS Development Environment Explanation:6Youare attemptingtodeleteanobjectL^(architecture,stream, facility,etc.)'thathasbeenmarkedE not-deletablebydefaultorbyuseofthe /NODELETE qualifier.UserAction:;Toallowtheobjecttobedeleted,specify?the appropriateMODIFYcommandwiththe/DELETEC\ qualifier.'ThenreenterthefailingDELETEcommand. ! /=O NODELSTRM,,noDELSTRM privilege;cannotdelete (streamsfromlibrary Facility:15VDE,OpenVMS Development Environment^ Explanation:8^You attemptedtouseacommandorqual-JifierthatrequiresoneormoreVDE privileges,andyouIdidnothave sufficient privilegesenabled.*ThismessageFhisnormally displayedin conjunctionwithothererror5 messages,usuallya no-privilegeerror.\UserAction:<\Ifyouare authorizedtousethe privilege,EusetheVDESET PRIVILEGEScommandtogiveyourselfI the necessary privilege.*Thentrytheoriginal operationNeagain.)Ifyouarenot authorizedtousethe qualifier,youHshouldeitherrequestthe necessary privilegefromyourLproject administratororyoushouldnotusethe qualifier.B ~?O NODELTAROOT,,no delta-fileroot directoryexists(forlibrary Facility:15VDE,OpenVMS Development Environment^ Explanation::^Youhavetriedtocreatea directorytreeUforaspecific facility'sdeltafiles,butno delta-filerootdi-Irectoryexistsforthelibrary.)HenceVDEcannotcreate@hanydisk directoriesforthe indicated facility.UserAction:&Usethe CREATE DIRECTORY_=\TREE/DELTA_FILEScommandtocreatea directoryMtreeforthe library'sdeltafiles.*Thatwill automaticallyO createthe delta-fileroot directoryforthelibraryandthe;e delta-filesubdirectoriesforall facilities.% K ! ~!DO NODIRDELTA,,no delta-file directoryfoundforfacil- (ityN(facility Facility:15VDE,OpenVMS Development Environment^ Explanation:<^VDEtriedtoaccessthe delta-file directoryPforthe indicated facility,butnosuch directoryisrecordedIinthe database.(ThisnormallymeansthatyouhavenotChyetcreatedthedisk directoriesforthe facility.UserAction:=Tocreatethe facility's delta-file directory,9\usetheCREATEDIRECTORY_TREEcommandwithBthe /DELTA_FILESandpossibly /FACILITY qualifiers.@ UsetheSHOWLOCATIONcommandtoseewhatdisk=e directoriesarerecordedintheVDE database. ! ~>O NODIRMARKER,-no marker-file directoryfoundfor(facility(facility Facility:15VDE,OpenVMS Development Environment^ Explanation:7^VDEtriedtoaccessthe marker-filedi-Orectoryforthe indicated facility,butnosuch directoryisHrecordedinthe database.(ThisnormallymeansthatyouJhhavefailedtocreatea delta-file subdirectorywithdi-Erectorysymbol VDE$MARKERforthe indicated facility.NSucha directorymustexistforyoutocreatemodulesthatrusemarkerfiles. UserAction:: Tocreatetheneeded subdirectory,usethe:eSET DIRECTORYcommandwiththe /DELTA_FILES<and/SYMBOL=VDE$MARKER qualifiers.)ThencreateIthe facility's delta-file directorytreewiththeCREATE7oDIRECTORY_TREEcommand,usingthe/DELTA_FFILESandpossibly /FACILITY qualifiers.'UsetheSHOWB LOCATIONcommandtoseewhatdisk directoriesare+yrecordedintheVDE database. Y=O NOFACSPEC,,nofacility specifiedfor operationk Facility:15kVDE,OpenVMS Development Environment Explanation:3Youhaveenteredacommandthatre-L^quiresadefaultfacilitytoexist,butyouhavenotes-L tablishedadefault facility.)Usually,thismeansthatthe@commandyouhaveenteredcontainsamodulenameKhwithanomittedfacilitynameandthefacilitycannotbeM defaulted.(Asaresult,themodulecannotbelookedupinany facility.UserAction:<Either establishadefaultfacilitywiththeA SETFACILITYcommandandreenterthecommand,orJereenterthecommandwithan explicitly specifiedfacility)name,asin[FACNAM]MOD.TYP.q G/ONOFREE,-nofreestorage availablek Facility:15kVDE,OpenVMS Development Environment Explanation:2VDEhasrunoutofvirtualmemory.UserAction:3Uselesscomplex commands,raisetheBvirtual-addressquota,orsubmitaproblemreport. ! /^ definitionsbecause an errorwasreturned from5SMG$DELETE_VIRTUAL_KEYBOAD.VDEusesthe9SMGfacilitytoperformkeypad management.UserAction:5CheckthesetupoftheterminalwhichJmightcauseSMGsomeproblem.(IftheerrorstillcannotI\be explained,pleasecontactVDEsupportfor assistance.  ?ONOKEYW,, qualifiernameismissing-appendthe(nametotheslash Facility:15VDE,OpenVMS Development Environment^ Explanation:;^A qualifieriscomposedofbotha"/"andNkeyword.(Ifonlya"/"appears,thenthiserrormessageis displayed.UserAction:9Ensurethattherearenodangling"/"inthecommand.j ! C@.O NOLIBDEF,,noVDElibrarydefinedk Facility:15kVDE,OpenVMS Development Environment Explanation:;VDEisunabletoperformthe specifiedop-H^erationasthetargetVDE library-thelibraryonwhichJthe operationwillbe performed-hasnotbeen established.RUserAction:9RSpecifythetargetVDElibrary.(Todeter-Fminethe available libraries,issuethe"SETLIBRARY"Bcommandwithno parameters.-AspartoftheerrorE\message,thiscommandwilldisplaythenamesoftheL predefinedVDE libraries,theRdbroot directoryforeach,D andthemnemonicnameforeach.(Oncethe mnemnonicJenameortheRdbroot directorynameforthetargetli-Ebraryisknown,onecan:*A)usethe mnemnonicnameGortheRdbroot directorynameasthelibnameparam-Aoeterona"SETLIBRARYlibname"VDEcommand.*B)GUseusethe mnemnonicnameortheRdbroot directoryC nameasthe parameterontheVDE/LIBRARY=libname.HyC)Definethelogicalname VDE$LIBRARYto translatetoFtheVDE mnemnonicnameortotheRdbroot directory*name.x  uN=O NOLIBROOM,,toomany librariesindefaultfilek Facility:15kVDE,OpenVMS Development Environment Explanation:7VDEhasdetectedtoomany librariesde-G^claredintheVDE.DATMotif applicationdefaultsfile,Sandisunabletodisplayallofthe specified librariesinthe/systemlibrary cascading pulldown.UserAction:;IfyouareunabletoreducethenumberofP librariesinthedefaultfile,pleasecontactVDEsupportfor\ assistance.6 !  @ONOMAIL,-nomessagesent;MAILmessagesaredis-(abled Facility:15VDE,OpenVMS Development Environment^ Explanation::^ThismessageisusedtoindicatethattheJversionofVDEinusecontainsdebugor prototypecode,Bandasaresult,nomailmessageisbeingsent.UserAction::ContactVDEsupportfor assistance,astheLversionofVDEinusecontainsdebugor prototypeimages.3 u AO NOMAILSENT,,failuretosendmailmessagetouser(user Facility:15VDE,OpenVMS Development Environment^ Explanation:8^VDEhasfailedinanattempttosendaLmailmessagetothe indicateduser notifyingthatuserofyouraction.UserAction:7AttempttoresolvetheproblembasedonFanyothererrormessagesincludedwiththisone,and1\contactVDEsupportfor assistance.*   /O NOMATCHFAC,,nofacilitynamematchesthewild-(cardedstring(string Facility:15VDE,OpenVMS Development Environment^ Explanation:5^Youentereda wildcardedfacilitynameL specificationonacommand,butthat specificationdidnot>matchanyfacilitynamesintheVDE database.UserAction:;Thisisnot necessarilyanerror;themes-Hsagesimplytellsyouthatno facilitiesmatchingyourJ\ specificationexistinthe database.*IfyouhadexpectedJsuch facilitiestoexist,youcanusetheSHOWFACILITYM commandtoseewhat facilitiesarepresentinthedatabaseGeandyoucanaskyourproject administatortoaddanymissing facilities.+ ! ~:O NOMATCHGEN,-no generationmatches wildcarded(string(string Facility:15VDE,OpenVMS Development Environment^ Explanation:1^Youentereda wildcarded generationL specificationonacommand,butthat specificationdidnotBmatchanymodule generationsintheVDE database.UserAction:5Thisisnot necessarilyanerror; theDmessagesimplytellsyouthatnomodule generationsK\matchingyour specificationexistinthe database.)IfyouJhadexpectedsuch generationstoexist,youcanusethe? SHOW GENERATIONcommandtoseewhat generations*earepresentinthe database.O %;O NOMATCHGENS,,no generationmatches wildcarded(string(string(instreamq(string Facility:15VDE,OpenVMS Development Environment^ Explanation:1^Youentereda wildcarded generationL specificationonacommand,butthat specificationdidnotFmatchanymodule generationsinthe specifiedstream.UserAction:;Thisisnot necessarilyanerror;themes-Isagesimplytellsyouthatnomodule generationsmatch-N\ingyour specificationexistinthe specifiedstream.(First,Jverifythatyouhaveeither specifiedthecorrectstreamN onthecommandorthatyourcontextissettothecorrectJestream.&Ifthestreamnamewascorrectandyouhadex-Ipectedsuch generationstoexist,youcanusetheSHOW4GENERATION/STREAM=stream-namecommandtoAoseewhat generationsarepresentinthatstream.t  J;O NOMATCHGRP,-nogroupnamematchesthewild-(cardedstring(string Facility:15VDE,OpenVMS Development Environment^ Explanation:2^Youentereda wildcardedgroupnameL specificationonacommand,butthat specificationdidnot;matchanygroupnamesintheVDE database.UserAction:;Thisisnot necessarilyanerror;themes-DsagesimplytellsyouthatnogroupsmatchingyourJ\ specificationexistinthe database.*IfyouhadexpectedCsuchgroupstoexist,youcanusetheSHOWGROUPI commandtoseewhatgroupsarepresentinthedatabaseBeandyoucanusetheCREATEGROUPcommandtoadd&anynewgroupsyouwant.C  O NOMATCHSCRP,-noscriptsmatchthe specificationk Facility:15kVDE,OpenVMS Development Environment Explanation:=You requestedadisplayofallscriptsofaE^certainstype,possiblymatchinga wildcardedmodule-Fnameor facility-namespecification,buttherearenoGscriptsinthedatabasethatmatchthatspecification.UserAction:;Thisisnot necessarilyanerror;themes-Osagesimplytellsyouthatnoscriptsexistinthedatabase+\thatmatchyourspecification.} ! S=O NOMATCHSES,,nosessionnamematchesthewild-(cardedstring(string Facility:15VDE,OpenVMS Development Environment^ Explanation:4^Youentereda wildcardedsessionnameL specificationonacommand,butthat specificationdidnot=matchanysessionnamesintheVDE database.UserAction:;Thisisnot necessarilyanerror;themes-FsagesimplytellsyouthatnosessionsmatchingyourJ\ specificationexistinthe database.*IfyouhadexpectedGsuchsessionstoexist,youcanusetheSHOWSESSIONK commandtoseewhatsessionsarepresentinthedatabaseGeandyoucanaskyourproject administatortoaddanymissing sessions.  \>O NOMATCHSTEP,,nobuildstepsformodulesmatch- (ingh(stringh(foundindatabase Facility:15VDE,OpenVMS Development Environment^ Explanation:2^Youentereda wildcarded module-nameO specificationtospecifybuildsteps,buttherearenobuildIstepsinthedatabaseformodulesthatmatchthatnamehspecification.UserAction:;Thisisnot necessarilyanerror;themes-J\sagesimplytellsyouthatnobuildstepsexistintheDdatabaseformodulesmatchingyour module-namespec-Q  ification.'Ifyouhadexpectedsuchbuildstepstoexist,youBecanusetheSHOWSTEPcommandtoseewhatbuild5stepsare representedinthe database.  W=O NOMATCHSTRM,,nostreamnamematchesthewild-(cardedstring(string Facility:15VDE,OpenVMS Development Environment^ Explanation:3^Youentereda wildcardedstreamnameL specificationonacommand,butthat specificationdidnot<matchanystreamnamesintheVDE database.UserAction:;Thisisnot necessarilyanerror;themes-EsagesimplytellsyouthatnostreamsmatchingyourJ\ specificationexistinthe database.*IfyouhadexpectedEsuchstreamstoexist,youcanusetheSHOWSTREAM *@ commandtoseewhatstreamsarepresentintheGedatabaseandyoucanaskyourproject administatorto%addanymissingstreams.%&   U;O NOMATCHUSER,,nousernamematchesthewild-(cardedstring(string Facility:15VDE,OpenVMS Development Environment^ Explanation:6^Youentereda wildcardedusernamespec-H ificationonacommand,butthat specificationdidnot8matchany usernamesintheVDE database.UserAction:;Thisisnot necessarilyanerror;themes-Jsagesimplytellsyouthatnousersmatchingyourspec-L\ ificationexistinthe database.)Ifyouhadexpectedsuch;userstoexist,youcanusetheSHOWUSER ,*kcommandH toseewhat usernamesarepresentinthedatabaseandKeyoucanaskyourproject administatortoaddanymissingusers.  7O NOMEMGRP,-nomembers specifiedforgroupgroupk Facility:15kVDE,OpenVMS Development Environment Explanation:9YouhavetriedtocreateagroupwithoutE^ specifyinganymembersforthatgroup.*AgroupmustIhaveatleastonemember.((ThemembersofagroupareLthemodulestobebuiltwhenthegroupnameis specified!honaGROUP command.)UserAction:/ReentertheCREATEGROUPcommand,K\ specifyingthenamesofthemodulesthatyouwanttobe,themembersofthenewgroup. ! /;O NOMODLIB,,noMODLIB privilege;cannotmodify'( attributesofthislibrary Facility:15VDE,OpenVMS Development Environment^ Explanation:8^You attemptedtouseacommandorqual-JifierthatrequiresoneormoreVDE privileges,andyouIdidnothave sufficient privilegesenabled.*ThismessageFhisnormally displayedin conjunctionwithothererror5 messages,usuallya no-privilegeerror.\UserAction:<\Ifyouare authorizedtousethe privilege,EusetheVDESET PRIVILEGEScommandtogiveyourselfI the necessary privilege.*Thentrytheoriginal operationNeagain.)Ifyouarenot authorizedtousethe qualifier,youHshouldeitherrequestthe necessary privilegefromyourLproject administratororyoushouldnotusethe qualifier.  ~O NOPERFREP,,noPREFREP privilege;cannotperform( replacements Facility:15VDE,OpenVMS Development Environment^ Explanation:8^You attemptedtouseacommandorqual-JifierthatrequiresoneormoreVDE privileges,andyouIdidnothave sufficient privilegesenabled.*ThismessageFhisnormally displayedin conjunctionwithothererror5 messages,usuallya no-privilegeerror.\UserAction:<\Ifyouare authorizedtousethe privilege,EusetheVDESET PRIVILEGEScommandtogiveyourselfI the necessary privilege.*Thentrytheoriginal operationNeagain.)Ifyouarenot authorizedtousethe qualifier,youHshouldeitherrequestthe necessary privilegefromyourLproject administratororyoushouldnotusethe qualifier.: { ! Q>ONOPNAM,,unknownprojectname specifiedforthe(stream Facility:15VDE,OpenVMS Development Environment^ Explanation:9^The specifiedprojectnamedoesnotmatchItheprojectnames associatedwiththe specifieddevelop-mentstream.UserAction::Thisisawarningmessage,IfyoubelieveIthatthisprojectshouldbe associatedwiththestream,J\pleasecontacttheprojectleader,thesystem manager(s),,orVDEsupportfor assistance.L ";ONOPNAMS,-noprojectsdefinedforthestreamk Facility:15kVDE,OpenVMS Development Environment Explanation:9Therearenoprojects associatedwiththe)^ specified developmentstream.UserAction:8Thisisan informationalmessage,IfyouLRbelievethatthereshouldbeoneormoreprojectsassoci-Jatedwiththestream,pleasecontacttheprojectleader,Fthesystem manager(s),orVDEsupportfor assistance.9 ! ~7O NOPRIVQUAL,, insufficient privilegetouseJqualifer( qualifier Facility:15VDE,OpenVMS Development Environment^ Explanation:4^You attemptedtouseacommandqual-Nifierthatrequiresa privilege,andyoudidnothavethat privilegeset.UserAction:<Ifyouare authorizedtousethe qualifier,EusetheSET PRIVILEGEScommandtogiveyourselftheL\ necessary privilege.'Thentrytheoriginal operationagain.NIfyouarenot authorizedtousethe qualifier,youshouldI eitherrequestthe necessary privilegefromyourprojectCe administratororyoushouldnotusethe qualifier. ! /CONOPRIVS,, insufficientVDE privilege(s)for attempted( operation Facility:15VDE,OpenVMS Development Environment^ Explanation:8^You attemptedtouseacommandorqual-JifierthatrequiresoneormoreVDE privileges,andyouIdidnothave sufficient privilegesenabled.*ThismessageFhisnormally displayedin conjunctionwithothererror5 messages,usuallya no-privilegeerror.\UserAction:<\Ifyouare authorizedtousethe privilege,EusetheVDESET PRIVILEGEScommandtogiveyourselfI the necessary privilege.*Thentrytheoriginal operationNeagain.)Ifyouarenot authorizedtousethe qualifier,youHshouldeitherrequestthe necessary privilegefromyourLproject administratororyoushouldnotusethe qualifier. ;O NOPROMPT,-noprompt specified;usingdefault(prompt Facility:15VDE,OpenVMS Development Environment^ Explanation:4^Thisisan informationalmessage,andC indicatesthatnopromptwas specifiedontheSET@PROMPTcommand.*Asnopromptwas specified,VDE6hwillreverttothedefaultVDEprompt.UserAction:#Noactionis required. ! aAsaresult,thecommandcannotbe performed.UserAction:7Reenterthecommandwitha qualifierto6specifythescripttypeofthescript. &s>ONOSCT,, replacementcausenotknown;modulenot(replaced Facility:15VDE,OpenVMS Development Environment^ Explanation:3^VDEwasnotprovidedwiththecauseDofthe replacementbeing performed.-Thecauseofa?replacement-usuallyaSourceCodeTracking(SCT)7hentryorasourcecodeFold-istracked.UserAction:5SpecifytheSCTnoteviathe/SCTor?\/NOTE qualifiersontheREPLACEcommand,orbyC providinganswerstoteh replacementpromptswithin VDE. ! kh!O NOSCTSRC,,sourcefile,record$DforSCTnotenotfoundk Facility:15kVDE,OpenVMS Development Environment Explanation:@VDEisnotabletolocatethesourcefilefor^theSCTnote.UserAction:8 Respecifythecommand,usingafilethatRexists. ! k@O NOSETLIB,,theSETLIBRARYcommandislockedoutk Facility:15kVDE,OpenVMS Development Environment Explanation:2TheSETLIBRARYcommandisdisabled5^when executingabetaversionofVDE.UserAction::ContactVDEsupportfor assistance,astheARversionofVDEinusecontains beta-onlyimages.$  )g:O NOSETTERM,-theSETTERMINALcommandisnot'( supportedonthisterminal Facility:15VDE,OpenVMS Development Environment^ Explanation:,^SETTERMINALisonly supported@onVT52, VT100-series, VT200-series, VT300-series,@ VT400-series, VT500-series,andDECterm terminals.! *ONOSPAWN,-spawncommandfailedk Facility:15kVDE,OpenVMS Development Environment Explanation:3AprocesscannotbespawnedbyVDE.UserAction:)Checkyour process'squotas.  `AO NOSTAGROOT,,nostagingarearoot directoryexists(forlibrary Facility:15VDE,OpenVMS Development Environment^ Explanation:8^Youhavetriedtocreatequeuedreplace-Kmentforsomemodule,butnostagingarearoot directoryIexistsforthelibrary.*HenceVDEcannotcreateadiskRh directoryforsaving(or ``staging'')thefilestobe replaced.UserAction:&Usethe CREATE DIRECTORY_>\ TREE/STAGINGcommandtocreatetherootdirec-Htoryforthe library'sstagingareas.,ThenreentertheA REPLACEcommand.)Alternatively,replacethemoduleFewithan immediate(asopposedtoqueued) replacement.GAn immediate replacementdoesnotuseastagingarea. &?O NOSTRMROOT,,nostreamroot directoryexistsfor(stream(stream Facility:15VDE,OpenVMS Development Environment^ Explanation::^Youhavetriedtocreatea directorytreeLforaspecificfacilitywithinthecurrentstream,butnoHroot directoryexistsforthestream.)HenceVDEcannotHhcreateanydisk directoriesforthe indicated facility.UserAction:*UsetheCREATEDIRECTORY_TREED\commandtocreatea directorytreeforthecurrentGstream.)Thatwill automaticallycreateboththestreamJ root directoryandthesubdirectoriesforall facilities.< ! \mandifyoudonotwishtoseethemessage. hO NOTESENTID,,notenoteID postedin conference( conference Facility:15VDE,OpenVMS Development Environment^ Explanation:5^ThismessageinformsyouthatVDEhasK successfullypostedanoteinthe indicatednotesconfer-Eence.,Thismessageisissuedwhenyouusethe/LOGJh qualifieronacommandthatsends notificationstonotes conferences.\UserAction:5\Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage.Q  '0O NOTESERR,,errorfromDECNotesatg routine-namek Facility:15kVDE,OpenVMS Development Environment Explanation:1VDEhas encounteredanerrorwhile1^usingthenotescallable interface.UserAction:7AttempttoresolvetheproblembasedonHRanyothererrormessagesincludedwiththisone,checkKthe documentationfor informationonsettingupthenotesD conferences,andcontactVDEsupportfor assistance.b  u88ONOTESID,,unabletoparseDECNotestopicrnote-(number Facility:15VDE,OpenVMS Development Environment^ Explanation:1^VDEhas encounteredanerrorwhile1usingthenotescallable interface.RUserAction:7RAttempttoresolvetheproblembasedonHanyothererrormessagesincludedwiththisone,checkKthe documentationfor informationonsettingupthenotesD\ conferences,andcontactVDEsupportfor assistance.* ! CO NOTEXTSTR,,textstringargumentmissingincallto( routine-name Facility:15VDE,OpenVMS Development Environment^ Explanation:7^VDEhasdetectedan inconsistencywithinNaninternalroutinewhichusesthenotescallable interface.RUserAction:9RPleasecontactVDEsupportfor assistance.FPleaseincludeany informationthatmaybeusefulor2releventin duplicatingtheproblem.  kBONOTIMPL,,thisfeatureisnot currently implementedk Facility:15kVDE,OpenVMS Development Environment Explanation:7Thismessageinformsyouthattheindi-H^catedfeatureorcallbackisnot currently implemented.UserAction:9PleasecontactVDEsupportfor assistance.,  %O NOTINRANGE,-integervaluenumberbnotinvalid(rangeof=( low-bound (tok( high-bound Facility:15VDE,OpenVMS Development Environment^ Explanation:9^The indicatedintegervalueisnotwithinNthevalidrangeforthe qualifieror parameteronwhichitis specified.UserAction:3Reenterthecommandwiththeinteger,valuewithintheproperrange. eONOTPROP,, generation generationnot propagated(paststream(stream Facility:15VDE,OpenVMS Development Environment^ Explanation:4^Becausethe /PROPAGATEor /NOPROPAGATED qualifierwas specifiedontheREPLACEcommand,theG indicatedmodule generationisnot propagatedpastthe)h indicated developmentstream.UserAction:2None.-Thisisan informationalmes-D\sagethatmerelyconfirmsthatVDE performedchange% propagationas requested.  ! O NOTRESINSTRM,,modulemodulenotreservedin(stream(stream Facility:15VDE,OpenVMS Development Environment^ Explanation:6^Youaretryingto unreserveorreplaceKamoduleinthe indicatedstream,butthemoduleisnot%reservedinthatstream.UserAction:*UsetheSHOWRESERVATION/FULL?commandtoseewhatstreamthe reservationwas=\madein..ThenusetheSETSTREAMcommandtoFsetthecurrentstreamtothe appropriatestreamandG re-enterthecommand,or(when available)youcanap-Bependthe/STREAM qualifieronthefailingcommandBandreissuethecommand..Ifyouare performinga? REPLACEMENT,a replacement performedinthean-Iocestorstream propogatedforwardintoanyand successors"ofthetargetstream.9#   BO NOTREVREP,,youarenotareviewerfor replacement( replacement Facility:15VDE,OpenVMS Development Environment^ Explanation:4^Youaretryingtomarka replacementKasacceptedor rejected,butyouarenotareviewerforIthe replacement.)Asaresult,yourattempttomarkthe?h replacementasacceptedorrejectedhasfailed.UserAction:5Specifythenameofa replacementforH\whichyouareareviewerorhaveyourselfaddedasa:reviewerbysomeone authorizedtoaddyou. ! />O NOUNCLOSE,,noUNCLOSE privilege;cannotunclose(aclosedstream Facility:15VDE,OpenVMS Development Environment^ Explanation:8^You attemptedtouseacommandorqual-JifierthatrequiresoneormoreVDE privileges,andyouIdidnothave sufficient privilegesenabled.*ThismessageFhisnormally displayedin conjunctionwithothererror5 messages,usuallya no-privilegeerror.\UserAction:<\Ifyouare authorizedtousethe privilege,EusetheVDESET PRIVILEGEScommandtogiveyourselfI the necessary privilege.*Thentrytheoriginal operationNeagain.)Ifyouarenot authorizedtousethe qualifier,youHshouldeitherrequestthe necessary privilegefromyourLproject administratororyoushouldnotusethe qualifier. ! /7O NOUSERNAME,,noUSERNAME privilege;cannot2(reserveandreplaceforotherusers Facility:15VDE,OpenVMS Development Environment^ Explanation:8^You attemptedtouseacommandorqual-JifierthatrequiresoneormoreVDE privileges,andyouIdidnothave sufficient privilegesenabled.*ThismessageFhisnormally displayedin conjunctionwithothererror5 messages,usuallya no-privilegeerror.\UserAction:<\Ifyouare authorizedtousethe privilege,EusetheVDESET PRIVILEGEScommandtogiveyourselfI the necessary privilege.*Thentrytheoriginal operationNeagain.)Ifyouarenot authorizedtousethe qualifier,youHshouldeitherrequestthe necessary privilegefromyourLproject administratororyoushouldnotusethe qualifier. ! /?O NOVDEDEVO,-noVDEDEVO privilege;accesstodun-(geon restricted Facility:15VDE,OpenVMS Development Environment^ Explanation:8^You attemptedtouseacommandorqual-JifierthatrequiresoneormoreVDE privileges,andyouIdidnothave sufficient privilegesenabled.*ThismessageFhisnormally displayedin conjunctionwithothererror5 messages,usuallya no-privilegeerror.\UserAction:<\Ifyouare authorizedtousethe privilege,EusetheVDESET PRIVILEGEScommandtogiveyourselfI the necessary privilege.*Thentrytheoriginal operationNeagain.)Ifyouarenot authorizedtousethe qualifier,youHshouldeitherrequestthe necessary privilegefromyourLproject administratororyoushouldnotusethe qualifier.  7O NULSTRNOT,-anullstringisnotallowedk Facility:15kVDE,OpenVMS Development Environment Explanation:=This qualifierrequiresthatastringwithaJ^minimumlengthof1 characterbeprovidedifanystringGis specifiedatall.'Thenullstringisnotallowed.RUserAction:5RReenterthecommand providingastring9withthis qualifier,ornovalueatall.  .ONYI,-featurenotyet implementedk Facility:15kVDE,OpenVMS Development Environment Explanation:9VDEhasdetectedarequestforafeature1^thathasnotyetbeen implemented.UserAction:9PleasecontactVDEsupportfor assistance.FRPleaseincludeany informationthatmaybeusefulor2releventin duplicatingtheproblem.] u3@OOFFLINE,,sourcecodecontrolsystemoffline,try(againlater Facility:15VDE,OpenVMS Development Environment^ Explanation:5^TheVDEsystemisofflineformainte-Hnanceorupgrade,pleasetryyourrequestagainlater.RUserAction:6RTheVDEsystemisofflinefoprmainte-Hnanceorupgrade,pleasetryagainlater.+IfyouhaveD questions,pleasecontactVDEsupportorthesystem-\ managementstafffor assistance. $OOUTFILE,-outputfileis4filek Facility:15kVDE,OpenVMS Development Environment Explanation:8 Indicatestheoutputfileofthecurrent<^command.)TheFETCHandRESERVEcommandsdis-Mplaythismessagetoshowthelocationoftheoutputfile7 containingthefetchedmodule generation.UserAction:6None.'Thisisan informationalmessage.] ! 3$O OUTMODSRC,,outputmodule?moduleofbuildstepis%(asourcemodule;ignored Facility:15VDE,OpenVMS Development Environment^ Explanation:3^The automatically collected dependencyK informationforthecurrentbuildstep specifiesthattheG indicatedmoduleisanoutputfromthestep.*However,FhthemoduleismarkedasasourcemoduleintheVDEJ database,andasourcemodulecannotbeanoutputofaIbuildstep.(Hencethis dependency informationisignored4randisnotrecordedinthe database. UserAction:9 Ifthemoduleis erroneouslymarkedasaKesourcemoduleintheVDE database,youshoulddeletetheNmoduleandrerunthebuildstep.'IfthemoduleactuallyisJasourcemodule,youshould investigatewhythecompilerOoorother processor specifiesitasanoutputfromthebuildstep. ! ~O PROTOTYPE,-thisisa prototypeversionofVDEk Facility:15kVDE,OpenVMS Development Environment Explanation::ThismessageisusedtoindicatethattheJ^versionofVDEinusecontainsdebugor prototypecode.UserAction::ContactVDEsupportfor assistance,astheLRversionofVDEinusecontainsdebugor prototypeimages. ! =O QARDBSYNTAX,,invalidQARdatabasenamesyntax:(name Facility:15VDE,OpenVMS Development Environment^ Explanation:9^Thenameorformat specifiedfortheQAR8databasenameisnotusingvalidsyntax.RUserAction:4R RespecifytheQARdatabasenameusingEonly alphanumeric, underscore,dollarsignandhyphen characters. ! -O QCHECKCOUNT,-queued.checkin.count:countk Facility:15kVDE,OpenVMS Development Environment Explanation:<ThismessageisusedtoformattextstringsO^withinVDE,andshouldnotbevisibletousersasanerrormessage.RUserAction::RContactVDEsupportfor assistance,astheNversionofVDEinuseshouldnotbe displayingthisasanerrormessage. ! .O QDATETIME,,queued.checkin.datetime:datetimek Facility:15kVDE,OpenVMS Development Environment Explanation:<ThismessageisusedtoformattextstringsO^withinVDE,andshouldnotbevisibletousersasanerrormessage.RUserAction::RContactVDEsupportfor assistance,astheNversionofVDEinuseshouldnotbe displayingthisasanerrormessage. ! 0OQERRORS,,queued.checkin.defectsfixed:defectsk Facility:15kVDE,OpenVMS Development Environment Explanation:<ThismessageisusedtoformattextstringsO^withinVDE,andshouldnotbevisibletousersasanerrormessage.RUserAction::RContactVDEsupportfor assistance,astheNversionofVDEinuseshouldnotbe displayingthisasanerrormessage. ! (OQGROUP,,queued.checkin.group:groupk Facility:15kVDE,OpenVMS Development Environment Explanation:<ThismessageisusedtoformattextstringsO^withinVDE,andshouldnotbevisibletousersasanerrormessage.RUserAction::RContactVDEsupportfor assistance,astheNversionofVDEinuseshouldnotbe displayingthisasanerrormessage.  ! &OQITEM,-queued.checkin.item:=itemk Facility:15kVDE,OpenVMS Development Environment Explanation:<ThismessageisusedtoformattextstringsO^withinVDE,andshouldnotbevisibletousersasanerrormessage.RUserAction::RContactVDEsupportfor assistance,astheNversionofVDEinuseshouldnotbe displayingthisasanerrormessage. ! ,OQLIBMNE,-queued.library.mnemonic:r libmnemonick Facility:15kVDE,OpenVMS Development Environment Explanation:<ThismessageisusedtoformattextstringsO^withinVDE,andshouldnotbevisibletousersasanerrormessage.RUserAction::RContactVDEsupportfor assistance,astheNversionofVDEinuseshouldnotbe displayingthisasanerrormessage. ! *OQMODULE,,queued.checkin.module:Mmodnamek Facility:15kVDE,OpenVMS Development Environment Explanation:<ThismessageisusedtoformattextstringsO^withinVDE,andshouldnotbevisibletousersasanerrormessage.RUserAction::RContactVDEsupportfor assistance,astheNversionofVDEinuseshouldnotbe displayingthisasanerrormessage.( ! &OQNOTE,-queued.checkin.note:Gtopic .replyk Facility:15kVDE,OpenVMS Development Environment Explanation:<ThismessageisusedtoformattextstringsO^withinVDE,andshouldnotbevisibletousersasanerrormessage.RUserAction::RContactVDEsupportfor assistance,astheNversionofVDEinuseshouldnotbe displayingthisasanerrormessage.b  ! )O QPROJECT,-queued.project.name:projectk Facility:15kVDE,OpenVMS Development Environment Explanation:<ThismessageisusedtoformattextstringsO^withinVDE,andshouldnotbevisibletousersasanerrormessage.RUserAction::RContactVDEsupportfor assistance,astheNversionofVDEinuseshouldnotbe displayingthisasanerrormessage. ! .OQREASON,,queued.checkin.reasonmask:reasonk Facility:15kVDE,OpenVMS Development Environment Explanation:<ThismessageisusedtoformattextstringsO^withinVDE,andshouldnotbevisibletousersasanerrormessage.RUserAction::RContactVDEsupportfor assistance,astheNversionofVDEinuseshouldnotbe displayingthisasanerrormessage. ! 1OQREPLID,,queued.checkin.replacementid:=replidk Facility:15kVDE,OpenVMS Development Environment Explanation:<ThismessageisusedtoformattextstringsO^withinVDE,andshouldnotbevisibletousersasanerrormessage.RUserAction::RContactVDEsupportfor assistance,astheNversionofVDEinuseshouldnotbe displayingthisasanerrormessage. ! .O QREPLNAME,,queued.checkin.replname:replnamek Facility:15kVDE,OpenVMS Development Environment Explanation:<ThismessageisusedtoformattextstringsO^withinVDE,andshouldnotbevisibletousersasanerrormessage.RUserAction::RContactVDEsupportfor assistance,astheNversionofVDEinuseshouldnotbe displayingthisasanerrormessage. ! +O QRMPBCOUNT,,queued.module.count:countk Facility:15kVDE,OpenVMS Development Environment Explanation:<ThismessageisusedtoformattextstringsO^withinVDE,andshouldnotbevisibletousersasanerrormessage.RUserAction::RContactVDEsupportfor assistance,astheNversionofVDEinuseshouldnotbe displayingthisasanerrormessage.& ! u0O QRMPBMODFLAG,,queued.module.modflags:mod-(flags Facility:15VDE,OpenVMS Development Environment^ Explanation:<^ThismessageisusedtoformattextstringsOwithinVDE,andshouldnotbevisibletousersasanerrormessage.UserAction::ContactVDEsupportfor assistance,astheNversionofVDEinuseshouldnotbe displayingthisasan\errormessage.$ ! u/O QRMPBMODNAME,,queued.module.modname:mod-(name Facility:15VDE,OpenVMS Development Environment^ Explanation:<^ThismessageisusedtoformattextstringsOwithinVDE,andshouldnotbevisibletousersasanerrormessage.UserAction::ContactVDEsupportfor assistance,astheNversionofVDEinuseshouldnotbe displayingthisasan\errormessage.( S u8OQRMPBREPLREMARK,-queued.module.replaceremark:( replaceremark Facility:15VDE,OpenVMS Development Environment^ Explanation:<^ThismessageisusedtoformattextstringsOwithinVDE,andshouldnotbevisibletousersasanerrormessage.UserAction::ContactVDEsupportfor assistance,astheNversionofVDEinuseshouldnotbe displayingthisasan\errormessage.' ! u7OQRMPBRESREMARK,,queued.module.reserveremark:( reserveremark Facility:15VDE,OpenVMS Development Environment^ Explanation:<^ThismessageisusedtoformattextstringsOwithinVDE,andshouldnotbevisibletousersasanerrormessage.UserAction::ContactVDEsupportfor assistance,astheNversionofVDEinuseshouldnotbe displayingthisasan\errormessage. ! /O QRMPBSTAGING,,queued.module.staging:=stagingk Facility:15kVDE,OpenVMS Development Environment Explanation:<ThismessageisusedtoformattextstringsO^withinVDE,andshouldnotbevisibletousersasanerrormessage.RUserAction::RContactVDEsupportfor assistance,astheNversionofVDEinuseshouldnotbe displayingthisasanerrormessage. ! *OQSTREAM,,queued.checkin.stream:'streamk Facility:15kVDE,OpenVMS Development Environment Explanation:<ThismessageisusedtoformattextstringsO^withinVDE,andshouldnotbevisibletousersasanerrormessage.RUserAction::RContactVDEsupportfor assistance,astheNversionofVDEinuseshouldnotbe displayingthisasanerrormessage. ! ,OQTYPCOD,,queued.checkin.typecode:rtypek Facility:15kVDE,OpenVMS Development Environment Explanation:<ThismessageisusedtoformattextstringsO^withinVDE,andshouldnotbevisibletousersasanerrormessage.RUserAction::RContactVDEsupportfor assistance,astheNversionofVDEinuseshouldnotbe displayingthisasanerrormessage.  ! ,OQTYPNAM,-queued.checkin.typename:typek Facility:15kVDE,OpenVMS Development Environment Explanation:<ThismessageisusedtoformattextstringsO^withinVDE,andshouldnotbevisibletousersasanerrormessage.RUserAction::RContactVDEsupportfor assistance,astheNversionofVDEinuseshouldnotbe displayingthisasanerrormessage.x  N O QUALDISALL,- qualifier6 qualifier"is disallowedforthe(command(command Facility:15VDE,OpenVMS Development Environment^ Explanation:5^Youhave specifiedacommand qualifierIthatisnotallowedwiththe specifiedcommand.(BecauseMthe qualifierisnotallowed,thecommandisnot executed.LhIncertaincases,the qualifieris disallowedbyyourVDENlibraryduetoalibrary attribute,andthe qualifierwouldMbeallowedifthelibrary attributethat disallowsitwererchanged. UserAction:6 Reenterthecommandwithouttheoffend-Neing qualifierorchangethelibrary attributethat disallowsit,if applicable.  _ O QUALNOTALL,- qualifierU qualifier isnotallowedwhen%(a parameteris specified Facility:15VDE,OpenVMS Development Environment^ Explanation:4^Youhave specifiedboththe indicatedE qualifierandacommand parameteronacommandthatKdoesnotallowbothtobe specified.*Thecommandisnot&hexecutedforthisreason.UserAction:7Reenterthecommandwitheitherthein-F\dicated qualifierorwithcommand parameters,butnotboth.G  !O QUALTOOMANY,, qualifier qualifier!hasbeenspeci- (fiedtoomanytimes Facility:15VDE,OpenVMS Development Environment^ Explanation:9^Youhave specifiedthe indicated qualifierGtoomanytimesfora parameteronthiscommandline.=Thecommandisnotexecutedforthisreason.UserAction:5Reenterthecommandwiththe indicatedK qualifier specifiednomorethanonceforeach parameter. ! q"O QUECLOSED,-batchqueuequeue!isclosedandcannot(acceptjobs Facility:15VDE,OpenVMS Development Environment^ Explanation:7^The indicatedbatchqueueisclosedandKcannotacceptbatchjobs.+Itthuscannotbeusedtorun.thebuildjobyouare starting.UserAction:9YoucaneitherrunthebuildjobontheG remainingbatchqueuesyouhave specified,oryoucanN\restartthebuildjobandspecifya differentsetofbatchqueuesforit. &"O QUEPAUSED,-batchqueuequeueispausedorpaus-*(ing;job executionishalted Facility:15VDE,OpenVMS Development Environment^ Explanation::^The indicatedbatchqueueispausedorinNtheprocessofpausing.(YoucanstillsubmitbatchjobstoLthequeue,butthejobswillnotexecuteuntilthepauseh conditionends.UserAction:<YoucaneitherletthebuildjobbequeuedK\tothepausedbatchqueueandwaitforthepausecondi-Qtiontoend,oryoucanrestartthebuildjobandspecifya5  differentsetofbatchqueuesforit./ &#O QUESTOPPED,,batchqueuequeueisstoppedor/( stopping;job executionishalted Facility:15VDE,OpenVMS Development Environment^ Explanation:;^The indicatedbatchqueueisstoppedorinOtheprocessof stopping.(YoucanstillsubmitbatchjobstoPthequeue,butthejobswillnotexecuteuntilthequeueis8hstartedbyasystemmanageror operator.UserAction:<YoucaneitherletthebuildjobbequeuedL\tothestoppedbatchqueueandwaitforthequeuetobeKstarted,oryoucanrestartthebuildjobandspecifya5  differentsetofbatchqueuesforit. ;O QUOCHECK,, performingaquotacheck operationk Facility:15kVDE,OpenVMS Development Environment Explanation:-This message indicates that the@^ VDE/READ_UAFimageischeckingprocessquotasinItheSYSUAF,andthatitwillNOTupdatequotasettingsintheSYSUAF.UserAction:3Informational,noactionis necessary  /OQUOLOW,-quotaquotasetto: 3old, recommended: (new Facility:15VDE,OpenVMS Development Environment^ Explanation:-^This message indicates that theB VDE/READ_UAFimagehasdetectedausernamewithaDquotavaluethatisbelowthe recommended settings.UserAction:5Contactyourlocalsystemmanager,andGaskthatthequotasonthe specifieduserbecheckedA\againsttheVDEminimumvalues,andraisedwhereB necessary.*ThesystemmanagerorVDEdatabasead-=  ministratorcanusetheVDEcommand VDE/READ_Fe UAF/WRITE_UAFtoraisetheprocessquotastothere-HquiredminimumvaluesonallVDEusers.'(ProcessquotaJvaluesabovetherequiredminimumswillnotbe altered.) =O QUORESET,, performingaquotacheckandupdate( operation Facility:15VDE,OpenVMS Development Environment^ Explanation:-^This message indicates that the@ VDE/READ_UAFimageischeckingprocessquotasinHtheSYSUAF,andthatitWILLupdatequotasettingsinhtheSYSUAF.UserAction:3Informational,noactionis necessary9 w.O QUOSTREXP,,quotedstringexpectedk Facility:15kVDE,OpenVMS Development Environment Explanation:9Aquotedstringwas expected.'ThisquotedN^stringmustbe delimitedbyeithersingleordoublequotes.  /OQUOUSER,,useruser#below recommendedquota( setting(s) Facility:15VDE,OpenVMS Development Environment^ Explanation:-^This message indicates that theB VDE/READ_UAFimagehasdetectedausernamewithaDquotavaluethatisbelowthe recommended settings.UserAction:5Contactyourlocalsystemmanager,andGaskthatthequotasonthe specifieduserbecheckedA\againsttheVDEminimumvalues,andraisedwhereB necessary.*ThesystemmanagerorVDEdatabasead-=  ministratorcanusetheVDEcommand VDE/READ_Fe UAF/WRITE_UAFtoraisetheprocessquotastothere-HquiredminimumvaluesonallVDEusers.'(ProcessquotaJvaluesabovetherequiredminimumswillnotbe altered.)"" f ! u<.O QUSERNAME,,queued.checkin.username:usernamek Facility:15kVDE,OpenVMS Development Environment Explanation:<ThismessageisusedtoformattextstringsO^withinVDE,andshouldnotbevisibletousersasanerrormessage.RUserAction:5RContactVDEsupportfor assistance,asKtheversionofVDEinuseshouldnotbe displayingthisPasanerrormessage.*!*= == == == == == == == == == =\= == == == == = ! >OREADERR,,VDEinputreaderror,forcedtoexitk Facility:15kVDE,OpenVMS Development Environment Explanation:7Anerrorwasfoundinreadinganinput^line.UserAction:9Allcommandline informationisreadfromDRthelogical VDE$INPUT. Somethingis interferingwithRthereadingfromthefileordevicethatis specifiedbythisDlogicalname.' Determinewhere VDE$INPUTis pointing.K\Ifyoucannot determinewhatiscausingthe interference,-pleasesubmitaproblemreport. &BO REGRESSION,, operatinginmodesuitableforregres-(siontests Facility:15VDE,OpenVMS Development Environment^ Explanation:7^Thismessage indicatesthattheVDEim-MagehasdetectedarequesttoswitchintoamodesuitableIfor operationswithinaVDE regressiontestsuite.+ThisGhrequestcanbe initiatedonlybyauserwithOpenVMSF privileges,orbyaVDEimagelinkedwiththismodeenabled.UserAction:;ContactVDEsupportfor assistance,asthisI messageshouldnotbe displayedundernormal operations.  f!O REPACCEPT,- replacement replacementmarkedas (acceptedindatabase Facility:15VDE,OpenVMS Development Environment^ Explanation:5^ThismessageinformsyouthattheVDEGdatabasenowrecordsthatyouhaveacceptedtheindi-Icated replacement.(ThismessageisonlyissuedwhenyouAhusethe/LOG qualifierontheACCEPT REPLACEMENTcommand.\UserAction:5\Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage.j u@ O REPADDED,, replacement replacementaddedtothe(database Facility:15VDE,OpenVMS Development Environment^ Explanation:7^Thismessageinformsyouthattheindi-Hcated replacement definitionhasbeenaddedtotheVDEI database.)Thismessageisonlyissuedwhenyouusethe5h/LOG qualifierontheREPLACEcommand.UserAction:5Usethe/NOLOG qualifierforthecom->\mandifyoudonotwishtoseethemessage.'  ~"O REPBELUSER,, replacement replacementbelongsto(anotheruser Facility:15VDE,OpenVMS Development Environment^ Explanation:6^Youare attemptingtomodifyorcancelHaqueued replacementthatbelongstoanotheruser,andIyoudonothavethePERFREP privilegethatwouldallowIhyoutocancelormodifyanotheruser's replacements.(AsIaresult,the replacementisnot cancelledor modified.\UserAction:1\Reenterthecommand specifyingyourEownqueued replacementtocancelormodify,orelseF havesomeonewiththe necessary privilegeperformthee operation.= OREPCAN,- replacement replacement cancelledk Facility:15kVDE,OpenVMS Development Environment Explanation:5Thismessageinformsyouthatthein-D^dicated replacementhasbeen cancelled.+ThismessageIisonlyissuedwhenyouusethe/LOG qualifieronthe'CANCEL REPLACEMENTcommand.UserAction:5Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage.  dOREPDEL,, replacement replacement deletedfromthe(database Facility:15VDE,OpenVMS Development Environment^ Explanation:9^Thismessageinformsyouthatthedefini-Jtionforthe indicated replacementhasbeendeletedfromItheVDE database.(ThismessageisonlyissuedwhenyouAhusethe/LOG qualifierontheDELETE REPLACEMENTcommand.\UserAction:5\Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage.  C!O REPEXISTS,, replacement replacementalreadyexists;#( replacementnotchanged Facility:15VDE,OpenVMS Development Environment^ Explanation:0^The indicated replacementnamewasB specifiedonaREPLACEcommand,butanentryforEthat replacementisalreadypresentinthe database.JhHenceanewentrywasnotcreatedforthat replacement.GAlternatively,the indicatednamewas specifiedastheDnewnameforanexisting replacementontheMODIFY:r REPLACEMENTcommand,butanother replacementHalreadyhasthe requestednewname.'HencethenameofK#theexisting replacementcouldnotbechangedtothenew{name.UserAction:3Ifyouenteredthewrong replacementAoname,reenterthecommandwiththecorrectname.DIfyouenteredtheright replacementname,usethe6 SHOW REPLACEMENTcommandtodisplaytheFydatabase informationforthat replacement.+IfyouareDnot satisfiedwiththat information,usetheMODIFY/* REPLACEMENTcommandtochangeit. &O REPLACED,, generation. generationreplacedinto(stream(stream Facility:15VDE,OpenVMS Development Environment^ Explanation:5^Thismessageinformsyouthatthein-Ddicatedmodulehasbeenreplacedintothe indicatedG developmentstreaminthecurrentVDElibrary.*IthasIhalsobeenassignedthe indicated generationnumber.'ThisImessageisonlyissuedwhenyouusethe/LOG qualifier&withtheREPLACEcommand.UserAction:5Usethe/NOLOG qualifierforthecom-> mandifyoudonotwishtoseethemessage.  `OREPLQUE,,modulewmodule"queuedfor replacement( replacement Facility:15VDE,OpenVMS Development Environment^ Explanation:5^Thismessageinformsyouthatthein-Edicatedmodulehasbeenqueuedfor replacementasaGmemberofthenamed replacement.(ThismessageisonlyHhissuedwhenyouusethe/LOG qualifierontheREPLACEcommand.\UserAction:5\Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage. ! h0OREPMOD,, informationfor replacement replacement%(modifiedinthedatabase Facility:15VDE,OpenVMS Development Environment^ Explanation:5^Thismessageinformsyouthatinforma-Itionforthe indicated replacementhasbeenmodifiedinItheVDE database.(ThismessageisonlyissuedwhenyouAhusethe/LOG qualifierontheMODIFY REPLACEMENTcommand.\UserAction:5\Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage.  q  uG#O REPNOTFOUND,, replacementK replacementPnotfound+(in database; parameterignored Facility:15VDE,OpenVMS Development Environment^ Explanation:5^The indicated repalcementnamewasen-<teredonaSHOW REPLACEMENTcommand,butno@such replacementwasfoundintheVDE database.UserAction:;Thisisnot necessarilyanerror;themes-Ksagesimplytellsyouthatthe indicated replacementdoes(\notexistinthe database. /Y"O REPNOTPERF,, replacement replacementforstream(stream3 (not performed;doesnotmatchstreamstream Facility:15VDE,OpenVMS Development Environment Explanation:5Thismessageinformsyouthatthein-Bdicated replacementhasnotbeen performedbecauseIhitbelongstoastreamthatdoesnotmatchthestreamFnameyou specifiedwiththe/STREAM qualifiertothe7PERFORM REPLACEMENTcommand(oryourde-Jrfaultstream).(Thismessageisonlyissuedwhenyouuse=the/LOG qualifieronthePERFORM REPLACEMENT#command.UserAction:5Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage.? OREPPERF,, replacement; replacement? performedk Facility:15kVDE,OpenVMS Development Environment Explanation:5Thismessageinformsyouthatthein-D^dicated replacementhasbeen performed.)ThismessageIisonlyissuedwhenyouusethe/LOG qualifieronthe(PERFORM REPLACEMENTcommand.UserAction:5Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage.  f!O REPREJECT,, replacement replacementmarkedas (rejectedindatabase Facility:15VDE,OpenVMS Development Environment^ Explanation:5^ThismessageinformsyouthattheVDEGdatabasenowrecordsthatyouhaverejectedtheindi-Icated replacement.(ThismessageisonlyissuedwhenyouAhusethe/LOG qualifierontheREJECT REPLACEMENTcommand.\UserAction:5\Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage. 9O REPSYNTAX,-invalid replacementnamesyntax:(name Facility:15VDE,OpenVMS Development Environment^ Explanation:4^Thenameorformat specifiedforthe; replacementnameisnotusingvalidsyntax.RUserAction:2R Respecifythe replacementnameusingEonly alphanumeric, underscore,dollarsignandhyphen characters. )`;O REQQUAMIS,,requiredcommand qualifiermissingk Facility:15kVDE,OpenVMS Development Environment Explanation:.BoththeDEFINEandDELETEcom-E^mandsmusthavea qualifiertospecifythetypeofE definitionor deletion./Youmustuseeither/KEYor /COMMAND. ! /ORESDEL,, reservation reservation of moduleSforuser(user(hasbeendeleted Facility:15VDE,OpenVMS Development Environment^ Explanation:7^Thismessageinformsyouthattheindi-Jcated reservationhasbeendeletedfromtheVDEdatabaseEbecauseyou performedan operationthatchangedwhatMh generationisthelatest generationofthemoduleforsomeCstream.(Such operationsincludetheDELETE,INSERT,9andREMOVE GENERATION commands.+AftersuchEran operation,the reservationisbasedonthewrongL generationandcannolongerbereplacedintothestream.eUserAction:9eNone.(TheaffecteduserswillbeinformedIthattheir reservationsaredeleted.)Theyshouldreserve8themoduleagainandredotheirchanges.~  uTO RESERVED,- generation3 generationreservedfrom(stream(stream Facility:15VDE,OpenVMS Development Environment^ Explanation:7^Thismessageinformsyouthattheindi-Hcatedmoduleand generationhasbeenreservedfromtheGcurrentlibrary.*Thismessageisonlyissuedwhenyou?husethe/LOG qualifierontheRESERVEcommand.UserAction:5Usethe/NOLOG qualifierforthecom->\mandifyoudonotwishtoseethemessage.!   O RESERVSES,, generation] generationreservedfrom(stream(stream=(forsession(session Facility:15VDE,OpenVMS Development Environment^ Explanation:7^Thismessageinformsyouthattheindi-Hcatedmoduleand generationhasbeenreservedfromtheLVDElibraryandispartofthe indicated reservationses-Khsion.'Thismessageisonlyissuedwhenyouusethe/LOG/ qualifierontheRESERVEcommand.\UserAction:5\Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage." &AO RESIDREQ,, reservation identifierrequiredformod- (ulen(module Facility:15VDE,OpenVMS Development Environment^ Explanation:5^Youhavemultiple reservationsfortheF indicatedmodule.*Youmust thereforespecifyareser-Cvation identifierwiththe/IDENTIFICATION qualifierHhtouniquelyindicatetowhich reservationyouwantthecommandtoapply.\User Action:*\Reissue!the command!with theA/IDENTIFICATION qualifiertoindicatethespecificE  reservationtowhichyouwantthecommandtoapply.#  %O RESIDUSED,, reservationId ID"Yalreadyusedformod- (ulen(module3(attempttoreservemodulehasfailed Facility:15VDE,OpenVMS Development Environment^ Explanation:8^Youaretryingtoreserveamodulecon-K currentlyusingthesame reservationidentificationasyouGhaveusedonaprevious reservationofthesamemod-Ihuleinthesamestream developmentstream.)ThisisnotJallowed,since reservationidentificationsmustbeunique.\UserAction:.\ReissuetheRESERVEcommandwithGa different reservationidentification specifiedontheE /IDENTIFICATION qualifier.'Alternatively,youcanomitFethe/IDENTIFICATION qualifier,inwhichcaseVDEwill6assignauniqueidentificationforyou.$ ORESMOD,, reservation reservationformodulemodule (modifiedindatabase Facility:15VDE,OpenVMS Development Environment^ Explanation:5^Thismessageinformsyouthatthein-Hdicated reservationrecordforthe indicatedmodulehasJbeenmodifiedintheVDE database.(ThismessageisonlyGhissuedwhenyouusethe/LOG qualifierontheMODIFY RESERVATIONcommand.\UserAction:5\Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage. % ! ua/O RESQUEUED,, reservationrequestfor`modulequeued(forstream(stream Facility:15VDE,OpenVMS Development Environment^ Explanation:5^ThismessageinformsyouthatVDEhasKqueueda reservationrequestforthe indicatedmoduleandE developmentstream.*ThismessageisonlyissuedwhenDhyouusethe/LOG qualifierontheRESERVEcommand.UserAction:5Usethe/NOLOG qualifierforthecom->\mandifyoudonotwishtoseethemessage.& )g3O RETURNED,,controlreturnedtoprocessprocess-(name Facility:15VDE,OpenVMS Development Environment^ Explanation:1^After performingeitheraSPAWNorDATTACH operation,thismessagewillbe generatedtoEinformyouwhenyouhavereturnedtoVDE'sprocess.' ! /4O RIGIDNOTFOU,,requiredrights identifier (ID not%(foundinrightsdatabase Facility:15VDE,OpenVMS Development Environment^ Explanation:8^YouhavenotyetbeenaddedtotheVDEH database,andtobeaddedyoumustholdthe indicatedJVMSrights identifier.)However,thatrights identifierisOhnotpresentinthesystemrights database.'Asaresult,you;arenotallowedaccesstotheVDElibrary.\UserAction:7\HaveyoursystemmanageraddtherightsQ identifiertothesystemrightsdatabaseandassignittotheL userswhoshouldhaveaccesstotheVDElibrary,orhaveBetheVDElibrary maintainerusetheMODIFYLIBRARYJcommandspecifythecorrectrights identifierintheVDE database.(( ! ~=O RIGIDNOTHELD,-youdonotholdrequiredrights( identifier n(ID Facility:15VDE,OpenVMS Development Environment^ Explanation:8^YouhavenotyetbeenaddedtotheVDEH database,andtobeaddedyoumustholdthe indicatedFVMSrights identifier.,However,youdonotholdthatPhrights identifierinthesystemrights database.&Asaresult,@youarenotallowedaccesstotheVDElibrary.\UserAction:5\IfyoushouldhaveaccesstotheVDEFlibrary,haveyoursystemmanagerassignyouthein-F dicatedrights identifier.,Thentry accessingtheVDEelibraryagain.)  \=O ROLLBACK,,database transactionhasbeenrolled(back Facility:15VDE,OpenVMS Development Environment^ Explanation:6^Thedatabase transaction associatedwithEthecurrentcommandhasbeenrolledbackbecauseanAerroroccurredwhile processingthecommand.-ThisDhmeansthatallchangesthecommandwouldhavemadeJtothedatabaseif successfulhaveinfactbeenremovedfromthe database.UserAction:8Correcttheerrorandretrythecommand.*  k~0OSCRDONE,, completedwaitforscriptk Facility:15kVDE,OpenVMS Development Environment Explanation:5ThismessageinformsyouthatVDEhas-^ completedawaitforascript.UserAction::ContactVDEsupportfor assistance,astheARversionofVDEinusecontains debuggingimages. + ! mandifyoudonotwishtoseethemessage.. ! >OSCRPCMDTOOLONG,,scriptcommandistoolong;it(exceeds3(count(( characters Facility:15VDE,OpenVMS Development Environment^ Explanation:6^YouhaveenteredascriptcommandthatListoolongforVDE'sinternalscriptcommandbuffer.'TheHmessage indicatesthemaximumsizeofthisbuffer.)TheOhtotallengthofthescriptcommandincludestheinitialline;forthecommandandall continuationlines.\UserAction:8\Changethescriptcommandsothatitisnotsolong.x/  N@OSCRPDEL,-scriptdeletedfromthedatabasescript(script Facility:15VDE,OpenVMS Development Environment^ Explanation:7^Thismessageinformsyouthattheindi-LcatedscriptforthecurrentstreamhasbeendeletedfromDtheVDE database.-ThismessageisonlyissuedwhenAhyouusethe/LOG qualifierontheDELETESCRIPTcommand.\UserAction:5\Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage.0 u`0O SCRPEXTR,,script extractedtofile filescriptscriptk Facility:15kVDE,OpenVMS Development Environment Explanation:7Thismessageinformsyouthattheindi-G^catedscripthasbeen extractedfromtheVDEdatabaseLintothe indicatedfile.)ThismessageisonlyissuedwhenByouusethe/LOG qualifierontheEXTRACTSCRIPThcommand.UserAction:5Usethe/NOLOG qualifierforthecom->\mandifyoudonotwishtoseethemessage. 1  &-O SCRPFACFAIL,,scriptforfacilityfacility terminated(witherrors Facility:15VDE,OpenVMS Development Environment^ Explanation:<^Thescriptforthe indicatedfacilitytermi-Fnatedwitherrorswhenexecutedforthecurrentcom-Gmand.)Thetypeofthescriptdependsonthecommand.@hFortheCREATESTREAMcommand,forexample,theE new-streamscriptisinvokedtoperformpartofthestream creation.UserAction:<Correcttheerrorinthescriptandreenter thecommand.2 9O SCRPFILE,,scriptproducedDCLcommandfilefile(script(script Facility:15VDE,OpenVMS Development Environment^ Explanation:5^Thismessageinformsyouthatthein-DdicatedscripthasbeeninvokedtoproducetheDCLHcommandfilewhosenameisgiveninthemessage.(ThisIhmessageisonlyissuedwhenyouusethe/LOG qualifier+ontheINVOKESCRIPTcommand.\UserAction:5\Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage.)3 ! ~*OSCRPFUNCUNDEF,-scriptfunctionfunctionaisunde-)(finedinthecurrentscript Facility:15VDE,OpenVMS Development Environment^ Explanation:=^The indicatedscriptfunctionisusedintheL currently executingscript,butis undefinedforthistypeQofscript.'ThismeansthatthefunctionisnotallowedtobeIhusedinthistypeofscript.)The module-name functions,Iforexample,are undefinedinscriptsinvokedatstreamNcreationbecausethesescriptsarenotappliedto individualrmodules. UserAction:9 Donotusethe indicatedfunctionintheescript.4  :OSCRPMOD,-script informationmodifiedinthe(databasescript](script Facility:15VDE,OpenVMS Development Environment^ Explanation:5^Thismessageinformsyouthatinforma-Ntionforthe indicatedscripthasbeenmodifiedintheVDEJ database.)Themodified attributesonlyapplytothecur-Hhrentstream.*ThismessageisonlyissuedwhenyouuseAthe/LOG qualifierontheMODIFYSCRIPTcommand.\UserAction:5\Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage.55  u O SCRPMODFAIL, scriptscriptformodulemodule"( terminatedwitherrors Facility:15VDE,OpenVMS Development Environment^ Explanation:8^Thescriptforthe indicatedmoduleter-BminatedwitherrorswhenexecutedforthecurrentFcommand./Thetypeofthescriptis specifiedinthehmessage.UserAction:<Correcttheerrorinthescriptandreenter\thecommand.m6 uCO SCRPUSED,-script`striptDwasusedk Facility:15kVDE,OpenVMS Development Environment Explanation:5Thismessageinformsyouthatthein-I^dicatedscriptwasusedtogenerateonesegmentoftheDcurrentDCLcommandfile.,Thismessageisonlyis-Esuedwhenyouusethe/LOG qualifierontheINVOKEhSCRIPTcommand.UserAction:5Usethe/NOLOG qualifierforthecom->\mandifyoudonotwishtoseethemessage.7 >O SCRQUOERR,,noclosing quotationmarkinscript( command:!/ (cmd Facility:15VDE,OpenVMS Development Environment^ Explanation:8^VDEhasdetectedamissingquoteintheE specifiedcommandforthescript.*Thescriptcommand8mustbe respecifiedusingcorrectsyntax.UserAction:5Thescriptcommandmustbe respecified!usingcorrectsyntax.8  k1OSCRWAIT,, commencingwaitforscriptk Facility:15kVDE,OpenVMS Development Environment Explanation:4ThismessageinformsyouthatVDEis9^ commencingawait operationforascript.UserAction::ContactVDEsupportfor assistance,astheARversionofVDEinusecontains debuggingimages.9  =OSCTCONF,,SCTnote conferencenull;modulenot(replaced Facility:15VDE,OpenVMS Development Environment^ Explanation:5^TherequiredSCTnotes conferencenameBfieldwasfoundemptyona replacement operation.RUserAction:6RPleasereentertheSCTnotes conferenceEnameusingcorrectsyntax,andretrythe replacement operation.: OSCTFCMT,-SCTfoldcomment required;modulenot(replaced Facility:15VDE,OpenVMS Development Environment^ Explanation:7^TherequiredSCTfoldcommentfieldwas6foundemptyona replacement operation.RUserAction:8REnteranSCTfoldcommentandretrythe! replacement operation.\< ! u28OSCTFNF,,unabletolocatenotes conferenceeconfnamek Facility:15kVDE,OpenVMS Development Environment Explanation:9VDEwasunabletoopenthe specifiedSCT^notes conferenceUserAction:6PleasereentertheSCTnotes conferenceCRnameusingthecorrectnameandsyntax,andretryJthe operation.+Ifthe conferenceismissing,contacttheKprojectleader,thesystem manager(s),orVDEsupportfor\ assistance.0 = >OSCTNOTE,,SCTnotenumbernull;modulenotre-(placed Facility:15VDE,OpenVMS Development Environment^ Explanation:6^TherequiredSCTnotenumberfieldwas6foundemptyona replacement operation.RUserAction:6REnterthenumberofthe associatedSCTEnoteusingcorrectsyntax,andretrythe replacement operation.>  >O SCTNOTESYN,,SCTnotenumbersyntaxerror;mod-(ulenotreplaced Facility:15VDE,OpenVMS Development Environment^ Explanation:7^VDEdetectedasyntaxerrorintheSCTnotenumberfield.RUserAction:8RPleasereentertheSCTnotenumberusingDcorrectsyntax,andretrythe replacement operation.a? k7/O SECMERFAI,, secondarymergefailurek Facility:15kVDE,OpenVMS Development Environment Explanation:2internalstate informationforVDE$_^ INVDIRSPECerror.UserAction:-Correct the cause of the VDE$_R INVDIRSPECerror.@  ~;O SEECONLIB,,seetheVDECONVERTLIBRARYcom-(mand Facility:15VDE,OpenVMS Development Environment^ Explanation:2^TheVDEdatabasedoesnothavetheCproperformat,andthe automatic conversionofthe;databasehasbeen disabled.0TheVDECONVERTEhLIBRARYcommandcanbeusedtoforcethe conversion$ofthedatabaseformat.\UserAction::\IfuseofthenewversionofVDEisin-Ktended,performafulllibrarybackupusingthe database-E providedbackuptools,andthenusetheVDECONVERT>eLIBRARYcommandtoupdatethedatabaseformat.VA ,O SESADDED,-sessionsession"addedtothedatabasek Facility:15kVDE,OpenVMS Development Environment Explanation:5Thismessageinformsyouthatthein-F^dicatedsession definitionhasbeenaddedtotheVDEI database.)Thismessageisonlyissuedwhenyouusethe5/LOG qualifierontheREPLACEcommand.UserAction:5Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage.B ! &O SESBELUSER,,sessionsession$1belongstoanotheruserk Facility:15kVDE,OpenVMS Development Environment Explanation:9Youare attemptingtomodifyorcancelaK^ reservationsessionthatbelongstoanotheruser,andyouIdonothavethePERFREP privilegethatwouldallowyouPtocancelormodifyanotheruser'ssession.'Asaresult,the4hsessionisnot cancelledor modified.UserAction:1Reenterthecommand specifyingyourF\own reservationsessiontocancelormodify,orelseFhavesomeonewiththe necessary privilegeperformthe  operation.-C OSESCAN,,session session_ cancelledk Facility:15kVDE,OpenVMS Development Environment Explanation:5Thismessageinformsyouthatthein-J^dicatedsessionhasbeen cancelled.)ThismessageisonlyGissuedwhenyouusethe/LOG qualifierontheCANCELSESSIONcommand.UserAction:5Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage.D ! O SESEXISTS,-sessionsessionalready existsin*( database;sessionnotchanged Facility:15VDE,OpenVMS Development Environment^ Explanation:7^The indicatedsessionnamewas specifiedJonaREPLACEcommand,butanentryforthatsessionisIalreadypresentinthe database.(HenceanewentrywasKhnotcreatedforthatsession.)Alternatively,the indicatedKnamewas specifiedasthenewnameforanexistingses-@sionontheMODIFYSESSIONcommand,butanotherGrsessionalreadyhasthe requestednewname.)HencetheLnameoftheexistingsessioncouldnotbechangedtothe#newname.UserAction:6Ifyouenteredthewrongsessionname,Hreenterthecommandwiththecorrectname.(Ifyouen-Doteredtherightsessionname,usetheSHOWSESSIONEcommandtodisplaythedatabase informationforthatO session.'Ifyouarenot satisfiedwiththat information,use8ytheMODIFYSESSIONcommandtochangeit.E  uX,OSESMOD,, informationforsessionsessionmodifiedin(thedatabase Facility:15VDE,OpenVMS Development Environment^ Explanation:5^Thismessageinformsyouthatinforma-Jtionforthe indicatedsessionhasbeenmodifiedintheIVDE database.'ThismessageisonlyissuedwhenyouuseBhthe/LOG qualifierontheMODIFYSESSIONcommand.UserAction:5Usethe/NOLOG qualifierforthecom->\mandifyoudonotwishtoseethemessage.oF ! EO SESNOMODS,-sessionsession/containsnomodule( reservations Facility:15VDE,OpenVMS Development Environment^ Explanation:8^Thismessageinformsyouthatthereser-Ivationsessionyouare replacingor unreservingcontainsHnomodule reservations.'ThecommanddeletedthesessionJhfromtheVDE database,butdidnotreplaceor unreserveanymodules.\UserAction:9\IfyoumeanttoreplacemodulesyouhaveJalready reserved,replacethem individually.'Alternatively,A usetheRESERVEcommandtocreateanewsessionIethatcontains reservationsforthedesiredmodules.(Then;changethemodulesandreplacethesession.VG  u,O SESNOTFOUND,-session`sessionnotfoundin'( database; parameterignored Facility:15VDE,OpenVMS Development Environment^ Explanation:5^The indicatedsessionnamewasenteredEonaSHOWSESSIONcommand,butnosuchsessionwas(foundintheVDE database.UserAction:;Thisisnot necessarilyanerror;themes-Lsagesimplytellsyouthatthe indicatedsessiondoesnot#\existinthe database.GH OSESTERM,,sessionesession terminatedk Facility:15kVDE,OpenVMS Development Environment Explanation:7Thismessageinformsyouthattheindi-I^catedsessionhasbeen terminated.)ThismessageisonlyFissuedwhenyouusethe/SESSIONand/LOG qualifiers3ontheREPLACEor UNRESERVEcommand.UserAction:5Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage.n I k4OSETKEY,,keypadstatehasbeensetto state-namek Facility:15kVDE,OpenVMS Development Environment Explanation:7FortheSETKEY operation,thisinforms.^theuserthatthekeywasset.UserAction:=Ifyoudowishtoseethis information,use=Rthe/NOLOG qualifierontheSETKEYcommand..J  >O SETKEYERR,,errorin processingSETKEYcommandk Facility:15kVDE,OpenVMS Development Environment Explanation:9Thescreen managementfacilityisusedtoD^maintainscreen bindings.)Inthis instance,SMG$SET_2 DEFAULT_STATEhasreturnedanerror.RUserAction:5RSeeSMG documentationto determinetheIproblem.)Ifyouranswercannotbefound,pleasecontact(VDEsupportfor assistance.K ! [7OSETLIB,,useSETLIBRARY, VDE$LIBRARY,or./LIBRARY Facility:15VDE,OpenVMS Development Environmentd Explanation:;dVDEisunabletoperformthe specifiedop-HerationasthetargetVDE library-thelibraryonwhichJthe operationwillbe performed-hasnotbeen established.UserAction:9SpecifythetargetVDElibrary.(Todeter-Fminethe available libraries,issuethe"SETLIBRARY"Bacommandwithno parameters.-AspartoftheerrorEmessage,thiscommandwilldisplaythenamesoftheL predefinedVDE libraries,theRdbroot directoryforeach,Dkandthemnemonicnameforeach.(Oncethe mnemnonicJnameortheRdbroot directorynameforthetargetli-Ebraryisknown,onecan:*A)usethe mnemnonicnameGtortheRdbroot directorynameasthelibnameparam-Aeterona"SETLIBRARYlibname"VDEcommand.*B)G%Useusethe mnemnonicnameortheRdbroot directoryC~nameasthe parameterontheVDE/LIBRARY=libname.HC)Definethelogicalname VDE$LIBRARYto translatetoF/theVDE mnemnonicnameortotheRdbroot directoryname.L ! /yAO SETUNAUTH,,attempttoset unauthorized privileges;( privilegesnotset Facility:15VDE,OpenVMS Development Environment^ Explanation:1^Youhave attemptedtousetheSETA PRIVILEGEScommandtograntyourselfoneormoreM privilegesthatyouarenot authorizedtoset accordingtohtheVDE database.UserAction:/UsetheSHOWPRIVILEGES/FULLcom-I\mandtoseewhat privilegesyouare authorizedtoset.EThenreentertheSET PRIVILEGEScommandtosetonlyI  authorized privileges.)Alternatively,asktheprojectad-Ne ministratortograntyou authorizationtosetthe privilegesJyouwant.'ThenexitfromVDE,startanewVDEsession,/andsetthe privilegesyouwant.6M  u mandifyoudonotwishtoseethemessage.b  ~O STRMCLOSED,,streamstream"Pis permanentlyclosed;(statenotchanged Facility:15VDE,OpenVMS Development Environment^ Explanation:6^Youhavetriedtochangethestateof>astream developmentstreamwiththe/OPENor;/FROZEN qualifierontheMODIFYSTREAMcom-Dhmandwhenthestreamisalreadyinthe permanentlyLclosedstate.*Therestofthecommandstilltakeseffect,Jbutthestreamstateisnotchanged;thestreamremainsrclosed. UserAction:6 Nouseractionis necessary;thestateGecannotbechangedandthecommanddidnotchangeit.kc  AOSTRMDEL,,streamkstream&deletedfromthedatabasek Facility:15kVDE,OpenVMS Development Environment Explanation:7Thismessageinformsyouthatthedefi-L^nitionforthe indicatedstreamhasbeendeletedfromtheIVDE database.'ThismessageisonlyissuedwhenyouuseAthe/LOG qualifierontheDELETESTREAMcommand.UserAction:5Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage.d  O STRMEXISTS,,streamstream>alreadyexistsin(database Facility:15VDE,OpenVMS Development Environment^ Explanation:3^The indicatedstreamnamewasspeci-DfiedonaCREATESTREAMcommand,butanentryforJthatstreamisalreadypresentinthe database.)HenceaKhnewentrywasnotcreatedforthatstream.'Alternatively,Gthe indicatednamewas specifiedasthenewnamefor=anexistingstreamontheMODIFYSTREAMcom-Hrmand,butanotherstreamalreadyhasthe requestednewHname.)Hencethenameoftheexistingstreamcouldnot*#bechangedtothenewname.UserAction:5Ifyouenteredthewrongstreamname,Hreenterthecommandwiththecorrectname.(Ifyouen-Boteredtherightstreamname,usetheSHOWSTREAMEcommandtodisplaythedatabase informationforthatN stream.'Ifyouarenot satisfiedwiththat information,use7ytheMODIFYSTREAMcommandtochangeit.e  uU,OSTRMMOD,, informationforstreamstreamPmodified(inthedatabase Facility:15VDE,OpenVMS Development Environment^ Explanation:5^Thismessageinformsyouthatinforma-Itionforthe indicatedstreamhasbeenmodifiedintheIVDE database.'ThismessageisonlyissuedwhenyouuseAhthe/LOG qualifierontheMODIFYSTREAMcommand.UserAction:5Usethe/NOLOG qualifierforthecom->\mandifyoudonotwishtoseethemessage.5f    OSTRMNOTCLOSED,-streamstreamcannotbe/(deletedbecauseitisnotclosed Facility:15VDE,OpenVMS Development Environment^ Explanation:<^YouaretryingtodeleteastreamwhichisOinanopenorfrozenstate.(Onlystreamsinaclosedstatemaybedeleted.UserAction:7If appropriate,changethestateoftheHstreamtoclosedandrepeatthedeletestreamcommand.ag ! u7O STRMNOTDEL,-stream%streamZnotdeletedk Facility:15kVDE,OpenVMS Development Environment Explanation:;Youare attemptingtodeleteastreamthatH^cannotbedeleted.) Additionalmessagesarenormallyin-Fcludedwiththismessage,andthesemessagesindicate0whythestreancannotbedeleted.UserAction:4Resolvethe problem(s)flaggedbytheDothererror messages,andreentertheDELETESTREAM\command.Qh ! u'O STRMNOTFOUND,,streamstreamnotfoundin'( database; parameterignored Facility:15VDE,OpenVMS Development Environment^ Explanation:4^The indicatedstreamnamewasenteredConaSHOWSTREAMcommand,butnosuchstreamwas(foundintheVDE database.UserAction:;Thisisnot necessarilyanerror;themes-Ksagesimplytellsyouthatthe indicatedstreamdoesnot#\existinthe database.i  O STRMNOTOPEN,-streamfstream isnotopen;opera-(tionnotallowed Facility:15VDE,OpenVMS Development Environment^ Explanation:7^YouaretryingtoreserveorreplaceaHmodule,butthe currentlyactivestream(whosenameisQgiveninthemessage)iseitherfrozenorclosed.(ItisthusIhnotopenforthe reservationor replacementofmodules.UserAction:/YoucanusetheSHOW STREAM/FULLK\commandtoseethestatusofthecurrentstream.)IftheKstreamisclosed,itis permanently protectedagainstbe-K ingchanged,andyoushouldnotbetryingtoreserveorOereplacemodulesinit.)Ifthestreamisfrozen,itiscur-Hrently protectedagainstbeingchanged,butchangesmayJbeallowedlaterwhenthelibrary administratorsetstheKostatebacktoopen.)YoumustthenwaituntilthestreamFbecomesopen.)(YoumayreservemodulesfromafrozenJ stream,butnotreplacethem.)*Finally,ifyoumeanttoJyreserveorreplacemodulesinanotherstream,youshouldCusetheSETSTREAMcommandtoswitchyourcontextI*tothatstreamandthenreserveorreplacethedesiredmodules.Pj ~&O STRMNOTPOP,-stream'stream"]isnotallowedtobe( populated Facility:15VDE,OpenVMS Development Environment^ Explanation:8^Youare attemptingtopopulatetheindi-=catedstreamwiththePOPULATESTREAMcommandKbutastream attribute disallowsuseofthiscommandforFhthestream.'Hencethestreamhasnotbeen populated.UserAction:9Eitheryoushouldnotbetryingtopopu-M\latethestreamorelseyoumustsetthestream attributeHthatallowsyoutopopulatethestreambeforeretryingI the operation.(Tosetthat attribute,usethe /POPULATE6e qualifiertotheMODIFYSTREAMcommand.k fOSTRMPOP,,streammstream! populatedfromstream(stream Facility:15VDE,OpenVMS Development Environment^ Explanation:7^Thismessageinformsyouthattheindi-Ecatedstreamhasbeen populatedwithall generationsBfromthesecond indicatedstream./ThismessageisEhonlyissuedwhenyouusethe/LOG qualifieronthe$POPULATESTREAMcommand.\UserAction:5\Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage.l  :O STRMPOPCOUNT,,populatemodulecounts:)update(count(,insert(count(,remove1(count Facility:15VDE,OpenVMS Development Environment^ Explanation:4^Thismessagetellsyouhowmanymod-Guleswereupdatedin,insertedinto,andremovedfromAthetargetstreambythecurrentPOPULATESTREAMHhcommand.(Thismessageisonlyissuedwhenyouusethe>/LOG qualifieronthePOPULATESTREAMcommand.\UserAction:5\Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage.d 2m ! CO STRTOOLONG,-quotedstringtoolong;mustbeshort-(ened Facility:15VDE,OpenVMS Development Environment^ Explanation:/^ThemaximumlengthofthequotedMstringis determinedbythenatureofthestring.(FortheFDEFINEcommand,thestringislimitedto255charac-Mhters.'Forremarkstrings,itislimitedto132 characters.UserAction:7Trytoshortenthesizeofthestring.n  V 2O SUCGENEXIST,- successor generationformodule&(alreadyexistsinlibrary Facility:15VDE,OpenVMS Development Environment^ Explanation:8^Thenew generationofthe indicatedmod->ulecreatedbythecurrentREPLACEorPERFORM< REPLACEMENTcommandshouldgeta whole-numberAhCMS generation expressionbutthereservedgener-Eationalreadyhasa successor generationintheVDEAlibrarywiththat whole-numberCMS generationex-Lr pression.)This situationcanariseifyouhaveplacedtheCreserved generationintoastreamusingtheINSERT9# GENERATIONcommandorifyouhavechangedC{thestreamthat``owns''the whole-number successorA generationwiththe /MAIN_STREAM qualifiertothe&-MODIFY GENERATIONcommand.UserAction:4Iftheexisting whole-number successorN  generationshouldnotbeintheVDElibrary,deleteitand>yits successorswiththeDELETE GENERATIONcom-Dmand.*Thenrepeatthefailed replacement.* Otherwise,<*usethe /MAIN_STREAM qualifiertotheMODIFY? GENERATIONcommandtoallocate ownershipoftheD whole-number successor generationtothestreamthatK3 alreadyownsthat generation,butnottoanystreamintoH whichyouaretryingtoreplacethemodule.+ThiswillJ forcethe replacementtouseaCMSvariantletter.(Then#= repeatthe replacement.(o 3O SUCLNKADD,- successorlinkfromstreamstream Nto(stream(stream=(added Facility:15VDE,OpenVMS Development Environment^ Explanation:5^The successorstream relationship,fromLthefirststream specifiedtothesecondstream specified,hasbeenadded.UserAction:5Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage.,p 3O SUCLNKREM,, successorlinkfromstreamstream Sto(stream(stream=(removed Facility:15VDE,OpenVMS Development Environment^ Explanation:5^The successorstream relationship,fromLthefirststream specifiedtothesecondstream specified,hasbeenremoved.UserAction:5Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage.q  k;OSYNTAX,,commandsyntaxerroratornear:''text 'k Facility:15kVDE,OpenVMS Development Environment Explanation:8AllcommandshaveaspecificsyntaxthatR^mustbe followed.&Failuretodosowillresultinthiserror.UserAction:6SeeVDE ReferenceManualfor assistance%Rwiththecommandsyntax. r  ;O TOOMANPARM,,toomany poundsign parametersin8(historyornotes stringinvalidstringis:(string Facility:15VDE,OpenVMS Development Environment^ Explanation::^Thehistoryornotesstring specifiedcon-Jtainsmorethanonehistoryornotes parameter.)Thisisnotallowed.UserAction:8Reenterthecommandwithavalidhistoryornotesstring. s 6O TRANTOODEEP,- translationoflogicalnamelogical(morethan7deep Facility:15VDE,OpenVMS Development Environment^ Explanation:8^The indicatedlogicalnameiseithertooLdeeplynested,orisdefined incorrectlytopointbackto;itselfcausinganinfinite translationloop.UserAction:4Reenterthecommandwithoutusingthelogicalname.Rt ! ~(>OUIDSKEW,,possibleUIDskew detected;checkfor(correctUIDfile. Facility:15VDE,OpenVMS Development Environment^ Explanation:5^VDEhasdetectedaninternal inconsis-&tencywiththeUIDfile.RUserAction:8RPlease determineiftheUIDfileassoci-QatedwiththeVDE distributionistheversioninuse.&IftheOUIDfileistheone associatedwiththe distribution,pleaseG\contactcontactVDEsupportfor assistance.*Pleasein-Jcludeany informationthatmaybeusefulorreleventinN  duplicatingtheproblem.'Ifthereisaskewcode associatedJewiththiserror,pleaseincludeitintheerrorreport.Zu ! 0'O UIDSKEWCODE,,UIDskewcodevaluek Facility:15kVDE,OpenVMS Development Environment Explanation:=Thisisthecodeforthe particularinternal:^ inconsistencydetectedwithintheUIDfile.UserAction:8Please determineiftheUIDfileassoci-QRatedwiththeVDE distributionistheversioninuse.&IftheOUIDfileistheone associatedwiththe distribution,please:contactcontactVDEsupportfor assistance.v -O UNACLOFIL,,unabletoclosefile file-namek Facility:15kVDE,OpenVMS Development Environment Explanation:6AnerroroccurredwhentryingtocloseH^the indicatedtextfile.,Amorespecificerrormessage!followsthismessage.RUserAction:5RExaminetheerrormessagethatfollowsItodiagnosethereasonfortheerror.+Thencorrecttheproblem accordingly.w  2O UNACLOLOG,-unabletocloselogfileb file-namek Facility:15kVDE,OpenVMS Development Environment Explanation:3The SYS$CLOSEsystemservicewasnot?^ performed successfullyinclosingthelogfile.UserAction:5 Determinewhatcouldbe preventingRMSNRfromclosingthefile successfully.(IfthereasoncannotbeF determined,pleasecontactVDEsupportfor assistance.Jx  u 4O UNACONLOG,,unabletoconnectlogfile file-namek Facility:15kVDE,OpenVMS Development Environment Explanation:0The SYS$CONNECTsystemservicewasH^not performed successfullyin connectingthelogfile'sRABandFAB.RUserAction:5R Determinewhatcouldbe preventingRMSEfrom connectingthefile'sFABandRAB successfully.IIfthiscannotbedone,pleasecontactVDEsupportfor\ assistance.N dy ! :7OUNACONVDBFORM,,unabletoconvertdatabase@(formatduetoaccessconflictwithanotheruser Facility:15VDE,OpenVMS Development Environment^ Explanation:8^TheVDEdatabasedoesnothavethefor-JmatrequiredbythecurrentversionofVDEandVDEhasK attemptedtoconvertthedatabasetotherequiredformat.IhThis operationhasfailedbecauseofanaccessconflictIwithanotheruser attemptingtoconvertthedatabaseatKthesametime.'Thatotheruserhasprobably succeededinIr convertingthedatabaseformat,whichiswhyyoucannotdoso.eUserAction:/eRetrytheCONVERTLIBRARYcommandGandtry accessingthedatabaseagain.+YoushouldfindKthatyouarenowabletoconvertthedatabaseformatorIothattheformathasalreadybeen converted.(Eitherway,DyoushouldbeabletouseVDEwiththat database.z  .O UNACREFIL,,unabletocreatefile file-namek Facility:15kVDE,OpenVMS Development Environment Explanation:5Anerroroccurredwhentryingtocre-O^ateoropenanewtextfile.'Amorespecificerrormessage!followsthismessage.RUserAction:5RExaminetheerrormessagethatfollowsItodiagnosethereasonfortheerror.+Thencorrecttheproblem accordingly."{  3O UNACRELOG,-unabletocreatelogfile file-namek Facility:15kVDE,OpenVMS Development Environment Explanation:4The SYS$CREATEsystemservicewasnotC^ performed successfullyincreatingtheoutputfile.UserAction:5 Determinewhatcouldbe preventingRMSKRfromcreatingthefile successfully.)IfthereasoncannotJbe determined,pleasecontactVDEsupportfor assistance./| is undefinedk Facility:15kVDE,OpenVMS Development Environment Explanation:1ThismessageinformstheuserthatC^thekeywas undefinedbyeitherthe DELETE/KEYor! UNDEFINE/KEY commands.RUserAction:5RUsethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage.  /8O UNKCOMSTA,-unknown completionstatusvalue(status(passedto VDESTATUS Facility:15VDE,OpenVMS Development Environment^ Explanation:7^ThismessageinformsyouthattheimageF VDESTATUS,waspassedastatusvalueitdidnotun-E derstand.( VDESTATUSis expectingthe characterstringBh "SUCCESS"orthe characterstring "FAILURE"tobeMpassedtoitforits parameter.(Anyother characterstring;resultsinthiserrormessagebeingoutput.UserAction:4Checkthe invocationofthe VDESTATUSC image.) Typically, VDESTATUSisinvokedfromacom-Hemandfilethatisbuiltbytheprogram VDEDOBUILDforErunning buildsteps.*Checkthecommandfile associatedBwiththe buildstepthatresultedinthismessage. ! OUNKEPT,,unabletoopnam'tokept subprocesssectionk Facility:15kVDE,OpenVMS Development Environment Explanation:6VDEhas encounteredanerrorwhileat-O^temptingtocreateorconnecttotheglobalsectionusedto3 communicatewiththekept subprocess.RUserAction:7RAttempttoresolvetheproblembasedonHanyothererrormessagesincludedwiththisone,checkEthe documentationfor informationonsettinguppro-E\cessandsystemquotas,andcontactVDEsupportfor assistance.;    +OUNKEYW,, unrecognizedkeyword'textT'-checkvalidity(andspelling Facility:15VDE,OpenVMS Development Environment^ Explanation:2^Thekeywordprovidedinthecommand/was unrecognizedinthiscontext.RUserAction:6RSeeVDE ReferenceManualfor assistance%withthecommandsyntax. \CO UNKFILEXT,-Unknownfile extensioninanalysisfile;6(thecompletefilespecificationfoundwase(spec Facility:15VDE,OpenVMS Development Environment^ Explanation:.^Theprogram VDEDEPEND encounteredNafile specificationthathasafile extensionitdoesnot@support.*Thiserroroccurredwhile VDEDEPENDwasIh processingananalysis(.ANA)file recordingcompileror- assembler dependency information.\UserAction:<\ Determineiftheanalysisfileis corrupted.MIftheanalysisfileisnot corruptedandthefileexten-N sion correspondstoafiletypethatshouldberecordedasFe dependency information,pleasecontactVDEsupportfor assistance.  &/OUNKPNAM,,unabletolocateprojectCprojnam in(stream( streamnam Facility:15VDE,OpenVMS Development Environment^ Explanation:6^VDEhasunabletolocatethe specifiedBprojectname associatedwiththe specifiedstream.RUserAction:3RSpecifyavalidandcorrectly-spelledLprojectnamefromthe availablelistofprojects assocatedLwiththestream.)IfyoubelievethatthereshouldbeoneH\ormore additionalprojects associatedwiththestream,Jpleasecontacttheprojectleader,thesystem manager(s),, orVDEsupportfor assistance.C  8OUNKPROJ,,unabletolocateaprojectnamek Facility:15kVDE,OpenVMS Development Environment Explanation:1VDEhas encounteredanerrorwhile1^usingthenotescallable interface.UserAction:7AttempttoresolvetheproblembasedonHRanyothererrormessagesincludedwiththisone,checkKthe documentationfor informationonsettingupthenotesD conferences,andcontactVDEsupportfor assistance.  2O UNKQARCLD,,internalVDEcodingerrork Facility:15kVDE,OpenVMS Development Environment Explanation:5VDEhasdetectedaninternal inconsis-^tency.UserAction:9PleasecontactVDEsupportfor assistance.FRPleaseincludeany informationthatmaybeusefulor2releventin duplicatingtheproblem. ! k1O UNLOCKED,, overridinglibrarylockoutk Facility:15kVDE,OpenVMS Development Environment Explanation:8Thismessageis displayedwhenuserwithI^MODLIB privilegereplacesamoduleinalockedlibrary.UserAction:;Evaluateifthe replacementis necessaryinGRthelockedlibrary;unlockthelibraryif appropriate.C  u=O UNMATQUO,- unmatchedquoteormissingquoteat(endofstring Facility:15VDE,OpenVMS Development Environment^ Explanation:=^Anytokenthatistobe delimitedbyquotesMmusthavequotesonbothsidesofthetoken.'ThesequotesImaybeeithersingleordouble;however,the delimiters*hmustbethesame characters.UserAction:5Reenterthecommandwiththe appropri- \atequotes balanced. l/O UNRESERVED,- reservationformodulemodulecan-(celled Facility:15VDE,OpenVMS Development Environment^ Explanation:5^Thismessageinformsyouthatthein-Bdicatedmodulehasbeen unreservedinthecurrentHlibraryandis thereforenolonger reserved.+Thismes-Jhsageisonlyissuedwhenyouusethe/LOG qualifieron"the UNRESERVEcommand.\UserAction:5\Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage.  6O USEDELMOD,-to unreserveaCREATEMODULE+( reservation,useDELETEMODULE Facility:15VDE,OpenVMS Development Environment^ Explanation:/^An erroneousattemptwasmadeto> UNRESERVEa just-createdmodule.-TocanceltheAmodule reservationandthemodulecreationcaused;hbyaCREATEMODULEcommand,usetheDELETE6MODULEcommand.,AftertheDELETEMODULEKcommandis accepted,themodulewillnotbecreated,theHr outstandingmodule reservationwillbe canceled,andno.furtheruseractionis required.eUserAction:<eIfyouwishtocancelthis reservation,use?theDELETEMODULEcommand.)Thismessageisin-D formational,andshould accompanyoneormoreotheroerror messages.G O USERADDED,,useruuser"?addedtothedatabasek Facility:15kVDE,OpenVMS Development Environment Explanation:5Thismessageinformsyouthatthein-H^dicateduserhasbeenaddedtotheVDE database.+ThisImessageisonlyissuedwhenyouusethe/LOG qualifier)ontheCREATEUSERcommand.UserAction:5Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage.M  #OUSERDEL,,useruser&deletedfromthedatabasek Facility:15kVDE,OpenVMS Development Environment Explanation:7Thismessageinformsyouthattheindi-J^cateduserhasbeendeletedfromtheVDE database.(ThisImessageisonlyissuedwhenyouusethe/LOG qualifier)ontheDELETEUSERcommand.UserAction:5Usethe/NOLOG qualifierforthecom->mandifyoudonotwishtoseethemessage. ! O USEREXISTS,,useruser(Ralreadyexistsin database;(usernotchanged Facility:15VDE,OpenVMS Development Environment^ Explanation:6^The indicatedusernamewas specifiedonDaCREATEUSERcommand,butanentryforthatuserHisalreadypresentinthe database.*HenceanewentryMhwasnotcreatedforthatuser.'Alternatively,the indicatedHusernamewas specifiedasthenewusernameforanex-EistinguserontheMODIFYUSERcommand,butanotherHruseralreadyhasthe requestednew username.'HencetheMusernameoftheexistingusercouldnotbechangedtothe#new username.UserAction:8Ifyouenteredthewrong username,reen-Cterthecommandwiththecorrect username.-IfyouDoenteredtheright username,usetheSHOWUSERcom-Imandtodisplaythedatabase informationforthatuser.J Ifyouarenot satisfiedwiththat information,usethe0yMODIFYUSERcommandtochangeit.})gINDEXINDEX!i  iAA9S8 AbbreviationsAbbreviations-SN8usingusing(]S&&8ACCEPT REPLACEMENTcommandACCEPT REPLACEMENT commandhS"..8ACCEPTReview ReplacementCommandACCEPT Review Replacement Command)S  9ACEACEdKS9At-sign(@)commandAt-sign (@) command@S8ATTACHcommandATTACH commandeS --8ATTACHReviewBuildJobCommandATTACH Review Build Job CommandhS"..8ATTACHReview ReplacementCommandATTACH Review Replacement Command!i  iBBaS++8BACKReviewBuildJobCommandBACK Review Build Job CommanddS ,,8BACKReview ReplacementCommandBACK Review Replacement CommandJS 8BatchQueueBatch Queuer >S9BUILDcommandBUILD commandUS&&9Build dependency recordingBuild dependency recordingHSN8Callable interfaceCallable interface !i  iCCUS$$8CANCEL DIRECTORYcommandCANCEL DIRECTORY commandKS8CANCELFOLDcommandCANCEL FOLD commandIS9CANCELLOGcommandCANCEL LOG commandWS%%9CANCEL PRIVILEGEScommandCANCEL PRIVILEGES command]S&&8CANCEL REPLACEMENTcommandCANCEL REPLACEMENT commandaQS""8CANCELSESSIONcommandCANCEL SESSION command OS!!8CANCELVERIFYcommandCANCEL VERIFY command)S  8CMSCMSr:S N9BulkUploadBulk Upload ;S N8CallableCallable}~S9CMS librariesCMS librariesgls}ep1 /S 9CommandsCommands5S N8 AmbiguousAmbiguous(FS8Comment CharacterComment CharacterBS8COMPILEcommandCOMPILE commandPS!!8 Continuation CharacterContinuation Character3S 9 ConversionConversionAS N9 AutomaticAutomatic/_S##8CONVERTLIBRARYcommandCONVERT LIBRARY command)<S 8COPYcommandCOPY command4[S''8CREATE ARCHITECTUREcommandCREATE ARCHITECTURE commandAQS""8CREATECONTEXTcommandCREATE CONTEXT commandO_S))9CREATEDIRECTORY_TREEcommandCREATE DIRECTORY_TREE commanda*>$9CREATEFACILITY/FROM_CMS_-LIBRARYcommandCREATE FACILITY/FROM_CMS_ LIBRARY commandSS##8CREATEFACILITYcommandCREATE FACILITY commandvKS8CREATEFOLDcommandCREATE FOLD commandMS  8CREATEGROUPcommandCREATE GROUP commandYS""8CREATELIBRARYcommandCREATE LIBRARY command/OS!!8CREATEMODULEcommandCREATE MODULE command]S&&8CREATE REPLACEMENTcommandCREATE REPLACEMENT command&XSS!!9CREATESCRIPTcommandCREATE SCRIPT command1AQS""9CREATESESSIONcommandCREATE SESSION commandSKS8CREATESTEPcommandCREATE STEP command^OS!!8CREATESTREAMcommandCREATE STREAM commandwKS8CREATEUSERcommandCREATE USER command/S 8CreatingCreating<S N9a subprocessa subprocess gS!..9CURRENTReviewBuildJobCommandCURRENT Review Build Job Commandr#7&8CURRENTReview Replacement-CommandCURRENT Review Replacement CommandcS##8%CURRENTScriptKeyword%CURRENT Script KeywordP%53 !i  iDDHS8Database DirectoryDatabase Directory%S  9DCLDCLJSN9 DIFFERENCESCommandDIFFERENCES CommandQS""8DCLCommand ProceduresDCL Command ProceduresFS9 DebuggingScriptsDebugging ScriptsNS8DefecttrackingDefect tracking6PSPS!!8DEFINE/COMMANDcommandDEFINE/COMMAND commandHS8 DEFINE/KEYcommandDEFINE/KEY command>S8DefiningkeysDefining keysPS!!9DELETE/COMMANDcommandDELETE/COMMAND commandHS9 DELETE/KEYcommandDELETE/KEY command[S''8DELETE ARCHITECTUREcommandDELETE ARCHITECTURE commandUS$$8DELETE BUILD_JOBcommandDELETE BUILD_JOB commandQS""8DELETECONTEXTcommandDELETE CONTEXT command SS##8DELETEFACILITYcommandDELETE FACILITY commandKS9DELETEFOLDcommandDELETE FOLD command#WS%%9DELETE GENERATIONcommandDELETE GENERATION command0MS  8DELETEGROUPcommandDELETE GROUP commandBSS!!8DELETEMODULEcommandDELETE MODULE commandOYS&&8DELETE REPLACEMENTcommandDELETE REPLACEMENT command\OS!!8DELETESCRIPTcommandDELETE SCRIPT commandnKS9DELETESTEPcommandDELETE STEP commandOS!!8DELETESTREAMcommandDELETE STREAM commandKS8DELETEUSERcommandDELETE USER command>S9 DependencyCodeDependency CodeUS##N9VDE$K_DEPEND_BEGIN_RECORDVDE$K_DEPEND_BEGIN_RECORD QS!!N8VDE$K_DEPEND_END_RECORDVDE$K_DEPEND_END_RECORD QS!!N8VDE$K_DEPEND_INPUT_FILEVDE$K_DEPEND_INPUT_FILE WS$$N8VDE$K_DEPEND_INPUT_LIBRARYVDE$K_DEPEND_INPUT_LIBRARY US##N8VDE$K_DEPEND_INPUT_MODULEVDE$K_DEPEND_INPUT_MODULE SS""N9VDE$K_DEPEND_OUTPUT_FILEVDE$K_DEPEND_OUTPUT_FILE d/N9VDE$K_DEPEND_OUTPUT_LIBRARYVDE$K_DEPEND_OUTPUT_ LIBRARY b.N8VDE$K_DEPEND_OUTPUT_MODULEVDE$K_DEPEND_OUTPUT_ MODULE KSN8VDE$K_DEPEND_VERSIONVDE$K_DEPEND_VERSION <S8DerivedModuleDerived Module:S N8BuildInputBuild Input>SN9ChangeLevelsChange LevelsU 9S N9 CompilationCompilation#1SN8CopyingCopying;ISN8DefiningModuleAsDefining Module As7S N8 DefinitionDefinition<S N8DisplayOfDisplay OfgFSN8FacilityCreationFacility Creation~3S N8GroupingGrouping<S N9StorageOfStorage OfJS9 DIFFERENCEScommandDIFFERENCES commands#8'8 DIRECTORYReviewBuildJob-CommandDIRECTORY Review Build Job Commandv%9(8 DIRECTORYReview Replacement-CommandDIRECTORY Review Replacement Command\S8 DirectorysymbolDirectory symbol $w/MS  8$DIRScriptFunction$DIR Script Function#!i  jEE;S9EditorEditor5>dS ,,8EDITReview ReplacementCommandEDIT Review Replacement CommandKS8EMITScriptCommandEMIT Script CommandBS8EnteringcommandsEntering commands8S N8fromDCLfrom DCL%?8S N9withinVDEwithin VDE"8S N9withinVSCwithin VSC"HS9Entering subcommandsEntering subcommands8S N9withinVDEwithin VDE>@S8ErrorMessagesError Messages <S 8EXITcommandEXIT commandaS++8EXITReviewBuildJobCommandEXIT Review Build Job CommanddS ,,8EXITReview ReplacementCommandEXIT Review Replacement CommandKS9EXITScriptCommandEXIT Script CommandQS""9EXTRACTSCRIPTcommandEXTRACT SCRIPT command!i  iFFYS&&8 $FACMODTYPScriptFunction$FACMODTYP Script Function US$$8$FACROOTScriptFunction$FACROOT Script Function&MS  8$FACScriptFunction$FAC Script Function>S9FETCHcommandFETCH commandMS  9FETCHScriptCommandFETCH Script Command'S8FileFile7S N8 VDE$RECDEPVDE$RECDEP2 US$$8$FILEDIRScriptFunction$FILEDIR Script Function!<S8File ExtensionFile Extension)S  N8LogLog)S  N8RDARDA)S  N9RDBRDB-S  N9SNPSNP)S  N8VDEVDE=S N8 VDE$COMMENTVDE$COMMENT1SN8VDE$LOGVDE$LOG9S N8 VDESCRIPTVDESCRIPT3WS%%9 $FILESPECScriptFunction$FILESPEC Script Function"cS,,9FIRSTReviewBuildJobCommandFIRST Review Build Job CommandfS!--8FIRSTReview ReplacementCommandFIRST Review Replacement Command!i  iHH<S 8HELPcommandHELP command1SN8exampleexample)-S8HistoryHistoryNS N9CMSElementCMS Elementx7S N9 DisplayingDisplaying]1SN8ModulesModules]1SN9NotesNotes!i  iIIWS%%8INSERT GENERATIONcommandINSERT GENERATION commandOS!!8INVOKESCRIPTcommandINVOKE SCRIPT command2OS!!8INVOKESCRIPTCommandINVOKE SCRIPT Command!i  jKKBS9Kept SubprocessKept Subprocess>S8Key definitionsKey definitions7S N8 displayingdisplaying!i  iLLaS++8LASTReviewBuildJobCommandLAST Review Build Job CommanddS ,,9LASTReview ReplacementCommandLAST Review Replacement Command7S 9 LIB$GET_VMLIB$GET_VMAS8LIB$GET_VM_PAGELIB$GET_VM_PAGEGS8LIB$REC_DEPENDENCYLIB$REC_DEPENDENCY 1S 8 LibrariesLibraries/SN8LabelsLabels 5S N9 MnemonicsMnemonics -SN8NamesNames US$$9$LIBROOTScriptFunction$LIBROOT Script Function(@S 9LINKcommandLINK commandAM/S8LINKERLINKER 8S 8LogicalnameLogical named/N8VDE$LIBRARY_DEFAULTS_LABELSVDE$LIBRARY_DEFAULTS_ LABELSj 2N8VDE$LIBRARY_DEFAULTS_ MNEMONICSVDE$LIBRARY_DEFAULTS_ MNEMONICSESN9VDE$LIBRARY_LABELVDE$LIBRARY_LABELKSN9VDE$LIBRARY_MNEMONICVDE$LIBRARY_MNEMONIC8S 8LogicalNameLogical Name1SN8CopyingCopying BSN8Macro AssemblerMacro Assembler5S N8 SYS$LOGINSYS$LOGIN7S N9 SYS$OUTPUTSYS$OUTPUT =S N9 SYS$SCRATCHSYS$SCRATCH 9S N8 VDE$DB_AREAVDE$DB_AREAMS N8 VDE$LIBRARYVDE$LIBRARYD_ OSN8VDE$LIBRARY_DEFAULTSVDE$LIBRARY_DEFAULTS SS""N8VDE$LIBRARY_DEFAULTS_CMSVDE$LIBRARY_DEFAULTS_CMS h/N8VDE$LIBRARY_DEFAULTS_LABELSVDE$LIBRARY_DEFAULTS_ LABELS n 2N8VDE$LIBRARY_DEFAULTS_ MNEMONICSVDE$LIBRARY_DEFAULTS_ MNEMONICS ESN9VDE$LIBRARY_LABELVDE$LIBRARY_LABEL KSN9VDE$LIBRARY_MNEMONICVDE$LIBRARY_MNEMONIC MSN8VDE$NOTES_LIBRARYVDE$NOTES_LIBRARY 9S N8 VDE$OFFLINEVDE$OFFLINE KSN8VDE$PAGEFILE_SECTIONVDE$PAGEFILE_SECTION2 MSN8VDE$RECORD_DEPENDENCYVDE$RECORD_DEPENDENCY2 ISN9VDE$REPLACE_DEFAULTVDE$REPLACE_DEFAULT =S N9 VDE$SCRATCHVDE$SCRATCH ;S N8 VDE$SNAPSHOTVDE$SNAPSHOT=SN8 VDE$TEMPLATESVDE$TEMPLATES p!3N8VDE$WHEREIS_BACKUPS_ AFTER_IMAGEVDE$WHEREIS_BACKUPS_ AFTER_IMAGEj h/N8VDE$WHEREIS_BACKUPS_ARCHIVEVDE$WHEREIS_BACKUPS_ ARCHIVEj h/N9VDE$WHEREIS_BACKUPS_CURRENTVDE$WHEREIS_BACKUPS_ CURRENTj US!!N9VDE$WHEREIS_BACKUP_FULLVDE$WHEREIS_BACKUP_FULLj US!!N8VDE$WHEREIS_BACKUP_INCRVDE$WHEREIS_BACKUP_INCRj ISN9VDE$WHEREIS_BUILDVDE$WHEREIS_BUILDj ESN8VDE$WHEREIS_CMSVDE$WHEREIS_CMSj OSN8VDE$WHEREIS_DATABASEVDE$WHEREIS_DATABASEj ISN8VDE$WHEREIS_LABELVDE$WHEREIS_LABELj OSN8VDE$WHEREIS_MNEMONICVDE$WHEREIS_MNEMONICj MSN8VDE$WHEREIS_STAGINGVDE$WHEREIS_STAGINGj SS  N9VDE$WHEREIS_STATISTICSVDE$WHEREIS_STATISTICSj !i  iMM'S8MailMailkS))N8Lost Reservation NotificationLost Reservation Notification8')WS N8 NotificationNotificationcS ++N8Queued Reservation NotificationQueued Reservation NotificationbS  N9Reviewer NotificationReviewer NotificationZ/S 9MainlineMainlinePSN8markingafileasmarking a file as 6M 3MainStreamMain StreamCMN3SeealsoMainlineSee also MainlineBS 8MarkerfileMarker file x3S 8MessagesMessages [S''8MODIFY ARCHITECTUREcommandMODIFY ARCHITECTURE commandXUS$$8MODIFY BUILD_JOBcommandMODIFY BUILD_JOB commandfQS""8MODIFYCONTEXTcommandMODIFY CONTEXT command{dS ,,9MODIFYFACILITY/DELETEcommandMODIFY FACILITY /DELETE commandSS##9MODIFYFACILITYcommandMODIFY FACILITY commandKS8MODIFYFOLDcommandMODIFY FOLD command{&9(8MODIFYGENERATION/MAIN_STREAM-commandMODIFY GENERATION/MAIN_STREAM command q#6%8MODIFYGENERATION/OBSOLETE-commandMODIFY GENERATION/OBSOLETE command m!4#8MODIFYGENERATION/REMARK-commandMODIFY GENERATION/REMARK command WS%%9MODIFY GENERATIONcommandMODIFY GENERATION commandMS  9MODIFYGROUPcommandMODIFY GROUP commandhS"..N8 specifyingcommand qualifiersforspecifying command qualifiers forlS$00N8 specifying parameter qualifiersforspecifying parameter qualifiers fors"5$8MODIFYLIBRARY/STATISTICS-commandMODIFY LIBRARY/STATISTICS command6SUS""8MODIFYLIBRARYcommandMODIFY LIBRARY commandOS!!9MODIFYMODULEcommandMODIFY MODULE commandYS&&9MODIFY REPLACEMENTcommandMODIFY REPLACEMENT command+YS&&8MODIFY RESERVATIONcommandMODIFY RESERVATION command@OS!!8MODIFYSCRIPTcommandMODIFY SCRIPT command^QS""8MODIFYSESSIONcommandMODIFY SESSION command{KS8MODIFYSTEPcommandMODIFY STEP commandOS!!8MODIFYSTREAMcommandMODIFY STREAM commandUS$$8MODIFY USER/USERcommandMODIFY USER/USER commandKS9MODIFYUSERcommandMODIFY USER commandMS  9$MODScriptFunction$MOD Script Function)SS##8$MODTYPScriptFunction$MODTYP Script Function*1S8MotifMotifE!i  iNNaS++8NEXTReviewBuildJobCommandNEXT Review Build Job CommanddS ,,9NEXTReview ReplacementCommandNEXT Review Replacement Command-S9NotesNotes+GS N8 NotificationNotification!i  iOO/S 8ObsoleteObsoleteLSN8markingafileasmarking a file as !i  jPPaS""9%PARENTScriptKeyword%PARENT Script KeywordP%53 cS''9PERFORM REPLACEMENTcommandPERFORM REPLACEMENT commandLSS##9POPULATESTREAMcommandPOPULATE STREAM command1S 8 PrivilegePrivilegeUS N8BUILDBUILD4Mf 7SN8BYPASSBYPASS`5SN8CREARCHCREARCHAX?SN9CRECTXCRECTXO[ {7SN9CREFACCREFACv7SN8CREGRPCREGRPB;SN8CREMODCREMODOESN8CRESCRPCRESCRP1n^<9SN8CRESTEPCRESTEP^MSN9CRESTRMCRESTRMawe7SN9CREUSRCREUSR1SN8DELARCHDELARCH/SN8DELFACDELFAC7SN8DELMODDELMODOU/SN8DELREPDELREP\1SN8DELSTRMDELSTRM;SN8FROZENFROZEN7SN8MODLIBMODLIB)1SN9MODSTRMMODSTRM7S N9OverrideOverrideYS N8PERFREPPERFREP 0a+{ 1SN8PREFREPPREFREP1SN8READALLREADALL`sSN8RESREPRESREP &S#a+@{i 5SN9UNCLOSEUNCLOSE_S N9USERNAMEUSERNAME,G *es -S8ProcessProcessMS  N8 attachingtoanotherattaching to anotherDS8ProjecttrackingProject trackingN+S8PromptPrompt)S  N9CLDCLDK9S N9 CustomizingCustomizing<S N8LibraryNameLibrary Name/SN8NameName)S  N8QARQARKSS N8RemarkRemark-Z f@SN8Root DirectoryRoot DirectoryGSN8StreamStream> .d=S N9 VDEREVBLDVDEREVBLD5S N9 VDEREVREPVDEREVREP5S 8 ProtectionsProtections5S N8 DirectoryDirectoryd!i  iQQ=S8QueueQueuer S9Queued ReplacementQueued Replacementg*N`f$+;W1i1 DS9Quoting charactersQuoting charactersKSN8EMITscriptcommandEMIT script command!i  iRR]S&&8REJECT REPLACEMENTcommandREJECT REPLACEMENT commandhS"..8REJECTReview ReplacementCommandREJECT Review Replacement CommandWS%%9REMOVE GENERATIONcommandREMOVE GENERATION commandJS9REPLACEcommandREPLACE command BS9RESERVEcommandRESERVE commandi>S9ResourceFileResource File OS!!8ReviewBuildCommandsReview Build CommandsRS%%8ReviewBuildJobCommandReview Build Job Command/SN8ATTACHATTACH+SN8BACKBACK1SN9CURRENTCURRENT5S N9 DIRECTORYDIRECTORY+SN8EXITEXIT-SN8FIRSTFIRST+SN8LASTLAST+SN8NEXTNEXT/SN9SELECTSELECT-SN9SPAWNSPAWNUS$$8REVIEW BUILD_JOBcommandREVIEW BUILD_JOB commandUS&&8Review ReplacementCommandReview Replacement Command/SN8ACCEPTACCEPT/SN8ATTACHATTACH+SN8BACKBACK1SN8CURRENTCURRENT5S N9 DIRECTORYDIRECTORY+SN9EDITEDIT+SN8EXITEXIT-SN8FIRSTFIRST+SN8LASTLAST+SN8NEXTNEXT/SN9REJECTREJECT/SN9SELECTSELECT+SN8SHOWSHOW-SN8SPAWNSPAWNYS&&8REVIEW REPLACEMENTcommandREVIEW REPLACEMENT command[S''8Review ReplacementCommandsReview Replacement Commands!i  iSSNS9Scratch DirectoryScratch Directory2 US$$9$SCRATCHScriptFunction$SCRATCH Script Function+@S8ScriptCommandScript Command+SN9EMITEMIT^S))N8EMITquoting characterpairsEMIT quoting character pairs+SN8EXITEXIT-SN8FETCHFETCHUS$$8ScriptComment CharacterScript Comment Character_S))9Script Continuation CharacterScript Continuation CharacterDS9Script DebuggingScript Debugging>S8ScriptFunctionScript Function+SN8$DIR$DIR#+SN8$FAC$FAC7S N8 $FACMODTYP$FACMODTYP 3S N9$FACROOT$FACROOT&3S N9$FILEDIR$FILEDIR!5S N8 $FILESPEC$FILESPEC"3S N8$LIBROOT$LIBROOT(+SN8$MOD$MOD)1SN8$MODTYP$MODTYP*3S N9$SCRATCH$SCRATCH+;S N8 $SESSIONNAME$SESSIONNAME,9S N9 $SESSIONNUM$SESSIONNUM-7S N9 $STAGEDEST$STAGEDEST.5S N8 $STAGEDIR$STAGEDIR07S N8 $STAGEROOT$STAGEROOT11SN8$STREAM$STREAM23S N8$STRMDIR$STRMDIR35S N9 $STRMROOT$STRMROOT5+SN9$TYP$TYP7DS8Script FunctionsScript Functions<S8ScriptKeywordScript KeywordCS N8%CURRENT%CURRENTP%53 ASN8%PARENT%PARENTP%53 <S 9ScriptTypesScript Types<1S  9SCTSCT+MS  8SCTnotes conferenceSCT notes conference IS8SCTTemplateFilesSCT Template Files eS --8SELECTReviewBuildJobCommandSELECT Review Build Job CommandhS"..8SELECTReview ReplacementCommandSELECT Review Replacement Command1S8SessionSession-]S((8 $SESSIONNAMEScriptFunction$SESSIONNAME Script Function,[S''9 $SESSIONNUMScriptFunction$SESSIONNUM Script Function-US$$9SET ARCHITECTUREcommandSET ARCHITECTURE commandIKS8SETCONTEXTcommandSET CONTEXT commandPOS!!8SET DEVELOPERCommandSET DEVELOPER Command^OS!!8SET DIRECTORYcommandSET DIRECTORY commandeIS8SETEDITORcommandSET EDITOR command}MS  9SETFACILITYcommandSET FACILITY commandCS9SETKEYcommandSET KEY commandKS8SETLIBRARYcommandSET LIBRARY commandCS8SETLOGcommandSET LOG commandMS  8SETNOVERIFYcommandSET NOVERIFY commandQS""8SET PRIVILEGEScommandSET PRIVILEGES commandIS9SETPROMPTcommandSET PROMPT commandIS9SETSTREAMcommandSET STREAM commandMS  8SETTERMINALcommandSET TERMINAL commandIS9SETVERIFYcommandSET VERIFY command>S8 ShareableImageShareable Image7S N8 VDE$RECDEPVDE$RECDEP2 WS%%8SHOW ARCHITECTUREcommandSHOW ARCHITECTURE commandQS""8SHOW BUILD_JOBcommandSHOW BUILD_JOB commandMS  8SHOWCONTEXTcommandSHOW CONTEXT commandOS!!9SHOWDEFAULTScommandSHOW DEFAULTS commandQS""8SHOW DEVELOPERCommandSHOW DEVELOPER Command&QS""8SHOW DIRECTORYcommandSHOW DIRECTORY command,KS8SHOWEDITORcommandSHOW EDITOR command8OS!!8SHOWFACILITYcommandSHOW FACILITY command@GS8SHOWFOLDcommandSHOW FOLD commandMSS##9SHOW GENERATIONcommandSHOW GENERATION command]IS9SHOWGROUPcommandSHOW GROUP commandMS  8SHOWHISTORYcommandSHOW HISTORY command]ES8SHOWKEYcommandSHOW KEY commandQS  8SHOWLIBRARYcommandSHOW LIBRARY commandOS!!8SHOWLOCATIONcommandSHOW LOCATION commandES8SHOWLOGcommandSHOW LOG commandKS8SHOWMEMORYcommandSHOW MEMORY commandKS9SHOWMODULEcommandSHOW MODULE commandSS##9SHOW PRIVILEGEScommandSHOW PRIVILEGES commandUS$$8SHOW REPLACEMENTcommandSHOW REPLACEMENT commandUS$$8SHOW RESERVATIONcommandSHOW RESERVATION commanddS ,,8SHOWReview ReplacementCommandSHOW Review Replacement CommandKS8SHOWSCRIPTcommandSHOW SCRIPT command MS  9SHOWSESSIONcommandSHOW SESSION command6 GS9SHOWSTEPcommandSHOW STEP commandL KS8SHOWSTREAMcommandSHOW STREAM command[ KS8SHOWSYMBOLcommandSHOW SYMBOL commandk OS!!8SHOWTERMINALcommandSHOW TERMINAL commands GS8SHOWUSERcommandSHOW USER commandz KS9SHOWVERIFYcommandSHOW VERIFY command MS  9SHOWVERSIONcommandSHOW VERSION command HS8Snapshot DirectorySnapshot DirectoryWS##8SourceControlTrackingSource Control Tracking:S8SourceModuleSource ModuleISN8DefiningModuleAsDefining Module As7S N8 DefinitionDefinition<S N8DisplayOfDisplay Ofg>S9SPAWNcommandSPAWN command cS,,9SPAWNReviewBuildJobCommandSPAWN Review Build Job CommandfS!--8SPAWNReview ReplacementCommandSPAWN Review Replacement CommandYS&&8 $STAGEDESTScriptFunction$STAGEDEST Script Function.WS%%8 $STAGEDIRScriptFunction$STAGEDIR Script Function0YS&&8 $STAGEROOTScriptFunction$STAGEROOT Script Function1hS 9StagingAreaStaging AreagN#f1i1 SS##9START BUILD_JOBcommandSTART BUILD_JOB command ZS  8 Statistics CollectionStatistics Collection6SQS""8STOP BUILD_JOBcommandSTOP BUILD_JOB command S ,5( 5(S##8STOP SUBPROCESScommandSTOP SUBPROCESS command SS##8$STREAMScriptFunction$STREAM Script Function2US$$9$STRMDIRScriptFunction$STRMDIR Script Function3WS%%9 $STRMROOTScriptFunction$STRMROOT Script Function5WS%%9SUSPEND BUILD_JOBcommandSUSPEND BUILD_JOB command +S9SymbolSymbolp!3N8VDE$WHEREIS_BACKUPS_ AFTER_IMAGEVDE$WHEREIS_BACKUPS_ AFTER_IMAGEj h/N8VDE$WHEREIS_BACKUPS_ARCHIVEVDE$WHEREIS_BACKUPS_ ARCHIVEj h/N8VDE$WHEREIS_BACKUPS_CURRENTVDE$WHEREIS_BACKUPS_ CURRENTj US!!N8VDE$WHEREIS_BACKUP_FULLVDE$WHEREIS_BACKUP_FULLj US!!N9VDE$WHEREIS_BACKUP_INCRVDE$WHEREIS_BACKUP_INCRj ISN9VDE$WHEREIS_BUILDVDE$WHEREIS_BUILDj ESN8VDE$WHEREIS_CMSVDE$WHEREIS_CMSj OSN8VDE$WHEREIS_DATABASEVDE$WHEREIS_DATABASEj ISN8VDE$WHEREIS_LABELVDE$WHEREIS_LABELj OSN8VDE$WHEREIS_MNEMONICVDE$WHEREIS_MNEMONICj MSN9VDE$WHEREIS_STAGINGVDE$WHEREIS_STAGINGj SS  N9VDE$WHEREIS_STATISTICSVDE$WHEREIS_STATISTICSj QS""8 SYS$LOGINLogicalNameSYS$LOGIN Logical Name7S 8 SYS$OUTPUTSYS$OUTPUT YS$$8 SYS$SCRATCHLogicalNameSYS$SCRATCH Logical Name SS""8SYS$SHARE:VDE$RECDEP.EXESYS$SHARE:VDE$RECDEP.EXE2 cS))8System AuthorizationDatabaseSystem Authorization Database^WS%%8System AuthorizationFileSystem Authorization File^;S8SYSUAFSYSUAF^!i  jTTMS  9$TYPScriptFunction$TYP Script Function7!i  iUU)S  8UICUICdNS8 UNRESERVEcommandUNRESERVE command SS##8 UploadingCMS LibrariesUploading CMS Libraries !i  jVVZS9 VDE$BUILDUtilityVDE$BUILD Utility:v9S8VDE$CMSVDE$CMSrx9S 8 VDE$DB_AREAVDE$DB_AREAUS##8VDE$K_DEPEND_BEGIN_RECORDVDE$K_DEPEND_BEGIN_RECORD QS!!8VDE$K_DEPEND_END_RECORDVDE$K_DEPEND_END_RECORD QS!!9VDE$K_DEPEND_INPUT_FILEVDE$K_DEPEND_INPUT_FILE WS$$9VDE$K_DEPEND_INPUT_LIBRARYVDE$K_DEPEND_INPUT_LIBRARY US##8VDE$K_DEPEND_INPUT_MODULEVDE$K_DEPEND_INPUT_MODULE SS""9VDE$K_DEPEND_OUTPUT_FILEVDE$K_DEPEND_OUTPUT_FILE YS%%8VDE$K_DEPEND_OUTPUT_LIBRARYVDE$K_DEPEND_OUTPUT_LIBRARY WS$$8VDE$K_DEPEND_OUTPUT_MODULEVDE$K_DEPEND_OUTPUT_MODULE KS8VDE$K_DEPEND_VERSIONVDE$K_DEPEND_VERSION IS 8 VDE$LIBRARYVDE$LIBRARYD_US$$9 VDE$LIBRARYLogicalNameVDE$LIBRARY Logical Name gS"--9VDE$LIBRARY_DEFAULTSlogicalnameVDE$LIBRARY_DEFAULTS logical nameo"5'8VDE$LIBRARY_DEFAULTSLogical-NameVDE$LIBRARY_DEFAULTS Logical Name w&9"8VDE$LIBRARY_DEFAULTS_CMS-LogicalNameVDE$LIBRARY_DEFAULTS_CMS Logical Name )<%8VDE$LIBRARY_DEFAULTS_LABELS-logicalnameVDE$LIBRARY_DEFAULTS_LABELS logical name})<%8VDE$LIBRARY_DEFAULTS_LABELS-LogicalNameVDE$LIBRARY_DEFAULTS_LABELS Logical Name -A9VDE$LIBRARY_DEFAULTS_"- MNEMONICSlogicalnameVDE$LIBRARY_DEFAULTS_ MNEMONICS logical name-A9VDE$LIBRARY_DEFAULTS_"- MNEMONICSLogicalNameVDE$LIBRARY_DEFAULTS_ MNEMONICS Logical Name aS**8VDE$LIBRARY_LABELlogicalnameVDE$LIBRARY_LABEL logical nameaS**8VDE$LIBRARY_LABELLogicalNameVDE$LIBRARY_LABEL Logical Name o"5'8VDE$LIBRARY_MNEMONIClogical-nameVDE$LIBRARY_MNEMONIC logical nameo"5'8VDE$LIBRARY_MNEMONICLogical-NameVDE$LIBRARY_MNEMONIC Logical Name ;S 9 VDE$MARKERVDE$MARKER xeS**8VDE$NOTES_LIBRARYlogicalnameVDE$NOTES_LIBRARY logical nameaS**9VDE$NOTES_LIBRARYLogicalNameVDE$NOTES_LIBRARY Logical Name US$$9 VDE$OFFLINELogicalNameVDE$OFFLINE Logical Name KS8VDE$PAGEFILE_SECTIONVDE$PAGEFILE_SECTION2 7S 8 VDE$RECDEPVDE$RECDEP2 MS8VDE$RECORD_DEPENDENCYVDE$RECORD_DEPENDENCY2 m!4&8VDE$REPLACE_DEFAULTLogical-NameVDE$REPLACE_DEFAULT Logical Name YS$$9 VDE$SCRATCHLogicalNameVDE$SCRATCH Logical Name ;S 9 VDE$SNAPSHOTVDE$SNAPSHOTYS&&8 VDE$TEMPLATESLogicalNameVDE$TEMPLATES Logical Name 7S 8 VDE$UPLOADVDE$UPLOAD sS 8VDE$V_CI_FLAG_SIGNALVDE$V_CI_FLAG_SIGNALF X j | .B$8VDE$WHEREIS_BACKUPS_AFTER_-IMAGELogicalNameVDE$WHEREIS_BACKUPS_AFTER_ IMAGE Logical Namej x'9$9VDE$WHEREIS_BACKUPS_AFTER_- IMAGESymbolVDE$WHEREIS_BACKUPS_AFTER_ IMAGESymbolj{(;$9VDE$WHEREIS_BACKUPS_AFTER_-IMAGESymbolVDE$WHEREIS_BACKUPS_AFTER_ IMAGE Symbol )<%8VDE$WHEREIS_BACKUPS_ARCHIVE-LogicalNameVDE$WHEREIS_BACKUPS_ARCHIVE Logical Namej t#5%8VDE$WHEREIS_BACKUPS_ARCHIVE-SymbolVDE$WHEREIS_BACKUPS_ARCHIVE Symbolj )<%8VDE$WHEREIS_BACKUPS_CURRENT-LogicalNameVDE$WHEREIS_BACKUPS_CURRENT Logical Namej t#5%8VDE$WHEREIS_BACKUPS_CURRENT-SymbolVDE$WHEREIS_BACKUPS_CURRENT Symbolj y%8*8VDE$WHEREIS_BACKUP_FULLLogical-NameVDE$WHEREIS_BACKUP_FULL Logical Namej dS))8VDE$WHEREIS_BACKUP_FULLSymbolVDE$WHEREIS_BACKUP_FULL Symbolj y%8*9VDE$WHEREIS_BACKUP_INCRLogical-NameVDE$WHEREIS_BACKUP_INCR Logical Namej dS))9VDE$WHEREIS_BACKUP_INCRSymbolVDE$WHEREIS_BACKUP_INCR Symbolj eS**8VDE$WHEREIS_BUILDLogicalNameVDE$WHEREIS_BUILD Logical Namej XS##8VDE$WHEREIS_BUILDSymbolVDE$WHEREIS_BUILD Symbolj aS((8VDE$WHEREIS_CMSLogicalNameVDE$WHEREIS_CMS Logical Namej TS!!8VDE$WHEREIS_CMSSymbolVDE$WHEREIS_CMS Symbolj s"5'9VDE$WHEREIS_DATABASELogical-NameVDE$WHEREIS_DATABASE Logical Namej ^S&&9VDE$WHEREIS_DATABASESymbolVDE$WHEREIS_DATABASE Symbolj eS**8VDE$WHEREIS_LABELLogicalNameVDE$WHEREIS_LABEL Logical Namej XS##8VDE$WHEREIS_LABELSymbolVDE$WHEREIS_LABEL Symbolj s"5'8VDE$WHEREIS_MNEMONICLogical-NameVDE$WHEREIS_MNEMONIC Logical Namej ^S&&8VDE$WHEREIS_MNEMONICSymbolVDE$WHEREIS_MNEMONIC Symbolj iS!,,8VDE$WHEREIS_STAGINGLogicalNameVDE$WHEREIS_STAGING Logical Namej \S%%9VDE$WHEREIS_STAGINGSymbolVDE$WHEREIS_STAGING Symbolj w$7)9VDE$WHEREIS_STATISTICSLogical-NameVDE$WHEREIS_STATISTICS Logical Namej bS((9VDE$WHEREIS_STATISTICSSymbolVDE$WHEREIS_STATISTICS Symbolj HS9 VDE/DEPENDcommandVDE/DEPEND commandLPS8 VDE/READ_UAFcommandVDE/READ_UAF commandZJS8 VDE/WHEREIScommandVDE/WHEREIS commandd6S 8VDEcommandVDE command=S N8atDCLlevelat DCL level46S 9VDEUtilityVDE UtilityNS  N9Command AbbreviationsCommand Abbreviations(3S N8commandscommands@S N8exitingfromexiting from$=<S N8HELPcommandHELP command)3S N8invokinginvoking!9S 9VDEvsVSCVDE vs VSC WS%%9VERIFY GENERATIONcommandVERIFY GENERATION command :S 8VSCLibraryVSC Library6S 8VSCUtilityVSC Utility<S N8HELPcommandHELP command)3S N8invokinginvoking!9S 8VSCvsVDEVSC vs VDE !i  iWWQS""9WAIT BUILD_JOBcommandWAIT BUILD_JOB command FS9Wildcard charactersWildcard charactersUS$$N8deleting facilitieswithdeleting facilities withOS!!N8deletinggroupsusingdeleting groups usingEOS!!N8deletingmoduleswithdeleting modules withROS!!N8deletingstreamswithdeleting streams withSS##N9deleting usernameswithdeleting usernames with w  uM*OUSERMOD,, informationforuseruserimodifiedinthe(database Facility:15VDE,OpenVMS Development Environment^ Explanation:5^Thismessageinformsyouthatinforma-Ltionforthe indicateduserhasbeenmodifiedintheVDEI database.)Thismessageisonlyissuedwhenyouusethe:h/LOG qualifierontheMODIFYUSERcommand.UserAction:5Usethe/NOLOG qualifierforthecom->\mandifyoudonotwishtoseethemessage. ! ]O USERNOTDEL,-useruser$znotdeleted;youcannot(deleteyourself Facility:15VDE,OpenVMS Development Environment^ Explanation:5^Thismessageinformsyouthatthein-Idicateduser,namelyyou yourself,hasnotbeendeletedLfromthe database.(YouarenotallowedtodeleteyourselfFhfromthe database.+This prohibitionpreventsyoufromL accidentallydeletingyourselffromthe database, especiallyEwhenusinga wildcardedusernamespecification.)ThereIristhusnowaytodeleteallusersfromthe database. UserAction:8 IfyouwanttodeleteyourselffromtheHe database,someoneelsewiththerequired privilegemustdoitforyou.C  uO USERNOTFOUND,,user7user#notfoundin database;( parameterignored Facility:15VDE,OpenVMS Development Environment^ Explanation:7^The indicatedusernamewasenteredonaCSHOWUSERcommand,butnosuchuserwasfoundintheVDE database.UserAction:;Thisisnot necessarilyanerror;themes-Psagesimplytellsyouthatthe indicateduserdoesnotexist\inthe database.A uO USERNOTUAF,,useruser&~notfoundinsystemUser( AuthorizationFile Facility:15VDE,OpenVMS Development Environment^ Explanation:3^The indicatedusernameisyouruser-@name,!but itwas notfound in the system User AuthorizationFile.UserAction:6ThiserrorshouldnothappenexcepttoDVDE developerswhoredefinethecurrentuserduring/\testing.&Submitaproblemreport. ! j:O USEVERSLNM,-uselogicalnameVDE$VMS_VERSION(.tooverrideOpenVMSversion Facility:15VDE,OpenVMS Development Environmentd Explanation:1dVDEisunableto determineOpenVMSDversion informationfromtheversionstringreturnedDfroma SYS$GETSYIservicecall.)Thismessagerecom->mmendsthatyouusetheVDE$VMS_VERSIONlogical1nametooverridethesystemvalue.aUserAction:.aDefinethelogicalnameVDE$VMS_AVERSIONtoavalidOpenVMSversionstringvalue.  DOVALREQ,-missing qualifierorkeywordvalue-supply"(allrequiredvalues'(text (' Facility:15VDE,OpenVMS Development Environment^ Explanation:5^Inmany commands,specifickeywordsor$ qualifiersare expected.RUserAction:6RSeeVDE ReferenceManualfor assistance%withthecommandsyntax.  ! #O VDECLUSTER,, vde.cluster:clusterk Facility:15kVDE,OpenVMS Development Environment Explanation:<ThismessageisusedtoformattextstringsO^withinVDE,andshouldnotbevisibletousersasanerrormessage.RUserAction::RContactVDEsupportfor assistance,astheNversionofVDEinuseshouldnotbe displayingthisasanerrormessage.4 ! u 9O VDECONTACT,, vde.contact:.pleasecontactVDE"(supportfor assistance Facility:15VDE,OpenVMS Development Environment^ Explanation:<^ThismessageisusedtoformattextstringsOwithinVDE,andshouldnotbevisibletousersasanerrormessage.UserAction::ContactVDEsupportfor assistance,astheNversionofVDEinuseshouldnotbe displayingthisasan\errormessage. ! %O VDEDATETIME,, vde.datetime:Wdatetimek Facility:15kVDE,OpenVMS Development Environment Explanation:<ThismessageisusedtoformattextstringsO^withinVDE,andshouldnotbevisibletousersasanerrormessage.RUserAction::RContactVDEsupportfor assistance,astheNversionofVDEinuseshouldnotbe displayingthisasanerrormessage.8 ! uBO VDEFORMAT,, vde.format:*theformatofthisfileis(subjecttochange Facility:15VDE,OpenVMS Development Environment^ Explanation:<^ThismessageisusedtoformattextstringsOwithinVDE,andshouldnotbevisibletousersasanerrormessage.UserAction::ContactVDEsupportfor assistance,astheNversionofVDEinuseshouldnotbe displayingthisasan\errormessage.  !  OVDENAME,, vde.product:Wvdenamek Facility:15kVDE,OpenVMS Development Environment Explanation:<ThismessageisusedtoformattextstringsO^withinVDE,andshouldnotbevisibletousersasanerrormessage.RUserAction::RContactVDEsupportfor assistance,astheNversionofVDEinuseshouldnotbe displayingthisasanerrormessage. ! OVDENODE,, vde.node:nodek Facility:15kVDE,OpenVMS Development Environment Explanation:<ThismessageisusedtoformattextstringsO^withinVDE,andshouldnotbevisibletousersasanerrormessage.RUserAction::RContactVDEsupportfor assistance,astheNversionofVDEinuseshouldnotbe displayingthisasanerrormessage.(   ! #O VDEPROJECT,- vde.project:projectk Facility:15kVDE,OpenVMS Development Environment Explanation:<ThismessageisusedtoformattextstringsO^withinVDE,andshouldnotbevisibletousersasanerrormessage.RUserAction::RContactVDEsupportfor assistance,astheNversionofVDEinuseshouldnotbe displayingthisasanerrormessage.& ! !#O VDERDBBKP,- VDE$DATABASE$ qdb_BCKP_typep Facility:15pVDE,OpenVMS Development Environment  Explanation:< ThismessageisusedtoformattextstringsOdwithinVDE,andshouldnotbevisibletousersasanerrormessage.WUserAction::WContactVDEsupportfor assistance,astheNversionofVDEinuseshouldnotbe displayingthisasanerrormessage. ! OVDERDBBKP_FULL,-FULLk Facility:15kVDE,OpenVMS Development Environment Explanation:<ThismessageisusedtoformattextstringsO^withinVDE,andshouldnotbevisibletousersasanerrormessage.RUserAction::RContactVDEsupportfor assistance,astheNversionofVDEinuseshouldnotbe displayingthisasanerrormessage. ! OVDERDBBKP_INCR,-INCRk Facility:15kVDE,OpenVMS Development Environment Explanation:<ThismessageisusedtoformattextstringsO^withinVDE,andshouldnotbevisibletousersasanerrormessage.RUserAction::RContactVDEsupportfor assistance,astheNversionofVDEinuseshouldnotbe displayingthisasanerrormessage.  ! #O VDEVERSION,, vde.version:versionk Facility:15kVDE,OpenVMS Development Environment Explanation:<ThismessageisusedtoformattextstringsO^withinVDE,andshouldnotbevisibletousersasanerrormessage.RUserAction::RContactVDEsupportfor assistance,astheNversionofVDEinuseshouldnotbe displayingthisasanerrormessage.L ! "AO VERBOTEN,,directATTACHtoaVDEkept subprocess(is forbidden Facility:15VDE,OpenVMS Development Environment^ Explanation:4^AnattempthasbeenmadetodirectlyEATTACHtoaVDEkept subprocessviaaDCLcommand,(andthisisnot permitted.UserAction:5UseoftheDCLATTACHcommandtoat-KtachtoaVDEkept subprocessisnot permitted.+IfthisG\messagearisesfroma conditionotherthananattemptHbyausertoATTACHtoaVDEkept subprocess,pleaseG contactVDEsupportfor assistance.*PleaseincludeanyKe informationthatmaybeusefulorreleventin duplicatingtheproblem. krOWHEREIS,- componentcomp isIvaluek Facility:15kVDE,OpenVMS Development Environment Explanation:8Thismessageisusedtodisplayinforma-H^tionaboutpartsofthelocalVDE environmentandVDEconfiguration.RUserAction:#RNoactionis required.  OWHYOFF,-reason:'!ADk Facility:15kVDE,OpenVMS Development Environment Explanation:2Thismessageisusuallypairedwith@^ VDE$_OFFLINE.TheVDE environmenthasbeentaken7offline,andthismessage indicateswhy.RUserAction:;RIftheproblem persists,pleasecontactVDE#supportfor assistance.* ~:O WILDGENNUM,, wildcarded generationnumbernot(allowedin(module Facility:15VDE,OpenVMS Development Environment^ Explanation:5^Youhave specifieda wildcardedgener-DationnumberonamodulenameforacommandwhichHdoesnotallowthe generationnumbertobe wildcarded.UserAction:8Decidewhat generationofthemoduleyouFwanttoapplythecommandto.*Thenreissuethecom-F\mand, specifyingthat generationnumber.(Alternatively,Hyoumayomitthe generationnumber,inwhichcasetheI commandisappliedtothelast(mostrecent) generationeofthemodule.a u7=O WILDNOTALL,,wildcard charactersnotallowedin(name:(name Facility:15VDE,OpenVMS Development Environment^ Explanation:6^Youhave specifiedawildcard characterL (asteriskorpercentsign)inanamethatisnotallowedFtohavewildcard characters.*ThemessagedisplaystheAhnameuptoand includingthewildcard character.UserAction:2Specifythenamewithoutawildcard1\ characterandresubmitthecommand.  V5OXMERROR,-Motif interfaceerrordetectedk Facility:15kVDE,OpenVMS Development Environment Explanation:7VDEhasdetectedanerrorintheMotif^ interface.UserAction:6Aproblemhasoccurred accessingtheXGRWindowsdisplay,duringthefetchofawidgetfromaKUIDfile,oranothersimilarerror.( Additionalerrormes-Ksagesshouldhavebeen displayedpriortothis particularI\errorandtheothermessagesshoulddetailtheparticu-Plarfailure detected.'Ifunableto determinethecaseoftheI error,pleasecontactVDEsupportfor assistance.)PleaseLeincludeany informationthatmaybeusefulorreleventin$ duplicatingtheproblem.* 6  !!!!!!!!!""""""""""""##########$$$$$$$$%%%%%%%%%%%%&&&&&&&&&&&'''''''''''''(((((((((((((())))))))))))))))))*********************+++++++++++++++++++++++++++,,,,,,,,,,,,,,,,,-----------------...........................................................////////////////////////////////////////////////////////00000000000111111111111111111111111111111111122222222222333333333333333333333333344444444444444444444444444444444444444444444444444444455555555555555555555556666666666777778777777777777777779999999:::::::::;;;;;;;;;;;<<<<<<<<<<<<<<===========>>>>>>>>>>>?????????????@@@@@@@@@@@@@@@@@@AAAAAAAAAAAAABBBBBBBBBBBBBCCCCCCCCCCCCCCCCCCDDDDDDDDDDDDDDDDDDDDDDDDDDDDEEEEEEEEEEEEEFFFFFFFFFFFGGGGGGGGHGGGGGGIIIIIIIIIIIIIIIIIIIIIIIIJJJJJJJJKKKKKKKKKKKKKKKKKKKKKKKKKKKLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLMMMMMMMMNNNNNNNNNNNNNNNNNNNNNNNNNOOOOOOOOOOOOOOOOOOOOOOOOOOOPPPPPPPPPPPQQQQQQQQQQQQQQRRRRRRRRRRRRRRRRRRRRRSSSSSSSSSSSSSSSSSSSSTTTTTTTTTTTTUUUUUUUUUUUUUUVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVWWWWWWWWWWWWWWWWWWWWWXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYZZZZZZZZZZZZZZZZZZZZZ[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[\\\\\\\\\\\\\\\\\\\\\\\\\\\\\]]]]]]]]]]^^^^^^^^^^^^^^^^^^^^____________________________________________`````````````````````````aaaaaaaaaaaaaabbbbbbbbbbbbbbbbbcccccccccccccccccddddddddddddddeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeefeeeeeeeeeeeeeeeeeeeeeggggggggggggggggggggggggggggggggggggggggggggggggggggggggghhhhhhhhhhhhiiiiiiiiiiiiiiiiiiijjjjjjjjjjjjkkkkkkkkkkkkkkkkkkkkkkkkkkklllllllllllllllllllllllllllllllllllllllllllllllllmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmnnnnnnnnnooonpppppppqqqqqqqqqqqqqqrrrrrsrttttttttttttttttttttttttuuuuuuuuuuuuvvvvvvvwwwwwwwwxxxxxxxxxxxxxxxyyyyyyyyzzzzzzzz{{{{{|{{{{{{{{{{{}}}}}}}~~~~~~~}PrefaceIntended AudienceDocument StructureDocument StructureDocument StructureDocument StructureAssociated DocumentsConventionsConventionsConventions1. Introduction to VDE1. Introduction to VDE1. Introduction to VDE1. Introduction to VDE1. Introduction to VDE1.1 Using VDE*1.1.1 Entering VDE and VSC Commands*1.1.1 Entering VDE and VSC Commands*1.1.1 Entering VDE and VSC Commands*1.1.1 Entering VDE and VSC Commands*1.1.1 Entering VDE and VSC Commands1.1.1.1 Invoking VDE1.1.1.1 Invoking VDE1.1.1.1 Invoking VDE1.1.1.1 Invoking VDE)1.1.1.2 Entering Commands from DCL)1.1.1.2 Entering Commands from DCL)1.1.1.2 Entering Commands from DCL"1.1.1.3 Using Abbreviations1.1.2 Using HELP1.1.2 Using HELP1.2 Command Summary1.2 Command Summary1.2 Command Summary1.2 Command Summary1.2 Command Summary1.2 Command Summary1.2 Command Summary1.2 Command Summary'2. VDE Commands Invoked from DCL VDE VDE VDE VDE VDE VDE VDE VDE VDE VDE VDE VDE VDE VDE VDE VDE VDE VDE VDE VDE VDE VDE VDE VDEVDE/DEPENDVDE/DEPENDVDE/DEPENDVDE/DEPENDVDE/DEPENDVDE/DEPENDVDE/DEPENDVDE/DEPENDVDE/DEPENDVDE/DEPENDVDE/DEPENDVDE/DEPENDVDE/DEPENDVDE/DEPENDVDE/READ_UAFVDE/READ_UAFVDE/READ_UAFVDE/READ_UAFVDE/READ_UAFVDE/READ_UAFVDE/READ_UAFVDE/READ_UAFVDE/READ_UAFVDE/READ_UAFVDE/WHEREISVDE/WHEREISVDE/WHEREISVDE/WHEREISVDE/WHEREISVDE/WHEREISVDE/WHEREISVDE/WHEREISVDE/WHEREISVDE/WHEREISVDE/WHEREISVDE/WHEREISVDE/WHEREISVDE/WHEREISVDE/WHEREISVDE/WHEREISVDE/WHEREIS VSC VSC VSC VSC VSC VSC VSC VSC VSC VSC VSC VSC VSC VSC VSC VSC3. VDE Command Reference@@@@@@@ACCEPT REPLACEMENTACCEPT REPLACEMENTACCEPT REPLACEMENTACCEPT REPLACEMENTACCEPT REPLACEMENTACCEPT REPLACEMENTACCEPT REPLACEMENTACCEPT REPLACEMENTACCEPT REPLACEMENTACCEPT REPLACEMENTACCEPT REPLACEMENTACCEPT REPLACEMENTACCEPT REPLACEMENTACCEPT REPLACEMENTACCEPT REPLACEMENTACCEPT REPLACEMENTACCEPT REPLACEMENTACCEPT REPLACEMENT ATTACH ATTACH ATTACH ATTACH ATTACH ATTACH ATTACH ATTACH ATTACH BUILD BUILD BUILD BUILD BUILD BUILD BUILD BUILD BUILD BUILD BUILD BUILD BUILD BUILD BUILD BUILD BUILD BUILD BUILD BUILD BUILD BUILD BUILD BUILD BUILD BUILD BUILD BUILD BUILD BUILD BUILD BUILD BUILD BUILD BUILD BUILD BUILD BUILD BUILD BUILDCANCEL DIRECTORYCANCEL DIRECTORYCANCEL DIRECTORYCANCEL DIRECTORYCANCEL DIRECTORYCANCEL DIRECTORYCANCEL DIRECTORYCANCEL DIRECTORYCANCEL DIRECTORYCANCEL DIRECTORYCANCEL DIRECTORYCANCEL DIRECTORYCANCEL DIRECTORYCANCEL DIRECTORYCANCEL DIRECTORYCANCEL DIRECTORYCANCEL FOLDCANCEL FOLDCANCEL FOLDCANCEL FOLDCANCEL FOLDCANCEL FOLDCANCEL FOLDCANCEL FOLDCANCEL FOLDCANCEL FOLDCANCEL FOLDCANCEL FOLDCANCEL FOLDCANCEL LOGCANCEL LOGCANCEL LOGCANCEL LOGCANCEL LOGCANCEL LOGCANCEL LOGCANCEL PRIVILEGESCANCEL PRIVILEGESCANCEL PRIVILEGESCANCEL PRIVILEGESCANCEL PRIVILEGESCANCEL PRIVILEGESCANCEL PRIVILEGESCANCEL PRIVILEGESCANCEL PRIVILEGESCANCEL REPLACEMENTCANCEL REPLACEMENTCANCEL REPLACEMENTCANCEL REPLACEMENTCANCEL REPLACEMENTCANCEL REPLACEMENTCANCEL REPLACEMENTCANCEL REPLACEMENTCANCEL REPLACEMENTCANCEL REPLACEMENTCANCEL REPLACEMENTCANCEL REPLACEMENTCANCEL SESSIONCANCEL SESSIONCANCEL SESSIONCANCEL SESSIONCANCEL SESSIONCANCEL SESSIONCANCEL SESSIONCANCEL SESSIONCANCEL SESSIONCANCEL SESSIONCANCEL VERIFYCANCEL VERIFYCANCEL VERIFYCANCEL VERIFYCANCEL VERIFYCANCEL VERIFYCANCEL VERIFYCANCEL VERIFYCOMPILECOMPILECOMPILECOMPILECOMPILECOMPILECOMPILECOMPILECOMPILECOMPILECOMPILECOMPILECONVERT LIBRARYCONVERT LIBRARYCONVERT LIBRARYCONVERT LIBRARYCONVERT LIBRARYCONVERT LIBRARYCONVERT LIBRARYCONVERT LIBRARYCONVERT LIBRARYCONVERT LIBRARYCONVERT LIBRARY COPY COPY COPY COPY COPY COPY COPY COPY COPY COPY COPY COPY COPYCREATE ARCHITECTURECREATE ARCHITECTURECREATE ARCHITECTURECREATE ARCHITECTURECREATE ARCHITECTURECREATE ARCHITECTURECREATE ARCHITECTURECREATE ARCHITECTURECREATE ARCHITECTURECREATE ARCHITECTURECREATE ARCHITECTURECREATE ARCHITECTURECREATE ARCHITECTURECREATE ARCHITECTURECREATE CONTEXTCREATE CONTEXTCREATE CONTEXTCREATE CONTEXTCREATE CONTEXTCREATE CONTEXTCREATE CONTEXTCREATE CONTEXTCREATE CONTEXTCREATE CONTEXTCREATE CONTEXTCREATE CONTEXTCREATE CONTEXTCREATE CONTEXTCREATE CONTEXTCREATE CONTEXTCREATE CONTEXTCREATE CONTEXTCREATE DIRECTORY_TREECREATE DIRECTORY_TREECREATE DIRECTORY_TREECREATE DIRECTORY_TREECREATE DIRECTORY_TREECREATE DIRECTORY_TREECREATE DIRECTORY_TREECREATE DIRECTORY_TREECREATE DIRECTORY_TREECREATE DIRECTORY_TREECREATE DIRECTORY_TREECREATE DIRECTORY_TREECREATE DIRECTORY_TREECREATE DIRECTORY_TREECREATE DIRECTORY_TREECREATE DIRECTORY_TREECREATE DIRECTORY_TREECREATE DIRECTORY_TREECREATE DIRECTORY_TREECREATE DIRECTORY_TREECREATE DIRECTORY_TREECREATE FACILITYCREATE FACILITYCREATE FACILITYCREATE FACILITYCREATE FACILITYCREATE FACILITYCREATE FACILITYCREATE FACILITYCREATE FACILITYCREATE FACILITYCREATE FACILITYCREATE FACILITYCREATE FACILITYCREATE FACILITYCREATE FACILITYCREATE FACILITYCREATE FACILITYCREATE FACILITYCREATE FACILITYCREATE FACILITYCREATE FACILITYCREATE FACILITYCREATE FACILITYCREATE FACILITYCREATE FACILITYCREATE FACILITYCREATE FACILITYCREATE FOLDCREATE FOLDCREATE FOLDCREATE FOLDCREATE FOLDCREATE FOLDCREATE FOLDCREATE FOLDCREATE FOLDCREATE FOLDCREATE FOLDCREATE FOLDCREATE FOLDCREATE FOLDCREATE FOLDCREATE FOLDCREATE FOLDCREATE GROUPCREATE GROUPCREATE GROUPCREATE GROUPCREATE GROUPCREATE GROUPCREATE GROUPCREATE GROUPCREATE GROUPCREATE GROUPCREATE GROUPCREATE GROUPCREATE GROUPCREATE GROUPCREATE GROUPCREATE GROUPCREATE GROUPCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE LIBRARYCREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE MODULECREATE REPLACEMENTCREATE REPLACEMENTCREATE REPLACEMENTCREATE REPLACEMENTCREATE REPLACEMENTCREATE REPLACEMENTCREATE REPLACEMENTCREATE REPLACEMENTCREATE REPLACEMENTCREATE REPLACEMENTCREATE REPLACEMENTCREATE SCRIPTCREATE SCRIPTCREATE SCRIPTCREATE SCRIPTCREATE SCRIPTCREATE SCRIPTCREATE SCRIPTCREATE SCRIPTCREATE SCRIPTCREATE SCRIPTCREATE SCRIPTCREATE SCRIPTCREATE SCRIPTCREATE SCRIPTCREATE SCRIPTCREATE SCRIPTCREATE SCRIPTCREATE SCRIPTCREATE SCRIPTCREATE SCRIPTCREATE SCRIPTCREATE SCRIPTCREATE SCRIPTCREATE SCRIPTCREATE SCRIPTCREATE SCRIPTCREATE SCRIPTCREATE SCRIPTCREATE SCRIPTCREATE SCRIPTCREATE SCRIPTCREATE SCRIPTCREATE SCRIPTCREATE SCRIPTCREATE SESSIONCREATE SESSIONCREATE SESSIONCREATE SESSIONCREATE SESSIONCREATE SESSIONCREATE SESSIONCREATE SESSIONCREATE SESSIONCREATE SESSIONCREATE SESSIONCREATE STEPCREATE STEPCREATE STEPCREATE STEPCREATE STEPCREATE STEPCREATE STEPCREATE STEPCREATE STEPCREATE STEPCREATE STEPCREATE STEPCREATE STEPCREATE STEPCREATE STEPCREATE STEPCREATE STEPCREATE STEPCREATE STEPCREATE STEPCREATE STEPCREATE STEPCREATE STEPCREATE STEPCREATE STEPCREATE STREAMCREATE STREAMCREATE STREAMCREATE STREAMCREATE STREAMCREATE STREAMCREATE STREAMCREATE STREAMCREATE STREAMCREATE STREAMCREATE STREAMCREATE STREAMCREATE STREAMCREATE STREAMCREATE STREAMCREATE STREAMCREATE STREAMCREATE STREAMCREATE STREAMCREATE STREAMCREATE STREAMCREATE STREAMCREATE STREAMCREATE STREAMCREATE STREAMCREATE STREAMCREATE STREAMCREATE STREAMCREATE STREAMCREATE STREAMCREATE STREAMCREATE STREAMCREATE STREAMCREATE STREAMCREATE STREAMCREATE STREAMCREATE STREAMCREATE STREAMCREATE STREAMCREATE STREAMCREATE STREAMCREATE STREAMCREATE STREAMCREATE STREAMCREATE STREAMCREATE STREAMCREATE STREAMCREATE STREAMCREATE STREAMCREATE STREAMCREATE STREAMCREATE STREAMCREATE STREAMCREATE STREAMCREATE USERCREATE USERCREATE USERCREATE USERCREATE USERCREATE USERCREATE USERCREATE USERCREATE USERCREATE USERCREATE USERCREATE USERCREATE USERCREATE USERCREATE USERCREATE USERCREATE USERCREATE USERCREATE USERCREATE USERCREATE USERCREATE USERDEFINE/COMMANDDEFINE/COMMANDDEFINE/COMMANDDEFINE/COMMANDDEFINE/COMMANDDEFINE/COMMANDDEFINE/COMMANDDEFINE/COMMANDDEFINE/COMMANDDEFINE/COMMANDDEFINE/KEYDEFINE/KEYDEFINE/KEYDEFINE/KEYDEFINE/KEYTable 3- 1: Key NamesDEFINE/KEYDEFINE/KEYDEFINE/KEYDEFINE/KEYDEFINE/KEYDEFINE/KEYDEFINE/KEYDEFINE/KEYDEFINE/KEYDEFINE/KEYDEFINE/KEYDEFINE/KEYDEFINE/KEYDEFINE/KEYDEFINE/KEYDEFINE/KEYDEFINE/KEYDELETE/COMMANDDELETE/COMMANDDELETE/COMMANDDELETE/COMMANDDELETE/COMMANDDELETE/COMMANDDELETE/COMMANDDELETE/KEYDELETE/KEYDELETE/KEYDELETE/KEYDELETE/KEYDELETE/KEYDELETE/KEYDELETE/KEYDELETE/KEYDELETE ARCHITECTUREDELETE ARCHITECTUREDELETE ARCHITECTUREDELETE ARCHITECTUREDELETE ARCHITECTUREDELETE ARCHITECTUREDELETE ARCHITECTUREDELETE ARCHITECTUREDELETE ARCHITECTUREDELETE ARCHITECTUREDELETE ARCHITECTUREDELETE BUILD_JOBDELETE BUILD_JOBDELETE BUILD_JOBDELETE BUILD_JOBDELETE BUILD_JOBDELETE BUILD_JOBDELETE BUILD_JOBDELETE BUILD_JOBDELETE BUILD_JOBDELETE BUILD_JOBDELETE BUILD_JOBDELETE BUILD_JOBDELETE BUILD_JOBDELETE BUILD_JOBDELETE CONTEXTDELETE CONTEXTDELETE CONTEXTDELETE CONTEXTDELETE CONTEXTDELETE CONTEXTDELETE CONTEXTDELETE CONTEXTDELETE CONTEXTDELETE CONTEXTDELETE CONTEXTDELETE FACILITYDELETE FACILITYDELETE FACILITYDELETE FACILITYDELETE FACILITYDELETE FACILITYDELETE FACILITYDELETE FACILITYDELETE FACILITYDELETE FACILITYDELETE FACILITYDELETE FOLDDELETE FOLDDELETE FOLDDELETE FOLDDELETE FOLDDELETE FOLDDELETE FOLDDELETE FOLDDELETE FOLDDELETE FOLDDELETE FOLDDELETE FOLDDELETE FOLDDELETE GENERATIONDELETE GENERATIONDELETE GENERATIONDELETE GENERATIONDELETE GENERATIONDELETE GENERATIONDELETE GENERATIONDELETE GENERATIONDELETE GENERATIONDELETE GENERATIONDELETE GENERATIONDELETE GENERATIONDELETE GENERATIONDELETE GENERATIONDELETE GENERATIONDELETE GENERATIONDELETE GENERATIONDELETE GENERATIONDELETE GROUPDELETE GROUPDELETE GROUPDELETE GROUPDELETE GROUPDELETE GROUPDELETE GROUPDELETE GROUPDELETE GROUPDELETE GROUPDELETE GROUPDELETE GROUPDELETE GROUPDELETE MODULEDELETE MODULEDELETE MODULEDELETE MODULEDELETE MODULEDELETE MODULEDELETE MODULEDELETE MODULEDELETE MODULEDELETE MODULEDELETE MODULEDELETE MODULEDELETE MODULEDELETE REPLACEMENTDELETE REPLACEMENTDELETE REPLACEMENTDELETE REPLACEMENTDELETE REPLACEMENTDELETE REPLACEMENTDELETE REPLACEMENTDELETE REPLACEMENTDELETE REPLACEMENTDELETE REPLACEMENTDELETE REPLACEMENTDELETE REPLACEMENTDELETE REPLACEMENTDELETE REPLACEMENTDELETE REPLACEMENTDELETE REPLACEMENTDELETE REPLACEMENTDELETE REPLACEMENTDELETE SCRIPTDELETE SCRIPTDELETE SCRIPTDELETE SCRIPTDELETE SCRIPTDELETE SCRIPTDELETE SCRIPTDELETE SCRIPTDELETE SCRIPTDELETE SCRIPTDELETE SCRIPTDELETE SCRIPTDELETE SCRIPTDELETE SCRIPTDELETE SCRIPTDELETE SCRIPTDELETE SCRIPTDELETE SCRIPTDELETE SCRIPTDELETE SCRIPTDELETE SCRIPTDELETE SCRIPTDELETE SCRIPTDELETE SCRIPTDELETE SCRIPTDELETE SCRIPTDELETE SCRIPTDELETE SCRIPTDELETE STEPDELETE STEPDELETE STEPDELETE STEPDELETE STEPDELETE STEPDELETE STEPDELETE STEPDELETE STEPDELETE STEPDELETE STEPDELETE STEPDELETE STEPDELETE STREAMDELETE STREAMDELETE STREAMDELETE STREAMDELETE STREAMDELETE STREAMDELETE STREAMDELETE STREAMDELETE STREAMDELETE STREAMDELETE STREAMDELETE USERDELETE USERDELETE USERDELETE USERDELETE USERDELETE USERDELETE USERDELETE USER Note 1DELETE USERDELETE USERDELETE USERDELETE USERDELETE USERDELETE USERDIFFERENCESDIFFERENCESDIFFERENCESDIFFERENCESDIFFERENCESDIFFERENCESDIFFERENCESDIFFERENCESDIFFERENCESDIFFERENCESDIFFERENCESDIFFERENCESDIFFERENCESDIFFERENCESDIFFERENCESDIFFERENCESDIFFERENCESDIFFERENCESDIFFERENCESDIFFERENCESDIFFERENCESDIFFERENCESDIFFERENCESDIFFERENCES EXIT EXIT EXIT EXIT EXIT EXIT EXIT EXITEXTRACT SCRIPTEXTRACT SCRIPTEXTRACT SCRIPTEXTRACT SCRIPTEXTRACT SCRIPTEXTRACT SCRIPTEXTRACT SCRIPTEXTRACT SCRIPTEXTRACT SCRIPTEXTRACT SCRIPTEXTRACT SCRIPTEXTRACT SCRIPTEXTRACT SCRIPTEXTRACT SCRIPTEXTRACT SCRIPTEXTRACT SCRIPTEXTRACT SCRIPTEXTRACT SCRIPTEXTRACT SCRIPTEXTRACT SCRIPTEXTRACT SCRIPTEXTRACT SCRIPTEXTRACT SCRIPTEXTRACT SCRIPTEXTRACT SCRIPTEXTRACT SCRIPTEXTRACT SCRIPT FETCH FETCH FETCH FETCH FETCH FETCH FETCH FETCH FETCH FETCH FETCH FETCH FETCH FETCH FETCH FETCH FETCH FETCH FETCH FETCH FETCH FETCH FETCH FETCH FETCH FETCH FETCH FETCH FETCH FETCH FETCH FETCH FETCH FETCH FETCH FETCH FETCH HELP HELP HELP HELP HELP HELP HELP HELPINSERT GENERATIONINSERT GENERATIONINSERT GENERATIONINSERT GENERATIONINSERT GENERATIONINSERT GENERATIONINSERT GENERATIONINSERT GENERATIONINSERT GENERATIONINSERT GENERATIONINSERT GENERATIONINSERT GENERATIONINSERT GENERATIONINSERT GENERATIONINSERT GENERATIONINSERT GENERATIONINSERT GENERATIONINSERT GENERATIONINSERT GENERATIONINSERT GENERATIONINSERT GENERATIONINSERT GENERATIONINSERT GENERATIONINSERT GENERATIONINSERT GENERATIONINVOKE SCRIPTINVOKE SCRIPTINVOKE SCRIPTINVOKE SCRIPTINVOKE SCRIPTINVOKE SCRIPTINVOKE SCRIPTINVOKE SCRIPTINVOKE SCRIPTINVOKE SCRIPTINVOKE SCRIPTINVOKE SCRIPTINVOKE SCRIPTINVOKE SCRIPTINVOKE SCRIPTINVOKE SCRIPTINVOKE SCRIPTINVOKE SCRIPTINVOKE SCRIPTINVOKE SCRIPTINVOKE SCRIPTINVOKE SCRIPTINVOKE SCRIPTINVOKE SCRIPTINVOKE SCRIPTINVOKE SCRIPTINVOKE SCRIPT LINK LINK LINK LINK LINK LINK LINK LINK LINK LINK LINKMODIFY ARCHITECTUREMODIFY ARCHITECTUREMODIFY ARCHITECTUREMODIFY ARCHITECTUREMODIFY ARCHITECTUREMODIFY ARCHITECTUREMODIFY ARCHITECTUREMODIFY ARCHITECTUREMODIFY ARCHITECTUREMODIFY ARCHITECTUREMODIFY ARCHITECTUREMODIFY ARCHITECTUREMODIFY ARCHITECTUREMODIFY ARCHITECTUREMODIFY BUILD_JOBMODIFY BUILD_JOBMODIFY BUILD_JOBMODIFY BUILD_JOBMODIFY BUILD_JOBMODIFY BUILD_JOBMODIFY BUILD_JOBMODIFY BUILD_JOBMODIFY BUILD_JOBMODIFY BUILD_JOBMODIFY BUILD_JOBMODIFY BUILD_JOBMODIFY BUILD_JOBMODIFY BUILD_JOBMODIFY BUILD_JOBMODIFY BUILD_JOBMODIFY BUILD_JOBMODIFY BUILD_JOBMODIFY BUILD_JOBMODIFY BUILD_JOBMODIFY BUILD_JOBMODIFY CONTEXTMODIFY CONTEXTMODIFY CONTEXTMODIFY CONTEXTMODIFY CONTEXTMODIFY CONTEXTMODIFY CONTEXTMODIFY CONTEXTMODIFY CONTEXTMODIFY CONTEXTMODIFY CONTEXTMODIFY CONTEXTMODIFY CONTEXTMODIFY CONTEXTMODIFY CONTEXTMODIFY CONTEXTMODIFY CONTEXTMODIFY CONTEXTMODIFY CONTEXTMODIFY CONTEXTMODIFY FACILITYMODIFY FACILITYMODIFY FACILITYMODIFY FACILITYMODIFY FACILITYMODIFY FACILITYMODIFY FACILITYMODIFY FACILITYMODIFY FACILITYMODIFY FACILITYMODIFY FACILITYMODIFY FACILITYMODIFY FOLDMODIFY FOLDMODIFY FOLDMODIFY FOLDMODIFY FOLDMODIFY FOLDMODIFY FOLDMODIFY FOLDMODIFY FOLDMODIFY FOLDMODIFY FOLDMODIFY FOLDMODIFY FOLDMODIFY FOLDMODIFY GENERATIONMODIFY GENERATIONMODIFY GENERATIONMODIFY GENERATIONMODIFY GENERATIONMODIFY GENERATIONMODIFY GENERATIONMODIFY GENERATIONMODIFY GENERATIONMODIFY GENERATIONMODIFY GENERATIONMODIFY GENERATIONMODIFY GENERATIONMODIFY GENERATIONMODIFY GENERATIONMODIFY GENERATIONMODIFY GENERATIONMODIFY GENERATIONMODIFY GENERATIONMODIFY GENERATIONMODIFY GENERATIONMODIFY GENERATIONMODIFY GENERATIONMODIFY GENERATIONMODIFY GENERATIONMODIFY GENERATIONMODIFY GENERATIONMODIFY GENERATIONMODIFY GENERATIONMODIFY GENERATIONMODIFY GENERATIONMODIFY GROUPMODIFY GROUPMODIFY GROUPMODIFY GROUPMODIFY GROUPMODIFY GROUPMODIFY GROUPMODIFY GROUPMODIFY GROUPMODIFY GROUPMODIFY GROUPMODIFY GROUPMODIFY GROUPMODIFY GROUPMODIFY GROUPMODIFY GROUPMODIFY GROUPMODIFY GROUPMODIFY GROUPMODIFY GROUPMODIFY GROUPMODIFY LIBRARYMODIFY LIBRARYMODIFY LIBRARYMODIFY LIBRARYMODIFY LIBRARYMODIFY LIBRARYMODIFY LIBRARYMODIFY LIBRARYMODIFY LIBRARYMODIFY LIBRARYMODIFY LIBRARYMODIFY LIBRARYMODIFY LIBRARYMODIFY LIBRARYMODIFY LIBRARYMODIFY LIBRARYMODIFY LIBRARYMODIFY LIBRARYMODIFY LIBRARYMODIFY LIBRARYMODIFY LIBRARYMODIFY LIBRARYMODIFY LIBRARYMODIFY LIBRARYMODIFY LIBRARYMODIFY LIBRARYMODIFY LIBRARYMODIFY LIBRARYMODIFY LIBRARYMODIFY LIBRARYMODIFY LIBRARYMODIFY LIBRARYMODIFY LIBRARYMODIFY LIBRARYMODIFY LIBRARYMODIFY LIBRARYMODIFY LIBRARYMODIFY LIBRARYMODIFY LIBRARYMODIFY LIBRARYMODIFY MODULEMODIFY MODULEMODIFY MODULEMODIFY MODULEMODIFY MODULEMODIFY MODULEMODIFY MODULEMODIFY MODULEMODIFY MODULEMODIFY MODULEMODIFY MODULEMODIFY MODULEMODIFY MODULEMODIFY MODULEMODIFY MODULEMODIFY MODULEMODIFY MODULEMODIFY MODULEMODIFY MODULEMODIFY MODULEMODIFY MODULEMODIFY MODULEMODIFY MODULEMODIFY MODULEMODIFY MODULEMODIFY MODULEMODIFY MODULEMODIFY MODULEMODIFY MODULEMODIFY MODULEMODIFY MODULEMODIFY MODULEMODIFY MODULEMODIFY MODULEMODIFY MODULEMODIFY MODULEMODIFY MODULEMODIFY MODULEMODIFY REPLACEMENTMODIFY REPLACEMENTMODIFY REPLACEMENTMODIFY REPLACEMENTMODIFY REPLACEMENTMODIFY REPLACEMENTMODIFY REPLACEMENTMODIFY REPLACEMENTMODIFY REPLACEMENTMODIFY REPLACEMENTMODIFY REPLACEMENTMODIFY REPLACEMENTMODIFY REPLACEMENTMODIFY REPLACEMENTMODIFY REPLACEMENTMODIFY REPLACEMENTMODIFY REPLACEMENTMODIFY REPLACEMENTMODIFY REPLACEMENTMODIFY REPLACEMENTMODIFY REPLACEMENTMODIFY RESERVATIONMODIFY RESERVATIONMODIFY RESERVATIONMODIFY RESERVATIONMODIFY RESERVATIONMODIFY RESERVATIONMODIFY RESERVATIONMODIFY RESERVATIONMODIFY RESERVATIONMODIFY RESERVATIONMODIFY RESERVATIONMODIFY RESERVATIONMODIFY RESERVATIONMODIFY RESERVATIONMODIFY RESERVATIONMODIFY RESERVATIONMODIFY RESERVATIONMODIFY RESERVATIONMODIFY RESERVATIONMODIFY RESERVATIONMODIFY RESERVATIONMODIFY RESERVATIONMODIFY RESERVATIONMODIFY RESERVATIONMODIFY RESERVATIONMODIFY RESERVATIONMODIFY RESERVATIONMODIFY RESERVATIONMODIFY RESERVATIONMODIFY RESERVATIONMODIFY SCRIPTMODIFY SCRIPTMODIFY SCRIPTMODIFY SCRIPTMODIFY SCRIPTMODIFY SCRIPTMODIFY SCRIPTMODIFY SCRIPTMODIFY SCRIPTMODIFY SCRIPTMODIFY SCRIPTMODIFY SCRIPTMODIFY SCRIPTMODIFY SCRIPTMODIFY SCRIPTMODIFY SCRIPTMODIFY SCRIPTMODIFY SCRIPTMODIFY SCRIPTMODIFY SCRIPTMODIFY SCRIPTMODIFY SCRIPTMODIFY SCRIPTMODIFY SCRIPTMODIFY SCRIPTMODIFY SCRIPTMODIFY SCRIPTMODIFY SCRIPTMODIFY SCRIPTMODIFY SESSIONMODIFY SESSIONMODIFY SESSIONMODIFY SESSIONMODIFY SESSIONMODIFY SESSIONMODIFY SESSIONMODIFY SESSIONMODIFY SESSIONMODIFY SESSIONMODIFY STEPMODIFY STEPMODIFY STEPMODIFY STEPMODIFY STEPMODIFY STEPMODIFY STEPMODIFY STEPMODIFY STEPMODIFY STEPMODIFY STEPMODIFY STEPMODIFY STEPMODIFY STEPMODIFY STEPMODIFY STEPMODIFY STEPMODIFY STEPMODIFY STEPMODIFY STEPMODIFY STREAMMODIFY STREAMMODIFY STREAMMODIFY STREAMMODIFY STREAMMODIFY STREAMMODIFY STREAMMODIFY STREAMMODIFY STREAMMODIFY STREAMMODIFY STREAMMODIFY STREAMMODIFY STREAMMODIFY STREAMMODIFY STREAMMODIFY STREAMMODIFY STREAMMODIFY STREAMMODIFY STREAMMODIFY STREAMMODIFY STREAMMODIFY STREAMMODIFY STREAMMODIFY STREAMMODIFY STREAMMODIFY STREAMMODIFY STREAMMODIFY STREAMMODIFY STREAMMODIFY STREAMMODIFY STREAMMODIFY STREAMMODIFY STREAMMODIFY STREAMMODIFY STREAMMODIFY STREAMMODIFY STREAMMODIFY STREAMMODIFY STREAMMODIFY STREAMMODIFY STREAMMODIFY STREAMMODIFY STREAMMODIFY STREAMMODIFY USERMODIFY USERMODIFY USERMODIFY USERMODIFY USERMODIFY USERMODIFY USERMODIFY USERMODIFY USERMODIFY USERMODIFY USERMODIFY USERMODIFY USERMODIFY USERMODIFY USERMODIFY USERMODIFY USERMODIFY USERMODIFY USERMODIFY USERMODIFY USERMODIFY USERMODIFY USERMODIFY USERMODIFY USERPERFORM REPLACEMENTPERFORM REPLACEMENTPERFORM REPLACEMENTPERFORM REPLACEMENTPERFORM REPLACEMENTPERFORM REPLACEMENTPERFORM REPLACEMENTPERFORM REPLACEMENTPERFORM REPLACEMENTPERFORM REPLACEMENTPERFORM REPLACEMENTPERFORM REPLACEMENTPERFORM REPLACEMENTPERFORM REPLACEMENTPOPULATE STREAMPOPULATE STREAMPOPULATE STREAMPOPULATE STREAMPOPULATE STREAMPOPULATE STREAMPOPULATE STREAMPOPULATE STREAMPOPULATE STREAMPOPULATE STREAMPOPULATE STREAMPOPULATE STREAMPOPULATE STREAMPOPULATE STREAMPOPULATE STREAMPOPULATE STREAMPOPULATE STREAMREJECT REPLACEMENTREJECT REPLACEMENTREJECT REPLACEMENTREJECT REPLACEMENTREJECT REPLACEMENTREJECT REPLACEMENTREJECT REPLACEMENTREJECT REPLACEMENTREJECT REPLACEMENTREJECT REPLACEMENTREJECT REPLACEMENTREJECT REPLACEMENTREJECT REPLACEMENTREJECT REPLACEMENTREJECT REPLACEMENTREJECT REPLACEMENTREJECT REPLACEMENTREMOVE GENERATIONREMOVE GENERATIONREMOVE GENERATIONREMOVE GENERATIONREMOVE GENERATIONREMOVE GENERATIONREMOVE GENERATIONREMOVE GENERATIONREMOVE GENERATIONREMOVE GENERATIONREMOVE GENERATIONREMOVE GENERATIONREMOVE GENERATIONREMOVE GENERATIONREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACETable 3- 2: ReasonsREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACEREPL } }ACEREPLACEREPLACEREPLACEREPLACEREPLACEREPLACERESERVERESERVERESERVERESERVERESERVERESERVERESERVERESERVERESERVERESERVERESERVERESERVERESERVERESERVERESERVERESERVERESERVERESERVERESERVERESERVERESERVERESERVERESERVERESERVERESERVERESERVERESERVERESERVERESERVERESERVERESERVERESERVERESERVERESERVERESERVERESERVERESERVERESERVERESERVERESERVERESERVERESERVERESERVERESERVERESERVERESERVERESERVERESERVERESERVERESERVERESERVERESERVERESERVERESERVERESERVERESERVERESERVEREVIEW BUILD_JOBREVIEW BUILD_JOBREVIEW BUILD_JOBREVIEW BUILD_JOBREVIEW BUILD_JOBREVIEW BUILD_JOBREVIEW BUILD_JOBREVIEW BUILD_JOBREVIEW BUILD_JOBREVIEW BUILD_JOBREVIEW BUILD_JOBREVIEW BUILD_JOB Review Build Job Commands Review Build Job Commands Review Build Job Commands Review Build Job Commands Review Build Job Commands Review Build Job Commands Review Build Job Commands Review Build Job Commands Review Build Job Commands Review Build Job Commands Review Build Job Commands Review Build Job Commands Review Build Job Commands Review Build Job Commands Review Build Job Commands Review Build Job Commands Review Build Job Commands Review Build Job Commands Review Build Job CommandsREVIEW REPLACEMENTREVIEW REPLACEMENTREVIEW REPLACEMENTREVIEW REPLACEMENTREVIEW REPLACEMENTREVIEW REPLACEMENTREVIEW REPLACEMENTREVIEW REPLACEMENTREVIEW REPLACEMENTREVIEW REPLACEMENTREVIEW REPLACEMENTREVIEW REPLACEMENT"Review Replacement Commands"Review Replacement Commands"Review Replacement Commands"Review Replacement Commands"Review Replacement Commands"Review Replacement Commands"Review Replacement Commands"Review Replacement Commands"Review Replacement Commands"Review Replacement Commands"Review Replacement Commands"Review Replacement Commands"Review Replacement Commands"Review Replacement Commands"Review Replacement Commands"Review Replacement Commands"Review Replacement Commands"Review Replacement Commands"Review Replacement Commands"Review Replacement Commands"Review Replacement Commands"Review Replacement Commands"Review Replacement Commands"Review Replacement Commands"Review Replacement Commands"Review Replacement Commands"Review Replacement CommandsScript KeywordsScript KeywordsScript KeywordsScript KeywordsScript KeywordsScript KeywordsScript KeywordsScript KeywordsScript KeywordsScript KeywordsScript KeywordsScript KeywordsScript KeywordsScript KeywordsScript KeywordsScript KeywordsScript KeywordsScript KeywordsScript KeywordsScript KeywordsScript KeywordsScript KeywordsScript KeywordsScript KeywordsScript KeywordsScript KeywordsScript KeywordsScript KeywordsScript KeywordsScript KeywordsScript KeywordsScript KeywordsScript KeywordsScript KeywordsScript KeywordsScript KeywordsScript KeywordsScript KeywordsScript KeywordsScript KeywordsScript KeywordsScript KeywordsScript KeywordsScript KeywordsScript KeywordsScript KeywordsScript KeywordsScript KeywordsScript KeywordsScript FunctionsScript FunctionsScript FunctionsScript FunctionsScript FunctionsScript FunctionsScript FunctionsScript FunctionsScript FunctionsScript FunctionsScript FunctionsScript FunctionsScript FunctionsScript FunctionsScript FunctionsScript FunctionsScript FunctionsScript FunctionsScript FunctionsScript FunctionsScript FunctionsScript FunctionsScript FunctionsScript FunctionsScript FunctionsScript FunctionsScript FunctionsScript FunctionsScript FunctionsScript FunctionsScript FunctionsScript FunctionsScript FunctionsScript FunctionsScript FunctionsScript TypesScript TypesScript TypesScript TypesScript TypesScript TypesScript TypesScript TypesScript TypesTable 3- 3: Script TypesTable 3- 3: Script TypesTable 3- 3: Script TypesScript TypesSET ARCHITECTURESET ARCHITECTURESET ARCHITECTURESET ARCHITECTURESET ARCHITECTURESET ARCHITECTURESET ARCHITECTURESET CONTEXTSET CONTEXTSET CONTEXTSET CONTEXTSET CONTEXTSET CONTEXTSET CONTEXTSET CONTEXTSET CONTEXTSET CONTEXTSET CONTEXTSET CONTEXTSET CONTEXTSET CONTEXTSET DEVELOPERSET DEVELOPERSET DEVELOPERSET DEVELOPERSET DEVELOPERTable 3- 4: ParametersSET DEVELOPERSET DIRECTORYSET DIRECTORYSET DIRECTORYSET DIRECTORYSET DIRECTORYSET DIRECTORYSET DIRECTORYSET DIRECTORYSET DIRECTORYSET DIRECTORYSET DIRECTORYSET DIRECTORYSET DIRECTORYSET DIRECTORYSET DIRECTORYSET DIRECTORYSET DIRECTORYSET DIRECTORYSET DIRECTORYSET DIRECTORYSET DIRECTORYSET DIRECTORYSET DIRECTORYSET DIRECTORYSET EDITORSET EDITORSET EDITORSET EDITORSET EDITORSET EDITORSET EDITORSET EDITORSET EDITORSET EDITORSET EDITORSET EDITORSET FACILITYSET FACILITYSET FACILITYSET FACILITYSET FACILITYSET FACILITYSET FACILITYSET KEYSET KEYSET KEYSET KEYSET KEYSET KEYSET KEYSET KEYSET LIBRARYSET LIBRARYSET LIBRARYSET LIBRARYSET LIBRARYSET LIBRARYSET LIBRARYSET LIBRARYSET LIBRARYSET LIBRARYSET LIBRARYSET LIBRARYSET LIBRARYSET LIBRARYSET LIBRARYSET LOGSET LOGSET LOGSET LOGSET LOGSET LOGSET LOGSET LOGSET NOVERIFYSET NOVERIFYSET NOVERIFYSET NOVERIFYSET NOVERIFYSET NOVERIFYSET NOVERIFYSET NOVERIFYSET PRIVILEGESSET PRIVILEGESSET PRIVILEGESSET PRIVILEGESSET PRIVILEGESTable 3- 5: PrivilegesSET PRIVILEGESSET PRIVILEGESSET PRIVILEGESSET PRIVILEGESSET PRIVILEGESSET PRIVILEGESSET PRIVILEGESSET PRIVILEGESSET PRIVILEGESSET PRIVILEGESSET PRIVILEGESSET PROMPTSET PROMPTSET PROMPTSET PROMPTSET PROMPTSET PROMPTSET PROMPTSET STREAMSET STREAMSET STREAMSET STREAMSET STREAMSET STREAMSET STREAMSET TERMINALSET TERMINALSET TERMINALSET TERMINALSET TERMINALSET TERMINALSET TERMINALSET TERMINALSET TERMINALSET VERIFYSET VERIFYSET VERIFYSET VERIFYSET VERIFYSET VERIFYSET VERIFYSET VERIFYSHOW ARCHITECTURESHOW ARCHITECTURESHOW ARCHITECTURESHOW ARCHITECTURESHOW ARCHITECTURESHOW ARCHITECTURESHOW ARCHITECTURESHOW ARCHITECTURESHOW ARCHITECTURESHOW ARCHITECTURESHOW ARCHITECTURESHOW ARCHITECTURESHOW BUILD_JOBSHOW BUILD_JOBSHOW BUILD_JOBSHOW BUILD_JOBSHOW BUILD_JOBSHOW BUILD_JOBSHOW BUILD_JOBSHOW BUILD_JOBSHOW BUILD_JOBSHOW BUILD_JOBSHOW BUILD_JOBSHOW BUILD_JOBSHOW BUILD_JOBSHOW BUILD_JOBSHOW BUILD_JOBSHOW BUILD_JOBSHOW BUILD_JOBSHOW BUILD_JOBSHOW BUILD_JOBSHOW BUILD_JOBSHOW BUILD_JOBSHOW BUILD_JOBSHOW BUILD_JOBSHOW BUILD_JOBSHOW BUILD_JOBSHOW BUILD_JOBSHOW BUILD_JOBSHOW BUILD_JOBSHOW BUILD_JOBSHOW BUILD_JOBSHOW CONTEXTSHOW CONTEXTSHOW CONTEXTSHOW CONTEXTSHOW CONTEXTSHOW CONTEXTSHOW CONTEXTSHOW CONTEXTSHOW CONTEXTSHOW CONTEXTSHOW CONTEXTSHOW CONTEXTSHOW CONTEXTSHOW DEFAULTSSHOW DEFAULTSSHOW DEFAULTSSHOW DEFAULTSSHOW DEFAULTSSHOW DEFAULTSSHOW DEFAULTSSHOW DEFAULTSSHOW DEVELOPERSHOW DEVELOPERSHOW DEVELOPERSHOW DEVELOPERSHOW DEVELOPERSHOW DEVELOPERSHOW DIRECTORYSHOW DIRECTORYSHOW DIRECTORYSHOW DIRECTORYSHOW DIRECTORYSHOW DIRECTORYSHOW DIRECTORYSHOW DIRECTORYSHOW DIRECTORYSHOW DIRECTORYSHOW DIRECTORYSHOW DIRECTORYSHOW EDITORSHOW EDITORSHOW EDITORSHOW EDITORSHOW EDITORSHOW EDITORSHOW EDITORSHOW EDITORSHOW FACILITYSHOW FACILITYSHOW FACILITYSHOW FACILITYSHOW FACILITYSHOW FACILITYSHOW FACILITYSHOW FACILITYSHOW FACILITYSHOW FACILITYSHOW FACILITYSHOW FACILITYSHOW FACILITYSHOW FOLDSHOW FOLDSHOW FOLDSHOW FOLDSHOW FOLDSHOW FOLDSHOW FOLDSHOW FOLDSHOW FOLDSHOW FOLDSHOW FOLDSHOW FOLDSHOW FOLDSHOW FOLDSHOW FOLDSHOW FOLDSHOW GENERATIONSHOW GENERATIONSHOW GENERATIONSHOW GENERATIONSHOW GENERATIONSHOW GENERATIONSHOW GENERATIONSHOW GENERATIONSHOW GENERATIONSHOW GENERATIONSHOW GENERATIONSHOW GENERATIONSHOW GENERATIONSHOW GENERATIONSHOW GENERATIONSHOW GENERATIONSHOW GENERATIONSHOW GENERATIONSHOW GENERATIONSHOW GENERATIONSHOW GENERATIONSHOW GENERATIONSHOW GENERATIONSHOW GENERATIONSHOW GENERATIONSHOW GENERATIONSHOW GENERATIONSHOW GENERATIONSHOW GENERATIONSHOW GENERATIONSHOW GENERATIONSHOW GENERATIONSHOW GENERATIONSHOW GENERATIONSHOW GENERATIONSHOW GENERATIONSHOW GROUPSHOW GROUPSHOW GROUPSHOW GROUPSHOW GROUPSHOW GROUPSHOW GROUPSHOW GROUPSHOW GROUPSHOW GROUPSHOW GROUPSHOW GROUPSHOW GROUPSHOW GROUPSHOW KEYSHOW KEYSHOW KEYSHOW KEYSHOW KEYSHOW KEYSHOW KEYSHOW KEYSHOW KEYSHOW KEYSHOW KEYSHOW KEYSHOW KEYSHOW LIBRARYSHOW LIBRARYSHOW LIBRARYSHOW LIBRARYSHOW LIBRARYSHOW LIBRARYSHOW LIBRARYSHOW LIBRARYSHOW LOCATIONSHOW LOCATIONSHOW LOCATIONSHOW LOCATIONSHOW LOCATIONSHOW LOCATIONSHOW LOCATIONSHOW LOCATIONSHOW LOCATIONSHOW LOCATIONSHOW LOCATIONSHOW LOCATIONSHOW LOCATIONSHOW LOGSHOW LOGSHOW LOGSHOW LOGSHOW LOGSHOW LOGSHOW LOGSHOW MEMORYSHOW MEMORYSHOW MEMORYSHOW MEMORYSHOW MEMORYSHOW MEMORYSHOW MEMORYSHOW MEMORYSHOW MEMORYSHOW MEMORYSHOW MODULESHOW MODULESHOW MODULESHOW MODULESHOW MODULESHOW MODULESHOW MODULESHOW MODULESHOW MODULESHOW MODULESHOW MODULESHOW MODULESHOW MODULESHOW MODULESHOW MODULESHOW MODULESHOW MODULESHOW MODULESHOW MODULESHOW PRIVILEGESSHOW PRIVILEGESSHOW PRIVILEGESSHOW PRIVILEGESSHOW PRIVILEGESSHOW PRIVILEGESSHOW PRIVILEGESSHOW PRIVILEGESSHOW PRIVILEGESSHOW REPLACEMENTSHOW REPLACEMENTSHOW REPLACEMENTSHOW REPLACEMENTSHOW REPLACEMENTSHOW REPLACEMENTSHOW REPLACEMENTSHOW REPLACEMENTSHOW REPLACEMENTSHOW REPLACEMENTSHOW REPLACEMENTSHOW REPLACEMENTSHOW REPLACEMENTSHOW REPLACEMENTSHOW REPLACEMENTSHOW REPLACEMENTSHOW REPLACEMENTSHOW REPLACEMENTSHOW REPLACEMENTSHOW REPLACEMENTSHOW REPLACEMENTSHOW REPLACEMENTSHOW REPLACEMENTSHOW REPLACEMENTSHOW REPLACEMENTSHOW REPLACEMENTSHOW REPLACEMENTSHOW REPLACEMENTSHOW REPLACEMENTSHOW REPLACEMENTSHOW RESERVATIONSHOW RESERVATIONSHOW RESERVATIONSHOW RESERVATIONSHOW RESERVATIONSHOW RESERVATIONSHOW RESERVATIONSHOW RESERVATIONSHOW RESERVATIONSHOW RESERVATIONSHOW RESERVATIONSHOW RESERVATIONSHOW RESERVATIONSHOW RESERVATIONSHOW RESERVATIONSHOW RESERVATIONSHOW RESERVATIONSHOW RESERVATIONSHOW RESERVATIONSHOW RESERVATIONSHOW SCRIPTSHOW SCRIPTSHOW SCRIPTSHOW SCRIPTSHOW SCRIPTSHOW SCRIPTSHOW SCRIPTSHOW SCRIPTSHOW SCRIPTSHOW SCRIPTSHOW SCRIPTSHOW SCRIPTSHOW SCRIPTSHOW SCRIPTSHOW SCRIPTSHOW SCRIPTSHOW SCRIPTSHOW SCRIPTSHOW SCRIPTSHOW SCRIPTSHOW SCRIPTSHOW SCRIPTSHOW SCRIPTSHOW SCRIPTSHOW SCRIPTSHOW SCRIPTSHOW SCRIPTSHOW SCRIPTSHOW SCRIPTSHOW SCRIPTSHOW SCRIPTSHOW SCRIPTSHOW SCRIPTSHOW SCRIPTSHOW SCRIPTSHOW SCRIPTSHOW SCRIPTSHOW SCRIPTSHOW SESSIONSHOW SESSIONSHOW SESSIONSHOW SESSIONSHOW SESSIONSHOW SESSIONSHOW SESSIONSHOW SESSIONSHOW SESSIONSHOW SESSIONSHOW SESSIONSHOW SESSIONSHOW SESSIONSHOW SESSIONSHOW SESSIONSHOW SESSIONSHOW SESSIONSHOW SESSIONSHOW SESSIONSHOW SESSIONSHOW SESSIONSHOW SESSIONSHOW STEPSHOW STEPSHOW STEPSHOW STEPSHOW STEPSHOW STEPSHOW STEPSHOW STEPSHOW STEPSHOW STEPSHOW STEPSHOW STEPSHOW STEPSHOW STEPSHOW STEPSHOW STREAMSHOW STREAMSHOW STREAMSHOW STREAMSHOW STREAMSHOW STREAMSHOW STREAMSHOW STREAMSHOW STREAMSHOW STREAMSHOW STREAMSHOW STREAMSHOW STREAMSHOW STREAMSHOW STREAMSHOW STREAMSHOW SYMBOLSHOW SYMBOLSHOW SYMBOLSHOW SYMBOLSHOW SYMBOLSHOW SYMBOLSHOW SYMBOLSHOW SYMBOLSHOW TERMINALSHOW TERMINALSHOW TERMINALSHOW TERMINALSHOW TERMINALSHOW TERMINALSHOW TERMINALSHOW USERSHOW USERSHOW USERSHOW USERSHOW USERSHOW USERSHOW USERSHOW USERSHOW USERSHOW USERSHOW USERSHOW USERSHOW USERSHOW VERIFYSHOW VERIFYSHOW VERIFYSHOW VERIFYSHOW VERIFYSHOW VERIFYSHOW VERIFYSHOW VERSIONSHOW VERSIONSHOW VERSIONSHOW VERSIONSHOW VERSIONSHOW VERSIONSHOW VERSION SPAWN SPAWN SPAWN SPAWN SPAWN SPAWN SPAWN SPAWN SPAWN SPAWN SPAWN SPAWNSTART BUILD_JOBSTART BUILD_JOBSTART BUILD_JOBSTART BUILD_JOBSTART BUILD_JOBSTART BUILD_JOBSTART BUILD_JOBSTART BUILD_JOBSTART BUILD_JOBSTART BUILD_JOBSTART BUILD_JOBSTART BUILD_JOBSTART BUILD_JOBSTART BUILD_JOBSTART BUILD_JOBSTART BUILD_JOBSTART BUILD_JOBSTART BUILD_JOBSTART BUILD_JOBSTART BUILD_JOBSTART BUILD_JOBSTOP BUILD_JOBSTOP BUILD_JOBSTOP BUILD_JOBSTOP BUILD_JOBSTOP BUILD_JOBSTOP BUILD_JOBSTOP BUILD_JOBSTOP BUILD_JOBSTOP BUILD_JOBSTOP BUILD_JOBSTOP BUILD_JOBSTOP BUILD_JOBSTOP SUBPROCESSSTOP SUBPROCESSSTOP SUBPROCESSSTOP SUBPROCESSSTOP SUBPROCESSSTOP SUBPROCESSSTOP SUBPROCESSSUSPEND BUILD_JOBSUSPEND BUILD_JOBSUSPEND BUILD_JOBSUSPEND BUILD_JOBSUSPEND BUILD_JOBSUSPEND BUILD_JOBSUSPEND BUILD_JOBSUSPEND BUILD_JOBSUSPEND BUILD_JOBSUSPEND BUILD_JOBSUSPEND BUILD_JOBSUSPEND BUILD_JOBUNRESERVEUNRESERVEUNRESERVEUNRESERVEUNRESERVEUNRESERVEUNRESERVEUNRESERVEUNRESERVEUNRESERVEUNRESERVEUNRESERVEUNRESERVEUNRESERVEUNRESERVEUNRESERVEUNRESERVEUNRESERVEUNRESERVEUNRESERVEVERIFY GENERATIONVERIFY GENERATIONVERIFY GENERATIONVERIFY GENERATIONVERIFY GENERATIONVERIFY GENERATIONVERIFY GENERATIONVERIFY GENERATIONVERIFY GENERATIONVERIFY GENERATIONVERIFY GENERATIONVERIFY GENERATIONVERIFY GENERATIONVERIFY GENERATIONVERIFY GENERATIONVERIFY GENERATIONVERIFY GENERATIONVERIFY GENERATIONWAIT BUILD_JOBWAIT BUILD_JOBWAIT BUILD_JOBWAIT BUILD_JOBWAIT BUILD_JOBWAIT BUILD_JOBWAIT BUILD_JOBWAIT BUILD_JOBWAIT BUILD_JOBWAIT BUILD_JOBWAIT BUILD_JOBWAIT BUILD_JOBWAIT BUILD_JOB"A. Associated Logical Names Table A- 1: Logical Names Table A- 1: Logical Names Table A- 1: Logical Names Table A- 1: Logical Names&B. Recording Build DependenciesThis appendix describes the callable interface that records build dependencies in the OpenVMS database. This interface allows the OpenVMS LINKER and various language proces- sors to record the input and output modules of a given build step in the VDE databLIB$REC_DEPENDENCYLIB$REC_DEPENDENCYLIB$REC_DEPENDENCYLIB$REC_DEPENDENCYLIB$REC_DEPENDENCY#Table B- 1: Dependency CodesLIB$REC_DEPENDENCYLIB$REC_DEPENDENCYLIB$REC_DEPENDENCYLIB$REC_DEPENDENCYLIB$REC_DEPENDENCYLIB$REC_DEPENDENCYLIB$REC_DEPENDENCYLIB$REC_DEPENDENCYLIB$REC_DEPENDENCYLIB$REC_DEPENDENCYLIB$REC_DEPENDENCYLIB$REC_DEPENDENCYLIB$REC_DEPENDENCYLIB$REC_DEPENDENCYLIB$REC_DEPENDENCYLIB$REC_DEPENDENCYLIB$REC_DEPENDENCYLIB$REC_DEPENDENCYLIB$REC_DEPENDENCYLIB$REC_DEPENDENCYLIB$REC_DEPENDENCYLIB$REC_DEPENDENCYLIB$REC_DEPENDENCYLIB$REC_DEPENDENCYLIB$REC_DEPENDENCYLIB$REC_DEPENDENCYLIB$REC_DEPENDENCYLIB$REC_DEPENDENCYLIB$REC_DEPENDENCYLIB$REC_DEPENDENCYLIB$REC_DEPENDENCYLIB$REC_DEPENDENCYLIB$REC_DEPENDENCYEXAMPLEC. Callable InterfaceThis appendix describes the VDE callable interface. Note This interface is under development and is subject to change. Please contact VDE support before attempting to use this interface.This appendix describes the VDE callable interface. Note This interface is under development and is subject to change. Please contact VDE support before attempting to use this interface.!Table C- 1: Itemlist Codes!Table C- 1: Itemlist CodesVDE$FetchModuleVDE$FetchModuleVDE$FetchModuleVDE$FetchModuleVDE$FetchModuleVDE$FetchModuleVDE$FetchModuleVDE$FetchModuleVDE$FetchModuleVDE$FetchModuleVDE$FetchModuleVDE$FetchModuleVDE$FetchModuleVDE$FetchModuleVDE$FetchModuleVDE$FetchModuleEXAMPLEVDE$ReplaceModuleVDE$ReplaceModuleVDE$ReplaceModuleVDE$ReplaceModuleVDE$ReplaceModuleVDE$ReplaceModuleVDE$ReplaceModuleVDE$ReplaceModuleVDE$ReplaceModuleVDE$ReplaceModuleVDE$ReplaceModuleVDE$ReplaceModuleVDE$ReplaceModuleVDE$ReplaceModuleVDE$ReplaceModuleVDE$ReplaceModuleVDE$ReplaceModuleEXAMPLEVDE$SetFacilityVDE$SetFacilityVDE$SetFacilityVDE$SetFacilityVDE$SetFacilityVDE$SetFacilityVDE$SetFacilityVDE$SetFacilityVDE$SetFacilityVDE$SetFacilityVDE$SetFacilityVDE$SetFacilityVDE$SetFacilityVDE$SetFacilityVDE$SetFacilityVDE$SetFacilityVDE$SetFacilityEXAMPLEVDE$SetLibraryVDE$SetLibraryVDE$SetLibraryVDE$SetLibraryVDE$SetLibraryVDE$SetLibraryVDE$SetLibraryVDE$SetLibraryVDE$SetLibraryVDE$SetLibraryVDE$SetLibraryVDE$SetLibraryVDE$SetLibraryVDE$SetLibraryVDE$SetLibraryVDE$SetLibraryVDE$SetLibraryEXAMPLEVDE$SetStreamVDE$SetStreamVDE$SetStreamVDE$SetStreamVDE$SetStreamVDE$SetStreamVDE$SetStreamVDE$SetStreamVDE$SetStreamVDE$SetStreamVDE$SetStreamVDE$SetStreamVDE$SetStreamVDE$SetStreamVDE$SetStreamVDE$SetStreamVDE$SetStreamEXAMPLEVDE$ShowFacilitiesVDE$ShowFacilitiesVDE$ShowFacilitiesVDE$ShowFacilitiesVDE$ShowFacilitiesVDE$ShowFacilitiesVDE$ShowFacilitiesVDE$ShowFacilitiesVDE$ShowFacilitiesVDE$ShowFacilitiesVDE$ShowFacilitiesVDE$ShowFacilitiesVDE$ShowFacilitiesVDE$ShowFacilitiesVDE$ShowFacilitiesVDE$ShowFacilitiesVDE$ShowFacilitiesEXAMPLEVDE$ShowProjectsVDE$ShowProjectsVDE$ShowProjectsVDE$ShowProjectsVDE$ShowProjectsVDE$ShowProjectsVDE$ShowProjectsVDE$ShowProjectsVDE$ShowProjectsVDE$ShowProjectsVDE$ShowProjectsVDE$ShowProjectsVDE$ShowProjectsVDE$ShowProjectsVDE$ShowProjectsVDE$ShowProjectsVDE$ShowProjectsEXAMPLEVDE$ShowLibraryVDE$ShowLibraryVDE$ShowLibraryVDE$ShowLibraryVDE$ShowLibraryVDE$ShowLibraryVDE$ShowLibraryVDE$ShowLibraryVDE$ShowLibraryVDE$ShowLibraryVDE$ShowLibraryVDE$ShowLibraryVDE$ShowLibraryVDE$ShowLibraryVDE$ShowLibraryVDE$ShowLibraryVDE$ShowLibraryEXAMPLEVDE$ShowModulesVDE$ShowModulesVDE$ShowModulesVDE$ShowModulesVDE$ShowModulesVDE$ShowModulesVDE$ShowModulesVDE$ShowModulesVDE$ShowModulesVDE$ShowModulesVDE$ShowModulesVDE$ShowModulesVDE$ShowModulesVDE$ShowModulesVDE$ShowModulesVDE$ShowModulesVDE$ShowModulesEXAMPLEVDE$ShowStreamsVDE$ShowStreamsVDE$ShowStreamsVDE$ShowStreamsVDE$ShowStreamsVDE$ShowStreamsVDE$ShowStreamsVDE$ShowStreamsVDE$ShowStreamsVDE$ShowStreamsVDE$ShowStreamsVDE$ShowStreamsVDE$ShowStreamsVDE$ShowStreamsVDE$ShowStreamsVDE$ShowStreamsVDE$ShowStreamsEXAMPLEVDE$UnreserveModuleVDE$UnreserveModuleVDE$UnreserveModuleVDE$UnreserveModuleVDE$UnreserveModuleVDE$UnreserveModuleVDE$UnreserveModuleVDE$UnreserveModuleVDE$UnreserveModuleVDE$UnreserveModuleVDE$UnreserveModuleVDE$UnreserveModuleVDE$UnreserveModuleVDE$UnreserveModuleVDE$UnreserveModuleVDE$UnreserveModuleVDE$UnreserveModuleEXAMPLED. CMS Library UploaderD. CMS Library UploaderD. CMS Library UploaderD. CMS Library Uploader$Table D- 1: VDE$UPLOAD Syntax$Table D- 1: VDE$UPLOAD Syntax$Table D- 1: VDE$UPLOAD Syntax$Table D- 1: VDE$UPLOAD SyntaxD. CMS Library UploaderE. Error MessagesOABKEYW, ambiguous qualifier or keyword ' text ' - supply more characters=ABTBADST, VDE may be in an inconsistent internal state-ABTCNTLC, command aborted by Control-C5ADATETIME, accepted.checkin.datetime: datetime6AERRORS, accepted.checkin.defectsfixed: defects,AGROUP, accepted.checkin.group: group)AITEM, accepted.checkin.item: item0AMODULE, accepted.checkin.module: modname2ANOTE, accepted.checkin.note: topic . replyAARCHADDED, architecture architecture added to the databaseCARCHDEL, architecture architecture deleted from the databaseVARCHEXISTS, architecture architecture already ex- ists in database; not changedRARCHMOD, information for architecture architecture modified in the database8ARCHNOTDEL, architecture architecture not deletedWARCHNOTFOUND, architecture architecture not found in database; parameter ignored9ARCHSYNTAX, invalid architecture name syntax: name3AREASON, accepted.checkin.reasonmask: reason6AREPLID, accepted.checkin.replacementid: replid5AREPLNAME, accepted.checkin.replname: replname8ARMPBCMSDIR, accepted.module.cmslibrary: cms- dir/ARMPBCOUNT, accepted.module.count: count9ARMPBGENNEW, accepted.module.newgeneration: newgen9ARMPBGENOLD, accepted.module.oldgeneration: oldgen9ARMPBMODFLAG, accepted.module.modflags: mod- flags5ARMPBMODNAME, accepted.module.modname: modnameDARMPBREPLREMARK, accepted.module.replaceremark: replaceremarkCARMPBRESREMARK, accepted.module.reserveremark: reserveremark5ARMPBSTAGING, accepted.module.staging: staging/ASTREAM, accepted.checkin.stream: stream>ATTACHED, terminal now attached to process process-name/ATYPCOD, accepted.checkin.typecode: type/ATYPNAM, accepted.checkin.typename: type5AUSERNAME, accepted.checkin.username: username:BADASSUMPTION, bad assumption, name , value , value-BADCHAR, illegal character encountered5BADFILNAM, illegal file specification ' text '+BADIMAFLA, bad image flavor detectedBBADMARKER, bad marker file format for generation generation9BADQUESTAT, bad status for batch queue queue- name,BADSCRATCH, bad SYS$SCRATCH directory7BADSTATUS, bad status returned from routine-nameJBADVMSVERS, unable to interpret OpenVMS version string: VMS-versionLBINSRCMOD, binary source modules cannot be dis- played or differenced(BITRANGE, bit range out of limitsfBLDALRSTART, build job job for stream stream already started; build job cannot be started againiBLDALRSTOP, build job job for stream stream has already stopped; build job cannot be stopped again=BLDINIFAIL, build initialization completed with errorsRBLDJOBACT, build job already active for stream stream ; new job not created6BLDJOBAFTER, build job to be started after timeBBLDJOBCRE, build job job for stream stream has been createdGBLDJOBDEL, build job job for stream stream deleted from database=BLDJOBENT, entry number entry submitted to queue queueMBLDJOBERR, error queuing build job on queue queue ; process not queuedHBLDJOBMOD, build job job for stream stream modi- fied in databaseIBLDJOBSIZ, build job job for stream stream consists of steps stepsVBLDJOBSTARTED, build job job for stream stream started with processes processes?BLDJOBSTARTING, starting build job job for stream stream:BLDJOBSTOP, build job job for stream stream stopped>BLDJOBSUSP, build job job for stream stream sus- pendediBLDNOTRUN, build job job for stream stream is not queued or running; build job cannot be suspendedJBLDSTEPNEED, build step needed to make inputs up-to-date: step stepCBLDSTEPNOTSHO, steps additional needed build steps not shownZCMSBADGEN, bad CMS generation generation found for module module possible CMS errorNCMSCLASSEXIST, CMS class class already exists for CMS facility facilityPCMSCRECLASS, CMS error when creating CMS class class in facility facilityJCMSCREELEM, CMS error when creating CMS ele- ment for module moduleKCMSCRELIB, CMS error when creating CMS library for facility facility:CMSDELELEM, CMS error when deleting element elementNCMSDELGEN, CMS error when deleting generation generation ( generation )`CMSDUPGEN, duplicate CMS generation generation found for module module possible CMS errorFCMSFETCH, CMS error when fetching CMS element for module moduleaCMSINSGEN, CMS error inserting generation genera- tion of element element into class class@CMSLIBEMPTY, the CMS library library contains no elementsZCMSMODCLASS, CMS error modifying the class name class to class in facility facilitygCMSNOCLASS, CMS class class does not exist for facility facility Unable to modify CMS class nameECMSREMGEN, CMS error removing element element from class classKCMSREPLACE, CMS error when replacing CMS ele- ment for module moduleKCMSRESERVE, CMS error when reserving CMS ele- ment for module moduleJCMSSETLIB, CMS error when setting CMS library for facility facilityWCMSSHOWCLASS, CMS error when retrieving CMS class information in library libraryQCMSSHOWDESGEN, CMS error when retrieving CMS generation of element elementLCMSSHOWELEM, CMS error when retrieving CMS element in library libraryLCMSSHOWHIST, CMS error when retrieving CMS history in library libraryPCMSSHOWRES, CMS error when retrieving CMS reservations in library libraryLCMSSTART, starting retrieval of CMS information for facility facilityMCMSVARLET, all CMS variant letters in use; none left for module modulegCMSVERGEN, CMS error reading class membership list when verifying generation generation ( spec )COMMAND, command command@COMMIT, database transaction has successfully com- mitted6COMNOTDEF, command " command-text " not defined<COMPFAIL, compilation of module completed with errors?COMPSUCC, compilation of module completed suc- cessfully>COMSTEPADDED, compile step for module added to databaseGCOMSTEPDEL, compile step for module module deleted from databaseFCOMSTEPMOD, compile step for module module modified in databaseGCOMTERMEOF, command terminated by CTRL/Z or end-of-file on input[CONCURRES, concurrent reservation reservation of module by user user already present1CONFACC, unable to access notes conference@CONFLICT, conflicting qualifers and/or keywords specifiedBCONFMEM, check conference file accessability and membership)CONFNAM, conference file name nameLCONKEYATR, conflicting key attributes key-attribute and key-attributeDCONQUAL, conflicting qualifiers / qualifier and } }/ quali- fier]CONRESDEL, concurrent reservation reservation of module for user user has been deleted'CONTINUE, attempting to continue9COPSTEPADDED, copy step for step added to databaseDCOPSTEPDEL, copy step for module module deleted from databaseECOPSTEPMOD, copy step for module module modi- fied in database5COPYFAIL, copy of module completed with errors6COPYSUCC, copy of module completed successfully)CREDIRFAI, create directory failed6CRELNMFAI, failed to define logical name lnmdsc6CTXADDED, context context added to the database8CTXDEL, context context deleted from the databaseJCTXDELARCH, context ## contains deleted architec- ture architectureDCTXDELFAC, context context contains deleted facility facilityBCTXDELSTRM, context context contains deleted stream contextQCTXEXISTS, context context already exists in database; context not changedGCTXMOD, information for context context modified in the databaseLCTXNOTFOUND, context context not found in database; parameter ignored3CTXSYNTAX, invalid context name syntax: name%CULPRIT, reserved by user userQDATETOOLONG, date-time value is too long; maxi- mum length is 24: date ...>DBCNV, converting database format from oldver to newver.DBCREATED, database db has been created$DBFMT, database format is verBDBGCMSGEN, at codept , letflg bool , item1 itm1 , item2 did*DBGCMSTXT, at codept , expected gen1DBGDB, debugging database: param1 , param2:DBGLNMBAT, debug logical name VDE$BATCH_ MODE: mode8DBGLNMDAT, debug logical name VDE$DATE_TIME: mode7DBGLNMUSR, debug logical name VDE$USERNAME: mode0DBGNOLNM, unable to translate logicalname3DBGQUALMSK, qualifier mask qualmsk1 qualmsk20DBGWAYPT, debug waypoint waypoint reached2DBGXLAC, debug waypoint reached; text: text4DBGXLXL, debug waypoint reached; value: valueJDCLBUFOVFL, DCL command line being generated is too long for bufferADCLERROR, error status returned by spawned DCL DCL commandHDCLTRUNC, DCL command line from script trun- cated; line too long]DEFARCH, architecture architecture not deleted; you cannot delete default architecture7DEFKEY, state-name key key-name has been defined9DEFKEYERR, error defining state-name key key- name7DELKEY, state-name key key-name has been deleted:DELKEYERR, error in processing DELETE/KEY com- mandHDEPNOTUPDATE, dependency information not up- dated for build step?DEPUPDATE, dependency information updated for build step1DEVOSYNCH, executing synch command: dclcmdCDIRADDED, directory specification spec added to the database7DIRCREATED, directory directory has been createdADIRDEL, directory specification spec deleted from database2DIREXPBAD, directory filename expansion bad5DIREXPFAI, directory filename expansion failed6DIRFILFAI, directory filename conversion failed@DIRFILNOTDEL, unable to delete directory file di- rectoryODIRNOTFOUDCL, directory location not found for script's DCL command fileIDIRNOTFOULOG, directory location not found for build-step log fileKDIRNOTFOUND, directory specification to cancel not found in databaseNDIRNOTFOUSCRP, directory location not found by script function functionEDIRSPECREQ, directory specification required for stream streamMDIRTOOLONG, directory specification is too long; maximum length is 2552DIRTREFAI, directory tree conversion failedADIRTRENOTDEL, not all files deleted in directory tree tree9DUPLNAME, duplicate name in list not allowed: nameDEDITUNDEF, your editor is undefined; editor cannot be invokedHEDITUPDATE, default editor definition updated in the VDE database?ELENOTFOUNDCMS, element element not found in CMS libraryFERRASSIGN, the attempt to acquire an I/O channel for VDE failed1ERRCRELNM, unable to create a logical nameMERRDEASSIGN, attempt to deassign an I/O channel acquired by VDE failedEERRDIRSPEC, error in directory or file specification file-name-ERRFAO, unable to format output string#ERRQIOW, error from SYS$QIOWQERRSMG, error returned from a call to the Screen Management Facility (SMG).ERRWRIFIL, error writing file file-nameNEXARANGE, hexadecimal number not valid; valid range is number to number]EXPGENDIFF, expected generation expression ex- pression differs from actual expressionNEXPGENEXPR, expected generation expression at replacement is generationAEXPGENLONG, expected CMS generation expression is too long8FACADDED, facility facility added to the database:FACDEL, facility facility deleted from the database>FACEXISTS, facility facility already exists in databaseIFACMOD, information for facility facility modified in the database/FACNOTDEL, facility facility not deletedNFACNOTFOUND, facility facility not found in database; parameter ignored*FACNOTMT, facility contains modules4FACSYNTAX, invalid facility name syntax: nameAFAMILY, unable to deallocate: siblings or children presentAFCBERR, internal VDE FCB error in VDE-internal- identifierPFCBWRONG, internal error; access access failed in VDE-internal-identifier:FETCHED, generation generation fetched from library-FILCOPLIB, file file copied to library3FILCOPSTAG, file file copied to staging area)FILENOTFOUND, file not found: file.FILQUE, print file queued to queue-name+FILREADERR, unable to read file file,FILWRITERR, unable to write file file\FIRGENNODEL, generation generation is first gener- ation of module; cannot be deletedEFIRNUMMAY, first number of a range may not be less than numberFFIRNUMRAN, first number of a range must be less than the secondFFLAVORPIDS, flavor flavor , pid pid , master mpid , parent ppidHFOLDADDED, fold record record for module module added to databaseEFOLDDEL, fold record record for module module has been deleted?FOLDEXP, fold record for fold expected for stream stream<FOLDIDREQ, fold identifier required for module moduleuFOLDIDUSED, fold identifier identifier already used for module module attempt to create fold record has failedJFOLDINSTRM, generation generation must be folded into stream streamIFOLDMOD, fold record record for module module modified in databaseUFOLDNOTFOUND, fold record record not found for module module and stream streamTFROMDIREMPTY, the directory directory specified with /FROM_DIRECTORY is empty?GBLSECNAM, communications global section name: gblsecnam?GENDEL, generation generation deleted from stream stream<GENDELLIB, generation generation deleted from libraryCGENINSERT, generation generation inserted into stream streamMGENMOD, information for generation generation modified in the database8GENNODEL, generation generation cannot be deletedDGENNOPRED, generation generation of module has no predecessorOGENNOTCLASSMEM, generation generation is not a member of CMS class classEGENNOTFOUNDCMS, generation generation not found in CMS library?GENNOTINSTAGE, generation not found in staging area areaHGENNOTQUEREPL, replacement was not queued; no staging area exists;GENNOTRECOVERED, generation generation not recoveredZGENRECCLASSMEM, generation generation success- fully recovered into CMS class classMGENRECOVERED, generation generation successfully recovered from source?GENREM, generation generation removed from stream stream8GENREPLDNF, staging directory directory not found=GENRETAINED, generation generation retained in library@GENSUCVERIFY, generation generation successfully verifiedAGETJPI, SYS$GETJPI system service failed, unable to attachLGETQUIERR, get queue information system service error for queue queue4GRPADD, module module is added to group group2GRPADDED, group group added to the databaseBGRPALRMEM, module module is already a member of group group4GRPDEL, group group deleted from the databaseKGRPEXISTS, group group already exists in database; group not changedCGRPMOD, information for group group modified in the databaseHGRPNOTFOUND, group group not found in database; parameter ignored>GRPNOTMEM, module module is not a member of group group8GRPREM, module module is removed from group group1GRPSYNTAX, invalid group name syntax: name*HELLO, Motif vdeversion starting up<ICIBOGUS, intermediate conference information invalid=ICIGONE, intermediate conference information not foundFICIPARSE, parse of intermediate conference infor- mation failedILLDEPFUN, Illegal dependency function passed to module VDE$REC_DEPENDENCY. The illegal dependency function value is value.ILLFORUSE, ill-formed user defined nameJINCNOTVAL, INPUT not valid on streams marked for queued replacementTINMODNOTFOU, input module module of build step not found in database; ignored?INPNOTNAME, input string text is not syntactically validMINPTOOLONG, input string too long; maximum length is number charactersOINPTOOSHORT, input string too short; minimum length is number characters=INTERR, internal VDE error in VDE-internal- identifier@INTERR_AZ, internal VDE error in VDE-internal- identifier1INTFUNCERR, internal script function error\INTMEMERR, internal memory-pool error at hex- virtual-address VDE-internal-identifier#INTTOOBIG, integer too large,INVALANS, answer is an invalid answerRINVDATLNM, invalid VDE$DATE_TIME; use DD- MMM-YYYY:HH:MM:SS.CC format: timeNINVDATTIM, invalid date-time; use DD-MMM- YYYY:HH:MM:SS.CC format: timeJINVDBFORM, invalid database format; VDE is unable to access library0INVDIGDEC, invalid decimal number: number8INVDIRSPEC, invalid directory specification: text@INVGENEXPR, invalid CMS generation expression: expressionbINVHISCHAR, invalid history or notes character following poundsigninvalid string is: stringEINVINPUT, invalid interactive command input; com- mand aborted@INVINTVAL, invalid integer value on command line: integer1INVIPMTNAM, invalid IPMT/CLD number syntax-INVKEYNAM, invalid or missing key nameVINVNUMRNG, number not valid; number is number , valid range is number to number0INVNUMSTG, invalid numeric string: string`INVPAGE, invalid screen height, value must be be- tween minimum_height and maximum_heightDINVPARAM, invalid parameter passed to routine- name-plus-info1INVQARDB, invalid QAR database name syntax0INVQARNO, invalid QAR entry number syntax=INVRANGE, no values in inverted range number to number?INVSOURCE, Invalid source of information specified: code\INVWIDTH, invalid screen width, value must be between minimum_width and maximum_widthOINVWILDSPEC, invalid wildcard specification in script selector: selector:IPMTAGAIN, please re-enter the IPMT or CLD num- berBIPMTFMT, use ABC.12345, ABC-12345, ABC.123456 or ABC-1234565IPMTSYNTAX, invalid IPMT/CLD name syntax: nameEITEMLIST, unable to parse itemlist list entry at offset offsetVIVQLOC, invalid qualifier location - place after each dependency file parameter]IVQUAL, unrecognized qualifier ' qualifier ' - check validity, spelling, and placement>JOURDISA, database journalling disabled for VDE library<JOURENA, database journalling enabled for VDE libraryNKEYADDED, keyword keyname added to note noteID in conference conference?LIBCONV, library format converted for new version of VDEhLIBINDRAN, Library index value of value out of range for library dependency or module dependency.5LIBLABEL, library ( mnemonic ) contents: label6LIBMOD, library attributes modified in databaseOLIBNOTSET, library not set; no VDE database found in directory directory9LIBREQ, specification of library mnemonic requiredLIBRESET, library reset5LINKFAIL, link of module completed with errors6LINKSUCC, link of module completed successfully;LNKSTEPADDED, link step for module added to databaseDLNKSTEPDEL, link step for module module deleted from databaseCLNKSTEPMOD, link step for module module modified in database5LOASTLM, recommended free ASTLM value is value5LOBIOLM, recommended free BIOLM value is value5LOBYTLM, recommended free BYTLM value is value/LOCKED, library write access is disabled5LODIOLM, recommended free DIOLM value is value5LOENQLM, recommended free ENQLM value is value5LOFILLM, recommended free FILLM value is valueMLOGNAMUNDEF, logical name logical undefined; operation cannot complete3LOJTQUOTA, recommended free JTQUOTA is value=LOPGFLQUOTA, recommended free PGFLQUOTA value is value5LOPRCLM, recommended free PRCLM value is value5LOQUOTA, one or more process quotas is too low5LOTQELM, recommended free TQELM value is value4MAILERR, error from MAIL routine routine-name/MAILSENT, mail message sent to user user+MATQUOMIS, matching quote is missingBMAXIDVAL, maximum allowed Id value in database exceeded: IDKMAXPARM, too many parameters - reenter command with fewer parametersAMERGEGEN, merging generation generation ( this ) into that7MISCONTSCRP, missing continuation line in scriptAMISHISPARM, missing history parameter in string " string "JMISTYPNAM, missing type name for module string ; type name required7MNEMONIC, library ( mnemonic ) library availableGMNETOOLONG, library mnemonic too long; maxim- ium length: length4MODADDED, module module added to the databaseDMODALRINSTEP, module module is already an input to build stepHMODALROUTSTEP, module module is already an output from build stepMMODALRQUEREP, module module already queued for replacement replacementHMODALRRES, module module already reserved; reservation has failed6MODDEL, module module deleted from the databaseNMODEXISTS, module module already exists in database; module not changed=MODINSTEP, module module is an input to the build stepHMODLOCKED, module module locked for replace- ment by another userIMODMODIF, information for module module modi- fied in the database+MODNOTDEL, module module not deletedJMODNOTFOUND, module module not found in database; parameter ignoredDMODNOTINSTEP, module module is not now an input to build step?MODNOTINSTRM, generation generation not in stream streamHMODNOTOUTSTEP, module module is not now an output from build step;MODNOTRES, module module is not currently re- served8MODNOTREV, module module not found in review list?MODOBS, module module-name superceded or marked obsoleteAMODOUTSTEP, module module is an output from the build stepDMODREMINSTEP, module module removed as an input to build stepHMODREMOUTSTEP, module module removed as an output from build stepOMUSTREPL, you must replace the new module to create its first generationDNAMTOOLONG, name is too long: text ; maximum length is number5NEEDFACILITY, this request requires a facility3NEEDLIBRARY, this request requires a library3NEEDMOD, module must be specified on command1NEEDMODULE, this request requires a module/NEEDMORE, unexpected end of command line:NEEDSTEP, build step must be specified on com- mand1NEEDSTREAM, this request requires a stream<NETERROR, network error; component: id , code: errcod>NEWDBGMSK, debug mask switching from oldmask to newmask?NOACCLIB, no access to library allowed for user username<NOARCHSPEC, no architecture specified for opera- tion4NOATTACH, failed to attach to process PID !XLKNOAUTOCONV, automatic conversion to current database format disabledDNOBASENOTE, no base note found for replacement replacement_id6NOBLDJOB, no build jobs found for stream streamNNOBLDSTEPS, build job contains no build steps; build job is not createdLNOBUILD, no BUILD privilege; cannot create build jobs in this libraryONOCANRES, cannot cancel reservation to create first generation of module@NOCAUSE, replacement cause not known; module not replaced>NOCLOSEQ, no closing quotation mark for a quoted stringLNOCONFNAM, no notes conference name specified in call to routine-nameMNOCREARCH, no CREARCH privilege; cannot create or modify architecturesFNOCRECTX, no CRECTX privilege; cannot create or delete contextsHNOCREFAC, no CREFAC privilege; cannot create or modify facilitiesDNOCREGRP, no CREGRP privilege; cannot create or delete groupsENOCREMOD, no CREMOD privilege; cannot create or modify modulesGNOCRESCRP, no CRESCRP privilege; cannot create or delete scriptsENOCRESTEP, no CRESTEP privilege; cannot create or delete stepsGNOCRESTRM, no CRESTRM privilege; cannot create or modify streamsDNOCREUSR, no CREUSER privilege; cannot create or delete usersCNODELARCH, no DELARCH privilege; cannot delete architectures5NODELDEF, Attempt to delete default prohibitedKNODELFAC, no DELFAC privilege; cannot delete facilities from libraryHNODELMOD, no DELMOD privilege; cannot delete modules from library@NODELREP, no DELREP privilege; cannot delete replacements!NODELSET, marked /NODELETEJNODELSTRM, no DELSTRM privilege; cannot delete streams from libraryCNODELTAROOT, no delta-file root directory exists for libraryHNODIRDELTA, no delta-file directory found for facil- ity facilityHNODIRMARKER, no marker-file directory found for facility facility5NOFACSPEC, no facility specified for operation(NOFREE, no free storage availablePNOFROZEN, no FROZEN privilege; cannot replace modules into frozen streamsBNOGENSTRM, generation generation not found in stream stream4NOKEYPAD, unable to set up keypad definitionsGNOKEYW, qualifier name is missing - append the name to the slash'NOLIBDEF, no VDE library defined4NOLIBROOM, too many libraries in default file<NOMAIL, no message sent; MAIL messages are dis- abled<NOMAILSENT, failure to send mail message to user userMNOMATCHARCH, no architecture name matches the wildcarded string stringINOMATCHCTX, no context name matches the wild- carded string stringJNOMATCHFAC, no facility name matches the wild- carded string stringANOMATCHGEN, no generation matches wildcarded string stringSNOMATCHGENS, no generation matches wildcarded string string in stream stringGNOMATCHGRP, no group name matches the wild- carded string stringHNOMATCHMOD, no module name matches the wild- carded string stringKNOMATCHREP, no replacement name matches the wildcarded string string6NOMATCHSCRP, no scripts match the specificationINOMATCHSES, no session name matches the wild- carded string stringRNOMATCHSTEP, no build steps for modules match- ing string found in databaseINOMATCHSTRM, no stream name matches the wild- carded string stringGNOMATCHUSER, no user name matches the wild- carded string string5NOMEMGRP, no members specified for group groupNNOMODLIB, no MODLIB privilege; cannot modify attributes of this library9NOMODMEMGRP, no modules are members of group groupNNOMODSTRM, no MODSTRM privilege; cannot mod- ify most stream attributes0NOMOREMOD, no more modules in review list5NOMORESTEP, no more build steps in review listRNONNULLARG, argument specfied MBZ has non-zero value in routine VDE-routine>NONOTE, no note topic entered; note entry is dis- abled=NONOTESENT, note NOT posted to conference con- ference;NOPARSTRM, no parent stream specified for new streamCNOPERFREP, no PREFREP privilege; cannot perform replacements<NOPNAM, unknown project name specified for the stream2NOPNAMS, no projects defined for the streamCNOPRIVQUAL, insufficient privilege to use qualifer qualifierENOPRIVS, insufficient VDE privilege(s) for attempted operation:NOPROMPT, no prompt specified; using default prompt;NORESFORMOD, no reservations exist for module moduleHNORESREP, no RESREP privilege; cannot reserve and replace modules,NOSCRATCH, no SYS$SCRATCH translation6NOSCRIPTYP, no script type specified on command>NOSCT, replacement cause not known; module not replaced:NOSCTSRC, source file record for SCT note not found6NOSETLIB, the SET LIBRARY command is locked outLNOSETTERM, the SET TERMINAL command is not supported on this terminal$NOSPAWN, spawn command failedDNOSTAGROOT, no staging area root directory exists for libraryDNOSTRMROOT, no stream root directory exists for stream stream4NOSTRMSPEC, no stream specified for operationBNOSUCHARCH, architecture architecture not found in database7NOSUCHCTX, context context not found in databaseBNOSUCHDIRSYM, directory symbol symbol not found in database9NOSUCHFAC, facility facility not found in databaseSNOSUCHFOLD, fold record record not found for module module and stream stream=NOSUCHFUNC, no such script function exists: func- tion=NOSUCHGEN, generation generation not found in database3NOSUCHGRP, group group not found in database5NOSUCHMOD, module module not found in database<NOSUCHPRIV, no such privilege name exists: priv- nameBNOSUCHQUE, batch queue queue does not exist; check spelling?NOSUCHREP, replacement replacement not found in databaseENOSUCHRES, reservation reservation for module module not found6NOSUCHSCRP, script script not found in database7NOSUCHSES, session session not found in databaseDNOSUCHSTEP, no build step for module module found in database6NOSUCHSTRM, stream stream not found in database0NOSUCHSYM, no such symbol ' text ' exists2NOSUCHUSER, user user not found in databaseRNOTCONNLIB, you are not connected to a VDE li- brary; command not performed8NOTEID, topic major . minor entered in conference7NOTESCONF, accessing notes conference conference5NOTESENT, note posted in conference conference>NOTESENTID, note noteID posted in conference conference5NOTESERR, error from DEC Notes at routine-name<NOTESID, unable to parse DEC Notes topic note- numberFNOTEXTSTR, text string argument missing in call to routine-name9NOTIMPL, this feature is not currently implementedUNOTINRANGE, integer value number not in valid range of low-bound to high-boundGNOTPROP, generation generation not propagated past stream stream@NOTRESINSTRM, module module not reserved in stream streamDNOTREVREP, you are not a reviewer for replacement replacementFNOUNCLOSE, no UNCLOSE privilege; cannot unclose a closed streamTNOUSERNAME, no USERNAME privilege; cannot reserve and replace for other usersFNOVDEDEVO, no VDEDEVO privilege; access to dun- geon restricted.NULSTRNOT, a null string is not allowed'NYI, feature not yet implementedCOFFLINE, source code control system offline, try again later#OUTFILE, output file is filePOUTMODSRC, output module module of build step is a source module; ignoredIOUTNLA0, if /OUTPUT=NLA0: was used, respecify with non-null outputGOVERRIDE, VDE library controls overridden via OpenVMS privileges@OVFLOWBUF, overflow of the input buffer, command ignored.HPREFIXNOTALL, prefix VDE$ not allowed in facility or stream names0PROTOLIB, using prototype library library4PROTOTYPE, this is a prototype version of VDE:QARDBSYNTAX, invalid QAR database name syntax: name/QCHECKCOUNT, queued.checkin.count: count3QDATETIME, queued.checkin.datetime: datetime4QERRORS, queued.checkin.defectsfixed: defects*QGROUP, queued.checkin.group: group'QITEM, queued.checkin.item: item4QLIBMNE, queued.library.mnemonic: libmnemonic.QMODULE, queued.checkin.module: modname0QNOTE, queued.checkin.note: topic . reply-QPROJECT, queued.project.name: project1QREASON, queued.checkin.reasonmask: reason4QREPLID, queued.checkin.replacementid: replid3QREPLNAME, queued.checkin.replname: replname-QRMPBCOUNT, queued.module.count: count7QRMPBMODFLAG, queued.module.modflags: mod- flags5QRMPBMODNAME, queued.module.modname: mod- nameBQRMPBREPLREMARK, queued.module.replaceremark: replaceremarkAQRMPBRESREMARK, queued.module.reserveremark: reserveremark3QRMPBSTAGING, queued.module.staging: staging-QSTREAM, queued.checkin.stream: stream-QTYPCOD, queued.checkin.typecode: type-QTYPNAM, queued.checkin.typename: typeLQUALDISALL, qualifier qualifier is disallowed for the command commandSQUALNOTALL, qualifier qualifier is not allowed when a parameter is specifiedKQUALTOOMANY, qualifier qualifier has been speci- fied too many timesDQUECLOSED, batch queue queue is closed and cannot accept jobsSQUEPAUSED, batch queue queue is paused or paus- ing; job execution is haltedTQUESTOPPED, batch queue queue is stopped or stopping; job execution is halted3QUOCHECK, performing a quota check operation9QUOLOW, quota quota set to: old , recommended: new>QUORESET, performing a quota check and update operation(QUOSTREXP, quoted string expected<QUOUSER, user user below recommended quota setting(s)3QUSERNAME, queued.checkin.username: username4READERR, VDE input read error, forced to exitDREGRESSION, operating in mode suitable for regres- sion testsHREPACCEPT, replacement replacement marked as accepted in database>REPADDED, replacement replacement added to the databaseBREPBELUSER, replacement replacement belongs to another user0REPCAN, replacement replacement cancelled@REPDEL, replacement replacement deleted from the databaseQREPEXISTS, replacement replacement already exists; replacement not changedBREPLACED, generation generation replaced into stream stream@REPLQUE, module module queued for replacement replacementOREPMOD, information for replacement replacement modified in the databaseTREPNOTFOUND, replacement replacement not found in database; parameter ignoredhREPNOTPERF, replacement replacement for stream stream not performed; does not match stream stream1REPPERF, replacement replacement performedHREPREJECT, replacement replacement marked as rejected in database7REPSYNTAX, invalid replacement name syntax: name4REQQUAMIS, required command qualifier missingORESDEL, reservation reservation of module for user user has been deletedBRESERVED, generation generation reserved from stream streamWRESERVSES, generation generation reserved from stream stream for session sessionDRESIDREQ, reservation identifier required for mod- ule moduleiRESIDUSED, reservation Id ID already used for mod- ule module attempt to reserve module has failedMRESMOD, reservation reservation for module module modified in databaseIRESQUEUED, reservation request for module queued for stream stream:RETURNED, control returned to process process- nameNRIGIDNOTFOU, required rights identifier ID not found in rights databaseBRIGIDNOTHELD, you do not hold required rights identifier ID:ROLLBACK, database transaction has been rolled back)SCRDONE, completed wait for script<SCRIPTONLY, VDE/STATUS is invoked only within scripts.SCRLOAD, loading script into subprocessKSCRPADDED, script from file file added to the database script scriptNSCRPCMDTOOLONG, script command is too long; it exceeds count characters>SCRPDEL, script deleted from the database script script<SCRPEXTR, script extracted to file file script scriptGSCRPFACFAIL, script for facility facility terminated with errorsDSCRPFILE, script produced DCL command file file script scriptSSCRPFUNCUNDEF, script function function is unde- fined in the current scriptISCRPMOD, script information modified in the database script scriptJSCRPMODFAIL, script script for module module terminated with errors'SCRPUSED, script stript was usedDSCRQUOERR, no closing quotation mark in script command:!/ cmd*SCRWAIT, commencing wait for script=SCTCONF, SCT note conference null; module not replacedHSCTCONFSYN, SCT note conference syntax error; module not replaced>SCTFCMT, SCT fold comment required; module not replaced9SCTFNF, unable to locate notes conference confname;SCTNOTE, SCT note number null; module not re- placedFSCTNOTESYN, SCT note number syntax error; mod- ule not replaced)SECMERFAI, secondary merge failure7SEECONLIB, see the VDE CONVERT LIBRARY com- mand6SESADDED, session session added to the database:SESBELUSER, session session belongs to another user(SESCAN, session session cancelledQSESEXISTS, session session already exists in database; session not changedGSESMOD, information for session session modified in the databaseASESNOMODS, session session contains no module reservationsLSESNOTFOUND, session session not found in database; parameter ignored*SESTERM, session session terminated6SETKEY, keypad state has been set to state-name5SETKEYERR, error in processing SET KEY command8SETLIB, use SET LIBRARY, VDE$LIBRARY, or /LIBRARYLSETUNAUTH, attempt to set unauthorized privileges; privileges not set8SHOKEYERR, error in processing SHOW KEY com- mandGSHORESFUL, use SHOW RESERVATION/FULL to check reservation stream=SNDJBCERR, job controller error status for queue queueCSPARE_1, placeholder for VDE$_MODEXISTS ( mod- ule ) message@SPARE_2, placeholder for VDE$_INVALANS ( answer ) message'SPARE_3, was FACNOTDEL; replacedSPARE_4, was STRMNOTDEL SPARE_5, was FOLDNOTFOUND'SPARE_6, was BADSTATUS; replaced SPARE_8, was FOLDNOTFOUND"SPAWNED, subprocess spawned-SPEMERFAI, specification merge failureJSRCNOTOUT, source module module cannot be an output from build stepGSTATNOTSPEC, the kind of statistics to display was not specifiedPSTEPNOTCRE, build step not created; module mod- ule not found in databaseGSTEPNOTFOUND, build step for module module not found in databaseOSTEPNOTMOD, build step not modified; module module not found in databaseHSTEPNOTREV, build step for module module not found in review list!STGTRUNC, string truncatedGSTKOVF, command procedures too deeply nested; limit is 16 levels5STRMADDED, stream stream added to the databaseISTRMCLOSED, stream stream is permanently closed; state not changed7STRMDEL, stream stream deleted from the database;STRMEXISTS, stream stream already exists in databaseFSTRMMOD, information for stream stream modified in the databaseOSTRMNOTCLOSED, stream stream can not be deleted because it is not closed,STRMNOTDEL, stream stream not deletedKSTRMNOTFOUND, stream stream not found in database; parameter ignoredFSTRMNOTOPEN, stream stream is not open; opera- tion not allowed?STRMNOTPOP, stream stream is not allowed to be populated:STRMPOP, stream stream populated from stream streamWSTRMPOPCOUNT, populate module counts: update count , insert count , remove count>STRTOOLONG, quoted string too long; must be short- enedMSUCGENEXIST, successor generation for module already exists in libraryJSUCLNKADD, successor link from stream stream to stream stream addedL   SUCLNKREM, successor link from stream stream to stream stream removed8SYNTAX, command syntax error at or near: ' text 'dTOOMANPARM, too many poundsign parameters in history or notes stringinvalid string is: stringHTRANTOODEEP, translation of logical name logical more than 7 deepGUIDSKEW, possible UID skew detected; check for correct UID file.'UIDSKEWCODE, UID skew code value0UNACLOFIL, unable to close file file-name4UNACLOLOG, unable to close log file file-name6UNACONLOG, unable to connect log file file-name`UNACONVDBFORM, unable to convert database format due to access conflict with another user1UNACREFIL, unable to create file file-name5UNACRELOG, unable to create log file file-name4UNACREMBX, unable to create temporary mailbox1UNADELFIL, unable to delete file file-name/UNAOPEFIL, unable to open file file-name6UNAOPEINP, unable to open input stream ' text 'IUNAPARFIL, unable to parse file name name with default string nameMUNAREPNOTECONF, unable to reply to note in notes conference conference3UNDKEY, state-name key key-name is undefinedLUNKCOMSTA, unknown completion status value status passed to VDESTATUS9UNKEPT, unable to opnam to kept subprocess sectionJUNKEYW, unrecognized keyword ' text ' - check validity and spellinghUNKFILEXT, Unknown file extension in analysis file; the complete filespecification found was specDUNKPNAM, unable to locate project projnam in stream streamnam/UNKPROJ, unable to locate a project name+UNKQARCLD, internal VDE coding error+UNLOCKED, overriding library lockoutBUNMATQUO, unmatched quote or missing quote at end of string<UNRESERVED, reservation for module module can- celledMUSEDELMOD, to unreserve a CREATE MODULE reservation, use DELETE MODULE1USERADDED, user user added to the database3USERDEL, user user deleted from the databaseIUSEREXISTS, user user already exists in database; user not changedBUSERMOD, information for user user modified in the databaseDUSERNOTDEL, user user not deleted; you cannot delete yourselfGUSERNOTFOUND, user user not found in database; parameter ignoredHUSERNOTUAF, user user not found in system User Authorization FileOUSEVERSLNM, use logical name VDE$VMS_VERSION to override OpenVMS versionWVALREQ, missing qualifier or keyword value - supply all required values ' text ''VDECLUSTER, vde.cluster: clusterIVDECONTACT, vde.contact: please contact VDE support for assistance*VDEDATETIME, vde.datetime: datetimeJVDEFORMAT, vde.format: the format of this file is subject to change$VDENAME, vde.product: vdenameVDENODE, vde.node: node'VDEPROJECT, vde.project: project.VDERDBBKP, VDE$DATABASE$ db _BCKP_ typeVDERDBBKP_FULL, FULLVDERDBBKP_INCR, INCR'VDEVERSION, vde.version: versionDVERBOTEN, direct ATTACH to a VDE kept subprocess is forbidden'WHEREIS, component comp is valueWHYOFF, reason: !ADEWILDGENNUM, wildcarded generation number not allowed in module@WILDNOTALL, wildcard characters not allowed in name: name.XMERROR, Motif interface error detected.XMERROR, Motif interface error detected  vde_manual_preface front_intended_audience front_document_structure$front_associated_documentsfront_conventionsintro_to_vdeuse_vdecmd_enter!invoke_vde$end_session%enter_cmd_dcl(abbrev)using_help+cmd_summ3vde_dcl_cmd_ref4dcl_vde_commandLdcl_vde_dependZvde_read_uafddcl_vde_whereisudcl_vsc_commandvde_cmd_refvde_cmd_at_signvde_cmd_acc_replvde_cmd_attachvde_cmd_build vde_cmd_build_createbld vde_cmd_build_startbldvde_cmd_can_dirvde_cmd_can_foldvde_cmd_can_logvde_cmd_can_privvde_cmd_can_repl vde_cmd_can_sessvde_cmd_can_verifyvde_cmd_compile'vde_cmd_conv_lib2vde_cmd_copy?vde_cmd_cre_archMvde_cmd_cre_ctx_vde_cmd_cre_dirtvde_cmd_cre_facvde_cmd_cre_foldvde_cmd_cre_grpvde_cmd_cre_libvde_cmd_cre_mod$vde_cmd_cre_repl/vde_cmd_cre_scrpQvde_cmd_cre_sess\vde_cmd_cre_stepuvde_cmd_cre_streamvde_cmd_cre_uservde_cmd_def_cmdvde_cmd_def_keytbl_keynamesvde_cmd_del_cmdvde_cmd_del_keyvde_cmd_del_archvde_cmd_del_bld vde_cmd_del_ctxvde_cmd_del_fac!vde_cmd_del_fold.vde_cmd_del_gen@vde_cmd_del_grpMvde_cmd_del_modZvde_cmd_del_repllvde_cmd_del_scrpvde_cmd_del_stepvde_cmd_del_streamvde_cmd_del_uservde_cmd_differencesvde_cmd_exitvde_cmd_extr_scrpvde_cmd_fetchvde_cmd_helpvde_cmd_ins_gen0vde_cmd_inv_scrpKvde_cmd_linkVvde_cmd_mod_archdvde_cmd_mod_bldyvde_cmd_mod_ctxvde_cmd_mod_facvde_cmd_mod_foldvde_cmd_mod_genvde_cmd_mod_grpvde_cmd_mod_libvde_cmd_mod_mod)vde_cmd_mod_repl>vde_cmd_mod_res\vde_cmd_mod_scrpyvde_cmd_mod_sessvde_cmd_mod_stepvde_cmd_mod_streamvde_cmd_mod_uservde_cmd_perf_replvde_cmd_pop_streamvde_cmd_rej_repl vde_cmd_rem_genvde_cmd_replace+$vde_cmd_replace_statistics. vde_cmd_replace_chngprop1 vde_cmd_replace_histnoteQtbl_reasonsgvde_cmd_reservevde_cmd_rev_bldvde_cmd_rev_bj_cmdsvde_cmd_rev_replvde_cmd_rev_rep_cmdsvde_script_keywords vde_cmd_crescrp_selectvde_cmd_crescrp_segsvde_cmd_crescrp_debugvde_script_functions:vde_script_typesCtbl_script_typesGvde_cmd_set_archNvde_cmd_set_ctx\vde_cmd_set_devoatbl_setdevo_paramcvde_cmd_set_dir{vde_cmd_set_editorvde_cmd_set_facvde_cmd_set_keyvde_cmd_set_libvde_cmd_set_logvde_cmd_set_noverifyvde_cmd_set_privtbl_privilegesvde_cmd_set_promptvde_cmd_set_streamvde_cmd_set_termvde_cmd_set_verifyvde_cmd_show_archvde_cmd_show_bldvde_cmd_show_ctxvde_cmd_show_def$vde_cmd_show_devo*vde_cmd_show_dir6vde_cmd_show_editor>vde_cmd_show_facKvde_cmd_show_fold[vde_cmd_show_genvde_cmd_show_grpvde_cmd_show_keyvde_cmd_show_libvde_cmd_show_locvde_cmd_show_logvde_cmd_show_memvde_cmd_show_modvde_cmd_show_privvde_cmd_show_replvde_cmd_show_res vde_cmd_show_scrp4 vde_cmd_show_sessJ vde_cmd_show_stepY vde_cmd_show_streami vde_cmd_show_symbolq vde_cmd_show_termx vde_cmd_show_user vde_cmd_show_verify vde_cmd_show_version vde_cmd_spawn vde_cmd_start_bld vde_cmd_stop_bld vde_cmd_stop_subproc vde_cmd_susp_bld vde_cmd_unreserve vde_cmd_verify_gen vde_cmd_wait_bld vde_logicals logical_name_tbl vde_rec_depend vde_rec_depend vde_dep_rec_dep vde_recdep_values rec_depend_begin rec_depend_tool rec_depend_infile rec_depend_inlib$ rec_depend_outfile& rec_depend_outlib+ rec_depend_objmod0 rec_depend_end2 rec_depend_bld_steps5 vde_calling_interface6 vde_calling_interface8 itemlist_codes: fetchmoduleK replacemodule] setfacilityo setlibrary setstream showfacilities showprojects showlibrary showmodules showstreams unreservemodule vde_upload vde_upload_syntax_tbl vde_errors @-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-1B-ADOBE-Helvetica-Medium-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-I-Normal--*-140-*-*-P-*-ISO8859-1O -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-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-1M-ADOBE-New Century Schoolbook-Bold-R-Normal--*-100-*-*-P-*-ISO8859-1O-ADOBE-New Century Schoolbook-Medium-R-Normal--*-100-*-*-P-*-ISO8859-1@-ADOBE-Courier-Medium-R-Normal--*-140-*-*-M-*-ISO8859-1M-ADOBE-New Century Schoolbook-Bold-I-Normal--*-140-*-*-P-*-ISO8859-1   )ODocument StructureFOUThisdocumentcontainsa reference descriptionofthe@OOpenVMS Development Environment(VDE)sourcecodeNOcontrolandsourcecodebuild environment.(ItprovidesusersIO^with reference informationrelatedtomodule reservationsKOand replacements, replacementreviews,librarycreationand4Ovariouslibrary maintenance operations.h>>OThismanualcontainsthe following information: `mmChapter1@Xmprovidesafull descriptionoftheVDEUtility. `Chapter25Xoutlinesthe followingVDE information:*0lO*lO3] 3 YmInvokingtheutility%YExitingfromtheutilityY Directingoutput6Yw RestrictionsandVDE privilegesrequired `Chapter35]containsthecommand referenceforVDECO commands.*Thissectionincludesthecommandformat,?command qualifiersand parameters,and examples. `''AppendixB5'contains informationusefulforworkingCdirectlywiththeVDE dependency recordingcallable interface. `WWAppendixC;Wcontains informationusefulforworkingwith the^ unsupported"-VDEcalling interface. `//AppendixE?/includesalistoferrormessagesthatcanbe displayedbyVDE.*oO*O *O5 *O -74  OVDE*56! ~ _DOTheOpenVMS Development Environment(VDE)UtilityisMO(atoolthatsoftware developerscanusetomanagesoftwareJO development.,VDEusesa relationaldatabasetostorede-HO velopment informationaboutyoursoftwaresystemandtoLO2managemultiple instancesofthatsystem.'VDEalsomanagesNOthedisk directories,CMS libraries,andfilesthatcompriseJOyoursoftwaresystem.(Inmanagingasoftwaresystem,VDE2O<canperformthe following functions: `JStoreandretrieve informationaboutthemodules,facili-Ities(groupsof modules),module generations, developmentHrstreams,andotherentitiesthatmakeupyoursoftwaresystem. `JEJReservesourcemodulesfromtheVDElibraryandre-Gplacethemaftertheyhavebeen modified.)ModulescanHbereservedfromandreplacedintomultiple developmentCSstreamsandchangescanbe automatically propagatedbetweenstreams. `+F+Buildthesoftwaresystem.+VDEcanperformbothfullJandminimalsystembuilds.*Inafullbuild,allmodulesKinthesoftwaresystemare compiled,linked,or otherwiseJ5 processed.'Inaminimalsystembuild,onlythosemodulesIthathavebeenchangedsincethelastsystembuildare, compiled,linked,or processed. `e Be Collectandreportsoftware development statistics.7 NIOVDEincludes extensivebuilt-inHELP.AttheVDE>,typeLO ``HELP''.An extensive documentationset,in Bookreaderand4O5 Postscriptformats,isalso available.k8AOFormat1OsVDEN [vde-command[;vde-command...]]A9O ParameterOs vde-commandHOAVDEcommandtobe performed.(The availableVDEcom-#O$mandsare describedin$Chapter3.%M$YoucanspecifymultipleJO|VDEcommandsifyouseparatethemby semicolons( ; ).*9lO:gOOThis parameteris optional;ityouomitit,VDEpromptsyouOfor commands.};SO DescriptionIOsTheVDEcommandinvokestheVDEutilityandallowsyouEOtoenterVDE subcommands.) SpecifyingtheVDEcommandOO$withspecific qualifiersenablesyoutomodifytheVDEenvi-KO|ronmentorinvokeseparateprogramsthatarepartoftheOVDEsystem. <KOToinvoketheVDEutility,entertheVDEcommandattheNODCLprompt( $ ).(Thesystemrespondswiththepromptfor7O5theVDEutility( VDE> ).'Forexample: O $ VDEO VDE>j=@GOAttheVDE>prompt,youcanenterVDE subcommandstoHOperformVDE functions.(For simplicity,these subcommandsPO5arereferredtoas``VDE commands''intherestofthisde-IO scription.+ToexitfromVDE,entertheEXITcommandorOpressCTRL/Z.?>GOThe followingexampleshowshowtoenterVDEcommands%Ofromwithintheutility: Oa $ aVDEO VDE> SHOW%LIBRARYEO Main&library%LIBNAME%in%root& directory%DEV$:[PROJDIR]O9 VDE> 9EXIT O $?FOYoucanalsoenterVDEcommandsdirectlyontheVDEKOcommandline.+Inthiscase,VDEdoesnotpromptyouforFO5 commands.,The followingexampleshowshowtoentera6OVDEcommandfromtheDCLcommandline: O $VDE%SHOW&LIBRARYEOZ Main&library%LIBNAME%in%root& directory%DEV$:[PROJDIR] O $9@IOYoucanalsoenterthe followingcommandsfromtheDCLKOcommandline(either interactivelyorfromwithinacodedQO5filecalleda``VDE script'')toinvokeseparateprogramsthat*OarepartoftheVDEsystem:A` `mm VDE/DEPEND ` VDE/READ_UAF `ll VDE/WHEREISsBIIOThesecommandsare described separatelyinthischapter.C! aOOTouseVDE,youmustspecifytheVDElibrarythatyouwantPOtouse.)TheVDElibraryforasoftwaresystemconsistsofaNO5root directory,aVDEdatabaseresidinginthatrootdirec-NOtory,anda directorytreethatcontainsallCMS libraries,QOsourcefiles,andotherfilesthatmakeupyoursoftwaresys-OO>tem.(YouspecifytheVDElibraryyouwanttousebygivingQOthe directory specificationforthelibraryroot directory.(ThePOroot directorycontainsthedatabaseandthedatabasecontainsNOHpointerstoallother directoriesthatmakeupthelibrary.D NOUnlessyouarecreatinganewVDElibrary,youcanspecifyQOthelibraryusinganyofthreemethods.(First,youcandefineLO5alogicalname VDE$LIBRARYtogivethe library'srootdi-OOrectory.*IfyouusethesameVDElibrarymostofthetime,KOyoushoulddefine VDE$LIBRARYinyourloginfile.)Second,HO>youcanusethe/LIBRARY qualifiertotheVDEcommandPOtospecifythelibrarymnemonicorroot directory.(Andthird,JOyoucanusetheVDESETLIBRARYcommandtospecifytheOOHmnemonicorroot directory.(Youmustuseoneofthesethree2OmethodstospecifytheVDElibrary.EO QualifiersOs/INTERFACE=keywordLOThe /INTERFACE qualifierallowstheusertoselectakey-KO$word representingtheprefereduser interface presentedby9O|VDE.WiththeVDE/INTERFACE=DECWINDOWSkey-MOword,theMotif graphicaluser interfaceisused.+Withthe5O-VDE/INTERFACE=CHARACTER_CELLkeyword,the4O traditionalcommand interfaceisused.2F! O /KEPT_PROCESS$O(/NOKEPT_PROCESS (default)MO SpecifieswhetherVDErunswithorwithoutcreatingakeptEOprocess.- /KEPT_PROCESS specifiesthattheVDEutilityMO2shouldruninakept subprocessthatisretainedfromoneMO invocationoftheVDEcommandtothenext.*UseofakeptLO subprocessallowsVDEtoconnecttotheVDEdatabaseonceJO<formany invocationsofVDE,thusspeedingup subsequentUOaccessestothe database.'ItalsoallowsVDEtoretainstatein-MO formation,suchasthedefaultstreamand facility,betweenGOE invocations.'/NOKEPT_PROCESS specifiesthatVDEnotrun"Oinakept subprocess.G  ODo notASattempttousetheDCLATTACHcommandtoattach-OtoaVDEorVSCkeptprocess.6HK !O/LIBRARY=directory-specKO( Specifiesthemnemonicnameorroot directoryoftheVDEEOlibrarywithwhichyouwanttowork.. SubsequentVDEIO operationswillaccessthedatabase associatedwiththatO2library.zIKPCO/DEPENDlangana-file [in-out-file[,in-out-file...]]GO(The/DEPEND qualifiercausesVDEtoinvokeaseparateKOprogramthat automaticallycollectsbuild dependencyinfor-EOmation.+The VDE/DEPEND combinationis describedasa6O2separatecommandlaterinthischapter.J! jO /READ_UAFIO(The /READ_UAF qualifiercausesVDEtoinvokeaseparateKOprogramusedtoupdatetheUserTableinaVDEdatabaseOOfrom informationinthesystemuser authorizationfile(UAF).HO2The VDE/READ_UAF combinationis describedasaseparate,Ocommandlaterinthischapter.6 K  OExamples O1.  $-DEFINE% VDE$LIBRARY%DEV$:[PROJDIR]  $ VDEH VDE>HSHOW%LIBRARYE Main&library%LIBNAME%in%root& directory%DEV$:[PROJDIR] VDE>SHOW%STREAM&V2.1-1  Stream%V2.1-1+/  "First%update%to%version%2.1"h VDE>hHELP% ...help&text% displayed... VDE>EXIT @ $@Thisexampledefineslogicalname VDE$LIBRARYtoMspecifytheroot directoryoftheVDElibraryyouwanttoI`workwith.(This directorycontainstheVDEdatabaseforDthelibrary.(TheVDEcommandenteredfromDCLthenDgivestheVDE>prompt.)YoucannowenterVDEcom-?jmands,inthiscasetheSHOWLIBRARYandSHOW:STREAM commands.-TheEXITcommandendstheIVDEsessionandreturnsyoutotheDCLprompt( $ ). O2.  $3VDE%SHOW&LIBRARY;&SHOW%STREAM&V2.1-1E Main&library%LIBNAME%in%root& directory%DEV$:[PROJDIR]( Stream%V2.1-1+/( "First%update%to%version%2.1" p $EThisexampleshowstwoVDEcommandsentereddirectlyA7 onthe DCL-levelVDEcommandline.)BothcommandsI are executed,afterwhichVDEexitsandreturnsyoutoM theDCLprompt( $ ).(Inthiscase,VDEdoesnotpromptDA for commands.)TheexampleassumesthatlogicalnameE  VDE$LIBRARYhasalreadybeendefined,perhapsinthe user'sloginfile. Oj 3. u $$u VDE/LIBRARY=DEV$:[ROOTDIR] VDE> SHOW%LIBRARY? Library&LIBNAME%in%root% directory%DEV$:[ROOTDIR]M VDE>M EXIT $L Inthisexample,the/LIBRARY qualifier specifiesthattheF\ root directoryfortheVDElibraryisDEV$:[ROOTDIR].= EnteringtheSHOWLIBRARYcommandattheVDE@ promptconfirmsthatthislibraryhasbeenset. O4.  $ VDE VDE>&SET%LIBRARY&DEV$:[ROOTDIR] VDE>SHOW%LIBRARY?b Library&LIBNAME%in%root% directory%DEV$:[ROOTDIR] VDE>EXIT  $DaThisexampleusestheSETLIBRARYcommandtospec-Iifytheroot directoryoftheVDElibrarytouse.-The?SHOWLIBRARYcommandconfirmsthatthislibrarykhasbeenset.}!GOACCEPT REPLACEMENT*5COMarksaqueued replacementasacceptedintheVDEGO( database.,Youcanonlymarka replacementasacceptedOTheACCEPT REPLACEMENTcommandupdatestheVDEMOdatabasetorecordthatyouhavereviewedthecodechangesMO5ina specifiedqueued replacementandthatyoujudgethoseGOchangestobe acceptablefor replacementintotheVDEJO library-the replacementintotheVDElibraryis performedwitha subsequentPERFORM REPLACMENTcommand.OOYoumustbeareviewerfora replacementinordertoissueBOtoACCEPT REPLACEMENTandmarkthe replacementasOH accepted. kAOTheACCEPT REPLACEMENTcommandallowsyoutoat-KOtachacommentfiletothequeued replacement.,ThisfileKO5givesyourcommentstotheauthorofthe replacementandNOtotheother reviewers.*IfyouhavealreadycreatedsuchaROfile,usethe/INPUT qualifiertocopyittothe replacement'sTO>stagingarea.(Ifyouwanttocreatesuchafile,usethe/EDITOO qualifier.(This qualifiercausesVDEtoinvokeyour preferredOOeditortocreateacommentfileforthe replacement.)IfyouIOHhavealreadycreatedacommentfileforthe replacementEOwithanearlierACCEPTorREJECTcommand,the/EDITVO qualifierletsyoueditthatfileagain.(This capabilityisusefulLORifyouchangeyourmindorwanttoaddmore information.e ;QOIfyouwishtomarka replacementasnot acceptable,usetheDOREJECT REPLACEMENTcommand.'IfyouwishtoseetheKO5reviewstatusofaqueued replacement,seethe documenta-7OtionontheSHOW REPLACEMENTcommandinSHOWO REPLACEMENT.nDRROO! rO QualifiersOs/CONFIRMO /NOCONFIRM (default)IO$ControlswhetherVDEasksyoutoconfirmthatyouwantHO|each replacement accepted.'The/CONFIRM qualifiercausesMOVDEtoprintamessageforeach replacementaskingwhetherNO-youwanttoacceptthat replacement.(IfyouanswerYES(orLOY),that replacementismarkedas accepted.)IfyouanswerLONO(orN),the replacementstatusisnotchanged.+IfyouHO7entera replacementnamewithawildcardspecification,JOVDEasksyoutoconfirmthe acceptanceofeachreplace-HOmentwhosenamematchesthewildcardspecification.*TheFOA /NOCONFIRM qualifiercausesVDEtomarkthe specifiedIO replacementsasacceptedwithoutaskingfor confirmation. ^O/EDITKO( SpecifiesthatVDEshouldinvokeyour preferrededitorsoKOthatyoucanedityourcommentfileforeachqueuedre-KO placement.,Ifsuchacommentfilealreadyexists(dueto&ACCEPT% REPLACEMENT%BROWN-3U %VDE-I-REPACCEPT,% replacement%BROWN-3&marked%as%accepted%in%databaseM" %VDE-I-COMMIT,%database% transaction%has% successfully& committedj VDE>GThisexamplemarksthatthecurrentuserfindsqueuedB1 replacementBROWN-3 acceptabletobereplacedintotheVDElibrary. O2. VDE>=ACCEPT% REPLACEMENT%SMITH-1/INPUT=COMMENT_FILE.TXTUO %VDE-I-REPACCEPT,% replacement%SMITH-1&marked%as%accepted%in%databaseM %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE>CNInthisexample,theusermarks replacementSMITH-G1asacceptedandprovidesacommentfilethatgivesG additional informationtotheuserwhoqueuedthere-W placement.EOCANCEL DIRECTORY*( 5MOCancelsa directorytemplateintheVDE database.' DirectoryKO( templates determinewhatdisk directoriesVDEcreateswhen?Ocreatingnew developmentstreamsand facilities.'ORequiresCRESTRM privilege.U+OFormatOsCANCEL DIRECTORYO DescriptionBOsTheCANCEL DIRECTORYcommanddeletesa ``directoryJO template''fromtheVDE database.* Directory templatesareCO$definedwiththeSET DIRECTORYcommandandspecifyLO|thenamesthatVDEshouldassigntodisk directorieswhenKOcreating directoriesfornew developmentstreamsorfacil-LO-itiesorforthe library'squeued-replacementstagingarea.AOTheCANCEL DIRECTORYcommandcandeletealltem-BOplatesthattheSET DIRECTORYcommandcancreate.@O7TheCANCEL DIRECTORYcommanddoesnotdeleteorCO otherwiseaffectexistingdisk directories,however.G UOUnlessthe cancelledtemplateisforthe library'sdeltafilesorSOitsstagingarea,itisonly cancelledforthedefaultdevelop-MO5mentstream.'Because directory templatesare inheritedbyaAOstream's descendants,theCANCEL DIRECTORYcommandROwillaffectthedisk directoriescreatedforallfuturedescen-SO>dantsofthedefaultstream.(Itmayalsoaffectthe directoriesBOcreatedfornew facilitiesinthedefaultstream.! fMOWhenyouhave cancelleda directory template,VDEusesitsPOdefaultrulestocreate directorytreesfor subsequentstreamsQO5and facilities.(VDEalwayscreatesstream, facility,anddelta-MOfileroot directories,whetherthereare templatesforsuchQO directoriesornot.(VDEdoesnotcreatefacilitysubdirectoriesRO>unlessthereare templatesforthem,however,soifyoucancelLOa subdirectory template,youpreventthat subdirectoryfromVDEdeletesthetemplateforthestreamor delta-filerootO directory.D! QOYoucandeletemorethanone directorytemplateatatimeby.Ousingwildcard charactersinthefac-name parameter.'TheRO5percentsign( % )inanamematchesanysingle characterinplatesforthose facilitieswhosenamesmatchthewildcard Opatternaredeleted.! UO/LOG (default)O(/NOLOGOOControlswhetherlogmessagesareprintedafterthe directoryNOtemplateisdeleted.'The/LOG qualifiercausessuchmessagesIO2tobeprintedandthe/NOLOG qualifier suppressesthem.NOThesemessagesindicatethatthe directorytemplatehasbeenMOdeletedfromthedatabaseandthatthedatabase transaction'O<has completed successfully.! "O/SUBDIRECTORY=dir-symbolQO( Specifiesthata directorytemplateforafacility subdirectoryObedeleted.&The dir-symbol.X parameter specifiesthe directoryKOsymbolthat identifiesthe subdirectory.+Amongotheruses,FO2the directorysymbolisusedwithinVDEscripts;see2ScriptOKeywordsCforfurtherdetails.-Ifthis qualifierisomitted,POVDEdeletesthe directorytemplatefora facility,stream,orMO< delta-fileroot directory.)(The descriptionofthe /FACILITYNO qualifierexplainshowthe qualifiersinteracttoselectthe Otemplatetodelete.)nDBBBOOB fOExamples O1. VDE>(CANCEL%DIRECTORY/FACILITY=RMSX %VDE-I-DIRDEL,% directory% specification% [MYDIR.RMS]%deleted&from%databaseM %VDE-I-COMMIT,%database% transaction%has% successfully& committede VDE>JThisexamplecancelsthe directorytemplatefortherootH, directoryforfacilityRMS.ThelogmessagesshowthatIthetemplatewas successfullydeletedfromthe database. O2. VDE>/CANCEL%DIRECTORY/SUBDIRECTORY=ANASYMSD %VDE-I-DIRDEL,% directory% specification%[.ANA]%deleted%from&databaseM %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE>JCThisexamplecancelsthe directorytemplateforthesub-C directorywith directorysymbolANASYM.VDEdeletesQthe subdirectorytemplatethatisusedforall facilitiesthat;Mdonothaveexplicit subdirectory templates.! "FOCANCEL PRIVILEGES*oEEODisablesVDE privilegesforthecurrentVDEsession.j@OFormat0OsCANCEL PRIVILEGESMpriv[,priv...]O ParameterOsprivOOThenameofaVDE privilegetodisableforthecurrentVDEO$session.,OForalistof privileges,seeTable3-5 ~inSET PRIVILEGES.*a?*?FO DescriptionIOsTheVDE privilegesenabledforyourcurrentVDEsessionDO determinetheVDEcommands(andinsomecasescom-JO$mand qualifiers)youareallowedtouse.)UsetheCANCELIO| PRIVILEGEScommandtodisable privilegesforthecurrentKOVDEsession.(YoumaywanttousethecommandtopreventIO- accidentalchangestothelibrary database,forexample.NHOYoucan reestablish privilegesusingtheSET PRIVILEGESKOcommandandyoucandisplayyourcurrent privilegesusing)O5theSHOW PRIVILEGEScommand.M#O QualifiersOs None.>OExamples O1. VDE>/CANCEL% PRIVILEGES&FROZEN,%USERNAME VDE>SHOW% PRIVILEGES% Currently%set& privileges:8e BUILD%CREFAC%CREGRP&CREMOD%CRESTEP&RESREP VDE>9TheCANCEL PRIVILEGEScommanddisablesthe7tFROZENandUSERNAME privileges.,THESHOW@ PRIVILEGEScommandconfirmsthatthose privileges%arenolongerset.}.@-/COCREATELIBRARY*AlMOCreatesanewVDElibrary, includingitsdatabaseanddiskO( directory structure.]3OFormat#OsCREATELIBRARYMdir-spech :>O ParameterOsdir-specPO Specifiesthenameoftheroot directoryofthelibrary.*TheRO$root directoryisthedisk directorythatcontainsthedatabaseOO|ofthelibrary.*ItnormallyalsocontainssubdirectoriesthatNOholdthecontentsofthelibrary.'UsetheOpenVMS directory1O- specificationformattospecifythe-dir-spec- parameter.KOThis parameteris required.+Ifnot specified,VDEprompts8O!youforthenameoftheroot directory.FO DescriptionPOsAVDElibraryisthe repositoryforallthemodulesinyourQOsoftwaresystem.(Alibraryconsistsofa top-leveldiskdirec-PO$torycalledtheroot directory,anRdbdatabasewhichresidesOO|intheroot directory,andanumberof directories(orsub-KO directories)whichcontainallthesourcemodules,derivedGO-modules,andother componentsofyoursoftwaresystem.)! @OTheCREATELIBRARYcommandfirstcreatesarootHO directoryforthenewlibraryanddefineslogicalnameGO5 VDE$LIBRARYtocontainthenameofthis directory.,ItOOthencreatesand initializesaVDEdatabaseintherootdi-AOrectory.*TheCREATELIBRARYcommandnormallyalsoRO>createsthedisk directory structurethatwillholdallsourcesNOandotherfilesthatmakeupyoursoftwaresystem.'However,QOifthedefault directory structureisnot appropriateforyou,NOHyoucanusethe/DEFER qualifiertopostpone directorycre-ROationuntilyouhave specifiedthe directory structurethatyouOwant.Y! /NOTheVDEdatabaseisa multifileRdb database.'ThisdatabasePOconsistsofthreeseparatefiles:,anRdbrootfile(the.RDBTO5file),astorageareafile(the.RDAfile),andasnapshotfileOO(the.SNPfile).+The.RDBfileisalwaysstoredintheVDENO library'sroot directory.-Thisfileis relativelysmall.-TheNO>.RDAfilestoresthebulkofthedatabasecontentsandtheKO.SNPfileallowsmultipleuserstousethedatabasecon-LO currently.*The.RDAand.SNPfilesarestoredintheVDESOH library'sroot directorybydefault,butyoucanspecifydiffer-LOent directory locationsforthesefileswiththe /DATABASELOand /SNAPSHOT qualifiers,orbydefiningthelogicalnamesDOR VDE$DB_AREAand VDE$SNAPSHOT.ByplacingthesefilesROon differentdisks,youcan distributeyourVDE library'sspace:OandI/O requirementsacrossmultipledisks. XLOYoumayalsowantto establishanRdb after-imagejournalLOfilefortheVDE database.*IfusedwiththeRMUdatabaseRO5backup facility,suchajournalfileallowsRdbtorecoverallSOdatabasedataasofthelast completed transactionafteradiskNOfailure.'To establish journalling,usethe/JOURNAL qualifierSO>tospecifythe directorylocationofthejournalfile.)Thisdi-ROrectoryshouldalwaysbeona differentphysicaldiskthanthe(OrestofyourVDE database.HOOnceyouhavecreatedanewVDElibrary,thatlibraryGObecomesthecurrentVDElibraryforyourpresentpro-IO5cesssothat subsequentVDEcommandsactuponthatli-IObrary.,TochangethecurrentVDElibrary,youmustuseAOtheSETLIBRARYcommandorredefinelogicalnameHO> VDE$LIBRARYtopointtotheroot directoryoftheVDE-Olibraryyouwanttoworkwith.! YQOMoststepsincreatinganewVDElibraryare reasonablyfast.LOForexample,each directoryinyour directory structureisRO5createdinafractionofasecondunlessyoursystemisheav-MOilyloaded.(However,VDErequiresseveralminutestocreateOOand initializethelibrary database.(ThedatabasecanusuallyOO>becreatedinaboutsixtoeightminutesbutmoretimemayOOberequiredonaheavilyloadedsystem.*Alogmessagetells0Oyouwhendatabasecreationstarts. O Qualifiers"Os /ALLOW_DELETE (default)O/NOALLOW_DELETE2O$ Specifiesthedefaultvalueforthe$delete4$ attributefornewBO|modules, facilities,andstreams.,The /ALLOW_DELETE.O qualifiercausesVDEtosetthedelete attributebyde-JO-faultwhenuserscreatenewsuch entities./Asaresult,SOuserscandeletetheseentitieswithoutfirsthavingtosettheOdelete=j attributewithaseparateMODIFYcommand.*TheAO7/NOALLOW_DELETE qualifiercausesVDEtocleartheOdeleteFk attributebydefaultfornewmodules, facilities,andXOstreams.'Asaresult,itisharderforausertodeleteanentity%OAbymistake;theentity'sAdelete+A attributemustbesetwithaJOseparateMODIFYcommandbeforetheentitycanbedeletedBOwithaDELETEcommand.+Whencreatingnewmodules,POJ facilities,andstreams,youcanoverridethisdefaultsettingHOwithanexplicit/DELETEor /NODELETE qualifiertotheOCREATEcommand.u KGOUsethe /ALLOW_DELETE qualifierifyouexpecttomakeJOfrequentchangestoyourlibrary,oftendeletingmodules,FO5 facilities,andstreams.'Usethe/NOALLOW_DELETEqual-MOifierifyouaremore concernedabout preventing accidental'Odeletionofsuch entities. O/ASK_INFO_FILE%O(/NOASK_INFO_FILE (default)HO SpecifieswhethertheREPLACEcommandshouldbydefaultMOasktheuserwhetherheorshewantstoeditaninforma-IO2tionfilewhencreatingaqueued replacement.+The/ASK_NO INFO_FILE qualifiersetsalibrary attributethatcausestheHOREPLACEcommandtoaskforan informationfilebyde-IO<fault.)The/NOASK_INFO_FILE qualifierclearsthislibraryIO attributesothattheREPLACEcommanddoesnotaskforROan informationfilebydefault.'Thislibrary attributeonlyaf-FOEfectsqueued replacements(not immediatereplacements),JOanditonlyaffectstheREPLACE command'sdefaultbehav-EOior;userscanalwaysusethe command's /INFORMATIONHOOor/NOINFORMATION qualifierto explicitlyrequesteitherO behavior. ^O/ASK_REPL_CAUSE&O(/NOASK_REPL_CAUSE (default)HO SpecifieswhethertheREPLACEcommandshouldbydefaultPOasktheuserforthe ``cause''ofthe replacement.)ThecauseKO2maybeafold operation,aSourceControlTracking(SCT)OOentryinaNotes conference,orsomeothercause.'The/ASK_JO REPL_CAUSE qualifiersetsalibrary attributethatcausesFO<theREPLACEcommandtoquerytheuserforthecauseBOofthe replacement.)The/NOASK_REPL_CAUSE qualifierKOclearsthislibrary attributesothattheREPLACEcommand1OEdoesnotaskforthis information. -O/AUTH_PRIVILEGES=(priv [,priv...])NO( Specifiesthestandard authorized privilegesforthelibrary.KOThesearethe authorized privilegesthatanewusergetsNOwhenaddedtothelibraryunlessa differentsetofautho-TO2rized privilegesis explicitly specifiedforthatuser.' AuthorizedRO privilegesarethoseVDE privilegestheuserisallowedtoset-OwiththeSET PRIVILEGEcommand.%MOIfonlyone privilegeis specified,the parenthesesmaybeNOomitted.+Ifthis qualifierisomitted entirely,VDEprovidesNO5defaultvaluesforthestandard authorized privilegesoftheOlibrary. OEachprivC parameter specifiesthenameofone privilege.'For'Oalistof privileges,seekTable3-5 inCSET PRIVILEGES.*ka?*C?! r'O/AUTO_ADD_USER[=rights-ident]%O(/NOAUTO_ADD_USER (default)MO SpecifieswhethernewusersshouldbeaddedtothelibraryKOdatabase automaticallywhentheyfirstaccessthelibrary.EO2The/AUTO_ADD_USER qualifier specifiesthatnewusersLOshouldbeaddedtothelibrarydatabase automaticallywhen5Otheyfirstaccessthelibrary.*Ifthe? rights-ident@parame-WO<teris specified,newusersareonlyaddedtothelibraryiftheyMOholdtheOpenVMSrights identifier specifiedbytheparame-FOter.(The/NOAUTO_ADD_USER qualifier specifiesthatnewOOEusersnotbeaddedtothelibrarydatabaseautomatically.)InOOthiscase,newuserscanonlybeaddedwithexplicitCREATEOUSER commands.! `FOTheowner information specifiedintheOpenVMSSYSUAFOOdatabasewillbeusedastheownerofanynewVDEusernameLO5created.)VDEwillignoreanyleading numerics,leadinghy-OOphens,leadingspace characters,andleadingtilde characters,0OlistedintheSYSUAFownerfield.Y! /O /AUTO_CONVERT$O(/NOAUTO_CONVERT (default)NO Specifieswhetherthelibraryanditsdatabaseare automati-POcally convertedtothenewlibraryformatwhenanewversionTO2ofVDEisusedonthelibrary.'AnewversionofVDEwillfre-IOquentlyrequirea differentdatabaseschemaandpossiblyMOotherchangestoalibrarythanthepreviousversion.*EachOO<newversionofVDEcanconvertaVDElibraryfromanolderNOformattothecurrentformat.)Thisiseitherdone automati-QOcallythefirsttimesomeoneaccessesthelibrary database,orGOEitisdonewithan explicityCONVERTLIBRARYcommand.7OThese qualifiers determinethe behaviour. FOThe /AUTO_CONVERT qualifier specifiesthatthelibraryOOshouldbe converted automaticallythefirsttimeauserusesRO5anewversionofVDEonthepresentlibraryandits database.EO/NOAUTO_CONVERT specifiesthatthelibraryshouldnotKObe convertedautomatically;insteada privilegedusermustHO> explicitlyconvertthelibrarywiththeCONVERTLIBRARYOcommand.[1LOThe advantageof automatic conversionisthatitisauto-QOmaticandrequiresnospecialstepsonthepartoftheuser.RO5However,oncealibraryhasbeen converted,itisnotpossibleBOtouseanolderversionofVDEonthatlibrary.jMOThe advantageof disabling automatic conversionisthatyouPOgetachancetobackupthedatabase(orthewholelibrary)OO5beforeyou explicitlyconvertthelibrary.*YouthenhavetheQOoptionof restoringthebackedupcopyofthelibraryifyouNOneedtogobacktousingtheoldversionofVDE.However,NO>onceyouinstallanewversionofVDE,nobodycanusetheSOexistinglibraryuntilitis converted.(Also,all accessorsmust>Ousethesameora compatibleversionofVDE. xMOIngeneral, automatic conversionisbestforsmallVDEli-KObrarieswhose databasesare relativelyeasytorebuildifOO5 necessary.'Explicit conversionmaybemoresuitableforlargeTO librarieswherethe difficultyof rebuildingthelibrary justifies=Omore stringentbackupandrecovery procedures.V,,O/NOAUTO_CONVERTisthedefault.q GO /AUTO_MAIL (default)O( /NOAUTO_MAILIO SpecifieswhetherVDEshould automaticallysendmailno-KO tificationtotheuserwhohasqueueda replacementwhenCO2that replacementislater performed.,The /AUTO_MAILLO qualifiersetsalibrary attributethatcausesthePERFORMCO REPLACEMENTcommandtosendsuchmail notification.HO<The /NOAUTO_MAIL qualifierclearsthislibrary attributeAOsothatthePERFORM REPLACEMENTcommanddoesnot#Osendsuch notification. #O/CMS_ELEM_HIST (default)O(/NOCMS_ELEM_HISTHO SpecifieswhetherVDEcreatestheCMSelementsfornewIOmoduleswithdefaultCMShistoryandnotesstrings.+TheFO2/CMS_ELEM_HIST qualifiercausesVDEtocreatetheCMSIOelementsfornewmoduleswithdefaulthistoryandnotesEOstringsandthe/NOCMS_ELEM_HIST qualifiercausesVDEJO<tocreateCMSelementswithnodefaulthistoryornotesBOstrings.,/NOCMS_ELEM_HISTisnormallyonlyusedifEOyou regularlyfetchVDEmodulesusingtheCMSFETCHIOEcommandandyouwanttomakesureyoudonotgetCMSKOhistoryornotesbydefault.-IfyoualwaysfetchthroughHOVDE,use/CMS_ELEM_HISTbecauseitallowsVDEtoavoidIOOa deficiencyinCMSandalwaysgiveandremovehistory!O information correctly.  O/CREATOR_NAME="string"PO( Specifiesthefullnameoftheuserwhocreatedthelibrary.IOThequotednamestring,whichmaybeupto40charac-QOterslong,shouldcontainyourfirstname,middleinitial,and?O2lastname.+TheCREATELIBRARYcommand automati-UOcallycreatesauserrecordinthenewlibraryforthe library'sNOcreator.'Thisnamestringbecomespartofthatuserrecord.0JOThis qualifieris required.,AnemptynamestringmaybeIO specifiedbutthisisnot recommended.+Ifthe /CREATOR_MO5NAME qualifierforalibraryisnot specified,VDEprompts&Oyouforthenamestring.C UO/DATABASE=dir-specOO( Specifiesthatthedatabasestoragearea(.RDA)fileandtheROsnapshot(.SNP)filebecreatedinthe directorylocationgivenObytheFdir-spec: parameter.*This qualifierletsyouputtheMO2largestpartoftheVDEdatabaseona differentdiskthanQOtherestoftheVDElibrary.*Ifyouomitthis qualifier,VDEMOcreatesthe.RDAand.SNPfilesintheVDE library'srootO< directory.@ O/DEFERO(/NODEFER (default)OO Specifieswhetherthecreationofthe directory structureforHOthenewlibraryshouldbe postponed.,The/DEFERquali-RO2fier postponescreationofthedisk directory structurefortheHOlibraryandthe/NODEFER qualifiercausesthe directoryLO structuretobecreated immediately.'Usethe/DEFERquali-PO<fierwhenthedefault directory structureis inappropriateforOthenewlibrary. aMOIfthe/NODEFER qualifieris specified(or/DEFERisomit-IOted),theCREATELIBRARYcommandfirstcreatestherootPO5 directoryandtheVDEdatabaseforthelibrary.(Thenitcre-NOatesthe remainingdisk directory structureforthelibrary.OOThis structure,whichincludes directoriestohold delta-filesSO>foronefacilityand directoriestoholdfilesforonedevelop-SOmentstream,is determinedbythedefaultrulesoftheutility.OOOncethe directory structureexists,sourcemodulesandother7OHfilescanbeaddedtothenewlibrary.! JOIfthe/DEFER qualifieris specified,theCREATELIBRARYKOcommandcreatesonlythe library'sroot directoryanditsMO5 database;itdoesnotcreatethe remaining directorystruc-NOtureforthenewlibrary.*Ifyouusethe/DEFER qualifier,EOyoucanenterSET DIRECTORYcommandstospecifytheJO>disk directoriesyouwantforthelibrary..Thenusethe@OCREATEDIRECTORY_TREEcommandtocreatethatdi-@Orectory structureondisk.-TheCREATE DIRECTORY_HOHTREEcommandusesVDEdefaultscombinedwiththerulesIOyou specifiedwithSET DIRECTORYcommandstocreatethe$Onew directory structure.! ,O/DEF_PRIVILEGES=(priv [,priv...])RO( Specifiesthestandarddefault privilegesforthelibrary.'TheseROarethedefault privilegesthatanewusergetswhenaddedtoWOthelibraryunlessa differentsetofdefault privilegesisexplic-QO2itly specifiedforthatuser.)Default privilegesarethoseVDEOO privilegesthatareenabledeachtimetheuserstartsaVDEOsession."MOIfonlyone privilegeis specified,the parenthesesmaybeNOomitted.+Ifthis qualifierisomitted entirely,VDEprovidesKO5defaultvaluesforthestandarddefault privilegesoftheOlibrary. OEachprivC parameter specifiesthenameofone privilege.'For'Oalistof privileges,seekTable3-5 inCSET PRIVILEGES.*ka?*C?! NNOEach privilege specifiedbecomesastandard authorizedprivi-SOlegeaswellasastandarddefault privilege.'ThisruleensuresRO5thatusersare authorizedtohavealltheirdefault privileges.x rN#O/HISTORY_NOTES (default)O(/NOHISTORY_NOTESCO SpecifieswhetherVDE'sRESERVEcommandcanproduceLOCMShistoryornotes informationinitsoutputfiles.,The?O2/HISTORY_NOTES qualifierallowstheRESERVEcom-NOmandtoproducehistoryandnotes informationandtoacceptCOthe /HISTORY,/NOTES,and /POSITION qualifiers.,TheAO</NOHISTORY_NOTES qualifiercausestheRESERVEcom-KOmandtoneverproducehistoryandnotes information(evenJOwhensuch informationisthedefaultforamodulebeingGOE reserved)andtonotacceptthe /HISTORY,/NOTES,andKO /POSITION qualifiers.+Inthiscase,youmustusetheVDEGOFETCHcommandtogetCMShistoryornotes informationOOOforamodule.( Disablinghistoryandnotes informationinre-LOservedfilesmakescertainmistakeslesslikelywheresuchQO informationgetsreplacedintotheVDElibraryaspartoftheOYmoduletext.! uO/JOURNAL=dir-specNO(Enables after-image journallingand specifiesthatadatabaseRO after-imagejournal(.AIJ)filebecreatedinthe directorylo- Ocationgivenbythedir-spec& parameter.*WhenusedwithIO2theRMUbackupandrestore facilities, after-imagejour-POnallingallowsyoutorecoverthe up-to-datecontentsofyourOOdatabaseafteradiskfailure.)The specified directoryshouldOO<alwaysresideona differentphysicaldiskthananyofyourSOotherdatabasefilessothatthejournalfilecannotbedamagedQObythesamediskfailureasthedatabaseitself.+IfyouomitMOEthis qualifier,VDEdisables after-image journalling.)Digital:O recommendsthatyoualwaysuse journalling.pO/LOG (default)O(/NOLOGHOControlswhetherlogmessagesareprintedwhenthenewKOlibraryiscreated.,The/LOG qualifiercausesmessagestoJO2beprintedandthe/NOLOG qualifier suppressesthem.)TheLOmessagesindicatethatthelibraryanditsmany componentsOhavebeencreated. ! O/NAME=lib-nameRO( Specifiesanameforthenewlibrarytobecreated.'ThisnameMOmaybeupto39 characterslongandmustfollowVDEnamePOsyntax.(VDEstoresthisnameinthedatabaseanddisplaysitGO2backtoyouwhenyouentertheSHOWLIBRARYorSHOWIODEFAULTScommand.*This qualifieris required;ifyoudoHOnotspecifyit,VDEpromptsyouforthelibraryname.O/REMARK="string"LO( Specifiesaremarkstring.(Thequotedremarkstring,whichNOcanbeupto132 characterslong,maycontainanyexplana-MOtoryremarkaboutthenewlibrarythatyouwantstoredinKO2the library's database., Typicallytheremark describesthe7Opurposeorcontentsofthenewlibrary. NPOAlthoughthis qualifieris required,youcanspecifyanemptyNOremarkstring.'Ifyoudonotspecifythe/REMARK qualifier,4O5VDEpromptsyouforaremarkstring. h"O /REPL_HISTORY (default)O(/NOREPL_HISTORYNO SpecifieswhetherVDEshouldmaintainahistoryofallpastKOsourcecode replacementsintotheVDElibrary.'The/REPL_FO2HISTORY qualifier specifiesthatsuchhistoryinforma-FOtionbe maintainedintheVDE database.,The/NOREPL_IOHISTORY qualifier specifiesthatsuch informationnotbeFO< maintained.+Whenyoumaintain replacementhistory,youKOcandisplaypast replacementsusingthe/HISTORY qualifier.OtotheSHOW REPLACEMENTcommand.l>OFor documentationontheSHOW REPLACEMENTcom-OmandinSHOW REPLACEMENT.*?7!  O /SEND_MAIL (default)O( /NOSEND_MAILMO SpecifieswhetherVDEshouldsendmail notificationmessagesLOforthoseVDE operationsthatnormallysendsuch messages.HO2The /SEND_MAIL qualifierenablesVDEtosendsuchmailAOmessagesandthe /NOSEND_MAIL qualifier suppressesEOallVDEmail messages.*The /NOSEND_MAIL qualifierisLO<usefulwhenyouwanttotestorplaywithaprivateVDELOlibrarywithoutsending notificationmessagestootherpeo-LOple.)However,fornormal productionuse,youshouldalwaysHOEleavethemail notificationfeatureenabled.+TheCREATEEOLIBRARYcommandenablesmail notificationbydefault.d :O/SHOW_ARCH_NAME&O(/NOSHOW_ARCH_NAME (default)HO Specifieswhetherthe architecturenameis displayedasFOpartofeverymodulenameinVDEoutput.+The/SHOW_IO2 ARCH_NAME qualifiersetsalibrary attributethatcausesLOVDEtoalwaysincludethe architecturenameineverymod-LOulenameit displays.*This attributealsocausestheSHOWEO<DEFAULTScommandtodisplaythedefault architecture.BOThe/NOSHOW_ARCH_NAME qualifierclearsthislibraryIO attributesothatVDEomitsthe architecturenameswhenMOE displayingmodulenames.'YounormallyonlywanttoseetheMO architecturenameifyouhavedefinedmultiple architectures"OforyourVDElibrary._55O This qualifierisnotyet implemented. O/SHOW_GEN_EXPR%O(/NOSHOW_GEN_EXPR (default)GO Specifieswhethertheexpected replace-timeCMSgenera-NOtion expressionforeachmoduleis displayedbytheRESERVE@O2command.-The/SHOW_GEN_EXPR qualifiersetsali-CObrary attributethatcausestheRESERVEcommandtoGOcomputeanddisplaytheCMS generation expressionthatDO<the correspondingREPLACEcommandismostlikelytoMOuseforthenewmodule generation.*YoucanusethisvalueQOasan``audittrail identifier''inyourcodeifyourprojectNOEusesthis convention.+Thislibrary attributealsocausesthe@OSHOW RESERVATIONcommandtodisplaytheexpectedHOCMS generation expressionanditcausestheREPLACEor>OOPERFORM REPLACEMENTcommandtoprintaninfor-IOmationalmessageiftheactualCMS generation expressionROforthereplaced generationturnsouttobe differentthantheDOYexpectedone.'The/NOSHOW_GEN_EXPR qualifierdisables#Othislibrary attribute.acIOPleasenotethatVDEcannot guaranteethattheexpectedMOCMS generation expressionwillactuallybeused.+ItisnotEO5possibleto determineatRESERVEtimewhetheraCMSNOvariantlettershouldbeusedwhenthemoduleis eventuallyKO replaced;thatdecisioncanonlybemadeatREPLACEtimeHO>anddependson propagation decisionsandstreamsucces-KOsor relationshipsatthattime.)However,theexpectedCMSMO generation expressionis generallytheonethatisactuallyOHused. O/SNAPSHOT=dir-specQO( Specifiesthatthedatabasesnapshot(.SNP)filebecreatedin2Othe directorylocationgivenbythe+dir-spec parameter.'ThisSO qualifierletsyouputthesnapshotfileonaseparatedisktoOO2betterusediskspaceortoimprovedatabase performance.(IfROyouomitthis qualifier,VDEcreatesthe.SNPfileinthedi-LOrectorygivenbythe /DATABASE qualifierifthat qualifierSO<is specified.*Ifneither qualifieris specified,VDEcreatestheCOsnapshotfileintheVDE library'sroot directory. fO/LOCKO(/UNLOCKFOThe/LOCKand/UNLOCK qualifiersprovideamethodbyAOwhichRESERVE,REPLACE, UNRESERVE,andothersim-NO2ilarcommandscanbedisabledonacopyofaVDElibrary.KOThis mechanismisnotintendedto completelylock-outall&OaccesstoaVDElibrary. eHO Specificationof/LOCK write-locksthelibrary,andtheFO corresponding/UNLOCK qualifierreversesthelock.+TheRO5 write-lockstatusisreadonlywhentheuser initiallyaccessesROthe library-onceauserhas connectedtothelibrary,thelockOstatusis  notupdated.NMOA write-lockedlibrarycanbeusedtopreventvarioususerMO modificationstothecontentsofthelibraryduringlibraryJO5 maintenance,ortomaintainashadowcopyofalibrary. NIOUsersholdingtheMODLIB privilegeareallowedtoover-OOridethelibrary write-lock.'An informationalmessagewillbe5O5 displayedwhenthelockis overridden.! O /STATISTICSSO(Enables statistics collectiononthe specifiedlibrary.)ThiswillNOcausevariousextra questionstobeaskedduring replacementMOandrelated operations.*Thisincludestheadditionofques-QO2tionsaroundthereasonforthechange,thenumberofdefectsQOfixed,andthe particularprojectachangeis associatedwith.< #O /WILD_INS_GEN$O(/NOWILD_INS_GEN (default)NO Specifieswhetherwildcard charactersareallowedinthepa->OrameterstotheINSERT GENERATIONcommandwhenFO2the /GENERATION qualifieris specified.)The /WILD_INS_JOGEN qualifiercausesVDEtoallowwildcard charactersinBOsuch parameterswhilethe/NOWILD_INS_GEN qualifierHO<causesVDEtonotallowsuchwildcard characters.+When=Othe /GENERATION qualifiertoINSERT GENERATIONPO specifiesaspecificCMS generation expression,itisunlikelyOOEthatthis generation expressioncouldapplytomorethanoneQOmodule.+Asaresult,itisunlikelythattheuseofwildcardGO charactersinthe module-name parameterswillgivetheKOOresulttheuser intended.)Toprevent mistakes,VDEthere-OOforedoesnotallowsuchwildcardusagebydefault.'However,MO ! !therearesome situationswhensuchusagemightbecorrectMOY(forexample,ifthe specifiedCMS generation expressionisOO1).*Forsuch situations,youcanenabletheuseofwildcard:O  characterswiththe /WILD_INS_GEN qualifier.  j. OExamples O1. VDE>5CREATE%LIBRARY& [PROJDIR]% /NAME=NEWLIB%- _VDE>&4/CREATOR_NAME="John&Doe"%-C _VDE>*4C /REMARK="Main&project%library"J Library&NEWLIB%to%be%created&in&root% directory& [PROJDIR]DD Library&root% directory&DEV$:[PROJDIR]&already%exists.ID Logical&name% VDE$LIBRARY%now&points%to%the%new&library.7Dc Creating%library& database;%please%wait...0D Library&database&has%been&created.V Staging&area%root% directory%DEV$:[PROJDIR.VDE$STAGE]&has%been&created7} Creating% directory%tree%for%delta%files:ED Root& directory%DEV$:[PROJDIR.VDE$CMS]&has%been&createdZD  Facility%CODE&root% directory&DEV$:[PROJDIR.VDE$CMS.CODE]%has%been%created?U CMS%library%for%facility%CODE%has%been%created9D All% directories%for&delta&files&now%exist7 Creating% directory%tree%for%stream&MAIN:BDN Root& directory%DEV$:[PROJDIR.MAIN]&has%been&createdG Subdirectory%DEV$:[PROJDIR.MAIN.VDE$BLD]&has%been&createdWD Facility%CODE&root% directory&DEV$:[PROJDIR.MAIN.CODE]%has%been%createdH& Subdirectory%DEV$:[PROJDIR.MAIN.CODE.SRC]%has%been%createdHn Subdirectory%DEV$:[PROJDIR.MAIN.CODE.OBJ]%has%been%createdL Subdirectory% DEV$:[PROJDIR.MAIN.CODE.VDE$COM]%has&been%createdL Subdirectory% DEV$:[PROJDIR.MAIN.CODE.VDE$LOG]%has&been%created9DF All% directories%for&stream%MAIN&now%exist' Library&creation& completed. VDE>B ThiscommandcreatesanewlibrarycalledNEWLIB.J Theroot directoryforthenewlibraryisDEV$:[PROJDIR]J8 andthenameofthecreatorisJohnDoe.*Thelogmes-E sagesindicatewhenthevariousstepsare completed.M FirstVDE indicatestheroot directoryofthelibrarycur-EB rentlyexistsandbindsthelogicalname VDE$LIBRARYJ tothat directory.*ThenVDEcreatesthedatabaseoftheC library,whichmaytakeseveralminutes.,Next,VDEMK createsthe directory structureforthedeltafilesoftheI project.,Finally,itcreatesthe directory structurefor= streamMAIN,theonlystreaminthelibrary. Ou 2.u VDE>u CREATE%LIBRARYB Enter% directory% specification%for%the&new%library:D  [PROJDIR]> Enter%the%name%you%want%for%the&new%library:dNEWLIB=L Enter%your&full%name%(first%and&last%names):dLJohn&Doe0 Enter%the%remark&for%new%library: Main%project&libraryJ Library&NEWLIB%to%be%created&in&root% directory& [PROJDIR]DD$ Library&root% directory&DEV$:[PROJDIR]&already%exists.IDl Logical&name% VDE$LIBRARY%now&points%to%the%new&library.7D Creating%library& database;%please%wait...0D Library&database&has%been&created.7e Creating% directory%tree%for%delta%files:ED Root& directory%DEV$:[PROJDIR.VDE$CMS]&has%been&createdZD Facility%CODE&root% directory&DEV$:[PROJDIR.VDE$CMS.CODE]%has%been%created?= CMS%library%for%facility%CODE%has%been%created9D All% directories%for&delta&files&now%exist7 Creating% directory%tree%for%stream&MAIN:BD6 Root& directory%DEV$:[PROJDIR.MAIN]&has%been&createdWD~ Facility%CODE&root% directory&DEV$:[PROJDIR.MAIN.CODE]%has%been%createdH Subdirectory%DEV$:[PROJDIR.MAIN.CODE.SRC]%has%been%createdH Subdirectory%DEV$:[PROJDIR.MAIN.CODE.OBJ]%has%been%createdLV Subdirectory% DEV$:[PROJDIR.MAIN.CODE.VDE$COM]%has&been%createdL Subdirectory% DEV$:[PROJDIR.MAIN.CODE.VDE$LOG]%has&been%created9D All% directories%for&stream%MAIN&now%exist'O Library&creation& completed. VDE>F'Inthisexample,theuserentersthekeywordsCREATEBLIBRARYandVDEpromptsforallotherneededin-J formation.*Thenewlibraryiscreatedexactlyasinthe1previousexample.  $Z $!%Locate%and&delete%previous% incarnations%of%the&test%facility%files,IE $!%then&unpack%the%saveset% containing&the%test&files...  $` $&if&f$search("sys$scratch:A.REQ")&.nes.&""&Then%Delete&sys$scratch:A.REQ;*/log` $&if&f$search("sys$scratch:B.REQ")&.nes.&""&Then%Delete&sys$scratch:B.REQ;*/log`e $&if&f$search("sys$scratch:C.B32")&.nes.&""&Then%Delete&sys$scratch:C.B32;*/log` $&if&f$search("sys$scratch:D.B32")&.nes.&""&Then%Delete&sys$scratch:D.B32;*/log` $&if&f$search("sys$scratch:E.B32")&.nes.&""&Then%Delete&sys$scratch:E.B32;*/log`= $&if&f$search("sys$scratch:F.B32")&.nes.&""&Then%Delete&sys$scratch:F.B32;*/log  $6 $&Backup%VDE$CREATE.BCK/SAVE& Sys$Scratch:  $J] $!%Create%the&core% directory&--&this%must%be% present...  $? $&Create/Directory% STAR$DATA:[QTV.WWW.VDE$DATABASE]5 $&VDE } !O !&create%the%WWW&library%in%STAR$DATA:[QTV.WWW...],%using%theO  !&mnemonic&WWW,%placing%all% Rdb-related%library% components&in.U !&!STAR$DATA:[QTV.WWW.VDE$DATABASE].  !E create%librarK STAR$DATA:[QTV.WWW.VDE$DATABASE]%/DEFER%-, /NAME=WWW&-0t /REMARK="QTV&WWW%Source%Library"%-C /NOAUTO_CONVERT&/AUTO_ADD_USER=VMS_SOURCE% /AUTO_MAIL%-I /ASK_INFO_FILE%/ASK_REPL_CAUSE&/SHOW_GEN_EXPR& /NOSTATISTI&-?L /NOHISTORY_NOTES%/NOALLOW_DELETE%/NOWILD_INS_GEN&-: /NOCMS_ELEM_HIST%/CREATOR="Stephen%Hoffman"%-3 &/DEF_PRIVILEGES=(CREMOD,RESREP,CREFAC)%-4$ '/AUTH_PRIVILEGES=(CREMOD,RESREP,CREFAC)&-3l &/data=STAR$DATA:[QTV.WWW.VDE$DATABASE]%-4 '/journ=STAR$DATA:[QTV.WWW.VDE$DATABASE]&-0 &/snap=STAR$DATA:[QTV.WWW.VDE$DATABASE] D ! SHOW&DEFAULTS SHOW& LIBRARY/FULL=! MODIFY%CONTEXT/PUBLIC%DEFAULT/NOSTREAM/NOFACILITY d! !:! CREATE%USER%SYSTEM% /NAME="System%Manager"%-8i! $/DEF_P=ALL/AUTH_P=ALL/REMARK="System&Manager" <" !H" !&Create%the%CMS& ("delta")%library& directory% structure.P" !& Configure%the%CMS& libraries%to%use%the& directory% structure:=# !p0STAR$DATA:[QTV.WWW.CMS$DATABASE.'facility'.CMS].Q[# !& Configure%the%"marker"%files%to%use&the% directory% structure:?# !p2STAR$DATA:[QTV.WWW.CMS$DATABASE.'facility'.SRC]... # !F3$ SET%DIRECTORY/DELTA_FILES& STAR$DATA:[QTV.WWW.CMS$DATABASE]A{$ SET%*DIRECTORY/DELTA_FILES/SUBDIRECTORY=VDE$CMS&[.CMS]D$ SET%-DIRECTORY/DELTA_FILES/SUBDIRECTORY=VDE$MARKER&[.SRC], % CREATE%DIRECTORY_TREE/DELTA_FILES%S% SHOW&DIRECTORY/DELTA_FILES % !*% !&Create%the%staging%area... +& !As& SET%DIRECTORY/STAGING%STAR$DATA:[QTV.WWW.VDE$STAGING](& CREATE%DIRECTORY_TREE/STAGING ' !3K' !&Create%the% stream/build& directories ' !?' SET%DIRECTORY/STREAM%STAR$DATA:[QTV.WWW.VDE$STREAM]'#( CREATE%DIRECTORY_TREE/STREAM j( !9( !&create%and%load%the%VDE&test% facility. ( !+B) CREATE%FACILITY% AAA_VDE_TEST&-8i) /REMARK="Test%facility%for%VDE& developers"&) SET%FACILITY% AAA_VDE_TEST"D* CREATE%MODULE/NODELETE/REMARK="VDE& self-test%module"&-$b* /INPUT=SYS$SCRATCH:%A.REQD* CREATE%MODULE/NODELETE/REMARK="VDE& self-test%module"&-$* /INPUT=SYS$SCRATCH:%B.REQD:+ CREATE%MODULE/NODELETE/REMARK="VDE& self-test%module"&-$+ /INPUT=SYS$SCRATCH:%C.B32D+ CREATE%MODULE/NODELETE/REMARK="VDE& self-test%module"&-$, /INPUT=SYS$SCRATCH:%D.B32DZ, CREATE%MODULE/NODELETE/REMARK="VDE& self-test%module"&-$, /INPUT=SYS$SCRATCH:%E.B32D, CREATE%MODULE/NODELETE/REMARK="VDE& self-test%module"&-$2- /INPUT=SYS$SCRATCH:%F.B32 z- !- EXIT . $Q. $&Exit}/9.0BOCREATEMODULE*hBOCreatesanewmoduleinthecurrentVDElibrary.&OkRequiresCREMOD privilege.nDOFormat4OsCREATEMODULENmod-name[, mod-name...] O ParameterOsmod-nameHOThenameofthemodulebeingcreated.*ThemodulenameIO$mustconsistofamodulenameandamoduletypesepa-JO|ratedbyaperiod(asin MODNAM.FOR).Itmay optionallyMObeprecededbyafacilitynameenclosedinsquarebracketsBO-(asin[ACCTNG]MODNAM.FORwhereACCTNGisthefa-QOcilityname).+Ifnofacilitynameis specified,themoduleisROassumedtobelongtothecurrentdefault facility.(ThefacilityJO7name,modulename,andtypenamemayeachbeupto39AO characterslongandmustfollowVDEnamesyntax. FO Description?OsTheCREATEMODULEcommandcreatesanewmoduleLOinthecurrentVDElibrary.+ItrecordsthenewmoduleinNO$theVDE database, includingits facility,name,type,remarkLO|string,andother attributes.*EverymodulebelongstosomeVO facility,eitherthefacilityyou explicitlyspecifyorthecurrentO-default facility.3  NOModulesare classifiedassourcemodulesorderivedmodules. OAsourcemodule9isatextfile (normally)whichyoucre-JO5ateandmodifymanuallywithaneditor.*AsourcemoduleOOcanbereservedfromandreplacedintotheVDElibrarywithDOtheRESERVEandREPLACE commands.)ThetextofeachQO>sourcemoduleisstoredinadeltafilewithinaCMSlibrary1OintheformofaCMS ``element.''}! tSGOBydefault,theCREATEMODULEcommanddoesnotcreatePOtheinitial generationofasourcemodule.)InsteaditrecordsNO5themoduleintheVDEdatabaseandreservesitforyouinHOyourdefault developmentstream.+YoumustthenusetheJOREPLACEcommandtoactuallycreatetheinitial generationLO>ofthemodule.+ThisshouldbethenormalwayofcreatingKOnewmodulesoncetheVDElibraryis established.*However,DOifyouusethe/INPUTor/FROM_DIRECTORY qualifier,EOHtheCREATEMODULEcommandcreatestheinitialgener-NOationsofthenewmodules;these qualifiersareusefulwhenMOyou initially establishyourVDElibrary.)(Notethat/INPUTQORmaynotbe available, dependingonthesettingofthequeued-OO replacementoptiononthestream.'If/INPUTisnot accepted,FOyoumustusea subsequentREPLACEcommandtospecify;O[thecontentsofthemoduleunder creation.) OAderivedmodule<:isafileorotherentitythatisproducedOObyan automatedbuildstep,suchasanobjectmoduleoranJO5 executableimage.*AderivedmodulecannotbereservedorJO replaced.*Inmostcases,VDE automaticallyentersderivedJOmodulesintotheVDEdatabasewhenthemodulesarepro-GO>duced;youseldomneedtoenterthemwiththeCREATE>OMODULEcommand.,However,whenaderivedmoduleNOneedstobeenteredintothedatabase manually,youcandoEOHsowiththe/DERIVED qualifiertotheCREATEMODULEOcommand.9MOIfamoduleis mistakenlycreated,onecanusetheDELETEHOMODULEcommandtoreversetheactionanddeleteit-the"O5 UNRESERVEcommandwill5 refuse#x5todeletemodulesthat%Olackafirst generation. DOTheDELETEMODULEcommandallowsthecreatorofanIOerrantmoduletocorrectsimple mistakes-suchasamis-FO5namedmodule-without requiringunusual privileges.)WithBOtheDELETEMODULEcommand,thecreatorcandeleteOthemodule prior8totheinitialmodule replacement.'DELETEFO>MODULEwillcancelthe outstanding reservationontheJOmodule,willremovethemodulefromany reservationses-SOsionthatitmightbeincludedin,andwillpreventthemoduleMOHfromever appearingintheVDElibrary.)Forfurtherinfor-8OmationontheDELETEMODULEcommand,seekDELETEOMODULE.1(TheDELETEMODULEcommandnormallyHORrequiresDELMOD privilege.,Inthis particular situation,KOCREMOD privilegeis sufficienttopermitmodule deletion.)nMDkkeeOO! {O QualifiersOs/BINARYO /NOBINARY (default)PO$ Specifieswhetherthesourcemoduleisabinaryfileornot.NO|The/BINARY qualifier specifiesthatthesourcemoduleisaPObinary (non-text)file.'Binarysourcefilescannotbereviewed?O-or differencedwiththeREVIEW REPLACEMENTcom-POmandbecausetheydonotconsistofordinaryASCIItext.'TheLO /NOBINARY qualifier specifiesthatthesourcemoduleisanPO7ordinaryASCIItextfile.'These qualifiersareonly meaningfulOforsourcemodules.f <OOLargefilesthatundergo extensivechangesatfrequentinter-ROvals,oraretheoutputofalanguageor application,maynotTO5besuitedforstorageasstandarddeltafilesasthefiledeltaOOisneverused,occupiesa considerableamountofdiskspace,GOandgrowsrapidly.*Seethe/MARKER qualifier.*ExamplesPO>offiles well-suitedforstorageasmarkerfilesincludemostNO executableimages,objectfiles, Postscriptfiles,andBACKUPO savesets.UO/CONCURRENT(default)O( /NOCONCURRENTJO Specifieswhetherthemodulecanbereserved concurrentlyFObymorethanoneuser.)The /CONCURRENT qualifieral-LO2lowsthemoduletobereserved concurrentlyunlessauserMO overridesthisdefaultwithforaspecific reservation.,The@O /NOCONCURRENT qualifier specifiesthatthemodule-O<cannotbereserved concurrently.! ^O/DELETEO( /NODELETE OControlswhethertheddelete0 attributeissetforthenewfa-UOcility.(This attributeallowsthefacilitytobedeletedwiththeCO2DELETEFACILITYcommand.(The/DELETE qualifiersetsQOthedelete attributesothatthenewfacilitycanbedeleted.MOThe /NODELETE qualifierclearsthedelete attributesothatRO<thenewfacilitycannotbedeletedunlessyoufirstresetthisDO attributewithaMODIFYFACILITYcommand.'MarkingaNOfacilityas /NODELETEmakesitharderto accidentallydeleteOEthe facility.zPROIfthis qualifierisnot specified,VDEusesthevalueoftheKOallow-deletionlibrary attribute.*Thelibraryallow-deletionNO5default attributecanbesetorresetbyusingthe/ALLOW_BODELETE qualifierontheCREATELIBRARYoronthe#OMODIFYLIBRARYcommand.P &O/DERIVEDO(/SOURCE (default)LO SpecifieswhetherthenewmoduleisasourcemoduleoraKOderivedmodule.+By definition,asourcemoduleisamod-PO2ulethatcanbereservedfromandreplacedintothelibrary.NOThe generationsofeachsuchmoduleisstoredina``deltaMOfile''(aCMS element).+MostsourcemodulesaretextfilesPO<thatyoumodifywithaneditor,butVDEalsosupportsbinary&O (non-text)sourcemodules. MOAderivedmoduleisamodulethatisproducedfromsourceHOmodulesorotherderivedmodulesbyan automatedbuildQO5step.)Itcannotbereservedor replaced,andisoftenignoredGOduringcommandwildcard processing.)DerivedmodulesareJO automaticallyrecordedintheVDEdatabasewhentheyareLO> produced;theyareseldomenteredintoalibrarywiththe?OCREATEMODULEcommand.(However,newsourcemod-NOulesarenot automaticallyrecordedintheVDEdatabaseandHOHmustbeenteredintoalibrarywiththeCREATEMODULEHOcommand.,Forthisreason,the/SOURCE qualifieristheOdefault.q G"O/FROM_DIRECTORY=dir-specRO( Specifiesthatmodulesbecreatedforallfilesina specifiedOdisk directory.(Thedir-spec( parametergivestheOpenVMSPO directory specificationofthedisk directory.(Whenthisqual-$O2ifieris specified,the/2mod-name#2 parametersareomitted,BOandtheCREATEMODULEcommandcreatesanewmod-WOuleinthecurrentdefaultfacilityforeachfileinthe specifiedLO< directory.-Eachfilebecomestheinitial generationofthe%O correspondingmodule.*TheEdir-spec parametermayalsoPOconsistofa wildcardedfilespecification,inwhichcaseVDEQOEcreatesamoduleforeachfilethatmatchesthespecification.NO(ThisfeaturecanbeusedtocreatemodulesforonlythoseUOfilesina directorythathaveacertainfile extension,forex-OOOample.))This qualifierletsyouenteralargenumberofnewKOmodulesintotheVDElibrarywithasinglecommand,pro-UOvidedthattheinitialversionsofthosemodulesarestoredinaQOYsingledisk directoryandthatallmodulesbelongtothesameO facility. xPOTheinitial generationofeachmodulecreatedwiththisqual-POifierisinsertedinto(becomesthelatest generationof)theLO5streamyouspecifywiththe/STREAM qualifierorintothePOdefaultstreamifyouomitthe/STREAM qualifier.)Itisalsofier specifiesthedefaulthistorystringiftheuser specifiesSOthathistory informationshouldbeincludedina retrievedfile.HO(Ifyouspecifythe /NOHISTORY qualifierontheCREATEAOHMODULEcommand,youmustusethe/HISTORYquali-KOfierontheFETCHorRESERVEcommandtousethedefault9Ohistorystring.)&Ifyoudonotspecifyastring parameter,VDEOORsuppliesadefaulthistorystringthatdependsonthemoduleOtype.uIOSeetheCMS documentationfora descriptionoftheCMS,Ohistorystringanditsformat.! O/INPUT[=file-spec]CO(The/INPUT qualifiercausestheCREATEMODULEcom-QOmandtocreatetheinitial generationofthenewmodule.'ThisDO qualifierisonly applicabletosourcemodules.(Thea file-specPO2 parametergivestheOpenVMSfile specificationofafilethatROcontainstheinitial generationofthemodule.'Ifthe file-nameTOpartofthefile specificationisomitted,thefilenameisas-NO<sumedtobethesameasthemodulename.*Ifthe directoryUO specificationpartisomitted,thefileisassumedtobeinyourAOcurrentdefault directory.*Ifyouomitthewhole) file-specMOE parameter,VDEcreatestheinitial generationfromthefileKOinyourdefault directorywiththesamenameasthenewOmodule. HOTheinitial generationofeachmodulecreatedwiththeNO/INPUT qualifierisinsertedinto(becomesthelatestgener-NO5ationof)thestreamyouspecifywiththe/STREAM qualifierQOorintothedefaultstreamifyouomitthe/STREAM qualifier.JOItisalsoinsertedintoall successorsofthatstream.COIfneither/INPUTnor/FROM_DIRECTORYis specified,@OtheCREATEMODULEcommandrecordsthemoduleinIO5theVDEdatabaseandmarksitasreservedtoyou.-YouFOmustthenusetheREPLACEcommandtoactuallycreateNOtheinitial generationofthemodule.,Thisisthe preferredKO>wayofcreatingnewmodulesonceaVDElibraryhasbeenO established.xNHOThe/INPUT qualifierisrejectedonanystreamsmarkedKOforqueued replacement.*TocreateandinsertamoduleonIO5astreammarkedforqueued replacement,omitthe/INPUTTO qualifier,andspecifythefiletoloadintothenewmoduleviaOaREPLACEcommand.f<an explanationofhowto establishsubdirectoriesandassignLOthem directorysymbols.(Seethe descriptionofthecommandAOSHOWDIRECTORY/DELTAfor informationon displayingLOHthecurrentmarkerfile directory(or directories)setting.S )IOThe /NOMARKER qualifier specifiesthatthesourcemoduleUOdoesnotuseamarkerfileandthatitstextisstoreddirectlyKO5inthedeltafile(CMSelement)forthemodule.+Ordinary@OASCIItextmodulesshouldnotusemarkerfiles.[ 11OAlsoseethe /[NO]BINARY qualifier.! O/NOTES[="string"](O(/NONOTES[="string"] (default)QO SpecifiestheCMSnotesstringtobe associatedwiththemod-POuleandwhetherCMSnotesshouldbeincludedinsourcefilesFO2whenmodulesare retrievedwiththeFETCHorRESERVEFOcommand.*CMSnotesindicateinwhatmodule generation+Oeachsourcelinewascreated. kMOThe/NOTES qualifier specifiesthatnotes informationshouldNObeincludedinsourcefilesbydefaultwhensuchfilesareAO5 retrievedwiththeFETCHorRESERVEcommand.,TheJO/NONOTES qualifier specifiesthatnotes informationshouldObeomitted.'Thestring5 parametertoeither qualifier specifiesTO>thedefaultnotesstringiftheuser specifiesthatnotesinfor-ROmationshouldbeincludedina retrievedfile.)(IfyouspecifyAOthe/NONOTES qualifierontheCREATEMODULEcom-KOHmand,youmustusethe/NOTES qualifierontheFETCHorKORESERVEcommandtousethedefaultnotesstring.)(IfyouOdonotspecifyastring/ parameter,VDEsuppliesadefault>ORnotesstringthatdependsonthemoduletype.sIOSeetheCMS documentationfora descriptionoftheCMS*Onotesstringanditsformat. ,O/NOTIFY=(username[,username...])OO( Specifiesuserstonotifyofallchangestothenewmodule.OEach username3 parameter specifiestheOpenVMSuser-MOnameormailaddressofauserwhoshouldbenotifiedbyOO2mailmessageeachtimethe specifiedmoduleisreplacedintoOtheVDElibrary. OEach username7 parametercanspecifytheusernameofaFOuseralreadyrecordedintheVDE database,aOpenVMSDO5mailaddresswithoneormorenodenames(suchasHO NODE::SMITH),oramail forwardingalias,oradefinedSOlogicalnameboundtoalistofuserstonotify.*Ifyouspec-PO>ifyalogicalname,keepinmindthatthelogicalnamemustSObedefinedwhenitislaterusedtosend notification messages.SOItshouldthusbeagrouporsystemlogicalnameoralogicalQOHnamethatisinsomeotherwaydefinedforallusersoftheOVDElibrary. %OIfyouspecifyonlyoneusername$= parameter,youmayomit(Othe surrounding parentheses.rH!O/POSITION=column-numberHO( SpecifiesthedefaultcolumnnumberinwhichCMSnotesQOaretobeplacedwhenthissourcemoduleis retrievedwithaAOFETCHorRESERVEcommand.(ThecolumnnumbermustVO2beanintegerintherange1to511.)Ifthis qualifierisomit-OOted,thedefaultcolumnnumberis81.)This qualifierhasnoKOeffectunlessnotesareenabledwiththe/NOTES qualifierBO<ontheCREATEMODULEcommandorontheFETCHorORESERVEcommand.KOSeetheCMS documentationfora descriptionofCMSnotesLOandhownotesare formattedattheendsofsourcelines.L! "O /PROPAGATEO( /NOPROPAGATEIO Specifieswhether automaticchange propagationisallowedMOforthismodulewhenitisreservedandreplacedintotheCO2library.+ /PROPAGATEallows automaticchangepropaga-FOtionand /NOPROPAGATE disallowschange propagation.(IfLOchange propagationis disallowed,VDE automaticallyinhibitsLO<change propagationwhenthemoduleisreservedorreplacedNOasifthe /NOPROPAGATE qualifierhadbeen specifiedfortheEORESERVEorREPLACEcommand.)Ifyouomitbothquali-1OEfiers,thevalueofthe facility'sE nopopulateE attributeisused%Otosetthenewmodule's propogatee attribute.! O/REMARK="string"NO( Specifiesaremarkstringtobestoredforthenewmodule.OOThequotedremarkstring,whichcanbeupto132 charactersHOlong,maycontainany explanatoryremarkaboutthenewMO2modulethatyouwantstoredintheVDE database.( TypicallyMOtheremark describesthepurposeorcontentofthemodule. NPOAlthoughthis qualifieris required,youcanspecifyanemptyNOremarkstring.'Ifyoudonotspecifythe/REMARK qualifier,4O5VDEpromptsyouforaremarkstring.~ T.O/REVIEWER=(username[,username...])NO( Specifies reviewersforallchangestothenewmodule.)EachOusername: parameter specifiestheOpenVMSusernameofNOauserwhoshouldreviewallchangestothe specifiedmod-OO2ule.'TheusermustalreadyberecordedintheVDE database.MOWhenachangetothemoduleisreplacedintotheVDEli-OObrary,VDEnotifiestheuserofthechangebymailmessage.QO<Ifthe replacementisqueued,theusershouldthenreviewtheLOqueued replacementbeforeitis performed.*Ifthereplace-NOmentis immediate,VDEnotifiestheuserofthenewmoduleMOE generationthatwascreated,andtheusermaytheninspectOthat generation. %OIfyouspecifyonlyoneusername$= parameter,youmayomit(Othe surrounding parentheses._! U5!O/SESSION[=session-name]OO(Sessionsareusedto logicallygroupasetofmodulereser-POvations together, typicallytogroupallmodulesrelatedtoaNO particularsourcecode alterationor enhancement together.'ItQO2allowsall componentmodulesreservedtobetreatedasasin-LOgleentityfor subsequent replacement operations.*AsessionPOalsoallows additionalmodulestobereservedand incorporated:O<intoanexistingsessionatalatertime.}SLOIfthenewmoduleisbeingcreatedsuchthattheinitialHO generationwillbecreatedbya subsequent replacement,GO5/SESSION specifiesthatVDEshouldaddthenewmoduleDO reservationtothe reservationsessiongivenbythefsession-OnameN parameter.I/OIfnosessionwiththe specified session-namesessionnameMO currentlyexists,VDEwillcreateanew reservationsessionKO5underthe specifiedsessionnameandwill incorporatethe+Omodulereservation(s)intoit.! NOIfthe. session-name4x parameterisomitted,VDE generatesaPOuniquesessionname,createsanewsessionbythatname,and1O5addsthemodule reservationtoit.DOIfthe/SESSION qualifierisomittedontheCREATE@OMODULEcommand,VDEwillreservethemodule(asLO5 expected),andwillnotaddthenewmodule reservationtoOanysession. Z WqFOSessionscanbe manipulatedviatheREPLACE,RESERVE,combinedintothesamesession.!! O/STREAM=stream-nameQO( Specifiesthatthemodulebereservedforthestreamgivenby Othe stream-name7  parameterorthattheinitial generationQOofthemodulebeinsertedintothatstream.'Ifneither/INPUTCO2nor/FROM_DIRECTORYis specified,the/STREAMqual-KOifiercausesVDEtomarkthemoduleasreservedfortheBO specifiedstream.*Ifthe/INPUTor/FROM_DIRECTORYPO< qualifieris specified,/STREAMcausesthetheinitialgenera-ROtionofthenewmoduletobecomethelatest generationoftheQOmoduleforthe specifiedstreamandallits successorstreams."NOIfthe/STREAM qualifierisomitted,themoduleisreservedBOfororinsertedintoyourcurrentdefaultstream.L#F "OExamples O1. VDE>YCREATE%MODULE% STGCVT.FOR% /STREAM=FOO%/REMARK="String% conversion% routines"U %VDE-I-RESERVED,& generation%[CODE]STGCVT.FOR%reserved%from&stream%FOOdC %VDE-I-MUSTREPL,&you%must&replace%the&new%module%to%create&its%first% generationN %VDE-I-MODADDED,&module%[CODE]STGCVT.FOR&added&to&the%databaseM %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE>@ThisexamplecreatesanewsourcemodulecalledA STGCVT.FOR.ThemoduleiscreatedinthecurrentK;default facility,facilityCODE,andisreservedfromtheB specifiedstreamFOO.A subsequentREPLACEcommandO(notshown)isneededtocreatethefirst generationoftheDmodule. O2. VDE>_CREATE% MODULE/NOLOG% STGCVT.FOR% /STREAM=FOO%/REMARK="String% conversion% routines"+ VDE>JHerethesamemoduleiscreatedasinthepreviousex-Cample,butthe/NOLOG qualifier suppressesthelogK messages. O3. VDE>FCREATE%MODULE% STGCVT.FOR%/NOLOG%/INPUT=[MYDIR]FOO.FOR&-2 VDE>042/REMARK="String% conversion% routines"z VDE>GInthisexample,the/INPUT qualifiercausesthecom-KA mandtocreatetheinitial generationofthemodulefromF file[MYDIR]FOO.FOR.Inthiscase,themoduleisnot markedas reserved. Oj 4. VDE>J CREATE%MODULE%[CODE]STGCVT.FOR%/REMARK="String% routines",%- _VDE>8 [ACCTNG]SALES.COB%/REMARK="Sales% accounting"V! %VDE-I-RESERVED,& generation%[CODE]STGCVT.FOR%reserved%from&stream%MAINdh %VDE-I-MUSTREPL,&you%must&replace%the&new%module%to%create&its%first% generationN %VDE-I-MODADDED,&module%[CODE]STGCVT.FOR&added&to&the%databaseW %VDE-I-RESERVED,& generation%[ACCTNG]SALES.COB%reserved%from%stream%MAINd@ %VDE-I-MUSTREPL,&you%must&replace%the&new%module%to%create&its%first% generationO %VDE-I-MODADDED,&module%[ACCTNG]SALES.COB%added%to%the%databaseM %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE>J Thisexamplecreatestwonewsourcemodules,oneinfa-E cilityCODEandoneinfacilityACCTNG.EachmoduleI8hasitsownremarkstring.(Themodulesarereservedin6theuser'sdefaultstream,streamMAIN. O 5.* VDE>*SET%STREAM%MAINr VDE>rSET%FACILITY%CODE VDE>ACREATE%/MODULE/FROM_DIRECTORY=[MYDIR.SOURCES]/REMARK=""W %VDE-I-GENINSERT,% generation&[CODE]A.REQ;1(1)%inserted%into%stream%MAINIJ %VDE-I-MODADDED,&module% [CODE]A.REQ%added%to%the%databaseW %VDE-I-GENINSERT,% generation&[CODE]B.REQ;1(1)%inserted%into%stream%MAINI %VDE-I-MODADDED,&module% [CODE]B.REQ%added%to%the%databaseW" %VDE-I-GENINSERT,% generation&[CODE]C.B32;1(1)%inserted%into%stream%MAINIj %VDE-I-MODADDED,&module% [CODE]C.B32%added%to%the%databaseW %VDE-I-GENINSERT,% generation&[CODE]D.B32;1(1)%inserted%into%stream%MAINI %VDE-I-MODADDED,&module% [CODE]D.B32%added%to%the%databaseWA %VDE-I-GENINSERT,% generation&[CODE]E.B32;1(1)%inserted%into%stream%MAINI %VDE-I-MODADDED,&module% [CODE]E.B32%added%to%the%databaseM %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE>BThisexampleusesthe/FROM_DIRECTORY qualifiertoNcreatemodulesforallfilesinagiven directory.(TheSET<9STREAMcommandmakesstreamMAINthedefaultCstreamandtheSETFACILITYcommandmakesfacilityBCODEthedefault facility.'TheCREATEMODULEcom-FCmandreadsallfiles E Ein directory[MYDIR.SOURCES]andMcreatesamoduleinfacilityCODEforeachsuchfile.'VDEKcreatestheinitial generationofeachmoduleandinsertsFLthat generationintothedefaultstream(streamMAIN)Jandall successorstreams.'(No successorstreamsarede-Lfinedinthis example.)'ThelogmessagesconfirmthattheJVinitial generationshavebeeninsertedintothe appropri-Katestreamsandthatthemoduleshavebeenaddedtothe database.`1*02B/OCREATESCRIPT*01a:OCreatesaVDEscriptintheVDE database.'OkRequiresCRESCRP privilege.]23OFormat#OsCREATESCRIPTM file-spec3 O ParameterOs file-specPO SpecifiestheOpenVMSfile specificationforafilethatcon-PO$tainsthetextofthenewscript.+Ifyouomitthe directory"O| specificationfromthes| file-spec#| parameter,yourcurrentOOdefault directoryisassumed.*Ifyouomitthefile extensionO-fromthe- file-spec4#- parameter,file extension VDESCRIPTisOassumed.4! O DescriptionFOsTheCREATESCRIPTcommandreadsaVDEscriptfromaROfileandrecordsthescriptanditstypeintheVDE database. O$A$scriptC$isasequenceofcommandsintheVDEscriptlan-LO|guagethatVDEcanexecutetocreateaDCLcommandfile.MOVDEcantheninvokethatDCLcommandfileina subprocessRO-toperformtheactionofthescript.(VDEusesscriptstoper-NOformmany differentkindsofactions.&Forexample,VDEusesTO ``compile scripts''tocompilemodulesinabuildjob.' Similarly,OO7ituses ``new-stream scripts''topopulatethe directoriesofFOanewstreamwithfileswhenitperformstheCREATEHOSTREAMcommand.(Therearemanyotherkindsofscripts,HOAall distinguishedbythecommandsor circumstancesthat'Ocausethemtobeinvoked._5 5MOTheprimarypurposeofVDEscriptsistoinsertnamesandNO directoryspecificationsfromtheVDEdatabaseintotextyouJO5specifytogenerateDCLcommandfilesthatperformvari-SOousactions.(AVDEscriptisthusamixtureofplaintextandNO invocationsof functionsthatretrievenames(suchasmoduleNO>names,typenames,andfacilitynames)and directorystringsNO(suchasthenamesoffacilitysubdirectories)fromtheVDEO database.=6! KOSinceyoudefinescripts,youdefinehowVDEshouldper-MOformthe correspondingactions.'Forexample,youdecidehowLO5aPascalmoduleiscompiledbecauseyoudefinethePascalROcompilescript.( Similarly,youcandefineascriptthatdefinesLO auxiliaryactionsoftheREPLACEcommand.'ScriptsthusletLO>youmakepolicy decisionsforyourownproject,whileVDEEOprovidesthe mechanismsthat implementyour policies.7 axGOTheCREATESCRIPTcommandonlydefinesthenewscriptLOforthecurrentdefault developmentstream.)Youcanrefer-PO5encethenewscriptonlyfromwithinthestreamtowhichitMObelongs.)WhenyouwanttocreatethesamescriptformoreGOthanonestream,youmustusetheCREATESCRIPTcom-NO>mandforeachstream.(Foreachstream,firstentertheSETHOSTREAMcommandtosetthe developmentstream,thenen-EOtertheCREATESCRIPTcommandtocreatethedesired&OHscriptwithinthestream.D8 OOWhenanew developmentstreamiscreated,allscriptdefini-POtionsfromtheparentstreamarecopiedtothechildstream.RO5If modified,thescript definitionsthenevolve independentlyin)Othetwo developmentstreams.9 >OKeywordsusedwithinscriptsare documentedinQScriptO Keywords,+whilescript functionsareinScript Functions, Vand O5scripttypesarein5ScriptTypes.$5Forotherscript-relatedO commands,alsosee%DELETESCRIPT,EXTRACTSCRIPT,OINVOKESCRIPT,MODIFYSCRIPT, andfSHOWSCRIPT.n9DQQH!H!OO*9LO*9O:*9%P?l*9P?*9O?0*9?\*9fA? :! PO QualifiersOs/BUILDLO SpecifiesthatthescriptbeinvokedwhenVDEstartseachKO$processthatexecutesabuildjob.+The VDE$BUILDutility,NO|whichexecutesbuildjobs,invokesthescriptonceforeachTOprocessthatexecutesagivenbuildjob.&ThisscriptrunsbeforePO-theprocessexecutesanybuildsteps.)ThescriptcanbeusedHOtogenerateDCLthatdefinescommandsorlogicalnamesOOthatareneededby subsequentbuildsteps.'BUILDscriptsareFO7optionalandarenotneededforbuildjobstowork. ;O/COMPILE=mod-nameKO( SpecifiesthatthescriptbeinvokedwhenVDEcompilesa$Omodulethatmatchesthemod-name parameter.)VDEin-HOvokesthescriptwhenyouenteraCOMPILEcommandforNO2amatchingmoduleorrunabuildjobthatcontainscompileJOstepsformatchingmodules.*ThescriptmustgeneratetheEODCLcommandsthatactuallyperformthecompilestep.<! O/COPY=mod-nameOO( SpecifiesthatthescriptbeinvokedwhenVDEcopiesamod-!OulethatmatchesthePmod-name"0 parameter.)VDEinvokesKOthescriptwhenyouenteraCOPYcommandforamatchingRO2moduleorrunabuildjobthatcontainscopystepsformatch-HOingmodules.)ThescriptmustgeneratetheDCLcommands3Othatactuallyperformthecopystep.=O/CREATE_FACILITYIO( SpecifiesthescriptthatVDEshouldinvokewhenanew=Ofacilityiscreated.'Thisscriptis optional.>%O/DELETE_GENERATION=mod-nameJO( SpecifiesthatthescriptbeinvokedwhenVDEdeletesaIOstream'slatest generationofamodulethatmatchestheOmod-name:0 parameter.*VDEinvokesthescriptwhenyou?O2enteraDELETE GENERATIONcommandforamatch-KOingmodule.)Thescriptshouldperform auxiliary processingAOthatyouwantfortheDELETE GENERATIONcommand,PO<suchasupdatingsourcefilesina clear-copy directory.(ThisPOtypeofscriptisoptionalandisnotneededfortheDELETE(O GENERATIONcommandtowork.?! [O/FETCH=mod-namePO( SpecifiesthatthescriptbeinvokedwhenVDEfetchesamod-!OulethatmatchesthePmod-name"0 parameter.)VDEinvokesJOthescriptwhenyouenteraFETCHcommandforamatch-JO2ingmodule.'ThescriptshouldgenerateDCLcommandsthatJOperform auxiliary processingthatyouwantfortheFETCHMOcommand,suchassending notificationto interestedindivid-OO<uals.(FETCHscriptsareoptionalandarenotneededforthe#OFETCHcommandtowork.@! %O/INSERT_GENERATION=mod-namePO( SpecifiesthatthescriptbeinvokedwhenVDEinsertsagen-4Oerationofamodulethatmatchesthemod-nameu parameterMOintoa developmentstream.'VDEinvokesthescriptwhenyou@O2enteranINSERT GENERATIONcommandforamatch-KOingmodule.)Thescriptshouldperform auxiliary processingAOthatyouwantfortheINSERT GENERATIONcommand,PO<suchasupdatingsourcefilesina clear-copy directory.(ThisPOtypeofscriptisoptionalandisnotneededfortheINSERT(O GENERATIONcommandtowork.A O/LINK=mod-nameNO( SpecifiesthatthescriptbeinvokedwhenVDElinksamod-!OulethatmatchesthePmod-name"0 parameter.)VDEinvokesKOthescriptwhenyouenteraLINKcommandforamatchingRO2moduleorrunabuildjobthatcontainslinkstepsformatch-HOingmodules.)ThescriptmustgeneratetheDCLcommands3Othatactuallyperformthelinkstep.BO/LOG (default)O(/NOLOGLOControlswhetherlogmessagesareprintedafterthescriptLOiscreated.+The/LOG qualifiercausessuchmessagestobeHO2printedandthe/NOLOG qualifier suppressesthem.*TheseNOmessagesindicatethatthescripthasbeencreatedandthatCOthedatabase transactionhas committed successfully.C! O/NEW_STREAM=fac-nameNO( SpecifiesthatthescriptbeinvokedforeachfacilitythatOmatchesthe#fac-name* parameterwhenVDEcreatesaIOnew developmentstream.*VDEinvokesthescriptforeachGO2matchingfacilitywhenyouenteraCREATESTREAMcom-GOmand.)ThescriptmustgenerateDCLcommandsthatcopyQOallstream-specificfilesforagivenfacilityfromtheparentPO<stream's directoriestothenewstream's directories.(TheroleGOof NEW_STREAMscriptsistopopulatethenewstream'sQO directorytreewithallrelevantfilesfromtheparentstream.D! WCO NEW_STREAMscriptsareoptionalandarenotneededFOfortheCREATESTREAMcommandtowork,buttheyareKO5strongly recommendedbecauseminimalsystembuildsfortheROnewstreamcannotworkunlessallresultfiles(suchasobjectMO librariesand executableimages)arecopiedfromtheparent.O>streamtothenewchildstream.PE! &O/NOKEEP=mod-nameKO( SpecifiesthatthescriptbeinvokedwhenVDEreplacesa$Omodulethatmatchesthemod-name parameter.)VDEin-COvokesthescriptwhenyouenteraREPLACEcommandGO2withthe/NOKEEP qualifierforamatchingmodule.+TheJOscriptshouldgenerateDCLcommandsthatperformtheac-OOtionofthe/NOKEEP qualifier,suchasdeletingthereplacedQO<sourcemoduleandperhapsalsothe associatedobjectandlist-ROingfilesfromtheuser'sdefault directory.*ThescriptisrunDOaftertheREPLACE command'sdatabase transactionhasLOE committed;itthusperforms ``clean-up'' operationsfortheIOcommand.(NOKEEPscriptsareoptionalandarenotneededGOfortheREPLACEcommandtowork.((IfaNOKEEPscriptMOOisnotdefinedwhenamoduleisreplacedwiththe/NOKEEP:O qualifier,VDEdoesnotdeleteanyfiles.)wFKMO/REMARK="string"SO( SpecifiesaremarkstringtobestoredinthedatabasefortheLOnewscript.+Thequotedremarkstring,whichcanbeuptoHO132 characterslong,maycontainany explanatoryremarkLO2aboutthescriptthatyouwanttostoreinthe database.G! ^O/REPLACE=mod-nameKO( SpecifiesthatthescriptbeinvokedwhenVDEreplacesa$Omodulethatmatchesthemod-name parameter.)VDEin-HOvokesthescriptwhenyouenteraREPLACEcommandforHO2amatchingmodule.)ThescriptshouldgenerateDCLcom-FOmandsthatperform auxiliary processingthatyouwantDOfortheREPLACEor(onaqueued-replacementstream);O<PERFORM REPLACEMENTcommand,suchassendingQO notificationto interested individualsorcopyingobjectmodulesPOtoobject libraries.'REPLACEscriptsareoptionalandarenot7OEneededfortheREPLACEcommandtowork.HfO/RESERVE=mod-nameKO( SpecifiesthatthescriptbeinvokedwhenVDEreservesa$Omodulethatmatchesthemod-name parameter.)VDEin-HOvokesthescriptwhenyouenteraRESERVEcommandforHO2amatchingmodule.)ThescriptshouldgenerateDCLcom-KOmandsthatperform auxiliary processingthatyouwantforJOtheRESERVEcommand,suchassending notificationtoin-KO<terested individuals.)RESERVEscriptsareoptionalandareO<fromscriptsorderedbytheirsegmentnumbers.J  O/SET_FACILITY=fac-nameQO( SpecifiesthatthescriptbeinvokedwhenVDEsetsanewde--Ofaultfacilitythatmatchesthefac-name> parameter.*VDEKOinvokesthescriptwhenyouenteraSETFACILITYorSETDO2CONTEXTcommandforamatching facility.,ThescriptCOshouldgenerateDCLcommandsthatperform auxiliaryGO processingthatyouwantfortheSETFACILITYorSETFO<CONTEXTcommand,suchasdefininglogicalnames.(SET_KOFACILITYscriptsareoptionalandarenotneededforthe=OSETFACILITYorSETCONTEXTcommandtowork._K55O This qualifierisnotyet implemented.iL ?O /SET_STREAMQO( SpecifiesthatthescriptbeinvokedwhenVDEsetsanewde-MOfaultstream.(VDEinvokesthescriptwhenyouenteraSETAOSTREAMorSETCONTEXTcommand.)ThescriptshouldEO2generateDCLcommandsthatperform auxiliaryprocess-GOingthatyouwantfortheSETSTREAMorSETCONTEXTCOcommand,suchasdefininglogicalnames.* SET_STREAMNO<scriptsareoptionalandarenotneededfortheSETSTREAM.OorSETCONTEXTcommandtowork._M55O This qualifierisnotyet implemented.N ^O/STAGING=mod-nameQO( SpecifiesthatthescriptbeinvokedwhenVDEcopiesasource$Omodulethatmatchesthemod-name parameterintoaLO ``staging''area.+VDEinvokesthescriptwhenyouenteraCO2REPLACEcommandforamatchingmoduleandthere-KO placementisqueued.(Foraqueued replacement,VDEcopiesTOeachreplacedfiletoastagingarea,fromwhereitisactuallyLO<replacedintotheVDElibrarywhenanotheruserlateren->OtersaPERFORM REPLACEMENTcommand.)ThescriptKOmustgenerateDCLcommandsthatcopythemoduleintotheOEstagingarea.O mO/UNRESERVE=mod-nameMO( SpecifiesthatthescriptbeinvokedwhenVDE unreservesa$Omodulethatmatchesthemod-name parameter.)VDEin-FOvokesthescriptwhenyouenteran UNRESERVEcommandGO2foramatchingmodule.,ThescriptshouldgenerateDCLIOcommandsthatperform auxiliary processingthatyouwantHOforthe UNRESERVEcommand,suchassending notificationIO<to interested individuals.* UNRESERVEscriptsareoptionalHOandarenotneededforthe UNRESERVEcommandtowork.P 'OExamples O1.  $)TYPE%[MYDIR]SCRIPT_C.VDESCRIPT/ !&Script%to%compile&a%C%module. " ! j EMIT&"$&SET%VERIFY"5 EMIT&"$& DEFINE/NOLOG%SRC$&",& $DIR(SRC)5 EMIT&"$& DEFINE/NOLOG%OBJ$&",& $DIR(OBJ)@B EMIT&"$&CC/DEBUG/OBJ=OBJ$:/ANA=OBJ$:%SRC$:",$MODTYP5 EMIT&"$& VDE/DEPEND%C%OBJ$:",$MOD,".ANA" EXIT  $ VDEb VDE>DbCREATE%SCRIPT/COMPILE=[RMS]*.C%[MYDIR]SCRIPT_C.VDESCRIPT\ %VDE-I-SCRPADDED,%script%from%file& DEV$:[MYDIR]SCRIPT_C.VDESCRIPT;9&added&to the&database>9 script&to&compile%module&[RMS]*.C&(segment&10)M %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE>H8Inthisexample, theuserfirsttypesthescriptfile<[MYDIR]SCRIPT_C.VDESCRIPTonthe terminal.)TheBscriptcontainsfiveEMITcommandsfollowedbyanFBEXITcommand.(TheuserthenentersVDEandusestheFCREATESCRIPTcommandtoenterthatscriptfileintoLtheVDEdatabaseasthecompilescriptforallCmodulesLKinfacilityRMS.Thelogmessagesconfirmthatthescript:was successfullyenteredintothe database. O 2. ! $.! TYPE%[MYDIR]SCRIPT_LINK_X.VDESCRIPT\i !&VDE%script%to%generate%the&DCL%commands%needed%to%link%module%X.EXE. ! EMIT&"$&SET%VERIFY"6A EMIT&"$&DEFINE%OBJLIB%",%$DIR(OBJ,CODE)> EMIT&"$&&LINK/EXE=OBJLIB:X.EXE/MAP=OBJLIB:X.MAPK-" EMIT&"@ 6OBJLIB:OBJLIB.OLB/INCLUDE=C,OBJLIB:OBJLIB.OLB/LIBRARY"% EMIT&"$&DEASSIGN&OBJLIB" a $ a VDE VDE>4 CREATE%SCRIPT/LINK=X.EXE%[MYDIR]SCRIPT_CV %VDE-I-SCRPADDED,%script%from%file&%DEV$:[MYDIR]SCRIPT_LINK_X.VDESCRIPT;2"9 added%to%the&database> script&to&link%module& [CODE]X.EXE&(segment&10)M %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE>& SHOW%SCRIPT/TEXT/LINK=X.EXE>Y Script%to%link%module% [CODE]X.EXE%(segment%10)D Text&of&script:[ 1:&!%script&to&generate&the%DCL%commands%needed&to&link%module&X.EXE.1 2:&!$y 3:&EMIT%"$%SET&VERIFY": 4:&EMIT%"$%DEFINE&OBJLIB%",%$DIR(OBJ,CODE)B 5:&EMIT%"$%&LINK/EXE=OBJLIB:X.EXE/MAP=OBJLIB:X.MAPK-"P 6:&EMIT%"@ P 6OBJLIB:OBJLIB.OLB/INCLUDE=C,OBJLIB:OBJLIB.OLB/LIBRARY") 7:&EMIT%"$%DEASSIGN%OBJLIB"( VDE>BThisexampledisplaysthescriptfile SCRIPT_LINK_I X.VDESCRIPTtoshowthetextofthescript.(ThescriptGHconsistsoftwocommentlinesandfiveEMIT commands.ETheEXITcommandisomittedinthiscase.+TheuserAthenentersVDEandusestheCREATESCRIPTcom-FRmandtoenterthescriptintotheVDE database.-TheG/LINK qualifier specifiesthatthescriptlinksmoduleJX.EXEinthecurrentdefault facility,facilityCODE.ByJ[default,thescript'ssegmentnumberis10.+Finally,theCSHOWSCRIPTcommandshowsthatthescriptcannow7 be displayeddirectlyfromthe database. O3. VDE>@CREATE%SCRIPT/NEW_STREAM=*&SCRIPT_NEW_STRM.VDESCRIPTX %VDE-I-SCRPADDED,%script%from%file&'DEV$:[MYDIR]SCRIPT_NEW_STRM.VDESCRIPT;3" added%to%the&databaseJb script&to&create%new%stream&for%facility%*&(segment&10)M %VDE-I-COMMIT,%database% transaction%has% successfully& committed. VDE>&SHOW%SCRIPT/TEXT/NEW_STREAM=*J: Script%to%create&new%stream%for&facility&*%(segment%10)D Text&of&script:N 1:&!%VDE&script%to%populate%the% directories%for&a%facility3 2:&!%when%a&new%stream%is%created.Y 3:&!L 4:&EMIT%"$% DEFINE/NOLOG&OLDOBJ%",%$DIR(OBJ,%CURRENT,%PARENT)M 5:&EMIT%"$% DEFINE/NOLOG&NEWOBJ%",%$DIR(OBJ,%CURRENT,%CURRENT)41 6:&EMIT%"$%COPY% OLDOBJ:*.OLB%NEWOBJ:"Cy 7:&EMIT%"$%COPY%!",$DIR(SRC,%CURRENT,%PARENT),"*.H%-" 8:&EMIT%"' ",$DIR(SRC,%CURRENT,%CURRENT)  9:&EXIT VDE>CThisexamplecreatesa NEW_STREAMscriptthatwillG`beexecutedforall facilitieswhenanew developmentBstreamiscreated.(TheCREATESCRIPTcommandcre-Eatesthescript,andtheSHOWSCRIPTcommandfetchsMjanddisplaysthecontentsofthescriptfromthe database.KThescript generatesDCLcommandstocopyallobjectli-Jbrariesfromtheparentstream'sobject directorytotheJtcurrentstream'sobject directory.'(The ``current''streamMisthenewstreambeingcreatedinthiscase.))ThescriptK%alsocopiesall.Hfilesfromtheparentstream'ssourceG} directoryforthefacilitytothenewstream'ssource( directoryforthe facility. ON4.S VDE>HSCREATE%SCRIPT/INSERT_GENERATION=[*]*.*&[MYDIR]SCRIPT_INS_GEN^ %VDE-I-SCRPADDED,%script%from%file&&DEV$:[MYDIR]SCRIPT_INS_GEN.VDESCRIPT;4&added to%the&databaseL+ script&to&insert% generation&for%module%[*]*.*&(segment&10)Ms %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE> VDE>4 SHOW%$SCRIPT/TEXT/INSERT_GENERATION=[*]*.*LK Script%to%insert& generation%for&module%[*]*.*%(segment%10)D Text&of&script:V 1:&!%Script&for%the%INSERT& GENERATION%command.KThis%script&fetchesZ#! 2:&!%out&a%clear%copy%of%the% generation%just&inserted&into%a%streamSk! 3:&!%in%order%to%keep%the%stream's%source& directory% up-to-date.! 4:&!<! 5:&FETCH& $FACMODTYP,&"/LOG/OUTPUT=",% $DIR(SRC)4C" 6:&EMIT%"$%PURGE%",%$DIR(SRC),$MODTYP" VDE>IA#Thisexampledefinesascripttobeexecutedeachtime>#theINSERT GENERATIONcommandis performedforA#anymodule.(TheSHOWSCRIPTcommanddisplaystheJK$textofthescript.'ThescriptcontainsaFETCHcommandH$thatfetchesthejustinserted generationintotheSRCM$ subdirectoryfortheaffectedstreamand facility.'Thisop-IU%eration maintainsan up-to-datecopyofthesourcefileL%inthat directory.(Becausethe/LOG qualifieris generatedC&fortheFETCHcommand,VDEwillprintaninforma-L^&tionallogmessageasthemoduleisfetchedduringscriptD& execution.)ThescriptalsocontainsanEMITcommandC'that generatesaPURGEcommandtobe performedon(h'thefilejustfetchedout.Zt4735BuOCREATESTREAM*vwqJOCreatesa developmentstreaminthecurrentVDElibrary.'OkRequiresCRESTRM privilege.txJOFormat:OsCREATESTREAMM stream-name[,stream-name...]y uO ParameterOs stream-nameQOThenameofastreamtobecreated.(ThisnamecanbeuptoMO$39 characterslong.'ItmustfollowVDEnamesyntax.'UnlikePO|otherVDEnames,thestreamnamecancontainperiods( . ).-OTheuseofthefacilityprefixZ VDE$$?is expressly prohibited.zgO DescriptionMOsA developmentstream(orsimply,a ``stream'')isanysep-LOaratelyevolvingversionofyoursoftwaresystem.)AstreamOO$may correspondtoapreviousorfutureversionofyoursys-OO|temortoa base-levelofthesystem.*Itmay correspondtoNOanyinstanceofthesystemthatevolves separatelyfromtheJO-restofthesystem.,EachstreamofyoursoftwaresystemPOcapturesa differentstateofthesystem,andthatstatemay3Oevolve independentlyforeachstream.{ WLOEachstreamofyoursoftwaresystemcontainsitsownver-QOsionsofallmodulesinthesystem,andyoumaychangetheseGO5modules independentlyineachstream.,EachstreamalsoPOcontainsitsownversionsofvariousdatabasetables,suchasIOgroup definitionsandmodule dependency information.)ThisKO> informationmayalsoevolve independentlyforeachstream.(|BOWhenyoucreateastream,theCREATESTREAMcom-NOmandfirstcreatesanentryforthenewstreamintheVDEHO5 database..Itthencopiesallstream-specific informationMOfromtheparentstream(bydefault,thedefaultstream)toIOthenewstream(thechildstream).,This informationin-MO>cludesdirectory-creationrules,group definitions,thebuildCO dependencygraph,and informationaboutwhatmoduleKO generationsbelongtotheparentstream.,In addition,the@OHCREATESTREAMcommandexecutesscriptswhichmayNOcopyfilesfromtheparentstream'sdisk directoriestothe'Ochildstream's directories.#}%LOThereareseveralkey attributestoVDEmodule propogationBO controlledbytheCREATESTREAMcommand, includingPO5thesequenceofstreamsonthevariouslinesofdescent,andMOthepresenceofthe particularstreamonthemainlineofNO developmentoronavariantlineofdescent.*TheformerisMO> controlledbythe parentageand successor settings,andthe=Olatteris controlledbythemainlinesetting. _UNote _6TheCREATESTREAMcommandcananddoesCperformspecificand potentiallynon-reversablemod-DR ificationstotheinternalVDEdata associatedwith other<streamspresentintheVDE database,partic-=ularlyaroundthe/MAINand/NOMAIN settings,?[andaroundthe/PARENTand /SUCCESSOR settings.8TheCREATESTREAMcommandshouldbeused withcaution.~HWTheexplicit specificationofthe appropriatevaluefor=the /[NO]MAIN qualifier(/MAINor/NOMAIN)on:aCREATESTREAMcommandisstronglyrecom-amended.  O QualifiersOs /CMS_CLASSO/NOCMS_CLASS(default)KO$ SpecifieswhetheraCMSclasswiththesamenameastheMO|streamshouldbe maintainedineach facility'sCMSlibrary.EOThe /CMS_CLASS qualifiercausesVDEtocreateaCMSNO-classforthestreamineach facility'sCMSlibraryandtoGOthenmaintainthatclasswhentheREPLACEcommandandEOcertainothercommandschangewhatmodule generationsHO7belongtothestream.(The /NOCMS_CLASS qualifiercausesBOVDEtonotmaintainaCMSclassforthestream.NFOThe /CMS_CLASS qualifier interactswiththe /INIT_CMS_COCLASSand/NOINIT_CMS_CLASS qualifiers;seethede-:O5 scriptionsofthese qualifiersfordetails.6  O/CONFERENCE=file-spec O(/NOCONFERENCE(default)JO SpecifieswhetheraOpenVMSNotes conferenceforreplace-LOment informationshouldbe associatedwiththenewstream.HO2The /CONFERENCE qualifier specifiesthatthenotescon-6Oferencefile specificationgivenbythe file-spec parameterMOshouldbeusedtorecordall replacementsintothestream.KO<VDEthenentersanewnoteintothe conferenceforeachKOqueuedor immediate replacementandareplytothatnoteEOwhenaqueued replacementisactually performed.-TheDOE /NOCONFERENCE qualifier specifiesthatnosuchnotes'O conferenceshouldbeused.FOUndernormalcircumstances,justthefilenameshould Obe specifiedinthe file-spec'k parameter.+VDEappliesde-QO5faultstothenotes conferencefile specificationbasedontheEO translationofthelogicalnameVDE$NOTES_LIBRARY.IfPOthislogicalnameisnotdefined,thedefaultfile specifica-=O>tion``NOTES$LIBRARY:.NOTE''isappliedtothe^> file-specO parameter., O/DEFERO(/NODEFER (default)PO Specifieswhetherthecreationofthedisk directory structureJOforthestreamshouldbe postponed.+The/DEFER qualifierLO2 postponescreationofthedisk directory structureandtheJO/NODEFER qualifiercausesthedisk directory structuretoFObecreated immediately.,Usethe/DEFER qualifierwhenNO<thedefault directory structureis inappropriateforthenewOstream.8! MOIfthe/NODEFER qualifieris specified(or/DEFERisomit-AOted),theCREATESTREAMcommandcreatesthediskOO5 directory structureforthestream.'This structureincludesaQOstreamroot directory,aroot directoryforeach facility,andTOfacilitysubdirectoriesthatholdthefilesthatarethecontentsQO>ofthefacilityinthenewstream.)The directory structureisEO determinedbytheSET DIRECTORYcommandsenteredforNOthenewstream(or inheritedfromtheparentstream)orbyKOHVDEdefaultrules.)OnceVDEhascreatedthenewstream'sRO directory structureforagiven facility,VDErunsthestream'sQO new-streamscriptforthat facility,providedsuchascriptisQORdefined.' Dependingonhowitisdefined,thisscriptmaypop-ROulatethe directoriesforthatfacilitywithsourcemodulesandOotherfiles. axIOIfthe/DEFER qualifieris specified,theCREATESTREAMLOcommanddoesnotcreatea directory structureforthenewIO5stream.-Ifyouusethe/DEFER qualifier,youcanenterCOSET DIRECTORYcommandstospecifythe structureofEOthedisk directories.)ThenusetheCREATE DIRECTORY_IO>TREEcommandtocreatethe directory structureondisk.>OTheCREATEDIRECTORY_TREEcommandusesVDEde-LOfaultsandtherulesyou specifiedwiththeSET DIRECTORY?OHcommandstocreatethenew directory structure. O/DELETEO( /NODELETE OControlswhetherthejdelete+ attributeissetforthenewNOstream.*This attributeallowsthestreamtobedeletedwith=O2theDELETESTREAMcommand.,The/DELETEquali-QOfiersetsthedelete attributesothatthenewstreamcanbeMOdeleted.(The /NODELETE qualifierclearsthedelete attributeRO<sothatthenewstreamcannotbedeletedunlessyoufirstre-GOsetthis attributewithaMODIFYSTREAMcommand.(ThisQOmakesitharderto accidentallydeleteastream.'Ifyouspec-ROEifyneither qualifier,VDEusesthevalueoftheallow-deletionPOlibrary attributeastheinitialvalueofthestream'sdeleteKO attribute.,Thislibrary attributeissetwiththe/ALLOW_BOODELETE qualifiertotheCREATEandMODIFYLIBRARYO commands. ^O/DIRECTORY=dir-specOO( Specifiesthenameoftheroot directoryofthestream.*TheNOroot directorynormallycontainsa subdirectoryforeachfa-POcility.(Each subdirectoryhas additionalsubdirectoriesfortheRO2sourcesandderivedfilesofthefacilityandstream.'(Tomod-KOifythedefault directory structure,firstusetheCREATEBOSTREAMcommandwiththe/DEFER qualifierthenuse:O<theSET DIRECTORYandCREATEDIRECTORY_TREEKOcommandstocreatethe directory structureyouwant.)(UseJOtheOpenVMS directory specificationformattospecifytheOEdir-specE parameter.R (O/INIT_CMS_CLASSO(/NOINIT_CMS_CLASSIO SpecifieswhetherVDE initializestheCMSclassfortheFOstreamineach facility'sCMSlibrarywhenthe/CMS_NO2CLASS qualifier specifiesthatsuchaclassshouldbemain-?Otained.)/INIT_CMS_CLASScausestheCREATESTREAMtributeunlessyouchangeitwithanexplicit /NOINIT_CMS_OCLASS qualifier.! WHOUnlessyouhaveexistingcommand proceduresorprogramsMOthatdependonthepresenceofCMSclasses,Digitalrecom-NO5mendsthatyounotmaintainCMSclassesforthestreamsinOOyourVDElibrary.' MaintainingCMSclassesisquiteslow,es-LOpeciallywhencreatingnewstreams,andVDEdoesnotneed5O>CMSclassesforanyofits functions.! UO/LOG (default)O(/NOLOGMOControlswhetherlogmessagesareprintedafternewstreamsLOarecreated.*The/LOG qualifiercausesthemessagestobeFO2printedandthe/NOLOG qualifier suppressesthem.,TheJOmessagesindicatethateachnewstreamhasbeencreated,OOthatitsdisk directory structurehasbeencreated,andthatCO<thedatabase transactionhas successfully committed.! O/MAINO(/NOMAIN (default)OO Specifieswhetherthenewstreamispartofthemaindevel-JOopmentthreadforyourproject.+The/MAIN qualifiersaysNO2thatthenewstreamispartofthemain developmentthreadYOfortheprojectandisexpectedtobeinusefora relativelylongTOtime,andisexpectedtobeinuseaftertheparentstreamhasKO<beenclosed.*VDEassignstheshortestpossibleCMS``gen-LOeration expressions''tonew generationsinamainstream.NOThe/NOMAIN qualifiersaysthatthenewstreamisnotpartNOEofthe project'smain developmentthreadandisexpectedtoROhaveashorterfuturelifetimethantheparentstream.'InthisGOcase,VDEmayassignlongerCMS generation expressionsMOO(usingCMS ``variant letters'')tofuturemodule generationsOinthestream.|! RIOYounormallyusethe/MAIN qualifierwhenyoucreateaSOstreamforyourprojectthatwillbethefuture continuationofNO5theparentstream.'CreatingstreamV2.0fromstreamV1.0isNOanexamplesince developmentofVersion1.0ofyourprojectROwillceaseasVersion2.0carriestheprojectintothefuture.JO>Youusethe/NOMAIN qualifierwhenyoucreatebaselev-ROelsorotherstreamsthatareexpectedtohaveshort lifetimes,Ocomparedtotheparentstream.=! KOIfyouspecifythe/MAIN qualifier,thenewstreamauto-MO maticallybecomesa successoroftheparentstreamsothatLO5changesare propagatedfromtheparenttothenewstream.MOIfyouspecifythe/MAIN qualifierbutyoudonotspecifyBOthe /SUCCESSORor /NOSUCCESSOR qualifier,themainKO>streamsthatare successorsoftheparentstreamarere-NOmovedas successorsoftheparentstreamandinsteadbecomeLO successorsofthenewstream.,TheeffectisthatthenewMOHstreamisinsertedintothe successorchainafterthepar-LOentstream.)Ifyouspecifythe/NOMAIN qualifier,nosuch"O insertiontakesplace.`KOFor informationonchangingthemainlineofdescentat-MOtributespecifictoa particularmodule generation,seethe:O5 documentationontheMODIFYGENERATION/MAIN_OSTREAMcommandinMODIFY GENERATION.  Specification DExplicit specificationof /[NO]MAINisnot currentlyF required,butexplicit specificationofthis qualifierGHmayberequiredinafuturereleaseofVDE.ExplicitF specificationofthisqualifier-eitheras/MAINoras* /NOMAIN-ishighly recommended. D*P? O/NOGENERATIONSMO( Specifiesthatthenewstreamshouldnotbe populatedwithPOthelatest generationsoftheparentstream.*IfyouusethisPO qualifier,yougetanewstream containingno generations.'IfMO2youomitthis qualifier,VDE populatesthenewstreamwithname,keepinmindthatthelogicalnamemustbedefinedROwhenitislaterusedtosend notification messages.(ItshouldSOthusbeagrouporsystemlogicalnameoralogicalnamethatTOHisinsomeotherwaydefinedforallusersoftheVDElibrary. %OIfyouspecifyonlyoneusername$= parameter,youmayomit(Othe surrounding parentheses.cO/OPEN (default)O(/FROZENO/CLOSEDLO Determinesthestatusofthenewstream:+open,frozen,orMO2 permanentlyclosed.*Ifyouspecifythe/OPEN qualifier,allGOuserscanreserveandreplacesourcemodulesfromtheGOstreamandtherebymodifythecontentsofthestream.! WNOIfyouspecifythe/FROZEN qualifier,allusersmayreserveIOmodulesfromthestream.*However,ausermusthavetheKO5FROZEN privilegetoreplacemodulesintothestream;non-LO privilegeduserscannotchangethecontentsofthestream.KOYoucanlaterchangethestatustoopenwiththeMODIFYJO>STREAMcommand,sothestreamisnot permanentlyfrozen.j @NOIfyouspecifythe/CLOSED qualifier,modulescannotbere-NOservedfromorreplacedintothestream.(ThisstatuscannotCO5bechangedwitha subsequentMODIFYSTREAMcommandHOunlessyouhavetheUNCLOSE privilege.'Usethe/CLOSEDOO qualifierwhenyouneverwantthecontentsofthestreamtoKO>changeagain,forexample,when capturinga base-levelofOOyoursoftwaresystemorwhen capturingthefinalstateofa0Oreleasedversionofyour software.pFFOOf/OPEN,/FROZENand/CLOSED,/OPENisthedefault.&UO/OWNER=username;O( Specifiestheownerofthenewstream.(The(username 8(pa-FOrameter specifiestheOpenVMSusernameofauserwhoOOshouldbe consideredtobethe ``owner''ofthestream.*VDEQO2assignsnospecialmeaningtotheownerofastream,buttheBOSHOWSTREAMcommanddisplaystheowner.)TheownerPOcouldthusbethepersontocontactwith questionsabouttheO<stream.]LOIfyouomitthis qualifier,VDErecordsnoownerfortheOstream. O/PARENT=stream-namePO( Specifiestheparentofthenewstream.,Ifthis qualifierisO specified,the1 stream-name)w parametergivesthenameofOOthe developmentstreamthatshouldbetheparentofthenewRO2streambeingcreated.(Ifthis qualifierisomitted,thedefault=Ostreambecomestheparentofthenewstream.& ROCorrect specificationofthis qualifierisofcentral importancePOwhen uploading facilitiesandstreamsfromanexistingsetof?O5CMS libraries.(SeetheCREATEFACILITY/FROM_CMS_OLIBRARYcommand.]33O Specificationof/PARENTis required.zO /POPULATE (default)O( /NOPOPULATEOO Specifieswhetherthestreamisallowedtobe populatedwithBO generationsfromanotherstreamusingthePOPULATEBO2STREAMcommand.) /POPULATEallows subsequentuseofCOthePOPULATESTREAMcommandtopopulatethestream1Oand /NOPOPULATE disallowssuchuse. r#O/PROCESS_COUNT=proc-countRO( Specifiesthedefaultnumberof processestoexecutebuildjobsJOforthenewstream.)This parameter determinesthedegreeOOof parallelismforthestream'sbuildjobs.+Seethedescrip-PO2tionoftheBUILDcommandforadetailed descriptionofthisO qualifier. z/O/QUEUE=(queue-name[,queue-name...])RO( SpecifiesthedefaultbatchqueuestowhichbuildjobsfortheMOnewstreamare submitted.'Seethe descriptionoftheBUILDOOcommandforadetailed descriptionofthis qualifierandforIO2a descriptionofits interactionwiththe/PROCESS_COUNTO qualifier.! O/REMARK="string"NO( Specifiesaremarkstringtobestoredforthenewstream.OOThequotedremarkstring,whichcanbeupto132 charactersHOlong,maycontainany explanatoryremarkaboutthenewMO2streamthatyouwantstoredintheVDE database.( TypicallyQOtheremark indicatestheversionor base-levelofyoursystem. NPOAlthoughthis qualifieris required,youcanspecifyanemptyNOremarkstring.'Ifyoudonotspecifythe/REMARK qualifier,4O5VDEpromptsyouforaremarkstring. qO/REPLACEMENT=keywordBO(ControlswhethertheREPLACEcommandpermitsimme-KOdiate replacementsintothenewstreamorrequiresqueued O replacements.)IftheDkeyword# parameteris IMMEDIATE,DO2theREPLACEcommandwill immediatelyreplacemodulesNOintothestreambydefault.)Ifthe parameterisQUEUE,theGOREPLACEcommandwillalwaysqueue replacementsfortheOO<streamsothatmodulesarenotreplacedintothestreamun-COtila privilegeduserentersaPERFORM REPLACEMENTLOcommand.(Ifyouomitthis qualifier,VDEpermits immediateLOE replacementsintothenewstream.*(Seethe descriptionsofDOthe /IMMEDIATEand/QUEUE qualifierstotheREPLACE+Ocommandformore information.)z P.O/REVIEWER=(username[,username...])KO( Specifies reviewersforallchangesreplacedintothenewOstream.(EachQusername, parameter specifiestheOpenVMSKOusernameofauserwhoshouldreviewallchangestotheMO2 specifiedstream.)TheusermustalreadyberecordedintheKOVDE database.)Whenamoduleisreplacedintothestream,POVDEnotifiestheuserofthe replacementbymailmessage.(IfMO<the replacementisqueued,theusershouldthenreviewtheLOqueued replacementbeforeitis performed.*Ifthereplace-NOmentis immediate,VDEnotifiestheuserofthenewmoduleMOE generationthatwascreated,andtheusermaytheninspectOthat generation. %OIfyouspecifyonlyoneusername$= parameter,youmayomit(Othe surrounding parentheses..#O/STEP_DELAY=time-intervalNO( Specifiesthedefault step-delaytimeintervalusedbybuildMOjobsforthenewstream.*Seethe descriptionoftheBUILDFOcommandforadetailed descriptionofthis qualifier.> U3O/SUCCESSOR=(succ-name[,succ-name...])!O( /NOSUCCESSOR (default)LOThe /SUCCESSOR qualifier specifies successorstothestreamKObeingcreated.,A successortoastreamisanotherstreamGO2towhichsourcechangesare propagatedbytheREPLACEOcommand.)Each succ-name) parameter specifiesthenameMOofastreamthatshouldbea successortothenewstreamO<givenbythe< stream-namea< parameter. tIOThe /NOSUCCESSOR qualifier specifiesthatthenewstream+Odoesnothaveany successors.U! +GOIfboththe /SUCCESSORand /NOSUCCESSOR qualifiersareMOomitted,thenewstreamhasno successorsunlessyouspec-LO5ifythe/MAIN qualifier.+Seethe descriptionofthe/MAINKO qualifierforthespecialrulesthatapplyinthiscase."!  O/TIMEOUT=time-intervalUO( SpecifiesthedefaulttimeoutintervalusedbybuildjobsfortheKOnewstream.(Seethe descriptionoftheBUILDcommandfor8Oadetailed descriptionofthis qualifier. A OExamples O1. VDE>JCREATE%STREAM%V5.2-BL3/REMARK="Base&Level&3%of% V5.2"/NOLOG VDE>HIThisexamplecreatesanewstreamcalled V5.2-BL3.'ThePremarkstring indicatesthatthisisbaselevel3ofversionI5.2oftheuser'ssoftwaresystem.(The/NOLOG qualifier)R suppressesalllog messages. O2. VDE>6CREATE%STREAM%V5.3%/REMARK="Version&5.3"7 Creating% directory%tree%for%stream&V5.3:BD` Root& directory%DEV$:[PROJDIR.V5_3]&has%been&created[D Facility%ACCTNG%root% directory%DEV$:[PROJDIR.V5_3.ACCTNG]%has&been%createdJ Subdirectory%DEV$:[PROJDIR.V5_3.ACCTNG.SRC]&has%been&createdJ8 Subdirectory%DEV$:[PROJDIR.V5_3.ACCTNG.OBJ]&has%been&createdN Subdirectory%"DEV$:[PROJDIR.V5_3.ACCTNG.VDE$COM]%has%been%createdN Subdirectory%"DEV$:[PROJDIR.V5_3.ACCTNG.VDE$LOG]%has%been%createdWD Facility%CODE&root% directory&DEV$:[PROJDIR.V5_3.CODE]%has%been%createdHW Subdirectory%DEV$:[PROJDIR.V5_3.CODE.SRC]%has%been%createdH Subdirectory%DEV$:[PROJDIR.V5_3.CODE.OBJ]%has%been%createdL Subdirectory% DEV$:[PROJDIR.V5_3.CODE.VDE$COM]%has&been%createdL/ Subdirectory% DEV$:[PROJDIR.V5_3.CODE.VDE$LOG]%has&been%createdUDw Facility%RMS%root% directory%DEV$:[PROJDIR.V5_3.RMS]%has&been%createdG Subdirectory%DEV$:[PROJDIR.V5_3.RMS.SRC]&has%been&createdG Subdirectory%DEV$:[PROJDIR.V5_3.RMS.OBJ]&has%been&createdKO Subdirectory%DEV$:[PROJDIR.V5_3.RMS.VDE$COM]%has%been%createdK Subdirectory%DEV$:[PROJDIR.V5_3.RMS.VDE$LOG]%has%been%createdUD Facility%SMG%root% directory%DEV$:[PROJDIR.V5_3.SMG]%has&been%createdG' Subdirectory%DEV$:[PROJDIR.V5_3.SMG.SRC]&has%been&createdGo Subdirectory%DEV$:[PROJDIR.V5_3.SMG.OBJ]&has%been&createdK Subdirectory%DEV$:[PROJDIR.V5_3.SMG.VDE$COM]%has%been%createdK Subdirectory%DEV$:[PROJDIR.V5_3.SMG.VDE$LOG]%has%been%created7DG All% directories%for&stream%V5.3now&existC %VDE-I-STRMADDED,%stream%V5.3%added%to%the%databaseM %VDE-I-COMMIT,%database% transaction%has% successfully& committedg VDE>E ThisexamplecreatesanewstreamcalledV5.3,rep-H.  resentingversion5.3oftheusersoftwaresystem.+TheH logmessagesindicatethatthe directoriesforthenewD streamhavebeencreated,thatthestreamhasbeenJ7 addedtothe database,andthatthedatabase transaction' has successfully completed.(546@OCREATEUSER* POCreatesadatabaserecordforanewuserofthecurrentVDEO(library.&ORequiresCREUSR privilege.lBOFormat2OsCREATEUSERNusername[, username...]O ParameterOsusernameLOTheOpenVMSusernameoftheusertobeaddedtotheVDEKO$ database.+Thisnamecanbeupto12 characterslongand*O|mustfollowVDEnamesyntax.O DescriptionDOsTheCREATEUSERcommandcreatesthedatabaserecordbythe specified privileges.'AuserwhodoesnothavearecordOOinagivenVDEdatabasecannotusetheVDEUtilitytogainEOaccesstothedatabaseorthe correspondinglibrary.]! 3O Qualifiers-Os/AUTH_PRIVILEGES=(priv [,priv...])OO Specifiesthenewuser's authorized privileges,whicharetheNO$ privilegestheuserisallowedtosetwiththeVDEcommandIO|SET PRIVILEGE.Each parametertothis qualifiernamesaSOsingle privilege.(Ifonlyone privilegeis specified,theparen-RO-thesesmaybeomitted.)Ifthis qualifierisnot specified,VDESOassignsthestandard authorized privilegesofthelibrarytotheOnewuser.f,OForalistof privileges,seeTable3-5 ~inSET PRIVILEGES.*Fa?*F?! ,O/DEF_PRIVILEGES=(priv [,priv...])LO( Specifiesthenewuser'sdefault privileges,whicharetheIO privilegesenabledeachtimetheuserstartsanewVDEJOsession.-Each parametertothis qualifiernamesasingleIO2 privilege.,Each privilege specifiedbecomesan authorizedWO privilegeaswellasadefault privilege,evenifithasnotbeenHOlistedwiththe/AUTH_PRIVILEGES qualifier.+IfonlyoneQO< privilegeis specified,the parenthesesmaybeomitted.(IftheLO/DEF_PRIVILEGES qualifierisnot specified,VDEassignstheNOstandarddefault privilegesofthelibrarytothenewuser.f,OForalistof privileges,seeTable3-5 ~inSET PRIVILEGES.*Fa?*F?O/LOG (default)O(/NOLOGLOControlswhetherlogmessagesareprintedafterusershaveLObeenaddedtothe database.+The/LOG qualifiercausestheHO2messagestobeprintedand/NOLOG suppressesthem.*TheLOmessagesindicatethatusershavebeenaddedandthatthe>Odatabase transactionhas successfully committed.I KO/NAME="string"LO( Specifiesthefullnameofthenewuser.+ThequotednameQOstring,whichcanbeupto40 characterslong,shouldcontainQOthefullname(firstname,middle initials,andlastname)ofO2thenewuser. NLOThis qualifieris required.*YoucanspecifyanemptynameROstringbutthisisnot recommended.(IfyoudonotspecifytheEO5/NAME qualifier,VDEpromptsyouforanamestring.,O/NOTIFY=(username[,username...])SO( Specifiesuserstonotifyofallcodechangesreplacedintothe1OVDElibrarybythenewuser.*Eachhusername parameterKO specifiestheOpenVMSusernameormailaddressofauserLO2whoshouldbenotifiedbymailmessageeachtimethenewJOusercreatedbythiscommandreplacesamoduleintotheOVDElibrary.! aOEach username7 parametercanspecifytheusernameofaFOuseralreadyrecordedintheVDE database,aOpenVMSDO5mailaddresswithoneormorenodenames(suchasMO NODE::SMITH),amail forwardingalias,oradefinedlogicalXOnameboundtoalistofuserstonotify.'IfyouspecifyalogicalLO>name,keepinmindthatthelogicalnamemustbedefinedROwhenitislaterusedtosend notification messages.(ItshouldSOthusbeagrouporsystemlogicalnameoralogicalnamethatTOHisinsomeotherwaydefinedforallusersoftheVDElibrary. %OIfyouspecifyonlyoneusername$= parameter,youmayomit(Othe surrounding parentheses. O/REMARK="string"QO( Specifiesaremarkstringtobestoredforthenewuser.(TheJOquotedremarkstring,whichcanbeupto132 charactersHOlong,maycontainany explanatoryremarkaboutthenewPO2userthatyouwantstoredintheVDE database.' TypicallythePOremark describestheuser's affiliationorfunctionwithintheO organization. NOOThis qualifierisrequiredalthoughyoucanspecifyanemptyNOremarkstring.'Ifyoudonotspecifythe/REMARK qualifier,4O5VDEpromptsyouforaremarkstring.f! <.O/REVIEWER=(username[,username...])QO( Specifies reviewersforallcodechangesreplacedintotheVDE,Olibrarybythenewuser.)EachusernameR parameterspeci-MOfiestheOpenVMSusernameofauserwhoshouldreviewallMO2changescreatedbythenewuser.&ThereviewermustalreadyNOberecordedintheVDE database.&WhenthenewusercreatedJObythiscommandreplacesamoduleintotheVDElibrary,OO<VDEnotifiesthereviewerofthechangebymailmessage.(IfLOthe replacementisqueued,thereviewershouldthenreviewLOthequeued replacementbeforeitis performed.+Ifthere-OOE placementis immediate,VDEnotifiesthereviewerofthenewNOmodule generationthatwascreated,andheorshemaythenQOinspectthat generation.*This qualifiercanbeusedtosetupNOO``buddy systems''wheretwousersalwaysrevieweachother'sOcode. %OIfyouspecifyonlyoneusername$= parameter,youmayomit(Othe surrounding parentheses.@   OExamples O1. VDE>MCREATE%USER&SMITH& NAME="Jane%Smith"/REMARK="OpenVMS% Developer"B %VDE-I-USERADDED,%user&SMITH&added&to&the%databaseM" %VDE-I-COMMIT,%database% transaction%has% successfully& committedj VDE>@ThiscommandcreatesadatabaserecordforuserA1SMITH.The/NAME qualifier specifiesJaneSmith'sIfullnameandthe/REMARK qualifier identifiesherjob.FTheexampleshowsthe informationallogmessagesthat6;the/LOG qualifierproducesbydefault. O2. VDE>NCREATE%USER&DOE% /NAME="John%X.%Doe"/REMARK="OpenVMS%Writer"&-! _VDE>3!&/AUTH_PRIVILEGES=(BUILD,CREGRP,CREMOD)%-i _VDE>0i/DEF_PRIVILEGES=(BUILD,CREFAC)%/NOLOG VDE>J Inthisexample,userDOEisaddedtothe database.*InHyadditionto specifyingthefullnameandaremarkforIJohnDoe,thiscommandgiveshis authorizedanddefaultG*VDE privileges.'NotethattheCREFAC privilegebecomesNan authorized privilegeaswellasadefault privilegeevenHthoughitisnotlistedbythe/AUTH_PRIVILEGESquali-N3fier.'Inthiscase,the/NOLOG qualifier suppressesthelog messages. O 3.+ VDE>5+ CREATE%USER/REMARK="OpenVMS% Developer"&-s _VDE>(s SMITH% /NAME="Jane%Smith",&- _VDE>% JONES% /NAME="Frank%Jones"B %VDE-I-USERADDED,%user&SMITH&added&to&the%databaseBJ %VDE-I-USERADDED,%user&JONES&added&to&the%databaseM %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE>JI Thisexample illustratesthecreationofdatabaserecordsC formultipleuserswithasingleCREATEUSERcom-> mand.*ThiscommandaddsusersSMITHandJONESGS tothe database.+Bothgetthesameremarkstringbe-D causetheremarkis specified immediatelyaftertheA CREATEUSERcommand.(TheygetseparatefullnameJ\ stringsandbothgetthestandard authorizedanddefault0  privilegesofthecurrentlibrary.D$CEBlODELETESCRIPT*mncthedefaultvalueapplies.r >OKeywordsusedwithinscriptsare documentedinQScriptO Keywords,+whilescript functionsareinScript Functions, Vand O5scripttypesarein5ScriptTypes.$5Forotherscript-relatedO commands,alsosee$CREATESCRIPT,EXTRACTSCRIPT,OINVOKESCRIPT,MODIFYSCRIPT, andfSHOWSCRIPT.nrDQQH!H!OO*rLO*rO:*r$P?/*rP?*rO?0*r?\*rfA? srO QualifiersOs/BUILDNO Specifiesthatthedefaultstream'sBUILDscriptbedeleted.t O/COMPILE=mod-nameMO( Specifiesthatthedefaultstream'sCOMPILEscriptwiththeO specifiedmod-name%s specificationbedeleted.su! IO/CONFIRMO( /NOCONFIRM (default)IOControlswhetherVDEasksyoutoconfirmthatyouwantKOeachscriptdeleted.(The/CONFIRM qualifiercausesVDEtoPO2printamessageforeachscriptaskingwhetheryouwantthatTOscriptdeleted.(IfyouanswerYES(orY),thescriptisdeletedSOfromthe database.'IfyouanswerNO(orN),thescriptisnotGO<deleted.*The /NOCONFIRM qualifiercausesVDEtodeleteFOthe specifiedscriptswithoutaskingfor confirmation.vO/COPY=mod-nameJO( Specifiesthatthedefaultstream'sCOPYscriptwiththeO specifiedmod-name%s specificationbedeleted.w! O/CREATE_FACILITYRO( SpecifiesthatthescriptthatVDEinvokeswhenanewfacility+Oiscreatedshouldbedeleted.x%O/DELETE_GENERATION=mod-nameDO( Specifiesthatthedefaultstream'sDELETE_GENERATION&Oscriptwiththe specifiedmod-name% specificationbedeleted.yO/DIFFERENCES=mod-nameFO( Specifiesthatthedefaultstream's DIFFERENCESscriptOwiththe specifiedmod-name% specificationbedeleted.zO/FETCH=mod-nameKO( Specifiesthatthedefaultstream'sFETCHscriptwiththeO specifiedmod-name%s specificationbedeleted.{%O/INSERT_GENERATION=mod-nameDO( Specifiesthatthedefaultstream'sINSERT_GENERATION&Oscriptwiththe specifiedmod-name% specificationbedeleted.|O/LINK=mod-nameJO( Specifiesthatthedefaultstream'sLINKscriptwiththeO specifiedmod-name%s specificationbedeleted.}O/LOG (default)O(/NOLOGLOControlswhetherlogmessagesareprintedafterthescriptLOisdeleted.+The/LOG qualifiercausessuchmessagestobeHO2printedandthe/NOLOG qualifier suppressesthem.*TheseNOmessagesindicatethatthescripthasbeendeletedandthatCOthedatabase transactionhas committed successfully.~O/NEW_STREAM=fac-nameEO( Specifiesthatthedefaultstream's NEW_STREAMscriptOwiththe specifiedfac-name%| specificationbedeleted.O/NOKEEP=mod-nameLO( Specifiesthatthedefaultstream'sNOKEEPscriptwiththeO specifiedmod-name%s specificationbedeleted.O/REPLACE=mod-nameMO( Specifiesthatthedefaultstream'sREPLACEscriptwiththeO specifiedmod-name%s specificationbedeleted.O/RESERVE=mod-nameMO( Specifiesthatthedefaultstream'sRESERVEscriptwiththeO specifiedmod-name%s specificationbedeleted.G! KO/SEGMENT=seg-numLO( Specifiesthesegmentnumberofthescripttodelete.,TheOseg-num> parameter specifiestheintegersegmentnumber.SOIfyouomitthis qualifier,VDEdeletesthescriptwithsegmentO2number10. O/SET_FACILITY=fac-nameGO( Specifiesthatthedefaultstream's SET_FACILITYscriptOwiththe specifiedfac-name%| specificationbedeleted.pO /SET_STREAMIO( Specifiesthatthedefaultstream's SET_STREAMscriptbeOdeleted.O/STAGING=mod-nameMO( Specifiesthatthedefaultstream'sSTAGINGscriptwiththeO specifiedmod-name%s specificationbedeleted.O/UNRESERVE=mod-nameJO( Specifiesthatthedefaultstream's UNRESERVEscriptwithOthe specifiedmod-name% specificationbedeleted.w CMOExamples O1. VDE>*DELETE%SCRIPT/COMPILE=[CODE]*.C? %VDE-I-SCRPDEL,%script&deleted%from%the%database?" script&to&compile%module& [CODE]*.C%(segment%10)Mj %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE>K!ThisexampledeletesthescripttocompileallCmodulesMyinfacilityCODE.ThelogmessagesidentifythescriptandLshowthatitwas successfullydeleted.)Thescriptisonly:*deletedforthedefault developmentstream.| K#JLCOEXTRACTSCRIPT*! AcQOExtractsaVDEscriptfromtheVDEdatabaseandwritesittoO(afile.^4OFormat$OsEXTRACTSCRIPTN file-spec O ParameterOs file-specNO SpecifiestheOpenVMSfile specificationfortheoutputfileUO$thatwillcontainsthetextofthe extractedscript.(Ifyouomit2O|the directory specificationfromthe\| file-spec| parameter,MOyourcurrentdefault directoryisassumed.+Ifyouomitthe$O-file extensionfromthe- file-spec%- parameter,file extension!O VDESCRIPTisassumed.4M O DescriptionAOsTheEXTRACTSCRIPTcommandreadsa specifiedVDEPOscriptfromtheVDEdatabaseandwritesittoanASCIItextPO$file.+VDEonlyextractsthescriptofthe specifiedtypeandGO|segmentnumberthatbelongstothedefault development?Ostream.,YoucanusetheEXTRACTSCRIPTcommandVO-whenyouwanttogetascriptintoafilesothatyoucaneditOOitandthenreinsertitintothedatabasewitha subsequent"OCREATESCRIPTcommand.POzYoumustspecifya script-type qualifiertoselectthescriptGOyouwant extracted.-Seethe descriptionoftheCREATEDO+SCRIPTcommandforan explanationoftheformatofTOscripts,the differenttypesofscripts,andhowscriptsarese-POlectedusing script-type qualifiers.(YoumustalsospecifytheHO4scriptsegmentnumberunlessthedefaultvalueapplies. >OKeywordsusedwithinscriptsare documentedinQScriptO Keywords,+whilescript functionsareinScript Functions, Vand O5scripttypesarein5ScriptTypes.$5Forotherscript-relatedO commands,alsosee(CREATESCRIPT,DELETESCRIPT,OINVOKESCRIPT,MODIFYSCRIPT, andfSHOWSCRIPT.nDQQH!H!OO*LO*O:*(P?/*P?l*O?0*?\*fA?  tO QualifiersOs/BUILDPO Specifiesthatthedefaultstream'sBUILDscriptbe extracted. O/COMPILE=mod-nameMO( Specifiesthatthedefaultstream'sCOMPILEscriptwiththeO specifiedmod-name's specificationbe extracted.O/COPY=mod-nameJO( Specifiesthatthedefaultstream'sCOPYscriptwiththeO specifiedmod-name's specificationbe extracted.! O/CREATE_FACILITYRO( SpecifiesthatthescriptthatVDEinvokeswhenanewfacility-Oiscreatedshouldbe extracted.%O/DELETE_GENERATION=mod-nameDO( Specifiesthatthedefaultstream'sDELETE_GENERATION&Oscriptwiththe specifiedmod-name  specificationbeex-Otracted.O/DIFFERENCES=mod-nameFO( Specifiesthatthedefaultstream's DIFFERENCESscriptOwiththe specifiedmod-name' specificationbe extracted.O/FETCH=mod-nameKO( Specifiesthatthedefaultstream'sFETCHscriptwiththeO specifiedmod-name's specificationbe extracted.%O/INSERT_GENERATION=mod-nameDO( Specifiesthatthedefaultstream'sINSERT_GENERATION&Oscriptwiththe specifiedmod-name  specificationbeex-Otracted.O/LINK=mod-nameJO( Specifiesthatthedefaultstream'sLINKscriptwiththeO specifiedmod-name's specificationbe extracted.{O/LOG (default)O(/NOLOGLOControlswhetherlogmessagesareprintedafterthescriptNOis extracted.)The/LOG qualifiercausessuchmessagestobeHO2printedandthe/NOLOG qualifier suppressesthem.*TheseJOmessagesindicatethatthescripthasbeen extractedand&Oidentifytheoutputfile.O/NEW_STREAM=fac-nameEO( Specifiesthatthedefaultstream's NEW_STREAMscriptOwiththe specifiedfac-name'| specificationbe extracted.O/NOKEEP=mod-nameLO( Specifiesthatthedefaultstream'sNOKEEPscriptwiththeO specifiedmod-name's specificationbe extracted.O/REPLACE=mod-nameMO( Specifiesthatthedefaultstream'sREPLACEscriptwiththeO specifiedmod-name's specificationbe extracted.O/RESERVE=mod-nameMO( Specifiesthatthedefaultstream'sRESERVEscriptwiththeO specifiedmod-name's specificationbe extracted.LK"O/SEGMENT=seg-numMO( Specifiesthesegmentnumberofthescripttoextract.+TheOseg-num; parameter specifiestheintegersegmentnum-QOber.*Ifyouomitthis qualifier,VDEextractsthescriptwithO2segmentnumber10. O/SET_FACILITY=fac-nameGO( Specifiesthatthedefaultstream's SET_FACILITYscriptOwiththe specifiedfac-name'| specificationbe extracted.rO /SET_STREAMIO( Specifiesthatthedefaultstream's SET_STREAMscriptbeO extracted.O/STAGING=mod-nameMO( Specifiesthatthedefaultstream'sSTAGINGscriptwiththeO specifiedmod-name's specificationbe extracted.O/UNRESERVE=mod-nameJO( Specifiesthatthedefaultstream's UNRESERVEscriptwithOthe specifiedmod-name' specificationbe extracted. #OExamples O1. VDE><EXTRACT%SCRIPT/COMPILE=[CODE]*.C&[MYDIR]SCRIPT_CY %VDE-I-SCRPEXTR,&script% extracted%to%file% DEV$:[MYDIR]SCRIPT_C.VDESCRIPT;1?" script&to&compile%module& [CODE]*.C%(segment%10)j VDE>jEXIT  $)TYPE%[MYDIR]SCRIPT_C.VDESCRIPT/ !&Script%to%compile&a%C%module. B !  EMIT&"$&SET%VERIFY"5 EMIT&"$& DEFINE/NOLOG%SRC$&",& $DIR(SRC)5 EMIT&"$& DEFINE/NOLOG%OBJ$&",& $DIR(OBJ)@b EMIT&"$&CC/DEBUG/OBJ=OBJ$:/ANA=OBJ$:%SRC$:",$MODTYP5 EMIT&"$& VDE/DEPEND%C%OBJ$:",$MOD,".ANA" EXIT 9 $DThisexampleextractsthescripttocompileCmod-IulesinfacilityCODE.VDEwritesthescriptintofile:YDEV$:[MYDIR]SCRIPT_C.VDESCRIPT.The subsequentHTYPEcommandshowsthatthefilecontainsthetextof thescript.u9O#NPB0OINVOKESCRIPT*12MOInvokesaVDEscriptfromtheVDEdatabaseandwritestheKO( resultingDCLcommandfiletoa directoryinthecurrent;OVDElibraryortoaVDEscratch directory.R3(OFormatOsINVOKESCRIPT4 UO Description@OsTheINVOKESCRIPTcommandreadsa specifiedVDELOscriptfromtheVDE database,executesthescriptlanguageKO$inthescripttoproduceaDCLcommandfile,andwritesIO|thatDCLcommandfiletothe appropriate directory.+TheEOINVOKESCRIPTcommanddoesnotexecutethe resultingO-DCLcommandfile.JOThe directorythatreceivestheDCLcommandfileistheNO! directorythatwouldreceiveitifthescriptwereexecutedLOznormallyaspartofaVDEcommand.'This directorydependsTOonthescripttype,andis displayedinalogmessage.'YoucanBO+usetheINVOKESCRIPTcommandtoexaminetheDCLDOcode generatedbyVDEinresponsetoyourscripts.5 POYoumustspecifya script-type qualifiertoselectthescriptEOyouwantinvoked./Seethe descriptionoftheCREATEMO5SCRIPTcommandforan explanationoftheformatofscriptsOOandthe differenttypesofscripts.,Alsoseethe descriptionDOoftheCREATESCRIPTcommandforan explanationofQO>howVDEselectsscriptsforspecificmodulesor facilities.*IfKOthescriptsyouselecthavemultiplesegmentnumbers,VDEJOselectsonescriptforeachsegmentnumberand generatesMOHtheDCLcommandfilefromthosescriptsinorderbytheirOsegmentnumbers.6NEOTheINVOKESCRIPTcommandalwaysselectsandinvokesOOthedesiredscriptinthecontextofthedefault developmentO5stream.7W>OKeywordsusedwithinscriptsare documentedinQScriptO Keywords,+whilescript functionsareinScript Functions,%O5andscripttypesarein5ScriptTypes.5Forotherscript-'Orelated commands,alsosee=CREATESCRIPT,DELETEOSCRIPT,EXTRACTSCRIPT,MODIFYSCRIPT, zandO>SHOWSCRIPT.n7DQQH!H!OO*7OO*7O:*7=P?/n7lDRBRBzzOO*7?*7?\*7OA? 8rO QualifiersOs/BUILDNO Specifiesthatthedefaultstream'sBUILDscriptbeinvoked.=9! UO/COMPILE=mod-nameLO( SpecifiesthataCOMPILEscriptforthedefaultstreambePOinvokedfora specifiedmodule,usingVDE'snormalscriptse-Olectionrules.'Themod-name) parameter specifiesthenameJO2ofthemodule.)Thisnamemaynotcontainwildcardchar-KOacters.,The specifiedmodule determinesthevaluesoftheEO$FAC,$MOD,and$TYPscript functions(amongothers))O<whenthescriptisinvoked.1:! UO/COPY=mod-nameRO( SpecifiesthataCOPYscriptforthedefaultstreambeinvokedMOfora specifiedmodule,usingVDE'snormalscript selectionOrules.(Themod-name2 parameter specifiesthenameoftheGO2module.+Thisnamemaynotcontainwildcard characters.IOThe specifiedmodule determinesthevaluesofthe$FAC,IO$MOD,and$TYPscript functions(amongothers)whentheO<scriptisinvoked.&;O/CREATE_FACILITYMO( Specifiesthatthefacilitycreationscriptbeinvoked.-TheJOthevaluesofthe$FAC,$MOD,and$TYPscript functionsKO(amongothers)are determinedwhenthescriptisinvoked.Q<U'%O/DELETE_GENERATION=mod-nameFO( SpecifiesthataDELETE_GENERATIONscriptforthede-NOfaultstreambeinvokedfora specifiedmodule,usingVDE's0Onormalscript selectionrules.+The(mod-name  parameterLO2 specifiesthenameofthemodule.)Thisnamemaynotcon-IOtainwildcard characters.)The specifiedmodule determinesJOthevaluesofthe$FAC,$MOD,and$TYPscript functions:O<(amongothers)whenthescriptisinvoked.?= UO/DIFFERENCES=mod-nameLO( Specifiesthata DIFFERENCESscriptforthedefaultstreamOObeinvokedfora specifiedmodule,usingVDE'snormalscript O selectionrules.,The*mod-name#  parameter specifiestheIO2nameofthemodule.*ThisnamemaynotcontainwildcardJO characters.*The specifiedmodule determinesthevaluesofJOthe$FAC,$MOD,and$TYPscript functions(amongothers))O<whenthescriptisinvoked.6> U O/FETCH=mod-nameOO( SpecifiesthataFETCHscriptforthedefaultstreambein-IOvokedfora specifiedmodule,usingVDE'snormalscript O selectionrules.,The*mod-name#  parameter specifiestheIO2nameofthemodule.*ThisnamemaynotcontainwildcardJO characters.*The specifiedmodule determinesthevaluesofJOthe$FAC,$MOD,and$TYPscript functions(amongothers))O<whenthescriptisinvoked.R?U(%O/INSERT_GENERATION=mod-nameGO( SpecifiesthatanINSERT_GENERATIONscriptforthede-NOfaultstreambeinvokedfora specifiedmodule,usingVDE's0Onormalscript selectionrules.+The(mod-name  parameterLO2 specifiesthenameofthemodule.)Thisnamemaynotcon-IOtainwildcard characters.)The specifiedmodule determinesJOthevaluesofthe$FAC,$MOD,and$TYPscript functions:O<(amongothers)whenthescriptisinvoked.1@! UO/LINK=mod-nameRO( SpecifiesthataLINKscriptforthedefaultstreambeinvokedMOfora specifiedmodule,usingVDE'snormalscript selectionOrules.(Themod-name2 parameter specifiesthenameoftheGO2module.+Thisnamemaynotcontainwildcard characters.IOThe specifiedmodule determinesthevaluesofthe$FAC,IO$MOD,and$TYPscript functions(amongothers)whentheO<scriptisinvoked.AO/LOG (default)O(/NOLOGLOControlswhetherlogmessagesareprintedafterthescriptLOisinvoked.+The/LOG qualifiercausessuchmessagestobeHO2printedandthe/NOLOG qualifier suppressesthem.*TheseNOmessagesindicatethatthescripthasbeeninvokedandgiveEXIT B $  $3TYPE%#[PROJDIR.MAIN.CODE.VDE$COM]MODNAM.C? $&!%DCL&command%file%to%execute&a%VDE&script $&!/b $&ON&WARNING%THEN%GOTO& VDE$ERROR $&! $&SET%VERIFY=9 $& DEFINE/NOLOG%SRC$&DEV$:[PROJDIR.MAIN.CODE.SRC]= $& DEFINE/NOLOG%OBJ$&DEV$:[PROJDIR.MAIN.CODE.OBJ]8 $&CC/DEBUG/OBJ=OBJ$:/ANA=OBJ$:% SRC$:MODNAM.C+ $& VDE/DEPEND%C%OBJ$:MODNAM.ANAY $&!= $&SET%NOVERIFYp!% Successful%script% completion  $& VDE/STATUS%SUCCESS1 $&EXITy $VDE$ERROR:> $&SET%NOVERIFYp!%Script& completed%with&errors  $& VDE/STATUS%FAILUREQ $&EXIT  $M Inthisexample,theuserinvokesthescriptthatcompilesB` moduleMODNAM.CinfacilityCODE.VDEselectstheK  appropriatescriptusingitsnormalscript selectionrulesM andappliesthescripttothatmodule.(VDEwritesthere-Dj sultingDCLcommandfiletoafilecalledMODNAM.CF intheVDE$COM subdirectoryforthegivenstreamand=  facility.,(TheCOMPILEandBUILDcommandsuseIs this directorywhentheygenerateandexecute build-step? commandfiles.)*The subsequentDCLTYPEcommandI% showsthetextoftheDCLcommandfile.*Thistextin-F} cludessomestandard``boiler-plate''atthe beginningQ andendofthefile.(InthemiddleofthefilearetheDCLG. commandsthatcomefromthescriptitself.)Thesecom-A mandsenable command-line verification,definetwo? logicalnames,compilethemodule MODNAM.C,andA8usethe VDE/DEPENDcommandtorecordthecompileFstep'sbuild dependencies.*The surrounding boiler-plateOtrapserrorsandrecordsthebuildstep'sstatus(successorB failure).WX,WYCOMODIFYLIBRARY*?LOModifies informationinthedatabaseheaderrecordfortheJO(currentVDElibrary.(ThiscommandcanmodifythelibraryIOname,thelibraryremarkstring,thestandard authorizedQOanddefault privilegesfornewusersofthelibrary,andvar-OO2iousotherlibrary attributes.,ItcanalsoenableordisableGO after-image journallingforthe library'sVDE database.&O&RequiresMODLIB privilege.S)OFormatOsMODIFYLIBRARYM#O ParametersOs None.7m O QualifiersOs /ALLOW_DELETEO/NOALLOW_DELETE2O$ Specifiesthedefaultvalueforthe$delete4$ attributefornewBO|modules, facilities,andstreams.,The /ALLOW_DELETEQO qualifiersetsalibrary attributethatcausesVDEtosettheO-deleteEj- attributebydefaultwhenuserscreatenewsuchen-VOtities.(Asaresult,userscandeletetheseentitieswithoutfirstOhavingtosetthedelete. attributewithaseparateMODIFYAO7command.*The/NOALLOW_DELETE qualifierclearsthis8Olibrary attributesothatVDEclearsthedelete attributebyMOdefaultfornewmodules, facilities,andstreams.,Asare-SOAsult,itisharderforausertodeleteanentitybymistake;Otheentity'sdelete5 attributemustbesetwithaseparateIOMODIFYcommandbeforetheentitycanbedeletedwithaFOJDELETEcommand.(Whencreatingnewmodules, facilities,MOandstreams,youcanoverridethisdefaultsettingwithanFOexplicit/DELETEor /NODELETE qualifiertotheCREATEOTcommand.u KGOUsethe /ALLOW_DELETE qualifierifyouexpecttomakeJOfrequentchangestoyourlibrary,oftendeletingmodules,FO5 facilities,andstreams.'Usethe/NOALLOW_DELETEqual-MOifierifyouaremore concernedabout preventing accidental'Odeletionofsuch entities. O/ASK_INFO_FILEO(/NOASK_INFO_FILEHO SpecifieswhethertheREPLACEcommandshouldbydefaultMOasktheuserwhetherheorshewantstoeditaninforma-IO2tionfilewhencreatingaqueued replacement.+The/ASK_NO INFO_FILE qualifiersetsalibrary attributethatcausestheHOREPLACEcommandtoaskforan informationfilebyde-IO<fault.)The/NOASK_INFO_FILE qualifierclearsthislibraryIO attributesothattheREPLACEcommanddoesnotaskforROan informationfilebydefault.'Thislibrary attributeonlyaf-FOEfectsqueued replacements(not immediatereplacements),JOanditonlyaffectstheREPLACE command'sdefaultbehav-EOior;userscanalwaysusethe command's /INFORMATIONHOOor/NOINFORMATION qualifierto explicitlyrequesteitherO behavior. ^O/ASK_REPL_CAUSEO(/NOASK_REPL_CAUSEHO SpecifieswhethertheREPLACEcommandshouldbydefaultPOasktheuserforthe ``cause''ofthe replacement.)ThecauseKO2maybeafold operation,aSourceControlTracking(SCT)OOentryinaNotes conference,orsomeothercause.'The/ASK_JO REPL_CAUSE qualifiersetsalibrary attributethatcausesFO<theREPLACEcommandtoquerytheuserforthecauseBOofthe replacement.)The/NOASK_REPL_CAUSE qualifierKOclearsthislibrary attributesothattheREPLACEcommand1OEdoesnotaskforthis information.5U -O/AUTH_PRIVILEGES=(priv [,priv...])NO( Specifiesthestandard authorized privilegesofnewusersofLOthecurrentlibrary.*However,any privileges specifiedwithBOtheCREATEUSERcommandoverridethese privileges.OO2Becausethe privilegelistyoucreatereplacesthe authorizedSO privilegelistofthecurrentlibrary,youmustspecifyallau-QOthorized privilegesthatyouwantnewusersofthelibrarytoO<have.NLOEach parametertothis qualifiernamesasingle privilege.MOIfonlyone privilegeis specified,the parenthesesmaybeO5omitted.f,OForalistof privileges,seeTable3-5 ~inSET PRIVILEGES.*Fa?*F?! g'O/AUTO_ADD_USER[=rights-ident]O(/NOAUTO_ADD_USERMO SpecifieswhethernewusersshouldbeaddedtothelibraryKOdatabase automaticallywhentheyfirstaccessthelibrary.EO2The/AUTO_ADD_USER qualifier specifiesthatnewusersLOshouldbeaddedtothelibrarydatabase automaticallywhen5Otheyfirstaccessthelibrary.*Ifthe? rights-ident@parame-WO<teris specified,newusersareonlyaddedtothelibraryiftheyMOholdtheOpenVMSrights identifier specifiedbytheparame-FOter.(The/NOAUTO_ADD_USER qualifier specifiesthatnewOOEusersnotbeaddedtothelibrarydatabaseautomatically.)InOOthiscase,newuserscanonlybeaddedwithexplicitCREATEOUSER commands.! `FOTheowner information specifiedintheOpenVMSSYSUAFOOdatabasewillbeusedastheownerofanynewVDEusernameLO5created.)VDEwillignoreanyleading numerics,leadinghy-OOphens,leadingspace characters,andleadingtilde characters,0OlistedintheSYSUAFownerfield.K !O /AUTO_CONVERTO(/NOAUTO_CONVERTJO Specifieswhetherthelibraryanditsdatabaseareauto-FO matically convertedtothenewlibraryformatwhenaIO2newversionofVDEisusedonthelibrary.,The/AUTO_MOCONVERT qualifier specifiesthatthelibraryshouldbecon-QOverted automaticallythefirsttimeauserusesanewversionKO<ofVDEonthepresentlibraryandits database.)/NOAUTO_LOCONVERT specifiesthatthelibraryshouldnotbe convertedNOautomatically;insteada privilegedusermust explicitlycon-COEvertthelibrarywiththeCONVERTLIBRARYcommand.?OSeetheCREATELIBRARYandtheCONVERTLIBRARYO commands.f <O /AUTO_MAILO( /NOAUTO_MAILIO SpecifieswhetherVDEshould automaticallysendmailno-KO tificationtotheuserwhohasqueueda replacementwhenCO2that replacementislater performed.,The /AUTO_MAILLO qualifiersetsalibrary attributethatcausesthePERFORMCO REPLACEMENTcommandtosendsuchmail notification.HO<The /NOAUTO_MAIL qualifierclearsthislibrary attributeAOsothatthePERFORM REPLACEMENTcommanddoesnot#Osendsuch notification. O/CMS_ELEM_HISTO(/NOCMS_ELEM_HISTHO SpecifieswhetherVDEcreatestheCMSelementsfornewIOmoduleswithdefaultCMShistoryandnotesstrings.+TheFO2/CMS_ELEM_HIST qualifiercausesVDEtocreatetheCMSIOelementsfornewmoduleswithdefaulthistoryandnotesEOstringsandthe/NOCMS_ELEM_HIST qualifiercausesVDEJO<tocreateCMSelementswithnodefaulthistoryornotesBOstrings.,/NOCMS_ELEM_HISTisnormallyonlyusedifEOyou regularlyfetchVDEmodulesusingtheCMSFETCHIOEcommandandyouwanttomakesureyoudonotgetCMS*Ohistoryornotesbydefault. u,O/DEF_PRIVILEGES=(priv [,priv...])PO( Specifiesthestandarddefault privilegesofnewusersoftheLOcurrentlibrary.*However,any privileges specifiedwiththeFOCREATEUSERcommandoverridethese privileges.'BecauseTO2the privilegelistyoucreatereplacesthedefault privilegelistROofthecurrentlibrary,youmustspecifyalldefault privilegesMOthatyouwantnewusersofthelibrarytohave.+Eachde-MO<fault privilege specifiedalsobecomesastandard authorized'O privilegeforthelibrary.3! N POEach parametertothis qualifiernamesasingle privilege.(IfSOonlyone privilegeis specified,the parenthesesmaybeomitted.,O5Foralistof privileges,see5Table3-5 ~5in5SET PRIVILEGES.*a?*?m rCO/HISTORY_NOTESO(/NOHISTORY_NOTESCO SpecifieswhetherVDE'sRESERVEcommandcanproduceLOCMShistoryornotes informationinitsoutputfiles.,The?O2/HISTORY_NOTES qualifierallowstheRESERVEcom-NOmandtoproducehistoryandnotes informationandtoacceptCOthe /HISTORY,/NOTES,and /POSITION qualifiers.,TheAO</NOHISTORY_NOTES qualifiercausestheRESERVEcom-KOmandtoneverproducehistoryandnotes information(evenJOwhensuch informationisthedefaultforamodulebeingGOE reserved)andtonotacceptthe /HISTORY,/NOTES,andKO /POSITION qualifiers.+Inthiscase,youmustusetheVDEGOFETCHcommandtogetCMShistoryornotes informationOOOforamodule.( Disablinghistoryandnotes informationinre-LOservedfilesmakescertainmistakeslesslikelywheresuchQO informationgetsreplacedintotheVDElibraryaspartoftheOYmoduletext.! cO/JOURNAL=dir-specO( /NOJOURNALHOEnablesordisables after-image journallingfortheVDECO database.-The/JOURNAL qualifierenables after-imageLO2 journallingand specifiesthatadatabase after-imagejour-VOnal(.AIJ)filebecreatedinthe directorylocationgivenbytheOdir-spec= parameter.'WhenusedwiththeRMUbackupandNO<restore facilities, after-image journallingallowsyoutore-NOcoverthe up-to-datecontentsofyourdatabaseafteradiskROfailure.'The specified directoryshouldalwaysresideonadif-QOEferentphysicaldiskthananyofyourotherdatabasefilessoLOthatthejournalfilecannotbedamagedbythesamedisk-Ofailureasthedatabaseitself. NHOThe /NOJOURNAL qualifierdisables after-image journallingGOfortheVDE database.*However,Digital recommendsthat(O5youalwaysuse journalling. fO/LOCKO(/UNLOCKFOThe/LOCKand/UNLOCK qualifiersprovideamethodbyAOwhichRESERVE,REPLACE, UNRESERVE,andothersim-NO2ilarcommandscanbedisabledonacopyofaVDElibrary.KOThis mechanismisnotintendedto completelylock-outall&OaccesstoaVDElibrary. eHO Specificationof/LOCK write-locksthelibrary,andtheFO corresponding/UNLOCK qualifierreversesthelock.+TheRO5 write-lockstatusisreadonlywhentheuser initiallyaccessesROthe library-onceauserhas connectedtothelibrary,thelockOstatusis  notupdated.NMOA write-lockedlibrarycanbeusedtopreventvarioususerMO modificationstothecontentsofthelibraryduringlibraryJO5 maintenance,ortomaintainashadowcopyofalibrary. NIOUsersholdingtheMODLIB privilegeareallowedtoover-OOridethelibrary write-lock.'An informationalmessagewillbe5O5 displayedwhenthelockis overridden.! UO/LOG (default)O(/NOLOGNOControlswhetherlogmessagesareprintedafterthedatabaseOOheaderrecordofthelibraryis modified.)The/LOG qualifierJO2causessuchmessagestobeprintedand/NOLOG suppressesOOthem.'Themessagesindicatethatlibrary attributeshavebeenLOmodifiedandthatthedatabase transactionhas successfullyO< committed. O/NAME=lib-nameMO( Specifiesanewnameforthecurrentlibrary.*Thenewli-OObrarynamecanbeupto39 characterslongandmustfollow$OnormalVDEnamesyntax.t JLOThisvalueis availableto procedurescallingVDEviathe9OVDE$LIBRARY_MNEMONICname,andthedatabaseOO5managershouldsetthisvaluetomatchthevalues associatedJOwiththislibrarythatare specifiedinthe VDE$LIBRARY_,ODEFAULTS_MNEMONICSlogicalname. O/REMARK="string"QO( Specifiesanewremarkstringforthelibrary.'Thequotedre-LOmarkstring,whichcanbeupto132 characterslong,mayKOcontainany explanatoryremarkaboutthelibrarythatyouPO2wantstoredinthelibrary database.(ThisstringreplacestheDOremarkstringfromtheoriginalCREATELIBRARYcom-BOmandorfromanypreviousMODIFYLIBRARYcommand.qGLOThisvalueis availableto procedurescallingVDEviatheOOPERFORM REPLACEMENTcommandtoprintaninfor-IOmationalmessageiftheactualCMS generation expressionROforthereplaced generationturnsouttobe differentthantheDOYexpectedone.'The/NOSHOW_GEN_EXPR qualifierdisables#Othislibrary attribute.acIOPleasenotethatVDEcannot guaranteethattheexpectedMOCMS generation expressionwillactuallybeused.+ItisnotEO5possibleto determineatRESERVEtimewhetheraCMSNOvariantlettershouldbeusedwhenthemoduleis eventuallyKO replaced;thatdecisioncanonlybemadeatREPLACEtimeHO>anddependson propagation decisionsandstreamsucces-KOsor relationshipsatthattime.)However,theexpectedCMSMO generation expressionis generallytheonethatisactuallyOHused.! O /STATISTICSSO(Enables statistics collectiononthe specifiedlibrary.)ThiswillNOcausevariousextra questionstobeaskedduring replacementMOandrelated operations.*Thisincludestheadditionofques-QO2tionsaroundthereasonforthechange,thenumberofdefectsQOfixed,andthe particularprojectachangeis associatedwith.4 # O /WILD_INS_GENO(/NOWILD_INS_GENNO Specifieswhetherwildcard charactersareallowedinthepa->OrameterstotheINSERT GENERATIONcommandwhenFO2the /GENERATION qualifieris specified.)The /WILD_INS_LOGEN qualifiersetsalibrary attributethatcausesVDEtoGOallowwildcard charactersinsuch parameterswhiletheDO</NOWILD_INS_GEN qualifierclearsthis attribute.)When=Othe /GENERATION qualifiertoINSERT GENERATIONPO specifiesaspecificCMS generation expression,itisunlikelyOOEthatthis generation expressioncouldapplytomorethanoneQOmodule.+Asaresult,itisunlikelythattheuseofwildcardGO charactersinthe module-name parameterswillgivetheKOOresulttheuser intended.)Toprevent mistakes,VDEthere-OOforedoesnotallowsuchwildcardusagebydefault.'However,MOtherearesome situationswhensuchusagemightbecorrectMOY(forexample,ifthe specifiedCMS generation expressionisOO1).*Forsuch situations,youcanenabletheuseofwildcard:O  characterswiththe /WILD_INS_GEN qualifier. OExamples O1. VDE>7MODIFY%%LIBRARY/DEF_PRIVILEGES=(BUILD,CREMOD)E %VDE-I-LIBMOD,%library& attributes%modified%in%databaseM" %VDE-I-COMMIT,%database% transaction%has% successfully& committedJInthisexample,thestandarddefault privilegesfornewMusersofthelibraryaremodifiedtoconsistoftheBUILD?BandCREMOD privileges.-ThelogmessagesconfirmKthatthelibraryhasbeenmodifiedandthatthedatabase/ transaction successfully completed. Ok2.p VDE>6pMODIFY%LIBRARY/REMARK="New&remark%string"E %VDE-I-LIBMOD,%library& attributes%modified%in%databaseM %VDE-I-COMMIT,%database% transaction%has% successfully& committedIoThisexamplemodifiestheremarkstringforthecurrentlibrary.!\%[]B\OMODIFYSCRIPT*]^MOModifiestheremarkstring associatedwithaVDEscriptinO(theVDE database.'ORequiresCRESCRP privilege.R_(OFormatOsMODIFYSCRIPTH`! O DescriptionEOsTheMODIFYSCRIPTcommandmodifiestheremarkstringLOfora specifiedVDEscriptintheVDE database.+VDEonlyQO$modifiesthescriptofthe specifiedtypethatbelongstothe'O|default developmentstream.a! WPOYoumustspecifya script-type qualifiertoselectthescriptFOyouwant modified..Seethe descriptionoftheCREATENO5SCRIPTcommandforan explanationofthe differenttypesofOOscriptsandhowscriptsareselectedusing script-typequali-POfiers.'Youmustalsospecifythescriptsegmentnumberunless'O>thedefaultvalueapplies.b! >OKeywordsusedwithinscriptsare documentedinQScriptO Keywords,+whilescript functionsareinScript Functions, Vand O5scripttypesarein5ScriptTypes.$5Forotherscript-relatedO commands,alsosee(CREATESCRIPT,DELETESCRIPT,OEXTRACTSCRIPT,MINVOKESCRIPT, andSHOWSCRIPT.nbDQQH!H!OO*bLO*bO:*b(P?/*bP?l*bO?*bM?0*bA? csO QualifiersOs/BUILDOO Specifiesthatthedefaultstream'sBUILDscriptbe modified.d O/COMPILE=mod-nameMO( Specifiesthatthedefaultstream'sCOMPILEscriptwiththeO specifiedmod-name&s specificationbe modified.e bO/CONFIRMO( /NOCONFIRM (default)IOControlswhetherVDEasksyoutoconfirmthatyouwantHOeachscript modified.)The/CONFIRM qualifiercausesVDENO2toprintamessageforeachscriptaskingwhetheryouwantPOthatscript modified.*IfyouanswerYES(orY),thescript'sQO attributesaremodifiedinthe database.'IfyouanswerNO(orJO<N),thescriptisnot modified.)The /NOCONFIRM qualifierPOcausesVDEtomodifythe specifiedscriptswithoutaskingforO confirmation.fO/COPY=mod-nameJO( Specifiesthatthedefaultstream'sCOPYscriptwiththeO specifiedmod-name&s specificationbe modified.g! O/CREATE_FACILITYRO( SpecifiesthatthescriptthatVDEinvokeswhenanewfacility,Oiscreatedshouldbe modified.h%O/DELETE_GENERATION=mod-nameDO( Specifiesthatthedefaultstream'sDELETE_GENERATION&Oscriptwiththe specifiedmod-name" specificationbemodi-Ofied.iO/DIFFERENCES=mod-nameFO( Specifiesthatthedefaultstream's DIFFERENCESscriptOwiththe specifiedmod-name& specificationbe modified.jO/FETCH=mod-nameKO( Specifiesthatthedefaultstream'sFETCHscriptwiththeO specifiedmod-name&s specificationbe modified.k%O/INSERT_GENERATION=mod-nameDO( Specifiesthatthedefaultstream'sINSERT_GENERATION&Oscriptwiththe specifiedmod-name" specificationbemodi-Ofied.lO/LINK=mod-nameJO( Specifiesthatthedefaultstream'sLINKscriptwiththeO specifiedmod-name&s specificationbe modified.mO/LOG (default)O(/NOLOGLOControlswhetherlogmessagesareprintedafterthescriptMOis modified.)The/LOG qualifiercausessuchmessagestobeHO2printedandthe/NOLOG qualifier suppressesthem.*TheseOOmessagesindicatethatthescripthasbeenmodifiedandthatCOthedatabase transactionhas committed successfully.nO/NEW_STREAM=fac-nameEO( Specifiesthatthedefaultstream's NEW_STREAMscriptOwiththe specifiedfac-name&| specificationbe modified.oO/NOKEEP=mod-nameLO( Specifiesthatthedefaultstream'sNOKEEPscriptwiththeO specifiedmod-name&s specificationbe modified.p! O/REMARK="string"QO( Specifiesanewremarkstringforthescript.)Thisstringre-JOplacestheremarkstringfromtheoriginalCREATESCRIPTBOcommandorfromapreviousMODIFYSCRIPTcommand.OO2Thequotedremarkstring,whichcanbeupto132 charactersKOlong,maycontainany explanatoryremarkaboutthescript:OthatyouwantstoredintheVDE database.qO/REPLACE=mod-nameMO( Specifiesthatthedefaultstream'sREPLACEscriptwiththeO specifiedmod-name&s specificationbe modified.rO/RESERVE=mod-nameMO( Specifiesthatthedefaultstream'sRESERVEscriptwiththeO specifiedmod-name&s specificationbe modified.KsK!O/SEGMENT=seg-numLO( Specifiesthesegmentnumberofthescripttomodify.*TheOseg-num; parameter specifiestheintegersegmentnum-QOber.*Ifyouomitthis qualifier,VDEmodifiesthescriptwithO2segmentnumber10.t O/SET_FACILITY=fac-nameGO( Specifiesthatthedefaultstream's SET_FACILITYscriptOwiththe specifiedfac-name&| specificationbe modified.uqO /SET_STREAMIO( Specifiesthatthedefaultstream's SET_STREAMscriptbeO modified.vO/STAGING=mod-nameMO( Specifiesthatthedefaultstream'sSTAGINGscriptwiththeO specifiedmod-name&s specificationbe modified.wO/UNRESERVE=mod-nameJO( Specifiesthatthedefaultstream's UNRESERVEscriptwithOthe specifiedmod-name& specificationbe modified.x KOExamples O1.G VDE>&MODIFY%SCRIPT/COMPILE=*.C/REMARK="New%remark&string"K %VDE-I-SCRPMOD,%script& information&modified&in&the%database?" script&to&compile%module& [CODE]*.C%(segment%10)Mj %VDE-I-COMMIT,%database% transaction%has% successfully& committed3 VDE>&SHOW%SCRIPT/FULL/COMPILE=[CODE]*.C? Script%to%compile%module% [CODE]*.C&(segment&10)BDB Script%added%to%database%onK 9-DEC-1989% 20:34:25.44ED Script%added%to%database%by%user%JONES%(John%Jones)&D Remark:&New%remark%stringb VDE>IThisexamplemodifiesthescripttocompileallCmod-J)ulesinfacilityCODEtohaveanewremarkstring.)TheIlogmessagesshowthatthescriptwas successfullymod->ified.*TheSHOW SCRIPT/FULLcommandshowsthat<2thedatabasecontainsthenewremarkstring.-`_a@OMODIFYUSER* QOModifiesoneormore attributesofthedatabaserecordofoneO(ormoreusers.&ORequiresCREUSR privilege.lBOFormat2OsMODIFYUSERNusername[, username...]PO ParameterOsusernameJOTheOpenVMSusernameoftheuserwhoserecordistobeKO$modifiedinthecurrentVDElibrary.)YoucanmodifymoreKO|thanoneuserrecordbyusingwildcard charactersintheJO username.+Thepercentsign( % )inausernamematchesKO-anysingle characterinthepositionitoccupiesandtheOasterisk( *@)matcheszeroormore charactersintheposi-OOtionit occupies.*The attributesofthoseuserrecordswhoseBO7 usernamesmatchthewildcardpatternare modified. FO Qualifiers-Os/AUTH_PRIVILEGES=(priv [,priv...])QO Specifiesanewsetof authorized privilegesthattheuserisDO$allowedtosetwiththeSET PRIVILEGEcommand.,TheQO| privilegelistyoucreatereplacestheuser'scurrent privilegeQOlist.( Therefore,youmustspecifyall authorized privilegesyou$O-wanttheusertohave.NLOEach parametertothis qualifiernamesasingle privilege.MOIfonlyone privilegeis specified,the parenthesesmaybeO5omitted.f,OForalistof privileges,seeTable3-5 ~inSET PRIVILEGES.*Fa?*F?mO/CONFIRMO( /NOCONFIRM (default)IOControlswhetherVDEasksyoutoconfirmthatyouwantIOeachuserrecord modified.(The/CONFIRM qualifiercausesLO2VDEtoprintamessageforeachusergivingtheusernameIOandaskingwhetheryouwanttomodifytheuserrecord.NOIfyouanswerYES(orY),theuserrecordis modified.,IfOO<youanswerNO(orN),theuserrecordisnot modified.)TheCO /NOCONFIRM qualifiercausesVDEtomodifytheuser5Orecordwithoutaskingfor confirmation. ! ,O/DEF_PRIVILEGES=(priv [,priv...])NO( Specifiesthedefault privilegeswhichareenabledeachtimeLOtheuserstartsanewVDEsession.+Eachdefault privilegeNO specifiedalsobecomesan authorized privilegefortheuser.SO2The privilegelistyoucreatereplacestheuser'scurrentprivi-TOlegelist.' Therefore,youmustspecifyalldefault privilegesyou$Owanttheusertohave.BPOEach parametertothis qualifiernamesasingle privilege.(IfPOonlyone privilegeis specified,the parenthesesmaybeomit-UO5ted.(Foralistofthe privilegenamesyoucanspecify,seethe#OSET PRIVILEGEScommand.! O/LOG (default)O(/NOLOGJOControlswhetherlogmessagesareprintedaftertheuserKOrecordsare modified.)The/LOG qualifiercausessuchmes-EO2sagestobeprintedand/NOLOG suppressesthem..TheLOmessagesindicatethattheuserrecordshavebeenmodifiedNOandthatthedatabase transactionhas successfully committed.I KO/NAME="string"OO( Specifiesafullnamefortheuser.)Thequotednamestring,POwhichcanbeupto40 characterslong,shouldcontainanewOOfullnamestring(firstname,middleinitial,andlastname)O2fortheuser.! g,O/NOTIFY=(username[,username...])0O(/NONOTIFY[=(username[,username...])]ROThe/NOTIFY qualifier specifiesalistofuserstonotifyeachIOtimethe specifieduserreplacesamoduleintotheVDEOO2library.)VDEappendstheseuserstothe specifieduser'sex-+Oisting notificationlist.)Each=username parametergivestheLOOpenVMSusernameormailaddressofauserwhoshouldbeQO<notifiedbymailmessageeachtimethe specifieduserreplaces(Oamoduleintothelibrary.! aOEach username7 parametercanspecifytheusernameofaFOuseralreadyrecordedintheVDE database,aOpenVMSDO5mailaddresswithoneormorenodenames(suchasMO NODE::SMITH),amail forwardingalias,oradefinedlogicalXOnameboundtoalistofuserstonotify.'IfyouspecifyalogicalLO>name,keepinmindthatthelogicalnamemustbedefinedROwhenitislaterusedtosend notification messages.(ItshouldSOthusbeagrouporsystemlogicalnameoralogicalnamethatTOHisinsomeotherwaydefinedforallusersoftheVDElibrary.WMOThe /NONOTIFY qualifier specifiesthatalistofusersal-LOreadyonthe specifieduser's notificationlistberemoved/O5fromthat notificationlist.(Each5username5 parametergivesIOtheOpenVMSusernameormailaddressofausertore-BOmovefromthe notificationlist.)IfyouomittheusernameEO> parameters,VDEremovestheentire notificationlist. NOOIfyouspecifyboth qualifiers,VDEremovestheusersspeci-NOfiedwiththe /NONOTIFY qualifierfromthe notificationlistOO5beforeaddingtheusers specifiedwiththe/NOTIFY qualifier.%OIfyouspecifyonlyoneusername!G parameterwitheitherDO qualifier,youmayomitthe surrounding parentheses.q! GO/REMARK="string"TO( Specifiesaremarkstringtobestoredfortheuser.'ThequotedNOremarkstring,whichcanbeupto132 characterslong,mayHOcontainany explanatoryremarkabouttheuserthatyouQO2wantstoredintheVDE database.'Thisstringreplacesthere-FOmarkstringfromtheoriginalCREATEUSERcommandorEOfromanypreviousMODIFYUSERcommand.( TypicallythePO<remark describestheuser's affiliationorfunctionwithintheO organization.! r.O/REVIEWER=(username[,username...])2O(/NOREVIEWER[=(username[,username...])]POThe /REVIEWER qualifier specifiesalistof reviewersforallOOchangesreplacedintotheVDElibrarybythe specifieduser.MO2VDEappendsthese reviewerstotheuser'sexistingreviewerOlist.)Eachusername/n parametergivestheOpenVMSuser-POnameofauserwhoshouldreviewallchangescreatedbytheOO< specifieduser.'ThenewreviewermustalreadyberecordedinLOtheVDE database.)Whenthe specifieduserreplacesamod-NOuleintotheVDElibrary,VDEnotifiestherevieweroftheLOEchangebymailmessage.*Ifthe replacementisqueued,theJOreviewershouldthenreviewthequeued replacementbeforeQOitis performed.'Ifthe replacementis immediate,VDEnotifiesNOOthereviewerofthenewmodule generationthatwascreated,OOandheorshemaytheninspectthat generation.(Thisquali-QOfiercanbeusedtosetup``buddy systems''wheretwousers.OYalwaysrevieweachother'scode. WMOThe /NOREVIEWER qualifier specifiesthatalistofexistingKO reviewersforthe specifieduserberemovedfromthere-O5viewerlist.(Each5username(v5 parametergivestheOpenVMSIOusernameofauserwhoshouldberemovedfromthere-+Oviewerlist.,Ifyouomitthe9username parameters,VDE?O>removestheentirereviewerlistfortheuser.NOIfyouspecifyboth qualifiers,VDEremovestheusersspec-GOifiedwiththe /NOREVIEWER qualifierfromthereviewerKO5listbeforeaddingtheusers specifiedwiththe /REVIEWERO qualifier.%OIfyouspecifyonlyoneusername!G parameterwitheitherDO qualifier,youmayomitthe surrounding parentheses.! oO/USERNAME=usernameIO( SpecifiesanewOpenVMSusernamefortheuser.)ThenewLOusernamecanbeupto12 characterslongandmustfollowKOnormalVDEnamesyntax.(IfyouchangeausernameintheLO2VDEdatabaseyoushouldalsoremembertohaveyoursystemJOmanagerchangeitinthesystemUser AuthorizationFile.QOAftertheusernameischanged,youmustrefertotheuserbyLO<thenewnameinall subsequentVDEcommandsandtheuser@Omustaccessthedatabasewiththenew username.a 7OExamples O1. VDE>GMODIFY%USER&SMITH&/USERNAME=BROWN% /NAME="Jane%S.%Brown"U %VDE-I-USERMOD,% information%for&user%BROWN%modified%in%the&databaseM %VDE-I-COMMIT,%database% transaction%has% successfully& committedCInthisexample,JaneSmithhaschangedhername.CTheMODIFYUSERcommandisusedtoenterhernewD<OpenVMSusernameandfullnamestringintotheVDEG database.) Thereafter,JanemustaccesstheVDElibraryFasuserBROWNandshemustbereferredtoasBROWNBFon subsequentVDE commands.*Thelogmessagescon-Ffirmthatheruserrecordwasmodifiedandthatthe9database transaction successfully completed. Oo2. VDE>LMODIFY%USER&DOE%/REMARK="OpenVMS& Documentation% Supervisor"%- _VDE>'/DEF_PRIVILEGES=BUILD%/NOLOG& VDE>AHereJohnDoehasbeenpromotedto Documentation? Supervisor.(TheMODIFYUSERcommandchangeshisIFremarkstringtoindicatehisnewroleandreduceshisNdefault privilegestoonlytheBUILD privilege.'Inthisex-Iample,the/NOLOG qualifier suppressesthelog messages.,tg@eh;gORESERVE*hwi! MPO Retrievesthelatest generationofoneormoresourcemodulesIO(fromagiven developmentstreamandmarksthosemodulesOOasreservedbythecurrentuser.(Related reservationscanbe?Ogroupedand manipulatedtogetherusing sessions.&OuRequiresRESREP privilege.sjIOFormat9OsRESERVEMmod-name[, mod-name...]' ["remark"]k O ParameterOsmod-nameQO SpecifiesasourcemoduleinthedefaultstreamorthestreamJO$ specifiedwiththe/STREAM qualifiertobereservedfromKO|thelibrary.,Themodulenameconsistsofanoptionalfa-IOcilitynameenclosedinsquare brackets,amodulename,KO-andanoptionaltypenameprecededbyaperiod(suchasHO[FACIL]MOD1.MAR).Ifyouomitthefacilityname,sourceNOmodulesfromthedefaultfacilityare reserved.*IfyouomitJO7thetypename,allsourcemoduleswiththegivenmodule8Onameinthegivenfacilityare reserved."lIOYoucanreservemorethanonemodulebyusingwildcardJO charactersinanyofthethree componentsofthemoduleMO5name.*Thepercentsign( % )inanamematchesanysin-POgle characterinthepositionitoccupiesandtheasterisk( c* )OOmatcheszeroormore charactersinthepositionit occupies.GO>VDEreservesthesourcemoduleswhosenamesmatchtheOwildcardpattern.m _IOYoucanalsoreservemultiplemodulesby specifyingtheKOnameofasourcegroupinsteadofamodulename.*SourceFO5groupsarecreatedwiththeCREATEGROUPcommand.(IfNOyouspecifyagroupname,eachmodulethatisamemberof7Othegroupisreservedfromthelibrary.n O"remark"OO( Specifiesaremarkstringforthe reservation.) SpecifyingtheOremarkA parameteris equivalentto specifyingthe/REMARK2O qualifieraftertheRESERVEkeyword.fo <O DescriptionGOsTheRESERVEcommandcopiesthelatest generationofaQOmoduleina specifiedstreamtoyourdefault directory(ortoNO$anotherlocationifyou specifiedthe/OUTPUT qualifier)andAO|marksthemoduleas ``reserved''inthatstream.bp8JOAfteryouhavemodifiedthemodule,youcanreturnyourAOchangestothelibrarywiththeREPLACEcommand.GO5Alternatively,youcancancelthe reservationwiththeBO UNRESERVEcommand;nomodule modificationswillbe&Oenteredintothelibrary. h_UkNote h_AThemodule reservationwillbereleasedwiththe5H UNRESERVEcommand,bytheREPLACEcom-@mand(whenqueued-replacementarenotenabledon<thestream),orbythePERFORMREPLACEcom-?Rmand(whenqueued-replacementisenabledonthestream).)SeetheDREPLACE, UNRESERVE,SHOW REPLACEMENT, and*SHOW RESERVATION[ commands. *pDm?*pm? npDooYY*p*e?qalHOBydefault,VDEdoesnotallowyoutoreserveamod-MOulethatisalreadyreservedbyanotheruser(or yourself)BO5forthesame developmentstream.0However,youcanGOreserveanalreadyreservedmoduleifyouspecifytheexisting reservationsallallow concurrent reservations.,IfOOyoudonotwishtooverridea reservation,youcanusetheIO/QUEUE qualifiertorequest notificationwhenthemodule/OHbecomes availablefor reservation.r ^MOWhenyoureservea generationofamodulefromaVDEli-RObrary,thefilethatisplacedinyour directoryhasthesameLO5creationandrevisiontimes,recordformat,andrecordat-UOtributesasthefilethatwasusedtocreatethe generationthatOyouare reserving.~s THOToreservemodulesonbehalfofanotheruser,usetheGO /USERNAME qualifiertospecifytheOpenVMSusernameofPO5thatotheruser.'Themodulesarethenreservedinthespeci-HOfieduser'sname.(YoumusthavetheUSERNAME privilege-Otousethe /USERNAME qualifier.~t! T>OFor informationoncreatinganewmodule,seeCREATEOMODULE.9 Dependingonthequeued-replacementsettingIO5ofthetargetstream,youmayneedtoissueaREPLACE.OcommandafterCREATEMODULE;see,REPLACE. The?O behaviouroftheCREATEMODULEandtheRESERVENO>commandsare identical,savefortheinitialabsenceoftheGOmoduleinthelibraryfortheCREATEMODULE,andtheROinitialpresenceofthemoduleinthelibraryfortheRESERVE.ntDH]H]OO*t,P?2uDOOnqueued-replacementstreams,modulescreatedviaaAOCREATEMODULEandmodulesreservedviaaRESERVEHO5canbecombinedintoasingle replacement,andcanbe;Ocombinedintoasingle reservation /SESSION.vO QualifiersOs/CONFIRMO /NOCONFIRM (default)IO$ControlswhetherVDEasksyoutoconfirmthatyouwantCO|eachmodule reserved.-The/CONFIRM qualifiercausesHOVDEtoprintamessageforeachmodulethatyouhaveIO- specifiedaskingwhetheryouwanttoreservethecorre-KOspondingmodule generation.*IfyouanswerYES(orY),itNOis reserved.-IfyouanswerNO(orN),itisnot reserved.DO7The /NOCONFIRM qualifiercausesVDEtoreserveeach@O specifiedmodulewithoutaskingfor confirmation.w O/FOLD[=fold-ident]KO( Specifiesafoldrecordtobe cancelledwhenthismoduleIO reservationis eventuallyreplacedintothelibrary.'Thefold-OidentK? parametergivesthefold identifierofafoldrecordforMO2themodulebeingreservedandforthestreaminwhichtheMO reservationisdone.(WhenyoulaterreplacethemoduleandIOVDEperformsthe replacement,VDEwillcancelthisfold@O<recordfromtheVDE database.'YoucanomittheK< fold-identPO parameterifthereisonlyonefoldrecordforthe specifiedMOmoduleandstream.)Youcanusethe/FOLD qualifierifyouOOEare modifyingthemoduletosatisfyanexistingfoldrecord.LOYoucanalsospecifythe/FOLD qualifierwiththeREPLACE2Ocommandtoachievethesameeffect.jx @O/HISTORY[="string"]O( /NOHISTORYKOThe/HISTORY qualifier specifiesthatCMShistoryinforma-VOtionistobeincludedinthefileplacedinyour directory.(ThePO2historyofthemoduleliststhe generationsthatprecededtheKOcurrent generationofthemodule.'Each generationproducesQOonelineofhistory informationintheoutputfile.+ThislineIO<givestheCMS generationnumber,username,date,time,9Oandremark associatedwiththe generation.y! kSOThequotedstring specifiestheformatofthehistoryline.'TheLOquotedstringmustcontainthe characters#Hor#B(lowerLO5caseisallowed)andcancontainotherprinting charactersOO(suchascomment delimiters).'EachhistorylineisformedbyOO insertingthehistory informationwhereyouspecify#Hor#BRO>inthehistorystring.'Ifyouspecify#H,thehistoryinforma-XOtionisinsertedattheendofthefileandifyouspecify#BitUOisinsertedatthe beginningofthefile.(Toincludea quotationEOHmarkintheoutputhistorystring,typeittwice( H""H).(Toin-VOcludeanumbersign( # )intheoutputhistorystring,typeit#Otwice( ## ).'Ifthestring1 parameterisomitted,VDEusesthe-ORmodule'sdefaulthistorystring.zNHOThe /NOHISTORY qualifier specifiesthathistoryinforma-ROtionisnottobeappendedtotheoutputfileplacedinyourO5 directory.h{ >JOIfthe/HISTORYand /NOHISTORY qualifiersarebothomit-FOted,theRESERVEcommand generateshistory informationQO5onlyifthehistory attributeisenabledforthemodule.*ThisCO attributeissetwiththeCREATEMODULEorMODIFYOMODULEcommand.| W|MOIfthe history-notes attributefortheVDElibraryisdis-AOabled,theRESERVEcommandwillnotgenerateCMSLO5history informationintotheoutputfileandwillnotac-IOceptthe/HISTORY qualifier..Seethe descriptionoftheCO/HISTORY_NOTES qualifiertoCREATELIBRARYformoreO> information.} Z#O/IDENTIFICATION=res-identLO( Specifiesa reservation identifierforthenew reservation.NOEach reservationhasaunique reservation identifiersothatFOyoucan distinguishbetweenmultiple concurrentreser-LO2vationsofthesamemodulebythesameuser.+Bydefault,COtheRESERVEcommandassignsauniquenumericiden-UOtifiertoeach reservation,suchas``1'',``2'',andsoon.*TheHO</IDENTIFICATION qualifier overridesthisdefaultandal-TOlowsyoutoselecta reservation identifierofyourchoice,such%Oasamnemonicname.+The= res-ident parameter specifiesROEthe reservation identifier.)Itcanbeupto39 characterslong/OandmustfollowVDEnamesyntax.~O/LOG (default)O(/NOLOGKOControlswhetherlogmessagesareprintedaftereachmod-LOule generationis reserved.*The/LOG qualifiercausessuchHO2messagestobeprintedand/NOLOG suppressesthem.*TheKOmessagesindicatethatthemoduleshavebeenreservedandIOthatthedatabase transactionhas successfully committed. ^O/MERGE=stream-nameO(/MERGE=(gen-expr)JOControlswhetheranother generationofthemodule(calledLOthemerge generation)istobemergedwiththe generationNO2thatisbeingreserved(calledthe retrieved generation).+If9Oyouspecifythe/MERGE qualifierwiththen stream-nameIO parameter,themerge generationisthelatest generationMO<ofthemoduleinthe specifiedstream.-Ifyouspecifythe&O/MERGE qualifierwiththe7gen-expr! parameterenclosedinNO parentheses,themerge generationisthe generationwiththeFOE specified generation expression(forexample, ``2A3'').! aGOWhenyouspecifythe/MERGE qualifier,VDEmergestheQOlinesofthe retrieved generationwiththelinesofthemergeOO5 generationanddeliversthemergedtextasasinglefiletoQOyouroutput directory.)Thefilethatisplacedinyourdirec-NOtoryhasthecurrentcreationandrevisiontimes.(ThemergePO> generationcannotbeonthesamelineofdescentasthere-QOtrieved generation.'WhenthereisaconflictbetweenblocksofSOoneormorelines,VDEincludesthe conflictinglinesandflagsOHthe conflict.\ 2OOVDEusesthecallable interfacetoCMStoprovidethemergeOO capability.(Foradetailed explanationofhowtwo generationsIO5aremergedandhowCMS(and thereforeVDE)treatscon-KOflictsbetweenthe generations,seetheCMSdocumentation.rO /NOCONCURRENTIO( SpecifiesthatthemodulecannotbereservedbyanotherLOuserwhileyouhaveit reserved.*Youmustreplaceorun-OOreservethemodulebeforeotherscanreserveit.*Bydefault,JO2VDEallows concurrent reservationsifthemodulehastheO concurrent) attributeset.= KO/NOTES[="string"]O(/NONOTESOOThe/NOTES qualifier specifiesthatCMSnotesaretobeap-ROpendedtothelinesoftheoutputfile.)CMSnotesindicateinEO2whatmodule generationeachsourcelinewascreated.! kROThequotedstring specifiestheformatofthenote.'ThequotedKOstringcancontaintext (includingthe appropriatecommentMO5 delimiter)andthe characters#Gor#g.'TheCMS generationPO expressionofthe generationinwhichthelinefirstappearedPOininsertedwhereyouspecify#Gor#g.(The resultingstringTO>isappendedtotheendoftheoutputline.'Toincludeaquota-IOtionmarkintheoutputnotesstring,typeittwice( "").*ToROincludeanumbersign( # )intheoutputnotesstring,type'OHittwice( ## ).)IftheGHstring,GH parameterisomitted,VDEusesPOthemodule'sdefaultnotesstring.)(Yousetthedefaultnotes?OstringwiththeCREATEMODULEorMODIFYMODULEOR command.) MOThe/NONOTES qualifier specifiesthatCMSnotesarenottoSObeappendedtothelinesofthefileplacedinyour directory.X.FOIfthe/NOTESand/NONOTES qualifiersarebothomit-FOted,theRESERVEcommand generatesCMSnotesonlyifPO5thenotes attributeisenabledforthemodule.)This attribute@OissetwiththeCREATEMODULEorMODIFYMODULEOcommand. mROIfthe history-notes attributefortheVDElibraryis disabled,HOtheRESERVEcommandwillnotgenerateCMSnotesinfor-NO5mationintotheoutputfileandwillnotacceptthe/NOTESDO qualifier..Seethe descriptionofthe/HISTORY_NOTESAO qualifiertoCREATELIBRARYformore information.O /NOOUTPUTPO( Specifiesthatthereserve operationistobe performedalongMOwithanyhistory processinganderrorcheckingbutthatno,Ooutputfileistobecreated.^ U4$O/OUTPUT=file-specificationLO(DirectsVDEtowritethereservedmoduletothe specifiedTOfile.'Ifyouomitthe directoryfromthefilespecification,VDETOwritesthefiletoyourdefault directory.*IfyouomitthefileLO2nameorfiletype,VDEusesthemodulenameandtypebyFOdefault.)Ifyouomitthe/OUTPUTand /NOOUTPUTqual-NOifiers entirely,VDEcreatesafileinyourcurrentdefaultthemodule.! pROIfthe history-notes attributefortheVDElibraryis disabled,HOtheRESERVEcommandwillnotgenerateCMSnotesinfor-QO5mationintotheoutputfileandwillnotacceptthe /POSITIONDO qualifier..Seethe descriptionofthe/HISTORY_NOTESAO qualifiertoCREATELIBRARYformore information.^4 O/PROPAGATE=stream-nameO( /NOPROPAGATEKOThis qualifiercontrolsthedefaultmodule propogationbe-FOhaviourofthe subsequentand associatedREPLACEcom-KO2mand,anditcontrolsthe reservation ``shadow''forthis"O particular reservation.gGOWhen specified,the /PROPAGATE qualifiercausesVDEtoLO propagatethechanged module(s)onlyasfarasthestreamO5 specifiedbythe5 stream-name5 parameter,but 5 not5toanyKO successorsofthat stream-change propagationthusstopsat!Othe specifiedstream.EOThe /NOPROPAGATE qualifiercausesVDEtodisableallHO propagateofthechangebeyondthecurrentstream(theIO5defaultstreamorthestream specifiedwiththe/STREAMO qualifier).NGOIfyouomitboth qualifiers,theREPLACEcommandwillHO propagatethechangedmodulestoall successorsoftheO5currentstream.WIOBecausethese qualifiers determinewhatstreamsasubse-GOquentREPLACEcommandwillaffect,theyalso determineFO5what streams-the``shadow''-thenewmodule reservationsMOcover.)A reservationthatcoversfewerstreamsallowsotherOOuserstoreservethesamemoduleinotherstreamswithless#O> likelihoodof conflict.mC1OFor informationon propogation,seefREPLACE.*fF?7  O/QUEUEPO( SpecifiesthatVDEshouldqueuea reservationrequestforyouQOifyoucannotreserveamodulebecauseitisalreadyreservedKObyanotheruser.,Ifthe requestedmodulecanbereservedMO2now,themoduleisreservedandthis qualifierhasnoef-OOfect.*However,ifthemoduleisnot available,VDEqueuesaQO reservationrequestforitinits database.(WhentheuserwhoJO<ownsthecurrent reservationlaterreplacesor unreservesKOit,VDEsendsyouamailmessagesayingthatthemoduleMOisnow available.)Toactuallyreservethemodule,youmustFOEthenenteranotherRESERVEcommand.*IfmultipleusersOOhavequeued reservationrequestsforthesamemodule,allofKOthemarenotifiedwhenthemodulebecomes available.(TheyJOOmustthendecideamong themselveswhoshouldreservetheOmodulefirst.dEOTodisplayqueued reservation requests,usetheSHOWO RESERVATIONcommand.fK<O/REMARK="string"QO( Specifiesa characterstringtobestoredinthedatabaseforLOthis reservation,usually explainingwhythe reservationisIOmade.,Theremarkisenclosedin quotationmarks.,Ifnocombinedintothesamesession.! fO/STREAM=stream-nameNO( Specifiesthatmodulesbereservedinthe developmentstreamOgivenbythe% stream-name"m parameter.-TheRESERVENOcommandfetchesthelatest generationofeach specifiedmod-OO2uleinthatstreamandrecordsthateach reservationbelongsQOtothatstream.*Ifthis qualifierisomitted,modulesarere-QOservedinthedefault developmentstream.)Ifthis qualifierisLO<omittedandnodefaultstreamisdefined,VDEpromptsyou!Oforthestreamname.7K O/USERNAME=usernameCRESERVE%FOO/REMARK="Fix&problem%reported%in%QAR&23"T %VDE-I-FETCHED,% generation%[FACIL]FOO.MAR;7(5A2)%fetched%from&libraryA" %VDE-I-OUTFILE,%output&file%is%DEV$:[MYDIR]FOO.MAR;cj %VDE-I-RESERVED,&module% generation&[FACIL]FOO.MAR;7(5A2)%reserved%from&stream%MAINM %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE>ChThiscommandreservesallsourcemodulesnamedFOOOinthedefault facility,FACIL.Inthiscase,thereisonlyIonesuchmodule,FOO.MAR.ThismoduleiscopiedtotheLruser'sdefault directoryandismarkedasreservedintheVDE database. OC2.H VDE>/HRESERVE%MOD1%/IDENTIFICATION=BUGFIXN Please%supply&required& information&for%module%[FACIL]MOD1.*;0:* Enter%the% reservation%remark: 4FIX%ACCESS& VIOLATIONS  %VDE-I-FETCHED,% generation%[FACIL]MOD1.PAS;9(9)%fetched&from%libraryBh %VDE-I-OUTFILE,%output&file%is%DEV$:[MYDIR]MOD1.PAS;b %VDE-I-RESERVED,&module% generation&[FACIL]MOD1.PAS;9(9)&reserved&from%stream&V6.0M %VDE-I-COMMIT,%database% transaction%has% successfully& committed@ VDE>@SHOW% RESERVATION2 Reservation%BUGFIX%of%[FACIL]MOD1.PAS? SMITH$  29-DEC-1989%V6.0 VDE>;>TheRESERVEcommandreservesmoduleMOD1.PASFinfacilityFACILandassignsthe reservationidenti-JfierBUGFIXtothe reservation.*(Ifyoudonotusethe<H /IDENTIFICATION qualifier,theRESERVEcommandI assignsanumeric reservation identifiertothereserva-< tion.)*TheSHOW RESERVATIONcommand indicatesER thatthemoduleisreservedwiththeBUGFIXidenti-G fier.+This identifiercanlaterbeusedonaREPLACE@ or UNRESERVEcommandtoidentifythis particular[  reservation. O 3. VDE>@ RESERVE/SESSION=SPEEDUP& A.REQ,B.REQ&"Remark%string"R! %VDE-I-FETCHED,% generation%[FACIL]A.REQ;11(11)&fetched%from%library?i %VDE-I-OUTFILE,%output&file%is%DEV$:[MYDIR]A.REQ;P %VDE-I-FETCHED,% generation%[FACIL]B.REQ;7(7)%fetched&from%library? %VDE-I-OUTFILE,%output&file%is%DEV$:[MYDIR]B.REQ;aA %VDE-I-RESERVED,&module% generation&[FACIL]A.REQ;11(11)%reserved%from%stream%MAIN_ %VDE-I-RESERVED,&module% generation&[FACIL]B.REQ;7(7)&reserved&from%stream&MAINM %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE>DThisexampleshowshowmodule reservationsaremadeCmembersofa reservationsession.+Thiscommandre-F8servesmodulesA.REQandB.REQinfacilityFACILandEmakesthe resulting reservationsmembersofareser-@vationsessioncalledSPEEDUP.ThesemodulescanLBlaterbereplaced(or unreserved)asaunitby specifyingJthesessionnameinsteadofthenamesofthe individualmodules.zl4kmDOScriptKeywords*NOThe followingkeywordsareusedinVDEbuildscriptsstored!O(intheVDE database.'ORequiresCRESCRP privilege.eS;OFormatOsEMITOEXITO:FETCHe! ;O DescriptionLOsScriptsareusedtoaddvarious user-defined extensionstoFOvariousVDE functionsand commands.*VDEinvokesvari-GO$ousscriptsatvarioustimesduringVDEprocessing-see$ScriptO|Types.9|forfurther informationonthis.n:D444OO4 kMOScriptsofvarioustypesarerecordedintheVDE database. OAscriptCisasequenceofkeywordsintheVDEscriptlan-LO5guagethatVDEcanexecutetocreateaDCLcommandfile.JOVDEcantheninvokethatDCLcommandfileinasubpro-NOcesstoperformtheactionofthescript.+VDEusesscriptsJO>toperformmany differentkindsofactions.+Forexample,SOVDEuses ``compile scripts''tocompilemodulesinabuildjob.OO Similarly,ituses ``new-stream scripts''topopulatethedi-MOH rectoriesofanewstreamwithfileswhenitperformstheBOCREATESTREAMcommand.(TherearemanyotherkindsPOofscripts,all distinguishedbythekeywordsor circumstances-ORthatcausethemtobeinvoked._ 5MOTheprimarypurposeofVDEscriptsistoinsertnamesandNO directoryspecificationsfromtheVDEdatabaseintotextyouJO5specifytogenerateDCLcommandfilesthatperformvari-SOousactions.(AVDEscriptisthusamixtureofplaintextandNO invocationsof functionsthatretrievenames(suchasmoduleNO>names,typenames,andfacilitynames)and directorystringsNO(suchasthenamesoffacilitysubdirectories)fromtheVDEO database.D! KOSinceyoudefinescripts,youdefinehowVDEshouldper-MOformthe correspondingactions.'Forexample,youdecidehowLO5aPascalmoduleiscompiledbecauseyoudefinethePascalRO compilationscript.' Similarly,youcandefineascriptthatde-HOfines auxiliaryactionsoftheREPLACEcommand.*ScriptsRO>thusletyoumakepolicy decisionsforyourownproject,whileJOVDEprovidesthe mechanismsthat implementyour policies.D OOWhenanew developmentstreamiscreated,allscriptdefini-POtionsfromtheparentstreamarecopiedtothechildstream.RO5If modified,thescript definitionsthenevolve independentlyin)Othetwo developmentstreams.! NNOAVDEscriptisasequenceoftextlinesthatcontainVDELOscript keywords.&ThereareonlythreeVDEscript commands:#O5EMIT,FETCH,andEXIT.LOIn addition,ascriptmaycontainblanklinesandcommentPOlines.*The exclamationpoint( ! )isthecomment character.NO5VDEignoresanytextonascriptlineafteran exclamationMOpoint,providedthe exclamationpointisnotwithinquotes.DOAscriptkeywordcommandmaybe continuedfromonePO>linetothenextbyendingthefirstlinewiththesequenceO space-minus(&- ).sIIOVDEacceptsthe followingkeywordcommandsinascript:c9 `mmEMIT m string[, string...]' IWEmitsonelineintotheDCLcommandfile.'Thiskeyword"command evaluateseachwstring"w parameter, concatenatesNthe resulting characterstringsintoasinglelineoftext,MaandwritesthislineoftexttotheDCLcommandfilebe-ing generated.)Eachstring' parametermaybeaquotedM characterstring,an invocationofascript function,ora"k directorysymbolname.}SAWIftheEMITcommand parametercontainsspacesorJother characters,thestringmustbeenclosedinapairJofquoting characters.*(eg:*IfthecommandisatypicalBaDCLcommandandcontainsblanksandvariousotherF characters,itmustbequoted.),Validquotingcharac-:terpairsincludethe double-quotepair:,( ")and( " %),Skandthe double-caretpair:((  )and(  ).(Useoftheend-Hquoting characterwithinthestringis permissible,butHrequiresthatthe characterbedoubled.,(eg:,adouble-Jtquote characterwithinthestringis specifiedbydoubleAdouble-quotes;bytwo consecutivedouble-quotes:'( "" Q).) +OWIfthe parameterisan invocationofascript function,youEmustspecifythefunctionnameorthefunctionnameIfollowedbya parenthesizedlistoffunction parameters.JaVDE evaluatesthefunctiontoproducea characterstringGthatis concatenatedtothecurrentDCLcommandline.D(Nextsectionliststhe availablescript functions.)+}IWIfthe parameterisa directorysymbolname,VDElooksFuptheOpenVMS directory specification associatedwithEthe directorysymbolfromtheVDEdatabaseandcon-Ha catenatesthatstringtothecurrentDCLcommandline.DOpenVMS directorysymbolsaredefinedusingtheSET DIRECTORYcommand.  ~OWToexitfromthe generatedDCLinthescript,issueoneof+the followingscript commands:$V EMIT&$&GOTO% VDE$ERROR& EMIT&$&GOTO% VDE$SUCCESS EMIT&"$&EXIT" `eeEXITL "JWExitsfromthescriptduringscript execution.( SubsequentFscriptcommandsarethusnotexecutedtoproduceDCLE commands.)(NotethattheEXITkeyworddoesnotcre-BaateanEXITcommandintheDCLcommandfile;itKonlystopsscript execution.(Seethe documentationontheFEMITscriptcommandfor informationon generatingthe@kproperDCLexitsequencefromwithinascript.) `FETCH  string[, string...]/ HWFetchesamodule generationfromtheVDElibrary.'This"keyword evaluateseachJstring"J parameter, concatenatesNthe resulting characterstringsintoasinglelineoftext,Naand interpretsthelineasthe qualifiersand parametersto'aVDEFETCHcommand.)Each}string~ parametermayJbeaquoted characterstring,an invocationofascript4k function,ora directorysymbolname. WYourWstring6W parametersshouldgeneratethefullVDE@FETCHcommandyouwant performedexceptfortheFETCHkeyword.+The"string!# parameterscangener-Faateall qualifiersand parametersthattheVDEFETCHJkeywordaccepts,andcanusescript functionstoincludeEstringssuchasmodulenames,streamnames,anddi-Gkrectoryspecifications.*The resultingcommandstringisKparsedandexecutedasifitbelongedtoanormalFETCHAkeywordenteredfromthe terminal.+UsetheFETCHFtkeywordwhenyouwantVDEtofetcha generationdi-Irectly,withoutusingaDCLcommandfile,andyouwantF%it performedinthesamedatabase transactionasthe-~ operation performingthescript.! 5NWBydefault,VDEfetchesthelatest generationofthespeci-Nfiedmoduleinthestreamforwhichthescriptisinvoked.GYoucanoverridethisdefaultby generatinga/STREAMFa qualifier, /GENERATION qualifier,ora generationnum-EberfortheFETCHkeyword.&ThescriptFETCHkeywordJ suppresseslogmessagesbydefault,butyoucanoverrideMkthisdefaultby generatinga/LOG qualifier.' Otherwise,allJ parameters, qualifiers,anddefaultsarethesameasforBtheregularVDEFETCHkeyword described elsewhere.WIfaqWstring;rW parameterisaquoted characterstring,the;stringmustbeenclosedindoublequotes( ").)Adouble-Gquote characterwithinthestringis specifiedbytwo(a consecutivedoublequotes( a""$ a).+VDE concatenatestheAquotedstringtothecurrentFETCHkeywordline. +OWIfthe parameterisan invocationofascript function,youEmustspecifythefunctionnameorthefunctionnameIfollowedbya parenthesizedlistoffunction parameters.JaVDE evaluatesthefunctiontoproducea characterstringIthatis concatenatedtothecurrentFETCHkeywordline.D(Nextsectionliststhe availablescript functions.) +IWIfthe parameterisa directorysymbolname,VDElooksFuptheOpenVMS directory specification associatedwithEthe directorysymbolfromtheVDEdatabaseandcon-Ja catenatesthatstringtothecurrentFETCHkeywordline.DOpenVMS directorysymbolsaredefinedusingtheSET DIRECTORYcommand.7!  NOWhen executingascript,VDEexecutes successivescriptkey-LOwordsfromthescriptuntilit encountersanEXITkeywordHO5ortheendofthescript.,VDEexecutesFETCHkeywordsKO immediatelyastheyare encountered.*VDEwritesalllinesFO generatedbyEMITkeywordstotheoutputDCLcommandSO>file.'Attheendofthescript,VDEexecutesthatcommandfileGOina subprocesstoperformtheactionofthescript.\! j2 O SelectionofScriptsMO4Manytypesofscriptsareinvokedwhenacertain operationSOmustbeappliedtoaspecificmodule,suchas compilingorre-OOservingthemodule.'Forsuch operations,VDEmustselecttheUO>scriptthatis appropriatetothemodule.&ThetypeofthescriptPOisofcoursetheprimary selection criterion,butevenforaQOgiventype, differentscriptsareneededfor differentmodules.MOGThescriptthatcompilesaFortranmoduleisnot appropri-TOateforaCmodule,forexample,andthescriptthatlinksone0Oimagecannotlinkanother.+(ScriptP Functionscontainsthe2OQtypesofscripts supportedbyVDE.)*dNO kJOTo accommodatesuch situations,VDEletsyouspecifyhowIOscriptsareselectedbasedonthemodulename.-YoucanRO5specifythatascriptshouldbeusedonlyforaspecificmod-UOule,forallmodulesofacertaintypeinagiven facility,forSOallmodulesofagiventype regardlessof facility,orforallOO>modules regardlessoftypeor facility.(WhenyoucreatesuchTOascript,youspecifythescripttypewitha qualifier,suchasGO/COMPILEor /RESERVE.YoualsospecifythemodulestoIOHwhichthescriptappliesthrougha module-name parameterKOtothe qualifier./A restrictedformof wildcardingdeter-POmineswhatmodulesthescriptcanbeusedfor.'The following4OR module-namespecificationsareallowed:M# `mm[FACIL]MOD.TYP^KWIfyoufullyspecifythemodulename,thescriptappliesJonlytothatspecificmodule.*Forexample,the qualifierC/LINK=[CODE]X.EXEsaysthatthescriptcanonlybeJausedtolinkimageX.EXEinfacilityCODE.IfyouomitMthefacilityname,thecurrentdefaultfacilityisassumed. `99[FACIL] E*9.TYP! XLWIfyouspecifythefacilitynameandtypenamebutspec-ifyanasterisk( *;E)inplaceofthemodulename,thescriptRappliestoallmodulesofthattypeinthat facility.'Forex-2aample,the qualifier/COMPILE=[FACIL] m*a.CsaysthatPthescriptcanbeusedtocompileallCmodulesinfacilityLFACIL.Ifyouomitthefacilityname,thecurrentdefault kfacilityisassumed. ` [ * ] $*I.TYPO %JWIfyouspecifythetypenamebutspecifyanasterisk( Vc* W)Kinplaceofboththefacilitynameandthemodulename,Rthescriptappliestoallmodulesofthattypeinallfacili-:aties.'Forexample,the qualifier /COMPILE=[ m* Ca] Xm*~a.FORsaysNthatthescriptcanbeusedtocompileallFortranmodulesinall facilities. ` [ * ] $* I. Y*! +WIfyouspecifyanasterisk( c*,W)foreachofthethreecom-Hponentsofthemodulename,thescriptappliestoallKmodules regardlessoftypeand facility.(Forexample,thea qualifier /RESERVE=[ m* a] m* Ca. Sm*0asaysthatthescriptcanbeused9toreserveallmodulesinall facilities.KONootherformsof wildcardingareallowedinthemodule-8Oname parametersto script-type qualifiers.! MOWhenVDElooksforascripttoperformsomeactionforaWOmodule,italwaysselectsthescriptthatismostspecifictothatRO5module.*Ifitcanfindascriptwithafully specifiedmoduleKOname([FACIL]MOD.TYP)forthemodulein question,itusesOOthatscript.+ Otherwise,itlooksforascriptwithamatch-AO>ing module-name specificationoftheform[FACIL] J*>.TYPor O[ d* ] *.TYPor[ * +] @* e. u*C,inthatorder.'ThisruleallowsyoutospecifyVOgenericscriptsthatapplytoallmodulesortoallmodulesofaSOHcertaintype,buttooverridethosescriptsforspecificmodulesHOorformodulesinspecific facilitieswhen appropriate.  bSOSimilarrulesapplytoscriptsthatareselectedby facility.)AIO NEW_STREAMscript,forexample,isinvokedforeachfa-PO5cilityinyoursystemwhenyoucreateanewstream.(InthisOOcase,VDEacceptstwoformsof facility-name specificationon'Othe script-type qualifiers:D  `mmFACIL_ 5MWIfyoufullyspecifythefacilityname,thescriptappliesLonlytothatspecific facility.+Forexample,the qualifierA/NEW_STREAM=RMSsaysthatthescriptcanonlybeEausedforfacilityRMSwhenVDEcreatesnewstreams. ` * ^+WIfyouspecifyanasterisk( c*+W)forthefacilityname,theNscriptappliestoall facilities.*Forexample,the qualifier /NEW_STREAM= t*3saysthatthescriptcanbeinvokedIaforeveryfacilityinyoursystemwhenVDEcreatesnewstreams. MONootherformsof wildcardingareallowedinthe facility-8Oname parametersto script-type qualifiers.;! POWhenVDElooksforascripttoperformanactionforafa-XOcility,itfirstlooksforascriptwithafully specifiedfacilityTO5name.'Ifnosuchscriptexistsinthe database,VDEselectstheROscriptwiththewildcardinthefacilityname,provideditex-TOists.*YoucanthusspecifyagenericscriptthatappliestoallSO> facilities,andthenoverridethatscriptforspecific facilitiesOwhen appropriate. 2O GeneratingCommandFilesinSegmentsIO4 Normally,VDE generatestheDCLcommandfiletoperformLOsomeactionfromasingleVDEscript.,Insome situations,LOhowever,itis necessarytogenerate different ``segments''JO>oftheDCLcommandfilefrom differentscripts.+TheDCLIOcommandfilethatcompilesaMACROmodule,forexample,6Omayneedtoconsistofthree segments:! i `mHmThefirstsegmentsetsuplogicalnamesfortheMACROA assemblerandincludestheMACROcommandanditsF qualifiers.'TheMACROcommandisendedwiththecon-Gw tinuation character.-ThissegmentisthesameforallEMACROmodules,andtheVDEscriptthat generatesit*(hasthe selectiontemplate[ 4* (] 4*(.MAR. `HThesecondsegmentcontainsthenameofthemoduletoJassembleanda plus-listofmacro librariestousewithHYthatmodule.+Thissegmentofthecommandfileisdif-BferentforeachMACROmodule,andtheVDEscriptI that generatesithasa selectiontemplateoftheformb [FAC]MOD.TYP. `FThethirdsegmentinsertsthe assembledobjectmoduleG:intoanobjectlibraryandruns VDE/DEPENDtocollectG dependencydata.&ThissegmentoftheDCLcommandfileIisthesameforallMACROmodules,andtheVDEscript?Dthat generatesithasthe selectiontemplate[ P* #D] 9P*^D.MAR.w! MOOOneVDEscriptcouldgenerateallthreesegmentsoftheDCLOOcommandfile,butthenaseparatescriptisneededforeachHO5MACROmoduleinthelibrary.,Thissolutionisundesir-OOablebecausethescriptkeywordsthatgeneratethefirstandPOthirdsegmentsoftheDCLcommandfilearethesameforallGO>MACROmodules,thuswastingspaceintheVDEdatabaseMOandmakingit difficulttomodifythecommonpartsoftheROscripts.*Abettersolutionistohavetwogenericscriptswith!OH selection templates[ T* >H] ST*6yH.MARthatgeneratethefirstandthirdGOsegmentsofeachMACROmodule'sDCLcommandfile,andSOtohaveasmallscriptspecifictoeachmoduletogeneratetheLORsecondsegment.+ThissolutionmakesiteasytomodifytheHOmodule-independentsegmentsofthekeywordfilesbecausemand.-WhenVDE generatesaDCLcommandfilefromPOscripts,itlooksforan appropriatescriptforeachpossibleIOsegmentnumber.+VDEselectsthescriptforeachsegmentNOHnumberusingthenormalscript selectionrulessothatmoreMOmodule-specificorfacility-specificscriptsarefavoredoverLOmoregenericscripts.,After selectingthescripts,VDEin-KORterpretstheminorderbysegmentnumbertogeneratetheOODCLcommandfile.*Iftherearenoscriptsforagivenseg-NOment,thatsegmentissimplyomittedfromthecommandfile.NO[Asaresult,youcanhaveuptotwentysegmentsinaDCLOOcommandfile,each generatedbya separatelyselectedscript.d! :MOIfyoudonotspecifyasegmentnumberforascript,VDEMOassignssegmentnumber10tothescript.(IfyourDCLcom-IO5mandfilesdonotneedmultiple segments,youcanthusHOignoresegmentnumbersandletVDEgeneratesegment10OO(andonlythatsegment)foreachcommandfile.(IfyoulaterOO>decidethatyouneed additionalsegmentsbeforeoraftertheLOoriginalsegment,youhaveamplesegmentnumberstochoose%Ofrominboth directions.M! W#O DebuggingScriptsHO4TheINVOKESCRIPTcommandisausefultoolfordebug-MOgingscripts.'INVOKESCRIPTallowsyoutofetchandinvokeMOa specifiedscript,andthentoexaminetheDCL command(s)%O> generatedbythescript.]DbCREATE%SCRIPT/COMPILE=[RMS]*.C%[MYDIR]SCRIPT_C.VDESCRIPT\ %VDE-I-SCRPADDED,%script%from%file& DEV$:[MYDIR]SCRIPT_C.VDESCRIPT;9&added&to the&database>9 script&to&compile%module&[RMS]*.C&(segment&10)M %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE>H8Inthisexample, theuserfirsttypesthescriptfile<[MYDIR]SCRIPT_C.VDESCRIPTonthe terminal.)TheBscriptcontainsfiveEMITkeywordsfollowedbyanFBEXITkeyword.)TheuserthenentersVDEandusestheFCREATESCRIPTkeywordtoenterthatscriptfileintoLtheVDEdatabaseasthecompilescriptforallCmodulesLKinfacilityRMS.Thelogmessagesconfirmthatthescript:was successfullyenteredintothe database. O 2. ! $.! TYPE%[MYDIR]SCRIPT_LINK_X.VDESCRIPT\i !&VDE%script%to%generate%the&DCL%commands%needed%to%link%module%X.EXE. ! EMIT&"$&SET%VERIFY"6A EMIT&"$&DEFINE%OBJLIB%",%$DIR(OBJ,CODE)> EMIT&"$&&LINK/EXE=OBJLIB:X.EXE/MAP=OBJLIB:X.MAPK-" EMIT&"@ 6OBJLIB:OBJLIB.OLB/INCLUDE=C,OBJLIB:OBJLIB.OLB/LIBRARY"% EMIT&"$&DEASSIGN&OBJLIB" a $ a VDE VDE>4 CREATE%SCRIPT/LINK=X.EXE%[MYDIR]SCRIPT_CV %VDE-I-SCRPADDED,%script%from%file&%DEV$:[MYDIR]SCRIPT_LINK_X.VDESCRIPT;2"9 added%to%the&database> script&to&link%module& [CODE]X.EXE&(segment&10)M %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE>& SHOW%SCRIPT/TEXT/LINK=X.EXE>Y Script%to%link%module% [CODE]X.EXE%(segment%10)D Text&of&script:` 1:&!%VDE&script%to%generate%the%DCL&commands&needed%to%link&module%X.EXE.1 2:&!$y 3:&EMIT%"$%SET&VERIFY": 4:&EMIT%"$%DEFINE&OBJLIB%",%$DIR(OBJ,CODE)B 5:&EMIT%"$%&LINK/EXE=OBJLIB:X.EXE/MAP=OBJLIB:X.MAPK-"P 6:&EMIT%"@ P 6OBJLIB:OBJLIB.OLB/INCLUDE=C,OBJLIB:OBJLIB.OLB/LIBRARY") 7:&EMIT%"$%DEASSIGN%OBJLIB"( VDE>BThisexampledisplaysthescriptfile SCRIPT_LINK_I X.VDESCRIPTtoshowthetextofthescript.(ThescriptGHconsistsoftwocommentlinesandfiveEMIT keywords.KTheEXITkeywordisomittedinthiscase.'Theuserthen>entersVDEandusestheCREATESCRIPTkeywordGRtoenterthescriptintotheVDE database.,The/LINKG qualifier specifiesthatthescriptlinksmoduleX.EXEHinthecurrentdefault facility,facilityCODE.Byde-H[fault,thescript'ssegmentnumberis10.,Finally,theCSHOWSCRIPTkeywordshowsthatthescriptcannow7 be displayeddirectlyfromthe database. O3. VDE>@CREATE%SCRIPT/NEW_STREAM=*&SCRIPT_NEW_STRM.VDESCRIPTX %VDE-I-SCRPADDED,%script%from%file&'DEV$:[MYDIR]SCRIPT_NEW_STRM.VDESCRIPT;3" added%to%the&databaseJb script&to&create%new%stream&for%facility%*&(segment&10)M %VDE-I-COMMIT,%database% transaction%has% successfully& committed. VDE>&SHOW%SCRIPT/TEXT/NEW_STREAM=*J: Script%to%create&new%stream%for&facility&*%(segment%10)D Text&of&script:N 1:&!%VDE&script%to%populate%the% directories%for&a%facility3 2:&!%when%a&new%stream%is%created.Y 3:&!L 4:&EMIT%"$% DEFINE/NOLOG&OLDOBJ%",%$DIR(OBJ,%CURRENT,%PARENT)M 5:&EMIT%"$% DEFINE/NOLOG&NEWOBJ%",%$DIR(OBJ,%CURRENT,%CURRENT)41 6:&EMIT%"$%COPY% OLDOBJ:*.OLB%NEWOBJ:"Cy 7:&EMIT%"$%COPY%!",$DIR(SRC,%CURRENT,%PARENT),"*.H%-" 8:&EMIT%"' ",$DIR(SRC,%CURRENT,%CURRENT)  9:&EXIT VDE>CThisexamplecreatesa NEW_STREAMscriptthatwillG`beexecutedforall facilitieswhenanew developmentBstreamiscreated.(TheCREATESCRIPTkeywordcre-FatesthescriptandtheSHOWSCRIPTkeyworddisplaysHjthescriptfromthe database.)Thescript generatesDCLGkeywordstocopyallobject librariesfromtheparentIstream'sobject directorytothecurrentstream'sobjectJt directory.((The ``current''streamisthenewstreambe-Singcreatedinthiscase.)'Thescriptalsocopiesall.HfilesL%fromtheparentstream'ssource directoryforthefacilityH}tothenewstream'ssource directoryforthe facility. O4. VDE>HCREATE%SCRIPT/INSERT_GENERATION=[*]*.*&[MYDIR]SCRIPT_INS_GEN^C %VDE-I-SCRPADDED,%script%from%file&&DEV$:[MYDIR]SCRIPT_INS_GEN.VDESCRIPT;4&added to%the&databaseL script&to&insert% generation&for%module%[*]*.*&(segment&10)M %VDE-I-COMMIT,%database% transaction%has% successfully& committedc VDE> VDE>4SHOW%$SCRIPT/TEXT/INSERT_GENERATION=[*]*.*L Script%to%insert& generation%for&module%[*]*.*%(segment%10)D: Text&of&script:V 1:&!%Script&for%the%INSERT& GENERATION%command.KThis%script&fetchesZ 2:&!%out&a%clear%copy%of%the% generation%just&inserted&into%a%streamS! 3:&!%in%order%to%keep%the%stream's%source& directory% up-to-date.Z! 4:&!<! 5:&FETCH& $FACMODTYP,&"/LOG/OUTPUT=",% $DIR(SRC)4! 6:&EMIT%"$%PURGE%",%$DIR(SRC),$MODTYPz" VDE>I"Thisexampledefinesascripttobeexecutedeachtime>A#theINSERT GENERATIONcommandis performedforA#anymodule.(TheSHOWSCRIPTcommanddisplaystheJ#textofthescript.(ThescriptcontainsaFETCHkeywordHK$thatfetchesthejustinserted generationintotheSRCM$ subdirectoryfortheaffectedstreamand facility.'Thisop-I$eration maintainsan up-to-datecopyofthesourcefileLU%inthat directory.(Becausethe/LOG qualifieris generatedH%fortheFETCHkeyword,VDEwillprintan informationalJ&logmessageasthemoduleisfetchedduringscriptexe-G^&cution.)ThescriptalsocontainsanEMITkeywordthatH& generatesaPURGEkeywordtobe performedonthefile'justfetchedout.8m,lnEOScript Functions*NOThissectioncontainsthescript functions supportedbyVDE.9OkThis documentationisunderconstruction...Q''ORequiresCRESCRP privilege.e! ;O DescriptionLOsScriptsareusedtoaddvarious user-defined extensionstoFOvariousVDE functionsand commands.*VDEinvokesvari-GO$ousscriptsatvarioustimesduringVDEprocessing-see$ScriptO|Types.9|forfurther informationonthis.n:D444OO4! OOScriptsarestoredintheVDE database,andspecificscriptsEOareinvoked automaticallyand transparentlyatprede-IO5terminedpoints.+Whenascriptisinvoked,thecommands!Owithinthe script-seeNScriptKeywords#forfurther informationOonthe availablescriptkeywords$-are convertedintoDCLIO>commandsandtheseDCLcommandsarethenexecutedinaO subprocess.*NPJO|ROWithinascript,script functions$9canbeusedtoextractJO informationfromtheVDEdatabaseandinsertthatinfor-HO5mationintotheDCLcommands generatedbybytheEMITLOscriptcommand,orintothecommandline generatedbytheOFETCHcommand. gPOCertainscript functionsextractnames,suchasstream,facil-NOity,module,andtypenamesfromthe database,whileothersGO5extracttheOpenVMS directoryspecificationsofvariousMOroot directoriesandsubdirectoriesintheVDElibrary.)VDE5Oacceptsthe followingscript functions:C `mm$FAC  KWReturnsthefacilitynameofthefacility currentlybeingK processedorofthemodule currentlybeing processed(for2example,themodulebeing compiled). ` $FACMODTYP! RdFWReturnsthefullmodulenameofthemodule currentlyJbeing processed(forexample,themodulebeing compiled).DThismodulenameincludesthefacilityname,moduleCaname,andtypenameinthenormalVDE module-name0syntax,forexample[FACIL]MOD.TYP. `99$FILEDIR"zGWReturnstheOpenVMS directory specificationofthedi-Erectorywherethemodule currentlybeingreplacedisHlocatedorwherethemodule currentlybeingfetchedorMareservedshouldgo.(Thisiseitherthecurrentdefaultdi-Jrectoryorthe directory specifiedwiththe/INPUTqual-CifiertotheREPLACEcommandorthe/OUTPUTqual-CkifiertotheFETCHorRESERVEcommand.)Thisfunc-AtionisonlydefinedforFETCH,NOKEEP,REPLACE,*RESERVE,andSTAGINGscripts. ` $FILESPEC#DWReturnstheOpenVMSfile specificationoftheinputIfileforthemodule currentlybeingreplacedoroftheLoutputfileforthemodule currentlybeingfetchedorre-Kaserved.-Thisiseitherthedefaultfile specificationforEthecommandorthefile specification specifiedwith?the/INPUT qualifiertotheREPLACEcommandor>kthe/OUTPUT qualifiertotheFETCHorRESERVEBcommand.-ThisfunctionisonlydefinedforFETCH,=NOKEEP,REPLACE,RESERVE,andSTAGINGscripts. `$DIR7 (dir-symbol[,fac-name[,stream-name]])$ HWReturnstheOpenVMS directory specificationofaspeci-Kfiedfacility subdirectoryforagiven developmentstream. Thez dir-symbol3O parameter specifiestheVDE directoryJasymbolthat identifiesthedesired subdirectory.( Directory@symbolsaredefinedwiththeSET DIRECTORYcom-mand.+Thefac-name-, parameter specifiesthefacilityHkwhose subdirectoryshouldbe retrieved.)Ifthisparame-Mterisomitted,thefacilityofthemodule currentlybeingD processedisassumed(forexample,themodulebeingt compiled).)Thet stream-name#Tt parameter specifiestheH developmentstreamforwhichthe subdirectoryshouldbeM% retrieved.'Ifthis parameterisomitted,thedefaultstream~isassumed.%! 5w=WYoucanspecifythekeyword%CURRENTforthe Wfac-nameB parametertorefertothefacilityofthemoduleFbeing processedandyoucanspecify%CURRENTforthea stream-name7a parametertorefertothe currentlyset=stream.&Youcanalsospecify%PARENTforthestream-nameC parametertorefertothecurrentstream'sparent;Bkthiskeywordismainlyusedin NEW_STREAMscriptsPtorefertothe directoriesoftheparentofthenewstreambeingcreated.;&AWFor additional informationon directorysymbols(W dir- symbol),seeCANCEL DIRECTORY,SET DIRECTORY, andsSHOW DIRECTORY. `$FACROOT( [(fac-name[,stream-name])]*&s]?*&s?c*&s?*' GWReturnstheOpenVMS directory specificationofaspec-Gifiedfacilityroot directoryforagivenstream./Thefac-name:{ parameter specifiesthefacilitywhoserootKa directoryshouldbe retrieved.)Ifthis parameterisomit-Kted,thefacilityofthemodule currentlybeing processedEisassumed(forexample,themodulebeing compiled). kTheyk stream-name0k parameter specifiesthe developmentKstreamforwhichthegivenfacilityroot directoryshouldIbe retrieved.,Ifthis parameterisomitted,thedefaulttstreamisassumed.( Rn=WYoucanspecifythekeyword%CURRENTforthe Wfac-name9 parameterandyoucanspecifythekeyword)%CURRENTor%PARENTforthe stream-name Cpa-Larameter.(Seethe descriptionofthe$DIRfunctionforthe(meaningsofthese keywords. `99$LIBROOT)! HWReturnstheOpenVMS directory specificationoftherootN directoryofthecurrentVDElibrary.'Thisisthe directory-thatcontainstheVDE database. `$MOD*GWReturnsthemodulenameofthemodule currentlybeingH processed(forexample,themodulebeing compiled).(TheHmodule'sfacilitynameandtypenamearenot included. `$MODTYP^+ 4FWReturnsthemodulenameandtypenameofthemoduleI currentlybeing processed(forexample,themodulebeingI compiled).)Thetwonamesare separatedbyaperiod,as?ainMOD.TYP.Thefacilitynameisnot included. `$SCRATCH, HKWReturnsthedeviceand directoryforthecurrentprocess-'specificscratch directory. `// $SESSIONNAME-! GWReturnsthenameofthe reservationsession associated?withthecurrentRESERVE,REPLACE,or UNRESERVEJcommand.(Ifno reservationsessionisusedforthecom-Lamand,thisfunctionreturnsthenullstring.(Thisfunction=isonlydefinedforNOKEEP,REPLACE,RESERVE,,STAGING,and UNRESERVEscripts. ` $SESSIONNUM3.! [ EWReturnstheuniquesessionnumberofthe reservationEsession associatedwiththecurrentRESERVE,REPLACE,@or UNRESERVEcommand.)Thesessionnumberisre-Faturnedasadecimalintegervalue.-Ifno reservationHsessionisusedforthecommand,thisfunctionreturnsJthenumber0.'ThisfunctionisonlydefinedforNOKEEP,6kREPLACE,RESERVE,STAGING,and UNRESERVEscripts. `BB $STAGEDEST/! >\GWReturnsthe destination directoryorfile specificationNforafilebeingcopiedtoastaging directorywhilebeingKqueuedfor replacement.'IftheinputfiletotheREPLACEFacommandhasthesamefilenameandtypeastheVDEBmodulebeing replaced,the $STAGEDESTfunctionre-IturnstheOpenVMS directory specificationofthestagingNk directoryintowhichthefileshouldbecopied.)Ifthein-Lputfilehasa differentfilenameortypethantheVDEGmodule,whichcanhappenifafilenameis specifiedEtwiththe/INPUT qualifier,thenthe $STAGEDESTfunc-Etionreturnsthestagingarea directory specification@% concatenatedwiththeVDEmodulenameandtype.n0 [DGWThe $STAGEDESTfunctionisusedtospecifythedesti-Dnation parameterofthestagingscriptCOPYcommandNthatcopiestheinputfileintothestagingarea.)Byleav-Iaingthefilenameoffthis parameterwhenthenameofPtheinputfileisnotbeingchanged(thetypicalcase),thisEfunctionensuresthattheCOPYcommand preservestheOkfile'screationdateandtime.'Thisfunctionisonlydefined forSTAGINGscripts. `BB $STAGEDIR1 RUBWReturnstheOpenVMS directory specificationoftheEstaging directoryforthemodule currentlybeingre-Hplaced..Staging directoriesareusedtoholdfilesforLaqueued replacements,andthisfunctionisonlydefinedforSTAGINGscripts. `99 $STAGEROOT2 IWReturnstheOpenVMS directory specificationofthestag-Gingarearoot directoryfortheVDElibrary.-(Staging9areasholdfilesforqueuedreplacements.) `$STREAM-3CWReturnsthenameofthedefault developmentstreamK(forexample,thestreambeingcreatedorthestreamfor0whichabuildjobisbeingrun.) `$STRMDIR( (dir-symbol[, stream-name])q4 GHWReturnstheOpenVMS directory specificationofaspeci-Ifiedstream subdirectoryforagiven developmentstream. Thez dir-symbol3O parameter specifiestheVDE directoryJasymbolthat identifiesthedesired subdirectory.( Directory@symbolsaredefinedwiththeSET DIRECTORYcom-mand..The stream-name# parameter specifiestheGkstreamwhose subdirectoryshouldbe retrieved.+IfthisE parameterisomitted,thedefaultstreamisassumed. 5! @WYoucanspecifythekeyword%CURRENTor%PARENTforthe stream-name/# parameter.(Seethe descriptionofGthe$DIRfunctionforthemeaningsofthese keywords.AaFor additional informationon directorysymbols(a dir- symbol),seeCANCEL DIRECTORY,SET DIRECTORY, andsSHOW DIRECTORY. ` $STRMROOT [(stream-name)]*5|]?*5|?c*5s?*6! VGWReturnstheOpenVMS directory specificationofaspec-0ifiedstream'sroot directory.,The stream-name pa-Crameter specifiesthe developmentstreamwhoserootNa directoryshouldbe retrieved.'Ifthis parameterisomitted,,thedefaultstreamisassumed. 7! @WYoucanspecifythekeyword%CURRENTor%PARENTforthe stream-name/# parameter.(Seethe descriptionofGthe$DIRfunctionforthemeaningsofthese keywords. `$TYP8EWReturnsthetypenameofthemodule currentlybeingC processed(forexample,themodulebeing compiled).9 wEOForfurther informationoncreatingscripts,seetheCREATEOSCRIPTcommand.n9/DHHzzOOgnmpA:OScriptTypes*;<vOOThissectioncontainsthetypesofscripts supportedbyVDE.'OkRequiresCRESCRP privilege.=! FO DescriptionNOsVDEsupportsmanytypesofscripts.)The differenttypesareJO distinguishedbythecommandsor circumstancesthatcauseKO$themtobeinvoked.(Forexample,COMPILEscriptsarein-GO|vokedwhenyouentertheCOMPILEcommandorwhenyouJOrunabuildjob,whileRESERVEscriptsareinvokedwhen(O-youenterRESERVE commands.>! IOSometypesofscriptsareoptionalbecausethecommandsOOthatinvokethemwillrun correctlywithoutscripts.)InsuchUO5cases,thescriptisthereonlytoallowyoutospecifyoptionalHO additional processingforthecommand.'TheRESERVEcom-KOmand,forexample,doesnotneedRESERVEscriptstoworkIO> correctly,butifyouwanttheRESERVEcommandtosendIOmailtoselecteduserswheneversomeonereservesamod-NOule,youmustuseaRESERVEscripttoperformthataction.NOHOthertypesofscriptsare mandatory.&Forexample,VDEdoesMOnotknowhowtocompile,copy,orlinkmodulesunlessyouGOspecifyhowwiththe appropriatescripts.,TheCOMPILE,AORCOPY,LINK,andBUILDcommandsthusrequiresuch#Oscriptstobedefined.?^KOMostscriptsareexecutedinlogical isolationfromotherNOscripts,andarecalledinresponsetoa particularcommandQO5orrequest.(Ifa particular operationresultsinmultiplepro-MO pogationsorsimilar operations,certainscriptsareinvoked'Oonceforeach propogation.@! [KOAfewscripttypes,suchastheBUILD,COMPILEandLINKMOscripts,operateasagroup.*TheBUILDscriptcanbeusedPO5tosetupDCLglobalsymbolsorlogicalnamesthatareusedJOasinputto subsequentCOMPILEorLINKscripts.)Aspar-POtialbuildscaninvokeasubsetofall availableCOMPILEandNO>LINKscripts,DCLglobalsymbolsandlogicalnamesthatareJOusedasinputsintoanyCOMPILEandLINKscriptsshouldAOonlybeequatedordefinedintheBUILDscript.ANOOYouspecifythetypeofascriptwitha qualifier.-FortheAOCREATESCRIPTcommand,youmustspecifyonesuchO5 qualifier.B lOTable3-3Flistsand describesthevariousscripttypesacceptedObyVDE:*BOFa?CFU4OForotherscript-related commands,seeCREATESCRIPT,ODELETESCRIPT,EXTRACTSCRIPT,INVOKESCRIPT,O<MODIFYSCRIPT, <and<SHOWSCRIPT.*FM?/*FO?l*F?*F?0*FO?\*FA? RtruBcOSET DIRECTORY*dGe MOCreatesa directorytemplateintheVDE database.( DirectoryKO( templates determinewhatdisk directoriesVDEcreateswhenNOcreatingnewstreamsand facilitiesandvariousdiskstorageOareas.'OuRequiresCRESTRM privilege.\f2OFormat"OsSET DIRECTORYMdir-specg Z[O ParameterOsdir-specMO SpecifiesaOpenVMS directory specificationforthenewdi-MO$rectory template.'This parametermayspecifyanabsoluteorPO|arelative directoryspecification.'Anabsolute directoryspec-KO ificationisafully specifiedOpenVMS directorynameandNO-followsthenormalsyntaxforsuchnames.'Youuseanabso-QOlute directory specificationwhenyouwanttodecidetheexactOOdisklocationfora directoryintheVDElibrary.)Forexam-MO7ple,youmaywanttolocateanewstream'sroot directoryOOonaspecificdiskbeforeVDEcreatesthestream's directoryFOtree.)The parameterDEV:[DIRNAM.FOO]isanexampleof1OAanabsolute directoryspecification.Dh! OOArelative directory specificationbeginswithaleftbracketPOandaperiod( [. ),thencontainsoneormore subdirectoryLO5names separatedbyperiods,andendswitharightbracketSO( ] ).)This directory specificationis concatenatedtothenameTOofthe appropriateroot directorytoformafull directoryspec-RO> ification.)Youusearelative directory specificationtospecifyKOa subdirectorynamethatVDEshoulduserelativetosomeQOroot directory.'The directory specification[.SRC],forexample,QOHcanbeusedtospecifythatafacility subdirectorynamedSRCIOshouldbecreatedwithineach facility'sroot directory.'iO DescriptionDOsTheSET DIRECTORYcommandcreatesanew ``directoryMO template''intheVDE database.)A directorytemplatespeci-OO$fiesthenamethatVDEshouldassigntoeachdisk directoryNO|ofacertainkindwhencreating directoriesfornewstreamsNOor facilities.*Youcancreate directory templatesforstreamQO-root directories,facilityroot directories,facility subdirecto-ROries,the library's delta-fileroot directory,andthe library'sIO staging-arearoot directoryforqueued replacements.*(ThePO7libraryroot directoryiscreatedwhenyoucreatethelibrary0Oandcannotbechanged thereafter.)Uj +FOTheSET DIRECTORYcommanddoesnotitselfcreatenewPO directories;itonlystoresthenew directorytemplateintheMO5VDE database.(VDEdoesnotusethetemplatetocreatenewEOdisk directoriesuntila subsequentCREATESTREAMorGOCREATEFACILITYcommandcreatesthe directorytreeforDO>anewstreamor facility.'TheCREATEDIRECTORY_TREEKOcommanduses directory templatestocreate directoriesfor-Oanexistingstreamor facility.k! WTOUnlessthenewtemplateisforthe library'sdeltafilesoritsOOstagingarea,itisonlydefinedforthedefault developmentJO5stream.*However, directory templatesare inheritedbytheNOstream'sfuture descendantsandareusedtocreatethediskRO directoriesforthose descendants.'TheyarealsousedtocreateKO> directorytreesfornew facilitiesinthedefaultstream.l! %OOIfyouwanttocreate directory templatesforanewstream,QOyoucanspecifythe templatesfortheparentstream,inwhichPO5casetheyare automaticallyappliedtoallchildstreams.(YouAOmustthenentertheSET DIRECTORYcommandbeforeAOyouentertheCREATESTREAMcommandforthenewKO>stream.)Alternatively,youcancreatethenewstreamwithCOthe/DEFER qualifierontheCREATESTREAMcommand.NOThis qualifier suppressesdirectory-treecreationforthenewEOHstream.*YoucanthenusetheSETSTREAMcommandtoJOmakethenewstreamthedefaultstreamandusetheSETHO DIRECTORYcommandtocreatethe directory templatesyouSET DIRECTORYcommandwiththe /FACILITY qualifierPOtocreatethe directory templatesyouwantforthat facility.>OA subsequentCREATEDIRECTORY_TREEcommandusesTOHthenew templatestocreatethe directorytreeforthe facility.En! IOFor additional informationon directory creation,andonO directorysymbols( dir-symbol-)and directorysymbolprocess-O5ing,seep5CANCEL DIRECTORY,5SHOW DIRECTORY, 5andOScript Functions.*np]?*n?**nOPLO$o! O QualifiersOs/DEFERO/NODEFER (default)LO$The/DEFER qualifier specifiesthat directorytreecreationNO|fornewstreamsbedeferredwhenthosestreamsarecreated.QOThisactiononlyappliestonewstreamsforwhichthedefaultPO-streamistheparent.'This qualifiershouldbeusedwhenyouOOalwayswantan opportunitytoalteranewstream's directoryNO templatesbeforeyouactuallycreateits directorytree.*TheNO7/NODEFER qualifier specifiesthat directorytreecreationnotNObedeferredfornewstreamsunlesstheuser explicitlyusesEOthe/DEFER qualifierwiththeCREATESTREAMcommand.8p! O /DELTA_FILESO(/STAGINGO/STREAM (default)NO Specifieswhetherthenew directorytemplateisfortheVDESO2 library'sdeltafiles,foritsstagingarea,orforthedefaultJOstream.(The /DELTA_FILES qualifier specifiesthatthenewPO directorytemplateisfor directoriesthatstorethe library'sNO<deltafiles(CMS libraries).(The/STAGING qualifier specifiesPOthatthenew directorytemplateisforthe library'sstaging-KOarearoot directory.-(StagingareasholdfilesforqueuedLOEreplacements.)'The/STREAM qualifier specifiesthatthenewQO directorytemplateisfor directoriesthatstorefilesfortheIOcurrentdefaultstream.*Becausestreamsinherit directoryKOO templatesfromtheirparents,the/STREAM qualifiercausesMOthenew directorytemplatetoapplytoallofthedefault(Ostream'sfuture descendants.qXAOOf /DELTA_FILES,/STAGINGand/STREAM,/STREAMisOthedefault.rwO/FACILITY=fac-nameKO( Specifiesthatthenew directorytemplateonlyappliesto'Othefacilitygivenbythefac-named parameter.+Thispa-KOrametermaynotcontainwildcard characters.*IfboththisHO2 qualifierandthe /SUBDIRECTORY qualifierare specified,KOVDEcreatesa directorytemplateforthe specifiedfacil-OOity subdirectory.)Ifthe /FACILITY qualifieris specifiedandFO<the /SUBDIRECTORY qualifierisomitted,VDEcreatesaEOtemplateforthe specified facility'sroot directory.s} WMOIfthe /FACILITY qualifierisomittedandthe /SUBDIRECTORYSO qualifieris specified,VDEcreatesa directorytemplatefortheRO5facility subdirectoryforall facilitiesthatarenot explicitlyOO specifiedinother templates.(Ifboththe /FACILITY qualifierIOandthe /SUBDIRECTORY qualifierareomitted,VDEcreatesIO>atemplateforthestreamor delta-fileroot directory.t! UO/LOG (default)O(/NOLOGOOControlswhetherlogmessagesareprintedafterthe directoryNOtemplateiscreated.&The/LOG qualifiercausessuchmessagesIO2tobeprintedandthe/NOLOG qualifier suppressesthem.NOThesemessagesindicatethatthe directorytemplatehasbeenNOaddedtothedatabaseandthatthedatabase transactionhas"O< completed successfully.uUO/PROMPTO( /NOPROMPT (default)FOThe/PROMPT qualifier specifiesthatuserswhocreateMOnewstreamsforwhichthedefaultstreamistheparentbeLO2promptedforthenameofthenewstream'sroot directory.NOThis qualifiershouldbeusedwhenyoudonotwanttouseLOthedefaultroot directorynamefornewstreams,butwantRO<theuserto explicitlyselectthelocationofthenewstream'sOO directorytreeeachtime(perhapstoselecta differentdiskJOeachtime).(The /NOPROMPT qualifier specifiesthatanewJOEstreamshouldgettheroot directory determinedbyVDE'sQOdefaultrulesunlesstheuser explicitly specifies otherwiseon'OtheCREATESTREAMcommand.v cO/REMARK="string"PO( Specifiesaremarkstringtobestoredforthenew directoryNO template.(Thequotedremarkstring,whichcanbeupto132JO characterslong,maycontainany explanatoryremarkaboutNO2thenew directorytemplatethatyouwantstoredintheVDEO database.w! y"O/SUBDIRECTORY=dir-symbolLO( Specifiesthatthenew directorytemplateisforafacil-!Oity subdirectory.+The\ dir-symbol#3 parameter specifiestheNO directorysymbolthatyouwantto associatewiththesubdi-KO2rectory.'The directorysymbolmustfollownormalVDEnameOOsyntax.)Youusethe directorysymbolinVDEscriptstoref-LOerencethe subdirectory;seethe descriptionoftheCREATEFO<SCRIPTcommandforan explanationofVDEscripts.-IfFOthe /SUBDIRECTORY qualifierisomitted,VDEcreatesaTO directorytemplatefora facility,stream,or delta-filerootdi-NOErectory.((The descriptionofthe /FACILITY qualifierexplainsQOhowthe qualifiersinteracttoselectthetemplatetocreate.)x k`NOWhenyouspecifyfacilitysubdirectoriesfor delta-files,theNO directorysymbolmayhaveaspecialmeaningtoVDE.IfyouKO5specifya delta-file subdirectorywiththesymbolVDE$CMS,OOVDEputstheCMSlibraryforthefacilityinthat subdirec-UOtoryinsteadofinthefacilityroot directory.)IfyouspecifyaGO> delta-file subdirectorywiththesymbol VDE$MARKER,VDEMOputstheactualsourcefilesformodulesthatuse``markerSOfiles''inthat subdirectory.(Ifyouusemarkerfiles,youmustGOHhavebotha marker-file subdirectoryanda CMS-libraryKO subdirectory.*(The descriptionofthe/MARKER qualifiertoDOtheCREATEMODULEcommand discussesmarkerfilesinORmoredetail.) y  OExamples O1. VDE>;SET%$DIRECTORY/STREAM/SUBDIRECTORY=ANASYM%[.ANA]V %VDE-I-DIRADDED,& directory% specification&[.ANA]%added%to%the%databaseM" %VDE-I-COMMIT,%database% transaction%has% successfully& committedj VDE>jSHOW% DIRECTORY= Directory-creation% templates&for%stream%V2.1-1:%D Directory%creation%flags:HB Do%not%defer%creation%of% directory&tree%for& substreams@ Do%not%prompt&for%root& directory%for% substreams=D Stream%root% directory%is% [.V2_1-1]&by&default6b Subdirectory:p [.VDE$BLD]%(symbol&VDE$BLD)=D Directory% templates&for% unspecified% facilities:19 Subdirectory:p[.ANA]&(symbol%ANASYM). Subdirectory:p[.OBJ]&(symbol%OBJ). Subdirectory:p[.SRC]&(symbol%SRC)6 Subdirectory:p [.VDE$COM]%(symbol&VDE$COM)6Y Subdirectory:p [.VDE$LOG]%(symbol&VDE$LOG)AD All%other% directories%created%using%default&rulesy VDE>JThisexamplecreatesa directorytemplateforanewfa-K@cility subdirectory.)The directory specificationis[.ANA],Kwhichsaysthata subdirectorycalledANAshouldbecre-Jatedwithineach facility'sroot directory.*The directoryCJ symbol associatedwiththat subdirectoryisANASYM.N ThissymbolisusedinVDEscriptsto referencethesubdi-> rectory.(TheSHOW DIRECTORYcommandshowsthatGT thenew directorytemplateisstoredinthe database. O 2. VDE>2 SET%DIRECTORY/FACILITY=RMS& [MYDIR.RMS][ %VDE-I-DIRADDED,& directory% specification& [MYDIR.RMS]&added&to&the%databaseMa %VDE-I-COMMIT,%database% transaction%has% successfully& committed VDE> SHOW% DIRECTORY= Directory-creation% templates&for%stream%V2.1-1:%D9 Directory%creation%flags:H Do%not%defer%creation%of% directory&tree%for& substreams@ Do%not%prompt&for%root& directory%for% substreams=DY Stream%root% directory%is% [.V2_1-1]&by&default6 Subdirectory:p [.VDE$BLD]%(symbol&VDE$BLD)=D1 Directory% templates&for% unspecified% facilities:.y Subdirectory:p[.OBJ]&(symbol%OBJ). Subdirectory:p[.SRC]&(symbol%SRC)6 Subdirectory:p [.VDE$COM]%(symbol&VDE$COM)6P Subdirectory:p [.VDE$LOG]%(symbol&VDE$LOG)3D Directory% templates&for%facility%RMS:'( Root& directory:% [MYDIR.RMS]AD All%other% directories%created%using%default&rulesH VDE>HThisexamplecreatesa directorytemplatefortherootJ directoryoffacilityRMS.The directory specificationisHh [MYDIR.RMS],anabsolute directory specificationfortheKroot directory.+VDEwillcreatethis directoryforfacil-;ityRMSwhena subsequentCREATE DIRECTORY_ErTREEcommandisenteredforthatfacilityoranewEstreamiscreatedfromthedefaultstream.*TheSHOW># DIRECTORYcommandshowsthatthenew directory2{templateisstoredinthe database.z n_FThe followingexampleshowsanexampleofaVDEli-Gbrary creation, includinganumberofdirectory-related5 commands.  $Z $!%Locate%and&delete%previous% incarnations%of%the&test%facility%files,II $!%then&unpack%the%saveset% containing&the%test&files...  $` $&if&f$search("sys$scratch:A.REQ")&.nes.&""&Then%Delete&sys$scratch:A.REQ;*/log`! $&if&f$search("sys$scratch:B.REQ")&.nes.&""&Then%Delete&sys$scratch:B.REQ;*/log`i $&if&f$search("sys$scratch:C.B32")&.nes.&""&Then%Delete&sys$scratch:C.B32;*/log` $&if&f$search("sys$scratch:D.B32")&.nes.&""&Then%Delete&sys$scratch:D.B32;*/log` $&if&f$search("sys$scratch:E.B32")&.nes.&""&Then%Delete&sys$scratch:E.B32;*/log`A $&if&f$search("sys$scratch:F.B32")&.nes.&""&Then%Delete&sys$scratch:F.B32;*/log  $6 $&Backup%VDE$CREATE.BCK/SAVE& Sys$Scratch:  $Ja $!%Create%the&core% directory&--&this%must%be% present...  $? $&Create/Directory% STAR$DATA:[QTV.WWW.VDE$DATABASE]9 $&VDE  !O !&create%the%WWW&library%in%STAR$DATA:[QTV.WWW...],%using%theO !&mnemonic&WWW,%placing%all% Rdb-related%library% components&in.X !&!STAR$DATA:[QTV.WWW.VDE$DATABASE].  !E create%librarK STAR$DATA:[QTV.WWW.VDE$DATABASE]%/DEFER%-0 /NAME=WWW&-0x /REMARK="QTV&WWW%Source%Library"%-C /NOAUTO_CONVERT&/AUTO_ADD_USER=VMS_SOURCE% /AUTO_MAIL%-I /ASK_INFO_FILE%/ASK_REPL_CAUSE&/SHOW_GEN_EXPR& /NOSTATISTI&-?P /NOHISTORY_NOTES%/NOALLOW_DELETE%/NOWILD_INS_GEN&-: /NOCMS_ELEM_HIST%/CREATOR="Stephen%Hoffman"%-3 &/DEF_PRIVILEGES=(CREMOD,RESREP,CREFAC)%-4( '/AUTH_PRIVILEGES=(CREMOD,RESREP,CREFAC)&-3p &/data=STAR$DATA:[QTV.WWW.VDE$DATABASE]%-4 '/journ=STAR$DATA:[QTV.WWW.VDE$DATABASE]&-0 &/snap=STAR$DATA:[QTV.WWW.VDE$DATABASE] H ! SHOW&DEFAULTS SHOW& LIBRARY/FULL= MODIFY%CONTEXT/PUBLIC%DEFAULT/NOSTREAM/NOFACILITY h !: CREATE%USER%SYSTEM% /NAME="System%Manager"%-8i $/DEF_P=ALL/AUTH_P=ALL/REMARK="System&Manager" ? !H !&Create%the%CMS& ("delta")%library& directory% structure.P !& Configure%the%CMS& libraries%to%use%the& directory% structure:= !p0STAR$DATA:[QTV.WWW.CMS$DATABASE.'facility'.CMS].Q_ !& Configure%the%"marker"%files%to%use&the% directory% structure:? !p2STAR$DATA:[QTV.WWW.CMS$DATABASE.'facility'.SRC]...  !F7 SET%DIRECTORY/DELTA_FILES& STAR$DATA:[QTV.WWW.CMS$DATABASE]A SET%*DIRECTORY/DELTA_FILES/SUBDIRECTORY=VDE$CMS&[.CMS]D SET%-DIRECTORY/DELTA_FILES/SUBDIRECTORY=VDE$MARKER&[.SRC], CREATE%DIRECTORY_TREE/DELTA_FILES%W SHOW&DIRECTORY/DELTA_FILES  !* !&Create%the%staging%area... / !Aw SET%DIRECTORY/STAGING%STAR$DATA:[QTV.WWW.VDE$STAGING]( CREATE%DIRECTORY_TREE/STAGING  !3O !&Create%the% stream/build& directories  !@ SET%DIRECTORY/STAGING%STAR$DATA:[QTV.WWW.VDE$STREAM]'& CREATE%DIRECTORY_TREE/STREAM n !9 !&create%and%load%the%VDE&test% facility.  !+F CREATE%FACILITY% AAA_VDE_TEST&-8i /REMARK="Test%facility%for%VDE& developers"& SET%FACILITY% AAA_VDE_TEST"D CREATE%MODULE/NODELETE/REMARK="VDE& self-test%module"&-$f /INPUT=SYS$SCRATCH:%A.REQD CREATE%MODULE/NODELETE/REMARK="VDE& self-test%module"&-$ /INPUT=SYS$SCRATCH:%B.REQD> CREATE%MODULE/NODELETE/REMARK="VDE& self-test%module"&-$ /INPUT=SYS$SCRATCH:%C.B32D CREATE%MODULE/NODELETE/REMARK="VDE& self-test%module"&-$ /INPUT=SYS$SCRATCH:%D.B32D^ CREATE%MODULE/NODELETE/REMARK="VDE& self-test%module"&-$ /INPUT=SYS$SCRATCH:%E.B32D CREATE%MODULE/NODELETE/REMARK="VDE& self-test%module"&-$6 /INPUT=SYS$SCRATCH:%F.B32 ~ ! EXIT  $U $&ExitU{z}COSET PRIVILEGES*nDDOEnablesVDE privilegesforthecurrentVDEsession.g=OFormat-OsSET PRIVILEGESNpriv[,priv...] FO ParameterOsprivLOThenameofa privilegeenabledforthecurrentVDEses-QO$sion.'Youcanenableonlythose privilegesforwhichyouhaveNO|authorization.*Tolistthe privilegesforwhichyouareau->O thorized,usetheSHOWPRIVILEGES/FULLcommand.O-Table3-51-containsalistofVDE privileges.*Oa?7 OOTheproject administrator privilegesarethosethataprojectMO administratorneedstoadduserstothelibrary;tocreateNOT facilities,modules,andstreams;torunbuildjobs;andto#O administertheproject.C! O DescriptionKOsTheVDE privilegesenabledforthecurrentsessiondeter-DOminetheVDEcommands(and,insomecases,commandLO$ qualifiers)youareallowedtouse.+Forexample,youmustFO|havetheCREFAC privilegetousetheCREATEFACILITY@OandMODIFYFACILITY commands.* Likewise,youmustHO-havetheUSERNAME privilegetoreplacemodulesforan-IOotheruserusingthe /USERNAME qualifieroftheREPLACEOcommand.! aNOWhenyoustartaVDEsession,thedefault privilegeslistedPOinyourusertablerecordinthedatabasebecometheinitialRO5 privilegesforyoursession.)Afterthat,youcanset additionalMO privilegesforthecurrentsessionusingtheSET PRIVILEGESMOcommandifyouare authorizedtosetthose privileges.*YouOO>canalsocancel privilegesforthecurrentsessionusingtheCOCANCEL PRIVILEGEScommandandyoucandisplayyourEOcurrent privilegesusingtheSHOW PRIVILEGEScommand. uKOUsersholdingtheOpenVMS privilegeBYPASSareallowedto*O /OVERRIDEtheVDE privileges.vOO Useofa privilegeoverrideisaudited,andan informational'O messagewillbe displayed.- ROToalterthedefaultor authorized privileges associatedwithaLO particularusernameinthecurrentlibrary,usetheMODIFY9O5USERusername/DEF_PRIVILEGESorMODIFYUSER,Ousername/AUTH_PRIVILEGEScommand.O QualifiersOs/ALLNOEnablesall authorizedVDE privileges.)Toalterthelibrary-KO$specific authorized privilegesforauser,usetheMODIFY2O|USERusername/AUTH_PRIVILEGEScommand.! pO/DEFAULTKO(ResetstheVDE privilegemasktothedefaultsettingforNOthecurrentuser-thedefaultsettingscanbe displayedusingBOtheSHOWUSER username/FULLcommand.)ToalterthePO2library-specificdefault privilegesforauser,usetheMODIFY3OUSERusername/DEF_PRIVILEGEScommand. O /OVERRIDEMO(IftheuserhastheOpenVMS privilegeBYPASSenabled,thisNOqualifer overridesallVDE privilege restrictionsandenablesOallVDE privileges.vOO Useofa privilegeoverrideisaudited,andan informational'O messagewillbe displayed.3  OExamples O1. VDE>*SET% PRIVILEGES&CREFAC,%CREMOD VDE>SHOW% PRIVILEGES%> Currently%set& privileges:8 BUILD%CREFAC%CREGRP&CREMOD%CRESTEP&RESREP VDE>SET%PRIVILEGES/ALL VDE>?TheSET PRIVILEGEScommandsetstheCREFACandBCREMOD privileges.)TheCREFAC privilegeallowstheN5usertocreateandmodify facilitiesinthecurrentlibraryIandtheCREMOD privilegeallowstheusertocreateandCmodifymodulesinthelibrary.'TheSHOW PRIVILEGES?command(see?SHOW PRIVILEGES)0?confirmsthattheK privilegeshavebeenaddedtothecurrent privilegemask.*? E &E .6` ̆$ - l*n(U0  f 6*? /H;H ADs4 2-AV&T]#o}Zi}K }! e\ l .WZ65n~ ] z fI1$`6L#^f$"p  3o  `xI;0 Ztj l(vP- x9RwES~ t.9B 8SbN*h | k K`' u9:'dI +T" 3&0 Q* W"ZIG%Z< &!xZO*z%T -}"#$,tEUT*<`hp*Hz8|g(Q |R2:ZBt~U(HG>|B _&@ :)8]H\xlZ_vA {=,"" 7)=*& )hR#0<46AYC EoR&-h5qMs2|.#,:DFc%0F^" .X$'2J0$`=0.I ;|UvF(_ R Tq^z! h `>& *,f!v  (fV6CS2biq>!28qx*m*G" t N&+ : : \~G ([ *q % * Z%& : $ $ $6 \9#  xb + ""< L [ i B0y tn  x$ 8d N ; * d8 ( ,#