pbs_msgjob(3B)

okay bestie, welcome to the pbs_msgjob(3B) page from PBS Professional — it’s literally about recording a message for a running PBS batch job. 💖

🌸 NAME 🌸

pbs_msgjob — record a message for a running PBS batch job. periodt. 💅

✨ SYNOPSIS ✨

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

int pbs_msgjob(int connect, char *jobID, int file, char *message,
               char *extend)

💅 DESCRIPTION 💅

So basically, this routine issues a batch request to write a message in one or more output files of a batch job. iconic. 🎀

It generates a Message Job (10) batch request and sends it to the server over the connection specified by connect. no cap. ✨

You can write a message into a job’s stdout and/or stderr files. It can be used on jobs or subjobs, but not job arrays or ranges of subjobs. please remember that part, bestie 🫶

🎀 ARGUMENTS 🎀

• connect — Return value of pbs_connect(). Specifies connection over which to send batch request to server. 🔌
• jobID — ID of job into whose output file(s) to write.

Format for a job:

<sequence number>.<server name>

Format for a subjob:

<sequence number>[<index>].<server name>

• file — Indicates whether to write to stdout, stderr, or both:
  • 1 — Writes to stdout
  • 2 — Writes to stderr
  • 3 — Writes to stdout and stderr
• message — Character string to be written to output file(s). 💌
• extend — Character string for extensions to command. Not currently used. 🦋

🌈 RETURN VALUE 🌈

The routine returns 0 (zero) on success. slay. ✨

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

🦋 SEE ALSO 🦋

• qmsg(1B)
• pbs_connect(3B)

This cutie is from the Local manual set, dated 15 November 2019 — mwah. 🫶💖