torque_submit_workers(1)

💖 torque_submit_workers — the girlies' guide 💖

okay so bestie, this is torque_submit_workers(1) from the Cooperative Computing Tools collection, and it is exactly the little helper you need when you want a whole squad of workers to show up to the Torque cluster party. ✨

---

🌸 NAME 🌸

torque_submit_workers — submit work_queue_worker to a Torque cluster. that's it, that's the vibe. 🫶

---

🎀 SYNOPSIS 🎀

torque_submit_workers [options] <servername> <port> <num-workers>

---

✨ DESCRIPTION ✨

so what this icon actually does: torque_submit_workers schedules the execution of work_queue_worker(1) on the Torque batch system, sliding in through its job submission interface, qsub. slay. 💅

how many workers get scheduled and run? that's literally the num-workers argument. that's its whole job. no cap.

the servername and port arguments specify the hostname and port number of the manager that work_queue_worker should connect to. 🔌

real talk though — those two arguments become optional when the auto mode option is specified for work_queue_worker. so if you're going auto, you can just… not. bestie behavior fr fr. 🙈

---

💅 OPTIONS 💅

• -M — Name of the preferred manager for worker. 👑
• -N <name> — Preferred project name for work_queue_worker to connect.
• -c <cores> — Set the number of cores each worker should use (0=auto). (default=1)
• -C <catalog> — Set catalog server for work_queue_worker to <catalog>. <catalog> format: HOSTNAME:PORT.
• -t <seconds> — Abort work_queue_worker after this amount of idle time (default=900s).
• -d <subsystem> — Enable debugging on worker for this subsystem (try -d all to start).
• -w <size> — Set TCP window size
• -i <time> — Set initial value for backoff interval when worker fails to connect to a manager. (default=1s)
• -b <time> — Set maxmimum value for backoff interval when worker fails to connect to a manager. (default=60s)
• -z <size> — Set available disk space threshold (in MB). When exceeded worker will clean up and reconnect. (default=100MB)
• -A <arch> — Set architecture string for the worker to report to manager instead of the value in uname.
• -O <os> — Set operating system string for the worker to report to manager instead of the value in uname.
• -s <path> — Set the location for creating the working directory of the worker.
• -j <> — Use job array to submit workers.
• -p <parameters> — Torque qsub parameters.
• -h — Show help message.

---

🔥 EXIT STATUS 🔥

On success, returns zero. On failure, returns non-zero. simple as that bestie. 😌

---

🌈 EXAMPLES 🌈

Submit 10 worker instances to run on Torque and connect to a specific manager:

torque_submit_workers manager.somewhere.edu 9123 10

Submit 10 work_queue_worker instances to run on Torque in auto mode with their preferred project name set to Project_A and abort timeout set to 3600 seconds:

torque_submit_workers -a -t 3600 -M Project_A 10

look at that. iconic. 🔥

---

👑 COPYRIGHT 👑

The Cooperative Computing Tools are Copyright (C) 2005-2019 The University of Notre Dame. This software is distributed under the GNU General Public License. See the file COPYING for details.

---

🦋 SEE ALSO 🦋

• Cooperative Computing Tools Documentation
• Work Queue User Manual
• work_queue_worker(1) work_queue_status(1) work_queue_factory(1) condor_submit_workers(1) sge_submit_workers(1) torque_submit_workers(1)

---

okay that's the whole page bestie, go forth and submit those workers 💖✨

this lil doc is from CCTools 8.0.0 DEVELOPMENT, and yeah the page you just read is torque_submit_workers(1). mwah. 🎀💅🫶