qrsh

Overview

qrsh is the FSCHED replacement for the SGE interactive job launcher. It submits parallel or resource-constrained tasks and supports core options for environment, resources, and job behavior.

---

Options

Supported Parameters

Option	Type/Range	Description
-A	Account name (string)	Specify the account for the job.
-b	y/n (case-insensitive)	Control whether to execute a binary directly; default is yes.
-cwd	None	Use the current working directory as the job working path.
-hard	None	Make subsequent -l/-q options hard constraints (must be satisfied).
-M	Email address (string)	Set the email address for notifications.
-m	b/e/a (characters)	Email trigger: b (begin), e (end), a (always). Use with -M.
-N	Job name (string)	Set the job name; no spaces or special characters.
-now	Enabled by default	Start the job immediately; no need to specify explicitly.
-pe	mpi/smp + slots	Define parallel environment and slots (e.g., -pe smp 4). Only mpi and smp are supported.
-soft	None	Make subsequent -l/-q options soft constraints (allow adjustment).
-v	"VAR=value" format	Set environment variables (one per option). Example: -v "PATH=/new/path".
-wd	Path string	Set the job working directory, overriding -cwd.

---

Unsupported or Limited Options

Invalid Options

The following options are ignored in FSCHED:

• -notify, -noshell, -nostdin: ignored by the system.

Limited Options

Option	Limitation
-h/-hold_jid/-pty	Job hold and dependency features are not implemented.
-l	Supports num_proc, mem_free, hostname, but allocation logic may be incomplete.
-q	Only a single queue name is supported; scheduling behavior may differ from SGE.

---

Examples

Example 1: Set parallel environment and email notification

qrsh -pe smp 4 -M user@example.com -m e my_script.sh

Starts a job with the smp environment and emails on completion.

Example 2: Enforce hard resource constraints

qrsh -hard -l "num_proc=8,mem_free=16G" my_program --arg1

Requires 8 CPU cores and 16GB memory (must be satisfied).

Example 3: Set environment variables

qrsh -v "DEBUG=1" python my_script.py

Enables the DEBUG environment variable before running the script.

---

Notes

1. Defaults:
   • -b defaults to yes, running binaries directly.
   • -now triggers immediate start by default.
2. Resource limits:
   • When using -l/-q, confirm parameter compatibility with FSCHED configuration.
3. Environment export:
   • All environment variables are inherited by default (no -V required).