brsvs

displays advance reservations

Synopsis

brsvs [-l | -w] [-p all | "host_name ..."]
brsvs [-l | -w] [-z all | "host_name ..."]
brsvs [-c all | "policy_name"]
brsvs [-h | -V]

Description

By default, displays the current advance reservations for all hosts, users, and groups.

For advance reservations across clusters:

  • -p all shows local and all remote reservations

  • The default all includes both local and remote

  • host_name does NOT take host_name@cluster_name

By default, brsvs truncates the reservation ID (RSVID) at 11 characters. Use -w to see the full reservation ID.

Options

-l

Displays advance reservations in a long multiline format. In addition to the standard output, the -l option displays the reservation type (open or closed) and the job IDs of any jobs associated with the specified advance reservation, sorted by status.

-w

Wide format. Displays reservation information without truncating fields.

-c all | "policy_name ..."

Shows advance reservation policies defined in lsb.resources. By default, displays all policy names.

The all keyword shows detailed information for all policies.

-p all | "host_name ..."

Shows a weekly planner for specified hosts using advance reservations.

The all keyword shows a weekly planner for all hosts with reservations.

-z all | "host_name"

Show a planner with only the weekly items that have reservation configurations displayed. Empty lines are omitted.

The all keyword shows a weekly planner for all hosts with reservations.

-h

Prints command usage and exits.

-V

Prints LSF release version and exits.

Output

TIME_WINDOW

Time window for a recurring reservation.

Values are separated by a hyphen (-), with no space in between:
time_window = begin_time-end_time
Times are specified in the format:
[day:]hour[:minute]
where all fields are numbers with the following ranges:
  • day of the week: 0-6 (0 is Sunday)

  • hour: 0-23

  • minute: 0-59

A time window can be specified in any of the following ways:
  • hour-hour

  • hour:minute-hour:minute

  • day:hour:minute-day:hour:minute

The default value for minute is 0 (on the hour); the default value for day is every day of the week.

Example

brsvs -c reservation1
Policy Name: reservation1
Users: ugroup1 ~user1 
Hosts: hostA hostB
Time Window: 8:00-13:00

See also

brsvadd, brsvdel, brsvmod, lsb.resources