Difference between revisions of "Mosq"

Latest revision as of 22:51, 4 February 2008

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