View reservations

Procedure

Use brsvs 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 *
In the TIME_WINDOW column:
  • A one-time reservation displays fields that are separated by slashes (month/day/hour/minute). For example:
    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. For example:
    5:18:0-5:20:0 *
In the NCPUS and RSV_HOSTS columns:
  • Remote reservations do not display details. For example:
    -/2048    hostA:-/1024
Parent topic: Use advance reservation

Show a weekly planner

Procedure

  1. Use brsvs -p to show a weekly planner for specified hosts using advance reservation. The all keyword shows the planner for all hosts with reservations.

    The output of brsvs -p is displayed in terms of 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:

    MAX indicates the configured maximum number of job slots for the host (MXJ defined in lsb.hosts).

    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 brsvs -z instead of brsvs -p to show only the weekly items that have reservation configurations. Lines that show all zero are omitted.
    For example:
    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

Show reservation types and associated jobs

Procedure

Use the -l option of brsvs 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

Show reservation ID

Procedure

Use bjobs -l to show the reservation ID used by a job: 
bjobs -l
Job <1152>, User <user1>, Project <default>, Status <PEND>, Queue <normal>,  
Reservation <user1#0>, Command <myjob>
Mon Nov 12 5:13:21 2009: Submitted from host <hostB>, CWD </home/user1/jobs>;
...

View historical accounting information for advance reservations

Procedure

Use the -U option of the bacct command to display accounting information about advance reservations.
bacct -U 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 (with bsub -U)

  • 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). For example:

      11/12/14/0-11/12/18/0

  • A recurring reservation displays fields that are separated by colons (day:hour:minute). For example:

    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 1 slot. The various modifications change the user to user2, then back to user1, adds, then removes 1 slot from the reservation.

Start of change 
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
End of change

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