Platform LSF Administration Guide Version 6.2

Interactive Batch Job Messaging
Administering Platform LSF
522
Interactive Batch Job Messaging
LSF can display messages to stderr or the Windows console when the following
changes occur with interactive batch jobs:
◆ Job state
◆ Pending reason
◆ Suspend reason
Other job status changes, like switching the job’s queue, are not displayed.
Limitations
Interactive batch job messaging is not supported in a MultiCluster environment.
Windows
Interactive batch job messaging is not fully supported on Windows. Only changes in the
job state that occur before the job starts running are displayed. No messages are
displayed after the job starts.
Configuring interactive batch job messaging
Messaging for interactive batch jobs can be specified cluster-wide or in the user
environment.
Cluster level
To enable interactive batch job messaging for all users in the cluster, the LSF
administrator configures the following parameters in
lsf.conf:
◆ LSB_INTERACT_MSG_ENH=Y
◆ (Optional) LSB_INTERACT_MSG_INTVAL
LSB_INTERACT_MSG_INTVAL specifies the time interval, in seconds, in which LSF
updates messages about any changes to the pending status of the job. The default
interval is 60 seconds. LSB_INTERACT_MSG_INTVAL is ignored if
LSB_INTERACT_MSG_ENH is not set.
User level To enable messaging for interactive batch jobs, LSF users can define
LSB_INTERACT_MSG_ENH and LSB_INTERACT_MSG_INTVAL as
environment variables.
The user-level definition of LSB_INTERACT_MSG_ENH overrides the definition in
lsf.conf.
Example messages
Job in pending
state
The following example shows messages displayed when a job is in pending state:
% bsub -Is -R "ls < 2" csh
Job <2812> is submitted to default queue <normal>.
<<Waiting for dispatch ...>>
<< Job's resource requirements not satisfied: 2 hosts; >>
<< Load information unavailable: 1 host; >>
<< Just started a job recently: 1 host; >>
<< Load information unavailable: 1 host; >>
<< Job's resource requirements not satisfied: 1 host; >>