IBM Engineering Lifecycle Management Installation guide for z/OS IBM Note Before using this information, be sure to read the general information under “Notices for IBM Engineering Lifecycle Management” on page 127. This edition applies to version 7.0.1 of the IBM® Engineering Lifecycle Management products and to all subsequent releases and modifications until otherwise indicated in new editions. © Copyright International Business Machines Corporation 2008, 2020. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents Chapter 1. Installing on z/OS................................................................................. 1 SMP/E installation process.......................................................................................................................... 1 Checklist for z/OS installations....................................................................................................................3 Installation information for z/OS system programmers.............................................................................4 Setting up the JZOS batch launcher............................................................................................................9 Security on z/OS systems............................................................................................................................ 9 RACF security....................................................................................................................................... 10 Jazz Team Server security on z/OS systems....................................................................................... 12 Security for z/OS builds........................................................................................................................13 Installing the configuration utility............................................................................................................. 16 Chapter 2. Setting up the server on z/OS.............................................................. 19 Installing on z/OS systems........................................................................................................................ 19 Configuring your installation................................................................................................................ 19 Starting the configuration utility.......................................................................................................... 24 Running the configuration utility..........................................................................................................25 Setting up a Db2 database on a z/OS system........................................................................................... 35 Prerequisites........................................................................................................................................ 35 Setting up Db2 for z/OS for Jazz Team Server.................................................................................... 36 Customizing the Jazz Team Server and ELM properties files for Db2................................................ 39 Creating database tables..................................................................................................................... 42 Running UNLOAD and LOAD processes for backup............................................................................ 48 Deploying and starting the server on z/OS................................................................................................53 Running Jazz Team Server and the ELM applications on z/OS systems or WebSphere Liberty profile on z/OS.................................................................................................................................53 Chapter 3. Installing optional tools, clients, and samples on z/OS.........................63 Installing and configuring the Build System Toolkit on z/OS systems.....................................................63 Creating additional directories (required)........................................................................................... 63 Configuring the ISPF gateway for build, deployment, and promotion support..................................64 Installing the Rational Build Agent on z/OS systems............................................................................... 72 Creating additional Rational Build Agent directories.......................................................................... 72 Configuring the Rational Build Agent shell script................................................................................73 Completing the installation and running the Rational Build Agent.....................................................75 Using InetD to start the agent..............................................................................................................76 Configuring the agent........................................................................................................................... 78 Build Agent Lookup Service................................................................................................................. 79 Using the Rational Build Agent and Job Monitor to run builds using JCL...........................................80 Additional setup options that depend on the Build System Toolkit on z/OS...........................................95 Using the Jazz Build Engine on z/OS....................................................................................................95 Installing the context-aware search tool..................................................................................................96 Installing on z/OS systems.................................................................................................................. 97 Installing and configuring the IBM Developer for z Systems integration feature....................................98 File agent RSE miner............................................................................................................................ 98 Integrated client...................................................................................................................................99 Engineering Workflow Management..................................................................................................100 Installing the IBM Engineering Workflow Management ISPF client......................................................100 ISPF client security............................................................................................................................ 100 ISPF daemon configuration............................................................................................................... 107 Configuring and running the ISPF client on z/OS systems............................................................... 112 iii Chapter 4. What to do next................................................................................ 115 Installation verification process (IVP).................................................................................................... 115 Additional setup tips and tasks...............................................................................................................117 Chapter 5. Appendix.......................................................................................... 119 bfagent.conf file.......................................................................................................................................119 Notices for ELM..................................................................................................127 iv Chapter 1. Installing on z/OS SMP/E installation process IBM System Modification Program/Extended (SMP/E) installs software and software changes on your z/OS® systems. SMP/E is the tool for installing and maintaining software on z/OS systems. SMP/E controls software changes at the element level. Job Control Language (JCL) is submitted through 3270 emulation, which is also known as "green screen". This method is a standard installation method that is used by IBM WebSphere® Application Server for z/OS, Db2® for z/OS, and other z/OS products. The IBM Engineering Lifecycle Management (ELM) components for z/OS are provided in a compressed file that contains program directories and binary files: Program directories (PDF files) The program directories contain the instructions for installing the ELM applications on z/OS: IBM Engineering Workflow Management (EWM), IBM Engineering Test Management (ETM), and IBM Engineering Requirements Management DOORS® Next (DOORS Next). Each program directory is specific to each product, but follows a template. The program directories contain standard instructions for installing Jazz® Team Server and all of the common files on z/OS by using SMP/E. Use one of the program directories to complete the installation. The program directories are also available online. For more information, see the IBM Engineering Lifecycle Management v7.0.1 program directories for z/OS at https://www.ibm.com/support/pages/node/6209655. Remember: The program directories list specific directory path names. If you extract your files to a different location, you must update the path names to match your location. Binary files The binary files are the files to be uploaded to z/OS for the SMP/E installation process. Restrictions: • No compressed