brsvs

Displays advance reservations.

Synopsis

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]

Description

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.

Options

-l: 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.
-w: 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.
-h: Prints command usage and exits.
-V: Prints LSF release version and exits.

Output

RSVID

The advance reservation ID.

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 following format:

[day:]hour[:minute]

All fields are numbers with the following ranges:

day of the week: 0 to 6 (0 is Sunday)
hour: 0 to 23
minute: 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.

USER

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

Examples

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      -