LSF Version 7.3 - Using Platform LSF HPC

Submitting LAM/MPI Jobs
bsub command
Use bsub to submit LAM/MPI jobs:
bsub -a lammpi -n number_cpus [-q queue_name ] mpirun.lsf
[-pam "
pam_options "] [ mpi_options ] job [ job_options ]
◆ -a lammpi tells esub the job is a LAM/MPI job and invokes esub.lammpi.
◆ -n number_cpus specifies the number of processors required to run the job
◆ -q queue_name specifies a LAM/MPI queue that is configured to use the
custom termination action. If no queue is specified, the
hpc_linux queue is used.
◆ mpirun.lsf reads the environment variable LSF_PJL_TYPE=lammpi set by
esub.lammpi, and generates the appropriate pam command line to invoke
LAM/MPI as the PJL
◆ % bsub -a lammpi -n 3 -q hpc_linux mpirun.lsf /examples/cpi
A job named cpi is submitted to the hpc_linux queue. It will be dispatched and
run on 3 CPUs in parallel.
◆ % bsub -a lammpi -n 3 -R "select[mem>100]
rusage[mem=100:duration=5]" -q hpc_linux mpirun.lsf
/examples/cpi
A job named cpi is submitted to the hpc_linux queue. It will be dispatched and
run on 3 CPUs in parallel. Memory is reserved for 5 minutes.
Submitting a job with a job script
A wrapper script is often used to call the LAM/MPI script. You can submit a job using
a job script as an embedded script or directly as a job, for example:
% bsub -a lammpi -n 4 < embedded_jobscript
% bsub -a lammpi -n 4 jobscript
Your job script must use mpirun.lsf in place of the mpirun command.
For information on generic PJL wrapper script components, see Chapter 3, “Running
Parallel Jobs”.
See Administering Platform LSF for information about submitting jobs with job scripts.
Job placement with LAM/MPI jobs
The mpirun -np option is ignored. You should use the
LSB_PJL_TASK_GEOMETRY environment variable for consistency with other
Platform LSF MPI integrations. LSB_PJL_TASK_GEOMETRY overrides the
mpirun -np option.
The environment variable LSB_PJL_TASK_GEOMETRY is checked for all parallel
jobs. If LSB_PJL_TASK_GEOMETRY is set users submit a parallel job (a job that
requests more than 1 slot), LSF attempts to shape LSB_MCPU_HOSTS accordingly.