E tFACPOPFACPOP|+PLMENU$FACPOP  ContentsB*DECdocument V3.2n/ gCONTENTSCONTENTS8 E\TitlePageTitle Page/gELFACPOPFACPOP*:OFACPOPOJuly1991VOJTheFacilityPopulateutility(FACPOP)isusedtopopulateoneCMS\OclassfromanotherCMSclass.+The advantageofthisutilityisthatifXOtheclasstobe populatedalreadycontainssome elements,thenthese[O3elementswillbeskippedsincenorealworkneedstobe performedforOthem.]33O{SoftwareVersion:'FACPOPVersionX0.1(V,O]FACPOPOFacilityPopulate*AIO ActivatestheFACPOPutility.+TheFACPOPutilityisrun;O(fromDCL. Selectively populatesCMSclasses.FOFormat8OsFACPOPM library-spec base-class target-classOCommand QualifiersDefaultsO: /[NO]CREATE: /NOCREATEO|/[NO]LOG| /LOG=libraryO/PROCESS/PROCESS=flagfreeO /[NO]REMOVE /NOREMOVE =OPrompts!Os LIB_SPEC: library-spec!O BASE_CLASS:Q base-classO$ TARGET_CLASS:$ target-class ! O DescriptionJOsTheFACPOPutilityisusedtocreate(if necessary)andHOpopulateaCMSclassfromanexistingCMSclass.,ThisOO$utilityhassomebuiltinchecksthatmustbemetinorderLO|tominimizethe possibilityforerror..TheactualtaskofGO populatingtheCMSclassis performedinthreesteps.OOpThefirststepistoverifythatbothclassnames specifiedQOarepresentintheCMSlibrary.(Ifthe'TARGET'classisnotXO!present,theutilitywill optionallycreatethisclassfortheuser.ROzIftheuserdidnotspecifythattheclassshouldbecreated,QOthentheutilitywilldisplayanerrormessageand discontinueOO+ processingonthelibrarythatdoesnotcontainthe'TARGET'Oclass. VQOThesecondstepistobuildalistofallelements containedQOinthe'BASE'class,andalistofallelements containedinOO5the'TARGET'class.*Usingtheselists,theutilitythenputsNOthe new/updated generationsfoundintheBASElistintotheOTARGETlist.K !QOThethirdandfinalstepistoremoveallelement generationsPOthatwerefoundintheTARGETlist,butwerenotpresentinRO5theBASElist.)Thestepis optional,andbydefaultisturned.Ooff(seethe/REMOVE qualifier).  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".O base-classNO( SpecifiestheCMSclassnamethatwillbeusedtopopulateOthetargetclass.A\O target-classFO( SpecifiestheCMSclassnamethatwillbe populated.L "OCommand QualifiersOs /[NO]CREATESO IndicatesthattheutilityshouldcreatethetargetclassifitPO$isnotalreadypresentinthelibrary.,ThetargetclasswillTO|onlybecreatedifthelibrarycontainsthebaseclass,andtheTOlibraryisonethatissupposedtobe processed.(ThedefaultisSO-nottocreatethetargetclassandtodisplayanerrormessageRO indicatingthatthetargetclasswasnotfoundinthelibrary.gK=(O/LOG=(log-type[,log-type,...])MO( Specifieswhattypeofloggingtheuserwants.*ThedefaultLOisthattheuserwillonlyseemessagesfromtheutilityMO pertainingtothe librariesbeing processedorskipped.+The/O2listof acceptablelogtypesis:  `m(m[NO]ALL-Logallmessages `G [NO]LIBRARY-Logonlymessage pertainingto libraries `l?l[NO]CMS-LogerrormessagesreceivedfromCMSc.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:k `mJm[NO]ALL-processall librariesnomatterwhat attributeitmayhave `E9E[NO]ARCHIVEDFACILITY-processallarchived libraries `C [NO]FLAGFREE-process librarieswithno attributes `<[NO]NOPROPAGATE-process librariesmarkedno propagate@KO /[NO]REMOVEOO( Indicatesthattheutilityshouldremove generationsfoundinUOthetargetclassthatarenotinthebaseclass.)ThedefaultisMOthatthese generationswillnotberemovedfromthetargetO2class.* b  FACPOP FACPOP FACPOP FACPOP FACPOP FACPOP FACPOP FACPOP FACPOP FACPOP FACPOP FACPOP FACPOP FACPOP FACPOP FACPOP FACPOP FACPOP cmd_facpop @-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-*-*-*tX`b .(t