vovprocessmgr

vovprocessmgr: Usage Message

USAGE:
    % vovprocessmgr [OPTIONS]

Report on and manage processes on hosts where an Altair Engineering vovtasker
is running, for example, in Accelerator.

OPTIONS:
    -h             -- Show brief help.
    -v             -- Increase verbosity.
    -w             -- Wide output (tab-separated, no truncation in names).
    -refresh [-orphans [-host HOST[,HOST]...] [-nohost HOST[,HOST]...]]
                      -- Refresh the process info. Refreshes all process info
                      unless the -orphans option is also passed, which
                      refreshes the process info for orphaned processes only.
                      The -host/-nohost options apply when refreshing orphaned
                      processes only, otherwise, all hosts are included.
                      Orphaned processes are determined by the presence of the
                      VOV_JOBID variable in the environment of the process.
                      Note that this is an asynchronous operation that is sent
                      to remote taskers, requesting them to gather and send
                      process information to the server. The timeliness of the
                      response depends on the loading of both the taskers and 
                      of the server. For this reason, some amount of time
                      should be allowed between a refresh request and
                      reporting on processes of any type. For reports
                      involving only a few taskers, this could be measured in
                      seconds. For requests involving hundreds or thousands of
                      hosts, it may take several minutes for every tasker to
                      report in. Refreshing process info is an expensive
                      operation that can result in a significant amount of
                      communication and loading on the vovserver process and
                      therefore should be used only when necessary.
    -external      -- Filter to processes that are not an descendant of 
                      tasker.
    -descendants   -- Filter to current descendant processes of tasker.
    -orphans       -- Filter to former descendant processes of tasker. For
                      accurate results, refresh the process info using the
                      -orphans option prior to running an orphan report. An
                      orphan report will also include fostered jobs as well.
                      Note that if orphan processes are common, it is
                      recommended to enable automatic child process cleanup
                      via the tasker.childProcessCleanup configuration
                      parameter in the policy.tcl file.
    -fostered      -- Filter to orphans currently being fostered.
    -all           -- Show all processes.

    -user "USER[,USER]..."              -- Filter to specified users.
    -host "HOST[,HOST]..."              -- Filter to specified hosts.
    -exe  "executableName[,exname]..."  -- Filter to specified executable
                                           names.

    -noheader      -- Suppress header.
    -noresv        -- Exclude reserved taskers.
    -noexternal    -- Exclude processes that are not an descendant of tasker.
    -nodescendants -- Exclude current descendant processes of tasker.
    -noorphans     -- Exclude former descendant processes of tasker.
    -nofostered    -- Exclude orphans currently being fostered.

    -nouser "USER[,USER]..."              -- Exclude specified users.
    -nohost "HOST[,HOST]..."              -- Exclude specified hosts.
    -noexe  "executableName[,exname]..."  -- Exclude specified executable
                                             names.

    -age   "TIMESPEC"  -- default age 10m.
    -maxrecursion "N"  -- Limit in recursive check of parents (default 100).

    -foster            -- Create a foster job for each top-most orphaned
                          process. Note that if orphan processes are common, 
                          it is recommended to enable automatic child process
                          cleanup via the tasker.childProcessCleanup
                          configuration parameter in the policy.tcl file.

    -clear             -- Forget all information about processes from the 
                          server (frees up memory). Must be the only option.

EXAMPLES:
   % vovprocessmgr -refresh
   % vovprocessmgr -refresh -orphans
   % vovprocessmgr -orphans
   % vovprocessmgr -all -noexternal
   % vovprocessmgr -external -onlyuser john,mary,bob
   % vovprocessmgr -orphans -age 3h
   % vovprocessmgr -clear