Provided by: oar-user_2.5.10-1_amd64 bug

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), 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.