pbs_geterrmsg(3B)

Okay bestie, this is pbs_geterrmsg(3B) from the PBS Professional manual — the little function that asks the server, “hey, what was that error text again?” and it’s giving helpful bestie energy. ✨

🎀 NAME 🎀

pbs_geterrmsg — get error message for most recent PBS batch operation. That’s the gig. 💅

✨ SYNOPSIS ✨

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

char *pbs_geterrmsg(int connect)

🌸 DESCRIPTION 🌸

Returns the most recent error message text associated with a batch server request. 🫶

If a preceding batch interface library call over the connection specified by connect returned an error from the server, the server may have created an associated text message. If there is a text message, this function returns a pointer to the text message. No cap: may is doing important work there. 👑

💖 ARGUMENTS 💖

• connect — Return value of pbs_connect(). Specifies the connection handle over which to request the error message from the server. It’s the handle for this lookup, bestie. 📨

🔥 RETURN VALUE 🔥

If the server returned an error and created an error text string in reply to a previous batch request, this function returns a pointer to the text string. The text string is null-terminated. Slay. ✅

If the server does not have an error text string, this function returns a null pointer. Also: the text string is a global variable; you do not need to free it. No cleanup arc required, bestie. 🎀

🦋 SEE ALSO 🦋

• pbs_connect(3B)

This page is from the Local source/version and dated 15 November 2019 — pbs_geterrmsg(3B) out. 💖✨