[an error occurred while processing this directive] [an error occurred while processing this directive] [an error occurred while processing this directive]

showres


showres    [ARGS]    [<RESID>]

Purpose:  show detailed reservation information
 
Argument Description
-g show 'grep'-able output with nodename on every line
-h show usage help
-n display information regarding all nodes reserved by <RESID>
-o display all reservations which overlap <RESID> in time
-r display reservation timeframes in relative time mode
-s display summary reservation information
-v show verbose output. If used with the '-n' flag, the command will display all reservations found on nodes contained in <RESID>. Otherwise, it will show long reservation start dates including the reservation year.

 
Parameter Description
RESID ID of reservation of interest - optional

Access

    This command can be run by any Maui administrator, or by any valid user if the parameter RESCTLPOLICY is set to ANY.
 

Description

    This command displays all reservations currently in place within the Maui Scheduler. The default behavior is to display reservations on a reservation-by-reservation basis.
 

Example 1

> showres

Reservations

  Type       ReservationID  S       Start         End    Duration  Nodes  StartTime

   Job        fr4n01.902.0  S    -0:02:00     0:08:00     0:10:00     16  Sat Dec 14 08:29:09
   Job        fr5n11.176.0  S    -0:01:00     1:59:00     2:00:00      8  Sat Dec 14 08:30:09
   Job        fr5n11.177.0  S    -0:01:00     0:02:20     0:03:20      1  Sat Dec 14 08:30:09
   Job        fr5n12.179.0  S    -0:00:30     1:59:30     2:00:00      3  Sat Dec 14 08:30:39
   Job        fr5n12.180.0  S    -0:00:30     0:29:30     0:30:00      4  Sat Dec 14 08:30:39
   Job        fr5n13.155.0  S     0:00:00     2:00:00     2:00:00      4  Sat Dec 14 08:31:09
 Group               daf#0  -    10:00:00    INFINITY    INFINITY     16  Sat Dec 14 18:31:09
  User             loadl#0  -     0:00:00    30:00:00    30:00:00     16  Sat Dec 14 08:31:09
System            SYSTEM#0  -    20:00:00    30:00:00    10:00:00     40  Sun Dec 15 04:31:09

25 Reservations Located
This example shows all reservations on the system. The fields are as follows:
 
Type Reservation Type. This will be one of the following: Job, User, Group, Account, or System.
ReservationID This is the name of the reservation. Job reservation names are identical to the job name. User, Group, or Account reservations are the user, group, or account name followed by a number. System reservations are given the name SYSTEM followed by a number.
S State. This field is valid only for job reservations. It indicates whether the job is (S)tarting, (R)unning, or (I)dle.
Start Relative start time of the reservation. Time is displayed in HH:MM:SS notation and is relative to the present time.
End Relative end time of the reservation. Time is displayed in HH:MM:SS notation and is relative to the present time. Reservation that will not complete in 1,000 hours are marked with the keyword INFINITY.
Duration Duration of the reservation in HH:MM:SS notation. Reservations lasting more than 1,000 hours are marked with the keyword INFINITY.
Nodes Number of nodes involved in reservation.
StartTime Time Reservation became active.

Example 2

> showres -n

Reservations on Sat Dec 14 08:31:09

            NodeName    Type      ReservationID   JobState      Start   Duration            StartTime

   fr10n11.usc.edu     Job       fr4n02.126.0   Starting   -0:02:00    6:00:00  Sat Dec 14 08:29:09
   fr26n01.usc.edu     Job       fr4n02.126.0   Starting   -0:02:00    6:00:00  Sat Dec 14 08:29:09
    fr5n09.usc.edu     Job       fr4n02.126.0   Starting   -0:02:00    6:00:00  Sat Dec 14 08:29:09
                      System           SYSTEM#0        N/A   20:00:00   10:00:00  Sun Dec 15 04:31:09
   fr18n15.usc.edu     Job       fr4n02.126.0   Starting   -0:02:00    6:00:00  Sat Dec 14 08:29:09
   fr20n02.usc.edu     Job       fr4n02.126.0   Starting   -0:02:00    6:00:00  Sat Dec 14 08:29:09
                        User            loadl#0        N/A    0:00:00   30:00:00  Sat Dec 14 08:31:09
                       Group              daf#0        N/A   10:00:00   INFINITE  Sat Dec 14 18:31:09
   fr20n15.usc.edu     Job       fr4n02.126.0   Starting   -0:02:00    6:00:00  Sat Dec 14 08:29:09
                        User            loadl#0        N/A    0:00:00   30:00:00  Sat Dec 14 08:31:09
                       Group              daf#0        N/A   10:00:00   INFINITE  Sat Dec 14 18:31:09
   fr26n11.usc.edu     Job       fr4n02.126.0   Starting   -0:02:00    6:00:00  Sat Dec 14 08:29:09
   fr17n11.usc.edu     Job       fr4n02.126.0   Starting   -0:02:00    6:00:00  Sat Dec 14 08:29:09
   fr25n12.usc.edu     Job       fr4n02.126.0   Starting   -0:02:00    6:00:00  Sat Dec 14 08:29:09
   fr26n16.usc.edu     Job       fr4n02.126.0   Starting   -0:02:00    6:00:00  Sat Dec 14 08:29:09
    fr5n12.usc.edu     Job       fr4n02.126.0   Starting   -0:02:00    6:00:00  Sat Dec 14 08:29:09
                      System           SYSTEM#0        N/A   20:00:00   10:00:00  Sun Dec 15 04:31:09
    fr5n15.usc.edu     Job       fr4n02.126.0   Starting   -0:02:00    6:00:00  Sat Dec 14 08:29:09

This example shows reservations for nodes. The fields are as follows:
 
NodeName Node on which reservation is placed.
Type Reservation Type. This will be one of the following: Job, User, Group, Account, or System.
ReservationID This is the name of the reservation. Job reservation names are identical to the job name. User, Group, or Account reservations are the user, group, or account name followed by a number. System reservations are given the name SYSTEM followed by a number.
JobState This field is valid only for job reservations. It indicates the state of the job associated with the reservation.
Start Relative start time of the reservation. Time is displayed in HH:MM:SS notation and is relative to the present time.
Duration Duration of the reservation in HH:MM:SS notation. Reservations lasting more than 1000 hours are marked with the keyword INFINITY.
StartTime Time Reservation became active.

Example 3

> showres fr35n08.3360.0

Reservations

  Type       ReservationID  S       Start         End    Duration  Nodes  StartTime

   Job      fr35n08.3360.0  S    -8:24:06    15:35:54    24:00:00     16  Thu Mar  5 03:08:38

1 reservation located
In this example, information for a specific reservation (job) is displayed.
 

See Also:

     setres - create new reservations.
     releaseres - release existing reservations.
     diagnose -r  - diagnose/view the state of existing reservations.
     Reservation Overview - description of reservations and their use.
[an error occurred while processing this directive] [an error occurred while processing this directive]