pbs_checkpointjob(3B)

NAME
pbs_checkpointjob - checkpoint a pbs batch job

SYNOPSIS
#include <pbs_error.h>
#include <pbs_ifl.h>

int pbs_checkpointjob(int connect, char *job_id, char *extend)

DESCRIPTION
Issue a batch request to checkpoint a batch job.

For pbs_checkpointjob() a "Checkpoint Job" batch request is generated and sent to the server over the connection specified by which is the return value of pbs_connect(). The server will reply when the job has completed the checkpoint operation. Checkpointing is only allowed for jobs that are marked as checkpointable.

These requests requires that the issuing user have operator or administrator privilege.

The argument, identifies which job is to be checkpointed, it is specified in the form:

The argument, is reserved for implementation defined extensions.

SEE ALSO
pbs_connect(3B)

DIAGNOSTICS
When the batch request generated by the pbs_checkpointjob() functions has been completed successfully by a batch server, the routines will return 0 (zero). Otherwise, a non zero error is returned. The error number is also set in pbs_errno.