Command Reference Guide

Platform LSF Command Reference 277
lstcsh
load sharing tcsh for LSF
Synopsis
lstcsh [tcsh_options] [-L] [argument ...]
Description
lstcsh is an enhanced version of tcsh. lstcsh behaves exactly like tcsh, except
that it includes a load sharing capability with transparent remote job execution for
LSF.
By default, a
lstcsh script is executed as a normal tcsh script with load sharing
disabled.
If a command line is considered eligible for remote execution, LSF selects a suitable
host— typically a powerful and/or lightly loaded host that can execute the
command line correctly—and sends the command line to that host.
You can restrict who can use
@ for host redirection in lstcsh with the parameter
LSF_SHELL_AT_USERS in
lsf.conf.
Remote Hosts
lstcsh provides a high degree of network transparency. Command lines executed
on remote hosts behave the same as they do on the local host. The remote execution
environment is designed to mirror the local one as closely as possible by using the
same values for environment variables, terminal setup, current working directory,
file creation mask, and so on. Each modification to the local set of environment
variables is automatically reflected on remote hosts.
Shell variables, nice values, and resource limits are not automatically propagated to
remote hosts.
Job Control
Job control in lstcsh is exactly the same as in tcsh except for remote background
jobs.
lstcsh numbers background jobs separately for each of the hosts that are used
to execute them. The output of the built-in command
job lists background jobs
together with their execution hosts.
To bring a remote background job to the foreground, the host name must be
specified together with an at sign (
@), as in the following example:
fg %2 @hostA
Similarly, the host name must be specified when killing a remote job. For example:
kill %2 @hostA
Options
tcsh_options lstcsh accepts all the options used by tcsh. See tcsh(1) for the meaning of
specific options.
-L Executes a script with load sharing enabled.