pbs_holdjob(3B)

okay bestie, this is the pbs_holdjob(3B) page from PBS — the one that teaches you how to put a hold on a batch job, no cap. 💅✨

🌸 NAME 🌸

pbs_holdjob — place a hold on a pbs batch job

✨ SYNOPSIS ✨

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

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

💖 DESCRIPTION 💖

It issues a batch request to place a hold upon a job. Like, it's giving “pause that job” energy. 🫶

A Hold Job batch request is generated and sent to the server over the connection specified by connect, which is the return value of pbs_connect(). Yes, that connect — the one from pbs_connect(). 🔥

The argument job_id identifies which job is to be held, and it is specified in the form: sequence_number.server.

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

🎀 hold_type values, defined in pbs_ifl.h 🎀

• #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 applied. default behavior slay 💅

The parameter extend is reserved for implementation defined extensions. that's it, that's the whole extend situation 🎀

👀 SEE ALSO 👀

go read qhold(1B), pbs_connect(3B), pbs_alterjob(3B), and pbs_rlsjob(3B) — bestie homework, iykyk 📚✨

💀 DIAGNOSTICS 💀

When the batch request generated by pbs_holdjob () function has been completed successfully by a batch server, the routine will return 0 (zero). Otherwise, a non zero error is returned. The error number is also set in pbs_errno. so if it's not 0, check pbs_errno, fr fr 😭

okay that's the whole page, bestie! footer check: source/version is Local, manual is pbs_holdjob(3B), and this footer has no date, so no invented date from me. byeee 🫶💅