# IBM Parallel Environment

This section describes how to set up a run configuration using IBM Parallel Environment as a PTP target system configuration

When running a parallel application with IBM PE, first create a C/C++/Fortran project, and build it. For more information, see

- Introduction to Creating MPI Projects - introduction to creating a simple project, including a synchronized project
- Synchronized Projects - more detail on creating and building projects on remote machines

As described in Running Parallel Programs, next create a run configuration via Run > Run Configurations ... and create a new Parallel Application.

The specifics for running an IBM PE parallel application with PTP are specified on the Resources tab of the run configuration. For Target System Configuration, select IBM Parallel Environment

Then specify a connection. If you have already specified a connection, e.g. for a Synchronized Project or a remote project, it will be selected already. If you are launching a local application (on the same machine where Eclipse is running), select Local for the Connection Type.

> See Creating Remote Connections and Local Connections

> Note: To edit connection information after a connection has been created, e.g. to change user name or password, see the Editing Remote Connections.

After selecting IBM PE, the Resources tab will be filled with information specific to this target configuration. This area usually (depending on the target system configuration) includes further tabs to segment the other information you can provide. Fill in the IBM PE options you need. Here we specify, on the first sub-tab Tasks, to use LoadLeveler scheduling, the number of tasks, nodes, and tasks per node.

Text fields are an easy way to specify information that will be passed to IBM PE when the job is submitted/launched. Hover over a text field to see additional information about the data value, including the environment variable that will be populated with the values you enter.

To see the information that will be passed, via environment variables etc., to the target system, click on the View Configuration button at the bottom of the Resources tab area.

Fill in other information on other tabs as needed. For example, to fill in a LoadLeveler node allocation pool, pool id, use the Nodes tab.

For Environment variables that don't have a corresponding text field or other way to enter the information in the UI, you can use the Environment tab. For example, to fill in a LoadLeveler reservation id, create a new environment variable by clicking on the New button. Enter the name and value for the variable and click the OK button. The environment variable will be submitted with the job.

Now continue with the run configuration setup for running your parallel application by specifying the Application program on the Application tab, and any other information required.

Back to Top | Back to Table of Contents