E t FACBATCHCBATCH]PLMENU$FACBATCH  ContentsB*DECdocument V3.2n/ gCONTENTSCONTENTS8 E\TitlePageTitle Page3g ELFACBATCHFACBATCH*<OFACBATCH OJuly1991]OJTheFacilityBatchutility (FACBATCH)isusedtosubmitabatchjobforDOeachCMSlibrarythatmeetsthe selection criteria._55O{SoftwareVersion:'FACBATCHVersionX0.1mCO]FACBATCH1OSubmitbatchjobforeachfacility*! HO ActivatestheFACBATCHutility.)TheFACBATCHutilityisNO(runfromDCL.SubmitsabatchjobagainsteachCMSlibrary0Othatmeetsthe selection criteria.[p1OFormat.OsFACBATCHN library-spec command-fileOCommand QualifiersDefaultsO:/AFTER:None.O|/HOLD|None.O/[NO]LOG/NOLOGO /OUTPUT_DIR/OUTPUT_DIR=sys$loginOD /POST_JOBNAMEDNone.O/PREFIX_JOBNAMENone.O/PROCESS/PROCESS=flagfree O /P4 None. OM/P5MNone. O/P6None. O/P7None. O/P8None.OW/QUEUEW/QUEUE=sys$batch _OPrompts!Os LIB_SPEC: library-specO COMMAND_FILE: command-file  FO DescriptionLOsTheFACBATCHutilityisusedtosubmitajobtoabatchPOqueueforeachCMSlibrarythatmeetsthe selection criteria.MO$Thejob submittedforeachlibrarywillconsistofauserMO|written procedurethatwillhavespecific informationpassedMOtoit.-The informationwillbepassedtotheuserwritten1O- procedureviatheP1-P8 parameters.  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 command-fileJO( Specifiesthenameoftheuserwrittencommand procedureKOthatistobe submittedforeachlibrarythatmeetstheO selection criteria.  OCommand QualifiersOs /AFTER=timeWORequeststhatthejobbehelduntilafteraspecifictime.'IftheOO$ specifiedtimehasalreadybeenpassed,thejobis processedNO|immediately.Timecanbe specifiedaseitheranabsolutetimeQOorasa combinationofabsoluteanddeltatimes.(SeetheVMS?O-DCLCONCEPTSMANUALforcomplete informationon#O specifyingtimevalues.VK,O/HOLDHO(Controlswhetherornotthejobismade availableforHO immediate processing.,The/HOLD qualifierholdsthejobKOuntilitisreleasedbythe/NOHOLD qualifierorbytheBO2/RELEASE qualifieroftheSET QUEUE/ENTRYcommand. O/[NO]LOGRO( SpecifiesthattheuserwantstoseemessagesfromtheutilityHO pertainingtothe librariesbeing processedorskipped.OOUTPUT_DIR=directoryTO( Specifieswherethelogfilesaretobeput.*Thedefaultisto3Oputallthelogfilesin SYS$LOGIN.! (O/POST_JOBNAME=character-stringJO(This qualifierismuchlikethe/PREFIX_JOBNAME qualifer,QOexceptthatthe characterstringenteredforthis qualifieris'Oappendedtothejobname.  *O /PREFIX_JOBNAME=character-stringTO( Specifiestheascii characterstringthatistobeplaceattheOO beginningofthejobname.*BydefaultthejobnamewillbeOOthenameoftheCMSfacilitythatisbeingprocess.+IntheFO2caseofVMS$:[YELLOW_TEST.CMS],thejobnamewouldbeLO"YELLOW_TEST".(Ifaprefixof"ABC_"isentered,thenthe2Ojobnamewouldbe"ABC_YELLOW_TEST".! .O$/PROCESS=(attribute[,attribute,...])QO(ThePROCESS qualifierisusedtodefinethe selectioncriteriaSOforthe librariesthataretobe processed.(Some librarieshaveBOspecial attributes associatedwiththem, VMSCMS$NO_CO2PROPAGATE.FLAGisanexampleofan attribute.-ThisQO attribute indicatesthatthislibraryisnottohaveanycodePO propagation performedwithinit.'Theprocess qualifierisusedNO<to selectivelyprocessorskip librariesmarkedwithcertainAO attributes.'Thelistof acceptable attributesis: `J[NO]ALL-processall librariesnomatterwhat attributeritmayhave `9[NO]ARCHIVEDFACILITY-processallarchivedJ libraries `D [NO]FLAGFREE-process librarieswithnot attributes `H<H[NO]NOPROPAGATE-process librariesmarkedno propagateN! U$!O/P4=text/P8=textJO(Allthe/Pn qualifiersaccept alphanumericstrings.,ThesePOstringscanbequotedstrings containingspaces,orsimpeoneNOwordstrings.(Thedataacceptedforeach parameter qualifierSO2ispasseddirectlytothe procedure submitted.'IfauserentersMO/P4=TESTonthecommandline,thentheuserwouldbeableHOtodoa"SHOWSYMBOLP4"commandwithinthe procedure3O< submittedandseethestring"TEST".O/QUEUE=queue-nameOO( Identifiesthebatchqueueonwhichthejobisentered.*The(Odefaultqueueis SYS$BATCH.* b0FACBATCHFACBATCHFACBATCHFACBATCHFACBATCHFACBATCHFACBATCHFACBATCHFACBATCHFACBATCHFACBATCHFACBATCHFACBATCHFACBATCHFACBATCHFACBATCHFACBATCHFACBATCH cmd_facbatch @-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-*-*-*tNVb0bt