vovforget

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


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:
    
    -h
    -help               -- Print this message.
    -q 
    -s
    -silent             -- Do not print count of forgotten nodes.
    -v                  -- Increase verbosity.
    
    -elements <setName> -- Forget elements in given set.
    -dir      <dirname> -- Forget jobs in a directory.
    -subdirs  <dirname> -- Forget jobs in a directory and all subdirs.
    -set      <setName> -- Forget a set.
    
    -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. 
    
    -allemptysets       -- Forget all empty sets older than 60s.
    -emptysets          -- Forget 'my' empty sets older than 60s.
    -blocking           -- Forget blocking files, i.e.
                           files with no inputs that are not VALID.
    -missing            -- Forget missing files.
    -idleusers          -- Forget users with no clients and no jobs.
    -isolated           -- Forget isolated files, i.e.
                           files with no inputs nor outputs.
    -sleeping           -- Forget all nodes with status SLEEPING
                           (they appear in black in the GUI).
    
    -alerts             -- Forget all alerts.
    -allalerts          -- Forget all alerts (same as -alerts).
    -allnodes           -- Forget all nodes.
    -allhosts           -- Forget all hosts.
    -allsets            -- Forget all sets (except System sets).
                              see also -allemptysets   and -emptysets
    -allresources       -- Forget all resource maps.
    -allreservations    -- Forget all reservations.
    -orphanreservations -- Forget all orphan reservations.
    -oldlimits          -- Forget all Limit:* resources that have not
                           not been used in the last 7 days.
    -idlelimits         -- Forget all Limit:* resources that are not
                           associated with any running or queued jobs.
    
    -preemptrules       -- Forget all preemption rules.
    
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 -hier -set FrontEnd
    % vovforget -hier -elements FrontEnd
    
SEE ALSO:
    vsz                       -- To forget isolated nodes.
    vovset forget <set>       -- To forget sets.

Examples

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