Command Reference Guide

Usage
278 Platform LSF Command Reference
There are three ways to run a lstcsh script with load sharing enabled:
- Execute the script with the
-L option
- Use the built-in command
source to execute the script
- Insert "
#!/local/bin/lstcsh -L" as the first line of the script (assuming you
install
lstcsh in /local/bin).
Using
@ or lsmode in a script does not enable load sharing if the script has not been
executed using one of these three ways.
Usage
In addition to the built-in commands in tcsh, lstcsh provides the following
built-in commands:
lsmode [on | off] [local | remote] [@] [v | -v] [e | -e] [t | -t] [connect
[host_name ...]] [
lsrtasks [lsrtasks_options]] [lsltasks [lsltasks_options]] [jobs]
on | off Turns load sharing on or off. When off, you can specify @ to send a command line
to a remote host.
local | remote Sets operation mode of lstcsh.
The default is
local.
local
Local operation mode. This is the default mode.
In this mode, a command line is eligible for remote execution only if all the
specified tasks are present in the remote task list in the user’s tasks file
$HOME/.lsftask, or if @ is specified on the command line to force specified tasks
to be eligible for remote execution.
Tasks in the local task list must be executed locally.
The local mode of operation is conservative, and can fail to take advantage of the
performance benefits and load balancing advantages of LSF.
The way
lstcsh handles tasks that are not present in the remote task list nor in the
local task list, depends on the mode of operation of
lstcsh (local or remote).
remote
Remote operation mode.
In this mode, a command line is considered eligible for remote execution only if
none of the specified tasks are present in the local task list in the user’s tasks file
$HOME/.lsftask.
Tasks in the remote list can be executed remotely.
The remote mode of operation is aggressive, and promotes extensive use of LSF.
The way
lstcsh handles tasks that are not present in the remote task list nor in the
local task list, depends on the mode of operation of
lstcsh (local or remote).
@ Specify @ to explicitly specify the eligibility of a command for remote execution.
The
@ may be anywhere in the command line except in the first position (which is
used to set the value of shell variables).
There are several ways to use
@: