Command Reference Guide

Platform LSF Command Reference 189
Gets the standard input for the job from specified file. Specify an absolute or relative
path. The input file can be any type of file, though it is typically a shell script text file.
Unless you use
-is, you can use the special characters %J and %I in the name of the
input file.
%J is replaced by the job ID. %I is replaced by the index of the job in the
array, if the job is a member of an array, otherwise by 0 (zero). The special
characters
%J and %I are not valid with the -is option.
NOTE: The file path can contain up to 4094 characters for UNIX and Linux, or up to 255 characters
for Windows, including the directory, file name, and expanded values for %J (job_ID) and %I
(index_ID).
If the file exists on the execution host, LSF uses it. Otherwise, LSF attempts to copy
the file from the submission host to the execution host. For the file copy to be
successful, you must allow remote copy (
rcp) access, or you must submit the job
from a server host where RES is running. The file is copied from the submission
host to a temporary file in the directory specified by the JOB_SPOOL_DIR
parameter in
lsb.params, or your $HOME/.lsbatch directory on the execution
host. LSF removes this file when the job completes.
By default, the input file is spooled to
LSB_SHAREDIR/cluster_name/lsf_indir. If
the
lsf_indir directory does not exist, LSF creates it before spooling the file. LSF
removes the spooled file when the job completes. Use the
-is option if you need to
modify or remove the input file before the job completes. Removing or modifying
the original input file does not affect the submitted job.
If JOB_SPOOL_DIR is specified, the
-is option spools the input file to the
specified directory and uses the spooled file as the input file for the job.
JOB_SPOOL_DIR can be any valid path up to a maximum length up to 4094
characters on UNIX and Linux or up to 255 characters for Windows.
JOB_SPOOL_DIR must be readable and writable by the job submission user, and it
must be shared by the master host and the submission host. If the specified
directory is not accessible or does not exist,
bsub -is cannot write to the default
directory
LSB_SHAREDIR/cluster_name/lsf_indir and the job fails.
-J job_name | -J "job_name[index_list]%job_slot_limit"
Assigns the specified name to the job, and, for job arrays, specifies the indices of the
job array and optionally the maximum number of jobs that can run at any given
time.
The job name does not need to be unique.
Job names can contain up to 4094 characters for UNIX and Linux, or up to 255
characters for Windows.
To specify a job array, enclose the index list in square brackets, as shown, and
enclose the entire job array specification in quotation marks, as shown. The index
list is a comma-separated list whose elements have the syntax start[-end[:step]]
where start, end and step are positive integers. If the step is omitted, a step of one is
assumed. The job array index starts at one.
By default, the maximum number of jobs in a job array is 1000, which means the
maximum size of a job array (that is, the maximum job array index) can never
exceed 1000 jobs.