You are here

jqueue

Name
jqueue  - display information about outstanding jasmine read and write jobs.

Syntax  
jqueue search-key search-value [all | field1 field2 ...]

Description
Display the status of queued jasmine jobs (i.e. ones that have not transitioned into state Done, Cancelled, or Failed).  You select the set of jobs to return by specifying a search key and a corresponding search value.  You can also specify a set of fields to display, or simply accept the default set.

Search Key & Display Fields
The following labels can be used for specifying a search key as well as indicating the fields to display in the result.  For display fields you can also specify all to show all details.

user
     The user who owns a job

request
     The request identifier associated with a job

job
     The job's unique identifier

vs
    The name of the volume set that the stub file belongs to

type
    The job type: either jput or jget

stub
    The full /mss stub path associated with the job

path
    The client path of the file (output file for jget, input file for jput)

netpath
    The canonical network filesystem location associated with path

host
    The machine from which the client request originated

port
    The machine from which the client request originated

mover
    The name of the data mover machine currently processing a job

volser
    The volser (volume serial number) of the tape associated with the job

submit
    The time when the job request was submitted to jasmine

jobState
    The current state of the job (one of Pending, Staging, Staged, Running)

size
    The size in bytes of the file associated with the job

bitfile
    The unique identifier of the tape file

fileOwner
    The name of the user who owns the client-side file.

creationTime
    The time when the file was created (only meaningful for queued jget jobs)

filePosition
    The tape position of the file

crc
    The CRC32 checksum of the file (only meaningful for queued jget jobs)

md5
   The MD5 checksum of the file (only meaningful for queued jget jobs)

Examples
Show user name, stub file path, and job state for jobs involving volume set "c-qweak":

jqueue vs c-qweak user stub jobState

Show default fields for jobs belonging to user "joeschmoe":

jqueue user joeshmoe all

Show default fields for request with identifier "123":

jqueue request 123

Show client host name and port, file size, and filesystem path for all jobs currently being processed by data mover host "scdm1":

jqueue mover scdm1 host port size path