Configuring the Jazz Team Server for a sample z/OS application

Edit online

Use this tutorial to practice the tasks that are required to configure a dependency build of a real application on your Jazz® Team Server and IBM® Engineering Workflow Management (EWM) Eclipse client. Learn how EWM is configured to build mainframe programs. Then practice the steps and use the features that this tutorial demonstrates, before you begin work on your own real applications.

After you complete this tutorial and set up your sample application, source code data is generated for that sample application. This source code data identifies any dependencies between source files, such as a COBOL program with a shared copybook. You can display this source code data using the source code data query editor in the Eclipse client. You can also use this source code data with the dependency build feature to indicate that you want to build only new or changed files. To use the dependency build feature, you need to firstly set up all required data set definitions, translators, and language definitions. To perform a dependency build, you need to create a build engine and a build definition, and use the system definitions generator to automate the creation of those definitions and translators. A link to the steps to run the system definitions generator is included in this tutorial.

For additional details on working with application files, see Enterprise Extensions features on Jazz.net.

Learning objectives

  1. Installing the Jazz Team Server
  2. Configuring the Jazz Team Server using the Engineering Workflow Management Web client
  3. Configuring the Engineering Workflow Management Eclipse client
  4. Importing and installing sample application projects
  5. Running the system definitions generator
  6. Verifying source code data scanning configuration

Time required

This tutorial could take you anywhere from two to five hours, depending on how many of the associated servers, clients, and build configuration tasks you attempt.

Installing the Jazz Team Server

Edit online

You need to have a Jazz Team Server with the EWM components installed. You can choose to install only those that your server configuration requires. Additional information is included with the PTFs.

Before you begin

A Jazz Team Server is needed. Refer to the topic Installing the IBM Engineering Lifecycle Management by using IBM Installation Manager for information of the general installation. If you want to install the server on your z/OS system, refer to this topic: Installing and configuring the server on z/OS® systems.

Configuring the Jazz Team Server using the Engineering Workflow Management Web client

Edit online

After you install and start your server, you can access the Web interface to perform administrative tasks such as managing users and configuring or troubleshooting the server.

Procedure

  1. Start your Web browser and go to https://host-name.example.com:9443/ccm/admin/;.
  2. https://host-name.example.com:9443/ccm/admin.
  3. Log in with ADMIN as both your user ID and password.
  4. Create a user.
  5. Create a project area.

What to do next

For the steps to create a Jazz user and project area, or for other Jazz administrative tasks, refer to this topic: Administering the Jazz Team Server.

Configuring the Engineering Workflow Management Eclipse client

Edit online

Before you can import sample application projects, you need to install the EWM Eclipse client, and then modify the permissions that control what you are authorized to do within your project area.

Procedure

  1. Install the Eclipse client. For the steps to install the Eclipse client, refer to this topic: Client installation overview.
  2. Modify client user permissions. For the steps to modify permissions using the Eclipse client, refer to this topic: Modifying permissions. Make sure you select all of the Data Set Definitions and Language Definitions permissions in the Permitted actions section of the Permissions dialog.
  3. Import sample application projects.

Importing and installing sample application projects

Edit online

Before you can run a sample application, you need to import and install samples.

About this task

A sample mortgage application is included with the product. You must import the following sample mortgage application projects:
Table 1. Required sample mortgage application projects
Project name Description
MortgageApplication-Common Common parts project
MortgageApplication-EPSCMORT Main calling application
MortgageApplication-EPSCSMRD Calculate payment module
MortgageApplication-EPSMLIST Equivalent offers list module
MortgageApplication-EPSMPMT Web enablement communication module

Click this link to download all required sample mortgage application files: https://jazz.net/library/article/714, and then follow these steps:

Procedure

  1. Start the Eclipse client.
  2. Select Window > Open Perspective > Other > Resource.
    The Project Explorer editor opens.
  3. Right-click to display the menu in Project Explorer and select Import.
    The Import editor opens.
  4. In the Import editor, select General > Existing Projects into Workspace, then click Next.
  5. Choose Select archive file, click Browse, then select the MortgageApplication.zip.
  6. Select all five required sample projects and click Finish.
  7. Select the five imported projects in the Project Explorer view, right-click to display the menu, then select Team > Share Project to share them to the Jazz Team Server.

Running the system definitions generator

Edit online

Use the system definitions generator to automate the creation of the language definitions, data set definitions, and translators you need to run dependency builds. The system definitions generator also updates the properties of files and folders contained in these sample projects.

Before you begin

For the steps to run the system definitions generator, refer to this topic: Generating build metadata automatically using the system definitions generator.

Verifying source code data scanning configuration

Edit online

When you run the system definitions generator with the supplied script, you enable source code data scanning, which EWM does not automatically perform.

About this task

Source code data is the metadata that defines relationships and dependencies among different source codes. When you run a dependency build, EWM uses these source code data to determine which source code should be rebuilt after you update code. You need to gather this data by running a source code data scanner against your source code, and you have to enable this scan if you want to run a dependency build. Specify the scanners that run against your source code when you associate language definitions with your source code files. For more information, see Specifying a source code data scanner.

By default, data streams are scanned automatically every hour. These automatic scans include only those files that have changed since the last scan. Depending on the number of files and the volume of file modification activity, it can become prohibitive to scan an entire repository every hour. Because of this, you can turn on or off the scanning of various streams. (The default is off.) Source code scanning is the most direct way you can obtain source code data.

Procedure

  1. In the Team Artifacts view, expand your Jazz repository, right-click Source Code Data, then choose Select Streams for Scanning.
    The Source Code Data Scanning editor opens.
  2. Confirm that you selected your project area stream, then click Cancel.

Summary

Edit online

In this tutorial, you learned how to install and configure a sample z/OS application.

Use what you learned from this tutorial to successfully configure your own applications.