vovshow

vovshow: Usage Message

DESCRIPTION:
    Show various types of objects in a VOV project,
    as well as documentation.

USAGE:
    % vovshow [OPTIONS]

OPTIONS:
    -h                  -- This help
    -v                  -- Increase verbosity
    -w                  -- Wide output

  Files:
    -missing            -- Show missing files
    -blocking           -- Show blocking files

  Jobs:
    -running            -- Show running jobs
    -scheduledjobs      -- Jobs that are scheduled to be run
    -recentjobs         -- Jobs that have recently completed
    -failed             -- Show failed jobs
    -sleeping           -- Show sleeping jobs
    -O format           -- Specify a format string for jobs

  Project:
    -alerts             -- Show current alerts
    -buckets            -- Show job queue buckets (see also -jetstreams)
    -clients [type:rx]  -- Show server's clients
    -emptysets          -- Show empty sets
    -fairshare          -- Show basic fairshare information
    -fsgroups           -- Same as -fairshare
    -groups             -- Same as -fairshare
    -innerlooptimers    -- Show info about inner loop timers
    -jetstreams         -- Show info about buckets and jetstreams
    -licenses           -- Show the licenses used by vovserver
    -mmchunks           -- Show info about memory allocation
    -parameters         -- Same as -policy
    -policy             -- Show all policy settings
    -project            -- Show project info
    -queries            -- Show all active queries
    -resources          -- Show resource maps
    -reservations [type] -- Show reservations, type can be tasker,
                              resourcemap, or emulator
    -retraces           -- Show retrace requests
    -serverenv          -- Show environment variables used by vovserver
    -taskers            -- Show taskers using 'vovtaskermgr show'
    -users              -- Show users
    -waitreasons        -- Show wait reasons

  License based Resources:
    -byjobusage LICENSE -- Show license resource usage by job, assumes Type 'License'

  Documentation: (search strings are case sensitive)
    -api                -- Show usage info about VTK and TCL API
    -envvars ES         -- VOV environment variables containing ES
    -failcodes          -- Show the know failure codes for jobs
    -fields             -- Show known fields
    -fieldshtml         -- Show known fields in formatted html
    -prop PS            -- VOV properties containing PS

  OPTIONS FOR Monitor:
    -accounts           -- Show default accounts table
                           which is managed by ftlm_lmproject and
                           ftlm_accounts setlive
    -expirations        -- Show features and expirations
    -features           -- Show features
    -licdaemons         -- Show license daemons

  OPTIONS FOR Allocator:
    -la                 -- Show LA summary
    -lares <RESOURCE>   -- Show detail for specified resource

  OPTIONS FOR Accelerator:
    -preemptrules       -- Show all preemption rules
    -preemptmethods     -- Show all known preemption methods



EXAMPLES:
    % vovshow -running
    % vovshow -w -running
    % vovshow -emptysets -blocking
    % vovshow -envvars NC
    % vovshow -prop PREEMPT
    % vovshow -retraces
    % vovshow -w -retraces

    % vovshow -features -tag SNPS
    % vovshow -licdaemons
    % vovshow -clients 'nickname:.*d$';  # clients where nickname

    % vovshow -api vtk_s;                # List all procs that
    % vovshow -api vtk_set_get_elements; # Show usage of


    % vovshow -la queued
    % vovshow -lares License:abc

SEE ALSO THESE COMMANDS THAT SHOW INFORMATION:
    vovjobqueue,      vovset list,   vovfind,
    vel,              voveventmon,   vovshowconnection,
    vovproject list,
    vovtaskermgr show
    vsi, vls, vst,
    vovdoc

% vovshow -running
% vovshow -w -running
% vovshow -emptysets -blocking
% vovshow -envvars NC
% vovshow -prop PREEMPT
% vovshow -retraces
% vovshow -w -retraces

% vovshow -features -tag SNPS
% vovshow -licdaemons
% vovshow -clients 'nickname:.*d$';     # clients where nickname ends in 'd'

% vovshow -api vtk_s;                   # List all procs that begin with vtk_s
% vovshow -api vtk_set_get_elements;    # Show usage of vtk_set_get_elements

% vovshow -la queued
% vovshow -lares License:abc

In a FlowTracer context, the most useful commands are those that show the missing files:

% vovshow -missing
% vovshow -blocking

and those showing jobs in various status:

% vovshow -running
% vovshow -failed
% vovshow -recentjobs