'\" t .\" Title: globus-job-submit .\" Author: [see the "AUTHOR" section] .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 03/31/2018 .\" Manual: Grid Community Toolkit Manual .\" Source: Grid Community Toolkit 6 .\" Language: English .\" .TH "GLOBUS\-JOB\-SUBMIT" "1" "03/31/2018" "Grid Community Toolkit 6" "Grid Community Toolkit Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "NAME" globus-job-submit \- Submit a batch job using GRAM .SH "SYNOPSIS" .sp \fBglobus\-job\-submit\fR [\-dumprsl|\-dryrun|\-verify] [\-file ARGUMENT_FILE] \fISERVICE\-CONTACT\fR [OPTIONS] \fIEXECUTABLE\fR \fIARGUMENT\&...\fR .sp \fBglobus\-job\-submit\fR [\-help | \-usage | \-version | \-versions] .SH "DESCRIPTION" .sp The \fBglobus\-job\-submit\fR program constructs a job description from its command\-line options and then submits the job to the GRAM service running at \fISERVICE_CONTACT\fR\&. The executable and arguments to the executable are provided on the command\-line after all other options\&. Note that the \fI\-dumprsl\fR, \fI\-dryrun\fR, \fI\-verify\fR, and \fI\-file\fR command\-line options must occur before the first non\-option argument, the \fISERVICE_CONTACT\fR\&. .sp The \fBglobus\-job\-submit\fR provides similar functionality to \fBglobusrun\fR in that it allows batch submission of GRAM jobs\&. However, unlike \fBglobusrun\fR, it uses command\-line parameters to define the job instead of RSL expressions\&. .sp To retrieve the output and error streams of the job, use the program \fBglobus\-job\-get\-output\fR\&. To reclaim resources used by the job by deleting cached files and job state, use the program \fBglobus\-job\-clean\fR\&. To cancel a batch job submitted by \fBglobus\-job\-submit\fR, use the program \fBglobus\-job\-cancel\fR\&. .SH "OPTIONS" .sp The full set of options to \fBglobus\-job\-submit\fR are: .PP \fB\-help, \-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\-submit\fR program to standard output\&. .RE .PP \fB\-versions\fR .RS 4 Display the software version of the \fBglobus\-job\-submit\fR program including DiRT information to standard output\&. .RE .PP \fB\-dumprsl\fR .RS 4 Translate the command\-line options to \fBglobus\-job\-submit\fR into an RSL expression that can be used with tools such as \fBglobusrun\fR\&. .RE .PP \fB\-dryrun\fR .RS 4 Submit the job request to the GRAM service with the dryrun option enabled\&. When this option is used, the GRAM service prepares to execute the job but stops before submitting the job to the LRM\&. This can be used to diagnose some problems such as missing files\&. .RE .PP \fB\-verify\fR .RS 4 Submit the job request to the GRAM service with the dryrun option enabled and then without it enabled if the dryrun is successful\&. .RE .PP \fB\-file \fR\fB\fIARGUMENT_FILE\fR\fR .RS 4 Read additional command\-line options from \fIARGUMENT_FILE\fR\&. .RE .PP \fB\-np \fR\fB\fIPROCESSES\fR\fR\fB, \-count \fR\fB\fIPROCESSES\fR\fR .RS 4 Start \fIPROCESSES\fR instances of the executable as a single job\&. .RE .PP \fB\-m \fR\fB\fIMAX_TIME\fR\fR\fB, \-maxtime \fR\fB\fIMAX_TIME\fR\fR .RS 4 Schedule the job to run for a maximum of \fIMAX_TIME\fR minutes\&. .RE .PP \fB\-p \fR\fB\fIPROJECT\fR\fR\fB, \-project \fR\fB\fIPROJECT\fR\fR .RS 4 Request that the job use the allocation \fIPROJECT\fR when submitting the job to the LRM\&. .RE .PP \fB\-q \fR\fB\fIQUEUE\fR\fR\fB, \-queue \fR\fB\fIQUEUE\fR\fR .RS 4 Request that the job be submitted to the LRM using the named \fIQUEUE\fR\&. .RE .PP \fB\-d \fR\fB\fIDIRECTORY\fR\fR\fB, \-directory \fR\fB\fIDIRECTORY\fR\fR .RS 4 Run the job in the directory named by \fIDIRECTORY\fR\&. Input and output files will be interpreted relative to this directory\&. This directory must exist on the file system on the LRM\-managed resource\&. If not specified, the job will run in the home directory of the user the job is running as\&. .RE .PP \fB\-env \fR\fB\fINAME\fR\fR\fB=\fR\fB\fIVALUE\fR\fR .RS 4 Define an environment variable named by \fINAME\fR with the value \fIVALUE\fR in the job environment\&. This option may be specified multiple times to define multiple environment variables\&. .RE .PP \fB\-stdin [\-l | \-s] \fR\fB\fISTDIN_FILE\fR\fR .RS 4 Use the file named by \fISTDIN_FILE\fR as the standard input of the job\&. If the \fI\-l\fR option is specified, then this file is interpreted to be on a file system local to the LRM\&. If the \fI\-s\fR option is specified, then this file is interpreted to be on the file system where \fBglobus\-job\-submit\fR is being executed, and the file will be staged via GASS\&. If neither is specified, the local behavior is assumed\&. .RE .PP \fB\-stdout [\-l | \-s] \fR\fB\fISTDOUT_FILE\fR\fR .RS 4 Use the file named by \fISTDOUT_FILE\fR as the destination for the standard output of the job\&. If the \fI\-l\fR option is specified, then this file is interpreted to be on a file system local to the LRM\&. If the \fI\-s\fR option is specified, then this file is interpreted to be on the file system where \fBglobus\-job\-submit\fR is being executed, and the file will be staged via GASS\&. If neither is specified, the local behavior is assumed\&. .RE .PP \fB\-stderr [\-l | \-s] \fR\fB\fISTDERR_FILE\fR\fR .RS 4 Use the file named by \fISTDERR_FILE\fR as the destination for the standard error of the job\&. If the \fI\-l\fR option is specified, then this file is interpreted to be on a file system local to the LRM\&. If the \fI\-s\fR option is specified, then this file is interpreted to be on the file system where \fBglobus\-job\-submit\fR is being executed, and the file will be staged via GASS\&. If neither is specified, the local behavior is assumed\&. .RE .PP \fB\-x \fR\fB\fIRSL_CLAUSE\fR\fR .RS 4 Add a set of custom RSL attributes described by \fIRSL_CLAUSE\fR to the job description\&. The clause must be an RSL conjunction and may contain one or more attributes\&. This can be used to include attributes which can not be defined by other command\-line options of \fBglobus\-job\-submit\fR\&. .RE .PP \fB\-l\fR .RS 4 When included outside the context of \fI\-stdin\fR, \fI\-stdout\fR, or \fI\-stderr\fR command\-line options, \fI\-l\fR option alters the interpretation of the executable path\&. If the \fI\-l\fR option is specified, then the executable is interpreted to be on a file system local to the LRM\&. .RE .PP \fB\-s\fR .RS 4 When included outside the context of \fI\-stdin\fR, \fI\-stdout\fR, or \fI\-stderr\fR command\-line options, \fI\-l\fR option alters the interpretation of the executable path\&. If the \fI\-s\fR option is specified, then the executable is interpreted to be on the file system where \fBglobus\-job\-run\fR is being executed, and the file will be staged via GASS\&. If neither is specified, the local behavior is assumed\&. .RE .SH "ENVIRONMENT" .sp If the following variables affect the execution of \fBglobus\-job\-submit\fR\&. .PP \fBX509_USER_PROXY\fR .RS 4 Path to proxy credential\&. .RE .PP \fBX509_CERT_DIR\fR .RS 4 Path to trusted certificate directory\&. .RE .SH "SEE ALSO" .sp globusrun(1), globus\-job\-run(1), globus\-job\-clean(1), globus\-job\-get\-output(1), globus\-job\-cancel(1) .SH "AUTHOR" .sp Copyright \(co 1999\-2014 University of Chicago