E  tFACCOMPACCOMP\PLMENU$FACCOMP  ContentsB*DECdocument V3.2n/ gCONTENTSCONTENTS8 E\TitlePageTitle Page1gELFACCOMPFACCOMP*;OFACCOMPOApril1992UOJThe facilities comparisonutility (FACCOMP)isusedtocomparetheTOCMSclasscontentsandtheVDEstreamcontentsfora developmentO stream/class.^44O{SoftwareVersion:'FACCOMPVersionX1.0$%V,O]FACCOMPOFacilityCompare*FO ActivatestheFACCOMPutility.*TheFACCOMPutilityisEO(runfromDCL.FACCOMPcomparsetheVDEviewofthe*O librarieswiththeCMSview.OFormat'OsFACCOMPN library-specstreamOCommand QualifiersDefaultsO:/[NO]LOG:/LOGO|/OUTPUT=file-spec|None.O/PROCESS/PROCESS=flagfreeu KOPrompts!Os LIB_SPEC: library-specOSTREAM:streamq  GO DescriptionCOsTheFACCOMPcommand activatestheutilityfromDCLVOandthenactsonthesetof specified libraries.(TheutilityusesGO$thelogical VDE$LIBRARYtolocatetheVDEdatabasetoO|process.DOTheFACCOMPutilityproducesareportof generationGOp differencesbetweentheCMSrepresentationofastreamMOandtheVDErepresentationofastream.)ThereportcanbeYO!printedtothelogfileorcanbeprintedtoauser specifiedtextOzfile. bQOTheutilityverifiesthatthestreamtocompareexistsintheQOVDElibrary.(IfthestreamisnotpresentintheVDElibraryOO5theutilitywill terminate.-IfthestreamispresentintheNOVDElibrary,eachfacilitymatchingthelibrary specification#O parameteris processed.v ! LGOIftheCMSclass correspondingtothestreamnameisMOnotfoundinafacilityCMSlibrary,awarningmessageisTO5 displayed.'Awarningmessageis displayedifthefacilityisnotMOfoundintheVDE database.* Processing continuesinbothofOthesecases.1 ! POTheutilitywillreturnthehighestseverityerror encounteredJOasthefinal completionstatus..Forexample,thelibrary O5 specificationVMS$:[A T@*5y5.CMS]mayresultintenCMS librariesIOtocompare.,AlltenoftheCMSlibraryandVDEstreamPOcontentsmustmatchforasuccessstatus.)IfoneormoreofRO>the facilitiesinthesetexhibita difference,thenawarning"Oreturnstatusresults. O ParametersOs library-specJO SpecifiestheCMSlibrarythatistobeactedon./ThisNO$ specificationcancontain wildcards,butitmustbeavalidFO|CMSlibrary directory specification(i.e.* VMS$:[YELLOW_KO TEST.CMS]).Anexampleofa wildcarded specificationwouldO-be:-VMS$:[Y 9*:7-.CMS].This specificationwouldprocessall9O librariesthatstartwiththeletter"Y".<YOstreamIO# SpecifiestheCMS class/VDEstreamnametobe compared. =OCommand QualifiersOs/[NO]LOGMO SpecifiesthattheFACCOMPutilityshoulddisplayamessage8O$foreveryCMSLIBRARYthatis processed.Ay$O/OUTPUT=file-specificationUO( Specifiesthenameofafilethatistocontainalltheoutput. tMONote:'errormessagesand informationalmessageswillnotbe'Oputintotheoutputfile.c.O$/PROCESS=(attribute[,attribute,...])JO(ThePROCESS qualifierisusedtoidentifywhat librariesMOaretobe processed.+Some librarieshavespecial attributes;O associatedwiththem,VMSCMS$NO_PROPAGATE.FLAGOO2isanexampleofan attribute.+This attribute indicatesthatMOthislibraryisnottohaveanycode propagation performedROwithinit.)Theprocess qualifierisusedto selectivelyprocessPO<orskip librariesmarkedwithcertain attributes.*Thelistof%O acceptable attributesis:l `mJm[NO]ALL-processall librariesnomatterwhat attributeitmayhave `E9E[NO]ARCHIVEDFACILITY-processallarchived libraries `D [NO]FLAGFREE-process librarieswithnot attributes `<[NO]NOPROPAGATE-process librariesmarkedno propagateX  .OExamples O1. $>'D @VMSCMS$:SET_VDE_LIBRARY%VMS $>'D SET%COMMAND%VMSCMS$:FACCOMP H$>6DH faccomp/log/process=ALL% vms$:[A*.cms]&V5.5<%FAC-I-USEVDELIB,%Using%VDE%library% VSC$DBROOTD %FAC-I-PROC,% Processing%library&VMS$:[AAA_VDE_TEST.CMS]" Date:p 9-APR-1992%08:58AVDE%to%CMS& generation% comparison%for%stream&V5.5+Library:%VMS$:[AAA_VDE_TEST.CMS];Module%Name t;CMS ;VDE0&--------------------------------------A.REQ 1_4%FAC-W-DIFFER,%VDE%and&CMS%differ%for&stream%V5.5&in&VMS$:[AAA_VDE_TEST.CMS];| %FAC-I-PROC,% Processing%library&VMS$:[ACC.CMS]Y %FAC-S-EQUAL,&VDE%and%CMS&are%equal%for%stream&V5.5%in%VMS$:[ACC.CMS]>  %FAC-I-PROC,% Processing%library&VMS$:[ACLEDT.CMS]\S %FAC-S-EQUAL,&VDE%and%CMS&are%equal%for%stream&V5.5%in%VMS$:[ACLEDT.CMS]> %FAC-I-PROC,% Processing%library&VMS$:[ADARTL.CMS]\ %FAC-S-EQUAL,&VDE%and%CMS&are%equal%for%stream&V5.5%in%VMS$:[ADARTL.CMS]=+ %FAC-I-PROC,% Processing%library&VMS$:[AMBER.CMS][s %FAC-S-EQUAL,&VDE%and%CMS&are%equal%for%stream&V5.5%in%VMS$:[AMBER.CMS]> %FAC-I-PROC,% Processing%library&VMS$:[ANALYZ.CMS]\ %FAC-S-EQUAL,&VDE%and%CMS&are%equal%for%stream&V5.5%in%VMS$:[ANALYZ.CMS]@K %FAC-I-PROC,% Processing%library&VMS$:[AQUARIUS.CMS]^ %FAC-S-EQUAL,&VDE%and%CMS&are%equal%for%stream&V5.5%in%VMS$:[AQUARIUS.CMS]> %FAC-I-PROC,% Processing%library&VMS$:[AUDSRV.CMS]\#  %FAC-S-EQUAL,&VDE%and%CMS&are%equal%for%stream&V5.5%in%VMS$:[AUDSRV.CMS] k $show%symbol%$status# $STATUS%==% "%X18178060" $>! KTheuserfirstsetsthevalueofthelogical VDE$LIBRARYHtopointtotheVMSproductdatabaseby executingthe95SET_VDE_LIBRARYcommand procedure.+Theuser?thenaddstheFACCOMPcommandtotheirprocessHcommandtable.(Inthisexample,theCMSclasscontentsA>andtheVDEstreamcontentsforstreamV5.5areGcomparedfor facilities beginningwiththeletter"a".OTheoutput qualifierisnotusedsoany differenceswillbeDHwrittento SYS$OUTPUT.Theprocess qualifierkeywordMALLisusedtoprocessarchivedand nopropagate facilities.Nf i $IThereisastream difference encountedinthisexample.BInfacility AAA_VDE_TESTthereisamodule,A.REQJ5whichexistsintheVDEdatabasebutisnotpresentinFtheCMSlibrary.(Thereturnstatus, X18178060equates@to FAC-W-DIFFER,whichwasthewarning condition> encountered. O2. $>-D faccomp/nolog&vms$:[sys.cms]&V5.5< %FAC-I-USEVDELIB,%Using%VDE%library% VSC$DBROOT"QDate:p 9-APR-1992%09:27AVDE%to%CMS& generation% comparison%for%stream&V5.5"Library:%VMS$:[SYS.CMS]JModule%Name tJCMS JVDE0&--------------------------------------BASE_LEVEL.MAR55 15V"%FAC-W-DIFFER,%VDE%and&CMS%differ%for&stream%V5.5&in&VMS$:[SYS.CMS] j$>DInthisexample,theNOLOG qualifierisusedwhichA1 suppressesthe %FAC-I-PROCmessage.'The generationAofmoduleBASE_LEVEL.MARinVDEandCMSdiffers.@The %FAC-W-DIFFERmessage indicatesthatVDEandA;CMSdifferforstreamV5.5intheSYS facility. O3. $>/D faccomp/log%vms$:[vms054*.cms]%V5.5<%FAC-I-USEVDELIB,%Using%VDE%library% VSC$DBROOT^N%FAC-I-SKPNOPROP,%Library&VMS$:[VMS054-2R.CMS]&marked% NOPROPAGATE,%skipping%itX%FAC-I-SKPARCH,%Library%VMS$:[VMS054-3.CMS]&marked% ARCHIVED,%skipping%it^%FAC-I-SKPNOPROP,%Library&VMS$:[VMS054-2R.CMS]&marked% NOPROPAGATE,%skipping%it % $>A Thisexampleshowsthemessages displayedwhenaF facilityismarkedarchivedormarked nopropagateandRP the/process qualifierisnotusedtoincludethese facilities.* j:FACCOMPFACCOMPFACCOMPFACCOMPFACCOMPFACCOMPFACCOMPFACCOMPFACCOMPFACCOMPFACCOMPFACCOMPFACCOMPFACCOMPFACCOMPFACCOMPFACCOMPFACCOMPFACCOMPFACCOMP cmd_faccomp @-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-1O-ADOBE-New Century Schoolbook-Medium-R-Normal--*-140-*-*-P-*-ISO8859-1@-ADOBE-Helvetica-Bold-R-Normal--*-140-*-*-P-*-ISO8859-1B-ADOBE-Helvetica-Medium-R-Normal--*-140-*-*-P-*-ISO8859-1/-ADOBE-Symbol-*-R-*--*-140-*-*-P-*-*-*@-ADOBE-Helvetica-Bold-R-Normal--*-100-*-*-P-*-ISO8859-1@-ADOBE-Courier-Medium-R-Normal--*-120-*-*-M-*-ISO8859-1> -ADOBE-Courier-Bold-R-Normal--*-120-*-*-M-*-ISO8859-1tj:Tp~$%t