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 LocatedThis 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:09This 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 locatedIn 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.