Setting up Db2 for z/OS to use with Jazz Team Server

When running the Jazz Team Server and the IBM® Engineering Lifecycle Management applications with Db2 for z/OS, you must create a Db2 storage group and several Db2 databases, depending on which Engineering Lifecycle Management applications you plan to use. You must also authorize a user to the storage group and databases.

About this task

The following steps must be performed before running the repository tools database builder utility, which creates the repository tables in each database. None of these steps is performed by the server database builder utility.
Creating a storage group
The storage group must be appropriate to the system. The following example shows a Db2 SQL create statement:
CREATE STOGROUP ELMSTG VOLUMES ('*') VCAT yourHlq ;
Notes:
  1. The storage group can be named something other than ELMSTG.
  2. yourHlq is the high-level qualifier of your Db2 files. It must exist on your system, and the Jazz Team Server user must have full access to it.
Creating databases
The databases must be created with UNICODE as the CCSID. Multiple databases are required to support the Jazz Team Server and the other Engineering Lifecycle Management applications. If you do not plan to use a particular application, you do not need to create that database. The following example shows Db2 SQL create statements:
Create the following Database for the Jazz Team Server
CREATE DATABASE JTS710 STOGROUP ELMSTG BUFFERPOOL BP16K0  
 CCSID UNICODE;  
 COMMIT;                                                

Create the following Database for the Engineering Workflow Management application
CREATE DATABASE CCM710 STOGROUP ELMSTG BUFFERPOOL BP16K0 
 CCSID UNICODE;                                          
 COMMIT;   

Create the following Database for the Engineering Test Management application
CREATE DATABASE QM710 STOGROUP ELMSTG BUFFERPOOL BP16K0 
 CCSID UNICODE;                                          
 COMMIT;

Create the following Database for the DOORS  application
CREATE DATABASE RM710 STOGROUP ELMSTG BUFFERPOOL BP16K0 
 CCSID UNICODE;                                          
 COMMIT;

Create the following Database for the LQE application
CREATE DATABASE LQE710 STOGROUP ELMSTG BUFFERPOOL BP16K0 
 CCSID UNICODE;                                          
 COMMIT;

Create the following Database for the DCC application
CREATE DATABASE DCC710 STOGROUP ELMSTG BUFFERPOOL BP16K0 
 CCSID UNICODE;                                          
 COMMIT;

Create the following Database for the GC application
CREATE DATABASE GC710 STOGROUP ELMSTG BUFFERPOOL BP16K0 
 CCSID UNICODE;                                          
 COMMIT;

Create the following Database for the LDX application
CREATE DATABASE LDX710 STOGROUP ELMSTG BUFFERPOOL BP16K0 
 CCSID UNICODE;                                          
 COMMIT;

Create the following Database for the ENI application
CREATE DATABASE ENI710 STOGROUP ELMSTG BUFFERPOOL BP16K0 
 CCSID UNICODE;                                          
 COMMIT;

Create the following Database for the Data Warehouse
CREATE DATABASE DW710 STOGROUP ELMSTG BUFFERPOOL BP16K0 
 CCSID UNICODE;                                          
 COMMIT;
Notes:
  1. You can replace the database names on the CREATE DATABASE statement with a different name.
  2. The database name is used later for the teamserver.properties com.ibm.team.repository.db.db2.dsn.dbname property or com.ibm.team.datawarehouse.db.db2.dsn.dbname settings.
  3. BP16K0 is an example of the buffer pool name. (On z/OS, a 16K page size or larger is required.) This buffer pool is used for creating tables. Table spaces are created in the default 16K buffer pool, unless you selected a larger buffer pool.
  4. You must create your Db2 database with UNICODE as the CCSID, otherwise the create database task fails and this message is displayed: CRJAZ0249I The database code page was set to "E" but should be "U". Recreate the database with the correct code page.
  5. You can define these databases in a single Db2 subsystem; however, you must also specify unique values for each teamserver.properties file directive com.ibm.team.repository.db.schemaPrefix to separate Jazz repositories as described in Customizing the Jazz Team Server and Engineering Lifecycle Management properties files for Db2 on z/OS.
  6. The reporting function in Engineering Lifecycle Management requires a data warehouse to operate. You should also add the property com.ibm.team.datawarehouse.db.schemaPrefix for the data warehouse tables if you plan to implement the data warehouse.
  7. You can specify database names and schema prefixes that are not tied to an Engineering Lifecycle Management release so that when you upgrade, the names are still meaningful and when you clone or copy the repositories, the clone names can remain the same. If you clone a database, you must keep the schema prefix the same length, as it is required to run the Engineering Lifecycle Management UNLOAD and LOAD utilities.
