.\" $HeadURL$ $LastChangedRevision$
.\" vim: filetype=nroff
.\"
.TH JSC 1 "ADE_APP_TOKEN_RELEASE_DATE_MAN"
.SH NAME
jsc \- send command to job scheduler
.br
.ne 5
.SH SYNOPSIS
.B jsc
\*[ade_standard_synopsis_component]
.I command
.B ...
.br
.ne 5
.SH DESCRIPTION
.B Jsc
is used to control a running
.B jsd\fR(1)
process.
.br
.ne 5
.SH COMMANDS
Valid values
for 
.I command
are:
.TP 25
.B quit
.B jsd\fR(1)
quits without wait for any running jobs to complete.
.TP
.B suspend
.B jsd\fR(1)
suspends scheduling jobs, although it still manages jobs that are running, queues new jobs and responds to the other commands.
.TP
.B resume
.B jsd\fR(1)
resumes scheduling jobs.
.TP
.B ping
.B jsd\fR(1)
replies with 'pong' to indicate it is running and that two way communication is possible.
.TP
.B show\-queue\fR [ \fB\-a\fR ]
This command is used by 
.B jsq\fR(1).
It is not expected that users call 
.B jsc
with this command directly.
.TP
.B submit\-job\fI resource\fB:\fIamount\fR[\fB,...\fR] \fIcommand
This command is used by 
.B jss\fR(1).
It is not expected that users call 
.B jsc
with this command directly.
.TP
.B cancel\-job\fI job\-id
This command dequeues the specified job if it has not yet started or kills it if it has started.
.TP
.B chprio\-job\fI job\-id priority
Modify the priority of a submitted job.
Numerically higher values for
.I priority
indicate greater urgency. The default value is 
.B 0\fR.
.TP
.B chres \fIresource\fB:\fIamount\fR[\fB,...\fR]
This command changes the quantites of the resources.
It does not impact already-running jobs but will affect if/when pending jobs start running. 
It is an error for the list of names of the resources to differ from the list of names of the resources specified in the original call to
.B jsd\fR(1),
although the quantities of each resource may differ from those in the original call.
.br
.ne 5
.SH CONFIGURATION
None
.br
.ne 5
.SH OPTIONS
\*[ade_standard_options_component]
.br
.ne 5
.SH EXIT STATUS
On success
.B jsc
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
None.
.br
.ne 5
.SH CAVEATS
None.
.br
.ne 5
.SH STANDARDS
This manual page documents version ADE_APP_TOKEN_RELEASE_ID of
.B jsc\fR.
.br
.ne 5
.SH SEE ALSO
js-config(1), jsd(1), jsq(1), jss(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) 2019-ADE_APP_TOKEN_RELEASE_YEAR ADE_APP_TOKEN_AUTHOR_NAME
\*[ade_standard_copyright_component]