Migrating the legacy Java Pack jobs to Java Integration stage

Use the Connector Migration Tool to view and migrate the legacy Java Pack jobs to Java Integration stage. The Java Integration stage is backward compatible to the current Java Pack so that the existing Java classes work unmodified with the Java Integration stage. The Java Integration stage also supports the existing API that is exposed in the existing Java Pack. The Java Pack API will not be extended beyond its current capability. The supported migration paths are Java Transformer (Parallel) to Java Integration stage (Parallel) and Java Client (Parallel) to Java Integration stage (Parallel).

1. Choose Start > Programs > IBM InfoSphere Information Server > Connector Migration Tool.
2. Log in by specifying the host name where the Designer client runs and identifying the project where the Java Pack jobs are defined.
3. Select View > View all migratable jobs to display all of the jobs that are in the project and that can be migrated to use Java Integration stage. Jobs that do not contain any stages that can be migrated are excluded from the job list. An icon indicates the status of each job. A gray icon indicates that the job cannot be migrated. A gray icon with a question mark indicates that the job might be successfully migrated.
4. Perform the following steps to analyze jobs:
   1. Highlight the job in the job list.
   2. Expand the job in the job list to view the stages in the job.
   3. Select one or more jobs, and click Analyze.
   After analysis, the color of the job, stage, or property icon indicates whether or not it can be migrated.

   Green icon

   A green icon indicates that the job, stage, or property can be migrated.

   Red icon

   A red icon indicates that the job or stage cannot be migrated.

   Orange icon

   A orange icon indicates that a job or stage can be partially migrated and that a property in a stage has no equivalent in Java Integration stage.

   Gray icon

   A gray icon indicates that the job or stage is not eligible for migration.

   The Connector Migration Tool displays internal property names, rather than the names that the stages display. To view a table that contains the internal name and the corresponding display name for each property, from the IBM® InfoSphere® DataStage® and QualityStage® Designer client, open the Stage Types folder in the repository tree. Double-click the stage icon, and then click the Properties tab to view the stage properties.
5. Click Preferences and choose how to migrate the job:
   • Click Clone and migrate cloned job to make a copy of the job and then migrate the copy. The original job remains intact.
   • Click Back up job and migrate original job to make a copy of the job and then migrate the original job.
   • Click Migrate original job to migrate the job without making a backup.
6. Select the jobs and stages to migrate, and then click Migrate.

   The selected jobs are migrated to the Java Integration stage and are placed in the same folder as the original job. If logging is enabled, a log file that contains a report of the migration task is created. After a job is successfully migrated, a green checkmark displays beside the job name in the Jobs list to indicate that the job has been migrated.