Control-M Control Module for InfoSphere DataStage

The Control-M Control Module (CM) for DataStage has a direct integration to the imbedded DataStage
Scheduler and can extract and insert jobs into DataStage’s scheduling tables. The CM connection profile,
the connection information to access DataStage including the userid & password as well as the
connection string to DataStage, is stored and encrypted in the Control-M DataStage. To create or modify
a connection profile, log into the Control-M Configuration Manager (CCM). Once you are connected
select Control-M for DataStage. Right click and select Connection Profile Management:

This window displays all the connection profiles, allows you to add or delete profiles, copy profiles and
validate the connection. Click the + to add a new profile or select one to display/modify:

Naming standards are important. Name the

profile something indicative of its purpose
to the DataStage instance to which it will
connect. This will make it easier when
selecting the profile you’ll need to define a
job. In this example we are selecting DV21.
We’ve used this example to align with the
function in the DataStage we are
performing. Double click and the screen on
the top of the next page appears.

1
 Control-M Control Module for InfoSphere DataStage

This connection profile requires the

DataStage connection information. To
add the profile, select local user, server
login or authentication file. The example
to the right shows Server Login. Add the
DataStage server name, domain name
(if any), user name, user password and
password.

Now you may validate your credentials.

Click the Test button in the lower left. It
will connect to DataStage using the
credentials you just provided and will
report success or failure in a pop-up
window:

If you have a valid connection you’ll get the screen

below. If not you’ll get an error. In that case verify your
credentials and try again.

Now click OK to close the Test window, and click OK

again to save the Connection Profile. You may now exit
Control-M CCM.

2
Control-M Control Module for InfoSphere DataStage
To create a new job flow, select the Planning domain on the left of the Control-M Interface:

You will see the work you

have previously opened
and saved and will have
the option to open other
workflows in Control-M by
Selecting Load Folders and
Jobs. We’ll cover that in a
moment. For now click
Blank Workspace on the
ribbon at the upper left of
the page. The screen
below will appear.

On the ribbon at the

top you will see the
types of jobs you
may use. This list is
controlled by role-
based security and
job type templates.
This list has all the
job types in it, but
you may exclude job
types for which you
have no need. For
our purpose, select
the drop-down
button on the job
types. You will get
the list on the top of
the next page.

3
 Control-M Control Module for InfoSphere DataStage
The folder can now be renamed to
something indicative of the flow’s
function, like #GCSS_Army or some
other appropriate name. Right click
on the folder and you get the
option to rename it; click
Properties:
You get this window:
Select DataStage and Drag the
job into the workspace. Control-
M will create the job and place
it in a folder. Folders are logical
groupings used to encapsulate
workflows for various reasons.
Customer-specific, function
specific, geographically specific,
application specific are some
examples of reasons to group
jobs. You may also wish to
create an application and/or
sub-application to further
quantify your workflow. Once
the job is in the workspace, we
can right-click it and add
properties for the job:
Smart folders – see button in upper right – may have scheduling criteria.
RUN DAILY, RUN FRIDAY, RUN WORKDAYS. We will not cover that here;
feel free to experiment with various options. Click in the Folder Name field
and type in an appropriate name. Select the Order method; Automatic
means it will be selected to run every day, None means the entire flow
must be triggered manually and Specific User Daily means the job is
ordered based on a pre-defined scheduled job that will evaluate this
folder’s schedule to see if it is eligible to run. Click OK when finished.
4
Control-M Control Module for InfoSphere DataStage

This example has a single job – IBM InfoSphere

DataStage_Job#1; double click it or right click and
select Properties to open it for edit. The window
below will open and we can begin building the job
based on the criteria supplied by our request for
from the DataStage job’s requestor.

Change the job’s name to something

meaningful and add a description if desired.
Select the host where the agent running the
DataStage Control Module is installed; in this
case it’s hou-ctmerp8. We get that from
Control-M Configuration Manager definition
for the CM for DataStage.

After adding the host, fill in the Application

and Sub-application. Once that’s done, click
on the button to fill in the DataStage
Connection Profile, Project and DataStage
Job. Add a Job Invocation ID as needed, then
click the Parameters Type dropdown and
select that value as needed. Once that is
complete you will need to update the Limits
setting and Job Output & Run Options
settings. You have successfully defined an
InfoSphere DataStage job. Click OK to close.