Page Comparison

...

• This will alter the select spec for a reservation.
• As with modification of start/end times, the request will be sent to the scheduler.  The scheduler will attempt to confirm the reservation with the new select spec.  The request can be confirmed or denied.
• The requested select spec must request fewer of the same chunks originally requested by the reservation.
• If the reservation has not started yet:
  • As with pbs_ralter -R/-E/-D, this may result in the reservation being moved to a completely different set of nodes.
  • If a reservation is in in state IN CONFLICT and the reconfirmation is successful, then the reservation will return to state CONFIRMED.
• If the reservation has already started running: 
  
  • Attempting to ralter a degraded running reservation will likely fail.  This is current behavior of ralter.
    • If you attempt to ralter just -R -E -D, the alter will fail.
    • If you attempt to alter the select, all of the unavailable nodes will need to be removed for the ralter to succeed.
      • This will require the admin to map the resv_nodes chunks to the schedselect chunks and remove the chunks which are unavailable.   
  • If a reservation is running and in substate IN CONFLICT, the pbs_ralter -l select will be rejected.  
  • Nodes with running jobs on them can not be released. If the ralter is requesting to release more nodes than don't have running jobs on them, the ralter will fail.
• If the reservation alter is successful, a 'Y' (reservation confirmation) record will be printed into the accounting logs
• The current behavior of pbs_ralter and standing reservations will not change.  The command will only modify the current occurrence.
• This interface can be used along with the -R/-E/-D options.
• Hooks:
  • There is no ralter hook.  It is not possible for the admin to intercept the incoming select and modify it
  • There are submission hooks (rsub/qsub).  The select associated with the reservation may not be the same as the user originally submitted.
    • To successfully ralter a select, the user should look at the current Resource_List.select for the reservation in pbs_rstat -f before submitting their pbs_ralter -lselect.
• If the requested select is either more of the same chunks or different chunks, the following message will be returned
  • "New select must be made up of a subset of the original chunks"

...