pbs_checkpointjob(3B)

✨ pbs_checkpointjob(3B) ✨

okay so bestie, this is the PBS manual page for pbs_checkpointjob, and it's literally about asking a batch job to checkpoint itself. iconic server behavior, no cap. 💅

🦋 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 💅

okay so what this does is issue a batch request to checkpoint a batch job. that's the whole vibe. ✨

For pbs_checkpointjob(), a "Checkpoint Job" batch request gets generated and sent to the server over the connection specified by connect, which is literally 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 — so if your job isn't marked that way, this is not the move. 🫶

These requests require that the issuing user have operator or administrator privilege. yes, permissions are the main character here. 👑

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

sequence_number.server

The argument extend is reserved for implementation defined extensions. so don't expect it to do a fun little extra thing unless the implementation says so, bestie. 🎀

🌸 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. so like, check pbs_errno if things go sideways, iykyk. 💀

💌 cute sign-off: this page comes from the Local source/version corner, tagged pbs_checkpointjob(3B) — and the footer doesn't list a date, so I'm not gonna invent one, periodt. 💖