Page Comparison

...

1. Visibility - Public
2. Change Control - Stable
3. Synopsis - A new command that will be used for altering reservation attributes.
4. Details - 
   1. The pbs_ralter command will be used to alter an already submitted advance or standing reservation.
   2. In particular, it can be used to change the start time, end time, mail points, mail_list and the reservation's name.
   3. This command can be used to change an advance reservation or the next/current instance of a standing reservation.
   4. After the change is requested, the change is either confirmed or denied.
   5. On denial of the change, the reservation is left as is.
   6. If the user changes only one of the times (start time or end time) of the reservation, the duration of the reservation will change.
   7. This command can be used by the owner of the reservation or the admin to alter any reservation.
   8. If the reservation has not started and if it cannot be reconfirmed on the same nodes, PBS will attempt to look for another set of nodes before denying the request.
   9. Following options will be supported:
      

      1. Start time modifier: '-R' <start_time>

         1. Specifies reservation's new start time.

         2. This option can be used only when the reservation is not running or is empty i.e. no jobs are submitted to the reservation.

         3. If the change is allowed, reservation will start at the new time specified with this option to pbs_ralter.

         4. The specifications of providing the time are same as pbs_rsub.

      2. End time modifier: '-E' <end_time>

         1. Specifies reservation's new end time.

         2. This option can be used even when the reservation is running and has jobs that are submitted to the reservation.

         3. If the change is confirmed, reservation will end at the new time specified with this option to pbs_ralter.

         4. The specifications of providing the time are same as pbs_rsub.

      3. Interactive option: '-I' <+block_time>.

         1. Specifies interactive mode.

         2. The pbs_ralter command will block, up to <block_time> seconds, while waiting for the reservation's change request to be confirmed.

         3. <block_time> should be positive.

         4. If the change is allowed, pbs_ralter returns with the status “CONFIRMED”, otherwise it returns with the status “UNCONFIRMED”.

         5. Format: Integer.

         6. Default: Not interactive.

      4. -m <mail_points> 

         1. Works same as pbs_rsub. 

      5. -N reservation_name

         1. Works same as pbs_rsub.

      6. -M mail_list

         1. Works same as pbs_rsub.

   10. For standing reservations if the new end time requested conflicts with any of the later instances, PBS will try to confirm the instance on another set of nodes, and if not possible, will deny the alter request. In this case, the next instance of the reservation will start only after the altered reservation finishes.
       1. example: 
          # pbs_rsub -R 1000 -E 1100 -r "FREQ=HOURLY;COUNT=3" -I 8
          S100.server CONFIRMED
          # pbs_ralter -E 1130 S100 -I 8
          S100.server CONFIRMED (pbs_rstat -f will show another set of nodes allocated to this instance).
          In the above example, the second instance will start running at 11:30 which is after the first instance finishes running. 
          All the jobs that were running in the first instance will be deleted.
   11. For standing reservation if the new start time is after the last instance of the standing reservation, only the altered instance will be able to run and other instances will be skipped as the other instances will have their end times in the past by the time the altered reservation finishes running.
       1. example:
          # pbs_rsub -R 1000 -E 1100 -r "FREQ=HOURLY;COUNT=3" -I 8
          S100.server CONFIRMED
          # pbs_ralter -E 1300 S100 -I 8
          S100.server CONFIRMED
          In the above example, the second and third instance of the reservation will be getting skipped.

Interface 2: CLI response message displayed when a reservation alter could not be confirmed within block_time for interactive option.

...