Displays advance reservations.


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


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

You can also see advance reservations across clusters:
  • The default all option includes both local and remote reservations.
  • host_name does not take the host_name@cluster_name argument.

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


Displays advance reservations in a long multiline format. In addition to the standard output, the -l option displays queues that can use the advance reservation hosts before the advance reservation starts, the pre-script, pre-script time, post-script, post-script time, the reservation type (open or closed), whether non-advance reservation jobs are allowed to continue running after the first advance reservation starts, and the job IDs of any jobs that are associated with the specified advance reservation. Reservations are sorted by status.

The NCPUS field displays real-time advance reservation usage, in the format: used slots/total slots.

Wide format. Displays reservation information without truncating fields.
-c all | -c "policy_name ..."
Shows advance reservation policies that are defined in the lsb.resources file. By default, displays all policy names.

The all keyword shows detailed information for all policies.

-p all " | -p "host_name ..." | -p host_group ..."
Shows a weekly planner for specified hosts, host groups, or a combination, that use advance reservations.

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

-z all | -z "host_name ..." | -z host_group ..."
Shows a planner with only the weekly items that have reservation configurations. Empty lines are omitted.

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

Prints command usage and exits.
Prints LSF release version and exits.


The advance reservation ID.
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 following format:
All fields are numbers with the following ranges:
day of the week
0 to 6 (0 is Sunday)
0 to 23
0 to 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.

The list of users and user groups that are specified for the advance reservation.


The following command shows a reservation with the name reservation1
brsvs -c reservation1
Policy Name: reservation1
Users: ugroup1 ~user1 
Hosts: hostA hostB
Time Window: 8:00-13:00
The following example shows a reservation placeholder for a dynamically scheduled reservation. The resources and time window are blank until a job actually uses the reservation:
brsvs user2#20
RSVID        TYPE      USER       NCPUS          RSV_HOSTS     TIME_WINDOW
user2#20     user     user2       0/0             none:0/0      -

See also

brsvadd, brsvmod, brsvdel, lsb.resources