jobs(3)

📦 version 6.1.3, in epel 9

💖 NAME 💖

okay bestie, welcome to jobs(3) from the torque manual — the page whose whole name vibe is remembering submitted job in session. That’s it, that’s the lore: jobs = remembering submitted job in session. Periodt. 💅

✨ SYNOPSIS ✨

🧚 Data Structures 🧚

  • struct drmaa_job_s — Job data stored for each submitted job.
  • struct drmaa_job_iter_s — Iterates over submitted jobs set.

🫶 Functions 🫶

  • void drmaa_get_job_list_iter (drmaa_session_t *session, drmaa_job_iter_t *iter) — Returns iterator to jobs held in DRMAA session.
  • drmaa_job_t * drmaa_get_next_job (drmaa_job_iter_t *iter) — Returns next job identifier from set or NULL if set finished.
  • void drmaa_add_job (drmaa_session_t *c, drmaa_job_t *job) — Adds job identifier to session.
  • bool drmaa_find_job (drmaa_session_t *c, const char *jobid, drmaa_job_t *found, unsigned flags) — Checks if job with given identifier exist in hash table and optionally removes it.

💅 Detailed Description 💅

No extra deets here, bestie — the heading is literally the whole moment in this section. Nothing else is listed. Slay, moving on. ✨

🔥 Function Documentation 🔥

void drmaa_get_job_list_iter (drmaa_session_t * session, drmaa_job_iter_t * iter)

Returns iterator to jobs held in DRMAA session. Caller thread should have drmaa_session_s::jobs_mutex acquired, and the iterator remains valid until the job list is modified (or the lock is released). 🔒✨

void drmaa_add_job (drmaa_session_t * c, drmaa_job_t * job)

Adds job identifier to session. Iconic behavior, no cap.

Parameters

  • c — DRMAA session.
  • job — Malloced drmaa_job_t structure with filled jobid field (also malloced).

bool drmaa_find_job (drmaa_session_t * c, const char * jobid, drmaa_job_t * found, unsigned flags)

Checks if job with given identifier exist in hash table and optionally removes it. The way that’s giving “lookup plus optional delete” energy. 💅

Parameters

  • c — Opened DRMAA session.
  • jobid — Job identifier.
  • found — If not NULL and job was found, job session data will be stored here.
  • flags — Information to store into session. If DRMAA_JOB_DISPOSE bit is set, session data will be removed.

See also

job_flag_t

👑 Author 👑

This page is auto-generated by Doxygen for torque from the source code — no human author credited, just the robot drip. 🤖✨

💖 source: torque • version 6.1.3 • date Sat Jan 21 2023 • manual jobs(3) — mwah, that’s the whole page, bestie! 🎀

📦 where this page comes from