pbs_rlsjob(3B)

💖 pbs_rlsjob: release a hold on a pbs batch job 💖

okay so bestie, welcome to the pbs_rlsjob(3B) page from the PBS crew 🌈. This is the function that releases a hold on a pbs batch job, and it is literally giving “unlock the job” energy. Let’s get into it 💅.

🌸 NAME 🌸

pbs_rlsjob — release a hold on a pbs batch job. periodt 🫶

✨ SYNOPSIS ✨

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

int pbs_rlsjob(int connect, char *job_id, char *hold_type, char *extend)

🎀 DESCRIPTION 🎀

okay so the whole vibe is: you issue a batch request to release a hold from a job 🦋.

A Release 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 argument job_id identifies the job from which the hold is to be released, and it is specified in the form sequence_number.server 🎀.

The parameter hold_type contains the type of hold to be released. The possible values are defined in pbs_ifl.h as:

• #define USER_HOLD "u" — available to the owner of the job, the batch operator, and the batch administrator 👑
• #define OTHER_HOLD "o" — available to the batch operator and the batch administrator ✨
• #define SYSTEM_HOLD "s" — available only to the batch administrator 🔐

If hold_type is either a null pointer or points to a null string, USER_HOLD will be released 🫶.

The parameter extend is reserved for implementation defined extensions 💜.

🦋 SEE ALSO 🦋

Go check out qrls(1B), qhold(1B), qalter(1B), pbs_alterjob(3B), pbs_connect(3B), and pbs_holdjob(3B) — iykyk ✨.

💀 DIAGNOSTICS 💀

When the batch request generated by the pbs_rlsjob() function has been completed successfully by a batch server, the routine will return 0 (zero) — slay 💅. Otherwise, a non zero error is returned. The error number is also set in pbs_errno 😭.

Signed off from the Local corner of PBS — source/version vibes: Local, PBS; page: pbs_rlsjob(3B); date: not printed in the original, so that’s a mystery bestie 🎀💜