Control-M for IBM DataStage

IBM DataStage enables you to construct data handling jobs that automate both ETL (extract, transform and load) and ELT (extract, load and transform) processes.

Control-M for IBM DataStage enables you to do the following:

• Connect to any supported IBM DataStage server from a single Control-M for IBM DataStage installation.

• Connect to any supported database from a single host with secure login, which eliminates the need to provide authentication.

• Manage IBM DataStage credentials in a secure connection profile.

• Introduce all Control-M capabilities to Control-M for IBM DataStage, including advanced scheduling criteria, complex dependencies, resource pools, lock resources, and variables.

• Integrate IBM DataStage jobs with other Control-M jobs into a single scheduling environment.

• Monitor the status, results, and output of IBM DataStage jobs.

• Attach an SLA job to the IBM DataStage jobs.

Configuring a Unix Host to Run DataStage Jobs

This procedure describes how to configure a Linux host to run IBM DataStage jobs.

Before You Begin

• Verify that IBM DataStage is installed on a Unix host.

• Verify that you have a dedicated IBM DataStage service account with minimum permissions and that you have admin access to configure an IBM DataStage user.

• Verify that you have a dedicated Unix operating system user for Control-M/Agent with membership to the DataStage group and permission to run the dsjob command.

Begin

1. Install Control-M/Agent 9.0.21.300 for the Unix user, as described in Installing Control-M/Agent on UNIX.

2. In the command prompt, run the following command to Initialize the IBM DataStage environment:
   ../dsenv

3. Run the dsjob command as follows:
   <Path to dsjob file>/dsjob

4. Run an IBM DataStage job as follows:
   <Path to dsjob file>/dsjob -run -jobstatus <project_name> <job_name>
   

Setting up Control-M for IBM DataStage

This procedure describes how to deploy the IBM DataStage plug-in, create a connection profile, and define an IBM DataStage job in Control-M SaaS and Automation API.

Before You Begin

• Verify that Java is installed, as described in Control-M External Java Installation.

• Verify that Automation API is installed, as described in Setting Up the API.

• Verify that Agent version 9.0.21.080 or higher is installed.

Begin

1. Run one of the following provision image commands:

   • Linux: ctm provision image datastage_linux_plugin.Linux

   • Windows: ctm provision image datastage_windows_plugin.Windows

2. Create an IBM DataStage connection profile in Control-M SaaS or Automation API, as follows:

   • Control-M SaaS: Create a Centralized Connection Profile with IBM DataStage Connection Profile Parameters

   • Automation API: ConnectionProfile:IBM DataStage

3. Define an IBM DataStage job in Control-M SaaS or Automation API, as follows:

   • Control-M SaaS: Create a Job with IBM DataStage Job parameters

   • Automation API: Job:IBM DataStage

Change Log

The following table provides details about changes that were introduced in new versions of this plug-in:

Plug-in Version	Details
1.0.01	Added return code handling of codes 21 and 255 (on Linux) or -2 (on Windows) in the Run RESET execution step.
1.0.00	Initial version