---
name: "qsched"
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/qsched"
---

# qsched(1)

show scheduling information on resource reservation

## NAME

qsched, process-scheduler-log - show scheduling information on resource reservation

## SYNTAX

**qsched** \[**-u *user***\|**--user=*user***\] \[**-a**\|**--all**\] \[**-j *jid\_list***\|**--jid=*jid\_list***\] \[**-f**\|**--full**\] \[**-s** **j**\|**--sort=j**\] \[**-q**\|**--queues**\] \[**-d**\|**--debug**\] \[**-h**\|**--help**\]\
 **process-scheduler-log** \[**-v**\]

## DESCRIPTION

**qsched** reports resources being reserved for jobs on the basis of the *schedule* file, which is processed by **process-scheduler-log**, which runs continuously.   Generating *schedule* requires setting **MONITOR=1** in the **params** parameter of the scheduler (see *sched\_conf*(5)).

**process-scheduler-log** should simply be started in the background as it does not currently daemonize itself.  Alternatively, it could be run under [*daemonize*(1)](/daemonize/1.md), or adapted to run as a global load sensor (see [*sge\_execd*(8)](/sge_execd/8.md)). It needs *SGE\_ROOT* and *SGE\_CELL* set in the environment when it starts.

**qsched** and **process-scheduler-log** both potentially need editing to configure for the local installation, particularly the definition of **$trim\_string** in **qsched**.

## OPTIONS

- **-a** \| **--all**

  View jobs belonging to all users (synonym for **-u user***)* View jobs belonging to *user*.

- **-d** \| **--debug**

  Print debugging information.

- **-f** \| **--full**

  Print all available data for each job.

- **-h** \| **--help**

  Print help information.

- **-j** *jid\_list* **\| --jid=***jid\_list*

  *jid\_list* is a comma-separated list of job ids to view.

- **-q \| --queues**

  Sort output by queue.

- **-s j** **\| --sort=j**

  Sort output by job id.

- **-u user \| --user=***user*

  View jobs belonging to *user*.

- **-v**

  Print information on standard output. **-u \***).

The default is to sort by start time.

## FILES

- */var/run/sgeprocschedlog.pid*

  Contains the process id of *process-scheduler-log*.

- *${SGE\_ROOT}/${SGE\_CELL}/common/act\_qmaster*

  Consulted to check that the qmaster is active.

- *${SGE\_ROOT}/${SGE\_CELL}/common/schedule*

  Normal schedule monitoring file.

- *${SGE\_ROOT}/${SGE\_CELL}/common/schedule.last*

  Contents of last complete scheduling interval seen in *schedule* file.

## SEE ALSO

*sched\_conf*(5), [*daemonize*(1)](/daemonize/1.md)

## AUTHOR

Mark Dixon \<m.c.dixon@leeds.ac.uk\>\
 Man page by Dave Love \<d.love@liverpool.ac.uk\>