< Previous | Next >

Lesson 10: Creating a new build definition

Rational Team Concert™ for System z® provides a new build definition template called Antz – Rational® Build Agent. Use this template to define an Ant-based build to use on Rational Team Concert for System z using the Rational Build Agent.
  1. In the Team Artifacts view, right-click the Builds node and select New Build Definition.
  2. Click Next to create a new build.
  3. Specify a Build Definition ID and select the Antz - Rational Build Agent template.
  4. Click Next.
  5. Select Jazz Source Control - zOS. This specifies that you want to use the Rational Team Concert for System z file agent to extract the files from the repository and place them on the target build system.
  6. Click Next.
  7. Select Job Output Publishing. This enables translator output reporting, such as SYSPRINT, for this build definition.
  8. Click Finish.

Lesson 10 Part 2: Using the build definition editor

In the build definition editor, perform the following steps to configure your build definition:
  1. On the Overview tab, select RationalBuildAgent for the Supported Build Engines value.
  2. Make sure that the Build Agent tab contains the following values:
    • Hostname: Your build machine IP address or hostname
    • Port: 5555 or the port number you configured in your bfagent.conf file
    • User name: The z/OS RACF® user ID of the builder on the target build machine
    • Password and Confirm Password: The builder's z/OS RACF password
  3. After you have configured the Build Agent tab, click Test Connection to test the connection to your build agent. If the connection was successful, you should see results that are similar to these:
    Message: Socket created successfully.
    Authentication Pass.
    
    Platform: os/390 19.00 03
    Version: 7.1.2.0-0-0003
    PingResult: PingOk
    ExitStatus: 0
  4. On the Job Output Publishing tab, make sure that you select Publish job output logs.
    Note: A lot of build machine CPU time and server disk space are used to publish build results. You can modify the names of the data set definitions you want to publish by changing the teamz.build.publishoutput.dds build property, which is set by default to SYSPRINT,ANTPRINT in the build.xml file.
  5. On Jazz™ Source Control - zOS, set the following values:
    Build Workspace
    Click Select to select the repository workspace to be built.
    Load directory
    Specify an absolute path in USS to use to store non-MVS build artifacts such as the Antz build.xml file. The builder user ID must have read, write, and execute permissions on this directory.
    Data set prefix
    Specify the prefix you want to prepend to managed data sets. For example, if you specified BUILDER.TEST as the data set prefix, the data set BUILDER.TEST.COBOL will be allocated for the COBOL zFolder associated with the COBOL data set definition in previous steps.
  6. Set the Build File field on the Antz tab to the absolute USS path of the Antz build file. If you want to use the build.xml file in the zComponent Project you already created, the file path should be <load directory>/<project directory>/build.xml. If you named the zComponent Project DEMO, the path to the build file could be ${teamz.scm.fetchDestination}/DEMO/build.xml.
    Note: ${teamz.scm.fetchDestination} is a property whose value points to the directory you specified in the Load directory field of the Jazz Source Control - zOS tab.
  7. Click Save.
< Previous | Next >

Feedback