pbs_relnodesjob(3B)

pbs_relnodesjob 💅

okay bestie, welcome to the PBS Professional glow-up of pbs_relnodesjob(3B) — literally the manual page for releasing some or all of the non-primary-execution-host vnodes assigned to a PBS job. no cap, it's giving "let my vnodes go" energy. 🦋

🌸 NAME 🌸

pbs_relnodesjob — release some or all of the non-primary-execution-host vnodes assigned to a PBS job. 💖

✨ SYNOPSIS ✨

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

int pbs_relnodesjob (int connect, char *jobID, char *vnode_list,
                     char *extend)

💅 DESCRIPTION 💅

So what this actually does: it issues a batch request to release some or all of the vnodes of a batch job. 🎀

It generates a RelnodesJob (90) batch request and sends it to the server over the connection specified by connect. slay. ✨

⚠️ okay important bestie: you cannot release vnodes on the primary execution host. that's the rule. periodt. 💀

You can use this on jobs and subjobs, but not on job arrays or ranges of subjobs. iykyk. 🙈

🎀 ARGUMENTS 🎀

• connect — the return value of pbs_connect(). it specifies the connection handle over which to send the batch request to the server. 🔌
• jobID — the ID of the job or subjob whose vnodes are to be released. format for a job: <sequence number>.<server name>. format for a subjob: <sequence number>[<index>].<server name>. 💅
• vnode_list — a list of vnode names separated by plus signs ("+"). if vnode_list is a null pointer, this specifies that all the vnodes assigned to the job that are not on the primary execution host are to be released. 🫶
• extend — character string for extensions to command. not currently used. 🎀

🔥 RETURN VALLUE 🔥

The routine returns 0 (zero) on success. 👑

If an error occurred, the routine returns a non-zero exit value, and the error number is available in the global integer pbs_errno. 😭

💖 that's the tea — source/version: Local, pbs_relnodesjob(3B), dated 15 November 2019. periodt. 💖