Starting a user build for zBuilder

Use the Dependency Based Build menu item to start a user build operation for the IBM Dependency Based Build zBuilder.

Before you start

To run a user build with the DBB zBuilder, you must meet these requirements.
z/OS system
IBM Dependency Based Build 3.0 must be installed and configured. For more information, see Installing the integration
Developer for z/OS client
  • You must have a local z/OS project that contains an application that is configured for the user build operation and contains a ZAPP file with a DBB profile. The ZAPP file is typically configured by a build engineer. If your application is not configured for a zBuilder user build, consult your DBB build engineer.
  • You must set preferences for a ZAPP build as described in Setting preferences for a zBuilder user build.
  • You must define a value for any user variables that are defined in the ZAPP file. To learn how to set user variables for a ZAPP file, see Passing user variables to a ZAPP file.

Fir a list of limitations and for help solving user build problems, see Limitations and troubleshooting.

Starting a user build

You can run two types of user builds from a z/OS project:
  • Run User Build with Full Upload: Uploads and builds the source file and all discovered and additional dependencies.
  • Run User Build: Uploads the source file and, if applicable any changed copybooks and include files for which the user build is requested.
Available in version 17.0.3 or later, you can run a user build for multiple programs, the following limitations apply:
  • All selected programs must use the same build profile. This condition applies when the Run User Build option is selected.
  • User Build for multiple programs cannot be triggered by opening them in the editor; it must be initiated from the z/OS Project view.
  • All selected programs must belong to the same z/OS project.
  • Error feedback is not supported.
To start a user build:
  1. Right-click the program file, or files for multiple programs you want to build, or, if the file is open in an editor, right-click in the editor.
  2. Move focus to the menu item Dependency Based Build.
  3. Move focus to the build type you want. The user build profiles that are defined in the ZAPP file are displayed. If the ZAPP file defines more than one user build profile, all profiles are displayed.
  4. Select the profile you want to run.