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
       <http://slurm.schedmd.com/>.

       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)