Viewing advance reservation information

Use the brsvs command to view information about advance reservations. You can see all current reservations, show a weekly planner for your reservations, or see reservation types and their associated jobs. Use the bjobs command to see the reservation ID for an advance reservation job. Use the bacct command to view historical accounting information for advance reservations.

Procedure

Use the brsvs command with no options to show current reservations. 
brsvs
RSVID       TYPE    USER   NCPUS      RSV_HOSTS           TIME_WINDOW 
user1#0     user    user1   0/1024    hostA:0/1024   11/12/6/0-11/12/8/0 
user2#0     user    user2  0/1024     hostA:0/1024           12:0-14:0 * 
groupA#0   group   groupA  -/2048     hostA:-/1024         3:0:0-3:3:0 * 
                                      hostB:0/1024 
system#0     sys   system   1024      hostA:0/1024       5:18:0-5:20:0 *
The TIME_WINDOW column shows the following information:
  • A one-time reservation displays fields that are separated by slashes (month/day/hour/minute):
    11/12/14/0-11/12/18/0
  • A recurring reservation displays fields that are separated by colons (day:hour:minute). An asterisk (*) indicates a recurring reservation:
    5:18:0-5:20:0 *
The NCPUS and RSV_HOSTS columns show remote reservations but do not display details:
-/2048    hostA:-/1024

Showing a weekly planner for advance reservations

Use the brsvs -p and brsvs -z commands to show a weekly planner for specified hosts using advance reservation.

Procedure

  1. Use the all keyword to show the planner for all hosts with reservations.

    The output of the brsvs -p command is displayed in weeks. The week starts on Sunday. The timeframe of a recurring reservation is not displayed, since it is unlimited. The timeframe of one-time reservation is displayed in terms of a week. If the reservation spans multiple weeks, these weeks are displayed separately. If a week contains a one-time reservation and a recurring reservation, the timeframe is displayed, since that is relevant for one-time reservation.

    Tip: The MAX field indicates the configured maximum number of job slots for the host (the MXJ parameter that is defined in the lsb.hosts file).
    brsvs -p all
RSVID       TYPE    USER   NCPUS      RSV_HOSTS           TIME_WINDOW 
user1#0     user    user1  0/1024     hostA:0/1024   11/12/6/0-11/12/8/0 
user2#0     user    user2  0/1024     hostA:0/1024           12:0-14:0 * 
groupA#0   group   groupA  0/2048     hostA:0/1024         3:0:0-3:3:0 * 
                                      hostB:0/1024 
system#0     sys   system   1024      hostA:0/1024       5:18:0-5:20:0 * 
HOST: hostA  (MAX = 1024) 
Week: 11/11/2009 - 11/17/2009 
Hour:Min     Sun     Mon     Tue     Wed     Thu     Fri     Sat 
0:0          0       0       0       1024    0       0       0 
0:10         0       0       0       1024    0       0       0 
0:20         0       0       0       1024    0       0       0 
... 
2:30         0       0       0       1024    0       0       0 
2:40         0       0       0       1024    0       0       0 
2:50         0       0       0       1024    0       0       0 
3:0          0       0       0       0       0       0       0 
3:10         0       0       0       0       0       0       0 
3:20         0       0       0       0       0       0       0 
... 
5:30         0       0       0       0       0       0       0 
5:40         0       0       0       0       0       0       0 
5:50         0       0       0       0       0       0       0 
6:0          0       1024    0       0       0       0       0 
6:10         0       1024    0       0       0       0       0 
6:20         0       1024    0       0       0       0       0 
... 
7:30         0       1024    0       0       0       0       0 
7:40         0       1024    0       0       0       0       0 
7:50         0       1024    0       0       0       0       0 
8:0          0       0       0       0       0       0       0 
8:10         0       0       0       0       0       0       0 
8:20         0       0       0       0       0       0       0 
... 
11:30        0       0       0       0       0       0       0 
11:40        0       0       0       0       0       0       0 
11:50        0       0       0       0       0       0       0 
12:0         1024    1024    1024    1024    1024    1024    1024 
12:10        1024    1024    1024    1024    1024    1024    1024 
12:20        1024    1024    1024    1024    1024    1024    1024 
... 
13:30        1024    1024    1024    1024    1024    1024    1024 
13:40        1024    1024    1024    1024    1024    1024    1024 
13:50        1024    1024    1024    1024    1024    1024    1024 
14:0         0       0       0       0       0       0       0 
14:10        0       0       0       0       0       0       0 
14:20        0       0       0       0       0       0       0 
... 
17:30        0       0       0       0       0       0       0 
17:40        0       0       0       0       0       0       0 
17:50        0       0       0       0       0       0       0 
18:0         0       0       0       0       0       1024    0 
18:10        0       0       0       0       0       1024    0 
18:20        0       0       0       0       0       1024    0 
... 
19:30        0       0       0       0       0       1024    0 
19:40        0       0       0       0       0       1024    0 
19:50        0       0       0       0       0       1024    0 
20:0         0       0       0       0       0       0       0 
20:10        0       0       0       0       0       0       0 
20:20        0       0       0       0       0       0       0 
... 
23:30        0       0       0       0       0       0       0 
23:40        0       0       0       0       0       0       0 
23:50        0       0       0       0       0       0       0 
HOST: hostB  (MAX = 1024) 
Week: 11/11/2009 - 11/17/2009 
Hour:Min     Sun     Mon     Tue     Wed     Thu     Fri     Sat 
------------------------------------------------------------------- 
0:0          0       0       0       1024    0       0       0 
0:10         0       0       0       1024    0       0       0 
0:20         0       0       0       1024    0       0       0 
... 
2:30         0       0       0       1024    0       0       0 
2:40         0       0       0       1024    0       0       0 
2:50         0       0       0       1024    0       0       0 
3:0          0       0       0       0       0       0       0 
3:10         0       0       0       0       0       0       0 
3:20         0       0       0       0       0       0       0 
... 
23:30        0       0       0       0       0       0       0 
23:40        0       0       0       0       0       0       0 
23:50        0       0       0       0       0       0       0
  2. Use the brsvs -z command instead of the brsvs -p command to show only the weekly items that have reservation configurations. Lines that show all zero are omitted. 
    brsvs -z all
