pbs_checkpointjob man page
pbs_checkpointjob — checkpoint a pbs batch job
int pbs_checkpointjob(int connect, char *job_id, char *extend)
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 connect 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, job_id, identifies which job is to be checkpointed, it is specified in the form: sequence_number.server
The argument, extend, is reserved for implementation defined extensions.
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.