pbs_locjob(3B)

💅 pbs_locjob(3B) — PBS Professional, bestie ✨

🌸 NAME 🌸

pbs_locjob — return current location of a PBS batch job. No cap, that's literally the whole mission. 🫶

✨ SYNOPSIS ✨

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

char *pbs_locjob(int connect, char *jobID, char *extend)

💖 DESCRIPTION 💖

Okay so this function issues a batch request to locate a batch job or job array. It's giving "where is that job at?" energy. 🔥

It generates a Locate Job (8) batch request and sends it to the server over the connection specified by connect.

If the server currently manages the batch job, or knows which server does currently manage the job, the server returns the location of the job. Iconic behavior, honestly. 👑

🎀 ARGUMENTS 🎀

• connect — Return value of pbs_connect(). Specifies connection over which to send batch request to server. It's the little communication line you already set up, bestie. 💌
• jobID — ID of job to be located. Format for a job:

<sequence number>.<server name>

Format for a job array:

<sequence number>[].<server name>

• extend — Character string for extensions to command. Not currently used. It's just chilling there for now. 🧚

🧼 CLEANUP 🧼

The character string returned by pbs_locjob() is allocated by pbs_locjob(). You must free it via a call to free(). Do not forget, babe — that's a memory leak waiting to happen. 😭💀

🔥 RETURN VALUE 🔥

On success, returns a pointer to a character string containing current location. Format:

<server name>

On failure, returns a null pointer, and the error number is available in the global integer pbs_errno. So if it flops, check pbs_errno, okay? 🫶

👀 SEE ALSO 👀

• pbs_connect(3B) — your connection bestie 💖

xoxo, from Local 🌈 — dated 15 November 2019 — pbs_locjob(3B) out, slay 💅✨