pbs_locjob(3B)

🌸 NAME — pbs_locjob(3B) from the PBS manual 🌸

pbs_locjob — locate current location of a pbs batch job. periodt, that's the name vibe bestie 💖

✨ SYNOPSIS ✨

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

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

🦋 DESCRIPTION 🦋

okay so pbs_locjob() issues a batch request to locate a batch job. If the server currently manages the batch job, or knows which server does currently manage the job, it will reply with the location of the job. no cap, that's the whole locate-job moment 🔥

A Locate Job batch request is generated and sent to the server over the connection specified by connect, which is the return value of pbs_connect(). like, that's the connection handshake bestie 🫶

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

sequence_number.server

The argument extend is reserved for implementation defined extensions. It is not currently used by this function. so rn it's just vibing in the signature 🙈

The return value is a pointer to a character sting — yes the page says "sting", iconic typo behavior 😭 — which contains the current location if known. The syntax of the location string is:

queue@server_name

If the location of the job is not known, the return value is the NULL pointer. literally the NULL pointer, not a maybe 😤

👑 SEE ALSO 👑

• qsub(1B)
• pbs_connect(3B)

💀 DIAGNOSTICS 💀

When the batch request generated by the pbs_locjob() function has been completed successfully by a batch server, the routine will return a non null pointer to the destination. Otherwise, a null pointer is returned. The error number is set in pbs_errno. fr fr, that's the diagnostics tea 🍓

mwah 💋 source/version footer check: Local and pbs_locjob(3B) — no date listed, so we're not inventing one 🙈