`: J:Release Project Leader Menu (PLMENU) DIGITAL CONFIDENTIALPLMENU + Contents  Tables!B*6DECdocument V3.2n/ gCONTENTSCONTENTS8 E\TitlePageTitle Page1xE\PrefacePreface/xE\PLMENUPLMENU@g$K1 INTRODUCTION1 INTRODUCTIONpw%33$K2PLMENUCommonPromptsandFeatures2 PLMENU Common Prompts and Featuresbw,,$K3CreatingaNewBuildStream3 Creating a New Build Streamw/F $L3.19&LInvokingthecreatebuildstream procedure3.1 Invoking the create build stream procedurefw1 $L3.2$&LCreateStream Processing3.2 Create Stream Processing(w/F $K3.39&K Suggestionsforcreatingnewbuildstreams3.3 Suggestions for creating new build streams*]w))$K4 PopulatingabuildStream4 Populating a build Stream-w+A $K4.14&KInvokingthepopulatestream procedure4.1 Invoking the populate stream procedure2jw3 $K4.2&&KPopulateStream Processing4.2 Populate Stream Processing:w-C $K4.36&K Suggestionsfor populatingbuildstreams4.3 Suggestions for populating build streams=Lw  $K5RenamingaStream5 Renaming a Stream>w)? $K5.12&KInvokingtherenamestream procedure5.1 Invoking the rename stream procedureBfw1 $L5.2$&LRenameStream Processing5.2 Rename Stream ProcessingJww%: $K5.3-&K Suggestionsforrenamingstreams5.3 Suggestions for renaming streamsLw2CC$K6Creatinga BaselevelStreamfromaBuildStream6 Creating a Baselevel Stream from a Build StreamMw3J $K6.1=&KInvokingthecreate baselevelstream procedure6.1 Invoking the create baselevel stream procedureP{w'< $K6.2/&KCreate BaselevelStream Processing6.2 Create Baselevel Stream ProcessingZw/E $K6.38&K SuggestionsforCreating BaselevelStreams6.3 Suggestions for Creating Baselevel Streams[Sw$$$L7 ComparingVDEtoCMS7 Comparing VDE to CMS\w*@ $K7.13&KInvokingthecomparestream procedure7.1 Invoking the compare stream procedure^hw2 $K7.2%&KCompareStream Processing7.2 Compare Stream Processinggyw&; $K7.3.&K Suggestionsfor ComparingStreams7.3 Suggestions for Comparing StreamshYw''$K8CreatingaNewFacility8 Creating a New Facilityjw+A $K8.14&KInvokingthecreatefacility procedure8.1 Invoking the create facility proceduremjw3 $L8.2&&LCreateFacility Processing8.2 Create Facility Processingt}w(= $K8.30&K SuggestionsforCreating Facilities8.3 Suggestions for Creating Facilitiesww-<<$L9 PopulatingaStreaminSelected Facilities9 Populating a Stream in Selected Facilitiesxw/E $K9.18&KInvokingthepopulate facilities procedure9.1 Invoking the populate facilities procedurezrw#7 $K9.2*&KPopulate Facilities Processing9.2 Populate Facilities Processingw*? $K9.32&K Suggestionsfor populating facilities9.3 Suggestions for populating facilities_w**$K10 ComparingTwoCMSClasses10 Comparing Two CMS Classes|w'=$K10.1/&KInvokingtheCompareClassOption10.1 Invoking the Compare Class Optionhw2$L10.2$&LCompareClass Processing10.2 Compare Class Processing{w'<$K10.3.&K Suggestionsfor ComparingClasses10.3 Suggestions for Comparing Classesrw&44$K11 Archivingor ObsoletingaFacility11 Archiving or Obsoleting a Facilityw-C$K11.15&KInvokingtheArchiveFacility Procedure11.1 Invoking the Archive Facility Procedurew*>$K11.20&KArchive/ObsoleteFacility Processing11.2 Archive/Obsolete Facility Processingw9P$K11.3B&K Suggestionsfor Archivingand Obsoleting Facilities11.3 Suggestions for Archiving and Obsoleting FacilitiesX* $\A\FutureMenuOptionsA Future Menu Options+gTABLESTABLESul(55=A2-1Specialinput recognizedbyPLMENU2- 1 Special input recognized by PLMENU} *0Y(OReleaseProjectLeaderMenuO:(PLMENU)ODIGITAL CONFIDENTIALOABSTRACTWOJAmenuoftoolstoperform masterpack operationsneededbytheVMS#OReleaseprojectleader._5&ORevision/Update Information^DRAFTwM'ORevision/Update Information:&^RevisionDate/April1992*   ( EyMVSCdoesnotevenrequiretheuseofCMSclasses,however?(theVMSsystembuildingtoolsuseCMSclasses.U  ;OPrefacex  5  OPLMENUFO,Thereleaseprojectleadermenuprovidesan interfaceBOtoperform functionswhich manipulatetheVDEVMSFOSourceControl(VSC)Databaseandit's underlyingCMSFO6 libraries..The operations availablefromthemenuareROusually performedbyareleaseprojectleaderorbyabuilder.KOMostofthemenu functionsrequirespecialVDE privilegesIO?not availabletothegeneralVMS developer.*TheprimaryLOpurposeofthemenuistoprovidea convenientmeansforNOthereleaseprojectleadertomaintainthe integritybetweenGOItheVMSsourcecontrol environmentandtheVMSsystem Obuilding environment. %QOTheVSCtoolisusedforsourcecontrolofVMS versions.'VSCMOusesaRDBdatabasetotrack reservations, replacementsandMO5otherupdatestoaVMSversion.)VSCusesCMS librariestoQOstoretheactualsourcecodechangesforaversion.' Presently,HOthereareovertwohundrecCMS libraries maintainedonFO>the masterpack.*EachCMSlibrarycontainsCMSclassesHOwhichmirroraVSCstreamstoredintheRDB database.FO MaintenanceoftheCMSclassesrequiresmuchoverheadNOHintermsofI/Oand processingtime.)Duetothis overhead,GOtheCMSclassesarenot completely maintainedbyVSC. OyFtVSCwillnotupdateCMSclassesonmany version-wideEOR operationssuchasstream creation,stream populationFOandstream renaming.*TheprojectleadermenuprovidesCOa convenientmeanstoperformCMScommandsontheGO[manyCMS librariestomirrortheVSCcommand.)FailureCOto successfullyperformtheCMScommandscancauseDO problemsbetweensourcecontrolandsystem building.* O'J P &KOVVMSsystembuildingrequiresaCMSclass representingtheOOtargetversiontobuild.* TypicallyabuildstreamiscreatedLOfromasnapshotofa developmentstream.(ThebuildstreamPO`isusedasthetargetversionofasystembuild.+CreatingaIObuildstream currentlyrequiresovereleventhousandRDBIOtableupdatesandovereleventhousand correspondingCMSEOjinsert generationcommandsintheVMS masterpackCMSKO libraries.-In addition,theCMSclassmustbecreatedinJOall applicableCMS librariesbefore performingtheinsertKOs generations.)Theprojectleadermenuprovidesamethodto9Ocreate,populateandrenamebuildstreams. _LOUPDATE:CMSClassesareoptionalforstreamscreatedafterOJanuary1993HOVMS developmentprojectscannowchosenottomaintainDOCMSclassesfortheirbuildstreams.2The VMSbuildHO3 proceduresandtheProjectLeaderMenutoolshavebeenKOmodifiedtofetchall generationsoftheVMSsourcecodeLOusingtheVDEdatabasealone.+The behaviourofthebuild,OO<andofthetools,is determinedbythevalueofalogical,5OVDE$FETCH_METHOD.IfVDE$FETCH_METHODisOO"VDE",thenthetoolsandthebuild procedureswillmaintainIOFonlytheVDElibrarywiththebuildstream generations. W>OItis importanttodefinetheVDE$FETCH_METHODDOlogicalinthe LOGIN.COMfilefortheaccountthatCO5willbe creating, populating,renamingandbuildingOstreams.@ThelogicalmustbedefinedforthebatchjobsHO submittedbythePLMENUtoolsandthelogicalmustbe5O>definedfortheVMSbuildbatchjobs.! aIOStream creation, populationandrenamingis significantlyNOfasterforstreamsthatdonotmaintainCMSclassesinallTO5theVMSfacility libraries.&Forexample,tocreateabuildclassKOforthe CORAL(V6.1)stream,takesabout6hourswiththeLOCMSclassesandabout40minuteswithouttheCMSclasses.JO>Stream populationtimesarealso drasticallyreduced.+TheQOsourcefetchingduringthebuildisalsomoreefficient(faster)LOusingtheVDE subprocesstofetchthesourcesratherthanFOHimage activatingCMStoperformeachfetch operation.nA D=OTable2-1:7Specialinput recognizedbyPLMENU O OFPromptInputaFAction Ob -O CtrlY,CtrlZ,"EXIT","QUIT"$a TerminatecurrentoptionO$ "Back","Prev"+a$ ReturntothepreviouspromptO "HELP","?"a Displayhelp O Z  VO 1.2 INTRODUCTIONZ,%"Quit"%or%"Exit"&to&exit% immediately5 6Choose%an%action%from%the%list%below:,(1)&Create%a&new%build%stream)(2)&Populate&a%build%stream /(3)&Rename%a&stream)w(4)&Set/Show&PLMENU%logicalsC(5)&Create%a& baselevel%stream%from%a&build&stream4(6)&Compare%VDE&to&CMS%for%a%stream'O(7)&Create%a&New%Facility<(8)&Populate&a%Stream&in&Selected& Facilities)(9)&Compare%Two&CMS%Streams-'(10)&Archive/Obsolete%a%FacilityFOWhat&action%do%you%want%to%perform?%(1-10,EXIT,HELP):jQOEachaction availablefromthemenuis describedindetailinOthis document._ h >4O 2.2PLMENU!Common!Prompts!and!FeaturesMOThissection describespromptswhicharecommontomostofJOthePLMENUoptions.)Thelogicalnames referencedinthisIOBsectioncanbeassignedvalueswiththeSet/ShowPLMENU*Ologicalsoptionofthemenu.JOTheprojectleadermenu functionsare performedbybatchLOjobswhichare submittedforyoubythemenu.,BatchjobsNO5areusedbecausethe functionsofthemenutakeminutesorNOhoursto complete.(Therearefive questionswhichareaskedPObyallthemenuoptionstocontrolthebatchjob attributes.MaOCommonPromptsHO4TherearefivepromptscommontothePLMENU functions. !  `mmProductRoot[VMS$]-(m:,TheproductrootdefinestheJVDEdatabaseandtheCMS librariesthataretobepro-Icessed.)TheproductrootwilldefaulttoVMS$.*YoucanJwoverridethisdefaultvaluebydefiningthelogicalname5PLMENU$DEFAULT_PRODUCTtoanothervalue.H(Thevalidproductroots availableareTOOLS$,VMS$and VMSTEST$. `/Queuetosubmitjob [SYS$LOBUILD]:YoumustJYgiveaqueueinwhichtorunthebatchjob.+ThebatchAqueuewilldefaultto SYS$LOBUILD.Youcanover-F ridethequeuedefaultvaluebydefiningthelogical3bnamePLMENU$DEFAULT_BATCH_QUEUEtoan-Aothervalue.-Notethatusingthe SYS$LOBUILDandB SYS$BUILDqueuesrequiresyoutoholdtheSYSTEM_/lBUILDERprocessrights identifier. `; Directoryforlogandworkfiles?- [default]|:-ThisLDpromptdefineswherethelogfileproducedbythesubmit-Ltedbatchjobwillbelocated.+Someofthemenuoptions,Glikepopulateabuildstream,produceworkfiles.-TheMMworkfilesproducedbya submittedjobwillbelocatedinLthis directory.(The directorywilldefaulttoyourcurrentJdefault directory.)Youcanoverridethe directorydefault;WbydefiningthelogicalnamePLMENU$DEFAULT_( DIRECTORYtoanothervalue. `/ +/ Timetosubmitjob?) [default]&/ :)ThebatchjobwillbeL  submittedtobegin executionatthetime specifiedbytheJ answertothisprompt.)ThedefaultvaluetothispromptC9 varies dependingonwhatmenuoptionyouareper-G forming.)Thedefault submissiontimeforanewstreamI createisusually midnight(it'sthecurrenttimeifyou@B areworkingonweekendsorbetweenmidnightandD 3:00AMon weekdays).,ThedefaultsubmittimeforaC VDE/CMSstream comparisonis"NOW"(submitthejobL  immediately). ` 0 Doyouwishtoproceed?) [default]3 :(Eachoptiondis-L$ playsasummaryofthejobtobe submittedandasksfor*| your confirmationtoproceed.OPromptfeaturesMO4Belowisasummaryofspecialstringsandinput recognized2Obytheprojectleadermenuprompts.  -O3.2Creating!a"New"Build!StreamMOdCreatinganewstreamisoneofthemost expensiveopera-JOtions performedontheVMSmasterpack.(Over11,000RDBJOupdatesand11,000CMSupdatesareneededtocreatetheOOnnewstream.*Duetothis overhead,itis undesirabletocre-JOateanewbuildstreamduringworkinghours.+ThecreateNOstreamoptionofthemenupromptsyouforalltheinforma-NOwtion necessaryto successfullycreateabuildstreaminthe>OVSCdatabaseandthe masterpackCMS libraries.! POThisoptionofthemenushouldalwaysbeusedtocreatenewLObuildstreams, regardlessofwhetherCMSclassesaremain-QOitainedorarenot maintainedforthebuildstream.&ThecreateLObuildstreamoptionavoidslockinguptheVDEdatabasebyOObreakingthecreatestreamintotwoseparate transactions.'ToNOrcreateastreamintheVDEdatabaseonly,remembertohaveCOthelogicalVDE$FETCH_METHODdefineto"VDE"beforeLO#invokingthemenu.+NOTE:ACMSclassisstillcreatedinMO|theVMS$:[SYS.CMS]librarybecauseofthesystembaselevelOupdating procedures. BOTheVDECREATESTREAMcommandexecutesasasin-FOgle transaction.(IftheVDECREATESTREAMcommandisGO5usedtocreateANDPOPULATEanewstream,thetrans-ROactioncreatingthestreamlocksoutallotherwriteaccesstoOOmuchoftheVDE database.'Thislockoutwouldbefrom30toKO>40minutesforthecurrent developmentstream size(V6.0&OCORAL).! }EOThecreatestreamoptionusestheVDECREATESTREAMEOcommandwiththe/NOGENERATIONS qualifier.'Thisqual-RO5ifiertellsVDEtonotinsertanyofthe generationsfromtheLOparentstreamintothenewlycreatedstream.(Thistransac-DOtiontakesabout1minute.)TheVDEPOPULATESTREAMJO>commandisthenusedtoinserttheparentstreammoduleEO generationsintothenewstream.'ThePOPULATESTREAMNOcommandusesmany transactionstoinsertsmallsetsofgen-LOHerationsintothenewstream.*Thesmall transactionsallowLOotherwriteaccessuserstoupdatethedatabasewhiletheKOpopulateisin progress.+Formore informationontheVDE@ORCREATESTREAMcommand,consulttheVDE referenceOmanual. ORequired PrivilegesMO4ThecreatebuildstreamoptionrequiresthattheuserholdOtheVDE privilegesCRESTRMandPERFREP andthepro-#Ocessrights identifiers#aVMS_ENABLE_CMSandVMS_O>SOURCED>.Iftheuserdoesnotholdthese privileges,the,O submittedbatchjobwillfail.g noD>O3.1BInvokingthecreatebuildstream procedureLOUTocreateanewbuildstream,selectoptiononefromtheEOmainmenu.*Thecreatebuildstreamcommand procedureO executes.HOWhat&action%do%you%want%to%perform?%(1-6,EXIT,HELP):&1-OCreate%Build%Stream&Version%X-1AO]Enter%?&or&"HELP"%at%any%prompt&to&obtain%helpFOPrompt%default%values%(if&any)%appear&in&brackets&[]FOEnter%,%"Quit"&or&"Exit"%to%exit& immediately tVProduct%Root&[VMS$]: u)OEntertheproductroot.,SeeIChapter2 fora definitionofOproductroot.* IFoO! POThenextpromptasksyoufortheparentstreamofthebuildOOstream.'TheparentstreamisthestreamforwhichthebuildMO5streamistobea snapshot.)Theparentstreammodulegen-JOerationsareusedtopopulatethenewbuildstream.-TheKObuildstreamwillbemarkedasa descendentofthepar-PO>entstream.(Theparentdefaultstothevalueoflogicalname7OPLMENU$DEFAULT_SOURCE_STREAM.Intheexam-QOplebelow,theuserentersstreamV5.5tocreateanewbuild%OHstreamforversionV5.5.@OParent%stream&for%new%build%stream&[V5.4]:%V5.5" {ROAfteryouentertheparentstreamyouwillbeaskedtosupplyNOthenewbuildstreamname.)Itisa conventioninVMSthatIO5thebuildstreamnamebeginwiththe developmentstreamOOnamefollowedbythestring"_BLD"andasuffix.)PleasetryOOtoadheretothis convention.(Intheexamplebelow,thenewHO>streamisnamed "V5.5_BLD_Z".+Youcandefinethelogi-9OcalPLMENU$DEFAULT_TARGET_STREAMtosuppya+Odefaultvaluetothisprompt.HttEnter%the&new%build%stream%name% [V5.5_BLD0]:% V5.5_BLD_Z#! OOThecreatestream procedurenowasksforaremarkstringtoNObe associatedwiththenewbuildstream.'ThisremarkstringJO5isusedfortheCMSclassesandtheVDEstreamremark.HOThisremarkis displayedbyaVSCshowstreamorCMSKOshowclasscommand.)Enteraremarkstring(noquotes)if3O>youdonotlikethedefaultremark.FORemark%string&for% V5.5_BLD_Z&[Build%stream%for&V5.5]: $ QOYouarenowaskedforthework directoryintowhichtoplaceNOthelogfileandworkfilesproducedbythe procedure.+TheEO5 submittedjobnameis formattedasCREATE_'new_build_FO stream_name'.*InourexamplethejobnameisCREATE_EO V55_BLD_Z.Periodsareremovedfromthebuildstream%O>stringinthejobname.Ot Directory&for%log%files%[WORK212:[SWEENEY.SCRATCH]]:% sys$scratch%zQOEnterthebatchqueuetosubmitthecreationjobatthenextOprompt.>taQueue%to%submit&create%job%[CLUSTER_LONGBATCH]:& uLOThe procedurepromptsyouforthetimetobeginthecre-NOatejob.'On weekdays,youarewarnedofpossible masterpackKO5disk contentionsifyouchooseatimebetween3:00AMandOO11:59PM.YoumaysubmitthejobattheenteredtimeifyouNOanswer affirmativelytothe"DoyouwanttosubmitthejobO>anyway?" question.9tTime%to%begin%create%job?% [TOMORROW]:%NOWdO,Due%to%lock% conflicts%and&disk% contention%on%the%master&pack,&this%job&shouldbOtbe% submitted%after%12:00AM%and%before&3:00AM%on%working&days.KIt%is%stronglySOadvised&to&avoid&creating&a%stream&during%regular&working%hours.@t%Do%you&want%to%submit&the%job%anyway?%[N]:BACKDtTime%to%begin%create%job?% [TOMORROW]:%TOMORROW+01:00' $LOYouareaskedtoconfirmyourinputandsubmitthebatchOjob.StYou&are% attempting&to&create%a&new%build%stream,& V5.5_BLD_Z%for$t development%stream&V5.5.-t3Do%you&wish%to%proceed?%[Yes]:.O{ Validating&stream%V5.5&in&VDE...4O Validating&stream% V5.5_BLD_Z&in&VDE...lO Job%CREATE_V55_BLD_Z%(queue%CLUSTER_LONGBATCH,&entry&633)%holding%untilJ 10-APR-1992%01:00h*>>O3.3B Suggestionsforcreatingnewbuildstreams+! z `mKmIt'sagoodideatoplanaheadandcreatebuildstreamsLbeforeyouactuallyneedthem,butdon'tcreatemorethanyouneed! `GPlease coordinateyourstream creationswithotherVMSG developmentprojectssothatyourstreamcreationdoesIOnot interferewithasystembuildorwithotherstream creations. `'N'ItisnotusefultoattempttocreatemorethanonebuildKstreamatthesametimebecausetherewillbemanycon-Kflictsonthe masterpack.)IfyouneedtocreatemultipleN0streamsitis suggestedthatyouspacethesubmittimesby!atleastfourhours. `NIfthecreateastreambatchjobfails,therecoverysteps9avary dependinguponwherethejobfailed.@,  hJYhIfthejobfailsbeforetheVDEstreamiscreated,re-AYrunthecreateastream procedurefromthemenuFYandusethesameinput.(The restartedbatchjobmayEYqgiveyouwarningsthattheCMSclassalreadyexistsYinsome facilities. IGYIIfthebatchjobfailsaftertheVDEstreamiscre-FYated,usethepopulatestreamoptionofthemenutoAYpopulateyournewstreamfromtheparentstream. zJYzIfyourjobfailsduetoa privilegeproblem,youneedFYyourVMSorVDEuserprofilechangedtoincludeallJY+the privilegesand identifiersnotedinthe beginningofYthischapter.:-! )V*O 4.2 Populating!a!build"StreamOOStream populationrefersto producingasnapshotofastreamOOatsomepointintime.&VMSbuildstreamsare populatedfromNOBaVMS developmentstreamandthenusedasinputtoasys-NOtembuild.)Theoverheadof populatingabuildstreamvariesKO dependinguponhow"close"thetargetbuildstreammoduleIOL generationsaretothe developmentstreammodulegenera-QOtions.)Ifthereareonlyafew differencesbetweenthetargetJObuildstreamandthe developmentstream,thenapopulatePOUcanbe completedinamatterofminutes.(IfthetwostreamsMOdivergesignificantly,thenthepopulatestreamoverheadde-MO generatesclosetothecreatestream overhead.)ThepopulateNO_streamoptionofthemenupromptsyouforalltheinforma-NOtion necessaryto successfullypopulateastreamintheVSC=Odatabaseandinthe masterpackCMS libraries..! WNOThepopulatebuildstreamoptionoftheprojectleadermenuLOisupdatedtoprocessbuildstreamswhichdonotmaintainOO5CMSclasses.&Theoption'scurrent behaviourtopopulatebuildJOstreams maintainedinbothVDEandCMSis retained.)TheDOvalueofthelogicalVDE$FETCH_METHOD determineshow2O>thebuildstreamwillbe populated.9/! AOTheVDE$FETCH_METHODlogicalisusedbythemenuLOoptionANDbythebatchstream submittedto determinehowFO5topopulatethestream.'IftheVDE$FETCH_METHODlogi-ROcalvalueisVDE,thestreamis populatedintheVDEdatabaseHOonly.'IftheVDE$FETCH_METHODlogicalvalueisnotVDERO>or undefined,thejobtriestopopulatethestreaminVDEandEOCMS.IftheVDE$FETCH_METHODlogicalissettoVDE,NOthereisnotimewarningsforwhenaVDEonlystreampop-MOHulateshouldrun.,IfCMSclassesaretobe populated,theOOoptionwillwarntheuserabout populatingthestreamduring!Onormalworkinghours.0L IOIfyourbuildstreamsdonotmaintainCMSclasses,you@OmaychoosetousetheVDEPOPULATESTREAMcom-KO5manddirectlyfromVSCtopopulateyoubuildstream.*The>OPOPULATESTREAMcommandrequirestheuserhold@OtheVDE privilegePERFREP.TheVDEFROZENpriv-LO>ilegemustalsobeheldbytheuserifthebuildstreamKOstateisfrozen.,SeetheVDE referencemanualforade-CO scriptionofthePOPULATESTREAMcommand.*Thefile>OHVMSCMS$:POPSTRM.COMcontainsthepopulatestreamFOcommandusedto currentlypopulatebuildstreams.-TheOcommandformatis:ZO~$&VDE%SET%PRIV%FROZEN;POPULATE%STREAM/FROM='parent_stream'&'target_stream'.Owhich%could%be%used&in&VSC%as:OPVSC>SET&PRIV%FROZENDO VSC>POPULATE%STREAM/FROM='parent_stream'&'target_stream'1ORequired PrivilegesOO4ThepopulatebuildstreamoptionrequiresthattheuserholdOtheVDE privilegesFROZENandPERFREPandthepro-#Ocessrights identifiers#aVMS_ENABLE_CMSandVMS_O>SOURCED>.Iftheuserdoesnotholdthese privileges,the,O submittedbatchjobwillfail.<! (} EyTThetargetclasswillbecreatedintheCMSlibraryifitdoes(notalreadyexist. M2 #9O4.1BInvokingthepopulatestream procedureOOUTopopulateastream,selectoptiontwofromthemainmenu.>OThepopulatestreamcommand procedure executes.Ht2What%action%do%you&want%to%perform?%(1-6,EXIT,HELP):%2(tPopulate%Stream&Version%X-1AtEnter%?%or%"HELP"%at%any&prompt%to%obtain%helpFtLPrompt&default%values&(if%any)&appear%in%brackets%[]FtEnter%,&"Quit"%or%"Exit"%to%exit% immediately Product%Root%[VMS$]:3u)OEntertheproductroot.,SeeIChapter2 fora definitionofOproductroot.*3IFoOb4 58LONextyouareaskedforthesourcestreamforthepopula-OOtion.*Thesourcestreamisthestreamtopopulatefrom,or,RO5ifyoulike,thestreamtocopy.)UsuallythesourcestreamisKOaVMS developmentstream,butthisisnota requirement.ROThesourcestreamissimilartotheparentstreamofthecre-QO>atestreamoption.'Thesourcestreamdefaultstothevalueof6OlogicalnamePLMENU$DEFAULT_SOURCE_STREAM.'OSource%Stream&[V5.4]:%V5.55! MOUponenteringthesourcestreamyouwillbeaskedfortheQOtargetstreamto populate.)ThisisusuallyabuildstreamforHO5a developmentproject.+ThetargetstreammusthavetheKOVDEstream population attributesetforthis proceduretoQOwork.'Thetargetstreamdefaultstothevalueoflogicalname'O>PLMENU$DEFAULT_TARGET_STREAM.%tTarget&Stream:% V5.5_BLD_Z6zLOThepopulatestreamjobnowpromptsyouforthequeueto&Osubmitthepopulatejobs.AOaQueue%to%submit%populate%jobs%[CLUSTER_LONGBATCH]:7 +yQOYouarenowaskedforthework directoryintowhichtoplaceNOthelogfileandworkfilesproducedbythe procedure.+TheHO5 submittedjobnameis formattedas'target_stream_name'_DOPOP.InourexamplethejobnameisV55_BLD_Z_POP.Nt Directory&for%logs&and%work&files&[WORK212:[SWEENEY.SCRATCH]]:8q POThe procedurepromptsyouforthetimetobeginthepopulateIOjob.+On weekdays,youarewarnedofpossible masterpackKO5disk contentionsifyouchooseatimebetween5:00AMandNO6:00PM.YoumaysubmitthejobattheenteredtimeifyouPOanswer affirmativelytothe"Doyoustillwanttosubmitthe8O>jobattheenteredtime?'[N]:" question.ZtTime%to%begin% submission&of&populate&jobs?&[% 9-APR-1992% 18:00:00]:&NOW`t,Due&to&locking% contention%on%the%master&pack,&this%job&should%be% submittedWttafter%6:00PM&and%before%5:00AM&on& weekdays.JIt%is%advised%to%avoidZt submitting% populations%during%regular%working&hours&unless%you%are&surePtthe&source%stream%and&the%target%stream&are%almost% identical.XmDo&you%still%want&to&submit%the%job&at&the%entered&time?&[N]:%YES9| ZKOYouarefinallyaskedtoconfirmyour populationrequest.AtPopulate%stream& V5.5_BLD_Z%from%stream%V5.5?%[Y]:.OP Validating&stream%V5.5&in&VDE...4O Validating&stream% V5.5_BLD_Z&in&VDE...lOJob% V55_BLD_Z_POP%(queue%CLUSTER_LONGBATCH,&entry&633)%started%on%queue%CLUSTER_LONGBATCH:)+O4.2BPopulateStream ProcessingKOUThepopulatestreambatchjob maintainsastatusfiletoJOindicatethecurrentstateofthestream population.-AnyIOwarningsorerrors encounteredduringthe populationareSO^markedinthisfile.(A populationstatusismailedtotheuserNOupon completionofthepopulatejob.*Thepopulatebatchjob2O processingis summarizedasfollows:=;! 5LjmIJThetargetVDEstreamis populatedfromthesourceVDEGstream.(The populationisbrokendownintomanysmallFRDB transactionstoavoidinglockingoutotherupdateMwusageonthe masterpack.(Ifanyerrorisdetectedatthis2pointthebatchjobwill terminate.KJOIIJThe proceduresubmitsabatchjobtoperformtheCMS@insert generationcommandsforevery non-archived7facilitywhichallowschange propagation.H*IIIJEachCMSinsert generation procedurechecksiftheKsourcestreamexistsinthefacilityCMSlibrary.*IftheJ0sourcestreamdoesnotexist,awarningmessagewillbeRoutputinthelogfileandintothe procedurestatusfile.(IfJthesourcestreamexists,thetargetstreamis populated:fromthesource. D:yN4IVJThe procedurewaitsforthehundredsofCMSinsertgen-Merationbatchjobsto complete.&WhenalljobsarecompleteLjthestatusfileischeckedforerrors.)Theuserwhosub-Lmittedthejobwillreceiveamailmessage indicatingthe&statusofthe population.*;D'J<Y?=! ;O4.3B Suggestionsfor populatingbuildstreams `N5NNEVERDELETEAN EXECUTINGCMSPOPULATE JOBFROMTHEQUEUE.'Animproper terminationofCaCMSinsert generationcommandcancorruptaCMSMXlibraryso,pleasedon'tdeletetheCMS populationjobs.(AMfutureversionofCMSissupposedtocorrectthisproblem.H IfyouneedtostopCMS populationjobsfromprocess-Mbing,thejobscanbestoppedbydefiningthelogicalnameBFAC$ABORT_POPLIBSinthesystemlogicalnametableAonallrelevantnodes.(TheFAC$ABORT_POPLIBSlog-JlicalstopsALLpopulatejobsfrom processing.)AfteryourPjobshavestopped,besuretodeassignthislogicaltoallow5future populationstorun successfully. `JIfthestreamyouare populatingisvery differentfromDthesourcestream,pleasedon'tsubmitthepopulate,Mduring "regular"workinghours. `JDon'tpanicifyoureceivewarningmessagesinthepop-H%ulationstatus.+Theremaybe facilitiesforfutureVMSE}releasesthatarenot applicabletoyour developmentstream. `UKUIfyouaregoingtodoabuildwiththetargetstream,Lit'snotwisetoallowchangestothesourcestreamdur-H ingthe population.+Ifyouallow replacementsintotheG_  developmentstreamduringthe population,theVDErep-K  resentationofthebuildstreamwilldifferfromtheCMSM representationofthebuildstream.'ThiscouldbeasourceHi of confusionafterthebuild.+ Remember,itistheCMSJ representationofthestreamthatisusedtobuildVMS. `A GA Ifyourpopulatestreamjobfails,rerunthepopulate* streamusingthesameinput.5 > s!O 5.2Renaming!a"StreamIORenamingastreamrequiresupdatingtheVDEstreamnameJOandtheCMSfacilityclassnames.(Renamestreamprocess-JOBingcanbe performedduringnormalworkinghoursbecauseNOitdoesnotlockuptheVDEdatabaseorCMS librariesfor'O prolongedperiodsoftime.?! kwNOTherenamestreamoptionoftheprojectleadermenuisup-MOdatedtoprocessstreamswhichdonotmaintainCMSclassesLO5aswellasstreamsthatdomaintainCMSclasses.)Theop-LOtion determineswhetherCMSclassesare maintainedfortheEOstreambythevalueofthelogicalVDE$FETCH_METHOD.FO>TheVDE$FETCH_METHODlogicalisusedbythemenuop-NOtionANDbythebatchstream submittedto determinehowtoBOrenamethestream.)IftheVDE$FETCH_METHODlogicalPOHvalueisVDE,thestreamisrenamedintheVDEdatabaseandDOtheVMS$SYSfacilityonly.)IftheVDE$FETCH_METHODSOlogicalvalueisnotVDEor undefined,thejobtriestorenameBORthestreaminVDEandallproductCMS libraries.X@e.NOIfyourbuildstreamsdonotmaintainCMSclasses,youcan;OusetheVDEMODIFY STREAM/NAME=commanddi-CO5rectlyfromVSCtorenameyourstream.-TheMODIFYIOSTREAMcommandrequirestheuserholdtheVDE privilegeFOMODSTRM.SeetheVDE referencemanualforadescrip-CO>tionoftheMODIFYSTREAMcommand.*RemeberifyouMOare modifyingaVMSstream,youwillstillneedtorenameKOtheCMSclassintheSYSfacilitybecausetheCMSclassMOHstillneedstobe maintainedforthesystem baselevelpro-OOcedures.*However,ifyoudonotplantousethestreamforLObuildinginthefuture,youmayomittheCMSrename.(The:ORfileVMSCMS$:RENSTRM.COMcontainstheMODIFYEOSTREAMcommandusedto currentlyrenamestreams.(TheOcommandformatis:aO$KVDE%Set&priv%MODSTRM;%Modify&#stream'remark_qual'/name='new_name'& 'stream_name'.Owhich%could%be%used&in&VSC%as: OZVSC>SET&PRIV%MODSTRM^O VSC>modify&stream/remark="BLADE& Baselevel%X999"/name=BLADE_X999_BLDN% BLADE_BLD_N>O DON'T%FORGET%THIS%WHEN&RENAMING&A%VMS&STREAM.,Ot$&Set%command&VMSCMS$:FACRENAMEfO$!% facrename%will%prompt%you&for%the%stream&to&rename%and%the&new%name&if&you*O$!%omit&the% parameter%valueslOL$&facrename/log=all/remark="BLADE% Baselevel&X999"&VMS$:[SYS.cms]K BLADE_BLD_N%BLADE_X999_BLDNA W[ORequired PrivilegesKO4TherenamestreamoptionrequiresthattheuserholdtheOVDE privilegeZMODSTRM09andtheprocessrights identifiers)OVMS_ENABLE_CMSand VMS_SOURCE .IftheuserdoesPO>notholdthese privileges,the submittedbatchjobwillfail.  ;B! 7O5.1BInvokingtherenamestream procedureOOUTorenameastream,selectoptionthreefromthemainmenu.,%"Quit"&or&"Exit"%to%exit& immediately tProduct%Root&[VMS$]:Cu)OEntertheproductroot.,SeeIChapter2 fora definitionofOproductroot.*CIFoODLOThenextpromptasksyouforthestreamyouwanttore-JOname.,Thispromptdefaultstothevalueoflogicalname'O5PLMENU$DEFAULT_SOURCE_STREAM.1tStream&to&rename%[V5.4]:& V5.5_BLD_ZEFOYouareaskedtosupplyanewnameforthestream.COThis prompt defaults!to the!value of!logical name'O5PLMENU$DEFAULT_TARGET_STREAM.+tNew&Stream%Name&[V5.5_BLD_10]:]F 3POYoucannowenteranewremarkstringtobe associatedwithKOtherenamedstream.(Thestream'scurrentremarkstringisHO5retainedifyoudonotenteravaluetothisprompt.PtNew&remark%string%for&stream% V5.5_BLD_10%[Use&current%remark]:G! zLOEnterthework directorywhereyouwanttherenamestream Ologfiletoreside.AOa Directory%for&log%file&[WORK212:[SWEENEY.SCRATCH]]:HzKOEnterthequeueinwhichtoruntherenamestreambatchOjob.>OaQueue%to%submit%rename&job%[CLUSTER_LONGBATCH]:I LOYouareaskedtoconfirmyourinputandproceedwiththeOstreamrename.StIf%you&proceed%you&will%rename&stream% V5.5_BLD_Z&to& V5.5_BLD_10.-tDo%you&wish%to%proceed?%[Yes]:4O Validating&stream% V5.5_BLD_Z&in&VDE...5OZ Validating&stream% V5.5_BLD_10%in%VDE...oOJob%RENAME_V55_BLD_Z%(queue%CLUSTER_LONGBATCH,&entry&633)%started%on%queue%CLUSTER_LONGBATCHJnt)O5.2BRenameStream ProcessingKOUThe processingstepsoftherenamestreambatchjobare:KJjmIJTheoldCMSclassnameinall non-archived, propagat-Mingfacility librariesismodifiedtothenewstreamname.MAnewstreamremarkisattachedtotheclassiftheuser#wsuppliedanewremark.MJIIJAfteralltheCMSlibraryclassesarerenamed,theVDEDOstreamismodifiedtothenewstreamnameandnewstreamremark.jN 2@ EyMStrictlyspeakingthestreamisnotfrozenbecausetheVDE@(INSERT GENERATIONcommandcanbeusedtoupdateFthe baselevelstream,butthepopulatestreamcommandFandthereserve/replacecommandsaredisabledforthe2 baselevelstream.L! 2O5.3B Suggestionsforrenamingstreams `{M{Ifarenamestreamjobfails,itis sufficienttorestartKthejobassumingthefailurewasnotduetoa privilege- violation. `BTrytoretaina consistentnaming conventionwhenIrenamingstreams.(Thiswillprovideforeasier interpre-N]tationofwhatastream representsafteryou'vegoneontootherthings. `5F5Makesureyoureadthe confirmationprompttoinsureIyouarerenamingthecorrectstream.(Youdon'twantto7renameaVMSversion developmentstream!M n,%"Quit"&or&"Exit"%to%exit& immediately tVProduct%Root&[VMS$]:Qu)OEntertheproductroot.,SeeIChapter2 fora definitionofOproductroot.*QIFoORNOThenextpromptasksyouforthebuildstreamyouwanttoLOrename.+Thispromptdefaultstothevalueoflogicalname'O5PLMENU$DEFAULT_SOURCE_STREAM.0tBuild%stream&to&rename:% V5.5_BLD_ZSOOAfteryouinputthestreamtorenameyouareaskedfortheMOsystem baselevelnumber associatedwiththeresultdiskforO5thebuildstream.0tResult&disk% baselevel&number:%X999T! +eQOThenextprompt encounteredisusedtoindicateifthisbase-WOlevelisaninternalfield test(IFT)versionorexternalfieldtestRO5(EFT)version.(Ifthis baselevelisnotanIFTorEFTversion+Oenter"other"tothisprompt.@t Baselevel&type%(EFT,%IFT&or&OTHER)%[OTHER]:%EFTUzSOYouareaskedifyouwishtoappendasuffixtothe baselevelOstreamname.FOaSuffix%to%append&to&stream% V5.5_X999_EFT& [NONE]:_BLD_ZV zPOYoucannowenteraremarkstringtobe associatedwiththeO baselevel.QtaRemark&string%for%V5.5_X999_EFT_BLD_Z%[V5.5%EFT% baselevel&X999]:W! zOOEnterthework directorywhereyouwanttherenamelogfileOtoreside.AOa Directory%for&log%file&[WORK212:[SWEENEY.SCRATCH]]:XzKOEnterthequeueinwhichtoruntherenamestreambatchOjob.>OaQueue%to%submit%rename&job%[CLUSTER_LONGBATCH]:+Y LOYouareaskedtoconfirmyourinputandproceedwiththeOstream renaming.[tIf%you&proceed%you&will%rename&stream% V5.5_BLD_Z&to&V5.5_X999_EFT_BLD_Z.StStream&V5.5_X999_EFT_BLD_Z%will%be%frozen%and&cannot%be% populated=tfrom%the%populate%stream&option%of%the%menu.-t{Do%you&wish%to%proceed?%[Yes]:4O Validating&stream% V5.5_BLD_Z&in&VDE...=O  Validating&stream%V5.5_X999_EFT_BLD_Z&in&VDE...\OS%VDE-I-STRMMOD,% information%for&stream% V5.5_BLD_Z&modified&in&the%databaseMO%VDE-I-COMMIT,%database% transaction%has% successfully& committedhOJob%RENAME_V55_BLD_Z%(queue%CLUSTER_LONGBATCH,&entry&329)%started%on%CLUSTER_LONGBATCHy !_Z 54O6.2BCreate BaselevelStream ProcessingIOUThecreate baselevelstream proceduremodifiesthebuildKOstreamtodisallowthe populationoftheVDEstream.+TheJO procedurethensubmitsthesamerenamestreambatchpro-IO^cedureasusedintherenamestreamoption.*TherenameMOstreambatchjobfirstmodifiesalltheCMSfacilityclassFOnamestothenewstreamname.-AftertheCMSlibraryGOhclassesarerenamed,theVDEstreamnameis modified.! "[! =O6.3B SuggestionsforCreating BaselevelStreams `{Q{Ifarenamestreamjobfailsitis sufficienttorestarttheJjobassumingitdidnotfailfora privilege violation. `SNSThisoptionis availabletoretaina consistentnamingcon-Jventionacross developmentstreams.(IfyouprefertouseGtherenamestreamoptionpleasetrytoadheretothe8]naming conventionusedinthis procedure. `FMakesureyoureadthe confirmationprompttoinsureI5youarerenamingthecorrectstream.(Youdon'twantto7renameaVMSversion developmentstream!I"!#Z\0%O 7.2 Comparing!VDE"to!CMSPOThisoptionsallowsyoutocheckthe consistencyofastreamDOrepresentationbetweenVDEandCMS.Themodulegen-JOBerationsintheVDEdatabasearecomparedtothemodule-O generationsintheCMSlibrary.]ORequired Privileges+O4Theprocessrights identifiers|4 (VMS_SOURCEorVMS_+O SOURCE_READ)andVMS_ENABLE_CMSare required. # "$F^8O7.1BInvokingthecomparestream procedureLOUTheVDEtoCMS comparisonutilityisinvokedby selecting,%"Quit"&or&"Exit"%to%exit& immediately tProduct%Root&[VMS$]:_z)OEntertheproductroot.(See=Chapter2%fora definitionoftheOproductroot.*_=FmO`MOThenextpromptasksyouforthestreamyouwanttocom-JOpare..Thispromptdefaultstothevalueoflogicalname'O5PLMENU$DEFAULT_SOURCE_STREAM.&tStream&to&compare%[V5.4]:azPOEnterthework directorywhereyouwantthe utility'sfile(s)Otoreside.BOa Directory%for&log%files%[WORK212:[SWEENEY.SCRATCH]]:bzLOEnterthequeueinwhichtorunthecomparestreambatchOjob.?OaQueue%to%submit%compare%job%[CLUSTER_LONGBATCH]:c OOIndicateifyouwantthereportofstream differencestobeUO displayedinthelogfile (default)orwrittentoaseparatere-YO5portfile.'Ifyoudonotgivea directory specificationtothefileOOname,thereportwillbelocatedinthework directory.*The(Odefaultfiletypeis.LIS.-OkReport%file%name&?%[LOG]:&TESTd 5]POEnterthefacilitytoprocess.)Bydefault,the proceduresub-EOmittedwillcompareVDEtoCMSforall non-archivedQO5 facilitiesintheproductroot.*Archived facilitiesareskippedMObythe procedure.' Facilitiesmarkedno propagationarecom-OOparedbythis procedure.)YoumayenterafullfacilitynameMO>orapartialfacilitynamewith wildcards.*ForexampleyouOmayenterSYS h*=toprocessall facilities beginningwithSYS.-OFacility%to%process&[ALL]:JSYS*.e! OOThe procedurepromptsyouforthetimetobeginthecompareUOjob.'Thisoptionisareadonlyfunctionsothereisnowarning)O5noticeonanyenteredtime.7OTime&to&submit%compare&job?% [NOW]:+00:01Bf BOYouareaskedtoconfirmyour comparisonrequest.ZtIf%you&proceed%you&will%submit&a%job&to&compare%stream&V5.4%for&allJtP facilities%matching%the%file% specification&VMS$:[SYS*.CMS].Dt Differences%in%the&stream%will&be&reported&to&file,t"WORK212:[SWEENEY.SCRATCH]TEST.LIS;-tIDo%you&wish%to%proceed?%[Yes]:.O Validating&stream%V5.4&in&VDE...gOJob% V54_COMPARE%(queue&CLUSTER_LONGBATCH,%entry%526)&holding%until% 13-APR-1992%09:17$#%g )*O7.2BCompareStream ProcessingIOUThecomparestreamutilitycomparesthestreamforeachMOfacilitymatchingtheenteredspecification.*Foreachfacil-ROity,amessageis displayedtothelogfile indicatingwhetherHO^theVDEstreamandtheCMSclassdifferedormatched.SO Differencesarereportedtothelocation specifiedinthereportOfileprompt.%$&h3O7.3B Suggestionsfor ComparingStreams `{A{Therearesomeknown differencesbetweenCMSand@VDEthatcanbeignored.'These differencesare:i Bh1.JBASE_LEVEL.MARinfacilitySYS.ThismoduleisCYupdatedinCMSonlybythesystembuildingtools.=@2.J Facilities AAA_VDE_TESTand YELLOW_TESTareHYtesting facilitiesforthetoolsgroup.*Any differences?Y encounteredinthese facilitiesmaybeignored. `pBpA differencebetweenVDEandCMSmaybethere-KsultofarolledbackVDE transaction.*The differenceisI!self-correctingoncethe transactionisrun successfully. `LAs mentionedinthepopulatestreamsection,ifyouallowJchangestoasourcestreamduringa population,youmayKR encounter differencesinthetargetstreamafterthepop-Mulation.)ThisisduetothefactthattheCMS populations>takeplaceaftertheVDEstreamis populated.3&%'Xj .(O 8.2Creating!a"New"FacilityMOWhenyouneedtocreateanewfacilityonthe masterpack,UOyoucanusethisoptiontocreatethe facility.'Thisoptioncre-MOBatesthenewfacilityintheVDEdatabaseandcreatestheQOfacilityCMSlibrary.'TheutilitycreatesthreemodulesintheROfacilitywhicharetemplatefilestobeusedforsystembuild-ROLing.+Theutilityalsosetsupno propagation facilitiesinthe"Omost efficientmanner.k ~ROThefacilityiscreatedinteractively.'Thereisnobatchproce-,Odure submittedbythisoption.lORequired PrivilegesO4TheVDE privilege4CREFAC.y4isrequiredtorunthisoption.+OTheprocessrights identifiersy VMS_SOURCEandVMS_O ENABLE_CMSare required.u '&(<m! 9O8.1BInvokingthecreatefacility procedureQOUTorunthecreatefacility procedure,chooseoptionsevenfrom+Otheprojectleadermainmenu.HO2What&action%do%you%want%to%perform?%(1-7,EXIT,HELP):&7(OCreate%Facility%Version%X-1AOEnter%?&or&"HELP"%at%any%prompt&to&obtain%helpFOLPrompt%default%values%(if&any)%appear&in&brackets&[]DOEnter%Z,%"Quit"%or%"Exit"&to&exit% immediately"tProduct%Root& [TOOLS$]:nz)OEntertheproductroot.(See=Chapter2%fora definitionoftheOproductroot.*n=FmOo! MOAstreamneedstobedefinedforthe facility.,ThestreamMOshouldbethefirst developmentstreaminwhichyouexpectPO5the componentsofthisfacilitytoship.+Forexample,ifyouWOarecreatingafacilitytoholdtheupdatefilesforversionV5.5,4OyouwouldenterV5.5tothisprompt.EtkFacility%begins&with%what% development%stream?&[MAIN]:p bnOOEnterthenewfacilityname.)TheproductrootischeckedtoUOseeifaCMSlibraryforthisfacilityalreadyexists.(IfaCMSSOURCED>.Iftheuserdoesnotholdthese privileges,the,O submittedbatchjobwillfail.-! (} EyTThetargetclasswillbecreatedintheCMSlibraryifitdoes(notalreadyexist.+*,xzoN=O9.1BInvokingthepopulate facilities procedurePOUTopopulateastreaminselected facilities,useoptioneightDOfromthemainmenu.-Thepopulate facilitiescommandO procedure executes.HtWhat%action%do%you&want%to%perform?%(1-6,EXIT,HELP):%8,OPopulate% Facilities&Version%X-1AO]Enter%?&or&"HELP"%at%any%prompt&to&obtain%helpFOPrompt%default%values%(if&any)%appear&in&brackets&[]DOEnter%Z,%"Quit"%or%"Exit"&to&exit% immediately tVProduct%Root&[VMS$]:{u)OEntertheproductroot.,SeeIChapter2 fora definitionofOproductroot.*{IFoO| YPONextyouareaskedforthesourcestreamforthe population.QOThesourcestreamisthestreamtopopulatefrom,or,ifyouPO5like,thestreamforwhichtocreatea snapshot.)UsuallytheMOsourcestreamisaVMS developmentstreambutthisisnotLOa requirement.+ThesourcestreamissimilartotheparentLO>streamofthecreatestreamoption.)Thesourcestreamde-DOfaultstothevalueoflogicalnamePLMENU$DEFAULT_OSOURCE_STREAM.'OtSource%Stream&[V5.4]:%V5.5}! MOUponenteringthesourcestreamyouwillbeaskedfortheQOtargetstreamto populate.)ThisisusuallyabuildstreamforHO5a developmentproject.+ThetargetstreammusthavetheKOVDEstream population attributesetforthis proceduretoQOwork.'Thetargetstreamdefaultstothevalueoflogicalname'O>PLMENU$DEFAULT_TARGET_STREAM.%tTarget&Stream:% V5.5_BLD_Z~ .`NOThenextquestionisusedto determineifyouwanttoin-TO teractivelyenteralistof facilitiestoprocess.*IfyouanswerRO5 affirmativelytothis question,youarepromptedforalistofRO facilities.)Ifyouanswer"N"otothis question,youareaskedEOtosupplyafilelistingthe facilitiestoprocess.MtkDo%you&want%to%enter%the& facilities%to%process?%[Y]:%help_ Answer%"Y"es%if%you%want%to% interactively&enter&the% facilities&to&process.[ If&you%answer%no,&you%will&be&expected&to&supply%the%name%of%a&file\ dwhich&lists&the% facilities&to&process.KEnter%BACK&or&PREV%to%return&to& the%target%stream&prompt.L Do&you%want&to&enter&the% facilities&to&process?& [Y]:=9OEnterthelistof facilitiesto populate.stEnter%a%list&of& facilities% delimited&by& commas(,)(256% character&maximum)&Hit%%to%finishOP:&helpcEnter%a%list&of&facility&names& delimited%by%commas%","&or&enter&one%facilityUname.KEnter&BACK%or%PREV%to%return%to%the&facility&input&prompt.stkEnter%a%list&of& facilities% delimited&by& commas(,)(256% character&maximum)&Hit%%to%finish+t:%sys,sysloa,driver,starlet! WOIfyoudidnotindicateyouwantedtoenteralistof facilities,\Oyouareaskedforthelocationofafilethatliststhe facilitiestoVO5process.'ThefilemustbeatextfilewithonefacilitynameperUOrecord.(Forexample,thefilebelowisusedtoprocess facilities$ODRIVER,SYSandSYSLOA.0Ok$&type%work$:[Sweeney.tools]facs.dat tSYStSYSLOAtBDRIVER O$* TOEnterthefacilitylistfilespecification.'Yourdefault directoryVOissearchedforthefileifyouomitthe directoryfromthefileO5specification.>tFacility%List%File:%work$:[Sweeney.tools]facs.dat2! LOThenextpromptisusedtoindicatehowtheVDEdatabaseOOandCMS librariesaretobe populated.)Ifyouwanttopop-IO5ulatethestreaminboththeVDEdatabaseandtheCMSPO librariesenter"BOTH"tothisprompt.'IfyouwanttoupdateMOtheVDEdatabaseonly,enter"VDE"tothisprompt.*IfyouQO>wanttopopulateonlythefacility"CMS" libraries,enterCMS.6tPopulate%CMS,%VDE%or%BOTH%[BOTH]:&BOTHzLOThepopulatestreamjobnowpromptsyouforthequeueto&Osubmitthepopulatejobs.@OaQueue%to%submit%populate%jobs%[CLUSTER_LONGBATCH] +yQOYouarenowaskedforthework directoryintowhichtoplaceNOthelogfileandworkfilesproducedbythe procedure.+TheHO5 submittedjobnameis formattedas'target_stream_name'_DOPOP.InourexamplethejobnameisV55_BLD_Z_POP.Nt Directory&for%logs&and%work&files&[WORK212:[SWEENEY.SCRATCH]]:q POThe procedurepromptsyouforthetimetobeginthepopulateIOjob.+On weekdays,youarewarnedofpossible masterpackKO5disk contentionsifyouchooseatimebetween5:00AMandNO5:00PM.YoumaysubmitthejobattheenteredtimeifyouPOanswer affirmativelytothe"Doyoustillwanttosubmitthe8O>jobattheenteredtime?'[N]:" question.ZtTime%to%begin% submission&of&populate&jobs?&[% 9-APR-1992% 17:00:00]:&NOW`t,Due&to&locking% contention%on%the%master&pack,&this%job&should%be% submittedWttafter%5:00PM&and%before%5:00AM&on& weekdays.JIt%is%advised%to%avoidZt submitting% populations%during%regular%working&hours&unless%you%are&surePtthe&source%stream%and&the%target%stream&are%almost% identical.XmDo&you%still%want&to&submit%the%job&at&the%entered&time?&[N]:%YES| BOYouareaskedtoconfirmyour populationrequest.QtIf%you&proceed%you&will%populate%stream& V5.5_BLD_Z%from%streamPtPV5.5%for%the& facilities%listed&in&work$:[Sweeney.tools]facs.dat.+tDo%you&wish%to%proceed?%[Y]:.O Validating&stream%V5.5&in&VDE...4OI Validating&stream% V5.5_BLD_Z&in&VDE...lOJob% V55_BLD_Z_POP%(queue%CLUSTER_LONGBATCH,&entry&633)%started%on%queue%CLUSTER_LONGBATCH[,+. )/O9.2BPopulate Facilities ProcessingKOUThepopulatestreambatchjob maintainsastatusfiletoJOindicatethecurrentstateofthestream population.-AnyIOwarningsorerrors encounteredduringthe populationareSO^markedinthisfile.(A populationstatusismailedtotheuserNOupon completionofthepopulatejob.*Thepopulatebatchjob2O processingis summarizedasfollows: ! >LjmIJThetargetVDEstreamis populatedfromthesourceVDEGstream.(The populationisbrokendownintomanysmallFRDB transactionstoavoidinglockingoutotherupdateMwusageonthe masterpack.(IfanyerrorisdetectedatthisKpoint,thebatchjobwill terminate.)Thestreamispopu-L(latedforALL facilitiesduetothecurrentimplementation2oftheVDEPOPULATESTREAMcommand.KJIIJThe proceduresubmitsabatchjobtoperformtheCMSEYinsert generationcommandsforevery non-archivedfa-Scilitywhichisinthefacilitylistfile.(Youarenotallowed- topopulatearchived facilities.H*IIIJEachCMSinsert generation procedurechecksiftheKsourcestreamexistsinthefacilityCMSlibrary.*IftheI:sourcestreamdoesnotexistawarningmessagewillbeRoutputinthelogfileandintothe procedurestatusfile.(IfJthesourcestreamexists,thetargetstreamis populatedDfromthesource. DDyM4IVJThe procedurewaitsfortheCMSinsert generationbatchJjobsto complete.*WhenalljobsarecompletethestatusNtfileischeckedforerrors.'Theuserwho submittedthejobKwillreceiveamailmessage indicatingthestatusofthe% population.*D'J .,/y ! O 7O9.3B Suggestionsfor populating facilities `N5NNEVERDELETEAN EXECUTINGCMSPOPULATE JOBFROMTHEQUEUE.'Animproper terminationofCaCMSinsert generationcommandcancorruptaCMSMXlibraryso,pleasedon'tdeletetheCMS populationjobs.(AMfutureversionofCMSissupposedtocorrectthisproblem.H IfyouneedtostopCMS populationjobsfromprocess-LbingthejobscanbestoppedbydefiningthelogicalnameBFAC$ABORT_POPLIBSinthesystemlogicalnametableAonallrelevantnodes.(TheFAC$ABORT_POPLIBSlog-JlicalstopsALLpopulatejobsfrom processing.)AfteryourOjobshavestoppedbesuretodeassignthislogicaltoallow5future populationstorun successfully. `JIfthestreamyouare populatingisvery differentfromKthesourcestreampleasedon'tsubmitthepopulateduring$M "regular"workinghours. `JDon'tpanicifyoureceivewarningmessagesinthepop-H%ulationstatus.+Theremaybe facilitiesforfutureVMSE}releasesthatarenot applicabletoyour developmentstream. `UKUIfyouaregoingtodoabuildwiththetargetstream,Kit'snotwisetoallowchangestothe developmentstreamK duringthe population.(Ifyouallow replacementsintotheG_  developmentstreamduringthe population,theVDErep-K  resentationofthebuildstreamwilldifferfromtheCMSM representationofthebuildstream.'ThiscouldbeasourceHi of confusionafterthebuild.+ Remember,itistheCMSJ representationofthestreamthatisusedtobuildVMS. `A GA Ifyourpopulatestreamjobfails,rerunthepopulate* streamusingthesameinput. ` J IfyoufailtopopulateafacilityinwhichthesourceIq streamhaschangedsincetheprevious populationoftheE targetstream,youwillcausetheVDEstreamrepre-I"  sentationtodifferfromtheCMSrepresentationforthe{  facility.[/.0 a+O 10.2 Comparing!Two!CMS!ClassesMOItisoftenusefultocomparethecontentsoftwostreamsNO(CMS Classes).'For instance,youmayneedtoidentifywhichMOBmoduleshavechangedbetweenonestablebuildstreamandaKO subsequentunstablebuildstream.)YoucanusethecompareKOCMSclassoptionofthemenutocomparetwoCMSclassesQOLforoneormore facilities(CMS libraries).)TheutilityallowsQOyoutosubmitmultiplebatchjobstoproducereportsofclassO differences.! IOTheVDEdatabasestream generationsarenotcomparedbyOOthisoption.'IfyouwanttocomparetheVDE generationsyouBO5canusetheVDESHOW GENERATIONcommandwiththeGO /IF_DIFFERENT qualifier.'Seethe"VDE ReferenceManual"BOfora descriptionoftheSHOW GENERATIONcommand.CO>TheCompareCMSclassutilityandtheVDEcommandROshouldgiveyouthesameresult.'IftheVDE differenceisnotROthesameastheoutputproducedbythisoption,thenyouhaveHOH uncovereda differencebetweenVDEandCMSforoneor!Obothofthestreams. ORequired Privileges6O4Youneedtheprocessrights identifiers4VMS_ENABLE_CMS Oand+(VMS_SOURCE_READor VMS_SOURCE) m.0 /1_o55O10.1CInvokingtheCompareClassOptionJOUTocomparetwoCMSclasses,selectoptionninefromtheDOmainmenu.*Thecompareclasscommand procedureexe-Ocutes.HtWhat%action%do%you&want%to%perform?%(1-6,EXIT,HELP):%9*O Difference&Stream%Version&X-1AO]Enter%?&or&"HELP"%at%any%prompt&to&obtain%helpFOPrompt%default%values%(if&any)%appear&in&brackets&[]DOEnter%Z,%"Quit"%or%"Exit"&to&exit% immediately%tVProduct%Root&[VMS$]:%VMSu)OEntertheproductroot.,SeeIChapter2 fora definitionofOproductroot.*IFoOzJOYouareaskedtosupplyoneofthestreamstocompare.IOThereisno validation performedontheenteredstream.&taFirst%Stream&[V5.5]:%V5.5 zOOEnterthesecondstreamtoforthe comparison.'No validationOis performed.3taSecond&Stream% [V5.5_BUILD]:& V5.5_BUILD!NOEnterthebatchqueueinwhichtorunthe differencejobs.EtQueue%to%submit& difference%job(s)&[CLUSTER_LONGBATCH]:L "OOEntera directoryforthelogfileproducedbythisoption.KOThis directory specificationisalsothedefault directory:O5 specificationforanyreportfile produced.Nt Directory&for%logs&and%work&files&[WORK212:[SWEENEY.SCRATCH]]: QO Optionallyenterafilenametocontainareportofthedif-NOferencesbetweenthetwostreams.(Bydefaultthe differencesXO5willbereportedinthelogfile.(Thefiletypedefaultsto".LIS"ROandthedefault directoryisthework directoryenteredattheOpreviousprompt./tkReport&file%name%?&[LOG]:%bs.lis MOEnterthefacilityspecificationstoprocess.+YoumayenterLO wildcardsinthefacilityname.,Intheexamplebelow,theSO5streamswillbecomparedinall facilitieswhichbeginwiththeOletter"B".+tFacility%to%process%[ALL]:%B*St{If%you&proceed%you&will%submit&a%job&to& difference%stream&V5.5Ttto%stream& V5.5_BUILD%for&all% facilities&matching&the% specification=t VMS$:[B*.CMS].K Differences&will%be%reported%in1tSfile%!WORK212:[SWEENEY.SCRATCH]BS.LIS;.2tDo%you&wish%to%proceed?%[Yes]:&yesZOJob%BS%(queue&CLUSTER_LONGBATCH,%entry%1483)%started&on&GALAXY_LONGBATCHI QOYouareaskedifyouwishtoprocessanymore facilities.*IfOOyouanswer affirmativelytotheprompt,youareaskedforaPO5newreportfilenameandafacility specificationtoprocess.OOAbatchjobis submittedforeachfacility specificationen-NOtered.'The procedure terminateswhenyouenter"NO"tothisO>prompt.DtDo%you&want%to%process%any%more% facilities?%[Yes]:.t Report&file%name%?& [BS.LIS]:%cs+tSFacility%to%process%[ALL]:%c*StIf%you&proceed%you&will%submit&a%job&to& difference%stream&V5.5Ttto%stream& V5.5_BUILD%for&all% facilities&matching&the% specification=tLVMS$:[C*.CMS].K Differences&will%be%reported%in1tfile%!WORK212:[SWEENEY.SCRATCH]CS.LIS;.-tDo%you&wish%to%proceed?%[Yes]:ZOEJob%CS%(queue&CLUSTER_LONGBATCH,%entry%1484)%started&on&DELPHI_LONGBATCHHtDo%you&want%to%process%any%more% facilities?%[Yes]:%no 102   *O10.2CCompareClass ProcessingTOUForeachfacility specificationentered,abatchjobis submittedNOtoproduceareportof differencesbetweenthetwostreams.POThebatchjobdisplaysamessageforeachfacility processed.OO^Asamplesessionandthelogfileproducedbythe session'sOinputfollows.*O< Difference&Stream%Version&X-1AOEnter%?&or&"HELP"%at%any%prompt&to&obtain%helpFOPrompt%default%values%(if&any)%appear&in&brackets&[]DO5Enter%Z,%"Quit"%or%"Exit"&to&exit% immediately tProduct%Root&[VMS$]: tFirst%Stream&[V5.5]:.t.Second&Stream% [V5.5_BUILD]:&AMBEREtvQueue%to%submit& difference%job(s)&[CLUSTER_LONGBATCH]:Nt Directory&for%logs&and%work&files&[WORK212:[SWEENEY.SCRATCH]]:'tReport&file%name%?&[LOG]:+tNFacility%to%process%[ALL]:%H*StIf%you&proceed%you&will%submit&a%job&to& difference%stream&V5.5Otto%stream&AMBER&for%all% facilities%matching%the% specification=tGVMS$:[H*.CMS].K Differences&will%be%reported%intthe&log%file.-tDo%you&wish%to%proceed?%[Yes]:eO@Job%V55_AMBER_DIFF%(queue&CLUSTER_LONGBATCH,%entry%591)&started%on%GALAXY_LONGBATCH>O$&type%+WORK212:[SWEENEY.SCRATCH]V55_AMBER_DIFF.log7  "SYS$NODE"&=% "GALAXY::"%(LNM$SYSTEM_TABLE)activeinstreamAMBERandobsoleteinstreamBLADE.NOSupposebothstreamsarestillopenforsourcecodechangesHOandBLADEisa successorofAMBER.TheBLADEstreamQOHdoesnotwantthefourhundredmodulesinthefacilitytobeIOusedwhencreatingnewbuildstreamsand populatingex-MOistingbuildstreams,but,theAMBERstreamneedsthefourEORhundredmodule generations.,TheBLADEreleaseprojectOOleadercanobsoletethefacilityandremovethefourhundredIOmodule generationsfromtheVDEstreamandCMSlibrary.QO[ Obsoletingthefacilitywillmeanfaster,more efficientstreamIO populationsfortheBLADEproject.*TheAMBERprojectis'O  unaffectedbythisaction.$ WRO Archivingafacility obsoletesthefacility beginningatapar-LOticularstream,andsetsaflagtopreventfurtherstream2O5 creationsandstream populationsfor 5ALLG5streamsinthefa-Ocility. yL/Ifthefacilitytoarchivespansmultiple releases,itisQO importantthatthefacilitynotbearchiveduntilallmainlineEO>streamsinwhichthefacilityisactiveareclosed.* P'J *^ORequired PrivilegesNOThearchivefacilityoptionrequiresthattheuserholdtheO`VDE privilege\`PERFREP0`andtheprocessrights identifiers)OVMS_ENABLE_CMSand VMS_SOURCE .IftheuserdoesPOnotholdthese privileges,the submittedbatchjobwillfail. 5 36woM;O11.1CInvokingtheArchiveFacility ProcedureQOUToarchiveorobsoletea facility,selectoptiontenfromtheGOmainmenu.)Thearchivefacilitycommand procedureexe-Ocutes.JOWhat&action%do%you%want%to%perform?%(1-10,EXIT,HELP):%105OArchive/Obsolete&A%Facility%Version%X-1AO]Enter%?&or&"HELP"%at%any%prompt&to&obtain%helpFOPrompt%default%values%(if&any)%appear&in&brackets&[]DOEnter%Z,%"Quit"%or%"Exit"&to&exit% immediately tVProduct%Root&[VMS$]:u)OEntertheproductroot.,SeeIChapter2 fora definitionofOproductroot.*IFoOO 5%TOYouareaskedforthefacilitytoarchiveor obsolete.'Thepro-OOcedure validatesthe existenceofthe facility.)The procedure@O5issuesawarningmessageiftheVMSCMS$ARCHIVED_DO FACILITY.FLAGfileisfoundinthefacilitymaster-KOpack directory..Thisflag indicatesthatthefacilitywasRO>archivedinthepast.(Youareallowedtocontinueevenifthe4OVMSCMS$ARCHIVED_FACILITYfileisfound.-Facility&To& Obsolete?:% DECW$LIBSSONowindicateifyouwantthefacilitytobearchivedortobeIO obsolete.*Yourentrymustbe substringof "ARCHIVED"orO5 "OBSOLETE".rename_streamAsh_rqrdprvl_pbsBh1_irspJh1_rspLh1_rsp_suggMcreate_baseOsh_rqrdprvl_rspPh1_icbspZh1_cbsp[h1_cbsp_sugg\compare_stream]sh_rqrdprvl_cs^h1_icospgh1_cosphh1_cosp_suggjcreate_faclsh_rqrdprvl_nfmh1_icfpth1_cfpwh1_cfp_suggxpop_facsysh_rqrdprvl_pssfzh1_ipfph1_pfph1_pfp_suggdiff_classsh_rqrdprvl_diffh1_iccoh1_ccoh1_cco_suggarch_facsh_rqrdprvl_obsh1_iafph1_afph1_afp_suggfuture_options @-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--*-140-*-*-P-*-ISO8859-1O-ADOBE-New Century Schoolbook-Medium-R-Normal--*-140-*-*-P-*-ISO8859-1L-ADOBE-Interim DM-Medium-I-Normal--*-140-*-*-P-*-DEC-DECMATH_SYMBOLM-ADOBE-New Century Schoolbook-Bold-R-Normal--*-140-*-*-P-*-ISO8859-1@-ADOBE-Courier-Medium-R-Normal--*-120-*-*-M-*-ISO8859-1/-ADOBE-Symbol-*-R-*--*-140-*-*-P-*-*-*O -ADOBE-New Century Schoolbook-Medium-R-Normal--*-120-*-*-P-*-ISO8859-1m()O3.2BCreateStream ProcessingHOUThebatchjob submittedbythecreatestream procedureHOperformsthe followingstepstocreateabuildstream:F) !PjmIJCreatesaCMSbuildclassforall facilitieswhichcontainHtheparentclassandwhicharenotmarkedarchivedor"markedno propagation.KJIIJChecksifthereisafacilitywhosenamematchestheJparentstreamname.(Ifamatchisfound,theCMSbuildQOclassiscreatedinthematchedfacilityevenifthefacility&ismarkedno propagation.K*'IIIJCreatesanempty(nomodule generations)buildstream!intheVDE database.F4IVJ PopulatesthebuildstreamfromtheparentstreamHWmodule generations.'The populationmethodusedisiden-Gticaltothestream population processing describedinChapter4.*)lO-JrZ}UxZ p_' .g:m8L;:CK^COYSD5 Z| _ab`,e: lymFobIp wBxLz3|Ru wDj[R [ ,Z   NJ