Configuring a ZAPP file

The ZAPP file defines the user build profiles for an application. It might also contain additional configuration information, such as property groups or settings that are used by IBM® Developer for z/OS on VS Code.

A ZAPP file user build profile contains the following minimal tags:


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

Important: A z/OS project must contain only one ZAPP file. If the project contains more than one ZAPP file, there might be issues with the generated property group and with running a user build.

For more information about all of the ZAPP properties that Developer for z/OS® supports, see ZAPP YAML schema. For more general information about ZAPP files, see Configuring your applications with ZAPP files.

Important: 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.