gm-jobs(8)

💖 gm-jobs(8) — the NorduGrid Toolkit girlie 💖

okay bestie, so this is gm-jobs, and it lives in the NorduGrid Toolkit section 8 of the manual (that's the admin/system commands girlies, very demure, very powerful ✨). She's your little window into what A-REX is doing, and she can also do a couple of things. Slay.

---

🌸 NAME 🌸

gm-jobs — shows you info about the jobs your ARC middleware is currently handling, and also manages them a lil bit 💅

---

🦋 DESCRIPTION 🦋

So gm-jobs displays information related to jobs handled by the locally running ARC middleware service A-REX. Not some other machine, not some remote vibe — locally. ✨

You can pick which flavour of info you want with the various options. This utility can also do some simple management operations — right now that's cancelling processing of specific jobs and removing them. That's it, that's the whole management arc, and honestly? Iconic. Keep it simple. 🎀

The default behavior is to print minimal information about all jobs currently handled by A-REX, plus some statistics. So if you just run her with no options, she's already giving you the group-chat recap. No cap. 🌈

---

⭐ SYNOPSIS ⭐

gm-jobs [OPTION...]

---

💅 OPTIONS 💅

• -h, --help — shows help for the available options. The "wait what does this do again" button 🫶
• -l, --longlist — displays more information about each job. She's giving detail, she's giving lore, she's giving the long version 💖
• -c, --conffile=file — use the specified configuration file. Pick your own file, be fancy.
• -d, --controldir=dir — read information from the specified control directory. Point her at your dir and she'll look there instead 🔍
• -s, --showshares — print a summary of jobs in each transfer share. For input (preparing) and output (finishing) files, it shows the number of files being copied and the number queued, per transfer share. That's the transfer-share tea ☕✨
• -J, --notshowjobs — do not print the list of jobs (which is printed by default). Sometimes you just don't wanna see them, and that's valid 💜
• -S, --notshowstates — do not print the number of jobs in each state (which is printed by default). The state-count girlies are getting benched this round.
• -w, --showservice — print the state of the service. Vibe check on the whole service, fr 🩺
• -f, --filteruser=dn — show only jobs of the user(s) with the specified subject name(s). Feed her a dn (that's a subject name) and she'll filter down to just them.
• -k, --killjob=id — request to cancel job(s) with the specified ID(s). 🗡️ bye bestie
• -K, --killuser=dn — request to cancel jobs belonging to user(s) with the specified subject name(s). Every job that user has? Cancelled. Mass unsubscribe energy.
• -r, --remjob=id — request to clean job(s) with the specified ID(s). 🧹 swept, gone, cleared
• -R, --remuser=dn — request to clean jobs belonging to user(s) with the specified subject name(s). The whole user's pile, tidied.
• -j, --filterjob=id — show only jobs with the specified ID(s). One job, one spotlight, main character energy 👑
• -e, --listdelegs — print the list of available delegation IDs. The delegation ID roster, assembled 🎀
• -E, --showdeleg=id — print the delegation token of the specified ID(s). Hand her an id, she hands you the token 🔑

lowkey reminder bestie: the -k/-K and -r/-R ones are requests to cancel and clean jobs, so please aim them on purpose, not by accident 😭

---

🧚 AUTHOR 🧚

Aleksandr Konstantinov <aleksandr dot konstantinov at fys dot uio dot no> — thank you for this icon, we are obsessed 🫶💖

---

and that's the whole page, bestie! written for <strong>NorduGrid 7.2.0</strong>, dated <strong>2013-01-30</strong> — vintage but still serving 💅✨ go check your jobs, filter by user, and slay responsibly 🎀🦋🌸