Platform LSF Reference Version 6.2

bsub
Platform LSF Reference
160
in the directory specified by the JOB_SPOOL_DIR parameter, 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 in
lsb.params 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 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 will fail.
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.
-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.
The job name can be up to 512 characters long.
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 job array index is 1000.
You may also use a positive integer to specify the system-wide job slot limit (the
maximum number of jobs that can run at any given time) for this job array.
All jobs in the array share the same job ID and parameters. Each element of the array is
distinguished by its array index.
After a job is submitted, you use the job name to identify the job. Specify
"job_ID[index]" to work with elements of a particular array. Specify
"job_name[index]" to work with elements of all arrays with the same name. Since job
names are not unique, multiple job arrays may have the same name with a different or
same set of indices.
-k "checkpoint_dir [checkpoint_period][method=method_name]"
Makes a job checkpointable and specifies the checkpoint directory. If you omit the
checkpoint period, the quotes are not required. Specify a relative or absolute path name.