_& !HFRD Guide to the CONFGR UtilityOCONFGR "# Contents  O$Indext*aS7&OHFRDGuidetotheCONFGRO:UtilityCO28thMay1992 WO{AguidetoHFRD configurationcontrolof VAXclusterstartup,AUTOGENUOand DECwindowsserver customizationfilesusingtheCONFGRutility.! zYO{Thisguideassumesa knowledgeofthepurposeanduseofVMSsystem!O management facilities.P&O{Contact:{ M.G.DanielU! /+O{PrintedCopy:OK{Thisbookis availableforprintingtoa PostScriptprinter.^OAttheVMScommandlineenter``PrintBook'',thefacilityismenudriven.GOFormultiplecopiesitisbettertoprintonce,then1 photo-copy .mCCO{ThisdocumentwaspreparedusingVAXDOCUMENTv2.1_  eO 1.2 IntroductionLOHFRD's VAXclusterisverylargebyany standard, presentlyKOsome60systems.)TheserangefromNI satellite VAXstationLOB2000s,withnointernaldisksand14Mbofmemory,toaEOCI connectedVAX9000-420with256Mbofmemory,andMOservingdiskstothe satellitesystems.-Theclusterhas10OLsystemdisks.  WQOThe implicationsofsuchalargeand disparateclusterstretchFOthestandardmethodsDECusesforsystemstartupand@O5AUTOGENcontrol.(HFRDVMSSystems ManagementhasOOadaptedthesetoprovideless cumbersomemethods,aswellasMOasystemformuchgreater understandingandcontrolofthe@O>clusteronamacroand individualsystemlevel. ! mKOTheparadigmusedis ``centralized configuration control'',DOmanagingstartup,AUTOGENand DECwindowssetupfilesQO5foreachofthe individualsystemsfromasingle configurationTOfileforeachaspect.'Thisfile specifieshoweachsystemshouldLObe configured,andautility generatestherequiredsystemPO>filesinacentral directory,beforeactually introducingthemTOinto production,thisoccuringonlyaftertheutilityisusedtoIOcopythe generatedfilestosystemspecific directories.T ! O1.1BStartupControlLOU PerceivedproblemswiththestandardDECmethodasapplied!Otolarge VAXclusters: n `mAmTherearetwogeneral approachesforVMSstartup"controlinacluster: Jh1.: Individual,system-specificSYS$SYSROOT:[SYSMGR]SYSTARTUP_YV5.COM7@2.:Acluster-commonSYSTARTUP_V5.COMfile `IWhenusingsystem-specificstartupfiles,asmallchangeLrequiredforallnodesortooneaspectofstartupinaMpclustermustbe individuallyappliedineachcase.)ThisisKfineforoneortwosystems,butoncetheclustergrowsG!toa substantialnumberofsystemsitrapidlybecomesz unmanageable. `:The alternative,acluster-common SYSTARTUP_0RV5.COMfile,soonbecomesfullofR if-then-elses Rin>aclusterwheremembershave differingmanage-Gment/application requirements.+ThisisfineforoneorK[twosystems,butagainoncetheclustergrowsitbecomes. increasingly difficulttomanage.GOBoththesemethodstendtomake centralized managementMO difficult.-Italsorendersitalmost impossibleforsystemsLO5 managementstafftogainanoverall appreciationofhowaKOlargeclusteris configuredwithoutseparateand extensiveHO documentationwhichmayormaynot faithfully representOO>theactualorcurrent situation(aproblemwithallexternalOdocumentation!)  O1.2BSHUTDOWNControl `{C{Therecanbetwo approachesinVMSsystem-specific#shutdowninacluster:& %Mh1.: Individual,system-specific!SYS$SYSROOT:[SYSMGR]SYSHUTDWN.COMB2.:System-disk-common SYS$COMMON:[SYSMGR]SYSHUTDWN.COM `CAswithstartupcontrol,whenusingsystem-specificFstartupfiles,asmallchangerequiredforallnodesEportooneaspectofshutdowninaclustermustbeD individuallyappliedineachcase.0OncetheclusterG!growstoa substantialnumberofsystemsthisbecomesz unmanageable. `;The alternative,acommon SYSHUTDWN.COMfileARisonly system-diskcommon..thisisbecomesmoreK complicatedinacluster containingmultiplesystemdisks.!Italsomustcontain if-then-elsesinaclusterwhereE[membershave differingshutdown requirements.)ThisisMfineforoneortwosystems,butastheclustergrowsit7 becomes increasingly difficulttomanage.wJONotunlikestartupsboththese alternativestendtomake-O centralized management difficult.*   O1.3BAUTOGENControlLOUTheAUTOGENutilityisusedto``tune''VMSsystemsbasedNOondata collectedfromarunningsystemalongwithguidanceIO directivesprovidedbysystems managementallowingcustomEO^SYStem GENerationandtuning.+ PerceivedproblemswithJOthestandardDECmethodasappliedtolarge VAXclusters:1  `mNmEachofthe directivefiles,"SYS$SYSROOT:[SYSEXE]MODPARAMS.DAT,Hmustbe individually maintainedtoprovidebothclusterFandsystemspecific parametercontrol.*AsmallchangeJwrequiredforallnodesinaclustermustbeappliedtoMeachfile.+Thisisfineforoneortwosystems,butonceJ(theclustergrowstoa substantialnumberofsystemsit)quicklybecomes unmanageable. `KEachofthesystem-specific parameterfilesis necessarilyDYinasystem-specific location,SYS$SYSROOT:[SYSEXE].AAs with startups,!thistendsto make centralized=  managementmore difficultandmakesitalmostCb impossibleforsystems managementstafftogainanLoverall appreciationofhowalargeclusteris configured.d  {*O1.4B DECwindowsServerControlGOUThesite-configurable DECwindowsserversetup procedure,9ODECW$PRIVATE_SERVER_SETUP.COM,allowssystems>O managementto customizethe DECwindowsX-serverHO^startup.*Thisincludes providingDCLSYMBOLStocontrolKOsuchthingsasmonitordensityandserverprocessquotas.NGOTheseserversetup proceduresmustbelocatedoneach@OsystemdiskineithertheSYS$COMMON:[SYSMGR]or-O5SYS$SPECIFIC:[SYSMGR] directories.! mLO PerceivedproblemswiththestandardDECmethodasapplied!Otolarge VAXclusters:0! # `m@mIflocatedinthe SYS$COMMONareathe procedureCmustcontaindecision structuresandseparatesetupFsectionsforeachsystembeing customized.*ThisworksKwwellenoughforasmallnumberofsystems,butoncetheBclustergrowsitbecomesmoredifficlttomanage. `OJOIflocatedinthe SYS$SPECIFICareaeachofthesystem-Gspecific proceduresmustbe individually maintained.)AsIwith startups,thistendstomake centralized managementKYmore difficultandmakesitalmost impossibleforsystemsI managementstafftogainanoverall appreciationofhow, alargeclusteris configured.  }SO 2.2CONFGR!Overview5OCONFGRisanHFRD implementedutility.KOTheapproachusedis ``centralized configuration control'',DOmanagingstartupandAUTOGENfilesforeachoftheNO5 individualsystemsfromasingle configurationfileforeachOaspect. NPOThisfile specifieshoweachsystemshouldbe configured,andNOtheCONFGRutility generatestherequiredsystemfilesinaO5central directory.NHOThe generatedfilesarethenplacedinto productionasQO required,usingthesameutilitytolocateasystem'sspecific7O5 directoryandthencopythemintothis.b88OThisapproachhasthe following benefits: oL`m1.:The configurationfileprovidesanatural,accurateandEsuccinctoverviewofhowalargenumberofseparateDaspectsareusedbysystems accordingto individualw requirements.O`2.:Changestoanspecificaspectcanrapidly, accuratelyandIOeasilybe propagatedtoallaffected individualsystems.M`3.: Separatesthe generationof individualsystemfilesfromG'theplacingoftheseinto production.-ThisallowstheHcheckingofchanges,etc.,before committingsystemstothem.   [O 3.2StartupHO EffectiveuseoftheCONFGRutilitytomanagestartups)Odependsonthetwoaspects, J configurationcontrol and'OB generationand distribution B.y!nO O ConfigurationControl/OU Configurationcontrolconsistsof:" xo `mAmGroupingstartup-relatedDCLcommands accordingtoIactivityintofilesnamedina meaningfulway.+ThisisFwherecareand considerationinbreakingstartupinto1wuseful groupingsmustbe exercised.w Judicioususeof;commentswithineachDCLfileis essential.E>Thisactivity comprisescreatingand/or modifyingtheCONFGR$$STARTUP:activity.COMfiles. `F Maintainingtheoverallconfiguration.)EachsystemhasJoitsownentry comprisingoneormorelines,withcomma-J separatedfields specifyingthenamesofthestartupDCL files.Note: 4TheSYSTARTUP_V5.COMfileis generatedIinthesameorderasthesystem's specificationintheI@ configurationfile.)Hencestartup functionsthatmustbePdonebeforeorafterothersmustbe specifiedinthatorder.RThisactivity comprisestheeditingtheCONFGR$$STARTUP:CONFGR.DAT_file.%# 'O Generationand DistributionLOUAsthe Generationand distribution activitiesare separate,IOCONFGRmaybeusedtocheckthe configurationfileandHOstartupDCLfileswithout affectinganysystem'sactualCO^SYSTARTUP_V5.COM.Thiscentral collectionofsystem-FOspecificSYSTARTUP_V5.COMfilesallowsready inspectionQOofasystem'sstartupwithoutbeingonthatnodeor accessingOhit'ssystemroot.O$v%OOThe generationand distribution activitiesarehandledbytheOCONFGRutility. ^_UaNote ^_E Generally,wherean application installation indicatesG>thatthestartupshouldbeplacedinor modifications6madetoSYSTARTUP_V5.COMthenmakethem&usingtheCONFGRutility.^Donot m3^directlyeditany VAXclustermember's/%SYS$SPECIFIC:[SYSMGR]SYSTARTUP_V5.COM+file,usetheCONFGRutility. Zj  %"O3.1BStartupDCLFilesOUStartupDCLfiles6Uare basically standaloneDCL procedures.KOTheseprovidetheDCLtoperformthestartup activity.+AQOstartupactivitymayjustbeacalltoan applicationstartupJO^ procedurelocated elsewhere,orcanbesimpleorcomplex'O stand-aloneDCL procedures.*&{' Q%OSimplestartupDCLfile:YO O$!-----------------------------------------------------------------------------OP $!% PASCAL.COM(O $!%Provide&DEC%VAX%Pascal. O $!2O( $!% 22-JUN-91KMGDJINITIAL% DEVELOPMENTYOp O$!-----------------------------------------------------------------------------?O $&DEFINE%SITE$NODE$APPLICATIONS&/SYSTEM%/NOLOG&-8 ."''F$TRNLNM("SITE$NODE$APPLICATIONS")'Pascal!",OH $&@SYS$STARTUP:PASCAL$STARTUP.COMYO O$!-----------------------------------------------------------------------------( W9OAlthoughCONFGR$$STARTUP:PASCAL.COMmayseemPOatrivialstartupfile,theuseofthestartupDCLnamesinMO5the configurationfileoffersaself-documentingandobviousNO descriptionofexactlywhatthesystemstartupisallaboutLO (provided reasonablyobviousandself-explanatoryfilenamesO>are chosen!).*)*, p,OMorecomplexstartupDCLfile:YO O$!-----------------------------------------------------------------------------OP $!%LAT.COM O $!@O $!% 12-APR-92KMGDJmodified%for&use%with&STARTMANDO( $!% 23-APR-89KMGDJinitial% development%(as% LTLOAD.COM)YOp O$!----------------------------------------------------------------------------- O $!-O $&HARDWARE&=%F$GETSYI("HW_NAME")JOH $&IF&F$LOCATE("VAXstation",HARDWARE)%.LT.%F$LENGTH(HARDWARE)O $&THEN&O $HARDWARE&=% "VAXstation"O  $&ELSELOh $IF&F$LOCATE("VAXserver",HARDWARE)%.LT.&F$LENGTH(HARDWARE)%-(z THEN%HARDWARE%=% "VAXserver"O $&ENDIF O@ $!#O $&RUN%SYS$SYSTEM:SYSGEN#/ CONNECT&LTA0% /NOADAPTER O $!*O_ $&LATCP&=%"$SYS$SYSTEM:LATCP" O $!]O $&LATCP&SET%NODE& /IDENT="High% Frequency%Radar%Division% ''HARDWARE'"&/NOLOG O7 $!cO $&LATCP&CREATE%SERVICE& /IDENT="High% Frequency%Radar%Division% ''HARDWARE'"&/NOLOG O $!O $&LATCP&START&NODEYOW O$!-----------------------------------------------------------------------------,+ O Stand-aloneDCLHOUItmustbepossibleto interactivelyexecutetheseDCLDO procedures standaloneandhavethem accomplishtheirJO activity, i.e.0theymustbeself-contained, withalltheDO^DCLrequiredtoexecute successfully./No assumptionsIOcanbemadeaboutanyotherDCLcodeinthe generatedGOSYSTARTUP_V5.COM(apartfromthepresenceofa``SAY''>Ohforeignverbassignedas``WRITESYS$OUTPUT'')./,> NPOThisallowsthecheckingofstartupDCLoutsideofanactualROsystemstartup,aswellasthe interactivestartingorrestart-AO5ingofan applicationusinga``@CONFGR$$STARTUP: 5activity 5.COM''-NHOAll non-commentlinesaresimplyreadfromthestartupEODCLfilebytheCONFGRutilityandincludedinthe/O5 systems'sspecificSYSTARTUP_V5.COM .O3.2B CONFGR.DATFile3OUCONFGR$$STARTUP:CONFGR.DAT providestheFOCONFGRutilitywiththeoverall configurationofeachOnode.c/i9IOEachsystemhasitsownentry, beginningwithaquote-next occuranceofaquote-delimitedsystemname.+TheseEOentriesshouldbe similarlyorderedforallsystems. _UNote _9TheSYSTARTUP_V5.COMfileDCLis generated@inthesameorderasthespecificationsintheER configurationfile.(Hencestartup functionsthatmustIbedoneinaspecificorderMUSTbe specifiedinthatorder. M*0$1 p(OAnexample CONFGR.DATfile:  . P .  . O !FO( "DBOOT",% secaudit,% accounting,%DECnet,%LAT,& DECwindows,2p queue_manager,%initialize_batch_queues, Bookreader,%Email, !-----7H Project_Manager,& Pathworks,%CDROM_software, !-----1 start_batch_queues,&banners,&finalize O  ! h .  .  . O@ !EO "WS48",K secaudit,% accounting,%DECnet,%LAT,& DECwindows,2 queue_manager,%initialize_batch_queues, Bookreader,%Email,_ !-----) FORTRAN,%Pascal,& WordPerfect, !-----I7 WS48_specific_startup,&start_batch_queues,%banners,%finalize O !  .  . W .> 20O3.3B GeneratedSYSTARTUP_V5.COMFileHOUAll non-commentlinesaresimplyreadfromthestartupFODCLfilesbytheCONFGRutilityandincludedinthe/O systems'sspecificSYSTARTUP_V5.COM3NJO Non-quotedtextisbydefaultchangedto lower-case(theQOauthor considersthisformateasiertoread),althoughthisisO5 optional.4 NLOTheDCLincludedfromeachstartupfileisprefixedbyaLOcommentline includingthenameofthesourcestartupDCLFO5file.'Thismakesthe generatedfileeasiertocheck.5 W>OTheSYSTARTUP_V5.COM procedureprovidesinforma-QOtionalmessages concerningthestageofstartuptotheconsoleHO5ofthesystemduringstartup..ThisprovidesuserswithJOstartupprogress informationinthecaseof workstations,LO informationalsovaluablewhen determininginwhichsection,O>ofastartupproblemsoccured.`6 6MOShouldastartupDCLfilenamebe specifiedthatdoesnotFOexistDCLcodeisplacedinthe generated SYSTARTUP_LO5V5.COMtodisplayamessageontheconsole indicatingtheLOproblem,aswellasacommentlinemessage indicatingtheQOnon-includedfilename.'IfanyerrorsofthisnatureoccuredMO>duringasystem'sstartup generation,DCLcodeis generatedKOtodisplayanotherwarningmessageontheconsoleatthe"O conclusionofstartup.*78HOAll non-commentlinesaresimplyreadfromthestartupEODCLfilebytheCONFGRutilityandincludedinthe@O5 systems'sspecificSYSTARTUP_V5.COM.For satelliteMOsystemsin particularthisin-lineDCLcodeis considerablyOOmore efficientthana collectionof``@'' execution commands,MO> especiallyfor activities comprisingonlyasmallnumberofO commands.9OOfcourse9, the CONFGRutilitydoesnotassesstheHO correctnessoftheDCL specifiedinthestartupfiles!*:; ODonot OTPdirectlyeditany VAXclustermember'sSYS$SPECIFIC:[SYSMGR]SYSTARTUP_3OV5.COMfile,usetheCONFGRutility.8< h!.OExample GeneratedSYSTARTUP_V5.COM,OD $!%SYSTARTUP_V5.COM&for%DEFAULT3O $!%Created:%Monday,& 17-AUG-1992&08:49=O $!%Produced%by:% $1$dua8:[site_manager]confgr.exe O $!POd $!%DO%NOT%MODIFY&this%file% directly,%use&the%CONFGR%utility! O $!O $&set%noon(O< $&say%=&"WRITE% SYS$OUTPUT"O $&say%""RO $&say%"%SYSTARTUPV5-I-BEGIN,&system%specific%startup&for%DEFAULT" O $!GO\ $!-------------------------% INITIALIZE%--------------------O ----------!O $&say%""7O3 $&say%"%SYSTARTUPV5-I-NOW,%""initialize""".O{ $&nodename&=%f$getsyi("NODENAME")9O $&define%/system&site$access_shortly%"TRUE"&O  $&set% accounting&/disableGOS $&if&*f$locate("VAXstation",f$getsyi("HW_NAME"))%.eq.&0%-)  then%set& accounting%/disableQO $&define%/nolog%/system%/exec%shutdown$inform_nodes% "''nodename'" O+ $!GOs $!-------------------------%SECAUDIT%----------------------O ----------!O $&say%""5OK $&say%"%SYSTARTUPV5-I-NOW,% ""secaudit"""RO $& audit_file%=%6"''f$trnlnm("CCDB$$DIR")'SECURITY_AUDIT.AUDIT$JOURNAL"$O $&set%audit%/journal%-&T# /destination='audit_file'%-%Tk /server=redirect_system_log$O $&set%audit%/journal%-,/ /server=final_action=ignore_new&-+/C !/resource=monitor_mode=percentage"O $&set%audit%/alarm%-$/ /enable=(authorization,%- acl,&-b login=(all),%- logfail=(all),%- breakin=(all))%-'/: /disable=(login=(subprocess)) O $!GO $!-------------------------%DEFAULT%-----------------------O ----------!OZ $&say%""4O $&say%"%SYSTARTUPV5-I-NOW,% ""default"""O $&say%""O2 $&say%""^Oz $&say%L"**************************************************************************"O $&say%"*  *"kO  $&say%"*JTHIS%NODE&HAS%NOT%HAD&A%confgr& GENERATED%""SYSTARTUP_V5.COM""%PROVIDEDJ*%"OR $&say%"* R *"O $&say%"*R the%startup%will&only%be%partial,%please&correct% immediately*"O $&say%"*  *"^O* $&say%L"**************************************************************************"Or $&say%""O $&say%"" O $!GOI $!-------------------------%DECNET&------------------------O ----------!O $&say%""3O! $&say%"%SYSTARTUPV5-I-NOW,% ""DECnet"""DOi $&if&*f$locate("VAXstation",f$getsyi("HW_NAME"))%.eq.&0O $&thenFO $say%"%DECNET-I-HFRD,&setting% VAXstation% requirements" OA $run%sys$system:ncp?  define%executor%maximum& broadcast% nonrouters&2562  define%known%line&receive%buffer&24'  define%exec&pipeline&24000) a define%exec&alias&node%vaxc0  define%exec&alias&incoming&disableO $&else?O9 $say%"%DECNET-I-HFRD,&setting%VAX& requirements" O $run%sys$system:ncp?  define%executor%maximum& broadcast% nonrouters&2562  define%known%line&receive%buffer&32' Y define%exec&pipeline&32000)  define%exec&alias&node%vaxc0  define%exec&alias&incoming&disableO0 $&endif.Ox $&nodename&=%f$getsyi("NODENAME")RO $&if&nodename&.eqs.&"DAJAV"%.or.%nodename%.eqs.%"DAMSC"&.or.%-B P nodename&.eqs.&"DBOOT"%.or.%nodename%.eqs.%"SERV2"O $&thenFO $say%"%DECNET-I-HFRD,&setting%incoming%alias%enabled" O( $run%sys$system:ncp) p define%exec&alias&node%vaxc/  define%exec&alias&incoming&enableO $&endif5OH $&say%"%DECNET-I-HFRD,&starting&DECnet"&O $&@sys$manager:startnet.com O $!GO  $!-------------------------%LAT&---------------------------Oh ----------!O $&say%""0O $&say%"%SYSTARTUPV5-I-NOW,%""LAT"""-O@ $&hardware&=%f$getsyi("HW_NAME")JO $&if&f$locate("VAXstation",hardware)%.lt.%f$length(hardware)O $&then&O $hardware&=% "VAXstation"O_ $&elseLO $if&f$locate("VAXserver",hardware)%.lt.&f$length(hardware)%-(z7 then%hardware%=% "VAXserver"O $&endif#O $&run%sys$system:sysgen#/ connect&lta0% /noadapter*OW $&latcp&=%"$SYS$SYSTEM:LATCP"]O $&latcp&set%node& /ident="High% Frequency%Radar%Division% ''hardware'"&/nologcO $&latcp&create%service& /ident="High% Frequency%Radar%Division% ''hardware'"&/nologO/ $&latcp&start&node Ow $!O $&say%""PO! $&say%"%SYSTARTUPV5-I-END,%system%specific%startup%for%DEFAULT"OO! $&say%""=neO3.4BUsingCONFGRIOUThereare4basicstepswhenusingtheCONFGRutility.E> J`m1.:CreateormodifyanystartupDCLfiles,as required.H`2.:Editthe CONFGR.DAT configurationfile,as required.E`l3.:Generatethesystem-specificSYSTARTUP_V5.COMfile.;ThiswillbecreatedintheCONFGR$$STARTUP.3 directoryandnamed SYSTARTUP_V5.\3 system-name L3.8TheCONFGRcommandforthisactivityis:%``CONFGR/STARTUP[/NODE=xname B[,hname2]]''0iThis!has!not"altered!any!system'sViactualBSYSTARTUP_V5.COM.ItispossibleatthisstagetoOreview,change,delete,etc.,anyofthe configurationfiles.E`4.: Distributethe generatedSYSTARTUP_V5.COMfilesto'system-specific directories.*aThiscopiesthe SYSTARTUP_V5.a system-nameafile,8fromtheCONFGR$$STARTUP directorytothe#system'sspecificroot,disk :[sysroot .SYSMGR].Itis&jrenamedfrom SYSTARTUP_V5.j system-name jtoSYSTARTUP_V5.COM.82TheCONFGRcommandforthisactivityis:,``CONFGR/STARTUP/COPY[/NODE=name Q[,wnameA]]''L?""O3.4.1BExamplesessionsf@-<-O GeneratingSYSTARTUP_V5.COMFiles9OD DAJAV$%confgr&/startup&/node=ws1,ws2,ws3,ws46O Configure%SYSTARTUP_V5.COM%for%WS1?%[Y]:4O %CONFGR-I-NOW,%SYSTARTUP_V5.COM&for%WS16O Configure%SYSTARTUP_V5.COM%for%WS2?%[Y]:4Od %CONFGR-I-NOW,%SYSTARTUP_V5.COM&for%WS29O Configure%SYSTARTUP_V5.COM%for%WS3?%[Y]:&n6O Configure%SYSTARTUP_V5.COM%for%WS4?%[Y]:4O< %CONFGR-I-NOW,%SYSTARTUP_V5.COM&for%WS4*O %CONFGR-I-CONFGRED,& WS1,WS2,WS4%O %CONFGR-W-NOTCONFGRED,&WS3O DAJAV$A/O DistributingSYSTARTUP_V5.COMFiles@OD DAJAV$%confgr&/startup&/node=ws1,ws2,ws3,ws4%/copy?O %CONFGR-I-NOW,%checking%system%roots%on%$1$DUA4:?O %CONFGR-I-NOW,%checking%system%roots%on%$1$DUA5:?O %CONFGR-I-NOW,%checking%system%roots%on%$1$DUA6:?Od %CONFGR-I-NOW,%checking%system%roots%on%$1$DUA7:?O %CONFGR-I-NOW,%checking%system%roots%on%$1$DUA8:?O %CONFGR-I-NOW,%checking%system%roots%on%$1$DUA9:@O< %CONFGR-I-NOW,%checking%system%roots%on% $1$DUA10:@O %CONFGR-I-NOW,%checking%system%roots%on% $1$DUA11:@O %CONFGR-I-NOW,%checking%system%roots%on% $1$DUA16:@O %CONFGR-I-NOW,%checking%system%roots%on% $1$DUA17:@O\ %CONFGR-I-NOW,%checking%system%roots%on% $1$DUA22:@O %CONFGR-I-NOW,%checking%system%roots%on% $1$DUA23:@O %CONFGR-I-NOW,%checking%system%roots%on% $1$DUA24:@O3 %CONFGR-I-NOW,%checking%system%roots%on% $1$DUA25:@O{ %CONFGR-I-NOW,%checking%system%roots%on% $1$DUA34:@O %CONFGR-I-NOW,%checking%system%roots%on% $1$DUA35:@O  %CONFGR-I-NOW,%checking%system%roots%on% $1$DUA36:@OS %CONFGR-I-NOW,%checking%system%roots%on% $1$DUA37:?O %CONFGR-I-NOW,%checking%system%roots%on%$1$DUA0:?O %CONFGR-I-NOW,%checking%system%roots%on%$1$DUA1:?O+ %CONFGR-I-NOW,%checking%system%roots%on%$1$DUA2:@Os %CONFGR-I-NOW,%checking%system%roots%on% $1$DUA12:@O %CONFGR-I-NOW,%checking%system%roots%on% $1$DUA13:@O %CONFGR-I-NOW,%checking%system%roots%on% $1$DUA14:@OK %CONFGR-I-NOW,%checking%system%roots%on% $1$DUA15:@O %CONFGR-I-NOW,%checking%system%roots%on% $1$DUA18:@O %CONFGR-I-NOW,%checking%system%roots%on% $1$DUA19:@O# %CONFGR-I-NOW,%checking%system%roots%on% $1$DUA20:@Ok %CONFGR-I-NOW,%checking%system%roots%on% $1$DUA21:@O %CONFGR-I-NOW,%checking%system%roots%on% $1$DUA30:@O %CONFGR-I-NOW,%checking%system%roots%on% $1$DUA31:@OC %CONFGR-I-NOW,%checking%system%roots%on% $1$DUA32:@O %CONFGR-I-NOW,%checking%system%roots%on% $1$DUA33:BO %CONFGR-I-NOW,%checking%system%roots%on% SERV2$DUA0:BO %CONFGR-I-NOW,%checking%system%roots%on% SERV2$DUA1:BOb %CONFGR-I-NOW,%checking%system%roots%on% SERV2$DUA2:BO %CONFGR-I-NOW,%checking%system%roots%on% SERV2$DUA3:DO %CONFGR-I-NOW,%checking%system%roots%on% SERV2$DUB255:BO: %CONFGR-I-NOW,%checking%system%roots%on% DBOOT$DUA0:BO %CONFGR-I-NOW,%checking%system%roots%on% DBOOT$DUA4:SO Copy&SYSTARTUP_V5.COM%for&WS3%to%DBOOT$DUA4:[SYS13.SYSMGR]?%[Y]:&nBO %CONFGR-I-NOW,%checking%system%roots%on% DBOOT$DUA5:POZ Copy&SYSTARTUP_V5.COM%for&WS1%to%DBOOT$DUA5:[SYS10.SYSMGR]?%[Y]:O %COPY-S-COPIED,%ASITE$MANAGEMENT:[SITE_MANAGER.CONFGR$$STARTUP]SYSTARTUP_V5.WS1;63%copied&to&,DBOOT$DUA5:[SYS10.SYSMGR]SYSTARTUP_V5.COM;15&(26%blocks)`O %PURGE-I-FILPURG,%,DBOOT$DUA5:[SYS10.SYSMGR]SYSTARTUP_V5.COM;13%deleted&(27%blocks)PO2 Copy&SYSTARTUP_V5.COM%for&WS2%to%DBOOT$DUA5:[SYS18.SYSMGR]?%[Y]:Oz %COPY-S-COPIED,%ASITE$MANAGEMENT:[SITE_MANAGER.CONFGR$$STARTUP]SYSTARTUP_V5.WS2;62%copied&to&,DBOOT$DUA5:[SYS18.SYSMGR]SYSTARTUP_V5.COM;26&(26%blocks)`O %PURGE-I-FILPURG,%,DBOOT$DUA5:[SYS18.SYSMGR]SYSTARTUP_V5.COM;24%deleted&(27%blocks)BO  %CONFGR-I-NOW,%checking%system%roots%on% DBOOT$DUA6:POR Copy&SYSTARTUP_V5.COM%for&WS4%to%DBOOT$DUA6:[SYS15.SYSMGR]?%[Y]:O %COPY-S-COPIED,%ASITE$MANAGEMENT:[SITE_MANAGER.CONFGR$$STARTUP]SYSTARTUP_V5.WS4;62%copied&to&,DBOOT$DUA6:[SYS15.SYSMGR]SYSTARTUP_V5.COM;55&(27%blocks)`O %PURGE-I-FILPURG,%,DBOOT$DUA6:[SYS15.SYSMGR]SYSTARTUP_V5.COM;53%deleted&(27%blocks)DO* %CONFGR-I-NOW,%checking%system%roots%on% DBOOT$DUB255:*Or %CONFGR-I-CONFGRED,& WS1,WS2,WS4%O %CONFGR-W-NOTCONFGRED,&WS3O DAJAV$B O 4.2Shutdown@OThe managementofsystem-specific shutdownsusingIOCONFGRisverysimilartothatof startups,soexamplePOBfilesandexampleusageisnotincludedinthesection.*This5O managementdependsonthetwoaspects,? configurationOcontrol and'( generationand distribution .yCnO O ConfigurationControl/OU Configurationcontrolconsistsof:D  `m>mGroupingshutdown-relatedDCLcommands accordingCtoactivityintofilesnamedina meaningfulway.Useof;commentswithineachDCLfileis essential.EThisactivity comprisescreatingand/or modifyingtheCONFGR$$SHUTDOWN:activity.COMfiles. `eAe Maintainingtheoverallconfiguration.-EachsystemGhasitsownentry comprisingoneormorelines,withBcomma-separatedfields specifyingthenamesoftheoshutdownDCLfiles.Note: 5The SYSHUTDWN.COMfileis generatedinE6thesameorderasthesystem's specificationintheF configurationfile.*Henceshutdown functionsthatmustLbedonebeforeorafterothersmustbe specifiedinthat@order.6This$activity% comprises$the%editing%the,CONFGR$$SHUTDOWN:CONFGR.DATfile.qEGG'O Generationand DistributionOOUThe generationand distribution activitiesarehandledbytheOCONFGRutility. /_U2Note /_E Generally,wherean application installation indicatesHthattheshutdownshouldbeplacedinor modifications:hmadeto SYSHUTDWN.COMthenmakethemusingtheCONFGRutility./Donot >3/directlyeditany VAXclustermember's,"SYS$SPECIFIC:[SYSMGR]SYSHUTDWN.COM+file,usetheCONFGRutility. +,F! )#O4.1BShutdownDCLFilesOUShutdownDCLfiles63Uare basically standaloneDCL procedures.IOTheseprovidetheDCLtoperformtheshutdown activity.LOAshutdownactivitymayjustbeacalltoan applicationKO^shutdown procedurelocated elsewhere,orcanbesimpleorGOcomplex stand-aloneDCL procedures.(Theyhavethesame=Oroleasthoseusedforstartupconfiguration.)GO Stand-aloneDCLHOUItmustbepossibleto interactivelyexecutetheseDCLDO procedures standaloneandhavethem accomplishtheirJO activity, i.e.0theymustbeself-contained, withalltheDO^DCLrequiredtoexecute successfully./No assumptionsIOcanbemadeaboutanyotherDCLcodeinthe generatedDO SYSHUTDWN.COM(apartfromthepresenceofa``SAY''>Ohforeignverbassignedas``WRITESYS$OUTPUT'').HNIOAll non-commentlinesaresimplyreadfromtheshutdownEODCLfilebytheCONFGRutilityandincludedinthe,O5 systems'sspecific SYSHUTDWN.COMIO4.2B CONFGR.DATFile4OUCONFGR$$SHUTDOWN:CONFGR.DATprovidestheFOCONFGRutilitywiththeoverall configurationofeachOnode. JAOEach!system!has its!own!entry," beginning!with aBOquote-delimitedsystemname(theSCSNODEname)andJO5 comprisingoneormorelines,withcomma-separatedfieldsKO specifyingthenamesoftheactivity-specificshutdownDCLQOfiles.(Asystem specificationis considered continueduntilthe@O>next occuranceofaquote-delimitedsystemname. _UNote _?HThe SYSHUTDWN.COMfileDCLis generatedintheFsameorderasthespecificationsinthe configurationHfile.&Henceshutdown functionsthatmustbedoneina@RspecificorderMUSTbe specifiedinthatorder. K-O4.3B Generated SYSHUTDWN.COMFileIOUAll non-commentlinesaresimplyreadfromtheshutdownFODCLfilesbytheCONFGRutilityandincludedinthe,O systems'sspecific SYSHUTDWN.COMLNJO Non-quotedtextisbydefaultchangedto lower-case(theQOauthor considersthisformateasiertoread),althoughthisisO5 optional. MNMOTheDCLincludedfromeachshutdownfileisprefixedbyaHOcommentline includingthenameofthesourceshutdownKO5DCLfile.'Thismakesthe generatedfileeasiertocheck.N W@OThe SYSHUTDWN.COM procedureprovides informationalJOmessages concerningthestageofshutdowntotheconsoleIO5ofthesystemduring shutdown.,ThisprovidesuserswithKOshutdownprogress informationinthecaseof workstations,LO informationalsovaluablewhen determininginwhichsection-O>ofashutdownproblemsoccured.*OPNODonot O3[directly"edit"any" VAXcluster"member's8O"SYS$SPECIFIC:[SYSMGR]SYSHUTDWN.COMfile,useO5theCONFGRutility.QneO4.4BUsingCONFGRIOUThereare4basicstepswhenusingtheCONFGRutility.5R  K`m1.:CreateormodifyanyshutdownDCLfiles,as required.H`2.:Editthe CONFGR.DAT configurationfile,as required.B`l3.:Generatethesystem-specific SYSHUTDWN.COMfile.<ThiswillbecreatedintheCONFGR$$SHUTDOWN+3 directoryandnamed SYSHUTDWN.3 system-name 3.8TheCONFGRcommandforthisactivityis:&``CONFGR /SHUTDOWN[/NODE=name [,name]]''0iThis!has!not"altered!any!system'sViactualHSYSHUTDWN.COM.Itispossibleatthisstagetoreview,Fchange,delete,etc.,anyofthe configurationfiles.B`4.: Distributethe generated SYSHUTDWN.COMfilesto'system-specific directories.'aThiscopiesthe SYSHUTDWN.,a system-name8afile,from=theCONFGR$$SHUTDOWN directorytothesystem'sspecificroot,disk ::[_sysroot*Z .SYSMGR].Itisrenamedfromj SYSHUTDWN.j system-namejtoSYSHUTDWN.COM.8TheCONFGRcommandforthisactivityis:$2``CONFGR( /SHUTDOWN(/COPY[/NODE=name [,name]]''J .S [O 5.2Modparams/AUTOGENGO EffectiveuseoftheCONFGRutilitytomanageAUTOGEN?O MODPARAMS.DATfilesdependsonthetwoaspects, OB configurationcontrol Band'bB generationand distribution B.yTnO O ConfigurationControl/OU Configurationcontrolconsistsof:U `m=mGroupingrelatedSYSGEN parametersandAUTOGEND directives accordingtopurposeinto parameterfiles?namedina meaningfulway.1ThisiswherecareCwand considerationinbreakingthese parametersinto5 meaningful groupingsmustbe exercised. Judicious>(useofcommentswithineach parameterfileis essential.EThisactivity comprisescreatingand/or modifyingtheHCONFGR$$MODPARAMS:HgroupH.PARfiles. `A Maintainingtheoverallconfiguration.-EachsystemG hasitsownentry comprisingoneormorelines,withBxcomma-separatedfields specifyingthenamesofthe parameterfiles.6@This$activity% comprises$the%editing%the-CONFGR$$MODPARAMS:CONFGR.PARfile.'V! 'O Generationand DistributionLOUAsthe Generationand distribution activitiesare separate,DOCONFGRmaybeusedtochecktheboth configurationJOand parameterfileswithout affectinganysystem'sactualHO^MODPARAMS.DAT.Thiscentral collectionofsystem-specificFO MODPARAMSfilesallowsready inspectionofasystem'sFOAUTOGEN directivefilewithoutbeingonthatnodeor(Oh accessingit'ssystemroot.JWv OOThe generationand distribution activitiesarehandledbytheOCONFGRutility. ^_UaNote ^_E Generally,wherean application installation indicatesH>thattheshutdownshouldbeplacedinor modifications:madeto MODPARAMS.DATthenmakethemusingtheCONFGRutility.^Donot m3^directlyeditany VAXclustermember's3"SYS$SPECIFIC:[SYSEXE]MODPARAMS.DATfile,$usetheCONFGRutility. ZX O ConsistencyCheckingDOUNocheckingof generated MODPARAMS.DAT parametersis)OdonebytheCONFGRutility.Y! WPOItis thereforenotonlypossiblebuthighlylikelythattheKO parameterswill interact.-Thatis,therewillbemultipleDO5 ``add_''s,! ``min_''s,!etc.2 affectingthesameSYSGENIO parameters.'AsAUTOGENdoesitsown consistencychecking/Othisshouldnotpresent problems.6Z HOHowever,fortheusertobeawareofexactlyhowtheHO generated parametersare interactingitis advisableto:O5checktheSYS$SYSTEM:AGEN$PARAMS.REPORTfilesBOforcommentsmadebyAUTOGENabouttheseeffects.[yO5.1B ParameterFilesOU Parameterfiles4Uaredatafiles containing meaningfully>OgroupedSYSGEN parametersorAUTOGEN directivesLO (``min_'',etc.).)Groupingmaybemade accordingtosystemJO^type, application requirements,or functional specification8Osuchasasystembeingavotingmember.*\] 0OExample system-type parameterfile:YO O!------------------------------------------------------------------------------OP !& VAX3100.PARO !& VAXstation%3100s O !bO( !& 24-JUL-92JMGDKPOSIX:% maxprocesscnt%minimum&now%60,%add&10&for%good&measureKOp !& 16-MAY-92JMGDKdisable&tape%MSCP%serving&for% VAXstations_O !& 29-APR-92JMGDK Workstation%replay,&>%24000%VIRTUALPAGECNT%(default%at%8Mb)_O !& 28-APR-92JMGDK ACP_REBLDSYSD&on& satellites%to%inhibit%system%disk%rebuilds]OH !& 02-APR-92JMGDK"show%mem%/pool%/full"& indicates% increased%SRP,%IRP,&LRP8O !& 12-SEP-91JMGDKchanged& "lockdirwt"&to&01O !& 07-MAY-91JMGDKinitial& developmentYO  O!------------------------------------------------------------------------------ Oh !SO !& "lockdirwt"&in& proportion%to%CPU&power,%VS3100%approx&2.7%VUPFO !& "lockdirwt"&for%non-MSCP%serving&nodes&should%be%0O@ LOCKDIRWT%=%0 O ![O !&based&on& comparing% "initial"%with% "current"%values&for%SRP,&IRP,%LRPcO !&using&"show&mem%/pool%/full",&increase&"min_"%to%a&bit%more&than% "current"O_ MIN_SRPCOUNT=4000O MIN_IRPCOUNT=2000O MIN_LRPCOUNT=150 O7 !O ADD_GBLPAGES=2000O ADD_GBLSECTIONS=3 O !OW MIN_MAXPROCESSCNT=60O ADD_MAXPROCESSCNT=10 O !"O/ MIN_VIRTUALPAGECNT=40000 Ow !O ACP_REBLDSYSD=0 O !OO TMSCP_LOAD&=%0 O !YO O!------------------------------------------------------------------------------*^'_ /OExample functional parameterfile:YO O!------------------------------------------------------------------------------OP !& VOTES_1.PARNO !&Voting%nodes% contribute&one%vote&each%(apart&from%DAJAV). O !cO( !& 17-APR-92JMGDKdue%to%the& arrangement&of&system%disks%and%to%ensure&an&odd Op !Op number%of%votes%DAJAV%has&been%given%two&votes,%with&DAMSC, O !D DARSC,%DADTC%each%with&1%,% contributing%another%3.1O !& 07-MAY-91JMGDKinitial& developmentYOH O!------------------------------------------------------------------------------O VOTES%=&1YO O!------------------------------------------------------------------------------` W6OAlthoughCONFGR$$MODPARAMS:VOTES-1.PARmayOOseematrivial parameterfile,theuseofthenamesintheHO5 configurationfileoffersaself-documentingandobviousLO descriptionofexactlywhatthesystemSYSGEN specificationOOisallabout (provided reasonablyobviousandself-explanatory%O>filenamesare chosen!).a NJOAll non-commentlinesaresimplyreadfromthe parameterOObytheCONFGRutilityandincludedinthe systems'sspecificO5 MODPARAMS.DAT#b! O5.2B CONFGR.PARFile5OUCONFGR$$MODPARAMS:CONFGR.PARprovidestheIOCONFGRutilitywiththeoverallAUTOGEN configurationofOeachnode.%c AOEach!system!has its!own!entry," beginning!with a:Oquote-delimited" ``SCSNODE''"system"name,$theGO5``SCSSYSTEMID''numberandthen comprisingoneormoreGOlines,withcomma-separatedfields specifyingthenamesNOofthe parameterfiles.+Asystem specificationis consideredHO> continueduntilthenext occuranceofaquote-delimitedJOsystemname.,Entriesshouldbe similarlyorderedforallOsystems.*d e .V (OAnexample CONFGR.PARfile:YO O!------------------------------------------------------------------------------OP !& CONFGR.PAR5O !&master%node& parameter%file&for%vaxc O !1O( !& 07-MAY-91JMGDKinitial& developmentYOp O!------------------------------------------------------------------------------ O !QO "DAJAV",%1530,%VAXC,%VOTES-2,%HSC-DISKSERVER,%VAX9420,% PATHWORKS,H POSIX,%MULTINETQO "DAMSC",%1527,%VAXC,%VOTES-1,%HSC-DISKSERVER,%VAX6220,% PATHWORKS,  POSIX,%EWS,%TEAMWORKQO  "DARSC",%1525,%VAXC,%VOTES-1,%NON-DISKSERVER,%VAX8250,% PATHWORKS,h POSIX,% DARSC_YATESQO "DADTC",%1526,%VAXC,%VOTES-1,%NON-DISKSERVER,%VAX8250,% PATHWORKS, POSIX O@ !VO "DBOOT",%1534,%VAXC,% NON-VOTING,%LOCAL-DISKSERVER,%VAX3600,% PATHWORKS, POSIXVO "SERV2",%1614,%VAXC,% NON-VOTING,%LOCAL-DISKSERVER,%VAX3600,% PATHWORKS,_ POSIX O !SO "WS1",%1535,%VAXC,% NON-VOTING,%NON-DISKSERVER,&VAX2000,& DECWINDOWS,T7 POSIX,&TEAMWORKSO "WS2",%1536,%VAXC,% NON-VOTING,%NON-DISKSERVER,&VAX4000,& DECWINDOWS,T POSIX,&TEAMWORKSO "WS3",%1537,%VAXC,% NON-VOTING,%NON-DISKSERVER,&VAX2000,& DECWINDOWS,TW POSIX,&TEAMWORKSO "WS4",%1538,%VAXC,% NON-VOTING,%NON-DISKSERVER,&VAX2000,& DECWINDOWS,T POSIX,&TEAMWORKSO/ "WS5",%1539,%VAXC,% NON-VOTING,%NON-DISKSERVER,&VAX2000,& DECWINDOWS,Tw POSIX,&TEAMWORKSO "WS6",%1540,%VAXC,% NON-VOTING,%NON-DISKSERVER,&VAX4000,& DECWINDOWS,T POSIX,&TEAMWORKSOO "WS7",%1541,%VAXC,% NON-VOTING,%NON-DISKSERVER,&VAX2000,& DECWINDOWS,T POSIX,&TEAMWORKSO "WS8",%1542,%VAXC,% NON-VOTING,%NON-DISKSERVER,&VAX2000,& DECWINDOWS,T' POSIX,&TEAMWORKSOo "WS9",%1543,%VAXC,% NON-VOTING,%NON-DISKSERVER,&VAX2000,& DECWINDOWS,T POSIX,&TEAMWORK O !TOF "WS10",&1544,&VAXC,& NON-VOTING,&NON-DISKSERVER,%VAX2000,% DECWINDOWS,z POSIX,%TEAMWORKTO "WS11",&1545,&VAXC,& NON-VOTING,&NON-DISKSERVER,%VAX2000,% DECWINDOWS,z POSIX,%TEAMWORKTOf "WS12",&1546,&VAXC,& NON-VOTING,&NON-DISKSERVER,%VAX4000,% DECWINDOWS,z POSIX,%TEAMWORKTO "WS13",&1547,&VAXC,& NON-VOTING,&NON-DISKSERVER,%VAX4000,% DECWINDOWS,z> POSIX,%TEAMWORKTO "WS14",&1548,&VAXC,& NON-VOTING,&NON-DISKSERVER,%VAX4000,% DECWINDOWS,z POSIX,%TEAMWORKTO "WS15",&1549,&VAXC,& NON-VOTING,&NON-DISKSERVER,%VAX4000,% DECWINDOWS,z^ POSIX,%TEAMWORK3O !&"WS16"%has% metamorphised%into&EWS1TO "WS17",&1551,&VAXC,& NON-VOTING,&NON-DISKSERVER,%VAX2000,% DECWINDOWS,z6 POSIX,% TEAMWORK,Z~ RADARTASKINGTO "WS18",&1552,&VAXC,& NON-VOTING,&NON-DISKSERVER,%VAX2000,% DECWINDOWS,z POSIX,%TEAMWORKTOV "WS19",&1553,&VAXC,& NON-VOTING,&NON-DISKSERVER,%VAX4000,% DECWINDOWS,z POSIX,%TEAMWORK O !TO- "WS20",&1554,&VAXC,& NON-VOTING,&NON-DISKSERVER,%VAX4000,% DECWINDOWS,zu POSIX,%TEAMWORKTO "WS21",&1555,&VAXC,& NON-VOTING,&NON-DISKSERVER,%VAX2000,% DECWINDOWS,z POSIX,%TEAMWORKTOM "WS22",&1556,&VAXC,& NON-VOTING,&NON-DISKSERVER,%VAX2000,% DECWINDOWS,z POSIX,%TEAMWORKTO "WS23",&1557,&VAXC,& NON-VOTING,&NON-DISKSERVER,%VAX2000,% DECWINDOWS,z% POSIX,%TEAMWORKTOm "WS24",&1558,&VAXC,& NON-VOTING,&NON-DISKSERVER,%VAX4000,% DECWINDOWS,z POSIX,%TEAMWORKTO "WS25",&1559,&VAXC,& NON-VOTING,&NON-DISKSERVER,%VAX4000,% DECWINDOWS,zE POSIX,%TEAMWORKTO "WS26",&1560,&VAXC,& NON-VOTING,&NON-DISKSERVER,%VAX4000,% DECWINDOWS,z POSIX,%TEAMWORKTO "WS27",&1561,&VAXC,& NON-VOTING,&NON-DISKSERVER,%VAX2000,% DECWINDOWS,ze POSIX,%TEAMWORKTO "WS28",&1562,&VAXC,& NON-VOTING,&NON-DISKSERVER,%VAX2000,% DECWINDOWS,z POSIX,%TEAMWORKTO= "WS29",&1563,&VAXC,& NON-VOTING,&NON-DISKSERVER,%VAX2000,% DECWINDOWS,z POSIX,%TEAMWORK O !TO "WS30",&1564,&VAXC,& NON-VOTING,&NON-DISKSERVER,%VAX2000,% DECWINDOWS,z\ POSIX,%TEAMWORKTO "WS31",&1565,&VAXC,& NON-VOTING,&NON-DISKSERVER,%VAX3100,% DECWINDOWS,0z FORCE_BUGCHECK_DUMP,&POSIX,%TEAMWORKTO4 "WS32",&1566,&VAXC,& NON-VOTING,&NON-DISKSERVER,%VAX3100,% DECWINDOWS,z| POSIX,%TEAMWORKTO "WS33",&1567,&VAXC,& NON-VOTING,&NON-DISKSERVER,%VAX3100,% DECWINDOWS,z  POSIX,%TEAMWORKTOT "WS34",&1568,&VAXC,& NON-VOTING,&NON-DISKSERVER,%VAX3100,% DECWINDOWS,z POSIX,%TEAMWORKTO "WS35",&1569,&VAXC,& NON-VOTING,&NON-DISKSERVER,%VAX3100,% DECWINDOWS,z, POSIX,%TEAMWORKTOt "WS36",&1570,&VAXC,& NON-VOTING,&NON-DISKSERVER,%VAX3100,% DECWINDOWS,z POSIX,%TEAMWORKTO "WS37",&1571,&VAXC,& NON-VOTING,&NON-DISKSERVER,%VAX3100,% DECWINDOWS,zL POSIX,%TEAMWORKTO "WS38",&1572,&VAXC,& NON-VOTING,&NON-DISKSERVER,%VAX3100,% DECWINDOWS,z POSIX,%TEAMWORKTO$ "WS39",&1573,&VAXC,& NON-VOTING,&NON-DISKSERVER,%VAX3100,% DECWINDOWS,zl POSIX,%TEAMWORK O !TO "WS40",&1574,&VAXC,& NON-VOTING,&NON-DISKSERVER,%VAX3100,% DECWINDOWS,zC POSIX,%TEAMWORKTO "WS41",&1575,&VAXC,& NON-VOTING,&NON-DISKSERVER,%VAX3100,% DECWINDOWS,z POSIX,%TEAMWORKTO "WS42",&1576,&VAXC,& NON-VOTING,&NON-DISKSERVER,%VAX3100,% DECWINDOWS,zc POSIX,%TEAMWORKTO "WS43",&1577,&VAXC,& NON-VOTING,&NON-DISKSERVER,%VAX3100,% DECWINDOWS,z POSIX,% TEAMWORK,Z; WS43TO "WS44",&1578,&VAXC,& NON-VOTING,&NON-DISKSERVER,%VAX3100,% DECWINDOWS,z POSIX,%TEAMWORKTO! "WS45",&1579,&VAXC,& NON-VOTING,&NON-DISKSERVER,%VAX3100,% DECWINDOWS,z[! POSIX,%TEAMWORKTO! "WS46",&1580,&VAXC,& NON-VOTING,&NON-DISKSERVER,%VAX2000,% DECWINDOWS,z! POSIX,%TEAMWORKTO3" "WS47",&1581,&VAXC,& NON-VOTING,&NON-DISKSERVER,%VAX3100,% DECWINDOWS,z{" POSIX,%TEAMWORKTO" "WS48",&1582,&VAXC,& NON-VOTING,&NON-DISKSERVER,%VAX3100,% DECWINDOWS,z # POSIX,%TEAMWORKTOS# "WS49",&1583,&VAXC,& NON-VOTING,&NON-DISKSERVER,%VAX4000,% DECWINDOWS,z# POSIX,%TEAMWORK O# !TO*$ "WS50",&1584,&VAXC,& NON-VOTING,&NON-DISKSERVER,%VAX4000,% DECWINDOWS,zr$ POSIX,% TEAMWORK,Z$ RADARTASKINGTO% "WS51",&1585,&VAXC,& NON-VOTING,&NON-DISKSERVER,%VAX4000,% DECWINDOWS,zJ% POSIX,%TEAMWORKTO% "WS52",&1586,&VAXC,& NON-VOTING,&NON-DISKSERVER,%VAX4000,% DECWINDOWS,z% POSIX,%TEAMWORKTO"& "WS53",&1587,&VAXC,& NON-VOTING,&NON-DISKSERVER,%VAX4000,% DECWINDOWS,zj& POSIX,%TEAMWORKTO& "WS54",&1588,&VAXC,& NON-VOTING,&NON-DISKSERVER,%VAX4000,% DECWINDOWS,0z& FORCE_BUGCHECK_DUMP,&POSIX,%TEAMWORKTOB' "WS55",&1589,&VAXC,& NON-VOTING,&NON-DISKSERVER,%VAX4000,% DECWINDOWS,z' POSIX,%TEAMWORKTO' "WS56",&1590,&VAXC,& NON-VOTING,&NON-DISKSERVER,%VAX4000,% DECWINDOWS,z( POSIX,%TEAMWORKTOb( "WS57",&1591,&VAXC,& NON-VOTING,&NON-DISKSERVER,%VAX4000,% DECWINDOWS,z( POSIX,%TEAMWORKTO( "WS58",&1592,&VAXC,& NON-VOTING,&NON-DISKSERVER,%VAX4000,% DECWINDOWS,z:) POSIX,%TEAMWORK O) !`O) !&(VCS%is%for&when%the& "VAXcluster&Console%System"% workstation% occasionally)SO* !&(joins%the%VAXC%for%system&related% activities,% upgrades,&etc.)`OY* "VCS",%1615,%VAXC,% NON-VOTING,%NON-DISKSERVER,&VAX3100,& DECWINDOWS,&POSIX,%VCS O* !YO* O!------------------------------------------------------------------------------ k+_Un+Note k+_>+Greatcaremustbetakento correctlyspecify7K,the SCSSYSTEMID.Unpredicatable conditions:,couldresultfrom AUTOGENINGwith incorrect:, SCSSYSTEMIDs.0Ifasystemdoesnothavea?U- SCSSYSTEMIDinthe CONFGR.PARfileanerrorisA- indicatedandno MODPARAMS.DATfileis generated. -wf-O5.3B Generated MODPARAMS.DATFileJOUAll non-commentlinesaresimplyreadfromthe parameterLOfilesbytheCONFGRutilityandincludedinthe systems's!Ospecific MODPARAMS.DATgNJO Non-quotedtextisbydefaultchangedto lower-case(theQOauthor considersthisformateasiertoread),althoughthisisO5 optional.hNKOThe parametersincludedfromeachfileareprefixedbyaIOcommentline includingthenameofthesource parameterFO5file.'Thismakesthe generatedfileeasiertocheck.-iQOShoulda parameterfilenamebe specifiedthatdoesnotexistKOtheproblemis indicatedtotheuserandacommentlineDO5placedinthe generated MODPARAMS.DAT indicatingthe#O non-includedfilename.jOOfcourse9, the CONFGRutilitydoesnotassessthe6O correctnessofthe parameters specified!*klNODonot O3[directly"edit"any" VAXcluster"member's=O"SYS$SPECIFIC:[SYSEXE]MODPARAMS.DATfile,usetheO5CONFGRutility.m :v+OExample Generated MODPARAMS.DAT&OD !& MODPARAMS.DAT%for&SERV22O !&Created:&Monday,% 27-JUL-1992%08:11theCONFGR$$MODPARAMS directorytothesystem'sspecificroot,disk ;:[`sysroot*[ .SYSEXE].Itisrenamedfromj MODPARAMS. j system-namejtoMODPARAMS.COM.8TheCONFGRcommandforthisactivityis:%2``CONFGR' /MODPARAMS'/COPY[/NODE=name [,name]]''Lp""O5.4.1BExamplesessions@q*O Generating SYSHUTDWN.COMFiles;OD DAJAV$%confgr& /modparams%/node=ws1,ws2,ws3,ws46O Configure% MODPARAMS.DAT%for%WS1?%[Y]:&n3O Configure% MODPARAMS.DAT%for%WS2?%[Y]:1O %CONFGR-I-NOW,% MODPARAMS.DAT&for%WS23Od Configure% MODPARAMS.DAT%for%WS3?%[Y]:1O %CONFGR-I-NOW,% MODPARAMS.DAT&for%WS33O Configure% MODPARAMS.DAT%for%WS4?%[Y]:1O< %CONFGR-I-NOW,% MODPARAMS.DAT&for%WS4*O %CONFGR-I-CONFGRED,& WS2,WS3,WS4%O %CONFGR-W-NOTCONFGRED,&WS1r\,O Distributing SYSHUTDWN.COMFilesBOD DAJAV$%confgr& /modparams%/node=ws1,ws2,ws3,ws4&/copy?O %CONFGR-I-NOW,%checking%system%roots%on%$1$DUA4:?O %CONFGR-I-NOW,%checking%system%roots%on%$1$DUA5:?O %CONFGR-I-NOW,%checking%system%roots%on%$1$DUA6:?Od %CONFGR-I-NOW,%checking%system%roots%on%$1$DUA7:?O %CONFGR-I-NOW,%checking%system%roots%on%$1$DUA8:?O %CONFGR-I-NOW,%checking%system%roots%on%$1$DUA9:@O< %CONFGR-I-NOW,%checking%system%roots%on% $1$DUA10:@O %CONFGR-I-NOW,%checking%system%roots%on% $1$DUA11:@O %CONFGR-I-NOW,%checking%system%roots%on% $1$DUA16:@O %CONFGR-I-NOW,%checking%system%roots%on% $1$DUA17:@O\ %CONFGR-I-NOW,%checking%system%roots%on% $1$DUA22:@O %CONFGR-I-NOW,%checking%system%roots%on% $1$DUA23:@O %CONFGR-I-NOW,%checking%system%roots%on% $1$DUA24:@O3 %CONFGR-I-NOW,%checking%system%roots%on% $1$DUA25:@O{ %CONFGR-I-NOW,%checking%system%roots%on% $1$DUA34:@O %CONFGR-I-NOW,%checking%system%roots%on% $1$DUA35:@O  %CONFGR-I-NOW,%checking%system%roots%on% $1$DUA36:@OS %CONFGR-I-NOW,%checking%system%roots%on% $1$DUA37:?O %CONFGR-I-NOW,%checking%system%roots%on%$1$DUA0:?O %CONFGR-I-NOW,%checking%system%roots%on%$1$DUA1:?O+ %CONFGR-I-NOW,%checking%system%roots%on%$1$DUA2:@Os %CONFGR-I-NOW,%checking%system%roots%on% $1$DUA12:@O %CONFGR-I-NOW,%checking%system%roots%on% $1$DUA13:@O %CONFGR-I-NOW,%checking%system%roots%on% $1$DUA14:@OK %CONFGR-I-NOW,%checking%system%roots%on% $1$DUA15:@O %CONFGR-I-NOW,%checking%system%roots%on% $1$DUA18:@O %CONFGR-I-NOW,%checking%system%roots%on% $1$DUA19:@O# %CONFGR-I-NOW,%checking%system%roots%on% $1$DUA20:@Ok %CONFGR-I-NOW,%checking%system%roots%on% $1$DUA21:@O %CONFGR-I-NOW,%checking%system%roots%on% $1$DUA30:@O %CONFGR-I-NOW,%checking%system%roots%on% $1$DUA31:@OC %CONFGR-I-NOW,%checking%system%roots%on% $1$DUA32:@O %CONFGR-I-NOW,%checking%system%roots%on% $1$DUA33:BO %CONFGR-I-NOW,%checking%system%roots%on% SERV2$DUA0:BO %CONFGR-I-NOW,%checking%system%roots%on% SERV2$DUA1:BOb %CONFGR-I-NOW,%checking%system%roots%on% SERV2$DUA2:BO %CONFGR-I-NOW,%checking%system%roots%on% SERV2$DUA3:DO %CONFGR-I-NOW,%checking%system%roots%on% SERV2$DUB255:BO: %CONFGR-I-NOW,%checking%system%roots%on% DBOOT$DUA0:BO %CONFGR-I-NOW,%checking%system%roots%on% DBOOT$DUA4:MO Copy& MODPARAMS.DAT%for&WS3%to%DBOOT$DUA4:[SYS13.SYSEXE]?%[Y]:O %COPY-S-COPIED,%@SITE$MANAGEMENT:[SITE_MANAGER.CONFGR$$MODPARAMS]MODPARAMS.WS3;22%copied%to%)DBOOT$DUA4:[SYS13.SYSEXE]MODPARAMS.DAT;13%(2%blocks)\OZ %PURGE-I-FILPURG,%)DBOOT$DUA4:[SYS13.SYSEXE]MODPARAMS.DAT;11%deleted&(3&blocks)BO %CONFGR-I-NOW,%checking%system%roots%on% DBOOT$DUA5:PO Copy& MODPARAMS.DAT%for&WS1%to%DBOOT$DUA5:[SYS10.SYSEXE]?%[Y]:&nMO2 Copy& MODPARAMS.DAT%for&WS2%to%DBOOT$DUA5:[SYS18.SYSEXE]?%[Y]:Oz %COPY-S-COPIED,%@SITE$MANAGEMENT:[SITE_MANAGER.CONFGR$$MODPARAMS]MODPARAMS.WS2;24%copied%to%)DBOOT$DUA5:[SYS18.SYSEXE]MODPARAMS.DAT;13%(2%blocks)\O %PURGE-I-FILPURG,%)DBOOT$DUA5:[SYS18.SYSEXE]MODPARAMS.DAT;11%deleted&(3&blocks)BO  %CONFGR-I-NOW,%checking%system%roots%on% DBOOT$DUA6:MOR Copy& MODPARAMS.DAT%for&WS4%to%DBOOT$DUA6:[SYS15.SYSEXE]?%[Y]:O %COPY-S-COPIED,%@SITE$MANAGEMENT:[SITE_MANAGER.CONFGR$$MODPARAMS]MODPARAMS.WS4;22%copied%to%)DBOOT$DUA6:[SYS15.SYSEXE]MODPARAMS.DAT;12%(2%blocks)\O %PURGE-I-FILPURG,%)DBOOT$DUA6:[SYS15.SYSEXE]MODPARAMS.DAT;10%deleted&(3&blocks)DO* %CONFGR-I-NOW,%checking%system%roots%on% DBOOT$DUB255:*Or %CONFGR-I-CONFGRED,& WS2,WS3,WS4%O %CONFGR-W-NOTCONFGRED,&WS1O DAJAV$ Ks!O 6.2 DECwindowsJOAswithstartupsan effectiveuseoftheCONFGRutilityAOtomanage DECwidnows customizationdependsontheOBtwoaspects, B configurationcontrol Band(B generationandO distribution /.ytnO O ConfigurationControl/OU Configurationcontrolconsistsof:hu! > `mCmGroupingDCLcommands accordingto requirementintoKfilesnamedina meaningfulway.'ThisiswherecareandG considerationinbreakingstartupintouseful groupingswmustbe exercised..w Judicioususeofcommentswithin)eachDCLfileis essential.E>Thisactivity comprisescreatingand/or modifyingtheCONFGR$$DECWINDOWS: requirement.COMfiles. `A Maintainingtheoverallconfiguration.-EachsystemGohasitsownentry comprisingoneormorelines,withBcomma-separatedfields specifyingthenamesofthe"  requirementDCLfiles.6This$activity% comprises$the%editing%the/CONFGR$$DECWINDOWS:CONFGR.DECWfile..v! 'O Generationand DistributionLOUAsthe Generationand distribution activitiesare separate,IOCONFGRmaybeusedtocheckthe configurationfileandLO requirementDCLfileswithout affectinganysystem'sactualNO^ DECwindowssetup.&Thiscentral collectionofsystem-specificJO customizationfilesallowsready inspectionofasystem'sMOconfigurationswithoutbeingonthatnodeor accessingit'sOhsystemroot.=w vOOThe generationand distribution activitiesarehandledbytheOCONFGRutility. ^_UaNote ^_. Generally,&where%an% documentation<> indicates thata modification shouldmadeto-DECW$PRIVATE_SERVER_SETUP.COMthen2makethemusingtheCONFGRutility.^Donot m3^directlyeditany VAXclustermember's<2SYS$SPECIFIC:[SYSMGR]DECW$PRIVATE_SERVER_SETUP.COM+file,usetheCONFGRutility. Zx %O6.1B DECwindowsDCLFilesDOU DECwindowsserver customization generallyconsistsofOOdefiningalogicalor assigningasymboltoprovideguidance7O informationtotheX-serverstartup.(The@ DECwindowsDCLO^filesD^are basicallyDCL procedures.)These proceduremerelyLOcollecttogetherthese directivesinto meaningful groupings.*yBz 9-O DECwindows requirementDCLfile:YO O!------------------------------------------------------------------------------OP !& 100DPI.COMPO !&Set% DECwindows&server%startup&for%100% dots-per-inch%screens. O !XO( !&75dpi&are%also&large,%19"%screens%on% VAXstation&4000's% (1280x1024)_Op !&100dpi%are%large,&19"%screens&on& VAXstation%2000's&and%3100's% (1024x768)YO !&100dpi%are%also%small,%14"&screens%on% VAXstation%4000's% (1280x1024) O !*OH !& 07-MAY-92JMGDKinitial&fileYO O!------------------------------------------------------------------------------)O $&DECW$SERVER_DENSITY%==%100YO  O!------------------------------------------------------------------------------{W6OAlthoughCONFGR$$DECWINDOWS:100DPI.COMmayMOseematrivial requirementfile,theuseoftheDCLnamesHO5inthe configurationfileoffersaself-documentingandGOobvious descriptionofexactlywhattheserverstartupIOisbeing configuredfor (provided reasonablyobviousand7O>self-explanatoryfilenamesare chosen!). | O6.2B CONFGR.DECWFile7OUCONFGR$$DECWINDOWS:CONFGR.DECWprovidestheMOCONFGRutilitywiththeoverall configurationofeachnode.}AOEach!system!has its!own!entry," beginning!with aBOquote-delimitedsystemname(theSCSNODEname)andJO5 comprisingoneormorelines,withcomma-separatedfieldsLO specifyingthenamesoftherequirement-specificDCLfiles.OOAsystem specificationis considered continueduntilthenextLO> occuranceofaquote- delimitedsystemname.(Theseentries "WS23",&100DPIO "WS24",&100DPIO "WS25",&100DPIO "WS26",&100DPIO^ "WS27",&100DPIO "WS28",&100DPIO "WS29",&100DPIO6 "WS30",&100DPI O~ !O "WS31",&100DPIO "WS32",&75DPIOV "WS33",&75DPIO "WS34",&75DPIO "WS35",&75DPIO- "WS36",&75DPIOu "WS37",&100DPIO "WS38",&100DPIO "WS39",&100DPI OM !O "WS40",&100DPIO "WS41",&100DPIO% "WS42",&75DPIOm "WS43",&75DPIO "WS44",&100DPIO "WS45",&75DPIOE "WS46",&75DPIO "WS47",&100DPIO "WS48",&75DPIO "WS49",&100DPI Oe !O "WS50",&100DPIO "WS51",&100DPIO= "WS52",&100DPIO "WS53",&100DPIO "WS54",&100DPIO "WS55",&100DPIO\ "WS56",&100DPIO "WS57",&100DPIO "WS58",&100DPI O4 !O| "VCS",%100DPI O !YO  O!------------------------------------------------------------------------------t =! w7O6.3B GeneratedDECW$PRIVATE_SERVER_SETUP.COM(FileLOAll non-commentlinesaresimplyreadfromthe requirementFODCLfilesbytheCONFGRutilityandincludedinthename.(IfanyerrorsofthisnatureoccuredDCLcodeisalsoMO generatedtodisplayanotherwarningmessageontheconsolethesystemnamefromtheSCSNODE parameter.HOBydefaultCONFGR generatesfiles,not distributethem.H O /DECWINDOWS9OGenerateDECW$PRIVATE_SERVER_SETUP.COMfiles.BO5BydefaultStartup, Shutdown,Modparams/AUTOGENandOO DECwindowsfilesare configured.'Howeverifthis qualifieris?Ouseditcausestheothernottobe generated. O/LOCASE (default)O /NOLOCASERO5Convert non-quotedtexttolowercasebeforeplacingitintheO generatedfile.7  O /MODPARAMS)OGenerate MODPARAMS.DATfiles.BO5BydefaultStartup, Shutdown,Modparams/AUTOGENandOO DECwindowsfilesare configured.'Howeverifthis qualifieris?Ouseditcausestheothernottobe generated.]O/NODE= name o[, name ]BOBy defaultCONFGRoperates on allsystemsin theOO5 configurationfile.+This qualifierallowsthe specificationofMOone,ormoresystems,inacomma- separatedlist.*Acitivty -ADOBE-Courier-Bold-R-Normal--*-120-*-*-M-*-ISO8859-1M -ADOBE-New Century Schoolbook-Bold-I-Normal--*-140-*-*-P-*-ISO8859-1@ -ADOBE-Courier-Medium-O-Normal--*-120-*-*-M-*-ISO8859-1Zrzotv_T .d 4j%)>>8~D6I,K4M.PSJ Z$a#snwzXB  t zF8 R