qmsg(1B)

💌 NAME

qmsg(1B) — send message to pbs batch jobs. yes bestie, this is the PBS manual page, and she’s here to help you drop an informative little message into a job’s output files without breaking a sweat. 🫶💖

✨ SYNOPSIS

qmsg [-E] [-O] message_string job_identifier ...

🦋 DESCRIPTION

okay so sending a message to a job literally means writing a message string into one or more of that job’s output files. usually you do it to leave an informative message in the job’s output. cute, right? 💅

here’s the important part: qmsg writes messages into the files of jobs by sending a Message Job batch request to the batch server that owns the job. it does not directly write the message into the files of the job. so she’s lowkey the messenger, not the pen — periodt. ✨

💅 OPTIONS

• -E — says write the message to the standard error of each job. one message, every job’s stderr, got it. 💌
• -O — says write the message to the standard output of each job. same vibe, but stdout this time. 🎀

if you don’t pick -E or -O, the message goes to the standard error of the job by default. no cap, that’s the fallback. 🙈

🎀 OPERANDS

• the first operand, message_string, is the message you want to write. if the string contains blanks, you must quote it — yes, bestie, quotes are not optional there. 🫶
• if the final character of the string is not a newline, a newline character gets added when it’s written to the job’s file. so she adds the line break for you. 💖
• all the following operands are job_identifiers that specify the jobs receiving the message string. qmsg accepts one or more job_identifier operands of this exact form:

sequence_number[.server_name][@server]

😭 STANDARD ERROR

if something goes wrong, qmsg writes a diagnostic message to standard error for each error occurrence. every oopsie gets its own diagnostic, okay? 💀

🦋 EXIT STATUS

• if all the operands presented to qmsg are processed successfully, the exit status is zero. slay. ✅
• if qmsg fails to process any operand, she exits with a value greater than zero. not slay, but very clear. 😭

👑 SEE ALSO

qsub(1B), pbs_msgjob(3B) — go read those too, bestie. iykyk. 📚✨

okay bye bestie — this page is signed off with source/version Local and title qmsg(1B); the footer doesn’t list a date, so that’s the whole tea. 💖💅🎀