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 in lsb.params, this option 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. We only cover -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.
If the Ansys EM tool executable pathname (ansys_exe) or any of the arguments of the Ansys tool command (anssys_args) contain characters which 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. See: Example Command Lines.