JSC(1) General Commands Manual JSC(1)
NAME
jsc - send command to job scheduler
SYNOPSIS
jsc [ -V | --version ] [ -v | --verbose | -d level | --debug=level ] [
-h | --help ] [ -p | --paths ] [ -n | --simulate ] command ...
DESCRIPTION
Jsc is used to control a running jsd(1) process.
COMMANDS
Valid values for command are:
quit jsd(1) quits without wait for any running jobs
to complete.
suspend jsd(1) suspends scheduling jobs, although it
still manages jobs that are running, queues
new jobs and responds to the other commands.
resume jsd(1) resumes scheduling jobs.
ping jsd(1) replies with 'pong' to indicate it is
running and that two way communication is pos-
sible.
show-queue [ -a ] This command is used by jsq(1). It is not ex-
pected that users call jsc with this command
directly.
submit-job resource:amount[,...] command
This command is used by jss(1). It is not ex-
pected that users call jsc with this command
directly.
cancel-job job-id This command dequeues the specified job if it
has not yet started or kills it if it has
started.
chprio-job job-id priority
Modify the priority of a submitted job. Nu-
merically higher values for priority indicate
greater urgency. The default value is 0.
chres resource:amount[,...]
This command changes the quantites of the re-
sources. 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 jsd(1), although the quanti-
ties of each resource may differ from those in
the original call.
CONFIGURATION
None
OPTIONS
-d level, --debug=level Determines how verbose this program will be.
The message types displayed for the different
values of level are as follows: 0 displays no
messages; 1 displays only errors, 2 displays
errors and warnings; 3 displays errors, warn-
ings and informational messages; higher values
display errors, warnings, informational mes-
sages and various messages intended for debug-
ging. The default is 2.
-h, --help Displays a brief usage message.
-p, --paths Lists the compiled-in paths of various files
and directories that this program uses. -n,
--simulate Some external commands that this
program runs may be displayed rather than ac-
tually executed. BEWARE: different programs
implement different levels of simulation; so
this option may work perfectly; on the other
hand it may do nothing at all!
-v, --verbose Equivalent to -d 3.
-V, --version Prints the program's version number and exits.
EXIT STATUS
On success jsc returns zero. On failure it returns non-zero and dis-
plays a diagnostic message.
FILES
None.
ENVIRONMENT VARIABLES
JS_NAME or LOGNAME If JS_NAME is set then it is used to set the
name of the instance of jsd(1) with which to
communicate. If that is not set then LOGNAME
is used instead. If that is also not set then
an error occurs.
EXAMPLES
None.
CAVEATS
None.
STANDARDS
This manual page documents version 2 of jsc.
SEE ALSO
js-config(1), jsd(1), jsq(1), jss(1)
AUTHOR
Alexis Huxley <alexishuxley@gmail.com>
COPYRIGHT & DISTRIBUTION POLICY
Copyright (C) 2019-2024 Alexis Huxley
This program is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation; either version 2 of the License, or (at your
option) any later version.
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of MER-
CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
Public License for more details.
You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
675 Mass Ave, Cambridge, MA 02139, USA.
26 Jul 2024 JSC(1)
