Command Reference Guide

Subcommands
158 Platform LSF Command Reference
3 slots are required. LSF tries to find as many slots as possible from host1. If 3 slots
are not available on
host1, then LSF tries to find the rest from host2. Hosts with
no slots available are removed from the list when the request is handled.
Subcommands
addhost [-n job_slots [-R "res_req"]] [-m "host_name ... | host_group ..."] reservation_ID
Adds hosts and slots on hosts into the original reservation allocation. The hosts can
be local to the cluster or hosts leased from remote clusters.
Adding a host without
-n reserves all available slots on the host that are not already
reserved by other reservations. You can specify the number of slots to be added
from the host list specified with
-n, but -n cannot be used alone. -m can be used
alone if no host group is specified in the list. You cannot specify
-R without with -n.
The specified slot number must be less than or equal to the available number of slots
for the hosts.
Only hosts can be added (
-m) to a system reservation. Slots cannot be added (-n) to
a system reservation.
disable -td "begin_date-end_date" | -tn [-f] reservation_ID
Disables specified periods, or instances, of a recurring advance reservation. The
start_date and end_date represent the start and end date of a period in which the
reservation should be disabled. These periods must take one of the following forms:
◆ yyyy:mm:dd-yyyy:mm:dd
◆ mm:dd-mm:dd - current year is assumed
◆ dd-dd - current month and year are assumed
The start date must be the same as or earlier than the end date.
If a reservation is disabled for a given day, then it does not become active on that
day, and remains inactive for the duration of the reservation time window.
Non-recurring reservations are able to use slots of the recurring reservation for the
duration of the time window.The
-tn option is a shortcut that disables a reservation
on the starting day of the next instance of the reservation time window; that is, the
instance that starts nearest in the future. If the reservation has already been disabled
for this day, the modification request is rejected.
For example, for a weekly reservation with time window from Wednesday 9 a.m. to
Friday 10 p.m, if the current day is Monday, then running the command with the
-tn option disables the reservation from Wednesday to Friday of the current week.
However, if the current day is Thursday, then the reservation is disabled from
Wednesday to Friday of the following week. If it is Wednesday, then whether to
disable in the current week or following week depends on whether or not the start
time of the instance has passed: if not then the reservation is disabled in the current
week, otherwise the following week’s reservation is disabled.
Running the disable command with the
-tn option twice on Monday tries to
disable twice in the current week. The second run has no effect, but is rejected
because the specified reservation instance is already disabled.