oarwalltime

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.