qrls

qrls

Release the hold state of jobs or tasks. This command mimics SGE (Sun Grid Engine) qrls behavior but is implemented on FSCHED.

---

Parameters

Parameter	Type	Required	Description and Constraints
-h	String	No	Specify hold types to release (such as "s"). Must be used with another valid parameter (such as -u or job_task_list); cannot be used alone.
-u	Username string or *	No	Specify user list (such as "user1,user2"). Mutually exclusive with job_task_list; at least one of them is required.
job_task_list	Positional parameter	Yes (if -u is not used)	Format jobID.task_range (for example job123.0-5). Mutually exclusive with -u and must follow FSCHED task identifier rules.

---

Examples

Scenario 1: Release all held tasks for a user

qrls -u user1

• Purpose: Release all held jobs/tasks for user user1.

---

Scenario 2: Release holds for specific tasks

qrls job123.0-5

• Purpose: Release the hold state for tasks 0 to 5 of job job123.

---

Scenario 3: Use -h with a user

qrls -h s -u user2

• Purpose: Release holds of a specific type (such as "s") for user user2.

---

Notes

1. Mutual exclusion:

   • -u and job_task_list cannot be used together. If -u is not specified, job_task_list is required.
   • Example of invalid usage:

     qrls -u user3 job456.0  # Error: -u and job list cannot be used together.

2. -h dependency:

   • -h must be used with at least one valid parameter (-u or job_task_list); it cannot be used alone.

3. User validation:

   • If a username in -u is invalid and "*" is not used, the command errors indicating the task does not exist.

4. Format requirements:

   • job_task_list must strictly follow the job identifier format (such as jobID.task_range).

---

Unsupported SGE Features

The following SGE features are not implemented due to compatibility differences with FSCHED:

• Notification options (such as email notifications).
• Some advanced hold types may not map to FSCHED equivalents.