.\" $HeadURL$ $LastChangedRevision$
.\"
.pso ade-config --format=man
.so \*[ade_include_prefix]/ade.man
.pso js-config --format=man
.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 \-l 
.I file
|
.B \-\-lockfile=\fIfile\fR
]
[
.B \-r
.I resource\fB:\fIamount\fR[\fB,...\fR]
|
.B \-\-resources=\fIresource\fB:\fIamount\fR[\fB,...\fR]
]
.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 \-l \fIfile\fR, \fB\-\-lockfile=\fIfile
Sets the location of
.B jsd\fR(1)'s
lockfile. See also
.B ENVIRONMENT 
below.
.TP
.B \-r \fIresource\fB:\fIamount\fR[\fB,...\fR], \fB\-\-resources=\fIresource\fB:\fIamount\fR[\fB,...\fR]
Specifies the resources and the amounts of each of them that
.I command
will consume.
.I resource
must adhere to the usual definition of a word; 
.I amount 
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 amount of any resource to
exceed the amount of that resource that was specified on
.B jsd\fR(1)'s
command line. 
.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
.TP
.B /tmp/jsd-\fIusername\fB.lock
.B Jsd\fR(1)'s
lockfile. 
.B jss
uses it to determine how to communicate with the daemon.
.br
.ne 5
.SH ENVIRONMENT VARIABLES
.TP 25
.B JSD_LOCKFILE
May be set to overrule the default lockfile location (see 
.B FILES
above).
.br
.ne 5
.SH EXAMPLES
This command submits a job that uses some standard resources:
.IP
.nf
.fam C
.B jsd --resources=ram:2048,cores:4,fsfree:102400000 \(dqmake -j 4 kernel\(dq
.fam T
.fi
.PP
This command manages some considerably less standard resources:
.IP
.nf
.fam C
.B jsd --resources=alexis:1,suzie:0,peter:0,jane:0 \(dqsh -c \(rs\(dqmailx -s \(rs\(rs\(rs\(dqplease make coffee and kill sleep when done\(rs\(rs\(rs\(dq alexis < /dev/null; sleep 100000\(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 amount of each resource that it expects
to consume.
.PP
The amount 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 jss\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), 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]