Specifying Environment-Specific Options After Launching Prism

Sun HPC ClusterTools 3.0 supports two run-time environments, Platform Computing's Load Sharing Facility (LSF), and the Cluster Runtime Environment (CRE). Prism runs on both environments. If you want to determine which environment is in effect, execute the script /opt/SUNWhpc/etc/hpc_rte from a shell prompt. For example:

% hpc_rte
lsf

Once you have entered Prism, you can issue environment-specific commands to specify any bsub (when using the LSF environment) or mprun (when using the CRE environment) options that you want to apply to your message-passing program.

Prism stores these options, then applies them when you start up a multiprocess program. Specifying the setting of a bsub option via the bsubargs command, or an mprun option via the mprunargs command, overrides the setting of the same option you have established via the prism command line. If it is an option that has otherwise not been specified, it is added to the existing settings.

The strings given to bsubargs or mprunargs should not contain the -I, -Ip, or -n flags, because Prism internally generates values for them, and the results will be undefined.

Using bsubargs

To specify a preferred host by name after you have entered Prism in the LSF environment, use the bsubargs command. For example:

(prism all) bsubargs -m argos

To remove any existing bsub options you have specified, issue the command

(prism all) bsubargs off

Within Prism, this removes options you have set via the command line.

Issuing the bsubargs command with no options shows the current bsub options.

The bsubargs command accepts a single string argument. Since this argument is issued within Prism, using the shell-specific syntax appropriate for the -bsubargs option causes errors. Also, each time that you issue the bsubargs command, the previously specified bsub options are replaced. To keep a list of options in effect, you must specify the entire list whenever you change any item in that list.

Using mprunargs

To specify a preferred partition by name after you have entered Prism in the CRE environment, use the mprunargs command. For example:

(prism all) bsubargs -p delos

To remove any existing mprun options you have specified, issue the command

(prism all) mprunargs off

Within Prism, this removes options you have set via the command line.

Issuing the mprunargs command with no options shows the current mprun options.

The mprunargs command accepts a single string argument. Since this argument is issued within Prism, using the shell-specific syntax appropriate for the -mprunargs option causes errors.