Using the bsub Command to Submit Batch Jobs

The LSF bsub command may be used to submit jobs. The typical command format is

bsub bsub_args ansys_exe ansys_args

where

bsub_args are the options of the bsub command,
ansysEM_exe is the pathname of the Ansys Electromagnetics desktop executable to launch, and
ansys_args are the arguments to the Ansys Electromagnetics desktop executable.

bsub Arguments

The bsub command has a large number of options that may be used to control the submission process. Only a few options that are often used with Ansys Electromagnetics jobs are listed here. The following options may be used to submit serial or parallel LSF jobs.

-nmin_proc, max_proc or -nmin_proc

Submits a parallel job, specifying the number of processors (or slots) required for the job. Here, min_proc is the minimum number of processors, and max_proc is the maximum number of processors. If no maximum is specified, then exactly min_proc processors are requested. If PARALLEL_SCHED_BY_SLOT=Y is in lsb.params, it specifies the number of slots required to run the job, not the number of processors. If the -n command line option is not specified, then the job is submitted as a serial batch job.

-R "span[ptile=n]"

There are many ways to use the -R "res_req" option to the bsub command. This topic only covers -R "span[ptile=n]" here because this option is very useful for Ansys Electromagnetics jobs. When this option is specified, the LSF scheduler will allocate n processors (or slots) on each host to this job, even if more processors are available on the host.

-x

All hosts running this job operate in exclusive execution mode. The job will only run on a host having no other jobs running on that host. No other batch jobs will be started on a host while this job is running on that host.

See LSF documentation for a complete list of options for the bsub command.

Important: If the Ansys EM tool executable pathname (ansys_exe) or any of the arguments of the Ansys tool command (ansys_args) contain characters that are interpreted by the command shell, these special characters must be properly quoted to ensure that the correct command is launched by LSF. A similar problem may occur if any of the ansoft_args require single quote, double quote or space characters. Note that the Ansys Electronics Desktop command is processed by the shell twice: once when the bsub command is processed, and again when the job starts.