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

        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.

oarwalltime                                        2025-02-18                                     oarwalltime(1)

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

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

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

       The newwalltime 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.

       Readyoursite'sdocumentationoraskyouradministratortoknowtheconfiguredsettings.

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

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

       Pleasemindthewalltimeofthejobanddonotrelytoomuchonthatfunctionality.

       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.

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

oarstat(1), oarsub(1), oardel(1)

oarwalltime [options] <job_id> [<[+/-]new walltime>]