Skip to end of metadata
Go to start of metadata

forum discussion

PP-662 - Getting issue details... STATUS

PP-663 - Getting issue details... STATUS

Interface 1: A new CLI pbs_ralter.

  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.
    6. To get a confirmation whether the change was allowed or not, use the pbs_rstat command or the interactive option.
    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 allowed, 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 2: CLI response message displayed when a reservation alter could not be confirmed within block_time for interactive option.

  1. Visibility - Public
  2. Change Control - Stable
  3. Synopsis - A new CLI response message denoting that the alter request for a reservation could not be confirmed within the block_time provided while using the interactive option of pbs_ralter command.
  4. Details - While using the interactive option, the pbs_ralter command blocks up to block_time seconds while waiting for the reservation's change request to be confirmed. There is a possibility that the request could not be processed within block_time seconds. In that case the command line returns and "<resvID> UNCONFIRMED" is displayed on the console.

Interface 3: CLI response message displayed when a reservation alter request is confirmed within block_time for interactive option.

  1. Visibility - Public
  2. Change Control - Stable
  3. Synopsis - A new CLI response message denoting that the alter request for a reservation was confirmed within the block_time provided while using the interactive option of pbs_ralter command.
  4. Details - While using the interactive option, the pbs_ralter command blocks up to block_time seconds while waiting for the reservation's change request to be confirmed. If the request is confirmed within block_time seconds, the command line returns and "<resvID> CONFIRMED" is displayed on the console.

Interface 4: CLI response message displayed when a reservation alter request is confirmed within block_time for interactive option.

  1. Visibility - Public
  2. Change Control - Stable
  3. Synopsis - A new CLI response message denoting that the alter request for a reservation was denied. Displayed when the interactive option of pbs_ralter command is used.
  4. Details - While using the interactive option, the pbs_ralter command blocks up to block_time seconds while waiting for the reservation's change request to be confirmed. If the request is denied within block_time seconds, the command line returns and "<resvID> DENIED" is displayed on the console.

Interface 5: CLI response message displayed in non-interactive mode of pbs_ralter.

  1. Visibility - Public
  2. Change Control - Stable
  3. Synopsis - A new CLI response message denoting that an alter request for a reservation is being made.
  4. Details - While using the non-interactive option, the pbs_ralter command returns immediately "<resvID> ALTER REQUESTED" is displayed on the console.

Interface 6: A new error code (number undecided yet) 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: 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 - 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.
  4. Details - 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 -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: 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: 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: 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: A new server log denoting that a reservation alter request is rejected.

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

Interface 14: A new server log denoting that a reservation alter request is rejected.

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