.\" $HeadURL$ $LastChangedRevision$
.\" vim: filetype=nroff
.\"
.TH JSS 1 "ADE_APP_TOKEN_RELEASE_DATE_MAN"
.SH NAME
jss \- submit job to job scheduler daemon
.br
.ne 5
.SH SYNOPSIS
.B jss
\*[ade_standard_synopsis_component]
[
.B \-r
.I res\fB:\fIqty\fR[\fB,...\fR]
]
[
.B \-n
.I job\-name
]
.I command
.br
.ne 5
.SH DESCRIPTION
.B Jss
is used to submit a request to
.B jsd\fR(1) 
to execute 
.I command\fR.
.br
.ne 5
.SH CONFIGURATION
None
.br
.ne 5
.SH OPTIONS
\*[ade_standard_options_component]
.TP
.B \-r \fIres\fB:\fIqty\fR[\fB,...\fR]
Specifies the resources and the quantities of each of them that
.I command
will consume.
.I res
must adhere to the usual definition of a word; 
.I qty 
must be an integer.
It is an error for the list of resources to differ from that 
specified on
.B jsd\fR(1)'s
command line.
It is an error for the quantity of any resource to
exceed the quantity of that resource that was specified on
.B jsd\fR(1)'s
command line. 
.TP
.B \-n \fIjob\-name\fR
Sets the job name; defaults to 
.B unset.
.br
.ne 5
.SH EXIT STATUS
On success
.B jss
returns zero. On failure it returns non-zero and displays a diagnostic
message.
.br
.ne 5
.SH FILES
None.
.br
.ne 5
.SH ENVIRONMENT VARIABLES
.TP 25
.B JS_NAME\fR or \fBLOGNAME
If
.B JS_NAME
is set then it is used to set the name of the instance of
.B jsd\fR(1)
with which to communicate.
If that is not set then
.B LOGNAME
is used instead.
If that is also not set then an error occurs.
.br
.ne 5
.SH EXAMPLES
This command submits a job that uses some standard resources:
.IP
.nf
.fam C
.B jss --resources=mem:2048,cpu:4 \(rs
.B \ \ \ \ \(dqmake -j 4 kernel\(dq
.fam T
.fi
.PP
This command manages some considerably less standard resources:
.IP
.nf
.fam C
.B SUBJECT=\(dqplease make coffee and kill sleep when done\(dq
.B jss --resources=alexis:1,suzie:0,peter:0,jane:0 \(dqsh -c \(rs\(dq\(rs
.B \ \ \ \ mailx -s \(rs\(rs\(rs\(dq$SUBJECT\(rs\(rs\(rs\(dq alexis < /dev/null; \(rs
.B \ \ \ \ sleep 100000; \(rs
.B \(rs\(dq\(dq
.fam T
.fi
.br
.ne 5
.SH CAVEATS
.B Jss
has no understanding of resource types; it simply
submits a list of the quantity of each resource that it expects
to consume.
.PP
The quantity of each resource that a job is expected to consume
must be determined the person who runs
.B jss\fR.
See also the
.B CAVEATS
section of
.B jsd\fR(1).
.PP
Jobs must be single commands. If you need to run multiple commands then, as in the 
example above, enclose them as arguments to the single command
.B sh -c '...'
(see 
.B sh\fR(1)).
.br
.ne 5
.SH STANDARDS
This manual page documents version ADE_APP_TOKEN_RELEASE_ID of
.B jss\fR.
.br
.ne 5
.SH SEE ALSO
js-config(1), jsc(1), jsd(1), jsq(1)
.br
.ne 5
.SH AUTHOR
ADE_APP_TOKEN_AUTHOR_NAME <ADE_APP_TOKEN_AUTHOR_EMAIL>
.br
.ne 5
.SH COPYRIGHT & DISTRIBUTION POLICY
Copyright (C) 2015-ADE_APP_TOKEN_RELEASE_YEAR ADE_APP_TOKEN_AUTHOR_NAME
\*[ade_standard_copyright_component]