From MosixWiki
MOSQ(M1) MOSIX Commands MOSQ(M1)
NAME
MOSQ - MOSIX queue control
SYNOPSIS
mosq [-j] [-p] list
mosq [-j] [-p] listall
mosq [-j] [-p] locallist
mosq [-j] [-p] locallistall
mosq [-j] run {pid|jobID} [{hostname}|{IP}|{node-number}]
mosq [-j] abort {pid|jobID} [{hostname}|{IP}|{node-number}]
mosq [-j] cngpri {newpri} {pid|jobID} [{hostname}|{IP}|{node-number}]
mosq [-j] advance {pid|jobID} [{hostname}|{IP}|{node-number}]
mosq [-j] retard {pid} [{hostname}|{IP}|{node-number}]
DESCRIPTION
Mosq displays and controls the content of the job queue - e.g., jobs that
were submitted using mosrun -q.
mosq list displays an ordered table of all queued jobs: their process-ID;
user-name; memory requirement (if any); whether confined to the local
partition or allowed to use other partitions and clusters in the grid;
their priority (the lower the better); the node where they were initi-
ated; and the command line (when available).
mosq listall is similar to list, except that it also shows jobs that were
once queued and are now running. For these jobs, the PRI field shows
"RUN" instead of a priority.
mosq locallist is similar to list, but displays only jobs that were ini-
tiated on the local node. The FROM field is not shown; and unlike list,
the order of jobs in locallist (within each priority and unless affected
by the actions below), is according to the submission time of the jobs
and not their actual place in the queue.
mosq locallistall is similar to locallist, except that it also shows jobs
that were once queued and are now running.
While list and listall may be blocked when the per-partition node that is
responsible for queuing is inaccessible, locallist and locallistall can
not be blocked because they depend only on the local node.
The -p argument adds the number of parallel processes ("NPROC") to the
listing.
When the -j argument is used in conjunction with list, listall, locallist
or locallistall, the Job-ID field is included in the listing (it is
assigned by mosrun(1) using the "mosrun -J{jobID}" parameter).
The following commands operate on selected jobs from the queue: when the
-j argument is not specified, a single job is selected by its process-ID
and initiating node, but when the -j argument is specified, all jobs with
the same User-ID as the caller, and the given Job-ID and initiating node,
are selected. The initiating node can be specified as either an IP
address, a host-name, a MOSIX logical node-number, or omitted if the
job(s) were initiated from the current node.
mosq cngpri modifies the priority of the selected job(s): the lower the
[non-negative] number - the higher the priority.
mosq run force the release of the selected job(s) from the queue and
cause them to start running (regardless of the available cluster/multi-
cluster resources).
mosq abort removes the selected job(s) from the queue, normally killing
them (but job(s) that were started by "mosrun -Q", will start running
instead).
mosq advance move the selected job(s) forward in the queue, making them
the first among the queued jobs with the same priority.
mosq retard move the selected job(s) backward in the queue, making them
the last among the queued jobs with the same priority.
SYNONYMS
The following synonyms are provided for convenience and may be used
interchangeably:
locallist - listlocal
locallistall - listalllocal; listlocalall
cngpri - changepri; newpri
run - launch; release; activate
abort - cancel; kill; delete
SEE ALSO
mosrun(1), mosix(7).
MOSIX May 2006 MOSIX
Copyright © 1999-2008 Amnon Barak. All rights reserved.