                                   /           Guide to Installing and Using WATCHER                    February, 1993    @           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.8               Matthew D. Madison           TGV, Incorporated             Santa Cruz, California                                                           "           ________________________           03 February 1993  =           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 Rensselaer Polytechnic Institute. =           Rensselaer assumes no responsibility for any errors +        |  that may appear in this document.         |6        |  DISCLAIMER: The author and TGV, Inc. 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.              __________8           Copyright 1993 Matthew D. Madison. 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 BELL                            CMD-20:                 SET DAYS                            CMD-21:                 SET DEBUG                           CMD-22:                 SET DECWINDOWS                      CMD-23:                 SET EVENT_LOG                       CMD-24:                 SET INTERVAL                        CMD-25:                 SET MULTIWARN                       CMD-26:                 SET VERIFY                          CMD-27:                 SET WATCH_DEFAULT                   CMD-28:                 SHOW                                CMD-31:                 SHUTDOWN                            CMD-33:                 WATCH                               CMD-34                       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 <              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       :           o  You can override or modify the watch criteria8              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-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           __________________________________________________________________             Contacting the Author   8           There is no formal support for WATCHER. If you;           have electronic mail capability, however, you can ;           send your questions and comments to the author at :           madison@tgv.com. The author is also available on$           DECUServe as user MADISON.  =           If you cannot send electronic mail, you can contact 9           the author by post, telephone, or facsimile at:   %                       Matthew Madison   '                       TGV, Incorporated              vi         A                                                           Preface         (                       603 Mission Street  .                       Santa Cruz, CA 95060 USA      %           Phone:      +1 408 427 4366   %           Fax:        +1 408 427 4365                                                               A                                                               vii                  A           _______________________________________________________       1      Installing WATCHER        7           To use WATCHER, you need the following files:   ;           WATCHER.EXE                The main WATCHER image   @           WCP.EXE                    The WATCHER Control Program  9           WCP_HELPLIB.HLB            Help library for WCP   ?           DECW_STARTLOGIN.COM        Part of DECwindows support   >           WATCHER_CONFIG.WCFG        You create this file with(                                      WCP  ;           WATCHER_STARTUP.COM        Sample startup command .                                      procedure  <           WATCHER_SHUTDOWN.COM       Sample shutdown command.                                      procedure  9           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_   A                                                               1-1                     Installing WATCHER      ?           CONFIG.WCFG file, then execute WATCHER_STARTUP.COM to $           start the Watcher process.  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 3                                      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  ;           PRMMBX           For defining the command mailbox   
           1-2          A                                                Installing WATCHER         3           PSWAPM           Required for disconnects   @           SHARE            For sending warning messages to other+                            users' terminals   ;           SYSNAM           For defining the command mailbox   9           SYSPRV           (optional) to ensure access to ,                            appropriate files  <           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:  =           Memory required per WATCH rule            206 bytes   =           Memory required per EXCLUDE or OVERRIDE   507 bytes            rule  A                                                               1-3                     Installing WATCHER        =           Memory required per interactive process   465 bytes   =           Memory required per watched process       531 bytes   =           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=           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 foreign $           command, define the symbol  )                $ WCP :== $WATCHER_DIR:WCP   @           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:  B                WCP> WATCH *$RT*/MEASURE=PROCESS_IO/LOGOUT=00:15:00  =           This command sets up a rule for watching all DECnet ;           remote logins, using changes in total process I/Oa?           (buffered plus direct) to determine process activity, :           and causing logouts to occur after 15 minutes of           activity.r  @           Note: You must have at least one WATCH command in your           configuration.  A                                                               2-1p t                  Configuring WATCHER     %           ___________________________       2.1.1  Identifying Terminals   @           WATCH commands take any wildcard pattern. All terminal;           device names that match the specified pattern aret;           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 withg%           cluster-accessible devices.i  7           If the terminal device driver supports remotea;           port identification, as does the LTDRIVER for LATs<           terminals, the remote port information can also be;           used as a match criterion by using the /ACCPORNAMn8           qualifier. The port name can be specified as a(           wildcard pattern. For example:  4                WCP> WATCH *$LT*/ACCPORNAM="TRMSRV/*"  <           This command would cause the terminals attached to/           terminal server TRMSRV to be watched.y  %           ___________________________       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 the;                                 process owning the terminalC@                                 plus all of its subprocesses, in,                                 centiseconds      
           2-2L C  N    A                                               Configuring WATCHERr        ;           PROCESS_IO            the sum of the buffered and_@                                 direct I/O counts of the process?                                 owning the terminal plus all of_0                                 its subprocesses  @           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 an:           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_n           CONFIG.WCP.   %           ___________________________g      2.1.3  Terminal Groupings  9           You can group WATCH rules together by using thei:           /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:   H                WCP> WATCH WTA*/GROUP=VWS   ! normal VT200-series windowsG                WCP> WATCH TKA*/GROUP=VWS   ! Tek 4010 emulation windows G                WCP> WATCH TJA*/GROUP=VWS   ! Tek 4125 emulation windowsT  A                                                               2-3                     Configuring WATCHER       <           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.   L           __________________________________________________________________  "    2.2    Exclusions and Overrides  <           WATCHER's behaviour towards a terminal or user can=           be modified through the definition of exclusion andE?           override rules. Exclusions and overrides can be basedN=           on any combination of username, terminal/port name,L>           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):   3                WCP> EXCLUDE SYSTEM/TERMINAL=*$OPA0: N                WCP> OVERRIDE JONES/TERMINAL=NODE1$TXA3:/DURING=(PRIMARY:8-16)-/                _WCP>           /LOGOUT=02:00:00p  <           The first command prevents WATCHER from taking any>           action against the SYSTEM account while it is logged=           into the system console. The second command extendso<           the logout inactivity period to two hours for user=           JONES weekdays from 8 am to 4:59 pm, while JONES isa=           logged into the terminal in her office, which is ont$           port TXA3 on system NODE1.  L           __________________________________________________________________      2.3    Saving Configurations   ?           Once you have established the rules you need for your <           configuration, you should create the configuration%           file with the SAVE command:c  '                WCP> SAVE WATCHER_CONFIG   ;           If WATCHER is currently running, you can have theM<           new configuration take effect immediately with the@           RESET command, which will cause the WATCHER process to=           reload its configuration information from the file.e  
           2-4r         A                                               Configuring WATCHER     %           ___________________________n  !    2.3.1  VAXcluster Environmentsh  9           For mainly homogeneous VAXcluster environments,t:           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_CONFIGU;           logical name differently depending on the system.   %           ___________________________U       2.3.2  Editing Configurations  <           The WATCH, EXCLUDE, and OVERRIDE commands all have9           a /DELETE to allow you to remove rules from theg?           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, thee?           SHOW command has a /COMMAND qualifier that causes thea?           configuration information to be displayed as commands 5           you would enter to build the configuration:h  6                WCP> SHOW/COMMAND/OUTPUT=CONFIG.WCP ALL  =           Once you dump the commands to the command file, you_>           can edit the command file as needed and create a new*           configuration with the commands:                  $ WCP/NOFILE                 WCP> @CONFIGo'                WCP> SAVE WATCHER_CONFIGd  @           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-5C    t               Configuring WATCHERn    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 DECWINDOWS<                WCP> WATCH *WSA*/MEASURE=PROCESS_IO/NOWARNING  ?           Note that you cannot use TERMINAL_IO as a measurement <           when watching DECwindows sessions, nor can WATCHER4           give warnings to idle DECwindows sessions.  =           WATCHER identifies DECwindows sessions by searching 9           the job logical name table for each interactive <           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 the >           WSA device name. In this way, activity in any of the=           DECwindows jobs will be counted as activity for allr'           jobs related to that session.   >           The DECwindows window manager and DECterm controller?           processes are detached processes that are also neededY=           by WATCHER (when forcing off a DECwindows session).W;           To identify these processes, WATCHER searches form>           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).   <           When WATCHER identifies a DECwindows session to be;           forced off, it looks for all processes (including =           the detached processes, which are important) with at<           matching WSA device name and forces them off. This;           should destroy all the windows on the workstationn>           and return it to a blank, background screen. It then  
           2-6          A                                               Configuring WATCHERe      <           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.O  9           WATCHER cannot be used to watch DECwindows jobs <           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 withe?           some activity to prevent WATCHER from logging out the            DECwindows session.o  ?           This technique should be effective for VMS DECwindows :           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 DECwindows            implementations.                                              A                                                               2-7o                 A           _______________________________________________________r  !    3      Troubleshooting WATCHERW        ;           If WATCHER is not behaving as expected, there maya=           be a problem with your WATCHER configuration. Therei9           is debug/trace code built into WATCHER to allowH;           you to monitor five categories of activities: thea=           mainline WATCHER code, the exclusion-checking code,_=           the override-checking code, measurement checks, andR@           process information collection. Through the use of the?           SET DEBUG command, you can turn on tracing for any orM,           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:   6                $ SET PROCESS/PRIVILEGE=(SYSNAM,SYSPRV)                $ WCP                WCP> SET DEBUG=nt                 WCP> SET NOACTION0                WCP> SAVE WATCHER_DIR:TEST_CONFIG                WCP> EXITJ                $ DEFINE/SYSTEM/EXEC WATCHER_CONFIG WATCHER_DIR:TEST_CONFIGB                $ DEFINE/SYSTEM/EXEC WATCHER_TRACE  trace-file-spec                $ WCP RESET  9           The debug level n is described in the SET DEBUGa:           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-1          !           Troubleshooting WATCHERt      <           Subsequent WCP RESET commands will cause the trace=           file to be closed and a new version created, so yout?           can easily view past trace information. To go back toC>           "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 Wakeups   >           To assist in debugging, you may want to have WATCHER9           wake up more often than normal. You can do this :           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 a ?           suitably privileged account (SYSPRV), you can use the            commands:   /                $ OPEN/WRITE WMBOX WATCHER_MBOX:c                $ WRITE WMBOX ""o                $ CLOSE WMBOX  ?           Each WRITE command will trigger a wakeup, and WATCHER 2           will go through its processing sequence.                              
           3-2m r  a          A           _______________________________________________________i    '           Part II  Command Descriptionse t  h    A                                              Command DescriptionswA                                                               WCPt    A           _______________________________________________________d  
           WCP       /           Executes the WATCHER Control Program.   A           ________________________________________________________             FORMAT             WCP  [command]  A           _______________________________________________________o)           Command Qualifiers     Defaults   1           /FILE=file-spec        See description.x  A           _______________________________________________________              PARAMETERS           [command] ?           Any WCP command except the input redirection operators?           (@). The specified command is executed and control is 1           returned to DCL immediately thereafter.l  A           _______________________________________________________t             DESCRIPTION_@           WCP is intended to be used as a DCL "foreign" command.;           To use it as a foreign command, you must define an           symbol as follows:  )                $ WCP :== $WATCHER_EXE:WCPt  ?           Defining the symbol in this way allows you to use theo@           /FILE qualifier and specify "one-shot" commands on the           command line.     A                                                             CMD-3     h               Command Descriptions
           WCP   A           _______________________________________________________              QUALIFIERS           /[NO]FILE=file-spec <           Loads the specified WATCHER configuration file for;           editing. If not specified, the configuration filet:           pointed to by the logical name WATCHER_CONFIG is;           loaded. The default file type is WCFG. If /NOFILEp8           is specified, no configuration file is loaded.                                                                             CMD-4C o  n    A                                              Command Descriptions B                                         @ (Redirect Command Input)    A           _______________________________________________________s  $           @ (Redirect Command Input)  1           Executes WCP commands read from a file.t  A           _______________________________________________________c             FORMAT             @  file-spec  A           _______________________________________________________o             PARAMETERS           file-spec,?           Name of the file containing WCP commands. If omitted,c'           the default file type is WCP.   A           _______________________________________________________a             DESCRIPTION ;           Use this command to have WCP take further command =           input from the specified file. There is no built-in =           limit on the number of levels of nesting of command_;           files, so be careful when using input redirection @           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 WCPL:           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.  0                $ DEFINE/USER SYS$INPUT file-spec                $ WCP          A                                                             CMD-5                     Command Descriptions           EXCLUDE     A           _______________________________________________________              EXCLUDEf  $           Defines an exclusion rule.  A           _______________________________________________________              FORMAT             EXCLUDE  username-pat   A           _______________________________________________________s)           Command Qualifiers     Defaultsl  -           /ACCPORNAM=port-pat    /ACCPORNAM=*            /DELETEo/           /DURING=daytim-list    (all the time)k*           /HOLDING=identifier    (ignored))           /IMAGE=fspec-pat       /IMAGE=* *           /PRIVILEGES=priv-list  (ignored),           /TERMINAL=dev-pat      /TERMINAL=*+           /UIC=uic               /UIC=[*,*]   A           _______________________________________________________r             PARAMETERS           username-pat9           A VMS username or pattern containing wildcards,a.           identifying the user to be excluded.  A           _______________________________________________________i             DESCRIPTION >           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. Omittedh0           criteria are not used or always match.               CMD-6r s       A                                              Command DescriptionseA                                                           EXCLUDEn  A           _______________________________________________________u             QUALIFIERS           /ACCPORNAM=port-patn@           Port name or pattern containing wildcards, identifying;           the terminal port (for terminal servers and otheru=           devices using port names) on which the user must bet<           logged in to be excluded. The default is any port.             /DELETET<           Specifies that the rule should be deleted from the@           configuration. All criteria must match exactly for the           rule to be deleted.i             /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[,...])   <           where day is a day of the week or the word PRIMARY=           or SECONDARY, identifying the primary and secondary <           days set with SET DAYS, and hour-range is either a?           single hour number (0 through 23) or two hour numbers <           separated by a hyphen. Multiple hour ranges may be           specified per day.             /HOLDING=identifieri7           Specifies that the user should be excluded ife=           holding the specified identifier. The identifier iso?           converted to binary format before being stored in they=           configuration, so you must create the configurationm?           file on the target system, or on a node with the samec>           RIGHTSLIST database as the target system, to prevent.           misinterpretation of the identifier.  ?           If you are running VMS V5.4 or later, WATCHER obtainsN=           the identifiers held by the process directly (using_;           $GETJPI), and thus can check identifiers that aren:           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 ownsi  A                                                             CMD-7  m                  Command Descriptions           EXCLUDEm    >           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).              /IMAGE=fspec-pat?           Specifies that the user should be excluded if runningh<           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 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, an image being run @           by one of the subprocesses (randomly selected if there.           are two or more such subuprocesses).             /PRIVILEGES=priv-list =           Specifies that the user is to be excluded only whene;           holding the specified privilege or privileges. Ifd:           omitted, privileges are not used as a criterion.             /TERMINAL=dev-patf@           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 excludede;           only when owned by a matching UIC. You may use ane=           asterisk for the member part of the UIC to have allt:           UIC's in a group match. If omitted, any UIC will           match.                     CMD-8h a  O    A                                              Command DescriptionsoA                                                              EXITc    A           _______________________________________________________L             EXIT             Ends a WCP session.m  A           _______________________________________________________a             FORMAT             EXIT  A           _______________________________________________________C             DESCRIPTIONP=           Ends the current WCP session and returns control toi;           DCL. If you have modified the configuration, EXITc?           will ask for a file name for saving the configurationd           before exiting.i                                            A                                                             CMD-9C    t               Command Descriptions           HELP    A           _______________________________________________________              HELP  $           Displays help information.  A           _______________________________________________________r             FORMAT             HELP  [topic...]  A           _______________________________________________________t             PARAMETERS           topic @           The name of a topic in the help library. If omitted, a&           list of topics is displayed.  A           _______________________________________________________o             DESCRIPTIONa1           This command is pretty straightforward.s                                               CMD-10 l  E    A                                              Command DescriptionsbA                                                          OVERRIDEt    A           _______________________________________________________              OVERRIDE  #           Defines an override rule.   A           _______________________________________________________              FORMAT              OVERRIDE  username-pat  A           _______________________________________________________ )           Command Qualifiers     Defaults   -           /ACCPORNAM=port-pat    /ACCPORNAM=*            /DELETEi/           /DURING=daytim-list    (all the time)o*           /HOLDING=identifier    (ignored))           /IMAGE=fspec-pat       /IMAGE=*E*           /PRIVILEGES=priv-list  (ignored),           /TERMINAL=dev-pat      /TERMINAL=*+           /UIC=uic               /UIC=[*,*](%           /[NO]DISCONNECT[=deltatime]W%        |  /[NO]FORCE_EXIT[=deltatime],!           /[NO]LOGOUT[=deltatime]e&           /MEASURE=(measurement[,...])"           /[NO]WARNING[=deltatime]  A           _______________________________________________________d             PARAMETERS           username-pat9           A VMS username or pattern containing wildcards,e@           identifying the user for which the override is to take           effect.(          A                                                            CMD-11                     Command Descriptions           OVERRIDE  A           _______________________________________________________n             DESCRIPTIONa>           This command is used to add or remove (with /DELETE)=           an override rule to the WATCHER configuration. When =           WATCHER is running, any process that matches all of ?           the specified criteria will have the warning, logout, ?           and measurement information, if specified, taken from 6           the override rule instead of the WATCH rule.  A           _______________________________________________________              QUALIFIERS           /ACCPORNAM=port-patt@           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.             /DELETE <           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[,...])   <           where day is a day of the week or the word PRIMARY=           or SECONDARY, identifying the primary and secondaryW<           days set with SET DAYS, and hour-range is either a?           single hour number (0 through 23) or two hour numbersb<           separated by a hyphen. Multiple hour ranges may be           specified per day.             /HOLDING=identifierW7           Specifies that the user should be excluded if =           holding the specified identifier. The identifier isc?           converted to binary format before being stored in the =           configuration, so you must create the configurationl             CMD-12 t  r    A                                              Command Descriptions A                                                          OVERRIDE     ?           file on the target system, or on a node with the sameS>           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 (usingF;           $GETJPI), and thus can check identifiers that aref:           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 user should be excluded if runninge<           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 againsto?           the wildcard pattern is the image currently being runh=           by the master process in the job, or, if the master_=           process is not running an image, an image being runo@           by one of the subprocesses (randomly selected if there.           are two or more such subuprocesses).             /PRIVILEGES=priv-list =           Specifies that the user is to be excluded only wheno;           holding the specified privilege or privileges. Ify:           omitted, privileges are not used as a criterion.             /TERMINAL=dev-patS@           Specifies a terminal device name or pattern containing<           wildcards. The user must be logged into a matching"           terminal to be excluded.    A                                                            CMD-13     l               Command Descriptions           OVERRIDE               /UIC=uic?           Specifies a UIC or UIC pattern. A process is excluded_;           only when owned by a matching UIC. You may use anp=           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. 6           The inactivity interval can be overridden by<           specifying a deltatime, or logouts/disconnects can=           be prevented altogether by specifying /NODISCONNECTi;           (although it is more efficient to use EXCLUDE for_        |  this).        |%        |  /[NO]FORCE_EXIT[=deltatime] :        |  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 by >        |  specifying a deltatime, or exits/logouts/disconnects=        |  can be prevented altogether by specifying /NOFORCE_ @        |  EXIT (although it is more efficient to use EXCLUDE for        |  this).  !           /[NO]LOGOUT[=deltatime]a:           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 usen           EXCLUDE for this).                   CMD-14 n       A                                              Command Descriptions A                                                          OVERRIDEa    &           /MEASURE=(measurement[,...])9           Specifies that the activity measurements shouldC<           be overridden. For measurement, specify one of the           following:  9           CPU[:threshold]            CPU time (the sum ofu9                                      the CPU time used by_8                                      the process and all9                                      its subprocesses, in <                                      centiseconds) should be<                                      used as a criterion. If<                                      threshold is specified,?                                      the difference in CPU timec?                                      between passes must exceedt@                                      the specified threshold for?                                      a process to be consideredm,                                      active.  <           PROCESS_IO[:threshold]     Process I/O (the sum of<                                      the buffered and direct?                                      I/O counts for the process >                                      and all its subprocesses)8                                      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.                      A                                                            CMD-15_ _  _               Command Descriptions           OVERRIDE      @           TERMINAL_IO[:threshold]    Terminal I/O (the operation:                                      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 for a=                                      process to be considered ,                                      active.  =           Any combination of PROCESS_IO, CPU, and TERMINAL_IO ?           is permitted. If omitted, threshold values default toi>           zero. Note that threshold values should be chosen as=           a function of the wakeup interval (defined with SET_           INTERVAL).  "           /[NO]WARNING[=deltatime]:           Specifies that the warning information should be<           overridden. The warning inactivity interval can be?           overridden by specifying a deltatime, or warnings cand0           be prevented by specifying /NOWARNING.                                               CMD-16         A                                              Command DescriptionsnA                                                              QUITD    A           _______________________________________________________u             QUIT  9           Quits WCP without saving configuration changes.r  A           _______________________________________________________r             FORMAT             QUIT  A           _______________________________________________________              DESCRIPTIONd=           If changes to the configuration have been made, youc5           are asked for confirmation before quitting.                                                 A                                                            CMD-17m s                  Command Descriptions           RESETh    A           _______________________________________________________              RESETt  7           Sends a reset command to the WATCHER process.r  A           _______________________________________________________d             FORMAT             RESETi  A           _______________________________________________________n             DESCRIPTION ;           This command sends a reset command to the WATCHERr<           process, which causes WATCHER to flush all process@           and configuration information, close its log and trace5           files, and read in the configuration again.i  :           OPER and SYSPRV privileges are required for this           command.                                                 CMD-18    o    A                                              Command DescriptionshA                                                              SAVEd    A           _______________________________________________________f             SAVE  (           Saves a WATCHER configuration.  A           _______________________________________________________              FORMAT             SAVE  [file-spec]c  A           _______________________________________________________5             PARAMETERS           file-specs?           Name of the file to which the configuration should bee=           written. If omitted, it defaults to the name of the <           file read in with the WCP/FILE qualifier (if any).=           If specified, the default file type is WCFG and thee<           default location is the current default directory.                                        A                                                            CMD-19m d  h               Command Descriptions           SET BELL    A           _______________________________________________________              SET BELL  >           Enables or disables the ringing of the terminal bell"           on warnings and logouts.  A           _______________________________________________________              FORMAT             SET [NO]BELL  A           _______________________________________________________c             DESCRIPTIONg@           By default, the terminal bell is not rung when WATCHER=           displays a warning or logout message on a terminal.e=           SET BELL will cause WATCHER to send a BEL characters>           with the message to cause the terminal bell to ring.                                                     CMD-20         A                                              Command Descriptions A                                                          SET DAYS     A           _______________________________________________________p             SET DAYS  @           Establishes the primary and secondary day settings for           subsequent commands.  A           _______________________________________________________a             FORMAT             SET DAYS  A           _______________________________________________________r)           Command Qualifiers     Defaultse             /PRIMARY=(day-list)a           /SECONDARY=(day-list)m  A           _______________________________________________________f             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.                            A                                                            CMD-21_                    Command Descriptions           SET DEBUG_    A           _______________________________________________________              SET DEBUGe  >           Enables or disables debug tracing and sets the level           of debug information.c  A           _______________________________________________________              FORMAT             SET [NO]DEBUG[=mask]  A           _______________________________________________________              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           _______________________________________________________AA           Value_____Bit_no.___Description________________________   ,             1         0       main line code  .             2         1       exclusion checks  -             4         2       override checksE  0             8         3       measurement checks  A           _16_________4_______process_info_collection____________   >           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.                 CMD-22 _  _    A                                              Command DescriptionsoA                                                    SET DECWINDOWS_    A           _______________________________________________________t             SET DECWINDOWS  ;           Enables or disables extra processing required foru           DECwindows support.   A           _______________________________________________________              FORMAT             SET [NO]DECWINDOWS  A           _______________________________________________________M             DESCRIPTIONE:           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 witht>           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).                                  A                                                            CMD-23                     Command Descriptions           SET EVENT_LOG     A           ________________________________________________________             SET EVENT_LOG_  =           Establishes how normal WATCHER events are recorded.s  A           _______________________________________________________d             FORMAT             SET [NO]EVENT_LOG   A           _______________________________________________________ )           Command Qualifiers     Defaultso             /FILE=file-specm           /OPERATOR=oper-listt  A           _______________________________________________________              DESCRIPTION_:           This command specifies how normal WATCHER events;           (startup, shutdown, reset, and logout events) arep@           recorded. By default, WATCHER events are logged to the!           CENTRAL operator class.   A           _______________________________________________________              QUALIFIERS           /FILE=file-specp6           Directs event logging to the specified file.             /OPERATOR=oper-list =           Specifies a list of one or more operator classes toe=           which WATCHER events should be logged. If more thans?           one operator class name is specified, the list should ;           be comma-separated and surrounded by parentheses.e                   CMD-24 e       A                                              Command Descriptions A                                                      SET INTERVALr    A           _______________________________________________________w             SET INTERVAL  :           Sets the hibernation interval between processing           passes.   A           _______________________________________________________              FORMAT  !           SET INTERVAL=delta-time   A           _______________________________________________________d             DESCRIPTIONi6           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 allr?           terminals and smaller than the difference between the ?           logout and warning intervals for any single terminal. ;           Too small a value, however, will cause WATCHER toy           waste CPU time.                                   A                                                            CMD-25n                    Command Descriptions           SET MULTIWARN     A           _______________________________________________________r             SET MULTIWARN   0           Enables or disables multiple warnings.  A           _______________________________________________________              FORMAT             SET [NO]MULTIWARNa  A           _______________________________________________________.)           Command Qualifiers     DefaultsH  7           /INTERVAL=delta-time   /INTERVAL="0 00:05:00"i  A           _______________________________________________________e             DESCRIPTIONn:           By default, WATCHER displays only one warning on:           terminals, at the time specified on the /WARNING=           qualifier. SET MULTIWARN enables multiple warnings;a?           one at the /WARNING time and again every five minutes >           (or whatever interval you specify) until the /LOGOUT)           or /DISCONNECT time is reached.   (           This is a system-wide setting.  A           _______________________________________________________e             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 wakeupp9           interval value (specified by SET INTERVAL). Thep=           actual interval between warnings may be longer thano;           the specified time, since checks are made only atm=           each processing pass (the interval between which isR3           controlled by the wakeup interval value).              CMD-26 i       A                                              Command Descriptions A                                                        SET VERIFY     A           _______________________________________________________s             SET VERIFY  <           Enables or disables echoing of commands in command           files.  A           _______________________________________________________              FORMAT             SET [NO]VERIFY  A           _______________________________________________________i             DESCRIPTION ?           The SET VERIFY command turns on command verification,e:           so that commands read from WCP command files are8           echoed to the terminal. SET NOVERIFY turns off-           verification, which is the default.                                           A                                                            CMD-27n                    Command Descriptions           SET WATCH_DEFAULT     A           _______________________________________________________              SET WATCH_DEFAULTE  =           Establishes defaults for subsequent WATCH commands.i  A           _______________________________________________________              FORMAT             SET WATCH_DEFAULTd  A           _______________________________________________________d)           Command Qualifiers     Defaultsl  %           /[NO]DISCONNECT[=deltatime]e%        |  /[NO]FORCE_EXIT[=deltatime]i!           /[NO]LOGOUT[=deltatime]l&           /MEASURE=(measurement[,...])"           /[NO]WARNING[=deltatime]  A           _______________________________________________________n             DESCRIPTION >           The SET WATCH_DEFAULT command is used to set logout,@           warning, and measurement defaults for subsequent WATCH        |  commands.i        |@        |  The defaults set by this command are saved between WCP        |  sessions.c  A           _______________________________________________________m             QUALIFIERS%           /[NO]DISCONNECT[=deltatime]U=           Sets the default for disconnects, to be used if not >        |  specified on subsequent WATCH commands. /DISCONNECT,:        |  /FORCE_EXIT, and /LOGOUT are mutually exclusive.        |%        |  /[NO]FORCE_EXIT[=deltatime]E?        |  Sets the default for forced image exits to be used onc>        |  subsequent WATCH commands. /DISCONNECT, /FORCE_EXIT,-        |  and /LOGOUT are mutually exclusive.              CMD-28         A                                              Command Descriptions A                                                 SET WATCH_DEFAULT     !           /[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 activityC<           determination if not specified on subsequent WATCH7           commands. For measurement, specify one of thee           following:  9           CPU[:threshold]            CPU time (the sum ofe9                                      the CPU time used by 8                                      the process and all9                                      its subprocesses, in <                                      centiseconds) should be<                                      used as a criterion. If<                                      threshold is specified,?                                      the difference in CPU time ?                                      between passes must exceed @                                      the specified threshold for?                                      a process to be considered ,                                      active.  <           PROCESS_IO[:threshold]     Process I/O (the sum of<                                      the buffered and direct?                                      I/O counts for the process >                                      and all its subprocesses)8                                      should be used as a?                                      criterion. If threshold isc>                                      specified, the difference:                                      in I/O counts between;                                      passes must exceed the >                                      specified threshold for a=                                      process to be considered ,                                      active.          A                                                            CMD-29  p  e               Command Descriptions           SET WATCH_DEFAULT.      @           TERMINAL_IO[:threshold]    Terminal I/O (the operation:                                      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 for a=                                      process to be considered ,                                      active.  =           Any combination of PROCESS_IO, CPU, and TERMINAL_IOn?           is permitted. If omitted, threshold values default toQ>           zero. Note that threshold values should be chosen as=           a function of the wakeup interval (defined with SETa           INTERVAL).  "           /[NO]WARNING[=deltatime];           Sets the defaults for warnings, to be used if not 1           specified on subsequent WATCH commands._                                                   CMD-30         A                                              Command Descriptions A                                                              SHOW     A           _______________________________________________________              SHOW      <           Displays all or part of the current configuration.  A           _______________________________________________________              FORMAT                 { ACTION    }o                 { ALL       }                  { BELL      }_                 { DAYS      }                  {           }E                 { DEBUG     }_                 { DEFAULTS  }_                 { EVENT_LOG }T           SHOW  {           }n                 { EXCLUDE   }E                 { FILE      }u                 { GLOBALS   }s                 {           }n                 { INTERVAL  }a                 { MULTIWARN }n                 { OVERRIDE  }                  {           }g                 { WATCH     }   A           _______________________________________________________ )           Command Qualifiers     Defaults   +           /[NO]COMMAND           /NOCOMMAND 4           /OUTPUT=file-spec      /OUTPUT=SYS$OUTPUT:  A           ________________________________________________________             DESCRIPTION 9           The SHOW command displays information about the_=           current configuration and the WCP default settings.O  A                                                            CMD-31_ _  _               Command Descriptions           SHOW  A           _______________________________________________________g             QUALIFIERS           /[NO]COMMAND;           The /COMMAND qualifier indicates that the displayt;           should be formatted as the commands that would beh?           entered to create the specified records. Use /COMMANDi=           with the /OUTPUT qualifier to create an MCP command =           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, thet;           result is displayed on the current output device,            SYS$OUTPUT._                                                               CMD-32    ]    A                                              Command Descriptions_A                                                          SHUTDOWNl    A           _______________________________________________________a             SHUTDOWN  :           Sends a shutdown command to the WATCHER process.  A           _______________________________________________________              FORMAT             SHUTDOWN  A           _______________________________________________________C             DESCRIPTION >           This command sends a shutdown command to the WATCHER>           process, which causes WATCHER to close its log files           and exit.E  :           OPER and SYSPRV privileges are required for this           command.                                        A                                                            CMD-33  M                  Command Descriptions           WATCH_    A           _______________________________________________________D             WATCH              Defines a watch rule.S  A           ________________________________________________________             FORMAT             WATCH  device-pat   A           _______________________________________________________ )           Command Qualifiers     Defaultst  -           /ACCPORNAM=port-pat    /ACCPORNAM=*            /DELETEe%           /[NO]DISCONNECT[=deltatime] %        |  /[NO]FORCE_EXIT[=deltatime]D!           /[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.a                 CMD-34         A                                              Command Descriptions A                                                             WATCH_  A           ________________________________________________________             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.             /DELETEo<           Specifies that the rule should be deleted from the@           configuration. All criteria must match exactly for the           rule to be deleted.   %           /[NO]DISCONNECT[=deltatime]M:           For systems with virtual terminals enabled, this<           qualifier specifies whether the terminal should be?           disconnected from the system, and if so, how long the_>           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)._=           If both this qualifier and /LOGOUT are omitted, theI=           disconnect/logout default is taken from the currentn$        |  SET WATCH_DEFAULT setting.        |>        |  The /DISCONNECT, /FORCE_EXIT, and /LOGOUT qualifiers!        |  are mutually exclusive.C        |%        |  /[NO]FORCE_EXIT[=deltatime] >        |  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.   !           /[NO]LOGOUT[=deltatime] 9           Specifies whether the terminal should be loggedo9           out, and if so, how long the terminal should be_>           inactive before logout occurs. If this qualifier and  A                                                            CMD-35s                    Command Descriptions           WATCH_    @           /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:   9           CPU[:threshold]            CPU time (the sum ofa9                                      the CPU time used by 8                                      the process and all9                                      its subprocesses, in <                                      centiseconds) should be<                                      used as a criterion. If<                                      threshold is specified,?                                      the difference in CPU times?                                      between passes must exceedr@                                      the specified threshold for?                                      a process to be considered ,                                      active.  <           PROCESS_IO[:threshold]     Process I/O (the sum of<                                      the buffered and direct?                                      I/O counts for the process >                                      and all its subprocesses)8                                      should be used as a?                                      criterion. If threshold is_>                                      specified, the difference:                                      in I/O counts between;                                      passes must exceed thes>                                      specified threshold for a=                                      process to be considered ,                                      active.                     CMD-36 a  f    A                                              Command DescriptionsuA                                                             WATCH       @           TERMINAL_IO[:threshold]    Terminal I/O (the operation:                                      count on the terminal@                                      device) should be used as a?                                      criterion. If threshold isb>                                      specified, the difference:                                      in I/O counts between;                                      passes must exceed the_>                                      specified threshold for a=                                      process to be consideredV,                                      active.  =           Any combination of PROCESS_IO, CPU, and TERMINAL_IOn?           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). If no /MEASUREMENT qualifier is specified, @           the measurement settings are taken from the SET WATCH_           DEFAULT settings.d  "           /[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 interval >           should be less than the logout interval. If omitted,:           the default is taken from the current SET WATCH_           DEFAULT setting.                            A                                                            CMD-37 