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 not deleted and is left as is.To get a confirmation whether the change was allowed or not, use the pbs_rstat
   6. command or the interactive optionIf the user changes only one of the times (start time or end time) of the reservation, the duration of the reservation will change.
   7. 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 allowedconfirmed, 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.

...

Interface 6: A new error code (number undecided yet) and a new error message for pbs_ralter denoting that a non-empty reservation that has already started running cannot have its start time altered.

1. Visibility - Public
2. Change Control - Stable
3. Synopsis - As per the requirements, reservation in RUNNING state cannot have its start time altered if there are jobs in it.
4. Details - When pbs_ralter is used for altering its start time that has jobs in it and has already started running, this new error code is returned .

Interface 7: A new error message for pbs_ralter denoting that a non-empty reservation that has already started running cannot have its start time altered.

1. Visibility - Public
2. Change Control - Stable
3. Synopsis - As per the requirements, reservation in RUNNING state cannot have its start time altered if there are jobs in it.
4. Details - When pbs_ralter is used for altering its start time that has jobs in it and has already started running, "Reservation not empty" is displayed on the console.

Interface 8 7: A new reservation state denoting that it is being altered (short format).

1. Visibility - Public
2. Change Control - Stable
3. Synopsis - When a reservation alter is being requested in non-interactive mode, until the scheduler confirms/denies the change, the reservation will switch to a new state.
4. Details - 
   1. When using non-interactive mode of pbs_ralter, the user who has requested the change can check the status of the request by using pbs_rstat. After the request is made, and until the PBS scheduler confirms/denies the change, the reservation will switch to a new state "AL" denoting that it is being altered
   .

Interface 9: A new reservation state denoting that it is being altered (long format).

1. Visibility - Public
2. Change Control - Stable
3. Synopsis - When a reservation alter is being requested in non-interactive mode, until the scheduler confirms/denies the change, the reservation will switch to a new state
   1. .
   Details -
   1. When using non-interactive mode of pbs_ralter, the user who has requested the change can check the status of the request by
   using
   1. using pbs_rstat -f. After the request is made, and until the PBS scheduler confirms/denies the change, the reservation will switch to a new state "RESV_BEING_ALTERED" denoting that it is being altered.

Interface 10 8: A new accounting log type for reservation alter request (non-interactive mode).

1. Visibility - Public
2. Change Control - Stable
3. Synopsis - A new accounting log type denoting that a reservation alter request has been made.
4. Details - When a reservation alter is being requested in non-interactive mode, a new type record namely 'A' will be written to the accounting logs.
   
   1. This log will have the format: "A; <resvID> requestor=<user>@<host>".

Interface 11 9: A new accounting log type for reservation alter request (interactive mode).

1. Visibility - Public
2. Change Control - Stable
3. Synopsis - A new accounting log type denoting that a reservation alter request has been made.
4. Details - When a reservation alter is being requested in non-interactive mode, a new type record namely 'A' will be written to the accounting logs.
   
   1. This log will have the format: "A; <resvID> requestor=<user>@<host> Interactive=<no.of.seconds>".

Interface 12 10: A new server log denoting that a reservation alter is being attempted.

1. Visibility - Public
2. Change Control - Stable
3. Synopsis - server, info level.
4. Details - When a reservation alter is being requested, the PBS server attempts to get a confirmation from the PBS scheduler.
   
   1. This log will have the format: "Attempting to modify reservation <resvID>".

Interface 13 11: A new server log denoting that a reservation alter request is rejected/confirmed.

1. Visibility - Public
2. Change Control - Stable
3. Synopsis - server, info level.
4. Details - 
   1. When a reservation alter request is rejected, server logs this event.
      
      1. This log will have the format: "
      Unable to alter reservation <resvID>
      1. Reservation alter denied <resvID>".

...

1. 1. When a reservation alter request is

...

1. Visibility - Public
2. Change Control - Stable
3. Synopsis - server, info level.
4. Details - When a reservation alter request in non-interactive mode,
   1. confirmed, server logs this event.
      
      1. This log will have the format: "Reservation alter
      successful for
      1. confirmed <resvID>".