NAME
slurm_suspend, slurm_resume, slurm_requeue - Slurm suspend, resume and
requeue functions
SYNTAX
#include <slurm/slurm.h>
int slurm_suspend (
uint32_t job_id
);
int slurm_resume (
uint32_t job_id
);
int slurm_requeue (
uint32_t job_id
);
ARGUMENTS
job_id SLURM job ID to perform the operation upon.
DESCRIPTION
slurm_suspend Suspend the specified job.
slurm_resume Resume execution of a previously suspended job.
slurm_requeue Requeue a running or pending SLURM batch job. The job
script will be restarted from its beginning, ignoring any previous
checkpoint.
RETURN VALUE
Zero is returned upon success. On error, -1 is returned, and the Slurm
error code is set appropriately.
ERRORS
ESLURM_DISABLED the operation is currently disabled (e.g. attempt to
suspend a job that is not running, resume a job that is not currently
suspended, or requeue a job on which the operation has been disabled).
ESLURM_INVALID_JOB_ID the requested job id does not exist.
ESLURM_ACCESS_DENIED the requesting user lacks authorization for the
requested action (e.g. not user root or SlurmUser).
ESLURM_JOB_PENDING the requested job is still pending.
ESLURM_ALREADY_DONE the requested job has already completed.
ESLURM_NOT_SUPPORTED the requested operation is not supported on this
system.
NOTE
These functions are included in the libslurm library, which must be
linked to your process for use (e.g. "cc -lslurm myprog.c").
COPYING
Copyright (C) 2005-2006 The Regents of the University of California.
Produced at Lawrence Livermore National Laboratory (cf, DISCLAIMER).
CODE-OCEC-09-009. All rights reserved.
This file is part of SLURM, a resource management program. For
details, see <https://computing.llnl.gov/linux/slurm/>.
SLURM 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.
SLURM is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
for more details.
SEE ALSO
scontrol(1)