You must prepare your development environment before you can define builds using Antz.
The Jazz Build System contains a sample script named startbfa.sh that you can use to start the Rational Build Agent on your build machine. You can find this script in the pathPrefix/usr/lpp/jazz/v2.0/buildsystem/buildtoolkit/examples/startbfa directory, where pathPrefix is any prefix you specified during SMP/E installation. This script is required for starting the Rational Build Agent to specify the credentials that Rational Build Agent needs to connect to the Jazz Team Server for System z, and also to provide access to libraries needed for Antz and native compilation. If necessary, you can copy this script to a work directory to modify and execute it.
| Variable | Description |
|---|---|
| @pathPrefix@ | Directory path to prefix the Jazz directory. Note: This
is the prefix to the Jazz directory, so your prefix should include
any prefix you specified as part of the SMP/E installation, as well
as /usr/lpp.
|
| @javaPathPrefix@ | Directory path to the IBM 31-bit SDK for z/OS Java 2 Technology Edition V5 |
| @yourUserid@ | The Jazz builder user ID |
| @yourPasswordFile@ | The Jazz password file |
| @zLang@ | Encoding used in host files; for example, IBM-037. If you do not specify a value, the default value determined by your z/OS UNIX environment is used. |
| @timeout@ | Timeout value, in seconds, for build step execution. If you do not specify a value, the default value 300 seconds is used. |
| @stepLib@ | STEPLIB DD to use in your z/OS build; for example, SYS1.LINKLIB:CEE.SCEERUN |
| @bfaBinPath@ | Directory path to the Rational Build Agent executable directory |
| @bfaConfPath@ | Directory path to the Rational Build Agent configuration file directory |
| @yourHomeDirectory@ | Your home directory. Use this only when the HOME environment variable is not defined elsewhere. |
By default, the Rational Build Agent on the Jazz Team Server checks for build status every 60 seconds. If you want to check status more frequently, you can change this default value.
A data set definition is a new Jazz model object that is stored in the Rational Team Concert for System z repository. It is a container for information about a data set on the z/OS system. All data sets referenced by a build process must have a corresponding data set definition.
| Name | Type | Allocation Parameters | Description |
|---|---|---|---|
| COBOL | Destination data set for a zFolder | RECFM(F,B) LRECL(80) SPACE(1,1) CYL | Data set for COBOL source files |
| LINK | Destination data set for a zFolder | RECFM(F,B) LRECL(80) SPACE(1,1) CYL | Data set for link-edit source files |
| OBJ | New data set used for build | RECFM(F,B) LRECL(80) SPACE(1,1) CYL | Data set for object decks |
| LOAD | New data set used for build | RECFM(U) LRECL(0) SPACE(1,1) CYL | Data set for load modules |
| TEMPFILE | Temporary data set used for build | SPACE(5,5) TRACKS UNIT(SYSALLDA) | Temporary data sets required by the COBOL compiler |
| IGYCRCTL | Existing data set used for build | COBOL compiler module | |
| IEWBLINK | Existing data set used for build | Link-editor module | |
| SCEELKED | Existing data set used for build | Data set containing the link-edit stubs for C/C++, PL/I, COBOL, and Fortran languages and Language Environment-provided routines |
Translators are a new Jazz model object that are stored in the Rational Team Concert for System z repository. Translators describe an operation to 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 will be reiterated and executed for each file associated with that language definition.
You need the IGYCRCTL translator to compile a COBOL program.
The IGYCRCTL DD allocations table specifies the data set allocations that the module associated with the translator expects to find during a build. In this lesson, specify the following DD allocations for use by the COBOL compiler.
The IEWBLINK translator will be used to link-edit the Hello World! module.
To set up the IEWBLINK DD allocations table, complete the following steps:
Language definitions are a new Jazz model object that are stored in the Rational Team Concert for System z repository. Each file you build with Rational Team Concert for System z must have a language definition associated with it. For this lesson, you will define language definitions for COBOL compilation and link-editing.
A zComponent project is a collection of z/OS data sets. zFolders represent the data sets in your project. Perform the following steps to create the zFolders required for this tutorial.
You are now ready to define the artifacts your new project requires. You will create a COBOL source file, and then a file that contains the bind instructions for the link-editor. You will also associate these resources with language definitions.
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.