LSB_JOB_TMPDIR

Syntax

LSB_JOB_TMPDIR=directory

Description

Specifies the path and directory for temporary job output.

When LSB_JOB_TMPDIR is defined in lsf.conf, LSF uses the directory specified by LSB_JOB_TMPDIR on the execution host when a job is started and creates a job-specific temporary directory as a subdirectory of the LSB_JOB_TMPDIR directory.

Important: This directory is for LSF internal use only. Make sure that user's jobs and post-execution processes do not use this directory.
The name of the job-specific temporary directory has the following format:
  • For regular jobs:
    • Unix: $LSB_JOB_TMPDIR/jobID.tmpdir
    • Windows: %LSB_JOB_TMPDIR%\jobID.tmpdir
  • For array jobs:
    • Unix: $LSB_JOB_TMPDIR/arrayID_arrayIndex.tmpdir
    • Windows: %LSB_JOB_TMPDIR%\arrayID_arrayIndex.tmpdir

On UNIX, the directory has the permission 0700 and is owned by the execution user.

After adding LSB_JOB_TMPDIR to lsf.conf, use bctrld restart sbd all to reconfigure your cluster.

If LSB_SET_TMPDIR= Y, the environment variable TMPDIR will be set to the job-specific temporary directory.

Valid values

Specify any valid path up to a maximum length of 256 characters. The 256 character maximum path length includes the temporary directories and files that the system creates as jobs run. The path that you specify for LSB_JOB_TMPDIR should be as short as possible to avoid exceeding this limit.

The path can include the %H dynamic pattern, which is automatically replaced with the first execution host of the job.

UNIX

Specify an absolute path. For example:
LSB_JOB_TMPDIR=/usr/share/lsf_tmp

Windows

Specify a UNC path or a path with a drive letter. For example:
LSB_JOB_TMPDIR=\\HostA\temp\lsf_tmp
LSB_JOB_TMPDIR=D:\temp\lsf_tmp

Temporary directory for tasks launched by the blaunch command

By default, LSF creates the job-specific temporary directory only on the first execution host.

To create a job-specific temporary directory on each execution host, set LSB_SET_TMPDIR=Y so that the path of the job-specific temporary directory is available through the TMPDIR environment variable, or set LSB_SET_TMPDIR to a user-defined environment variable so that the path of the job-specific temporary directory is available through the user-defined environment variable.

Tasks launched through the blaunch distributed application framework make use of the job-specific temporary directory:
  • When the job-specific temporary directory environment variable is set on the first execution host, the blaunch framework propagates this environment variable to all execution hosts when launching remote tasks
  • The job RES or the task RES creates the job-specific temporary directory if it does not already exist before starting the job
  • The directory created by the job RES or task RES has permission 0700 and is owned by the execution user
  • If the job-specific temporary directory was created by the task RES, LSF deletes the directory and its contents when the task is complete
  • If the job-specific temporary directory was created by the job RES, LSF deletes the directory and its contents when the job is done
  • If the job-specific temporary directory is on a shared file system, it is assumed to be shared by all the hosts allocated to the blaunch job, so LSF does not remove the directories created by the job RES or task RES

Default

By default, LSB_JOB_TMPDIR is not enabled. If LSB_JOB_TMPDIR is not specified in lsf.conf, this parameter is defined as follows:
  • On UNIX: $TMPDIR or /tmp
  • On Windows: %TMP%, %TEMP, or %SystemRoot%