pbs_rerunjob(3B)

πŸ“¦ version 6.1.3, in epel 9, nixos 26.05, nixpkgs unstable

πŸ’… pbs_rerunjob β€” the 3B girlies' guide ✨

okay so real talk, this is a page from the 3B section of the PBS manual β€” the library-call zone β€” and honestly? she's a lil legend. let's get into it 🫢


🌸 NAME 🌸

pbs_rerunjob β€” literally just reruns a pbs batch job. that's the whole vibe. πŸ’«


✨ SYNOPSIS ✨

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

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

like, copy it exactly bestie, the compiler does NOT play πŸ’€


πŸŽ€ DESCRIPTION πŸŽ€

so what she does is issue a batch request to rerun a batch job β€” that's it, that's the job 😌

she generates a Rerun Job batch request and sends it off to the server over the connection you spec'd in connect β€” which, and this is important, is the return value of pbs_connect(). don't be out here making up your own connection number, i'm begging πŸ™ˆ

now, plot twist: if the job is marked as being not rerunable, the request will fail and an error will be returned. she said no and she meant it πŸ’…

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

sequence_number.server

king behavior honestly. sequence_number.server β€” that's the shape, don't fight it πŸ‘‘

the parameter extend is reserved for implementation defined extensions. as of TORQUE 2.2, the string RERUNFORCE may be used to force a rerun if the mini-server fails.

⚠️ this is dangerous. do not use it. i'm so serious rn 😭 like genuinely β€” dangerous, do not use it, that's not me being dramatic that's the page. RERUNFORCE is giving "i'll just force it" and then your whole day is ruined πŸ’€

πŸ¦‹ SEE ALSO πŸ¦‹

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

go read those too, iykyk πŸ“šβœ¨


πŸ’– DIAGNOSTICS πŸ’–

when the batch request generated by the pbs_rerunjob() function has been completed successfully by a batch server, the routine will return 0 (zero). slay. πŸŽ‰

otherwise? a non zero error is returned πŸ˜” and β€” key detail β€” the error number is also set in pbs_errno. so check that girl, she's telling you what went wrong πŸ’…


and that's the whole page babes 🌈 source/version: Local, and it's the 3B manual, page pbs_rerunjob(3B) β€” no date on this one, don't come for me πŸ™ˆ mwah, go rerun something πŸ“πŸ’œ

πŸ“¦ where this page comes from