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

...