E2&Guide to Installing and Using WATCHERRSWATCHER_DOC - Contents6B*,VAX DOCUMENT V2.2pJXJ (   ` MF\J1 ("#L%.1' 63= B +D:mD7GGJ.UH.VxVW'k^lJm npr<sAv4xz}~4&:a / gCONTENTSCONTENTS8 E\TitlePageTitle Page@E\ CopyrightPageCopyright Page1xE\PrefacePreface Mw  $K1 InstallingWATCHER1 Installing WATCHERbw/ $K1.1"&KRequiredLogicalNames1.1 Required Logical Namesnl$22$@1.1.1LogicalNameforHelpLibrary1.1.1 Logical Name for Help Library[w+ $L1.2&L PrivilegesRequired1.2 Privileges Required Yw* $L1.3&LOther Requirements1.3 Other Requirements#Ow!!$K2 ConfiguringWATCHER2 Configuring WATCHER&cw0 $K2.1#&KSettingupWATCHRules2.1 Setting up WATCH Rules)[l''$A2.1.1 Identifying Terminals2.1.1 Identifying Terminals+M\  $A2.1.2WATCHCriteria2.1.2 WATCH Criteria.Ul$$$@2.1.3Terminal Groupings2.1.3 Terminal Groupings3fg1 $K2.2$&K Exclusionsand Overrides2.2 Exclusions and Overrides5_w- $K2.3 &KSavingConfigurations2.3 Saving Configurations7_\))$A2.3.1 VAXcluster Environments2.3.1 VAXcluster Environments9]l(($A2.3.2EditingConfigurations2.3.2 Editing Configurations:Yw* $K2.4&K DECwindowsSupport2.4 DECwindows Support=Ww%%$K3TroubleshootingWATCHER3 Troubleshooting WATCHERDSw' $K3.1&KForcingWakeups3.1 Forcing WakeupsI^))[PartIINCommand DescriptionsPart II Command DescriptionsK)g  ELWCPWCPLZw''EK@ (RedirectCommandInput)@ (Redirect Command Input)T1gEKEXCLUDEEXCLUDEZ+gEKEXITEXITj+gEKHELPHELPo3g EKOVERRIDEOVERRIDEu+rELQUITQUIT-gEKRESETRESET+gELSAVESAVE8g EKSETACTIONSET ACTION4g EKSETBELLSET BELL4g EKSETDAYSSET DAYS6g EKSETDEBUGSET DEBUG@gEKSET DECWINDOWSSET DECWINDOWS>rELSET EVENT_LOGSET EVENT_LOG8g EKSETINSWAPSET INSWAP<g EKSETINTERVALSET INTERVAL>gEKSET MULTIWARNSET MULTIWARN8g EKSETVERIFYSET VERIFYFrEKSET WATCH_DEFAULTSET WATCH_DEFAULT+gELSHOWSHOW3g ELSHUTDOWNSHUTDOWN-gEKWATCHWATCHmM* Copyright1993,1994MadGoat Software.'Allrights reserved. ~AllRights Reserved.fS<+OGuideto InstallingandUsingO:WATCHER?OJune,1994YO{Thismanual describesthe installation,configuration,and operationofCOWATCHER,anidleterminalmonitorforVMSsystems.xN'ORevision/Update Information:'^Thisisarevisedmanual.,t*O OperatingSystemandVersion:,^VAX/VMSV5.0orlater,OpenVMS^AXPV1.0orlater]3OSoftwareVersion:^WATCHERV2.9 !  O OO 24June1994jO Permissionisgrantedtocopyand redistributethisdocumentforno commercialgain.jOVThe informationinthisdocumentissubjecttochangewithoutnoticeandshouldnotfObe construedasa commitmentbytheauthor.(TheauthorassumesnoresponsibilityBOforanyerrorsthatmayappearinthis document.Ou DISCLAIMER:RuTheauthor,theauthor's employer,andMadGoatSoftwaremakenofOrepresentationsor warrantieswithrespecttothecontentshereofand specificallynOdisclaimanyimplied warrantiesofmerchantabilityorfitnessforany particularpurpose.OOThe followingare trademarksofDigital Equipment Corporation: O-MOs Copyright1993,1994MadGoat Software.&Allrights reserved.* `  M #OPrefaceEOOneofthefirstprogramsanewVMSsystemmanagerSOusuallyneedsisan``idleterminal monitor''(ITM).Thatis,aMOXprogramtomonitorterminalactivityandlogoutthoseusersKOwhose terminalsremaininactiveforanextendedperiodofJO time.+AnITMhelpsensurethatsystem resourcesarenotLObwastedandhelpsreducethe possibilityof intrudersusingLO unattended terminalsasameansofentryintothesystem.  WKOUnfortunately,anITMcanalsobean annoyancetosystemMOusers.'AsimpleITMcan victimize legitimateuserswhomayNO5needtoremainloggedinbutidlewhiletheyareatwork.QOThiscanleadtocleverusersdevising ``hacks''toevadetheLOITM, defeatingthepurposeofusingtheITMinthefirstO>place.P  &KOWATCHERhasahighdegreeof flexibility,allowingsystemJOmanagerstodecidehowto accommodateusers'needswhileMO5still addressing operationalandsecurityissues.'WATCHERisDOfully configurable, providingthe following features:  S `mDmYoucantellWATCHERwhich terminalstowatch,andEona per-terminalbasis,what measurements(CPUuse,LprocessI/Ocount,terminalI/Ocount)touseascriteriaJwfor determining idleness,andhowlongaterminalshould?beidlebeforetheusershouldbeforcedoff. `OCOUserscanbeexcludedfrom interferencebyWATCHERCbasedonany combinationof username,UIC,aheldI identifier, privileges,terminaldeviceand/orportname,EYtime-of-day/day-of-week,andnameofimagebeingrun. `FYoucanoverrideormodifythewatchcriteriaand/orF0idletimesforanyuserbasedonany combinationofF username,UIC,aheld identifier, privileges,terminalDdeviceand/orportname,time-of-day/day-of-week,and&:nameofimagebeingrun.NGOThroughtheuseofthese features,thesystemmanagerKOshouldbeableto configureWATCHERtohandlemosttypes7O5of terminalsand accommodatemostusers.   OIntendedAudienceJOUThismanualisintendedforthesystemmanagerorotherJOperson responsiblefor installingand configuringWATCHER.M  3w ODocument StructureOOUThisdocumentconsistsoftwoparts.*Thefirst describestheKO installationanduseofWATCHER.Thesecond describesallAOoftheWATCHERControlProgram(WCP)commandsinO^detail.\  , OSupportforWATCHERFOUThereisnoformalsupportforWATCHER.IfyouhaveNOInternet connectivity,however,youmaywishto subscribetoOOoneormoreofthe followingMadGoatSoftwaremailinglists:O%%mInfo-MadGoat@wkuvx1.wku.edum CEW DiscussionofMadGoatSoftwareproductsbyusersandDMadGoat developers.,To subscribe,sendamessageto- #Info-MadGoat-Request@wkuvx1.wku.eduwiththewordKa SUBSCRIBEinthefirstlineofthebodyofthemessage.)MadGoat-Announce@wkuvx1.wku.eduj@DW Announcementsofnewreleasesandnewproductsfrom8MadGoat.+To subscribe,sendamessageto MadGoat-) Announce-Request@wkuvx1.wku.edu&withthewordKa SUBSCRIBEinthefirstlineofthebodyofthemessage.%MadGoat-Bugs@wkuvx1.wku.eduH! zIWAddressfor reportingbugsinMadGoatSoftware products.HPleaseincludethenameofthepackageandversioninKthesubjectheaderofthemessage,sothereportcanbeBamoreeasilydirectedtothe appropriate developer.! ROIfyoucannotsend electronicmail,youcancontacttheauthor3Obypost, facsimile,or telephoneat:b MatthewMadisonb] TGV, Incorporatedb 101CooperStreet&bP SantaCruz,CA95060USAOD Fax:bD +14084575208O Phone:b +14084575390J _!O 1.2 Installing!WATCHER>OTouseWATCHER,youneedthe followingfiles:W-O WATCHER.EXE# ThemainWATCHERimageO] WCP.EXE] TheWATCHERControl ProgramO$ WCP_HELPLIB.HLB!$ HelplibraryforWCPO DECW_STARTLOGIN.COM' Partof DECwindowssupportO WATCHER_CONFIG.WCFG, YoucreatethisfilewithWCPO WATCHER_STARTUP.COM" Samplestartupcommand procedure9OX WATCHER_SHUTDOWN.COMSampleshutdowncommand procedureO  SAMPLE_CONFIG.WCP%  Sample configurationcom-m mandsNMOThepackagecomeswiththeobjectcodefilesand librariesFOandacommand procedurecalled LINK.COM,forcreatingO5thetwoimages.x! aN\OItiseasiesttosimplyplaceallofthefilesinthe distributioninNOone directory,runLINK.COMtocreatetheimages,thenedit>O5WATCHER_STARTUP.COMandthesample configuration@OcommandsinSAMPLE_CONFIG.WCPasneededforyourPOsystem.)ThenallyouneedtodoistorunWCP,executetheEO>WCPcommandfileyoucreatedfromthesample,which@OinturncreatesaWATCHER_CONFIG.WCFGfile,then?OexecuteWATCHER_STARTUP.COMtostarttheWatcherOHprocess.y'O1.1BRequiredLogicalNamesDOUThethree system-widelogicalnamesWATCHERrequiresOare:, O WATCHER_DIR. Shouldpointtolocationofim-(0 agesandcommand proceduresO WATCHER_CONFIG+ ConfigurationfiletobeusedO$ WATCHER_TRACE+$ Tracefile;useNL:ifdebugq disabledh>>OTheyshouldallbedefinedin executivemode. 2O1.1.1BLogicalNameforHelpLibraryKO4ThehelplibraryforWCPmaybeplacedin SYS$HELP,or,MOifyoudefinethelogicalname WCP_HELPLIBtobethefullKOpathnameofthefile,anywhereelseonthesystem.,The?O=sampleWATCHER_STARTUP.COMincludesthe necessary2ODEFINEcommandtodothisforyou.1  #O1.2B PrivilegesRequiredLOUTheaccountthatisusedfortheWATCHERprocessrequires%Othe following privileges:;!! O CMKRNL7K Requiredfor DECwindowssupportanddis-K0 connectsO PRMMBX.K FordefiningthecommandmailboxO$ PSWAPM$K$ Requiredfor disconnectsO SHAREsupport.)CMKRNLandPSWAPMarerequiredtoperform,Ovirtualterminaldisconnections."e# ;"O1.3BOther Requirements4OUTheRUNcommandinWATCHER_STARTUP.COMBOshouldprovidetheWATCHERprocesswith sufficientCOquotastooperateonmostsystems..CPUandmemoryIO^ requirementswillvary dependingonthenumberofrulesIOintheWATCHERconfiguration,peaknumberof interactiveLOusers,andpeaknumberofwatchedusers.(YoumaywishtoKOhrefertothe followingtablein computingexpectedmemory7O resourcesneededbytheWATCHERprocess:$! b,O MemoryrequiredperWATCHrule 206bytesaccesstothejoblogicalnametablesofall interactiveand/Odetached processesonthesystem.p& 9F"O 2.2 Configuring!WATCHEREOTheWATCHERControlProgram(WCP)isusedtocreateGOWATCHERconfigurations.)WCPisdesignedtobeexecutedLOBasaVMSforeigncommand.'Tosetuptheforeigncommand,Odefinethesymbol O  $$  WCP%:==%$WATCHER_DIR:WCP'zuKOOncethesymbolissetup,youcaninvokeWCPwiththeOcommand: Oa $ a WCP(zJOWCPwill automaticallyloadthecontentsofyourdefined0OWATCHER_CONFIGfile,ifitexists. )(O2.1BSettingupWATCHRulesFOUTheWATCHcommandsetsuprulesthat determinewhichJO terminalsgetwatched,howto determinewhethertheter-MOminalsareactive,andhowlong terminalsmustbeinactive?O^beforeausercanbeforcedoff.&Forexample:O WCP>9  WATCH&(*$RT*/MEASURE=PROCESS_IO/LOGOUT=00:15:00*VKOThiscommandsetsuparuleforwatchingallDECnetre-QOmotelogins,usingchangesintotalprocessI/O (bufferedplusOO5direct)to determineprocess activity,andcausinglogoutsto4Ooccurafter15minutesof inactivity. _UNote _=YoumusthaveatleastoneWATCHcommandinyourconfiguration. : +! 'O2.1.1B Identifying TerminalsGO4WATCHcommandstakeanywildcardpattern.(AllterminalLOdevicenamesthatmatchthe specifiedpatternarewatched.HOThedevicenamesusedbyWATCHERarethephysicalde-TO=vicenamesof terminals;ifthesystemispartofa VAXcluster,QOSCSnodenameisprefixedtothedevicename,asisnormally;OdonebyVMSwithcluster-accessibledevices., POIftheterminaldevicedriversupportsremoteport identifica-KOtion,asdoestheLTDRIVERforLAT terminals,theremoteMO5port informationcanalsobeusedasamatch criterionbyFOusingthe /ACCPORNAM qualifier.*Theportnamecanbe=O specifiedasawildcardpattern.'Forexample:Ok WCP>+ k WATCH&*$LT*/ACCPORNAM="TRMSRV/*"- zKOThiscommandwouldcausethe terminalsattachedtotermi-/OnalserverTRMSRVtobewatched. . O2.1.2BWATCHCriteriaMO4WATCHERgivesyouthechoiceofusingoneormoreoftheIO following measurementsascriteriaforjudgingwhethera)Oterminaloruserisactive:/sO TERMINAL_IO53 theI/O operationcountonthetermi-30 naldevice O CPU43 ThetotalCPUtimeusedbythepro-43 cessowningtheterminalplusallof.3E its subprocesses,in centisecondsO PROCESS_IO23 thesumofthebufferedanddirect43  I/Ocountsoftheprocessowningthe43Z terminalplusallofits subprocessesn0! DFOThe TERMINAL_IO measurementisusefulfor conventionalOO terminalsbutcannotbeusedfor workstations(runningeitherJO5VWSor DECwindows)duetothenatureof workstationac-IOtivity.( PROCESS_IOis recommendedforuseon workstationOterminaldevices.1WJOForanyofthese measurementsyoucanspecifyaminimumAO thresholdvalue.+WhenWATCHERperformsacompari-LO5son,the differencebetweenthecurrentmeasuredvalueandMOthelastmeasuredvaluemustbegreaterthanthe specifiedLO thresholdtobecountedas activity.+Thedefault thresholdUO>valueiszero,sothatany differenceatallcountsas activity.2N@OSeveralsamplesofWATCHcommandswith differentFOcriteriaand thresholdvaluesareprovidedinSAMPLE_O5 CONFIG.WCP.3 &$O2.1.3BTerminal GroupingsIO4YoucangroupWATCHrulestogetherbyusingthe/GROUPHO qualifier.*WhenWATCHERappliesitsrulesfor determin-OOingterminal activity,activityononeterminalinthegroupNO=countsasactivityforallthe terminalsinthegroup.,TheLOmainuseforthisfeatureiswithmulti-windowed terminalsDOand workstationsrunningVWS (DECwindows workstationsMOGarehandledinthismannerautomatically).'Forexample,theQO followingruleshandleallthe workstationterminaltypesona'O standaloneVWS workstation:O} WCP>A } WATCH&WTA*/GROUP=VWSp!%normal% VT200-series&windowsO WCP>A  WATCH&TKA*/GROUP=VWSp!%Tek%4010% emulation%windowsO  WCP>A   WATCH&TJA*/GROUP=VWSp!%Tek%4125% emulation%windows4 NNOTheusercanthencreateanynumberofanytypeoftermi-VOnalwindow,andaslongasoneofthemisactive,theywillallO5remainloggedin.5 Gw)O2.2B Exclusionsand OverridesGOU WATCHER's behaviourtowardsaterminalorusercanbeJOmodifiedthroughthe definitionof exclusionandoverrideMOrules.) Exclusionsand overridescanbebasedonanycombi-IO^nationof username, terminal/portname,UIC,imagebeingQOrun, privileges,aheld identifier,andtimeofday.) ExclusionHOrulespreventWATCHERfromtakinganyactiontowardsaOOhuser,whileoverriderulesmerelymodifyhowtheterminalisSOwatched(i.e.,theactivitycriteriaand inactivity periods).'For8Oexample(takenfroma VAXclustersystem):O WCP>*  EXCLUDE%SYSTEM/TERMINAL=*$OPA0:O WCP>E  OVERRIDE&1JONES/TERMINAL=NODE1$TXA3:/DURING=(PRIMARY:8-16)-O. _WCP>. /LOGOUT=02:00:006! WCOThefirstcommandpreventsWATCHERfromtakinganyQOactionagainsttheSYSTEMaccountwhileitisloggedintotheKO5systemconsole.(Thesecondcommandextendsthelogoutin-LOactivityperiodtotwohoursforuserJONESweekdaysfromQO8amto4:59pm,whileJONESisloggedintotheterminalinEO>heroffice,whichisonportTXA3onsystemNODE1.' 07%O2.3BSavingConfigurationsNOUOnceyouhave establishedtherulesyouneedforyourcon-OO figuration,youshouldcreatethe configurationfilewiththeOSAVEcommand:O WCP>  SAVE%WATCHER_CONFIG=8 HOIfWATCHERis currentlyrunning,youcanhavethenewJO configurationtakeeffect immediatelywiththeRESETcom-KO5mand,whichwillcausetheWATCHERprocesstoreloadits6O configuration informationfromthefile.9 )O2.3.1B VAXcluster EnvironmentsBO4Formainly homogeneous VAXcluster environments,youROshouldbeabletouseone configurationfileforallnodesinQOthecluster.*Ifyouhaveamixofnodes,however,itmaybeNO=easiertocreatemultiple configurationfilesanddefinetheCOWATCHER_CONFIGlogicalname differently dependingonOthesystem.B: (O2.3.2BEditingConfigurations=O4TheWATCH,EXCLUDE,andOVERRIDEcommandsallHOhavea/DELETEtoallowyoutoremoverulesfromtheNO database,andyoucanaddrulesaswell.(However,youcan-NO=notcontroltheorderofthenewrules(orderis importantKObecauseWATCHERsearchestherulelistsintheorderyouJOenterthemuntilone matches).+Toassistinmakingcom-IOGplexchangestotheconfiguration,theSHOWcommandhasJOa/COMMAND qualifierthatcausesthe configurationinfor-OOmationtobe displayedascommandsyouwouldentertobuildOQtheconfiguration:O WCP>-  SHOW/COMMAND/OUTPUT=CONFIG.WCP%ALLO;b%FOOnceyoudumpthecommandstothecommandfile,youHOcaneditthecommandfileasneededandcreateanew-O5 configurationwiththe commands: O $ WCP/NOFILEO WCP>  @CONFIGOI WCP> I SAVE%WATCHER_CONFIG0<ROInsteadofeditingtheconfiguration,itmaybeeasierjusttoEOmaintainaWCPcommandfilewiththe necessarycom-KO5mandsinitandbuildanew configurationeachtimeyou$Oneedtomakeachange.3= "O2.4B DECwindowsSupportDOUTheVMS DECwindowsimplementationmakesit difficultGOfora WATCHER-typeprogramtoproperly identify,warn,EOandlogout DECwindows sessions.'However,WATCHERdoesIO^providelimitedsupportforwatching DECwindows sessions,2Oenabledwiththe following commands:O< WCP> < SET% DECWINDOWSO WCP>3  WATCH&"*WSA*/MEASURE=PROCESS_IO/NOWARNING>! NGONotethatyoucannotuse TERMINAL_IOasa measurementBOwhenwatching DECwindows sessions,norcanWATCHER9O5givewarningstoidle DECwindows sessions.? BOWATCHER identifies DECwindowssessionsby searchingSOthejoblogicalnametableforeach interactiveprocessfortheEO5logicalname DECW$DISPLAY,definedin executivemode.MOEach interactivejobrelatedtoasingle DECwindowssessionCOwillhavethesamevaluefor DECW$DISPLAY.WATCHERNO> immediatelychangestheterminaldevicenameitusestotheLOWSAdevicename(evenforDECterm sessions)andalsosetsOOthegroupnametotheWSAdevicename.'Inthisway,activ-ROHityinanyofthe DECwindowsjobswillbecountedasactivity5Oforalljobsrelatedtothatsession.>@ >OThe DECwindowswindowmanagerandDECtermcon-OOtroller processesaredetached processesthatarealsoneededDO5byWATCHER(whenforcingoffa DECwindows session).FOToidentifythese processes,WATCHERsearchesforde-BOtached processeswith DECW$DISPLAYdefinedinuserHO>mode.*WATCHERtracksthese processes,butdoesnotuseROtheminactivity determination(itcallsthem``fake'' processes!Oin debug/tracelogs).A! COWhenWATCHER identifiesa DECwindowssessiontobeQOforcedoff,itlooksforall processes (includingthedetachedLO5 processes,whichare important)withamatchingWSAdeviceNOnameandforcesthemoff.)Thisshoulddestroyallthewin-POdowsonthe workstationandreturnittoablank, backgroundOO>screen.)Itthencreatesadetachedprocessthatexecutesthe?ODECW_STARTLOGINcommand procedure(whichmustbeKOlocatedinWATCHER_DIR:),which,afterwaitingafewsec-SOHondsforotheractivitytodiedown,restartstheloginprocess)OontheaffectedWSAdevice.B rFOWATCHERcannotbeusedtowatch DECwindowsjobsthatPOarestartedonremotesystems,withthelocal workstationbe-RO5ingusedonlyasadisplay.(TheremustbeatleastsomejobsJOrunningonthe workstationwithsomeactivitytoprevent@OWATCHERfromloggingoutthe DECwindowssession.SC)FOThis techniqueshouldbe effectiveforVMS DECwindowsCOV2(VMSV5.1throughV5.5)andV3(alsoknownasAO5DECwindows/MotifV1.0), andshouldevenworkwithEOX terminals.,Itmaynotworkwithfuture DECwindowsOimplementations. D! n&O 3.2Troubleshooting!WATCHERJOIfWATCHERisnotbehavingas expected,theremaybeaFOproblemwithyourWATCHERconfiguration.*Thereisde-LOB bug/tracecodebuiltintoWATCHERtoallowyoutomonitorJOfive categoriesof activities:+themainlineWATCHERcode,GOtheexclusion-checkingcode,theoverride-checkingcode,FOL measurementchecks,andprocess information collection.JOThroughtheuseoftheSETDEBUGcommand,youcanturnKOontracingforanyorallofthese debugging categories.dE :LOIfWATCHERisalreadyrunning,thebestwaytosetupaKOtest configurationiswiththe followingcommand sequence: Oa $0a SET%!PROCESS/PRIVILEGE=(SYSNAM,SYSPRV) O $  WCPO WCP>  SET%DEBUG=nO9 WCP> 9 SET%NOACTIONO WCP>'  SAVE%WATCHER_DIR:TEST_CONFIGO WCP>  EXIT O $E DEFINE/SYSTEM/EXEC%WATCHER_CONFIG%WATCHER_DIR:TEST_CONFIG OY $<Y DEFINE/SYSTEM/EXEC% WATCHER_TRACEKtrace-file-spec O $ WCP%RESET]F 3OThedebuglevel  n5is describedintheSETDEBUGcommandTO description,butusuallywillbe1(just mainline)or31(full).RO5Youcandirectthetrace informationtoanyfile accessibleto2OWATCHER,ortoanunowned terminal.GN=OTheSETNOACTIONcommandwillpreventWATCHERJOfromactuallylogginganyoneoutorsendingwarningmes-O5sagesto terminals.H! WIO SubsequentWCPRESETcommandswillcausethetracefileTOtobeclosedandanewversioncreated,soyoucaneasilyviewRO5pasttrace information.'Togobackto``production''mode,justFOredefineWATCHER_CONFIGbacktothenameoftherealHO configurationfile,define WATCHER_TRACEtobeNL:,and.O>issueanotherWCPRESETcommand.+iI=?O3.1BForcingWakeupsGOUToassistin debugging,youmaywanttohaveWATCHERLOwakeupmoreoftenthannormal.*Youcandothisbyset-KOtingashorterwakeupintervalinthetestconfiguration,IO^oryoucanforceawakeuptooccurbywritingtotheCOWATCHERcontrolmailbox.-Fromasuitably privileged;Oaccount (SYSPRV),youcanusethe commands: O $* OPEN/WRITE%WMBOX% WATCHER_MBOX: O $ WRITE&WMBOX&"" O$ $$ CLOSE&WMBOXJ~>OEach WRITEcommandwilltrigger awakeup,!and@OWATCHERwillgothroughits processing sequence.mSK))OPartII7Command Descriptions77L  OWCP*M]N33OExecutestheWATCHERControlProgram.OSOFormatOs WCPN [command]OCommand QualifiersDefaultsO:/FILE=file-spec:See description.PO ParametersOs [command]DOAnyWCPcommandexcepttheinput redirectionopera-LO$tor(@).+The specifiedcommandisexecutedandcontrolis5O|returnedtoDCL immediately thereafter.Q O DescriptionLOsWCPisintendedtobeusedasaDCL ``foreign''command.QOTouseitasaforeigncommand,youmustdefineasymbolasO$follows: O $$ WCP%:==%$WATCHER_EXE:WCPR NPODefiningthesymbolinthiswayallowsyoutousethe/FILEKO qualifierandspecify ``one-shot''commandsonthecommandO5line.SFyO QualifiersOs/[NO]FILE=file-specLOLoadsthe specifiedWATCHER configurationfileforediting.SO$Ifnot specified,the configurationfilepointedtobythelog-EO|icalnameWATCHER_CONFIGisloaded.*ThedefaultfileOOtypeisWCFG.If/NOFILEis specified,no configurationfileO-isloaded.GQT''O@ (RedirectCommandInput)*UaV77OExecutesWCPcommandsreadfromafile.PW&OFormatOs @N file-specX =O ParametersOs file-specLONameofthefile containingWCP commands.(Ifomitted,the'O$defaultfiletypeisWCP.=Y O DescriptionHOsUsethiscommandtohaveWCPtakefurthercommandin-SOputfromthe specifiedfile.)Thereisnobuilt-inlimitontheMO$numberoflevelsofnestingofcommandfiles,sobecare-HO|fulwhenusinginput redirectionfromwithinacommandJOfile.)Commandsreadfromcommandfilesarenot displayed#O-unlessyouSETVERIFY.GOCommand redirectioncanonlybeusedattheWCPcom-JO!mandprompt,notasa ``one-shot''WCPcommand.'TohaveQOzafilebeusedforinputforanentireWCPsession,usethe1O followingsequenceofDCL commands. OW $+W DEFINE/USER& SYS$INPUT% file-spec O $  WCP;ZOEXCLUDE*[Q\''ODefinesan exclusionrule.-].OFormatOs EXCLUDEN username-patOCommand QualifiersDefaultsO:/ACCPORNAM=port-pat: /ACCPORNAM= D*O|/DELETEO/DURING=daytim-list(allthetime)O/HOLDING=identifier (ignored)OD/IMAGE=fspec-patD/IMAGE= N*O/PRIVILEGES=priv-list (ignored)O/TERMINAL=dev-pat /TERMINAL= >*O /UIC=uic /UIC=[ n*  , *  ]^! =O ParametersOs username-patLOAVMSusernameorpattern containing wildcards, identifying&O$theusertobe excluded._ZO DescriptionGOsThiscommandisusedtoaddorremove(with/DELETE)EOan exclusionruletotheWATCHERconfiguration.+WhenJO$WATCHERisrunning,anyprocessthatmatchesalloftheMO| specifiedcriteriaisnotwatched.,Omittedcriteriaarenot"Ousedoralwaysmatch.q`GO QualifiersOs/ACCPORNAM=port-patKOPortnameorpattern containing wildcards, identifyingtheKO$terminalport(forterminalserversandotherdevicesus-OO|ingportnames)onwhichtheusermustbeloggedintobe1O excluded.'Thedefaultisanyport.aO/DELETEMO( Specifiesthattheruleshouldbedeletedfromtheconfig-OOuration.+AllcriteriamustmatchexactlyfortheruletobeOdeleted.bO/DURING=daytim-listTO( SpecifiesalistofdaysandtimesduringwhichtheuseristoKObeexcludedfrom watching.)Theday/timespecificationsareOoftheform Oi day:(hour-range[,...])Owhere K day?isadayoftheweekorthewordPRIMARYorEO] SECONDARY, identifyingtheprimaryand secondarydays$OsetwithSETDAYS,and hour-range%iseitherasinglehourLOnumber(0through23)ortwohournumbers separatedbyaHOghyphen.'Multiplehourrangesmaybe specifiedperday.c! O/HOLDING=identifierSO( Specifiesthattheusershouldbeexcludedifholdingthespec-POified identifier.*The identifieris convertedtobinaryformatMObeforebeingstoredintheconfiguration,soyoumustcre-RO2atethe configurationfileonthetargetsystem,oronanodeMOwiththesame RIGHTSLISTdatabaseasthetargetsystem,to:Opreventmisinterpretationofthe identifier.!d HOIfyouarerunningVMSV5.4orlater,WATCHERobtainsOOthe identifiersheldbytheprocessdirectly(using $GETJPI),NO5andthuscancheck identifiersthataregranted dynamically.BOPriortoV5.4,WATCHERusesthe $FIND_HELDsystemUOservicetoscanthesystem rightslistfor identifiersheldbytheMO>userthatownseachprocess; dynamicallygranted identifiers.Ocannotbecheckedinthiscase.CeGONotethatifyoudonotuse/HOLDINGonanyEXCLUDEFOorOVERRIDEcommand,therights identifier informationLO5isnot collectedbyWATCHER, resultinginsomesavingsin@O processingtime (especiallyonpre-V5.4 systems).f^O/IMAGE=fspec-patKO( SpecifiesthattheusershouldbeexcludedifrunninganGO executableimagewhosename(asreturnedbytheJPI$_AOIMAGNAMEitemfrom$GETJPI)matchesthe specifiedHO2wildcardpattern./Forajobwith subprocesses,theim-EOagenamethatWATCHERusesformatchingagainsttheKOwildcardpatternistheimage currentlybeingrunbythePO<masterprocessinthejob,or,ifthemasterprocessisnotLOrunninganimage,animagebeingrunbyoneofthesub-MO processes (randomlyselectediftherearetwoormoresuchOEsubuprocesses).g! O/PRIVILEGES=priv-listTO( SpecifiesthattheuseristobeexcludedonlywhenholdingtheSO specified privilegeor privileges.(Ifomitted, privilegesarenot!Ousedasa criterion.h O/TERMINAL=dev-patNO( Specifiesaterminaldevicenameorpattern containingwild-NOcards.)TheusermustbeloggedintoamatchingterminaltoObe excluded.[i K1O/UIC=uicNO( SpecifiesaUICorUICpattern.)AprocessisexcludedonlyIOwhenownedbyamatchingUIC.YoumayuseanasteriskROforthememberpartoftheUICtohaveallUIC'sinagroup6O2match.'Ifomitted,anyUICwillmatch..8jOEXIT*kJl  OEndsaWCPsession.HmOFormatOs EXIT n! =O DescriptionOOsEndsthecurrentWCPsessionandreturnscontroltoDCL.IfQOyouhavemodifiedtheconfiguration,EXITwillaskforafileAO$nameforsavingthe configurationbeforeexiting.V8oOHELP*pPq&&ODisplayshelp information.Tr*OFormatOs HELPN [topic...]s=O ParametersOstopicUOThenameofatopicinthehelplibrary.)Ifomitted,alistof O$topicsis displayed.ttJO Description5OsThiscommandisprettystraightforward.' <uOOVERRIDE*vPw&&ODefinesanoverriderule.xpOFormat Os OVERRIDEN username-patOCommand QualifiersDefaultsO:/ACCPORNAM=port-pat: /ACCPORNAM= D*O|/DELETEO/DURING=daytim-list(allthetime)O/HOLDING=identifier (ignored)OD/IMAGE=fspec-patD/IMAGE= N*O/PRIVILEGES=priv-list (ignored)O/TERMINAL=dev-pat /TERMINAL= >*O /UIC=uic /UIC=[ n*  , *  ]%OM/[NO]DISCONNECT[=deltatime]%O/[NO]FORCE_EXIT[=deltatime]!O/[NO]LOGOUT[=deltatime]&O/MEASURE=(measurement[,...])"OW/[NO]WARNING[=deltatime]y! =O ParametersOs username-patLOAVMSusernameorpattern containing wildcards, identifyingEO$theuserforwhichtheoverrideistotakeeffect.z! FO DescriptionGOsThiscommandisusedtoaddorremove(with/DELETE)DOanoverrideruletotheWATCHERconfiguration.,WhenJO$WATCHERisrunning,anyprocessthatmatchesallofthePO| specifiedcriteriawillhavethewarning,logout,andmeasure-NOment information,if specified,takenfromtheoverriderule(O-insteadoftheWATCHrule.|{ RO QualifiersOs/ACCPORNAM=port-patKOPortnameorpattern containing wildcards, identifyingtheMO$terminalport(forterminalserversandotherdevicesusingQO|portnames)onwhichtheusermustbeloggedintohavethe8Ooverrideapply.'Thedefaultisanyport.|O/DELETEMO( Specifiesthattheruleshouldbedeletedfromtheconfig-OOuration.+AllcriteriamustmatchexactlyfortheruletobeOdeleted.} 'iO/DURING=daytim-listTO( SpecifiesalistofdaysandtimesduringwhichtheoverrideisGOtoapply.'Theday/timespecificationsareoftheform O day:(hour-range[,...])Owhere K day?isadayoftheweekorthewordPRIMARYorEO SECONDARY, identifyingtheprimaryand secondarydays$O]setwithSETDAYS,and] hour-range%]iseitherasinglehourLOnumber(0through23)ortwohournumbers separatedbyaHOhyphen.'Multiplehourrangesmaybe specifiedperday.~ O/HOLDING=identifierPO( SpecifiesthattheoverrideshouldapplyonlyiftheuserisROholdingthe specified identifier.)The identifieris convertedtoQObinaryformatbeforebeingstoredintheconfiguration,soyouRO2mustcreatethe configurationfileonthetargetsystem,oronIOanodewiththesame RIGHTSLISTdatabaseasthetargetGOsystem,topreventmisinterpretationofthe identifier.! HOIfyouarerunningVMSV5.4orlater,WATCHERobtainsOOthe identifiersheldbytheprocessdirectly(using $GETJPI),NO5andthuscancheck identifiersthataregranted dynamically.BOPriortoV5.4,WATCHERusesthe $FIND_HELDsystemUOservicetoscanthesystem rightslistfor identifiersheldbytheMO>userthatownseachprocess; dynamicallygranted identifiers.Ocannotbecheckedinthiscase.HGONotethatifyoudonotuse/HOLDINGonanyEXCLUDEFOorOVERRIDEcommand,therights identifier informationLO5isnot collectedbyWATCHER, resultinginsomesavingsinEO processingtime (especiallyonpre-VMSV5.4 systems).^O/IMAGE=fspec-patPO( SpecifiesthattheoverrideshouldapplyonlyiftheuserisHOrunningan executableimagewhosename(asreturnedby@Othe JPI$_IMAGNAMEitemfrom$GETJPI)matchestheNO2 specifiedwildcardpattern.*Forajobwith subprocesses,theBOimagenamethatWATCHERusesformatchingagainstKOthewildcardpatternistheimage currentlybeingrunbyUO<themasterprocessinthejob,or,ifthemasterprocessisnotLOrunninganimage,animagebeingrunbyoneofthesub-MO processes (randomlyselectediftherearetwoormoresuchOEsubuprocesses).O/PRIVILEGES=priv-listNO( SpecifiesthattheoverrideshouldapplyonlywhentheuserOOisholdingthe specified privilegeor privileges.,Ifomitted,7O privilegesarenotusedasa criterion. O/TERMINAL=dev-patNO( Specifiesaterminaldevicenameorpattern containingwild-NOcards.)Theusermustbeloggedintoamatchingterminalto%Ohavetheoverrideapply.e K;O/UIC=uicPO( SpecifiesaUICorUICpattern.(TheoverrideappliesonlytoLO processesownedbyamatchingUIC.Youmayuseanaster-POiskforthememberpartoftheUICtohaveallUIC'sina=O2groupmatch.'Ifomitted,anyUICwillmatch.* %O/[NO]DISCONNECT[=deltatime]JO( Specifiesthatthelogout/disconnect informationshouldbeKO overridden, performingavirtualterminal disconnectionin-ROsteadofdeletingtheuserprocess.'The inactivityintervalcan+O2be overriddenby specifyingav2 deltatime$2,orlogouts/disconnectsGOcanbe prevented altogetherby specifying /NODISCONNECTKO (althoughitismore efficienttouseEXCLUDEforthis).! %O/[NO]FORCE_EXIT[=deltatime]JO( Specifiesthatthelogout/disconnect informationshouldbePO overridden, performingaforcedimageexitinsteadofdeletingJOtheprocessor disconnectingthe terminal.)Only user-modePO2imagesareforced;iftheuserisatDCLcommandlevel,theOOforcedexitisskipped.*The inactivityintervalcanbeover-#Oriddenby specifyinga{ deltatime*,orexits/logouts/disconnectsGO<canbe prevented altogetherby specifying /NOFORCE_EXITKO (althoughitismore efficienttouseEXCLUDEforthis). !O/[NO]LOGOUT[=deltatime]JO( Specifiesthatthelogout/disconnect informationshouldbePO overridden, performingaprocessdeletioninsteadofavirtualMOterminaldisconnection.(The inactivityintervalcanbeover-#O2riddenby specifyingay2 deltatime,2,orlogoutscanbe preventedKOby specifying /NOLOGOUT (althoughitismore efficientto#OuseEXCLUDEforthis).&O/MEASURE=(measurement[,...])LO( Specifiesthattheactivity measurementsshouldbeoverrid-Oden.'For measurement.,specifyoneofthe following:~ TOCPU[:* threshold z]"CPUtime(thesumof";theCPUtimeusedby%theprocessandallits& subprocesses,in centisec-(Eonds)shouldbeusedasa criterion.*If threshold His) specified,the differencein$OCPUtimebetweenpasses&mustexceedthe specified( thresholdforaprocessto!Xbe consideredactive.O PROCESS_IO[:o threshold ]%ProcessI/O(thesumof$+thebufferedanddirect(I/Ocountsfortheprocess&andallits subprocesses)'4shouldbeusedasacri-terion.-If threshold is) specified,the differencein&>I/Ocountsbetweenpasses&mustexceedthe specified( thresholdforaprocessto!Hbe consideredactive.O TERMINAL_IO[: threshold(]TerminalI/O(theopera-( tioncountontheterminal's device)shouldbeusedas a criterion.)If threshold  is)$  specified,the differencein&| I/Ocountsbetweenpasses& mustexceedthe specified(-  thresholdforaprocessto! be consideredactive.\2AOAny combinationof PROCESS_IO,CPU,and TERMINAL_*OIOis permitted.)Ifomitted,4 threshold$valuesdefaulttozero.PO5Notethat thresholdvaluesshouldbechosenasafunctionof@Othewakeupinterval(definedwithSET INTERVAL).] K3"O/[NO]WARNING[=deltatime]MO( Specifiesthatthewarning informationshouldbe overridden.MOThewarning inactivityintervalcanbe overriddenbyspeci-Ofyingac deltatime=,orwarningscanbe preventedby specifyingO2 /NOWARNING. !8OQUIT*h>>OQuitsWCPwithoutsaving configurationchanges.HOFormatOs QUITO DescriptionJOsIfchangestothe configurationhavebeenmade,youare5Oaskedfor confirmationbefore quitting.! "9ORESET*h>>OSendsaresetcommandtotheWATCHERprocess.IOFormatOs RESET! 0hO DescriptionCOsThiscommandsendsaresetcommandtotheWATCHERHOprocess,whichcausesWATCHERtoflushallprocessandOO$ configuration information,closeitslogandtracefiles,and.O|readinthe configurationagain.KOOPERandSYSPRV privilegesarerequiredforthiscommand."!#8OSAVE*U++OSavesaWATCHERconfiguration.U+OFormatOs SAVEN [file-spec] FO ParametersOs file-specOONameofthefiletowhichthe configurationshouldbewrit-XO$ten.'Ifomitted,itdefaultstothenameofthefilereadinwithRO|theWCP/FILE qualifier(ifany).)If specified,thedefaultfilePOtypeisWCFGandthedefaultlocationisthecurrentdefaultO- directory.#"$?OSETACTION*AVDOControlswhetherWATCHERperformswarningandlogoutO(actions.S)OFormatOs SET [NO]ACTION! O DescriptionMOsTotestoutaWATCHER installationor configurationchange,AOyoumaywanttoSETNOACTIONtopreventWATCHERLO$fromactually notifyingany terminalsorlogginganyusersHO|out.+TheSETNOACTIONsettingallowsyoutotestyourNO configurationsafely,andusetheDEBUGandtrace facilities8O-toseehowWATCHERwouldhave performed.POWhenyouarethroughtesting,returnthesettingbacktotheFO!default,SETACTION,tohaveWATCHERactuallyperform4Oz warnings,disconnections,logouts,etc.$#%=OSETBELL* AnQOEnablesordisablestheringingoftheterminalbellonwarn-O(ingsandlogouts.Q'OFormatOs SET[NO]BELLZ0O DescriptionIOsBydefault,theterminalbellisnotrungwhenWATCHERJOdisplaysawarningorlogoutmessageona terminal.+SETGO$BELLwillcauseWATCHERtosendaBEL characterwithAO|themessagetocausetheterminalbelltoring.<%$&=OSETDAYS*AfGO Establishestheprimaryand secondarydaysettingsforO( subsequent commands.OFormatOs SETDAYSOCommand QualifiersDefaultsO:/PRIMARY=(day-list)O|/SECONDARY=(day-list)sIO DescriptionKOsThiscommandisusedtomoveoneormoredaysfromtheLOprimarydaylisttothe secondarydaylistor vice-versa.KO$Theselistsareusedas shorthandbyothercommandswhen>O|youspecifyPRIMARYor SECONDARYona/DURINGO qualifier.A&%'>OSETDEBUG*AgQOEnablesordisablesdebugtracingandsetsthelevelofdebugO( information.Y/OFormatOs SET[NO]DEBUG[=mask] zO Description?OsSETDEBUGturnsondebugtracing./WATCHERwillMOsenddebugoutputtothefileordevice identifiedbythe,O$ WATCHER_TRACElogicalname.(For$ mask$,specifyadec-JO|imalnumber representingabitmask indicatingwhichkinds8Oof debugging informationyouwantlogged.1!  OOValueBitno. Description O A1 [A0Amainlinecode 2 [1 exclusionchecks 44 [424overridechecks 8 [3 measurementchecks z(16 [(4#(processinfo collection OC OThe maskHvaluecanbeanyoneoftheabove,orasumofanyHO=oftheabovevalues.*UseSETNODEBUGtodisabledebugOtracing.'&(COSET DECWINDOWS*& A_MOEnablesordisablesextra processingrequiredfor DECwindowsO(support.W-OFormatOs SET[NO]DECWINDOWSR (O DescriptionKOsSincethe DECwindowssupportrequires additional processingPObeyondthatusedforwatchingnormal terminals,itisbyde-GO$faultturnedoff.'YoushouldonlySET DECWINDOWSwhenFO|youwillberunningWATCHERona DECwindowsworksta-NOtion(orasystemwith DECwindows terminals).'YouwillalsoLO-needtoincludeaWATCHruleforWSAterminaldevicesto9Owatch DECwindowssessions(as describedinSection2.4).*I|?=(')BOSET EVENT_LOG*mCCO EstablisheshownormalWATCHEReventsare recorded.OFormatOs SET [NO]EVENT_LOGOCommand QualifiersDefaultsO:/FILE=file-specO|/OPERATOR=oper-list+O Description@OsThiscommand specifieshownormalWATCHEReventsLO (startup, shutdown,reset,andlogoutevents)are recorded.FO$Bydefault,WATCHEReventsareloggedtotheCENTRALO|operatorclass.iO QualifiersOs/FILE=file-specI/Ocountsbetweenpasses&mustexceedthe specified( thresholdforaprocessto!Hbe consideredactive.O TERMINAL_IO[: threshold(]TerminalI/O(theopera-( tioncountontheterminal's device)shouldbeusedas a criterion.)If threshold  is)$  specified,the differencein&| I/Ocountsbetweenpasses& mustexceedthe specified(-  thresholdforaprocessto! be consideredactive.\2AOAny combinationof PROCESS_IO,CPU,and TERMINAL_*OIOis permitted.)Ifomitted,4 threshold$valuesdefaulttozero.PO5Notethat thresholdvaluesshouldbechosenasafunctionof@Othewakeupinterval(definedwithSET INTERVAL)."O/[NO]WARNING[=deltatime]SO(Setsthedefaultsfor warnings,tobeusedifnot specifiedon&O subsequentWATCH commands..-/8OSHOW*mCCODisplaysallorpartofthecurrentconfiguration.OFormatO SHOW 8  > y> > Y> > 1< > > > > a> : ACTION  ALLg BELL DAYS DEBUGp DEFAULTS EVENT_LOG" EXCLUDEz FILE GLOBALS+ INSWAP INTERVAL MULTIWARN5 OVERRIDE WATCH 9  > y> > Y> > 1= > > > > a> ;OECommand QualifiersEDefaultsO /[NO]COMMAND /NOCOMMANDO/OUTPUT=file-spec/OUTPUT=SYS$OUTPUT: O DescriptionHOsTheSHOWcommanddisplays informationaboutthecurrent:O configurationandtheWCPdefault settings.! O QualifiersOs /[NO]COMMANDIOThe/COMMAND qualifier indicatesthatthedisplayshouldHO$be formattedasthecommandsthatwouldbeenteredtoDO|createthe specifiedrecords.-Use/COMMANDwiththeKO/OUTPUT qualifiertocreateanMCPcommandfilethatcanQO-bealteredwithyourfavoriteeditor,thenreadbackintoMCP,Otocreateanewconfiguration.! O/OUTPUT=file-specNO(The/OUTPUT qualifierisusedtodirecttheSHOWresulttoXOafileorotherdevice.'Bydefault,theresultis displayedonthe/Ocurrentoutputdevice, SYS$OUTPUT.a/.0<OSHUTDOWN*kAAOSendsashutdowncommandtotheWATCHERprocess.L"OFormatOs SHUTDOWN*! O Description=OsThis command sends a shutdowncommand totheCOWATCHERprocess,whichcausesWATCHERtocloseits O$logfilesandexit.KOOPERandSYSPRV privilegesarerequiredforthiscommand.0/9OWATCH*L""ODefinesawatchrule.[OFormatOs WATCHN device-patOCommand QualifiersDefaultsO:/ACCPORNAM=port-pat: /ACCPORNAM= D*O|/DELETE%O/[NO]DISCONNECT[=deltatime]%O/[NO]FORCE_EXIT[=deltatime]!OD/[NO]LOGOUT[=deltatime]&O/MEASURE=(measurement[,...])"O/[NO]WARNING[=deltatime]=O ParametersOs device-patLOAterminaldevicenameorpattern containing wildcards,to6O$identifythe terminal(s)tobewatched.`O DescriptionGOsThiscommandisusedtoaddorremove(with/DELETE)@OawatchruletotheWATCHERconfiguration./WhenGO$WATCHERisrunning,aprocessrunningonanyterminalQO|matchingthe specifiedcriteriawillbewatchedfor inactivity,,Ousingthe specified parameters.< O QualifiersOs/ACCPORNAM=port-patKOPortnameorpattern containing wildcards, identifyingthePO$terminalport(s)(forterminalserversandotherdevicesusingFO|portnames)tobewatched.'Thedefaultisanyport.O/DELETEMO( Specifiesthattheruleshouldbedeletedfromtheconfig-OOuration.+AllcriteriamustmatchexactlyfortheruletobeOdeleted.u oK%O/[NO]DISCONNECT[=deltatime]KO(Forsystemswithvirtual terminalsenabled,this qualifierKO specifieswhethertheterminalshouldbe disconnectedfromQOthesystem,andifso,howlongtheterminalshouldbeinac-PO2tivebeforethe disconnectionoccurs.)Ifvirtual terminalsareSOnotenabled,ortheterminaltobeforcedoffisnot connectedMOthroughavirtual terminal,theprocessisloggedout(theRO<sameeffectasforthe/LOGOUT qualifier).'Ifboththisquali-LOfierand/LOGOUTareomitted,thedisconnect/logoutdefaultEOistakenfromthecurrentSET WATCH_DEFAULTsetting.?OThe /DISCONNECT, /FORCE_EXIT,and/LOGOUTquali-*Ofiersaremutually exclusive. b_UeNote b_>Theterminal-disconnectioncodeusedbyWATCHERFCrunsinkernelmode,atelevatedIPL,andhencemayCresultinasystemcrashiftheVMSterminalUCBE extensionsorterminalclassdriverchanges.)AswithCLallcodethatuses undocumentedVMS internals,ex-=ercisecautionwhenusing /DISCONNECTfortheGfirsttimeandwhenyouupgradetoanewversionofVVMS.nAWThe disconnectcodeistheonlypartofWATCHER#thatuseskernelmode.  %O/[NO]FORCE_EXIT[=deltatime]MO( Specifiesthatany user-modeimage currentlyrunningattheROterminalshouldbeforcedtoexit,withoutactuallyloggingtheOuseroff.i?OThe /DISCONNECT, /FORCE_EXIT,and/LOGOUTquali-*Ofiersaremutually exclusive.q!O/[NO]LOGOUT[=deltatime]NO( Specifieswhethertheterminalshouldbeloggedout,andifMOso,howlongtheterminalshouldbeinactivebeforelogoutGOoccurs.,Ifthis qualifierand /DISCONNECTareomitted,MO2thelogout/disconnectdefaultistakenfromthecurrentSET!O WATCH_DEFAULTsetting.i?OThe /DISCONNECT, /FORCE_EXIT,and/LOGOUTquali-*Ofiersaremutually exclusive.&O/MEASURE=(measurement[,...])HO( Specifiesthe measurementsthatshouldbeusedforac-%Otivitydetermination.+For measurement",specifyoneoftheO following:~ TOCPU[:* threshold z]"CPUtime(thesumof";theCPUtimeusedby%theprocessandallits& subprocesses,in centisec-(Eonds)shouldbeusedasa criterion.*If threshold His) specified,the differencein$OCPUtimebetweenpasses&mustexceedthe specified( thresholdforaprocessto!Xbe consideredactive.O PROCESS_IO[:o threshold ]%ProcessI/O(thesumof$+thebufferedanddirect(I/Ocountsfortheprocess&andallits subprocesses)'4shouldbeusedasacri-terion.-If threshold is) specified,the differencein&>I/Ocountsbetweenpasses&mustexceedthe specified( thresholdforaprocessto!Hbe consideredactive.O TERMINAL_IO[: threshold(]TerminalI/O(theopera-( tioncountontheterminal's device)shouldbeusedas a criterion.)If threshold  is)$  specified,the differencein&| I/Ocountsbetweenpasses& mustexceedthe specified(-  thresholdforaprocessto! be consideredactive.AOAny combinationof PROCESS_IO,CPU,and TERMINAL_*OIOis permitted.)Ifomitted,4 threshold$valuesdefaulttozero.LO5Notethat thresholdvaluesshouldbechosenasafunctionHOofthewakeupinterval(definedwithSET INTERVAL).IfDOno /MEASUREMENT qualifieris specified,themeasure-CO>mentsettingsaretakenfromtheSET WATCH_DEFAULTO settings. "O/[NO]WARNING[=deltatime]KO( Specifieswhethertheterminalshouldbewarnedaboutin-QO activity,andifso,howlongtheterminalshouldbeinactiveNObeforewarningissent.)ThewarningintervalshouldbelessSO2thanthelogout interval.'Ifomitted,thedefaultistakenfrom4OthecurrentSET WATCH_DEFAULTsetting.   !!!!!"""""#####$$$$$%%%%%&&&&&&'''''((((((()))))*****++++++,,,,,------------......./////000000000000000000PrefacePrefacePrefacePrefacePrefaceIntended AudienceDocument StructureSupport for WATCHERSupport for WATCHERSupport for WATCHERSupport for WATCHERSupport for WATCHERSupport for WATCHERSupport for WATCHER1. Installing WATCHER1. Installing WATCHER1. Installing WATCHER1. Installing WATCHER!1.1 Required Logical Names!1.1 Required Logical Names!1.1 Required Logical Names*1.1.1 Logical Name for Help Library1.2 Privileges Required1.2 Privileges Required1.2 Privileges Required1.3 Other Requirements1.3 Other Requirements1.3 Other Requirements2. Configuring WATCHER2. Configuring WATCHER2. Configuring WATCHER!2.1 Setting up WATCH Rules!2.1 Setting up WATCH Rules"2.1.1 Identifying Terminals"2.1.1 Identifying Terminals"2.1.1 Identifying Terminals2.1.2 WATCH Criteria2.1.2 WATCH Criteria2.1.2 WATCH Criteria2.1.2 WATCH Criteria2.1.2 WATCH Criteria2.1.3 Terminal Groupings2.1.3 Terminal Groupings#2.2 Exclusions and Overrides#2.2 Exclusions and Overrides 2.3 Saving Configurations 2.3 Saving Configurations$2.3.1 VAXcluster Environments#2.3.2 Editing Configurations#2.3.2 Editing Configurations#2.3.2 Editing Configurations2.4 DECwindows Support2.4 DECwindows Support2.4 DECwindows Support2.4 DECwindows Support2.4 DECwindows Support2.4 DECwindows Support2.4 DECwindows Support!3. Troubleshooting WATCHER!3. Troubleshooting WATCHER!3. Troubleshooting WATCHER!3. Troubleshooting WATCHER!3. Troubleshooting WATCHER3.1 Forcing Wakeups3.1 Forcing Wakeups#Part II Command Descriptions WCP WCP WCP WCP WCP WCP WCP WCP!@ (Redirect Command Input)!@ (Redirect Command Input)!@ (Redirect Command Input)!@ (Redirect Command Input)!@ (Redirect Command Input)!@ (Redirect Command Input)EXCLUDEEXCLUDEEXCLUDEEXCLUDEEXCLUDEEXCLUDEEXCLUDEEXCLUDEEXCLUDEEXCLUDEEXCLUDEEXCLUDEEXCLUDEEXCLUDEEXCLUDEEXCLUDE EXIT EXIT EXIT EXIT EXIT HELP HELP HELP HELP HELP HELPOVERRIDEOVERRIDEOVERRIDEOVERRIDEOVERRIDEOVERRIDEOVERRIDEOVERRIDEOVERRIDEOVERRIDEOVERRIDEOVERRIDEOVERRIDEOVERRIDEOVERRIDEOVERRIDEOVERRIDEOVERRIDEOVERRIDEOVERRIDEOVERRIDEOVERRIDEOVERRIDE QUIT QUIT QUIT QUIT QUIT RESET RESET RESET RESET RESET SAVE SAVE SAVE SAVE SAVESET ACTIONSET ACTIONSET ACTIONSET ACTIONSET ACTIONSET BELLSET BELLSET BELLSET BELLSET BELLSET DAYSSET DAYSSET DAYSSET DAYSSET DAYSSET DEBUGSET DEBUGSET DEBUGSET DEBUGSET DEBUGSET DEBUGSET DECWINDOWSSET DECWINDOWSSET DECWINDOWSSET DECWINDOWSSET DECWINDOWSSET EVENT_LOGSET EVENT_LOGSET EVENT_LOGSET EVENT_LOGSET EVENT_LOGSET EVENT_LOGSET EVENT_LOGSET INSWAPSET INSWAPSET INSWAPSET INSWAPSET INSWAPSET INTERVALSET INTERVALSET INTERVALSET INTERVALSET INTERVALSET MULTIWARNSET MULTIWARNSET MULTIWARNSET MULTIWARNSET MULTIWARNSET MULTIWARNSET VERIFYSET VERIFYSET VERIFYSET VERIFYSET VERIFYSET WATCH_DEFAULTSET WATCH_DEFAULTSET WATCH_DEFAULTSET WATCH_DEFAULTSET WATCH_DEFAULTSET WATCH_DEFAULTSET WATCH_DEFAULTSET WATCH_DEFAULTSET WATCH_DEFAULTSET WATCH_DEFAULTSET WATCH_DEFAULTSET WATCH_DEFAULT SHOW SHOW SHOW SHOW SHOW SHOW SHOWSHUTDOWNSHUTDOWNSHUTDOWNSHUTDOWNSHUTDOWN WATCH WATCH WATCH WATCH WATCH WATCH WATCH WATCH WATCH WATCH WATCH WATCH WATCH WATCH WATCH WATCH WATCH WATCH  watcher_doc_2watcher_doc_3watcher_doc_4watcher_doc_5watcher_doc_6watcher_doc_7watcher_doc_8 watcher_doc_9#watcher_doc_10&watcher_doc_11)watcher_doc_12+watcher_doc_13.watcher_doc_143watcher_doc_155watcher_doc_167watcher_doc_179watcher_doc_18:watcher_doc_19= dwsesDwatcher_doc_20Iwatcher_doc_21Lwatcher_doc_22Twatcher_doc_23Zwatcher_doc_24jwatcher_doc_25owatcher_doc_26uwatcher_doc_27watcher_doc_28watcher_doc_29watcher_doc_30command_set_actionwatcher_doc_31watcher_doc_32watcher_doc_33watcher_doc_34watcher_doc_35command_set_inswapwatcher_doc_36watcher_doc_37watcher_doc_38watcher_doc_39watcher_doc_40watcher_doc_41watcher_doc_42 B-ADOBE-Helvetica-Medium-R-Normal--*-120-*-*-P-*-ISO8859-1@-ADOBE-Helvetica-Bold-R-Normal--*-180-*-*-P-*-ISO8859-1@-ADOBE-Helvetica-Bold-R-Normal--*-120-*-*-P-*-ISO8859-1@-ADOBE-Helvetica-Bold-R-Normal--*-100-*-*-P-*-ISO8859-1B-ADOBE-Helvetica-Medium-R-Normal--*-100-*-*-P-*-ISO8859-1@-ADOBE-Helvetica-Bold-R-Normal--*-140-*-*-P-*-ISO8859-1O-ADOBE-New Century Schoolbook-Medium-R-Normal--*-140-*-*-P-*-ISO8859-1/-ADOBE-Symbol-*-R-*--*-140-*-*-P-*-*-*M-ADOBE-New Century Schoolbook-Bold-R-Normal--*-140-*-*-P-*-ISO8859-1O -ADOBE-New Century Schoolbook-Medium-I-Normal--*-140-*-*-P-*-ISO8859-1O -ADOBE-New Century Schoolbook-Medium-R-Normal--*-120-*-*-P-*-ISO8859-1@ -ADOBE-Courier-Medium-R-Normal--*-120-*-*-M-*-ISO8859-1> -ADOBE-Courier-Bold-R-Normal--*-120-*-*-M-*-ISO8859-1B -ADOBE-Helvetica-Medium-R-Normal--*-140-*-*-P-*-ISO8859-1O-ADOBE-Interim DM-Medium-I-Normal--*-140-*-*-P-*-DEC-DECMATH_EXTENSION (   ` MF\J1 ("#L%.1' 63= B +D:mD7GGJ.UH.VxVW'k^lJm npr<sAv4xz}~4&:a@