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:
| 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/jazz710 |
| @workPath@ | The Jazz Team Server working directory. | BLZWORK | /u/jazz710 |
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:
| Variable Name | Use | Default value |
|---|---|---|
| BLZBFAH | The path prefix of the Build agent directory /buildagent | /usr/lpp/jazz/v7.1.0/buildagent |
| BLZBFAC | The Build agent configuration files directory | /etc/jazz710/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.