JOB_SPOOL_DIR

Syntax

JOB_SPOOL_DIR=dir

Description

Specifies the directory for buffering batch standard output and standard error for a job.

When JOB_SPOOL_DIR is defined, the standard output and standard error for the job is buffered in the specified directory.

Files are copied from the submission host to a temporary file in the directory specified by the JOB_SPOOL_DIR on the execution host. LSF removes these files when the job completes.

If JOB_SPOOL_DIR is not accessible or does not exist, files are spooled to the default directory $HOME/.lsbatch.

For bsub -is and bsub -Zs, 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, and JOB_SPOOL_DIR is specified, bsub -is cannot write to the default directory LSB_SHAREDIR/cluster_name/lsf_indir, and bsub -Zs cannot write to the default directory LSB_SHAREDIR/cluster_name/lsf_cmddir, and the job will fail.

As LSF runs jobs, it creates temporary directories and files under JOB_SPOOL_DIR. By default, LSF removes these directories and files after the job is finished. See bsub for information about job submission options that specify the disposition of these files.

On UNIX, specify an absolute path. For example:
JOB_SPOOL_DIR=/home/share/lsf_spool
On Windows, specify a UNC path or a path with a drive letter. For example:
JOB_SPOOL_DIR=\\HostA\share\spooldir
or
JOB_SPOOL_DIR=D:\share\spooldir
In a mixed UNIX/Windows cluster, specify one path for the UNIX platform and one for the Windows platform. Separate the two paths by a pipe character (|):
JOB_SPOOL_DIR=/usr/share/lsf_spool | \\HostA\share\spooldir

Valid value

JOB_SPOOL_DIR can be any valid path.

The entire path including JOB_SPOOL_DIR can up to 4094 characters on UNIX and Linux or up to 255 characters for Windows. This maximum path length includes:
  • All directory and file paths attached to the JOB_SPOOL_DIR path

  • Temporary directories and files that the LSF system creates as jobs run.

The path you specify for JOB_SPOOL_DIR should be as short as possible to avoid exceeding this limit.

Note: The first path must be UNIX and second path must be Windows.

Default

Not defined

Batch job output (standard output and standard error) is sent to the .lsbatch directory on the execution host:
  • On UNIX: $HOME/.lsbatch

  • On Windows: %windir%\lsbtmpuser_id\.lsbatch

If %HOME% is specified in the user environment, uses that directory instead of %windir% for spooled output.