MettleCI enables you to check in changed DataStage Repository-based assets (e.g. Jobs, ParameterSets...) to a Git repository. Git check-in can be performed either via a combination of the DataStage Classic Designer client and MettleCI Workbench or directly in MettleCI Workbench. The former option - while involving two pieces of software - is the quickest as it avoids manually filling out Job information (e.g. which Project it is part of) each time you commit a change.

Step-by-step guide

Integrate MettleCI Workbench with DataStage Designer Client

Follow the instruction in Getting Started with MettleCI Workbench to Integrate MettleCI Workbench with DataStage Client

Commit DataStage assets from the Designer Client

Once MettleCI Workbench and DataStage Client are integrated. You can start DataStage Client, and open a job.

With your job open on the DataStage canvas select the Tools → Custom → MettleCI - Commit Asset menu option.

Alternatively, you can go directly to Workbench and select your project (at the top of the screen) and selecting the Version Control men item from the sidebar, then click the [+] button on the top right hand corner to take you to the Git Commit page.

Select Work Item to associate with your commit

The form you’re presented with captures all the information necessary to perform your Commit to Git:

DataStage Project: This is a read-only value telling you which DataStage project you’re using (and consequently which Git repository you’re committing to)

Asset(s): This is where you specify the DataStage assets you’re committing. If you invoked this page from the MettleCi DataStage Designer menu item then this field will already include the Job canvas which had focus when you selected the menu item. You can add more assets by typing their name then selecting them from the 'New selection' box which appears below (Important: Don’t forget this second step!). Even though you may specify multiple assets we generally recomment making a single commit per asset, to make tracking changes to individual assets clearer.

Include Unit Tests: When selected, this checkbox will include (where available) the Unit Test Specifications and Unit Test Data for all specified DataStage Job assets in the commit.

Work Item(s):

Commit Message: Enter a short comment describing your changes.

When the form is complete click Check in.

Image Removed

Image Added

4. View Error Log 

When check-in completes, regardless of Pass or Fail, you can see the status from the VIEW LOGS at the bottom of the screen

Image Removed

Image Added

5. Commit History

You can also review the Commit History by clicking on "Version Control" from the sidebar, you can now see the success/failure history of last code check in

Image Removed

Image Added

Related articles