qsub Arguments

The PBS qsub command has a large number of options for control of the submission process. In this section, we review the -l nodes=valuecommand line option with Ansys Electromagnetics parallel batch jobs.

This option or directive has the following format:

-l nodes=node_spec[+node_spec...][#suffix]

where node_spec is one of the following

nodename[:pc_spec[:pc_spec...]]

Host name of the specified node, followed by optional ppn or cpp specifiers.

[N][:property[:property...]][:pc_spec[:pc_spec...]]

Optional number of nodes, followed by optional node properties, followed by optional ppn or cpp specifiers. If the number N is omitted, then the default value of 1 host is used.

Here, the optional ppn or cpp specifiers pc_spec are of form:

ppn=X

Number of processes (tasks) per node. Default is 1 if not specified.

cpp=Y

Number of CPUs (threads) per process. Default is 1 if not specified.

The optional global suffix, #suffix, which applies to all hosts has one of the following values:

#excl

This suffix requests exclusive access to the allocated nodes.

#shared

This suffix requests shared (i.e., non-exclusive) access to the allocated nodes.

The total number of requested processes is determined by adding up the product of the number of nodes and the number of processes per node for each node_spec. In general, this should match the number of distributed engines specified in the Ansys Electromagnetics desktop -Machinelist num=num_distributed_enginescommand line option.

The number of CPUs per process (cpp) specified in the PBS qsub command line or in the PBS directives in the script file should generally match the number of processors per engine specified in the Desktop -batchoptions value.

See the PBS documentation for a complete list of options for the bsub command, and further information on running multi-node jobs.

qsub Arguments

Related Topics