vovforget

vovforget: Usage Message

DESCRIPTION:
    Forget objects from the project's vovserver.
    The objects are typically nodes (files or jobs) and are
    are passed by VovId or by file name.
    The objects may also be users, sets, or selected by option.

USAGE:
    vovforget [options] [objectId] ...

OPTIONS:

    -alerts             -- Forget all alerts.
    -allalerts          -- Forget all alerts (same as -alerts).
    -allemptysets       -- Forget all empty sets older than 60s.
                           (Command is only supported for Accelerator, Accelerator Plus, and Hero products.)
    -allnodes           -- Forget all nodes.
    -allhosts           -- Forget all hosts.
    -allsets            -- Forget all sets (except System sets).
                              see also -allemptysets   and -emptysets
                           (Command is only supported for FlowTracer, Allocator, and Monitor products.)
    -allresources       -- Forget all resource maps.
    -rdsresources       -- Forget all resource maps created by RDS.
    -allreservations    -- Forget all reservations.
    -blocking           -- Forget blocking files, i.e.
                           files with no inputs that are not VALID.
    -dir      <dirname> -- Forget jobs in a directory.
    -elements <setName> -- Forget elements in given set.
    -emptysets          -- Forget 'my' empty sets older than X seconds
                           X = 0s for FlowTracer, Allocator, and Monitor products.
                           X = 60s  for Accelerator, Accelerator Plus, and Hero products.
    -emptysets -hier    -- Forget 'my' empty sets (and their subsets) older than 0s (default).
                           (Command is only supported for FlowTracer, Allocator, and Monitor products.)
    -h
    -help               -- Help usage message.
    -hier               -- When forgetting a set or its elements,
                           also traverse the hierarchy of the subsets.
                           Technical note: The traversal is based on
                           attachments of subsets,
                           and not on the names of the subsets.
    -idlelimits         -- Forget all Limit:* resources that are not
                           associated with any running or queued jobs.
    -idleusers          -- Forget users with no clients and no jobs.
    -isolated           -- Forget isolated files, i.e.
                           files with no inputs nor outputs.
    -missing            -- Forget missing files.
    -orphanreservations -- Forget all orphan reservations.
    -oldlimits          -- Forget all Limit:* resources that have not
                           not been used in the last 7 days.
    -preemptrules       -- Forget all preemption rules.
    -q
    -s
    -set      <setName> -- Forget a set.
    -silent             -- Do not print count of forgotten nodes.
    -sleeping           -- Forget all nodes with status SLEEPING
                           (they appear in black in the GUI).
    -subdirs  <dirname> -- Forget jobs in a directory and all subdirs.
    -v                  -- Increase verbosity.

EXAMPLES:
    % vovforget aa bb cc              -- Forget files by name.
    % vovforget 00023456              -- Forget objects by id.
    % vovforget -dir .                -- Forget jobs in current dir.
    % vovforget -subdirs .            -- Forget jobs in current dir
                                         and all subdirs.
    % vovforget -allnodes
    % vovforget -blocking
    % vovforget -allemptysets        -- All empty sets, for all users.
    % vovforget -emptysets           -- My empty sets
    % vovforget -emptysets -age 10s  -- My empty sets older than 10s

    % vovforget -hier -set FrontEnd
    % vovforget -hier -elements FrontEnd

SEE ALSO:
    vsz                       -- To forget isolated nodes.
    vovset forget <set>       -- To forget sets.

To forget specific files or jobs, give either the name of a file or the VovId of a job as an argument.

% vovforget fileAA
% vovforget 00012345 00023456

To forget all elements in a set, use the -elements option.

% vovforget -elements "failed:jobs"

To forget all jobs in a directory, use the -dir option.

% vovforget -dir .

To forget all jobs in a directory and all of its subdirectories, use the -subdirs option.

% vovforget -subdirs .

To forget all blocking files, use:

% vovforget -blocking