---
name: "condor_watch_q"
section: "1"
platform: "linux"
package: "condor"
version: "23.9.6+dfsg-2.1+b10"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/condor_watch_q"
---

# condor\_watch\_q(1)

HTCondor Manual Track the status of jobs over time.

## NAME

condor\_watch\_q - HTCondor Manual

Track the status of jobs over time.

## SYNOPSIS

**condor\_watch\_q** \[**-help**\]

**condor\_watch\_q** \[*general options*\] \[*display options*\] \[*behavior options*\] \[*tracking options*\]

## DESCRIPTION

**condor\_watch\_q** is a tool for tracking the status of jobs over time without repeatedly querying the *condor\_schedd*. It does this by reading job event log files. These files may be specified directly (the **-files** option), or indirectly via a single query to the *condor\_schedd* when **condor\_watch\_q** starts up (options like **-users** or **-clusters**).

**condor\_watch\_q** provides a variety of options for output formatting, including: colorized output, tabular information, progress bars, and text summaries. These display options are highly-customizable via command line options.

**condor\_watch\_q** also provides a minimal language for exiting when certain conditions are met by the tracked jobs. For example, it can be configured to exit when all of the tracked jobs have terminated.

## EXAMPLES

If no users, cluster ids, or event logs are given, **condor\_watch\_q** will default to tracking all of the current user's jobs. Thus, with no arguments,

```
condor_watch_q
```

will track all of your currently-active clusters.

To track jobs from a specific cluster, use the **-clusters** option, passing the cluster ID:

```
condor_watch_q -clusters 12345
```

To track jobs from a specific user, use the **-users** option, passing the user's name the actual query will be the for the *Owner* job ad attribute):

```
condor_watch_q -users jane
```

To track jobs from a specific event log file, use the **-files** option, passing the path to the event log:

```
condor_watch_q -users /home/jane/events.log
```

To track jobs from a specific batch, use the **-batches** option, passing the batch name:

```
condor_watch_q -batches BatchOfJobsFromTuesday
```

All of the above "tracking" options can be used together, and multiple values may be passed to each one. For example, to track all of the jobs that are: owned by **jane** or **jim**, in cluster **12345**, or in the event log **/home/jill/events.log**, run

```
condor_watch_q -users jane jim -clusters 12345 -files /home/jill/events.log
```

By default, **condor\_watch\_q** will never exit on its own (unless it encounters an error or it is not tracking any jobs). You can tell it to exit when certain conditions are met. For example, to exit with status 0 when all of the jobs it is tracking are done or with status 1 when any job is held, you could run

```
condor_watch_q -exit all,done,0 -exit any,held,1
```

## OPTIONS

### General Options

- **-help**

  Display the help message and exit.

- **-debug**

  Causes debugging information to be sent to **stderr**.

### Tracking Options

These options control which jobs **condor\_watch\_q** will track, and how it discovers them.

- **-users USER \[USER ...\]**

  Choose which users to track jobs for. All of the user's jobs will be tracked. One or more user names may be passed.

- **-clusters CLUSTER\_ID \[CLUSTER\_ID ...\]**

  Which cluster IDs to track jobs for. One or more cluster ids may be passed.

- **-larger-than CLUSTER\_ID**

  Track jobs for all cluster IDs greater than or equal to the specified *CLUSTER\_ID*. Note: This option does not discover how to track jobs.

- **-files FILE \[FILE ...\]**

  Which job event log files (i.e., the **log** file from **condor\_submit**) to track jobs from. One or more file paths may be passed.

- **-batches BATCH\_NAME \[BATCH\_NAME ...\]**

  Which job batch names to track jobs for. One or more batch names may be passed.

- **-collector COLLECTOR**

  Which collector to contact to find the schedd, if needed. Defaults to the local collector.

- **-schedd SCHEDD**

  Which schedd to contact for queries, if needed. Defaults to the local schedd.

### Behavior Options

- **-exit GROUPER,JOB\_STATUS\[,EXIT\_STATUS\]**

  Specify conditions under which condor\_watch\_q should exit. **GROUPER** is one of **all**, **any** or **none**. **JOB\_STATUS** is one of **active**, **done**, **idle**, or **held**. The "active" status means "in the queue", and includes jobs in the idle, running, and held states. **EXIT\_STATUS** may be any valid exit status integer. To specify multiple exit conditions, pass this option multiple times. **condor\_watch\_q** will exit when any of the conditions are satisfied.

### Display Options

These options control how **condor\_watch\_q** formats its output. Many of them are "toggles": **-x** enables option "x", and **-no-x** disables it.

- **-groupby {batch, log, cluster}**

  How to group jobs into rows for display in the table. Must be one of **batch** (group by job batch name), **log** (group by event log file path), or **cluster** (group by cluster ID). Defaults to **batch**.

- **-table/-no-table**

  Enable/disable the table. Enabled by default.

- **-progress/-no-progress**

  Enable/disable the progress bar. Enabled by default.

- **-row-progress/-no-row-progress**

  Enable/disable the progress bar for each row. Enabled by default.

- **-summary/-no-summary**

  Enable/disable the summary line. Enabled by default.

- **-summary-type {totals, percentages}**

  Choose what to display on the summary line, **totals** (the number of each jobs in each state), or **percentages** (the percentage of jobs in each state, of the total number of tracked jobs) By default, show **totals**.

- **-updated-at/-no-updated-at**

  Enable/disable the "updated at" line. Enabled by default.

- **-abbreviate/-no-abbreviate**

  Enable/disable abbreviating path components to the shortest somewhat-unique prefix. Disabled by default.

- **-color/-no-color**

  Enable/disable colored output. Enabled by default if connected to a tty. Disabled on Windows if colorama is not available (*https://pypi.org/project/colorama/*).

- **-refresh/-no-refresh**

  Enable/disable refreshing output. If refreshing is disabled, output will be appended instead. Enabled by default if connected to a tty.

## EXIT STATUS

Returns **0** when sent a SIGINT (keyboard interrupt).

Returns **0** if no jobs are found to track.

Returns **1** for fatal internal errors.

Can be configured via the **-exit** option to return any valid exit status when a certain condition is met.

## AUTHOR

Center for High Throughput Computing, University of Wisconsin-Madison

## AUTHOR

HTCondor Team

## COPYRIGHT

1990-2024, Center for High Throughput Computing, Computer Sciences Department, University of Wisconsin-Madison, Madison, WI, US. Licensed under the Apache License, Version 2.0.