---
name: "oarwalltime"
section: "1"
platform: "linux"
package: "oar-user"
version: "2.6.1-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/oarwalltime"
---

# oarwalltime(1)

query or request a change of the walltime of a job handled by the OAR batch scheduler.

## NAME

oarwalltime - query or request a change of the walltime of a job handled by the OAR batch scheduler.

## SYNOPSIS

**oarwalltime** \[options\] \<job\_id\> \[\<\[+/-\]new walltime\>\]

## DESCRIPTION

This command manages requests to change the walltime of a job.

If no *new walltime* is given, the command shows the current walltime change status for the job.

If a *new walltime* is given, the command requests a change of the walltime of the job, or update a previous request.

The *new walltime* is to be passed in the format \[+-\]h:m:s. If no sign is used, The value is a new walltime absolute value (like passed to oarsub). If prefixed by +, the request is an increase of the walltime by the passed value. If prefixed by -, it is a decrease request. A walltime change request that has not been yet accepted by the scheduler can be cancelled by passing the '+0' value.

Walltime changes can only be requested for a running job.

There is no warranty that walltime can be increased, since it depends on the resources availability (next jobs).

Once a request is registered, it will by handled during the next pass of scheduling and granted if it fits with other jobs.

As per configuration:

- •

  the walltime change functionality may be disabled in your installation, and if not there is a maximum to the possible walltime increase

- •

  a walltime increase request may only be applied some time before the predicted end of the job. That apply time may be computed as a percentage of the walltime of the job

- •

  a walltime increase may happen incrementally, so that other scheduled jobs get more priority. That increment may be computed as a percentage of the walltime of the job

- •

  the functionality may be configured differently from one queue to another.

*Read your site's documentation or ask your administrator to know the configured settings.*

## OPTIONS

- **--force**

  Request walltime increase to be trialed or applied immediately regardless of any otherwise configured delay.

- **--whole**

  Request walltime increase to be trialed or applied wholly at once, or not applied otherwise.

- **--delay-next-jobs**

  Request walltime increase to possibly delay next batch jobs (but not advance reservations), if required to fit in the resources allocation. Warning: this implies delaying any other batch jobs, including the ones from other users. Using this option may be prohibited.

- **--timeout**

  Specify a timeout (in seconds) after which the walltime change request will be aborted if not already accepted by the scheduler. By default, there is no timeout unless a default timeout is set by the administrator.

- **-h, --help**

  Print help command message.

- **-V, --version**

  Print OAR version.

## NOTES

All changes are logged. Changes using the force or delay-next-jobs options are accounted.

*Please mind the walltime of the job and do not rely too much on that functionality.*

The shell environment variables of the job are not updated (OAR\_JOB\_WALLTIME, OAR\_JOB\_WALLTIME\_SECONDS).

Walltime change events for a job are listed in the *oarstat* output.

## SEE ALSO

[**oarstat**(1)](/oarstat/1.md), [**oarsub**(1)](/oarsub/1.md), [**oardel**(1)](/oardel/1.md)

## COPYRIGHTS

```
 Copyright 2003-2017 Laboratoire d'Informatique de Grenoble (http://www.liglab.fr). This software is licensed under the GNU General Public License Version 2 or above. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
```