RSVID        TYPE      USER    NCPUS       RSV_HOSTS     TIME_WINDOW
user1_1      user      user1     0/3       hostA:0/2       12/28/14/30-12/28/15/30
                                           hostB:0/1
HOST: hostA (MAX = 2)
Week: 12/23/2007 - 12/29/2007
Hour:Min        Sun     Mon     Tue     Wed     Thu     Fri     Sat
----------------------------------------------------------------------
14:30           0       0       0       0       0       1       0
14:40           0       0       0       0       0       1       0
14:50           0       0       0       0       0       1       0
15:0            0       0       0       0       0       1       0
15:10           0       0       0       0       0       1       0
15:20           0       0       0       0       0       1       0

HOST: hostB (MAX = 2)
Week: 12/23/2007 - 12/29/2007
Hour:Min        Sun     Mon     Tue     Wed     Thu     Fri     Sat
----------------------------------------------------------------------
14:30           0       0       0       0       0       2       0
14:40           0       0       0       0       0       2       0
14:50           0       0       0       0       0       2       0
15:0            0       0       0       0       0       2       0
15:10           0       0       0       0       0       2       0
15:20           0       0       0       0       0       2       0

Showing reservation types and associated jobs

The brsvs -l command shows each advance reservation in long format.

Procedure

Use the -l option of the brsvs command to show each advance reservation in long format.

The rows that follow the reservation information show the

  • The status of the reservation
  • Time when the next instance of recurring reservation is active
  • Type of reservation (open or closed)
  • The status by job ID of any job associated with the specified reservation (FINISHED, PEND, RUN, or SUSP) 
brsvs -l
RSVID        TYPE      USER       NCPUS          RSV_HOSTS     TIME_WINDOW
user1_1#0    user    user1_1      10/10          host1:4/4    8:00-22:00 *      
                                                 host2:4/4
                                                 host3:2/2
Reservation Status: Active
Next Active Period:
        Sat Aug 22 08:00:00 2009 - Sat Aug 22 22:00:00 2009
Creator: user1_1
Reservation Type: CLOSED
FINISHED Jobs: 203 204 205 206 207 208 209 210 211 212
PEND Jobs: 323 324
RUN  Jobs: 313 314 316 318 319 320 321 322
SUSP Jobs: 315 317
Resource Unit: Host
Specify a reservation name to see information about a single reservation:
brsvs -l user1_1#0
RSVID      TYPE  USER   NCPUS  RSV_HOSTS      TIME_WINDOW
user1_1#0  user  user1  0/2    lsfrhel04:0/2  4/13/23/30-4/13/23/40
Reservation Status: Inactive
Creator: user1
Reservation Type: CLOSED
Resource Unit: Slot

