LSF Version 7.3 - Administering Platform LSF

File Spooling for Job Input, Output, and Command Files
684 Administering Platform LSF
For more information
See the Platform LSF Configuration Reference for information about the
LSB_MAILSIZE environment variable and the LSB_MAILTO,
LSB_MAILSIZE_LIMIT parameters in
lsf.conf, and JOB_SPOOL_DIR in
lsb.params.
File Spooling for Job Input, Output, and Command Files
About job file spooling
LSF enables spooling of job input, output, and command files by creating directories
and files for buffering input and output for a job. LSF removes these files when the
job completes.
You can make use of file spooling when submitting jobs with the
-is and -Zs
options to
bsub. Use similar options in bmod to modify or cancel the spool file
specification for the job. Use the file spooling options if you need to modify or
remove the original job input or command files before the job completes. Removing
or modifying the original input file does not affect the submitted job.
NOTE: The file path for spooling job input, output, and command files 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).
File spooling is not supported across MultiClusters.
Specifying job input files
Use the bsub -i input_file and bsub -is input_file commands to get the
standard input for the job from the file path name specified by input_file. The path
can be an absolute path or a relative path to the current working directory. The
input file can be any type of file, though it is typically a shell script text file.
LSF first checks the execution host to see if the input file exists. If the file exists on
the execution host, LSF uses this file as the input file for the job.
If the file does not exist on the execution host, 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.
The
-is option of bsub spools the input file to the directory specified by the
JOB_SPOOL_DIR parameter in
lsb.params, and uses the spooled file as the input
file for the job.
Use the
bsub -is command if you need to change the original input file before the
job completes. Removing or modifying the original input file does not affect the
submitted job.