This command displays all reservations currently in place within Moab. The default behavior is to display reservations on a reservation-by-reservation basis.
Access
By default, this command can be run by any Moab administrator, or by any valid user if the parameter RSVCTLPOLICY is set to ANY.
Argument
Description
-f
show free (unreserved) resources rather than reserved resources. The
'-f' flag cannot be used in conjunction with the any other flag
-g
when used with the '-n' flag, shows 'grep'-able output with nodename on every line
-n
display information regarding all nodes reserved by <RSVID>
-o
display all reservations which overlap <RSVID> (in time and space) NOTE: not supported with '-n' flag
-r
display reservation timeframes in relative time mode
-v
show verbose output. If used with the '-n' flag, the command will
display all reservations found on nodes contained in <RSVID>. Otherwise, it will show long reservation start dates including the reservation year.
Parameter
Description
RSVID
ID of reservation of interest - optional
Example 1
The above 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
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
In this example, information for a specific reservation (job) is displayed.