Showing the reservation ID for an advance reservation job

The bjobs -l command shows the reservation ID used by a job.

Procedure

Use the bjobs -l command. 
bjobs -l
Job <1152>, User <user1>, Project <default>, Status <PEND>, Queue <normal>,  
Reservation <user1#0>, Command <covfefe>
Mon Nov 12 5:13:21 2009: Submitted from host <hostB>, CWD </home/user1/jobs>;
...

Viewing historical accounting information for advance reservations

The bacct -U command shows historical accounting information about advance reservations.

Procedure

Use the -U option of the bacct command.
The bacct -U command summarizes all historical modification of the reservation and displays information similar to the brsvs command:
  • The reservation ID specified on the -U option.
  • The type of reservation (user or system)
  • The user names of users who used the brsvadd command to create the advance reservations
  • The user names of the users who can use the advance reservations for jobs that are submitted with the bsub -U option.
  • Number of slots reserved
  • List of hosts for which job slots are reserved
  • Time window for the reservation.
    • A one-time reservation displays fields that are separated by slashes (month/day/hour/minute). 
      11/12/14/0-11/12/18/0
  • A recurring reservation displays fields that are separated by colons (day:hour:minute). 
    5:18:0 5:20:0

For example, the following advance reservation has four time modifications during its life time. The original reservation has the scope of one user (user1) and one host (hostA) with one slot. The various modifications change the user to user2, then back to user1, adds, then removes one slot from the reservation.

bacct -U user1#1
Accounting about advance reservations that are:
  - accounted on advance reservation IDs user1#1,
  - accounted on advance reservations created by user1,
---------------------------- SUMMARY ----------------------------
RSVID:                         user1#1
TYPE:                          user
CREATOR:                       user1
Total number of jobs:          0
Total CPU time consumed:       0.0 second
Maximum memory of a job:       0.0 MB
Maximum swap of a job:         0.0 MB
Total active time:             0 hour  6 minute 42 second
Resource Unit:                 Host
------------------------ Configuration 0 ------------------------
RSVID        TYPE      CREATOR   USER    NCPUS       RSV_HOSTS
user1#1      user        user1  user1       1          hostA:1
Active time with this configuration:  0 hour  0 minute 16 second
------------------------ Configuration 1 ------------------------
RSVID        TYPE      CREATOR   USER    NCPUS       RSV_HOSTS
user1#1      user        user1  user2        1         hostA:1
Active time with this configuration:  0 hour  0 minute 24 second
------------------------ Configuration 2 ------------------------
RSVID        TYPE      CREATOR   USER    NCPUS       RSV_HOSTS
user1#1      user        user1  user2        1         hostA:1
Active time with this configuration:  0 hour  1 minute 58 second
------------------------ Configuration 3 ------------------------
RSVID        TYPE      CREATOR   USER    NCPUS       RSV_HOSTS
user1#1      user        user1  user1        2         hostA:2
Active time with this configuration:  0 hour  1 minute 34 second
------------------------ Configuration 4 ------------------------
RSVID        TYPE      CREATOR   USER    NCPUS       RSV_HOSTS
user1#1      user        user1  user1        1         hostA:2
Active time with this configuration:  0 hour  2 minute 30 second

The following reservation (user2#0) has one time modification during its life time. The original one has the scope of one user (user2) and one host (hostA) with one slot; the modification changes the user to user3.

bacct -U user2#0
Accounting about advance reservations that are:
  - accounted on all advance reservation IDs:
  - accounted on advance reservations created by all users:
--------------------------- SUMMARY -------------------------
RSVID:                         user2#0
TYPE:                          user
CREATOR:                       user2
Total number of jobs:          1
Total CPU time consumed:       5.0 second
Maximum memory of a job:       1.7 MB
Maximum swap of a job:         7.5 MB
Total active time:             2 hour    0 minute    0 second
------------------------ Configuration 0 ------------------------
RSVID        TYPE      CREATOR   USER    NCPUS       RSV_HOSTS
user1#0      user      user2     user2       1       hostA:1
Active time with this configuration:  1 hour  0 minute  0 second
------------------------ Configuration 1 ------------------------
RSVID        TYPE      CREATOR   USER    NCPUS       RSV_HOSTS
user1#0      user      user2     user3       1       hostA:1
Active time with this configuration:  1 hour  0 minute  0 second