Creating additional Rational Build Agent directories

Edit online

On z/OS® , the Rational Build Agent requires several directories in addition to the z/OS UNIX System Services directory created by the SMP/E installation.

One of the additional directories is a working directory and the other directories are used to store configuration files. A sample member (BLZCPBFA) in hlq.SBLZSAMP is used to create and populate these directories with the required files from the SMP/E installed directory. To fully configure the build agent, you also need to submit and run BLZCPBTK. See Creating additional Build System Toolkit directories.

The following three symbolic names are used throughout this guide to indicate the following directories:

Table 1. Symbolic names for directories
Symbolic name	Use	Variable in BLZCP* jobs	Default directory
@pathPrefix@	The path prefix specified during the SMP/E installation.	BLZHOME
@confPath@	The Jazz® Team Server configuration files directory.	BLZCONF	/etc/jazz703710
@workPath@	The Jazz Team Server working directory.	BLZWORK	/u/jazz703710

Note: The Jazz Team Server and CCM application directories require RACF file access permissions. For details, see Security on z/OS systems.

In addition to creating and populating these directories, the sample jobs provided also perform several required customizations. The variables mentioned in the symbolic name table, must be set in several places in each job. In addition there are other variables that might need to be set that are listed in the following table:

Table 2. Variable names and usages
Variable Name	Use	Default value
BLZBFAH	The path prefix of the Build agent directory /buildagent	/usr/lpp/jazz/v7.0.37.1.0/buildagent
BLZBFAC	The Build agent configuration files directory	/etc/jazz703710/ccm
iconvLoc	The location of the iconv utility	/bin/iconv

The instructions contained in each configuration job will indicate which variables you must configure.

Configure member BLZCPBFA in hlq.SBLZSAMP using the instructions contained in the member. Use the SUBMIT command to submit the modified JCL and check the job log. Return codes of 0 indicate the configuration is correct.

Attention: The BLZCP* members contain the @confgrp@ and @workgrp@ variables, which must be set to the SAF groups that contain all of the user IDs that require write access to the configuration and work directories. You must also associate group IDs (GID) with these SAF groups.