Scroll to navigation

oarwalltime(1) OAR commands oarwalltime(1)

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.

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 applied at once: immediately and not incrementally.
--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.
-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), oarsub(1), oardel(1)

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.
2019-10-17 oarwalltime