You can generate a local property group for a z/OSĀ®
project with Dependency Based Build (DBB) integration support or add DBB integration properties to
an existing property group.
About this task
The user build operation uses a local property group to locate dependent files and to write error
feedback information to the Remote Error List view when the user build
completes. You can generate a user-build ready property group for a project, or you can use an
existing local property group as the basis for a user build property group.
For a user build operation to run successfully, the property group must contain the paths to
dependent files, such as such as copybooks or build scripts. When you use the action to create a property group, DBB calculates the dependencies and adds them to
the SYSLIB field on the Local Compiler Options page of
the property group. If you need to configure remote libraries for resolving dependencies, you can
add them to the property group as well.
Restriction:
- Property group generation is not supported for Assembler source files.
- Do not use the Generate ZAPP command for a
property group that you intend to use for DBB user build. The ZAPP file that is created by the
Generate ZAPP command is not intended to support a user build operation, and
it overwrites the user build ZAPP file, causing the zBuilder user build profile to be
lost.
Procedure
-
In the z/OS Projects view, right-click a local z/OS project that has DBB integration support, and then select .
-
In the Generate a Local Property Group window, select the language support
tabs you want to include in the property group.
Tip: After the property group is generated, you can add Assembler support to it:
- In the Property Group Manager view, double-click the generated property
group. It opens in the property group editor.
- Click the Categories tab.
- Click Local Assembler Settings and then save the property group.
- Optional:
To generate a user build property group from an existing local property group, click
Browse and then select the property group you want to use.
Choosing this option creates a copy of the selected property group and updates it with
the user build dependencies. The property group copy is named after the project.
- You can add paths to any local or remote dependencies that are not in the Git repository.
If the Git repository contains multiple dependency files with the same name in different folders,
you need to add these folders to the SYSLIB or local macro libraries in the
order that you want the folders to be searched.
- To add remote libraries to the property group, do these steps:
- In the Property Group Manager view, double-click the generated
property group. It opens in the property group editor.
- Click the COBOL, PL/I, or
Assembler tab.
- Open Copy Libraries, Include Libraries,
or Remote Macro Libraries page
- From the Connection name list, choose a remote
system.
- Click Add, Edit, or
Remove to add copy, include, or macro libraries to the table, edit the
entries in the table, or remove entries from the table.
When you click
Add or Edit, a window opens prompting you for a
library name and a data set name.
- In the Library name field, type a name for the
library.
For example, type SYSLIB.
- The table can have only one SYSLIB entry.
- The table allows for the specification of a name other than SYSLIB for the library, as in the
following examples. The editor searches the partitioned data sets defined in MYLIB instead of
SYSLIB. If you have the following statements in COBOL or PL/I code you can use this field to define
the library name MYLIB.
- COBOL example:
COPY MYFILE OF MYLIB.
- PL/I example:
%INCLUDE MYLIB (MYFILE);
- If the library name is set to JCLLIB and the path is specified as
**, the system searches for the include library using the datasets defined in
the JCL JOB Card. The search order is as follows:
- JCLLIB
- JOBLIB
- PROCLIB
- SYS1.PROCLIB
- The system extracts and searches the datasets specified in these statements. If a dataset name
is referenced using a variable declared by a SET statement within the same JOB Card, the
variable is resolved before performing the search.
- In the Library path field, type one or more partitioned data
set names to search and click OK.
Separate multiple data set names with a space. The editor searches the data sets in the order
listed.
- Save the property group.
What to do next
- Verify that your Eclipse workspace is set up for development in your
target programming language. For more information about setting up a workspace, see the related
topics.
- Setting preferences for a zAppBuild user build