---
name: "qrls"
section: "1"
platform: "linux"
package: "gridengine-client"
version: "8.1.9+dfsg-13.1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/qrls"
---

# qrls(1)

release Grid Engine jobs from previous hold states

## NAME

qrls - release Grid Engine jobs from previous hold states

## SYNTAX

**qrls** \[ **-h** {**u**\|**o**\|**s**},... \] \[ **-help** \] \[ **job/task\_id\_list** \]

**qrls** \[ **-h** {**u**\|**o**\|**s**},... \] \[ **-help** \]  **-u user\_list**

## DESCRIPTION

*Qrls* provides a means for a user/operator/manager to release so called *holds* from one or more jobs pending to be scheduled for execution. As long as any type of hold is assigned to a job, the job is not eligible for scheduling.

Holds can be assigned to jobs with the [*qhold*(1)](/qhold/1.md), [*qsub*(1)](/qsub/1.md) or the [*qalter*(1)](/qalter/1.md) command.

There are three different types of holds:

- **user**

  User holds can be assigned and removed by managers, operators and the owner of the jobs.

- **operator**

  Operator holds can be assigned and removed by managers and operators.

- **system**

  System holds can be assigned and removed by managers only.

If no hold type is specified with the **-h** option (see below) the user hold is assumed by default.

An alternate way to release holds is the [*qalter*(1)](/qalter/1.md) command (see the *-h* option).

## OPTIONS

- **-h** {**u**\|**o**\|**s**},...

  Releases a u(ser), o(perator) or s(system) hold or a combination thereof from one or more jobs.

- **-help**

  Prints a listing of all options.

- **-u username,...**

  Modifies the hold state of those jobs which were submitted by users specified in the list of usernames. Managers are allowed to use the **qrls -u "\*"** command to modify the hold state for jobs of all users.

  If a user uses the **-u** switch, the user may specify an additional *job/task\_id\_list*.

- **job/task\_id\_list**

  Specified by the following form:

      *job\_id\[.task\_range\]\[,job\_id\[.task\_range\],...\]*

  If present, the *task\_range* restricts the effect of the operation to the array job task range specified as suffix to the job id (see the **-t** option to [*qsub*(1)](/qsub/1.md) for further details on array jobs).

  The task range specifier has the form n\[-m\[:s\]\]. The range may be a single number, a  simple range  of the form n-m or a range with a step size.

  Instead of *job/task\_id\_list* it is possible to use the keyword 'all' to modify all jobs of the current user.

## ENVIRONMENT VARIABLES

- **SGE\_ROOT**

  Specifies the location of the Grid Engine standard configuration files.

- **SGE\_CELL**

  If set, specifies the default Grid Engine cell. To address a Grid Engine cell *qrls* uses (in the order of precedence):

  The name of the cell specified in the environment  variable SGE\_CELL, if it is set.

  The name of the default cell, i.e. **default**.

- **SGE\_DEBUG\_LEVEL**

  If set, specifies that debug information should be written to stderr. In addition the level of detail in which debug information is generated is defined.

- **SGE\_QMASTER\_PORT**

  If set, specifies the tcp port on which [*sge\_qmaster*(8)](/sge_qmaster/8.md) is expected to listen for communication requests. Most installations will use a services map entry for the service "sge\_qmaster" instead to define that port.

## SEE ALSO

[*sge\_intro*(1)](/sge_intro/1.md), [*qalter*(1)](/qalter/1.md), [*qhold*(1)](/qhold/1.md), [*qsub*(1)](/qsub/1.md).

## COPYRIGHT

See [*sge\_intro*(1)](/sge_intro/1.md) for a full statement of rights and permissions.