table of contents
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 |