lstcsh supports two built-in commands to control load sharing, lsmode and connect.
lsmode [on|off] [local|remote] [e|-e] [v|-v] [t|-t]The lsmode command reports that LSF is enabled if lstcsh was able to contact LIM when it started up. If LSF is disabled, no load-sharing features are available.
The lsmode command takes a number of arguments that control how lstcsh behaves.
lsmode
lsmode
IBM Platform LSF 9.1.3.0 build 213132, Feb 23 2013
Copyright International Business Machines Corp, 1992-2013.
US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
binary type: linux2.6-glibc2.3-x86_64
LSF enabled, local mode, LSF on, verbose, no_eligibility_verbose, notiming.[on | off]
Turns load sharing on or off. When turned off, you can send a command line to a remote host only if force eligibility is specified with @.
The default is on.
[local | remote]
Sets lstcsh to use local or remote mode.
The default is local.
[e | -e]
Turns eligibility verbose mode on (e) or off (-e). If eligibility verbose mode is on, lstcsh shows whether the command is eligible for remote execution, and displays the resource requirement used if the command is eligible.
The default is off.
[v | -v]
Turns task placement verbose mode on (v) or off (-v). If verbose mode is on, lstcsh displays the name of the host on which the command is run, if the command is not run on the local host. The default is on.
[t | -t]
Turns wall-clock timing on (t) or off (-t).
If timing is on, the actual response time of the command is displayed. This is the total elapsed time in seconds from the time you submit the command to the time the prompt comes back.
This time includes all remote execution overhead. The csh time built-in does not include the remote execution overhead.
This is an impartial way of comparing the response time of jobs submitted locally or remotely, because all the load sharing overhead is included in the displayed elapsed time.
The default is off.
connect [host_name]lstcsh opens a connection to a remote host when the first command is executed remotely on that host. The same connection is used for all future remote executions on that host.
The connect command with no argument displays connections that are currently open.
The connect host_name command creates a connection to the named host. By connecting to a host before any command is run, the response time is reduced for the first remote command sent to that host.
lstcsh has a limited number of ports available to connect to other hosts. By default each shell can only connect to 15 other hosts.
connect
CONNECTED WITH SERVER SHELL
hostA +
connect hostB
Connected to hostB
connect
CONNECTED WITH SERVER SHELL
hostA +
hostB -In this example, the connect command created a connection to host hostB, but the server shell has not started.