NAME

      watchDog - RTAP environment watch dog process

SYNOPSIS

       watchDog [-d do not increment terminated process counts]
                [-e RTAP environment name] [-i interval (secs)]
                [-t timeout (secs)] [-p watch dog point alias]
                [-q no remote query for procnum] [-v verbose]

DESCRIPTION

      watchDog  is  the  controlling  process  in  an   RTAP   environment's
      monitoring  system.  It  runs  within  an RTAP environment, and uses a
      database point (see -p option) to record activity to various processes
      and/or  other  environments. watchDog receives condition messages from
      RtapWDServer periodically (see -i option). The messages are parsed and
      saved into the database. The database alarm system can then be used to
      trigger other actions based on the status received.

      The -d argument specifies that the watchDog will not increment
      the counts for a terminated process.

      The -e environment name argument  specifies  the environment to  which
      watchDog  is  to  attach  itself (see rtRegisterForDebug(3)).  If this
      option is omitted, the contents of the  environment  variable  RTAPENV
      are used instead.

      The -i  interval  argument   specifies   the  interval  that  watchDog
      expects   to   receive   RTAP   environment  condition  messages  from
      RtapWDServer(1). The default interval is 30 seconds, and  the  minimum
      defined in rtWD_MIN_INTERVAL, is 10 seconds. If the value specified is
      less than the minimum value, it is silently set to the minimum value.

      The -p watch dog point alias argument  specifies  the  alias  name  of
      the watch dog point alias. The default is WATCH DOG.

      The -q argument specifies that the watchDog will not query any  remote
      environments  for  the  watchDog  process number;  instead the process
      number is assumed to be the same as the current watchDog process.  The
      process number can be set in the RtapEnvTable(4).

      The -t timeout argument  specifies the  number of seconds in  addition
      to  the  interval  time  that  watchDog  waits  for  a  response  from
      RtapWDServer(1) before timing out. If a timeout occurs, the status for
      the processes will be set to the value of rtSRVR_NOT_RESPONDING.

      The -v argument specifies that errors should be printed to  stdout  as
      well as being logged through RtapMonitor(1).

DIAGNOSTICS

      watchDog uses RtapMonitor(1) to log diagnostic messages.

AUTHOR

      watchDog was developed by tesserNet Systems Inc.

SEE ALSO

      RtapWDServer(1), RtapMonitor(1), RtapEnvLookup(1), RtapEnvTable(4)