                                       /           Guide to Installing and Using WATCHER                  June, 1994      @           This manual describes the installation, configuration,@           and operation of WATCHER, an idle terminal monitor for           VMS systems.        A           Revision/Update Information:  This is a revised manual.   >           Operating System and Version: VAX/VMS V5.0 or later,A                                         OpenVMS AXP V1.0 or later   4           Software Version:             WATCHER V2.9                 Matthew D. Madison           MadGoat Software                                                         "           ________________________           24 June 1994  =           Permission is granted to copy and redistribute this *           document for no commercial gain.  ?           The information in this document is subject to change 9           without notice and should not be construed as a 9           commitment by the author. The author assumes no ?           responsibility for any errors that may appear in this            document.   <           DISCLAIMER: The author, the author's employer, and@           MadGoat Software make no representations or warranties>           with respect to the contents hereof and specifically?           disclaim any implied warranties of merchantability or -           fitness for any particular purpose.   ;           The following are trademarks of Digital Equipment            Corporation:             __________<           Copyright 1993, 1994 MadGoat Software. All rights           reserved.                        A           _______________________________________________________              Contents  A                 _________________________________________________ A                 PREFACE                                         v   A           _______________________________________________________ A           CHAPTER 1  INSTALLING WATCHER                       1-1   A                 _________________________________________________ A                 1.1   REQUIRED LOGICAL NAMES                  1-2   A                 1.1.1     Logical Name for Help Library  _    1-2   A                 _________________________________________________ A                 1.2   PRIVILEGES REQUIRED                     1-2   A                 _________________________________________________ A                 1.3   OTHER REQUIREMENTS                      1-3     A           _______________________________________________________ A           CHAPTER 2  CONFIGURING WATCHER                      2-1   A                 _________________________________________________ A                 2.1   SETTING UP WATCH RULES                  2-1   A                 2.1.1     Identifying Terminals  _________    2-2   A                 2.1.2     WATCH Criteria  ________________    2-2   A                 2.1.3     Terminal Groupings  ____________    2-3   A                 _________________________________________________ A                 2.2   EXCLUSIONS AND OVERRIDES                2-4   A                 _________________________________________________ A                 2.3   SAVING CONFIGURATIONS                   2-4   A                 2.3.1     VAXcluster Environments  _______    2-5   A                 2.3.2     Editing Configurations  ________    2-5   A                                                               iii                     Contents          A                 _________________________________________________ A                 2.4   DECWINDOWS SUPPORT                      2-6     A           _______________________________________________________ A           CHAPTER 3  TROUBLESHOOTING WATCHER                  3-1   A                 _________________________________________________ A                 3.1   FORCING WAKEUPS                         3-2     A           _______________________________________________________   '           PART II  COMMAND DESCRIPTIONS :                 WCP                                  CMD-3:                 @ (REDIRECT COMMAND INPUT)           CMD-5:                 EXCLUDE                              CMD-6:                 EXIT                                 CMD-9:                 HELP                                CMD-10:                 OVERRIDE                            CMD-11:                 QUIT                                CMD-17:                 RESET                               CMD-18:                 SAVE                                CMD-19:                 SET ACTION                          CMD-20:                 SET BELL                            CMD-21:                 SET DAYS                            CMD-22:                 SET DEBUG                           CMD-23:                 SET DECWINDOWS                      CMD-24:                 SET EVENT_LOG                       CMD-25:                 SET INSWAP                          CMD-26:                 SET INTERVAL                        CMD-27:                 SET MULTIWARN                       CMD-28:                 SET VERIFY                          CMD-29:                 SET WATCH_DEFAULT                   CMD-30:                 SHOW                                CMD-33:                 SHUTDOWN                            CMD-35:                 WATCH                               CMD-36                 iv                   A           _______________________________________________________              Preface   <           One of the first programs a new VMS system manager<           usually needs is an "idle terminal monitor" (ITM).=           That is, a program to monitor terminal activity and @           logout those users whose terminals remain inactive for>           an extended period of time. An ITM helps ensure that>           system resources are not wasted and helps reduce the@           possibility of intruders using unattended terminals as+           a means of entry into the system.   ;           Unfortunately, an ITM can also be an annoyance to =           system users. A simple ITM can victimize legitimate ?           users who may need to remain logged in but idle while 9           they are at work. This can lead to clever users :           devising "hacks" to evade the ITM, defeating the6           purpose of using the ITM in the first place.  <           WATCHER has a high degree of flexibility, allowing=           system managers to decide how to accommodate users' ?           needs while still addressing operational and security >           issues. WATCHER is fully configurable, providing the           following features:   ?           o  You can tell WATCHER which terminals to watch, and A              on a per-terminal basis, what measurements (CPU use, =              process I/O count, terminal I/O count) to use as >              criteria for determining idleness, and how long a>              terminal should be idle before the user should be              forced off.  ?           o  Users can be excluded from interference by WATCHER >              based on any combination of username, UIC, a held@              identifier, privileges, terminal device and/or port=              name, time-of-day/day-of-week, and name of image               being run.       A                                                                 v                     Preface           A           o  You can override or modify the watch criteria and/or =              idle times for any user based on any combination =              of username, UIC, a held identifier, privileges, ?              terminal device and/or port name, time-of-day/day- 2              of-week, and name of image being run.  ?           Through the use of these features, the system manager <           should be able to configure WATCHER to handle most8           types of terminals and accommodate most users.  L           __________________________________________________________________             Intended Audience   8           This manual is intended for the system manager8           or other person responsible for installing and           configuring WATCHER.  L           __________________________________________________________________             Document Structure  8           This document consists of two parts. The first<           describes the installation and use of WATCHER. The=           second describes all of the WATCHER Control Program #           (WCP) commands in detail.   L           __________________________________________________________________             Support for WATCHER   =           There is no formal support for WATCHER. If you have 9           Internet connectivity, however, you may wish to ;           subscribe to one or more of the following MadGoat !           Software mailing lists:   (              Info-MadGoat@wkuvx1.wku.edu  =              Discussion of MadGoat Software products by users A              and MadGoat developers. To subscribe, send a message <              to Info-MadGoat-Request@wkuvx1.wku.edu with the@              word SUBSCRIBE in the first line of the body of the              message. ,              MadGoat-Announce@wkuvx1.wku.edu             vi         A                                                           Preface           ;              Announcements of new releases and new products :              from MadGoat. To subscribe, send a message to=              MadGoat-Announce-Request@wkuvx1.wku.edu with the @              word SUBSCRIBE in the first line of the body of the              message. (              MadGoat-Bugs@wkuvx1.wku.edu  ;              Address for reporting bugs in MadGoat Software =              products. Please include the name of the package >              and version in the subject header of the message,=              so the report can be more easily directed to the #              appropriate developer.   =           If you cannot send electronic mail, you can contact 9           the author by post, facsimile, or telephone at:   $                      Matthew Madison  &                      TGV, Incorporated  &                      101 Cooper Street  -                      Santa Cruz, CA 95060 USA   $           Fax:       +1 408 457 5208  $           Phone:     +1 408 457 5390                          A                                                               vii                      A           _______________________________________________________       1      Installing WATCHER      7           To use WATCHER, you need the following files:   8           WATCHER.EXE             The main WATCHER image  =           WCP.EXE                 The WATCHER Control Program   6           WCP_HELPLIB.HLB         Help library for WCP  <           DECW_STARTLOGIN.COM     Part of DECwindows support  ?           WATCHER_CONFIG.WCFG     You create this file with WCP   8           WATCHER_STARTUP.COM     Sample startup command+                                   procedure   9           WATCHER_SHUTDOWN.COM    Sample shutdown command +                                   procedure   ?           SAMPLE_CONFIG.WCP       Sample configuration commands   :           The package comes with the object code files and<           libraries and a command procedure called LINK.COM,&           for creating the two images.  ?           It is easiest to simply place all of the files in the ?           distribution in one directory, run LINK.COM to create ;           the images, then edit WATCHER_STARTUP.COM and the <           sample configuration commands in SAMPLE_CONFIG.WCP?           as needed for your system. Then all you need to do is >           to run WCP, execute the WCP command file you created;           from the sample, which in turn creates a WATCHER_ ?           CONFIG.WCFG file, then execute WATCHER_STARTUP.COM to $           start the Watcher process.  A                                                               1-1                     Installing WATCHER        L           __________________________________________________________________       1.1    Required Logical Names  >           The three system-wide logical names WATCHER requires           are:  =           WATCHER_DIR             Should point to location of ?                                   images and command procedures   ?           WATCHER_CONFIG          Configuration file to be used   >           WATCHER_TRACE           Trace file; use NL: if debug*                                   disabled  7           They should all be defined in executive mode.   %           ___________________________   '    1.1.1  Logical Name for Help Library   =           The help library for WCP may be placed in SYS$HELP, >           or, if you define the logical name WCP_HELPLIB to be>           the full path name of the file, anywhere else on the=           system. The sample WATCHER_STARTUP.COM includes the 6           necessary DEFINE command to do this for you.  L           __________________________________________________________________      1.2    Privileges Required   :           The account that is used for the WATCHER process,           requires the following privileges:  <           CMKRNL         Required for DECwindows support and$                          disconnects  9           PRMMBX         For defining the command mailbox   1           PSWAPM         Required for disconnects   >           SHARE          For sending warning messages to other)                          users' terminals   9           SYSNAM         For defining the command mailbox   7           SYSPRV         (optional) to ensure access to *                          appropriate files  
           1-2          A                                                Installing WATCHER             :           WORLD          For getting information about and*                          killing processes  <           SYSPRV is not needed if you make sure that WATCHER;           has enough access to read its configuration files <           and the system rightslist (if using identifiers as>           an exclusion criterion on pre-VMS V5.4 systems), and>           write its log and trace files (if used). Both CMKRNL@           and SYSPRV are required for DECwindows support. CMKRNL=           and PSWAPM are required to perform virtual terminal            disconnections.   L           __________________________________________________________________      1.3    Other Requirements  ?           The RUN command in WATCHER_STARTUP.COM should provide ?           the WATCHER process with sufficient quotas to operate ;           on most systems. CPU and memory requirements will >           vary depending on the number of rules in the WATCHER>           configuration, peak number of interactive users, and=           peak number of watched users. You may wish to refer =           to the following table in computing expected memory 2           resources needed by the WATCHER process:  8           Memory required per WATCH rule       206 bytes  8           Memory required per EXCLUDE or       507 bytes           OVERRIDE rule   8           Memory required per interactive      465 bytes           process   8           Memory required per watched          531 bytes           process   8           Size of WATCHER code (approximate)   18K bytes  <           On pre-VMS V5.4 systems, allow a small increase in>           CPU, memory, and I/O requirements if identifiers are<           used as an exclusion mechanism, since WATCHER will<           require access to the rightslist database for each?           interactive process. DECwindows support also requires @           additional overhead for access to the job logical name  A                                                               1-3                     Installing WATCHER          =           tables of all interactive and detached processes on            the system.                                                                             
           1-4                      A           _______________________________________________________       2      Configuring WATCHER       =           The WATCHER Control Program (WCP) is used to create @           WATCHER configurations. WCP is designed to be executed9           as a VMS foreign command. To set up the foreignn$           command, define the symbol  5                            $ WCP :== $WATCHER_DIR:WCPa  @           Once the symbol is set up, you can invoke WCP with the           command:                               $ WCP  :           WCP will automatically load the contents of your4           defined WATCHER_CONFIG file, if it exists.  L           __________________________________________________________________       2.1    Setting up WATCH Rules  >           The WATCH command sets up rules that determine which=           terminals get watched, how to determine whether the >           terminals are active, and how long terminals must be@           inactive before a user can be forced off. For example:  N                            WCP> WATCH *$RT*/MEASURE=PROCESS_IO/LOGOUT=00:15:00  =           This command sets up a rule for watching all DECnete;           remote logins, using changes in total process I/Oh?           (buffered plus direct) to determine process activity,y:           and causing logouts to occur after 15 minutes of           inactivity.   @           Note: You must have at least one WATCH command in your           configuration.  A                                                               2-1y                    Configuring WATCHER         %           ___________________________n      2.1.1  Identifying Terminals   @           WATCH commands take any wildcard pattern. All terminal;           device names that match the specified pattern are9;           watched. The device names used by WATCHER are the ;           physical device names of terminals; if the system_<           is part of a VAXcluster, SCS node name is prefixed=           to the device name, as is normally done by VMS with %           cluster-accessible devices.   7           If the terminal device driver supports remote_;           port identification, as does the LTDRIVER for LATA<           terminals, the remote port information can also be;           used as a match criterion by using the /ACCPORNAM 8           qualifier. The port name can be specified as a(           wildcard pattern. For example:  @                            WCP> WATCH *$LT*/ACCPORNAM="TRMSRV/*"  <           This command would cause the terminals attached to/           terminal server TRMSRV to be watched._  %           ___________________________       2.1.2  WATCH Criteria  >           WATCHER gives you the choice of using one or more of<           the following measurements as criteria for judging/           whether a terminal or user is active:-  ;           TERMINAL_IO        the I/O operation count on the_,                              terminal device  ;           CPU                The total CPU time used by then8                              process owning the terminal=                              plus all of its subprocesses, in )                              centiseconds_  ?           PROCESS_IO         the sum of the buffered and direct_=                              I/O counts of the process owning 9                              the terminal plus all of its_)                              subprocesses   
           2-2I A  N    A                                               Configuring WATCHERn          @           The TERMINAL_IO measurement is useful for conventional@           terminals but cannot be used for workstations (running8           either VWS or DECwindows) due to the nature of=           workstation activity. PROCESS_IO is recommended for_.           use on workstation terminal devices.  9           For any of these measurements you can specify a_:           minimum threshold value. When WATCHER performs a8           comparison, the difference between the current<           measured value and the last measured value must be?           greater than the specified threshold to be counted as @           activity. The default threshold value is zero, so that3           any difference at all counts as activity.   :           Several samples of WATCH commands with different?           criteria and threshold values are provided in SAMPLE_            CONFIG.WCP.   %           ___________________________X      2.1.3  Terminal Groupings  9           You can group WATCH rules together by using the :           /GROUP qualifier. When WATCHER applies its rules<           for determining terminal activity, activity on one>           terminal in the group counts as activity for all the?           terminals in the group. The main use for this feature ;           is with multi-windowed terminals and workstations =           running VWS (DECwindows workstations are handled in @           this manner automatically). For example, the following>           rules handle all the workstation terminal types on a%           standalone VWS workstation:   T                            WCP> WATCH WTA*/GROUP=VWS   ! normal VT200-series windowsS                            WCP> WATCH TKA*/GROUP=VWS   ! Tek 4010 emulation windowsMS                            WCP> WATCH TJA*/GROUP=VWS   ! Tek 4125 emulation windows   <           The user can then create any number of any type of@           terminal window, and as long as one of them is active,)           they will all remain logged in.   A                                                               2-3                     Configuring WATCHER         L           __________________________________________________________________  "    2.2    Exclusions and Overrides  <           WATCHER's behaviour towards a terminal or user can=           be modified through the definition of exclusion and ?           override rules. Exclusions and overrides can be based =           on any combination of username, terminal/port name, >           UIC, image being run, privileges, a held identifier,?           and time of day. Exclusion rules prevent WATCHER from @           taking any action towards a user, while override rules>           merely modify how the terminal is watched (i.e., the@           activity criteria and inactivity periods). For example+           (taken from a VAXcluster system):   ?                            WCP> EXCLUDE SYSTEM/TERMINAL=*$OPA0: Z                            WCP> OVERRIDE JONES/TERMINAL=NODE1$TXA3:/DURING=(PRIMARY:8-16)-;                            _WCP>           /LOGOUT=02:00:00   <           The first command prevents WATCHER from taking any>           action against the SYSTEM account while it is logged=           into the system console. The second command extendsl<           the logout inactivity period to two hours for user=           JONES weekdays from 8 am to 4:59 pm, while JONES is =           logged into the terminal in her office, which is on $           port TXA3 on system NODE1.  L           __________________________________________________________________      2.3    Saving Configurationsm  ?           Once you have established the rules you need for youre<           configuration, you should create the configuration%           file with the SAVE command:f  3                            WCP> SAVE WATCHER_CONFIGo  ;           If WATCHER is currently running, you can have the,<           new configuration take effect immediately with the@           RESET command, which will cause the WATCHER process to=           reload its configuration information from the file.   
           2-4     r    A                                               Configuring WATCHERt        %           ___________________________s  !    2.3.1  VAXcluster Environments   9           For mainly homogeneous VAXcluster environments, :           you should be able to use one configuration file<           for all nodes in the cluster. If you have a mix of=           nodes, however, it may be easier to create multiple ;           configuration files and define the WATCHER_CONFIG ;           logical name differently depending on the system.   %           ____________________________       2.3.2  Editing Configurations  <           The WATCH, EXCLUDE, and OVERRIDE commands all have9           a /DELETE to allow you to remove rules from theo?           database, and you can add rules as well. However, you_=           cannot control the order of the new rules (order is >           important because WATCHER searches the rule lists in@           the order you enter them until one matches). To assist=           in making complex changes to the configuration, theA?           SHOW command has a /COMMAND qualifier that causes the ?           configuration information to be displayed as commands_5           you would enter to build the configuration:   B                            WCP> SHOW/COMMAND/OUTPUT=CONFIG.WCP ALL  =           Once you dump the commands to the command file, youo>           can edit the command file as needed and create a new*           configuration with the commands:  '                            $ WCP/NOFILEd'                            WCP> @CONFIG 3                            WCP> SAVE WATCHER_CONFIGs  @           Instead of editing the configuration, it may be easier@           just to maintain a WCP command file with the necessary@           commands in it and build a new configuration each time$           you need to make a change.  A                                                               2-5                     Configuring WATCHERs        L           __________________________________________________________________      2.4    DECwindows Support  >           The VMS DECwindows implementation makes it difficult:           for a WATCHER-type program to properly identify,@           warn, and logout DECwindows sessions. However, WATCHER>           does provide limited support for watching DECwindows8           sessions, enabled with the following commands:  .                            WCP> SET DECWINDOWSH                            WCP> WATCH *WSA*/MEASURE=PROCESS_IO/NOWARNING  ?           Note that you cannot use TERMINAL_IO as a measurementa<           when watching DECwindows sessions, nor can WATCHER4           give warnings to idle DECwindows sessions.  =           WATCHER identifies DECwindows sessions by searchingC9           the job logical name table for each interactiveS<           process for the logical name DECW$DISPLAY, defined>           in executive mode. Each interactive job related to a@           single DECwindows session will have the same value for@           DECW$DISPLAY. WATCHER immediately changes the terminal>           device name it uses to the WSA device name (even for?           DECterm sessions) and also sets the group name to theX>           WSA device name. In this way, activity in any of the=           DECwindows jobs will be counted as activity for all.'           jobs related to that session.   >           The DECwindows window manager and DECterm controller?           processes are detached processes that are also needed =           by WATCHER (when forcing off a DECwindows session). ;           To identify these processes, WATCHER searches forN>           detached processes with DECW$DISPLAY defined in user@           mode. WATCHER tracks these processes, but does not use>           them in activity determination (it calls them "fake")           processes in debug/trace logs).o  <           When WATCHER identifies a DECwindows session to be;           forced off, it looks for all processes (includinge=           the detached processes, which are important) with aN<           matching WSA device name and forces them off. This;           should destroy all the windows on the workstationS>           and return it to a blank, background screen. It then  
           2-6          A                                               Configuring WATCHERm          <           creates a detached process that executes the DECW_@           STARTLOGIN command procedure (which must be located in?           WATCHER_DIR:), which, after waiting a few seconds for @           other activity to die down, restarts the login process%           on the affected WSA device._  9           WATCHER cannot be used to watch DECwindows jobsL<           that are started on remote systems, with the local>           workstation being used only as a display. There must?           be at least some jobs running on the workstation with ?           some activity to prevent WATCHER from logging out the            DECwindows session.u  ?           This technique should be effective for VMS DECwindowsb:           V2 (VMS V5.1 through V5.5) and V3 (also known as=           DECwindows/Motif V1.0), and should even work with X_;           terminals. It may not work with future DECwindowsi           implementations.                                            A                                                               2-7                      A           _______________________________________________________W  !    3      Troubleshooting WATCHER       ;           If WATCHER is not behaving as expected, there may_=           be a problem with your WATCHER configuration. There 9           is debug/trace code built into WATCHER to allowh;           you to monitor five categories of activities: thel=           mainline WATCHER code, the exclusion-checking code,w=           the override-checking code, measurement checks, and @           process information collection. Through the use of the?           SET DEBUG command, you can turn on tracing for any or ,           all of these debugging categories.  <           If WATCHER is already running, the best way to set?           up a test configuration is with the following command            sequence:   B                            $ SET PROCESS/PRIVILEGE=(SYSNAM,SYSPRV)                             $ WCP+                            WCP> SET DEBUG=nE,                            WCP> SET NOACTION<                            WCP> SAVE WATCHER_DIR:TEST_CONFIG$                            WCP> EXITV                            $ DEFINE/SYSTEM/EXEC WATCHER_CONFIG WATCHER_DIR:TEST_CONFIGN                            $ DEFINE/SYSTEM/EXEC WATCHER_TRACE  trace-file-spec&                            $ WCP RESET  9           The debug level n is described in the SET DEBUG :           command description, but usually will be 1 (just:           mainline) or 31 (full). You can direct the trace;           information to any file accessible to WATCHER, or !           to an unowned terminal._  <           The SET NOACTION command will prevent WATCHER from8           actually logging anyone out or sending warning            messages to terminals.  A                                                               3-1y m  C    !           Troubleshooting WATCHER           <           Subsequent WCP RESET commands will cause the trace=           file to be closed and a new version created, so youk?           can easily view past trace information. To go back toe>           "production" mode, just redefine WATCHER_CONFIG back<           to the name of the real configuration file, define>           WATCHER_TRACE to be NL:, and issue another WCP RESET           command.  L           __________________________________________________________________      3.1    Forcing Wakeupsc  >           To assist in debugging, you may want to have WATCHER9           wake up more often than normal. You can do thisx:           by setting a shorter wakeup interval in the test;           configuration, or you can force a wakeup to occure;           by writing to the WATCHER control mailbox. From aa?           suitably privileged account (SYSPRV), you can use thei           commands:   ;                            $ OPEN/WRITE WMBOX WATCHER_MBOX: +                            $ WRITE WMBOX "" (                            $ CLOSE WMBOX  ?           Each WRITE command will trigger a wakeup, and WATCHER 2           will go through its processing sequence.                            
           3-2                    A           _______________________________________________________   '           Part II  Command Descriptions          A                                              Command Descriptions A                                                               WCPr        A           _______________________________________________________s  
           WCPt    /           Executes the WATCHER Control Program.   A           _______________________________________________________              FORMAT             WCP  [command]  A           _______________________________________________________m)           Command Qualifiers     Defaults   1           /FILE=file-spec        See description.   A           _______________________________________________________              PARAMETERS           [command]_?           Any WCP command except the input redirection operator ?           (@). The specified command is executed and control is 1           returned to DCL immediately thereafter.   A           _______________________________________________________              DESCRIPTION @           WCP is intended to be used as a DCL "foreign" command.;           To use it as a foreign command, you must define a            symbol as follows:  5                            $ WCP :== $WATCHER_EXE:WCPi  ?           Defining the symbol in this way allows you to use thet@           /FILE qualifier and specify "one-shot" commands on the           command line.     A                                                             CMD-3T c  a               Command Descriptions
           WCP       A           _______________________________________________________              QUALIFIERS           /[NO]FILE=file-spec_<           Loads the specified WATCHER configuration file for;           editing. If not specified, the configuration file :           pointed to by the logical name WATCHER_CONFIG is;           loaded. The default file type is WCFG. If /NOFILE 8           is specified, no configuration file is loaded.                                                                           CMD-4e v       A                                              Command DescriptionsvB                                         @ (Redirect Command Input)        A           _______________________________________________________m  $           @ (Redirect Command Input)  1           Executes WCP commands read from a file.t  A           _______________________________________________________s             FORMAT             @  file-spec  A           _______________________________________________________              PARAMETERS           file-speca?           Name of the file containing WCP commands. If omitted, '           the default file type is WCP.   A           _______________________________________________________o             DESCRIPTION ;           Use this command to have WCP take further command =           input from the specified file. There is no built-inM=           limit on the number of levels of nesting of command ;           files, so be careful when using input redirectionT@           from within a command file. Commands read from command8           files are not displayed unless you SET VERIFY.  9           Command redirection can only be used at the WCPn:           command prompt, not as a "one-shot" WCP command.<           To have a file be used for input for an entire WCP>           session, use the following sequence of DCL commands.  <                            $ DEFINE/USER SYS$INPUT file-spec                             $ WCP        A                                                             CMD-5     h               Command Descriptions           EXCLUDE         A           _______________________________________________________i             EXCLUDEs  $           Defines an exclusion rule.  A           _______________________________________________________s             FORMAT             EXCLUDE  username-patm  A           _______________________________________________________e)           Command Qualifiers     Defaults   -           /ACCPORNAM=port-pat    /ACCPORNAM=*s           /DELETEl/           /DURING=daytim-list    (all the time)n*           /HOLDING=identifier    (ignored))           /IMAGE=fspec-pat       /IMAGE=*a*           /PRIVILEGES=priv-list  (ignored),           /TERMINAL=dev-pat      /TERMINAL=*+           /UIC=uic               /UIC=[*,*]t  A           _______________________________________________________              PARAMETERS           username-pat9           A VMS username or pattern containing wildcards, .           identifying the user to be excluded.  A           _______________________________________________________              DESCRIPTIONl>           This command is used to add or remove (with /DELETE)>           an exclusion rule to the WATCHER configuration. When:           WATCHER is running, any process that matches all;           of the specified criteria is not watched. Omittedd0           criteria are not used or always match.             CMD-6) o  x    A                                              Command DescriptionsaA                                                           EXCLUDE       A           _______________________________________________________              QUALIFIERS           /ACCPORNAM=port-pat!@           Port name or pattern containing wildcards, identifying;           the terminal port (for terminal servers and other =           devices using port names) on which the user must bee<           logged in to be excluded. The default is any port.             /DELETEn<           Specifies that the rule should be deleted from the@           configuration. All criteria must match exactly for the           rule to be deleted._             /DURING=daytim-list_=           Specifies a list of days and times during which the <           user is to be excluded from watching. The day/time(           specifications are of the form  1                            day:(hour-range[,...])s  <           where day is a day of the week or the word PRIMARY=           or SECONDARY, identifying the primary and secondaryr<           days set with SET DAYS, and hour-range is either a?           single hour number (0 through 23) or two hour numbersa<           separated by a hyphen. Multiple hour ranges may be           specified per day.             /HOLDING=identifier 7           Specifies that the user should be excluded ifo=           holding the specified identifier. The identifier isL?           converted to binary format before being stored in theR=           configuration, so you must create the configuration ?           file on the target system, or on a node with the same >           RIGHTSLIST database as the target system, to prevent.           misinterpretation of the identifier.  ?           If you are running VMS V5.4 or later, WATCHER obtains =           the identifiers held by the process directly (using ;           $GETJPI), and thus can check identifiers that are :           granted dynamically. Prior to V5.4, WATCHER uses:           the $FIND_HELD system service to scan the system?           rightslist for identifiers held by the user that owns   A                                                             CMD-7     e               Command Descriptions           EXCLUDEl        >           each process; dynamically granted identifiers cannot"           be checked in this case.  @           Note that if you do not use /HOLDING on any EXCLUDE or@           OVERRIDE command, the rights identifier information is@           not collected by WATCHER, resulting in some savings in;           processing time (especially on pre-V5.4 systems).h             /IMAGE=fspec-pat?           Specifies that the user should be excluded if runningn<           an executable image whose name (as returned by the@           JPI$_IMAGNAME item from $GETJPI) matches the specified<           wildcard pattern. For a job with subprocesses, the;           image name that WATCHER uses for matching againstc?           the wildcard pattern is the image currently being run =           by the master process in the job, or, if the mastere=           process is not running an image, an image being runp@           by one of the subprocesses (randomly selected if there.           are two or more such subuprocesses).             /PRIVILEGES=priv-listm=           Specifies that the user is to be excluded only whens;           holding the specified privilege or privileges. If.:           omitted, privileges are not used as a criterion.             /TERMINAL=dev-patm@           Specifies a terminal device name or pattern containing<           wildcards. The user must be logged into a matching"           terminal to be excluded.             /UIC=uic?           Specifies a UIC or UIC pattern. A process is excluded ;           only when owned by a matching UIC. You may use an =           asterisk for the member part of the UIC to have all :           UIC's in a group match. If omitted, any UIC will           match.                   CMD-8     m    A                                              Command DescriptionseA                                                              EXIT         A           _______________________________________________________              EXIT             Ends a WCP session.   A           _______________________________________________________              FORMAT             EXIT  A           _______________________________________________________u             DESCRIPTION =           Ends the current WCP session and returns control to ;           DCL. If you have modified the configuration, EXITf?           will ask for a file name for saving the configuration_           before exiting._                                          A                                                             CMD-9                     Command Descriptions           HELP        A           _______________________________________________________o             HELP  $           Displays help information.  A           _______________________________________________________              FORMAT             HELP  [topic...]  A           _______________________________________________________o             PARAMETERS           topice@           The name of a topic in the help library. If omitted, a&           list of topics is displayed.  A           _______________________________________________________o             DESCRIPTION 1           This command is pretty straightforward.                                              CMD-10 f  d    A                                              Command Descriptions A                                                          OVERRIDE         A           _______________________________________________________n             OVERRIDE  #           Defines an override rule.r  A           _______________________________________________________e             FORMAT              OVERRIDE  username-pat  A           _______________________________________________________l)           Command Qualifiers     Defaultsw  -           /ACCPORNAM=port-pat    /ACCPORNAM=*            /DELETE /           /DURING=daytim-list    (all the time) *           /HOLDING=identifier    (ignored))           /IMAGE=fspec-pat       /IMAGE=*c*           /PRIVILEGES=priv-list  (ignored),           /TERMINAL=dev-pat      /TERMINAL=*+           /UIC=uic               /UIC=[*,*]e%           /[NO]DISCONNECT[=deltatime]i%           /[NO]FORCE_EXIT[=deltatime] !           /[NO]LOGOUT[=deltatime]g&           /MEASURE=(measurement[,...])"           /[NO]WARNING[=deltatime]  A           _______________________________________________________              PARAMETERS           username-pat9           A VMS username or pattern containing wildcards,h@           identifying the user for which the override is to take           effect.         A                                                            CMD-11                     Command Descriptions           OVERRIDE      A           _______________________________________________________t             DESCRIPTIONL>           This command is used to add or remove (with /DELETE)=           an override rule to the WATCHER configuration. Whent=           WATCHER is running, any process that matches all of ?           the specified criteria will have the warning, logout,t?           and measurement information, if specified, taken froms6           the override rule instead of the WATCH rule.  A           _______________________________________________________              QUALIFIERS           /ACCPORNAM=port-pate@           Port name or pattern containing wildcards, identifying;           the terminal port (for terminal servers and otheri=           devices using port names) on which the user must be >           logged in to have the override apply. The default is           any port.l             /DELETEt<           Specifies that the rule should be deleted from the@           configuration. All criteria must match exactly for the           rule to be deleted.              /DURING=daytim-list =           Specifies a list of days and times during which the ?           override is to apply. The day/time specifications areo           of the form   1                            day:(hour-range[,...])c  <           where day is a day of the week or the word PRIMARY=           or SECONDARY, identifying the primary and secondaryc<           days set with SET DAYS, and hour-range is either a?           single hour number (0 through 23) or two hour numbersn<           separated by a hyphen. Multiple hour ranges may be           specified per day.             /HOLDING=identifiern:           Specifies that the override should apply only if;           the user is holding the specified identifier. Thea?           identifier is converted to binary format before being              CMD-12 u  e    A                                              Command Descriptions)A                                                          OVERRIDE         9           stored in the configuration, so you must create 9           the configuration file on the target system, or <           on a node with the same RIGHTSLIST database as the<           target system, to prevent misinterpretation of the           identifier.$  ?           If you are running VMS V5.4 or later, WATCHER obtains =           the identifiers held by the process directly (usingb;           $GETJPI), and thus can check identifiers that arel:           granted dynamically. Prior to V5.4, WATCHER uses:           the $FIND_HELD system service to scan the system?           rightslist for identifiers held by the user that owns >           each process; dynamically granted identifiers cannot"           be checked in this case.  @           Note that if you do not use /HOLDING on any EXCLUDE or@           OVERRIDE command, the rights identifier information is@           not collected by WATCHER, resulting in some savings in?           processing time (especially on pre-VMS V5.4 systems).              /IMAGE=fspec-pat>           Specifies that the override should apply only if the<           user is running an executable image whose name (as:           returned by the JPI$_IMAGNAME item from $GETJPI);           matches the specified wildcard pattern. For a jobh=           with subprocesses, the image name that WATCHER uses_@           for matching against the wildcard pattern is the image?           currently being run by the master process in the job, ?           or, if the master process is not running an image, ano>           image being run by one of the subprocesses (randomly@           selected if there are two or more such subuprocesses).             /PRIVILEGES=priv-list @           Specifies that the override should apply only when the@           user is holding the specified privilege or privileges.=           If omitted, privileges are not used as a criterion.              /TERMINAL=dev-pat @           Specifies a terminal device name or pattern containing<           wildcards. The user must be logged into a matching.           terminal to have the override apply.  A                                                            CMD-13_ _  _               Command Descriptions           OVERRIDE                   /UIC=uic>           Specifies a UIC or UIC pattern. The override applies<           only to processes owned by a matching UIC. You may@           use an asterisk for the member part of the UIC to have>           all UIC's in a group match. If omitted, any UIC will           match.  %           /[NO]DISCONNECT[=deltatime]_:           Specifies that the logout/disconnect information=           should be overridden, performing a virtual terminal_=           disconnection instead of deleting the user process.l6           The inactivity interval can be overridden by<           specifying a deltatime, or logouts/disconnects can=           be prevented altogether by specifying /NODISCONNECTc;           (although it is more efficient to use EXCLUDE fori           this).  %           /[NO]FORCE_EXIT[=deltatime]t:           Specifies that the logout/disconnect information>           should be overridden, performing a forced image exit:           instead of deleting the process or disconnecting<           the terminal. Only user-mode images are forced; if>           the user is at DCL command level, the forced exit is?           skipped. The inactivity interval can be overridden byX>           specifying a deltatime, or exits/logouts/disconnects=           can be prevented altogether by specifying /NOFORCE_m@           EXIT (although it is more efficient to use EXCLUDE for           this).  !           /[NO]LOGOUT[=deltatime] :           Specifies that the logout/disconnect information=           should be overridden, performing a process deletion :           instead of a virtual terminal disconnection. The=           inactivity interval can be overridden by specifying @           a deltatime, or logouts can be prevented by specifying9           /NOLOGOUT (although it is more efficient to use            EXCLUDE for this).                 CMD-14         A                                              Command Descriptions A                                                          OVERRIDE         &           /MEASURE=(measurement[,...])9           Specifies that the activity measurements should <           be overridden. For measurement, specify one of the           following:  >           CPU[:threshold]         CPU time (the sum of the CPU:                                   time used by the process>                                   and all its subprocesses, in>                                   centiseconds) should be used>                                   as a criterion. If threshold>                                   is specified, the differenceA                                   in CPU time between passes mustW@                                   exceed the specified threshold@                                   for a process to be considered)                                   active.n  =           PROCESS_                Process I/O (the sum of thei@           IO[:threshold]          buffered and direct I/O counts=                                   for the process and all itst>                                   subprocesses) should be used>                                   as a criterion. If thresholdA                                   is specified, the difference ino@                                   I/O counts between passes must@                                   exceed the specified threshold@                                   for a process to be considered)                                   active.   =           TERMINAL_               Terminal I/O (the operation ?           IO[:threshold]          count on the terminal device)s@                                   should be used as a criterion.<                                   If threshold is specified,>                                   the difference in I/O counts<                                   between passes must exceed=                                   the specified threshold for_<                                   a process to be considered)                                   active.p  =           Any combination of PROCESS_IO, CPU, and TERMINAL_IOa?           is permitted. If omitted, threshold values default tog>           zero. Note that threshold values should be chosen as=           a function of the wakeup interval (defined with SET            INTERVAL).  A                                                            CMD-15_ _  _               Command Descriptions           OVERRIDE        "           /[NO]WARNING[=deltatime]:           Specifies that the warning information should be<           overridden. The warning inactivity interval can be?           overridden by specifying a deltatime, or warnings can 0           be prevented by specifying /NOWARNING.                                                                                 CMD-16 s  n    A                                              Command Descriptions A                                                              QUIT         A           _______________________________________________________              QUIT  9           Quits WCP without saving configuration changes.   A           ________________________________________________________             FORMAT             QUIT  A           _______________________________________________________e             DESCRIPTIONi=           If changes to the configuration have been made, youn5           are asked for confirmation before quitting.t                                              A                                                            CMD-17p f                  Command Descriptions           RESETo        A           _______________________________________________________d             RESET   7           Sends a reset command to the WATCHER process.a  A           _______________________________________________________c             FORMAT             RESETt  A           _______________________________________________________.             DESCRIPTIONa;           This command sends a reset command to the WATCHERN<           process, which causes WATCHER to flush all process@           and configuration information, close its log and trace5           files, and read in the configuration again.   :           OPER and SYSPRV privileges are required for this           command.                                               CMD-18 t  e    A                                              Command DescriptionsrA                                                              SAVEe        A           _______________________________________________________r             SAVE  (           Saves a WATCHER configuration.  A           _______________________________________________________e             FORMAT             SAVE  [file-spec].  A           _______________________________________________________              PARAMETERS           file-spec ?           Name of the file to which the configuration should bee=           written. If omitted, it defaults to the name of theC<           file read in with the WCP/FILE qualifier (if any).=           If specified, the default file type is WCFG and theh<           default location is the current default directory.                                      A                                                            CMD-19p e                  Command Descriptions           SET ACTION        A           _______________________________________________________X             SET ACTION  >           Controls whether WATCHER performs warning and logout           actions.  A           _______________________________________________________              FORMAT             SET [NO]ACTION  A           _______________________________________________________n             DESCRIPTION =           To test out a WATCHER installation or configurationt9           change, you may want to SET NOACTION to preventp:           WATCHER from actually notifying any terminals or@           logging any users out. The SET NOACTION setting allows<           you to test your configuration safely, and use the=           DEBUG and trace facilities to see how WATCHER would            have performed.   ?           When you are through testing, return the setting backl>           to the default, SET ACTION, to have WATCHER actually9           perform warnings, disconnections, logouts, etc.t                                     CMD-20    o    A                                              Command DescriptionsiA                                                          SET BELLm        A           _______________________________________________________              SET BELL  >           Enables or disables the ringing of the terminal bell"           on warnings and logouts.  A           _______________________________________________________w             FORMAT             SET [NO]BELL  A           _______________________________________________________              DESCRIPTIONh@           By default, the terminal bell is not rung when WATCHER=           displays a warning or logout message on a terminal.C=           SET BELL will cause WATCHER to send a BEL character >           with the message to cause the terminal bell to ring.                                        A                                                            CMD-21_ _  _               Command Descriptions           SET DAYS        A           ________________________________________________________             SET DAYS  @           Establishes the primary and secondary day settings for           subsequent commands.  A           _______________________________________________________f             FORMAT             SET DAYS  A           _______________________________________________________ )           Command Qualifiers     Defaults              /PRIMARY=(day-list)            /SECONDARY=(day-list)o  A           ________________________________________________________             DESCRIPTION @           This command is used to move one or more days from the=           primary day list to the secondary day list or vice- ;           versa. These lists are used as shorthand by other_=           commands when you specify PRIMARY or SECONDARY on a            /DURING qualifier.                                     CMD-22 i  r    A                                              Command Descriptions_A                                                         SET DEBUG         A           _______________________________________________________              SET DEBUG   >           Enables or disables debug tracing and sets the level           of debug information.   A           _______________________________________________________              FORMAT             SET [NO]DEBUG[=mask]  A           _______________________________________________________d             DESCRIPTION_=           SET DEBUG turns on debug tracing. WATCHER will send :           debug output to the file or device identified by=           the WATCHER_TRACE logical name. For mask, specify a @           decimal number representing a bitmask indicating which9           kinds of debugging information you want logged.a  A           _______________________________________________________e                    BitA           Value____no.______Description__________________________   *             1        0      main line code  ,             2        1      exclusion checks  +             4        2      override checks   .             8        3      measurement checks  A           _16________4______process_info_collection______________O  >           The mask value can be any one of the above, or a sum@           of any of the above values. Use SET NODEBUG to disable           debug tracing.  A                                                            CMD-23s f  w               Command Descriptions           SET DECWINDOWS        A           _______________________________________________________              SET DECWINDOWS  ;           Enables or disables extra processing required for_           DECwindows support.t  A           _______________________________________________________r             FORMAT             SET [NO]DECWINDOWS  A           _______________________________________________________r             DESCRIPTION :           Since the DECwindows support requires additional9           processing beyond that used for watching normal,<           terminals, it is by default turned off. You should>           only SET DECWINDOWS when you will be running WATCHER7           on a DECwindows workstation (or a system withM>           DECwindows terminals). You will also need to include8           a WATCH rule for WSA terminal devices to watch<           DECwindows sessions (as described in Section 2.4).                                           CMD-24 v  i    A                                              Command Descriptions A                                                     SET EVENT_LOG         A           _______________________________________________________              SET EVENT_LOGD  =           Establishes how normal WATCHER events are recorded.d  A           _______________________________________________________i             FORMAT             SET [NO]EVENT_LOG   A           _______________________________________________________y)           Command Qualifiers     Defaults              /FILE=file-spec            /OPERATOR=oper-list   A           _______________________________________________________e             DESCRIPTION3:           This command specifies how normal WATCHER events;           (startup, shutdown, reset, and logout events) are @           recorded. By default, WATCHER events are logged to the!           CENTRAL operator class.   A           _______________________________________________________i             QUALIFIERS           /FILE=file-spec 6           Directs event logging to the specified file.             /OPERATOR=oper-list)=           Specifies a list of one or more operator classes toR=           which WATCHER events should be logged. If more thant?           one operator class name is specified, the list shouldo;           be comma-separated and surrounded by parentheses.t      A                                                            CMD-25  d  i               Command Descriptions           SET INSWAP        A           _______________________________________________________s             SET INSWAP  8           Sets the $GETJPI NOINSWAP control flag used by           WATCHER.  A           _______________________________________________________a             FORMAT             SET [NO]INSWAP  A           _______________________________________________________r             DESCRIPTION ;           Under VAX/VMS V5.2 and later (and all versions ofy=           OpenVMS AXP), the $GETJPI system service supports am>           control flag that prevents it from taking any action@           that would result in the swapping in of a process that@           is currently swapped out. SET NOINSWAP enables the use=           of this control flag in WATCHER, causing WATCHER tol?           ignore any swapped-out processes. The default settinge           is INSWAP.  =           Using SET NOINSWAP may result in inactive processes ?           not being logged out by WATCHER, or in some cases maye=           result in processes getting logged out prematurely,a=           because activity of swapped-out processes cannot ben*           determined when NOINSWAP is set.                               CMD-26 r  i    A                                              Command Descriptions(A                                                      SET INTERVALe        A           _______________________________________________________e             SET INTERVAL  :           Sets the hibernation interval between processing           passes.   A           _______________________________________________________T             FORMAT  !           SET INTERVAL=delta-timea  A           _______________________________________________________d             DESCRIPTION 6           This command sets the length of time WATCHER;           hibernates between processing passes. The default :           is 5 minutes. The value you should use should be?           smaller than the warning and logout intervals for all ?           terminals and smaller than the difference between theh?           logout and warning intervals for any single terminal.f;           Too small a value, however, will cause WATCHER toi           waste CPU time.                                 A                                                            CMD-27i r  i               Command Descriptions           SET MULTIWARNi        A           _______________________________________________________              SET MULTIWARN   0           Enables or disables multiple warnings.  A           _______________________________________________________s             FORMAT             SET [NO]MULTIWARN   A           _______________________________________________________O)           Command Qualifiers     Defaultse  7           /INTERVAL=delta-time   /INTERVAL="0 00:05:00"b  A           _______________________________________________________l             DESCRIPTIONo:           By default, WATCHER displays only one warning on:           terminals, at the time specified on the /WARNING=           qualifier. SET MULTIWARN enables multiple warnings;b?           one at the /WARNING time and again every five minutesu>           (or whatever interval you specify) until the /LOGOUT)           or /DISCONNECT time is reached.   (           This is a system-wide setting.  A           _______________________________________________________              QUALIFIERS           /INTERVAL=delta-time:           Specifies the interval of time that should occur8           between warnings. If omitted, defaults to five?           minutes. This value should equal or exceed the wakeup 9           interval value (specified by SET INTERVAL). The =           actual interval between warnings may be longer than ;           the specified time, since checks are made only at =           each processing pass (the interval between which is 3           controlled by the wakeup interval value).              CMD-28         A                                              Command DescriptionseA                                                        SET VERIFYf        A           _______________________________________________________              SET VERIFY  <           Enables or disables echoing of commands in command           files.  A           _______________________________________________________              FORMAT             SET [NO]VERIFY  A           _______________________________________________________              DESCRIPTIONi?           The SET VERIFY command turns on command verification,m:           so that commands read from WCP command files are8           echoed to the terminal. SET NOVERIFY turns off-           verification, which is the default.                                         A                                                            CMD-29  O  h               Command Descriptions           SET WATCH_DEFAULT         A           _______________________________________________________              SET WATCH_DEFAULTs  =           Establishes defaults for subsequent WATCH commands.d  A           _______________________________________________________              FORMAT             SET WATCH_DEFAULTn  A           _______________________________________________________t)           Command Qualifiers     Defaults   %           /[NO]DISCONNECT[=deltatime] %           /[NO]FORCE_EXIT[=deltatime] !           /[NO]LOGOUT[=deltatime]n&           /MEASURE=(measurement[,...])"           /[NO]WARNING[=deltatime]  A           _______________________________________________________r             DESCRIPTION >           The SET WATCH_DEFAULT command is used to set logout,@           warning, and measurement defaults for subsequent WATCH           commands.   @           The defaults set by this command are saved between WCP           sessions.   A           _______________________________________________________              QUALIFIERS%           /[NO]DISCONNECT[=deltatime]O=           Sets the default for disconnects, to be used if nott>           specified on subsequent WATCH commands. /DISCONNECT,:           /FORCE_EXIT, and /LOGOUT are mutually exclusive.  %           /[NO]FORCE_EXIT[=deltatime] ?           Sets the default for forced image exits to be used on >           subsequent WATCH commands. /DISCONNECT, /FORCE_EXIT,-           and /LOGOUT are mutually exclusive.R             CMD-30         A                                              Command Descriptions A                                                 SET WATCH_DEFAULTc        !           /[NO]LOGOUT[=deltatime] 9           Sets the default for logouts, to be used if not >           specified on subsequent WATCH commands. /DISCONNECT,:           /FORCE_EXIT, and /LOGOUT are mutually exclusive.  &           /MEASURE=(measurement[,...])?           Sets the default measurements to be used for activity <           determination if not specified on subsequent WATCH7           commands. For measurement, specify one of thec           following:  >           CPU[:threshold]         CPU time (the sum of the CPU:                                   time used by the process>                                   and all its subprocesses, in>                                   centiseconds) should be used>                                   as a criterion. If threshold>                                   is specified, the differenceA                                   in CPU time between passes must @                                   exceed the specified threshold@                                   for a process to be considered)                                   active.o  =           PROCESS_                Process I/O (the sum of the_@           IO[:threshold]          buffered and direct I/O counts=                                   for the process and all its_>                                   subprocesses) should be used>                                   as a criterion. If thresholdA                                   is specified, the difference inn@                                   I/O counts between passes must@                                   exceed the specified threshold@                                   for a process to be considered)                                   active.                 A                                                            CMD-31                     Command Descriptions           SET WATCH_DEFAULT_          =           TERMINAL_               Terminal I/O (the operation ?           IO[:threshold]          count on the terminal device)_@                                   should be used as a criterion.<                                   If threshold is specified,>                                   the difference in I/O counts<                                   between passes must exceed=                                   the specified threshold forl<                                   a process to be considered)                                   active.i  =           Any combination of PROCESS_IO, CPU, and TERMINAL_IOa?           is permitted. If omitted, threshold values default to >           zero. Note that threshold values should be chosen as=           a function of the wakeup interval (defined with SET            INTERVAL).  "           /[NO]WARNING[=deltatime];           Sets the defaults for warnings, to be used if not 1           specified on subsequent WATCH commands.n                                                   CMD-32 _  _    A                                              Command DescriptionsNA                                                              SHOW_        A           _______________________________________________________l             SHOW    <           Displays all or part of the current configuration.  A           _______________________________________________________              FORMAT                 { ACTION    }l                 { ALL       }r                 { BELL      }t                 {           }a                 { DAYS      }l                 { DEBUG     }                  { DEFAULTS  }h                 {           }c                 { EVENT_LOG }E           SHOW  { EXCLUDE   }l                 { FILE      }                  {           }                  { GLOBALS   }                  { INSWAP    }                  { INTERVAL  }                  {           }                  { MULTIWARN }                  { OVERRIDE  }                  { WATCH     }_                 {           }_  A           _______________________________________________________ )           Command Qualifiers     Defaultsw  +           /[NO]COMMAND           /NOCOMMAND_4           /OUTPUT=file-spec      /OUTPUT=SYS$OUTPUT:  A           ________________________________________________________             DESCRIPTION_9           The SHOW command displays information about theh=           current configuration and the WCP default settings.w  A                                                            CMD-33s A  E               Command Descriptions           SHOW      A           _______________________________________________________              QUALIFIERS           /[NO]COMMAND;           The /COMMAND qualifier indicates that the displayi;           should be formatted as the commands that would be_?           entered to create the specified records. Use /COMMAND =           with the /OUTPUT qualifier to create an MCP commandr=           file that can be altered with your favorite editor,_@           then read back into MCP to create a new configuration.             /OUTPUT=file-spec_:           The /OUTPUT qualifier is used to direct the SHOW;           result to a file or other device. By default, thea;           result is displayed on the current output device,_           SYS$OUTPUT._                                                             CMD-34 m  d    A                                              Command DescriptionstA                                                          SHUTDOWNe        A           _______________________________________________________r             SHUTDOWN  :           Sends a shutdown command to the WATCHER process.  A           _______________________________________________________a             FORMAT             SHUTDOWN  A           ________________________________________________________             DESCRIPTION_>           This command sends a shutdown command to the WATCHER>           process, which causes WATCHER to close its log files           and exit.   :           OPER and SYSPRV privileges are required for this           command.                                      A                                                            CMD-35_                    Command Descriptions           WATCHb        A           _______________________________________________________e             WATCH              Defines a watch rule.e  A           _______________________________________________________s             FORMAT             WATCH  device-patf  A           ________________________________________________________)           Command Qualifiers     Defaults   -           /ACCPORNAM=port-pat    /ACCPORNAM=*_           /DELETE_%           /[NO]DISCONNECT[=deltatime]n%           /[NO]FORCE_EXIT[=deltatime] !           /[NO]LOGOUT[=deltatime] &           /MEASURE=(measurement[,...])"           /[NO]WARNING[=deltatime]  A           ________________________________________________________             PARAMETERS           device-pat6           A terminal device name or pattern containing?           wildcards, to identify the terminal(s) to be watched.   A           _______________________________________________________              DESCRIPTION @           This command is used to add or remove (with /DELETE) a?           watch rule to the WATCHER configuration. When WATCHER @           is running, a process running on any terminal matching@           the specified criteria will be watched for inactivity,)           using the specified parameters.r               CMD-36         A                                              Command Descriptions_A                                                             WATCH       A           _______________________________________________________u             QUALIFIERS           /ACCPORNAM=port-pat @           Port name or pattern containing wildcards, identifying>           the terminal port(s) (for terminal servers and other>           devices using port names) to be watched. The default           is any port.             /DELETEe<           Specifies that the rule should be deleted from the@           configuration. All criteria must match exactly for the           rule to be deleted.   %           /[NO]DISCONNECT[=deltatime] :           For systems with virtual terminals enabled, this<           qualifier specifies whether the terminal should be?           disconnected from the system, and if so, how long theV>           terminal should be inactive before the disconnection:           occurs. If virtual terminals are not enabled, or8           the terminal to be forced off is not connected;           through a virtual terminal, the process is logged_=           out (the same effect as for the /LOGOUT qualifier).t=           If both this qualifier and /LOGOUT are omitted, the =           disconnect/logout default is taken from the current_$           SET WATCH_DEFAULT setting.  >           The /DISCONNECT, /FORCE_EXIT, and /LOGOUT qualifiers!           are mutually exclusive.u  ?           Note: The terminal-disconnection code used by WATCHERl=           runs in kernel mode, at elevated IPL, and hence may_:           result in a system crash if the VMS terminal UCB9           extensions or terminal class driver changes. Asi=           with all code that uses undocumented VMS internals,O?           exercise caution when using /DISCONNECT for the firstc<           time and when you upgrade to a new version of VMS.  ?            The disconnect code is the only part of WATCHER thati           uses kernel mode.a  A                                                            CMD-37                     Command Descriptions           WATCH         %           /[NO]FORCE_EXIT[=deltatime]W>           Specifies that any user-mode image currently running;           at the terminal should be forced to exit, without$(           actually logging the user off.  >           The /DISCONNECT, /FORCE_EXIT, and /LOGOUT qualifiers!           are mutually exclusive.M  !           /[NO]LOGOUT[=deltatime] 9           Specifies whether the terminal should be logged_9           out, and if so, how long the terminal should bea>           inactive before logout occurs. If this qualifier and@           /DISCONNECT are omitted, the logout/disconnect default>           is taken from the current SET WATCH_DEFAULT setting.  >           The /DISCONNECT, /FORCE_EXIT, and /LOGOUT qualifiers!           are mutually exclusive.   &           /MEASURE=(measurement[,...])<           Specifies the measurements that should be used for>           activity determination. For measurement, specify one           of the following:t  >           CPU[:threshold]         CPU time (the sum of the CPU:                                   time used by the process>                                   and all its subprocesses, in>                                   centiseconds) should be used>                                   as a criterion. If threshold>                                   is specified, the differenceA                                   in CPU time between passes must @                                   exceed the specified threshold@                                   for a process to be considered)                                   active.                          CMD-38 _  _    A                                              Command DescriptionsLA                                                             WATCH_          =           PROCESS_                Process I/O (the sum of the @           IO[:threshold]          buffered and direct I/O counts=                                   for the process and all itsd>                                   subprocesses) should be used>                                   as a criterion. If thresholdA                                   is specified, the difference ins@                                   I/O counts between passes must@                                   exceed the specified threshold@                                   for a process to be considered)                                   active.c  =           TERMINAL_               Terminal I/O (the operation_?           IO[:threshold]          count on the terminal device)T@                                   should be used as a criterion.<                                   If threshold is specified,>                                   the difference in I/O counts<                                   between passes must exceed=                                   the specified threshold for=<                                   a process to be considered)                                   active.l  =           Any combination of PROCESS_IO, CPU, and TERMINAL_IOs?           is permitted. If omitted, threshold values default too>           zero. Note that threshold values should be chosen as=           a function of the wakeup interval (defined with SETe?           INTERVAL). If no /MEASUREMENT qualifier is specified,t@           the measurement settings are taken from the SET WATCH_           DEFAULT settings.e  "           /[NO]WARNING[=deltatime]?           Specifies whether the terminal should be warned about @           inactivity, and if so, how long the terminal should be?           inactive before warning is sent. The warning intervale>           should be less than the logout interval. If omitted,:           the default is taken from the current SET WATCH_           DEFAULT setting.      A                                                            CMD-39f