Provided by: coop-computing-tools_9.9-2ubuntu3_amd64 bug


       work_queue_status - display status of currently running Work Queue applications.


       work_queue_status [options] [manager] [port]


       work_queue_status  displays the status of currently running Work Queue applications.  When
       run with no options, it queries the global catalog server to list  the  currently  running
       Work  Queue  managers.  When given an address and a port, it queries a manager directly to
       obtain more detailed information about tasks and workers.

       •   Hostname and port number of the application.

       •   Number of waiting tasks.

       •   Number of completed tasks.

       •   Number of connected workers.

       •   Number of tasks currently being executed.

       •   Timestamp of when there was last communication with the application.


        --where <expr>
               Show only Work Queue managers matching this expression.

        -Q, --statistics
              Show summary information about queues. (default)

        -M, --project-name=<name>
              Filter results of -Q for managers matching <name>.

        -W, --workers
              Show details of all workers connected to the manager.

        -T, --tasks
              Show details of all tasks in the queue.

        -A, --able-workers
              List categories of the given manager, size of largest task, and  workers  that  can
              run it.

        -R, --resources
              Show available resources for each manager.

              Show resource capacities for each manager.

        -l, --verbose
              Long output.

       -C, --catalog=<catalog>
              Set catalog server to <catalog>. Format: HOSTNAME:PORT

       -d, --debug=<flag>
              Enable debugging for the given subsystem. Try -d all as a start.

       -t, --timeout=<time>
              RPC timeout (default=300s).

       -o, --debug-file=<file>
              Send debugging to this file. (can also be :stderr, or :stdout)

       -O, --debug-rotate-max=<bytes>
              Rotate debug file once it reaches this size.

        -v, --version
              Show work_queue_status version.

        -h, --help
              Show this help message.


       Without  arguments,  work_queue_status  shows  a  summary of all of the projects currently
       reporting to the default catalog server. Waiting, running, and complete columns  refer  to
       number of tasks:

               $ work_queue_status
               PROJECT            HOST                   PORT WAITING RUNNING COMPLETE WORKERS
               shrimp        9001     963      37        2      33
               crustacea        9000       0    2310    32084     700

       With the -R option, a summary of the resources available to each manager is shown:

               $ work_queue_status -R
               MANAGER                         CORES      MEMORY          DISK
               shrimp                         228        279300          932512
               crustacea                      4200       4136784         9049985

       With  the  --capacity  option,  a  summary  of the resource capacities for each manager is

               $ work_queue_status --capacity
               MANAGER                         TASKS      CORES      MEMORY          DISK
               refine                         ???        ???        ???             ???
               shrimp                         99120      99120      781362960       1307691584
               crustacea                      318911     318911     326564864       326564864

       Use the -W option to list the workers connected to a particular  manager.   Completed  and
       running columns refer to numbers of tasks:

               $ work_queue_status -W 9001
               HOST                     ADDRESS          COMPLETED RUNNING         0 4
         0 0         4 4
            4 4
               cclvm03.virtual.crc.nd.e         0 0

       With the -T option, a list of all the tasks submitted to the queue is shown:

               $ work_queue_status -T 9001
               ID       STATE    PRIORITY HOST                     COMMAND
               1000     WAITING         0 ???                      ./rmapper-cs -M fast -M 50bp 1
               999      WAITING         0 ???                      ./rmapper-cs -M fast -M 50bp 1
               21       running         0     ./rmapper-cs -M fast -M 50bp 3
               20       running         0     ./rmapper-cs -M fast -M 50bp 2
               19       running         0     ./rmapper-cs -M fast -M 50bp 2
               18       running         0     ./rmapper-cs -M fast -M 50bp 2

       The -A option shows a summary of the resources observed per task category.

               $ work_queue_status -T 9001
               analysis            216        784           54          4      ~1011      ~3502
               merge                20         92           30         ~1      ~4021      21318
               default               1         25           54         >1       ~503       >243

       With the -A option:

       •   Running and waiting correspond to number of tasks in the category.

       •   Fit-workers  shows the number of connected workers able to run the largest task in the

       •   max-cores, max-memory, and max-disk  show  the  corresponding  largest  value  in  the

           The value may have the following prefixes:

       •   No prefix. The maximum value was manually specified.

       •   ~ All the task have run with at most this quantity of resources.

       •   >  There  is at least one task that has used more than this quantity of resources, but
           the maximum remains unknown.

           Finally, the -l option shows statistics of the queue in a JSON object:

               $ work_queue_status -l 9001


       On success, returns zero.  On failure, returns non-zero.


       The Cooperative Computing Tools are Copyright (C) 2005-2019 The University of Notre  Dame.
       This  software  is distributed under the GNU General Public License.  See the file COPYING
       for details.


Cooperative Computing Tools DocumentationWork Queue User Manualwork_queue_worker(1)            work_queue_status(1)             work_queue_factory(1)
           condor_submit_workers(1) sge_submit_workers(1) torque_submit_workers(1)