'\" t
.\"     Title: globus-job-status
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\"      Date: 03/18/2010
.\"    Manual: GRAM5 Commands
.\"    Source: University of Chicago
.\"  Language: English
.\"
.TH "GLOBUS\-JOB\-STATUS" "1" "03/18/2010" "University of Chicago" "GRAM5 Commands"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
globus-job-status \- Check the status of a GRAM5 job
.SH "SYNOPSIS"
.HP \w'\fBglobus\-job\-status\fR\ 'u
\fBglobus\-job\-status\fR \fIJOBID\fR
.HP \w'\fBglobus\-job\-status\fR\ 'u
\fBglobus\-job\-status\fR [\-help] [\-usage] [\-version] [\-versions]
.SH "DESCRIPTION"
.PP
The
\fBglobus\-job\-status\fR
program checks the status of a GRAM job by sending a status request to the job manager contact for that job specifed by the
\fIJOBID\fR
parameter\&. If successful, it will print the job status to standard output\&. The states supported by
\fBglobus\-job\-status\fR
are:
.PP
PENDING
.RS 4
The job has been submitted to the LRM but has not yet begun execution\&.
.RE
.PP
ACTIVE
.RS 4
The job has begun execution\&.
.RE
.PP
FAILED
.RS 4
The job has failed\&.
.RE
.PP
SUSPENDED
.RS 4
The job is currently suspended by the LRM\&.
.RE
.PP
DONE
.RS 4
The job has completed\&.
.RE
.PP
UNSUBMITTED
.RS 4
The job has been accepted by GRAM, but not yet submitted to the LRM\&.
.RE
.PP
STAGE_IN
.RS 4
The job has been accepted by GRAM and is currently staging files prior to being submitted to the LRM\&.
.RE
.PP
STAGE_OUT
.RS 4
The job has completed execution and is currently staging files from the service node to other http, GASS, or GridFTP servers\&.
.RE
.SH "OPTIONS"
.PP
The full set of options to
\fBglobus\-job\-status\fR
are:
.PP
\fB\-help\fR, \fB\-usage\fR
.RS 4
Display a help message to standard error and exit\&.
.RE
.PP
\fB\-version\fR
.RS 4
Display the software version of the
\fBglobus\-job\-status\fR
program to standard output\&.
.RE
.PP
\fB\-versions\fR
.RS 4
Display the software version of the
\fBglobus\-job\-status\fR
program including DiRT information to standard output\&.
.RE
.SH "ENVIRONMENT"
.PP
If the following variables affect the execution of
\fBglobus\-job\-status\fR\&.
.PP
X509_USER_PROXY
.RS 4
Path to proxy credential\&.
.RE
.PP
X509_CERT_DIR
.RS 4
Path to trusted certificate directory\&.
.RE
.SH "BUGS"
.PP
The
\fBglobus\-job\-status\fR
program can not distinguish between the case of the job manager terminating for any reason and the job being in the
DONE
state\&.
.SH "SEE ALSO"
.PP

\fBglobusrun\fR(1)