Authorizing user access to the databases

The server requires a user ID and password to access the repositories. The user ID and password are specified later in the teamserver.properties file. This user ID is not used to log on to the server. It is used only to provide authority for the server to access the Db2 for z/OS databases. Specifically, this user ID requires permissions as shown in the example. In this example, the user has the name jazz.

A user ID with SYSADM access to the databases has the appropriate access to run the server and create the required tables, indexes, and views using the repository tools -createTables command.

If your process does not allow a user ID with SYSADM access, you must grant additional permissions to the user ID. Examples of the GRANT statements are included in the following sample. (Comments are indicated by --.)

-- General 
GRANT USE OF STOGROUP ELMSTG TO jazz ;  
GRANT SELECT ON SYSIBM.SYSTABLES TO jazz ;
GRANT SELECT ON SYSIBM.SYSINDEXES TO jazz ;
GRANT SELECT ON SYSIBM.SYSDATABASE TO jazz ;
GRANT SELECT ON SYSIBM.SYSTABCONST TO jazz ;
GRANT SELECT ON SYSIBM.SYSAUXRELS TO jazz ; 
GRANT SELECT on SYSIBM.SYSKEYS TO jazz ;

-- Grant access to bufferpool.  Default bufferpool is used
-- for tablespaces and an additional grant for the default BP
-- may be needed if different from this one. 32K buffer pool
-- is needed for inline LOBs
GRANT USE OF BUFFERPOOL BP16K0 TO jazz ;  
GRANT USE OF BUFFERPOOL BE32K TO jazz ;

-- JTS – if the JTS repository will be on DB2 z/OS
GRANT DBADM ON DATABASE JTS710 TO jazz ; 

-- Engineering Workflow Management – if the Engineering Workflow Management repository will be on DB2 z/OS
GRANT DBADM ON DATABASE CCM710 TO jazz ; 

-- Engineering Test Management – if the Engineering Test Management repository will be on DB2 z/OS
GRANT DBADM ON DATABASE QM710 TO jazz ; 

-- Engineering Requirements Management DOORS Next – if the Engineering Requirements Management DOORS Next repository will be on DB2 z/OS
GRANT DBADM ON DATABASE RM710 TO jazz ;-- 

-- LQE – if the LQE repository will be on DB2 z/OS
GRANT DBADM ON DATABASE LQE710 TO jazz ;-- 

-- DCC – if the DCC repository will be on DB2 z/OS
GRANT DBADM ON DATABASE DCC710 TO jazz ;-- 

-- GC – if the GC repository will be on DB2 z/OS
GRANT DBADM ON DATABASE GC710 TO jazz ;-- 

-- LDX – if the LDX repository will be on DB2 z/OS
GRANT DBADM ON DATABASE LDX710 TO jazz ;-- 

-- ENI – if the ENI repository will be on DB2 z/OS
GRANT DBADM ON DATABASE ENI710 TO jazz ;-- 

If you plan to use Data Warehouse reporting where “DWX” 
--  equals the prefix you plan to use for the DW schemas
GRANT DBADM ON DATABASE DW710 TO jazz ; 

GRANT CREATEIN ON SCHEMA DWX_CFG TO jazz;
GRANT CREATEIN ON SCHEMA DWX_ODS TO jazz;
GRANT CREATEIN ON SCHEMA DWX_ASSET TO jazz;
GRANT CREATEIN ON SCHEMA DWX_SCHK TO jazz;
GRANT CREATEIN ON SCHEMA DWX_DW TO jazz;
GRANT CREATEIN ON SCHEMA DWX_CALM TO jazz;

COMMIT ;  
  

If you used an ID with DBADM and these additional privileges, you must also grant access to the Views after the tables are created. For details, see Creating database tables using repository tools.

In addition, if the value of field DBADM CREATE AUTH is set to NO on panel DSNTIPP during Db2 installation, you must grant SYSADM authorization to the user or change this setting.
GRANT SYSADM TO jazz ; 
COMMIT ;  
If the value of field DBADM CREATE AUTH is set to YES on panel DSNTIPP during Db2 installation, you can create the database with DBADM authority, but if you want the user to upgrade or recreate the database, you must grant SYSCTRL or SYSTEM DBADM authorization to the user, because the user needs authority to be able to execute DROP VIEW.
GRANT SYSCTRL TO jazz ; 
COMMIT ;  

In addition, as part of the data warehouse creation and server setup process, a report user is defined for the data warehouse. This user ID is defined in teamserver.properties using the property com.ibm.team.datawarehouse.report.user. This user ID is automatically granted connect and select access to the data warehouse tables as part of the configuration process.