Creating an IBM® i translator

Create a translator to define the commands to run on all the buildable files for a language definition.

Before you begin

Before you begin this task, you must create a project area.
Restriction: Before you can create, modify, or delete a translator, you must have permission to modify the translator. You can manage these permissions from the Project Configuration node on the Process Configuration tab in the Project Area editor.
Note: If you created a translator with the Rational Team Concert version 3.0.1.x client, you must update to version 4.0 or later and change that translator. The client preserves your version 3.0.1.x translator output name.

About this task

You can create a translator one of two ways:
  1. Expand these nodes in the Team Artifacts navigator: Enterprise Extensions > System Definitions > IBM i > Language Definitions > Translators.
  2. From the main menu, select File > New > Other > Enterprise Extensions > IBM i > Translator.

The following task describes how to create a translator from the Translators node in the Team Artifacts navigator.


  1. From the Team Artifacts view, select your repository connection and log in to your project area.
  2. Expand your project area node, and then expand Enterprise Extensions > System Definitions > IBM i > Language Definitions > Translators.
  3. Right-click the Translators node and click New Translator.
    The Translator editor opens with two tabs: General and History.
  4. In the Name field of the Translator editor, provide a name for the translator.
  5. On the General tab, specify the following attributes:
    1. Optional: On the General tab, in the Description field, provide a brief description of your new translator.
    2. If you select the Inspect built object and update build map option, Link-Edit support is enabled for the translator.
    3. If you made changes to this translator that do not require a full analysis of buildable files, click the Ignore changes to this system definition for dependency builds check box.
      For more information about analysis of buildable files, see Running dependency builds on z/OS and IBM i systems.
    4. To use a search path other than the default search path in the build definition, select Override build definition search path in the Search path section and complete these steps:
      1. Click Browse to select a specific search path or a search path build property.
      2. In the Select Search Path pane, select either Search path or Build property. To select a search path, click Browse and choose the search path that you want to use for this translator. If you select Build property, enter a search path build property that is defined in the build definition. Specify the property name in the form of ${}.
    5. In the Output Object section, specify a name and type of target output object. In the Deployment type or variable field, you can enter either a deployment type, or a variable that exists in the translator you are editing. Optionally, select the Rename output object check box to modify the translator output name by using a pattern or variable. For details about translator output pattern rules, see Translator output pattern rules.
    6. In the Variables section, click Add to create variables and values for the translator to use. You can also edit or remove existing variables.
    7. In the Commands section, enter the commands that you want the translator to run, depending on whether the output object exists.
  6. On the History tab, you can see all changes made over time by different users to the translator. You can review the state of the translator at any point in time, which is useful for debugging and fixing dependency build problems.
  7. To save your new translator, click Save .

What to do next

You can also duplicate any translator. To duplicate a translator, complete the following steps:
  1. Open the Team Artifacts view.
  2. Expand the Translators node.
  3. Right-click the translator to duplicate and click Duplicate.
  4. In the Duplicate system definition window, in the Name field, provide a name for the duplicate translator.
  5. To duplicate the translator, click OK. The new duplicate translator is displayed under the Translators node. If it is not, refresh the view.