Execute Connector Migration Tool Bamboo Task

The Connector Migration Tool is a utility provided as part of the Information Server product, and can be used to identify and optionally upgrade deprecated stages in DataStage jobs.

MettleCI provides an intelligent wrapper around the Connector Migration Tool to identify and upgrade the relevant jobs, also reporting issues that cannot be resolved by the Connector Migration Tool itself.

You can use the Execute Connector Migration Tool task to invoke the Connector Migration Tool and log its output to the Bamboo log.

Configuration Steps

1. Navigate to the Tasks configuration tab for the job (this will be the default job if creating a new plan).
2. Click the name of an existing Export DataStage Asset task, or click Add Task and then search 'DataStage' to easily locate the Export DataStage Asset task type, in order to create a new task.

3. Complete the following settings:

   Task Description	A description of the task, which is displayed in Bamboo
   Disable this task	Check, or clear, to selectively run this task
   Executable	From the pulldown list, choose a 'Datastage Capability'
   Domain	Enter the Domain of the Datastage instance (Host Name of the Services Tier)
   Server	Enter the Server of the Datastage instance (Host Name of the Engine Tier)
   Username	Enter the Datastage Username
   Password	Enter the Datastage Password
   Project name	DataStage Project the Connector Migration Tool is to be run against
   Optional parameters	Refer to step 3 of the Connector Migration Tool command line reference information for additional options that can be incorporated into the execution Note: the MettleCI function already uses the -d optional part of its default operation
   Unique CCMigrate Log Filename	Name of the log file generated by the Connector Migration Tool
   Root ISX Directory	File pattern to locate ISX files. Set to **/* for all files under the default location. Note: preferable to specify as a bamboo Artifact
   Max Threads	Sets the maximum number of concurrent executions of the Connector Migration Tool
   Fail plan when compile error	Conditionally abort the plan and return status of Fail if a migrated job fails to compile