Creating additional Build System Toolkit directories

On z/OS®, the Build System Toolkit requires several directories in addition to the z/OS UNIX System Services directory created by the SMP/E installation. One directory is a working directory and the other directories are used to store configuration files. There is a sample member (BLZCPBTK) in hlq.SBLZSAMP used to create and populate these directories with the required files from the SMP/E installed directory.

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/jazz703
@workPath@ The Jazz Team Server working directory. BLZWORK /u/jazz703
Note: The configuration and work 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.3/buildagent
BLZBFAC The Build agent configuration files directory /etc/jazz703/ccm
BLZJAVA The location of the Java™ directory /usr/lpp/java/J11.0_64
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 BLZCPBTK 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.