-jobaff
Specifies the affinity preferences for the job.
Categories
schedule
Synopsis
bsub -jobaff "[! | # | ~]attribute_name ..."bsub -jobaff "attribute([! | # |
~]attribute_name ...)"
bsub -jobaff "[! | # |
~]samehost(job_id)"
bsub -jobaff "[! | # |
~]samecu(job_id)"
Description
Use the bsub command with the -jobaff option to specify the affinity preferences for the job:
- [! | # | ~]attribute_name ...
- Use no keywords to specify the preferences for hosts on which LSF would
run the current job based on host attributes. Use a space to separate multiple attributes.
Specifying the following special characters before the attribute name indicates the following preferences:
- Default (no special character): It is preferred for the host to have this attribute.
- !: It is preferred for the host to not have this attribute.
- #: It is mandatory for the host to have this attribute.
- ~: It is mandatory for the host to not have this attribute.
- attribute([! | # | ~]attribute_name ...)
- Using the attribute keyword is the same as using no keywords (that is, using the attribute keyword specifies the preferences for hosts on which LSF would run the current job based on host attributes).
- [! | # | ~]samehost(job_id)
- Use the samehost keyword to specify the preference for the job to run on
the same host on which another job with the specified job ID runs. The job ID can be a simple job or
array job element, but you cannot specify multiple job IDs. The
SAME_JOB_AFFINITY parameter must be set to Y or
y in the lsb.params file to use the
samehost keyword.
Specifying the following special characters before the samehost keyword indicates the following preferences:
- Default (no special character): It is preferred for the job to run on the same host on which the specified job runs.
- !: It is preferred for the job to not run on the same host on which the specified job runs.
- #: It is mandatory for the job to run on the same host on which the specified job runs.
- ~: It is mandatory for the job to not run on the same host on which the specified job runs.
- [! | # | ~]samecu(job_id)
- Use the samecu keyword to specify the preference for the job to run on a
compute unit on which another job with the specified job ID runs. The job ID can be a simple job or
array job element, but you cannot specify multiple job IDs. The
SAME_JOB_AFFINITY parameter must be set to Y or
y in the lsb.params file to use the
samecu keyword.
Specifying the following special characters before the samecu keyword indicates the following preferences:
- Default (no special character): It is preferred for the job to run on the same compute unit on which the specified job runs.
- !: It is preferred for the job to not run on the same compute unit on which the specified job runs.
- #: It is mandatory for the job to run on the same compute unit on which the specified job runs.
- ~: It is mandatory for the job to not run on the same compute unit on which the specified job runs.
Note: If you submit a job with a samehost or samecu
affinity for a job that is finished and there are no other unfinished jobs that reference this
finished job at submission time, LSF cleans
the finished job's allocation host information from the job scheduler. With no host allocation
information for the finished job, your job submission with mandatory samehost
or samecu requirements would pend indefinitely, and if your job submission has
a preferred samehost or samecu requirement, the preferred
requirement is ignored.
See also
battr