Creating directories for Jazz Team Server and the Engineering Lifecycle Management applications

Edit online

The Jazz Team Server (JTS) and each of the IBM® Engineering Lifecycle Management (ELM) applications installed on z/OS require several directories in addition to the UNIX System Services directory created by the SMP/E installation.

One of the required directories is a working directory and the other required directories are used to store Jazz Team Server and ELM configuration files. There are sample members for each application in hlq.SBLZSAMP used to create and populate these directories with the required files from the SMP/E installed directory. The following table lists the sample member in hlq.SBLZSAMP associated with the installed application.

Table 1. Sample member names for each application installed on z/OS.
Installed application	Sample member
Change and Configuration Management (CCM) - HRCM702	BLZCPCCM
Global Configuration Management - HRGC702	BLZCPGC
IBM Jazz Reporting Service - HRRS702	BLZCPDCC, BLZCPRS, BLZCPLQE
Jazz Team Server (JTS) - HRJS702	BLZCPJTS
Link Index Provider - HRLI702	BLZCPLDX
Quality Management (QM) - HRQM702	BLZCPQM
IBM Engineering Lifecycle Optimization - Engineering Insights (ENI) - HRRE702	BLZCPRE
Requirements Management (RM) - HRRM702	BLZCPRM
WebSphere Liberty Profile - HRWL702	BLZCPWLP

You can run sample JCL members based on the components that you installed and plan to configure.

There are also sample members used for configuring the Build System Toolkit (BLZCPBTK), the Rational® Build Agent (BLZCPBFA), and the Build Manager (BLZCPPVM) on z/OS. For instructions on running those members, see:

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

Table 2. 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/jazz702
@workPath@	The Jazz Team Server working directory.	BLZWORK	/u/jazz702

You must use unique directory names for @confPath@ and @workPath@ if you want to maintain additional configurations for previous versions.

Space recommendations:

The JTS and ELM directories must have the following allocations:

@workPath@: 6000 cylinders 3390, for running the Jazz Team Server and ELM applications on z/OS. This figure might be larger than required if the server is not running on z/OS or if the server is not running all of the ELM applications. Allocate a file system that allows for significant expansion as your installation grows.
@confPath@: 300 cylinders 3390

RACF server file access requirements: The BLZCP* jobs will create directories that are owned by the user ID that runs the BLZCP* jobs. In addition, 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. The Jazz Team Server and ELM application directories require the following RACF® file access permissions so the server can function:

The user ID that runs the WebSphere® Application Server or WebSphere Liberty profile server must have read and write access to @confPath@ and @workPath@.
The user ID that runs the Jazz Team Server repository tools are run must have read and write access to @confPath@ and @workPath@.

The recommended approach to providing access to the working directories and configuration directories is to create a RACF group and assign the IDs to that group that are needed for the functions you plan to use.

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 listed in the following table:

Table 3. Additional variable names
Variable Name	Use	Default value
BLZBFAH	The installation directory of the Rational Build Agent.	/usr/lpp/jazz/v7.0.2/buildagent
BLZBFAC	The Rational Build agent configuration files directory.	/etc/jazz702/ccm
BLZJAVA	The location of the Java™ directory.	/usr/lpp/java/J8.0_64
BLZHOST	The fully qualified host name where the server is running .	Host.name
iconvLoc	The location of the iconv utility.	/bin/iconv

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

For each JOB, configure the sample member 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.