profiles:

The profiles: mapping key defines several types of mappings, one of which is the dbb profile type, which you use to configure a DBB user build for zBuilder. This section contains one or more of the following mappings.
name:
Required. The name of the user build profile. This name is used to identify the user build profile in the Dependency Based Build menu in the z/OS Projects view.
type:
Required. Specify dbb.
settings:
Required. Defines settings for the user build.
additionalDependencies:
This mapping must contain the value - "dbb-app.yaml". For more information about this file, see Application configuration.

The mapping can also contain additional values. Specify a list of GLOB patterns that define the files to be uploaded to the z/OS UNIX file system for a build. Relative path names are interpreted to be relative to the location of the ZAPP file that is being used for the build. The target folder to upload to the z/OS UNIX file system is defined in the User build workspace option on the Dependency Based Build Preferences. For more information about this preference page, see Setting preferences for a zBuilder user build.

logFilePatterns:
Optional. Specify a list of GLOB patterns that define the files to be downloaded from the z/OS UNIX file system after the build. Relative path names are interpreted to be relative to the DBB log folder that is defined in the User build log folder option of the ZAPP page of Dependency Based Build Preferences. For more information about this preference page, see Setting preferences for a zBuilder user build. user setting. If you omit this property, then all files are downloaded from the DBB log folder.

settings:

command:
The command and parameters that DBB uses to run the user build. For a zBuilder user build, the command must have this format: $DBB_HOME/bin/dbb build. In this command:
  • The $DBB_HOME/bin/dbb is the shell script that calls the metadata store. The environment variable $DBB_HOME is set in the configuration file conf/rse-dbb.env in the DBB host installation path.
  • build is the DBB build command.
lifecycle:
Specify user for the user build lifecycle. A lifecycle is a named build definition. Developer for z/OS® supports the user (user build) lifecycle. This property is required.
lifecycleArgs:
Additional arguments and options for the lifecycle. For a list of base DBB build arguments, see lifecycles: in the IBM Dependency Based Build 3.0 documentation.
Limitation: The dependencyFile argument is not supported.
If you want to include a variable for the high-level qualifier, use the --hlq argument as shown in this example:

      lifecycleArgs:
        - "--hlq ${dbbHlq}"

Example


profiles:
  # User build profile example, requires IBM Dependency-Based Build
  - name: zBuilder
    type: dbb
    settings:
      command: "$DBB_HOME/bin/dbb build"
      lifecycle: user
      lifecycleArgs:
        - "--hlq ${dbbHlq}"
      additionalDependencies:
        - "dbb-app.yaml"