Show a List of Jobs

The tool vovshow is used to show things like jobs, retrace requests, the project itself.


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
      -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
      -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
      -slaves             -- Show slaves using 'vovslavemgr show'
      -taskers            -- Show taskers using 'vovtaskermgr show'
      -users              -- Show users
      -waitreasons        -- Show wait reasons
  
    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
  
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