Skip to content

Linking Development Libraries to IDz Projects

Overview of IDz Work Area Setup

Users of Developer for z Systems (IDz) will typically want to use IDz projects to manage their personal development libraries on the mainframe. In general, setting up a development work area on the mainframe for use with IDz requires the following:

  • Creating a z/OS connection in IDz for each system where a ZMF repository and any related personal development libraries reside.

  • Creating an IDz project for each set of related development libraries.

  • An MVS subproject is needed to contain any PDS development libraries associated with a project.

  • A z/OS Unix subproject is needed to contain any HFS libraries associated with a project.

  • Creating or modifying viewing filters for your personal development libraries in the Remote Systems Explorer perspective of IDz.

  • Assigning development libraries to specific IDz subprojects.

IDz Projects and ChangeMan ZMF

You can link your personal development libraries on z/OS to any desired z/OS project in IDz. At the same time, ZMF for Eclipse provides access in IDz to z/OS personal development libraries and to resources under change control in ChangeMan ZMF repositories. This permits integrated ZMF checkouts to IDz projects and lets you take advantage of the mainframe development tools in IDz while working with ZMF-managed software assets.

Desktop Workspaces and IDz

Java developers can also set up a desktop workspace to support local development of mainframe Java applications. The local workspace can be integrated with ZMF for versioning and building management (see "Integrating a Desktop Workspace with ZMF"). At the same time, it can be associated with a z/OS Unix project in IDz to take advantage of mainframe-specific development and debugging tools — for example, to support a DB2 relational database back end.

Creating a New z/OS Connection in IDz

A z/OS connection must be configured in IDz for each mainframe system hosting a ZMF repository that you want to work with using IDz. The IDz connection to z/OS is independent from the connection to z/OS and ZMF used by ZMF for Eclipse.

Note

The z/OS connection in IDz is used by the Remote System Explorer perspective and the z/OS Projects perspective of IDz. The z/OS and ZMF connection in ZMF for Eclipse is used by the Serena perspective and by the Team integration menu in the Java perspective in IDz and in the open-source Eclipse Workbench.

Follow the instructions that are provided in the IDz user manuals that IBM supplies to create a new z/OS connection in IDz.

Creating an IDz Project

IDz Project Checkout

Personal development libraries on the z/OS server must be connected to an IDz project before you can work with them in IDz. Once this is set up, you can use ZMF for Eclipse to check out components from a ZMF baseline library into a personal development library and its associated IDz project at the same time.

Follow the information provided in the IDz user manuals that IBM provides to create an IDz project.

The new project should appear in the z/OS Projects navigation view of the z/OS Projects perspective.

Adding an IDz Subproject to a Project**

Projects,Subprojects,and File Systems:

IDz uses different subproject types to manage resources in different mainframe file systems. PDS development libraries in the native z/OS file system must be linked to an MVS subproject. HFS development libraries in the z/OS Unix System Services (USS) file system must be linked to a z/OS Unix subproject.

Separation of file systems at the subproject level supports different build procedures for different file systems. At the same time, related resources in different file systems can be managed together at the project level.

Follow the instructions given in the IDz user manuals that IBM provides to create an MVS subproject or a z/OS Unix subproject.

The new subproject should display under the node for the parent project in the z/OS Projects navigation view.

Creating Remote Systems Viewing Filters

View Filters and Project Filters

Filters can be created in IDz for two different purposes: (1) managing your view of mainframe resources in the Remote Systems navigation view; and (2) dynamically associating selected resources with projects and subprojects in the z/OS Projects navigation view. There need not be any correspondence between the two sets of filters.

Generally you will want to be able to view many more development libraries and other files in the Remote Systems view than you will actually want to associate with particular projects. For purposes of coordinating your work across perspectives, it is helpful to have a filter in the *Remote Systems view that shows all your PDS development libraries and another that shows all your HFS libraries in the same way they are shown in the Serena perspective. More narrow filters can be added to these as needed.

Follow the instructions given in the IDz user manuals that IBM provides to create viewing filters.

Adding a Library to an IDz Subproject

Development resources are added to subprojects in different ways, depending on the subproject type.

  • MVS Subprojects — PDS libraries or individual members are explicitly and statically linked to a subproject. In the z/OS Projects navigation view, PDS library and member names are shown directly beneath the node for the subproject to which they are linked.

  • z/OS Unix Subprojects — zFS directories or files are linked dynamically to a subproject by means of selection filters. In the z/OS Projects navigation view, filter names are shown below the node for the subproject to which zFS directories and files are linked. Expand the filter node to see the zFS directories and files that currently meet the selection criteria for inclusion in the subproject.

The libraries added to a subproject must reside in the type of file system that the subproject supports.

Note

Every MVS subproject must include a PDS data set (not just members), and every z/OS Unix subproject must include a directory (not just files), to enable ZMF checkout.

Follow the instructions given in the IDz user manuals that IBM provides to add a PDS library or member to an MVS subproject or add an HFS library or file to a z/OS Unix subproject.

In the z/OS Projects view, expand the named project and subproject nodes. The libraries or files you added should display.

Refer to the ChangeMan ZMF for Eclipse User’s Guide for information about the Smart Editor.

Back to top