Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 11 Next »

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

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) 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 and "Reservation not empty" is displayed on the console.

Interface 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.
    2. 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 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 'N' will be written to the accounting logs.
    1. If only start time is changed, this log will have the format: "N; <resvID> requestor=<user>@<host> stime=<requested start time>".
      1. example - "N; R123.server requestor=root@hostname stime=1497264531"
    2. If only end time is changed, this log will have the format: "N; <resvID> requestor=<user>@<host> etime=<requested end time>".
      1. example - "N; R123.server requestor=root@hostname etime=1497264531"
    3. If both start and end times are changed, this log will have the format: "N; <resvID> requestor=<user>@<host> stime=<requested start time> etime=<requested end time>".
      1. example - "A; R123.server requestor=root@hostname stime=1497264531 etime=1497267531"

Interface 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 'N' will be written to the accounting logs.
    1. If only start time is changed, this log will have the format: "N; <resvID> requestor=<user>@<host> stime=<requested start time> interactive=<no.of seconds>".
      1. example - "N; R123.server requestor=root@hostname stime=1497264531 interactive=10"
    2. If only end time is changed, this log will have the format: "N; <resvID> requestor=<user>@<host> etime=<requested end time> interactive=<no.of seconds>".
      1. example - "N; R123.server requestor=root@hostname etime=1497264531 interactive=10"
    3. If both start and end times are changed, this log will have the format: "N; <resvID> requestor=<user>@<host> stime=<requested start time> etime=<requested end time> interactive=<no.of seconds>".
      1. example - "N; R123.server requestor=root@hostname stime=1497264531 etime=1497267531 interactive=10"

Interface 10: A new accounting log type for reservation alter request being confirmed.

  1. Visibility - Public
  2. Change Control - Stable
  3. Synopsis - A new accounting log type denoting that a reservation alter request has been confirmed.
  4. Details - When a reservation alter is being confirmed, a new type record namely 'Z' will be written to the accounting logs.
    1. If only start time is changed, this log will have the format: "Z; <resvID> requestor=<user>@<host> stime=<new confirmed start time>".
      1. example - "Z; R123.server requestor=root@hostname stime=1497264531"
    2. If only end time is changed, this log will have the format: "Z; <resvID> requestor=<user>@<host> etime=<new confirmed end time>".
      1. example - "Z; R123.server requestor=root@hostname etime=1497264531"
    3. If both start and end times are changed, this log will have the format: "Z; <resvID> requestor=<user>@<host> stime=<new confirmed start time> etime=<new confirmed end time>".
      1. example - "Z; R123.server requestor=root@hostname stime=1497264531 etime=1497267531"

Interface 11: A new accounting log type for reservation alter request being denied.

  1. Visibility - Public
  2. Change Control - Stable
  3. Synopsis - A new accounting log type denoting that a reservation alter request has been denied.
  4. Details - When a reservation alter is being denied, a new type record namely 'Z' will be written to the accounting logs.
    1. If only start time is changed, this log will have the format: "z; <resvID> requestor=<user>@<host> stime=<requested start time>".
      1. example - "z; R123.server requestor=root@hostname stime=1497264531"
    2. If only end time is changed, this log will have the format: "z; <resvID> requestor=<user>@<host> etime=<requested end time>".
      1. example - "z; R123.server requestor=root@hostname etime=1497264531"
    3. If both start and end times are changed, this log will have the format: "z; <resvID> requestor=<user>@<host> stime=<requested start time> etime=<requested end time>".
      1. example - "z; R123.server requestor=root@hostname stime=1497264531 etime=1497267531"

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/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: "Reservation alter denied <resvID>".
    2. When a reservation alter request is confirmed, server logs this event.
      1. This log will have the format: "Reservation alter confirmed <resvID>".

Interface 14: A new PBS IFL API for modifying a reservation.

  1. Visibility - Public
  2. Change Control - Stable
  3. Synopsis - New IFL API.
  4. Details - 
    1. Signature - 

      char * pbs_modify_resv(int server_connect, char *resv_id, struct attropl *attrib, char *extend)

      1. server_connect - socket on which we connect to the server.

      2. resv_id - reservation ID.
      3. attrib - list of attributes to be changed.
      4. extend - for future extensions.
  • No labels