Integrating EGit and IBM Developer for z/OS

IBM Developer for z/OS provides access to source files in a Git repository. The product includes the Eclipse EGit components and adds tools for creating z/OS projects from Git repositories and integrating these projects with IBM Dependency Based Build for z/OS. Use the topics in this section to learn how to set up access to a Git repository and integrate it with the product tools for developing z/OS applications.

Verify installation of EGit

Before you can use a Git repository with the product, make sure that the EGit components are installed. On Windows, the components are called Git integration for Eclipse. On mac OS, they are called EGit.

To see which product features are installed:
  1. Start the product.
  2. Click Help > About IBM Developer for z/OS.
  3. Click Installation Details.
  4. If you want to filter the list of installed software to more easily find the components you are interested in, type a string, such as DBB, Endevor, or Git, into the text field.

Add the EGit components to the product

If the EGit components are not installed with the product, you can add them. Use the same installation method that you used when you installed the client. For instructions, see Adding or removing installed features.

  • If you installed the Developer for z/OS client by using IBM Installation Manager, add the EGit components by using Installation Manager.
  • If you installed the Developer for z/OS client by using p2, add the EGit components by using p2.

The Git Repositories view

After you install the EGit components into the product, it adds the Git Repositories view to the z/OS Projects perspective. For more information about using EGit, see the Eclipse EGit Documentation.
Screen capture of the Git Repositories view

Creating a z/OS project from a Git repository

  1. Add a Git repository to the Git Repositories view. For instructions, see Adding a repository in the EGit User Guide.
  2. In the Git Repositories view, right-click a repository or an application folder and click Create a z/OS Project. The Git repository or folder is added to the z/OS Projects view.
  3. To see the new project, click the z/OS Projects tab. The following demonstration includes the steps for adding a Git repository to the Git Repositories view.
    Creating a z/OS project from a Git repositor

Next steps

The following screen capture illustrates the difference between a Git repository in the Git Repositories view and one that is added to the z/OS Projects view. The Git repository, on the left, is enabled for EGit functions, while the local z/OS project that was created from the Git repository is enabled for functions such as Software Analysis, Debug, Dependency Based Build, Property Groups, and z/OS Provisioning. By using the Team menu on the z/OS project, you can also perform EGit functions on the project. For more information about these functions, see the related information at the end of this topic.

Actions available for a Git repository in the Git Repositories view and the z/OS Projects view