Creating an IBM® i translator

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

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 ${my.build.property}.
   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 .