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/jazz70
@workPath@ The Jazz Team Server working directory. BLZWORK /u/jazz70
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 Buildforge agent directory /buildagent /usr/lpp/jazz/v7.0/buildagent
BLZBFAC The Build Forge® agent configuration files directory /etc/jazz70/ccm
BLZJAVA The location of the Java™ directory /usr/lpp/java/J8.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.

video icon Video

Jazz.net channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community

Jazz.net
Jazz.net forums
Jazz.net library

support icon Support

IBM Support Community
Deployment wiki