Setting DataStage environment definitions

An administrator or other user with appropriate permissions can set environment definitions in DataStage®.

For each PX instance, you can create multiple runtime environments in which you define environment variables and partitioning that are used when jobs are run. Developers select a runtime environment when they run their jobs.

A DataStage job is a flow that is designated to run with an environment definition. You use environment definitions to control jobs. The relationship between DataStage flows and DataStage jobs is one to many.

You can designate an environment definition as a runtime setting from the DataStage designer canvas or from the Jobs tab.

Setting new environment definitions

To set a new environment definition, complete the following steps:
  1. Click the Manage tab in your project, then click Environments in the Project menu.
  2. Click Templates, then click New template.
  3. Enter a name and optional description.
  4. Select DataStage for the configuration type.
  5. Select a hardware configuration from the drop-down menu.
    Note: The hardware configurations that are listed in the drop-down menu are based on the instances of DataStage that are available to you with the permissions that you have. If you want to create an environment definition based on an instance that is not shown in the drop-down menu, then you must first create that new instance. To create the new instance, you must have sufficient permissions.
  6. Select the number of partitions for the new environment, then optionally specify environment variables.
  7. Click Create.

Changing environment definitions

You can change an existing DataStage environment definition in two different ways: from within a DataStage flow or from within a project.

To change an environment definition from within a DataStage flow, complete the following steps:
  1. Click the Settings icon in the DataStage flow, then in the Design time settings, click Run.
  2. Select an environment definition from the drop-down menu. If only one environment definition is available, the name is listed, but no drop-down appears.
To change an environment definition from within a project, complete the following steps:
  1. Click the Manage tab in your project, then in the Project menu click Environments.
  2. Click the overflow menu next to the environment definition in the list that you want to edit, then click Edit. Edit the environment definition, then close the page.