< Previous | Next >

Lesson 5: Creating translators

Translators are Jazz™ model objects that are stored in the Rational Team Concert™ for System z® repository. Translators describe an operation that will be performed on a file during a build. A set of translators can be associated with a language definition. During a build, the set of translators associated with a language definition are reiterated and executed for each file associated with that language definition.
Complete the following tasks to practice creating translators:
  1. Create the IGYCRCTL translator.
  2. Configure the IGYCRCTL DD allocations table.
  3. Create the IEWBLINK translator.
  4. Configure the IEWBLINK DD allocations table.

Lesson 5 Part 1: Creating the IGYCRCTL translator and configuring the IGYCRCTL DD allocations table

You need the IGYCRCTL translator to compile a COBOL program.
  1. Create the IGYCRCTL translator.
  2. Configure the IGYCRCTL DD allocations table.

Creating the IGYCRCTL translator

Perform the following steps to create the IGYCRCTL translator:
  1. Expand the Language Definitions node in the Team Artifacts view.
  2. Expand the Translators node.
  3. Right-click to display the context menu, then select New Translator.
    1. Name the translator IGYCRCTL.
  4. In the General section, specify the following parameters:
    • Data set definition: IGYCRCTL. This is the data set definition that contains the executable module to be used by this translator. Click Browse to select this data set definition from the list of definitions you created in previous steps.
    • Default options: NODECK,OBJECT,LIB. These options correspond to the PARM parameter field of the JCL EXEC statement.
    • Maximum return code: 0

Configuring the IGYCRCTL DD allocations table

The IGYCRCTL DD allocations table specifies the data set allocations that the module associated with the translator expects to find during a build. Specify the following DD allocations for use by the COBOL compiler:
  1. Click Add next to the DD allocations table. Enter the following value:
    • DD name: SYSIN. This is the input COBOL source file.
  2. Select Translator input.
  3. Add a DD Allocation with the following value:
    • DD name: SYSLIN. This allocates the target object module data set.
  4. Select Data set definition for Data set. This indicates that this data set should be allocated using the characteristics specified in the related data set definition.
  5. Click Browse and select the OBJ data set definition.
  6. Select Append member name to data set name. This tells the build process to append the member name of the input data set to the data set name.
  7. Create a DD allocation with the name SYSPRINT, to be used by Antz to collect build output.
  8. Select Data set definition for Data set.
  9. Click Browse to select the TEMPFILE data set definition.
  10. Create DD allocations for the working data sets used by the COBOL compiler during compilation:
    1. Specify SYSUT1 as the DD name.
    2. Select Data set definition for Data set.
    3. Click Browse to select the TEMPFILE data set definition.
    4. Repeat steps a through c to create DD allocations for SYSUT2, SYSUT3, SYSUT4, SYSUT5, SYSUT6, and SYSUT7.
< Previous | Next >

Feedback