Configuration Reference

Bank of Z uses the .setup/config/config.yaml file to define the environment-specific settings used during setup, build, and deployment. The configuration file uses YAML format and supports variable expansion to simplify configuration management.

Configuration file overview

The configuration file supports:

• Hierarchical configuration using YAML sections
• Variable expansion using {{section.key}} syntax
• Environment variable references using ${ENV_VAR} syntax
• Comments using the # character

Required settings

The global section contains the primary configuration values required to configure the Bank of Z environment. These settings are shared across the setup scripts, middleware, and supporting tools.

Sandbox

Application

Tools

z/OS System

GUI

Frontend

CICS

IMS

DB2

MQ

Sections settings

Sandbox configuration

The sandbox section defines the root directory on z/OS UNIX System Services (USS) where Bank of Z components are installed.

Application configuration

The app section defines application naming conventions used for datasets, resources, and deployment artifacts.

DBB configuration

The dbb section identifies the IBM Dependency Based Build (DBB) installation.

Depending on your environment and deployment requirements, additional configuration sections can be defined.

Repository configuration

Defines repositories that are cloned during setup.

zBuilder configuration

Defines where zBuilder source and deployment artifacts are located.

zconfig configuration

Defines settings for z/OS configuration tooling.

ZCodeScan configuration

Defines settings used for static code analysis.

Wazi Deploy configuration

Defines deployment automation settings used by Wazi Deploy.

TAZ configuration

Defines settings for automated unit testing and test execution.

CICS configuration

Defines CICS connection information required for automation and deployment tasks.

Variable expansion

Configuration values can reference other configuration entries.

Example:

sandbox:
  path: /usr/local/sandboxes/bank-of-z

dbb:
  dbb_build: ${sandbox.path}/Bank-of-Z/.setup/build

Variables are resolved automatically during setup.

Environment variables can also be referenced:

cics:
  user: ${CICS_USER}
  password: ${CICS_PASSWORD}

Note: Using environment variables is recommended for sensitive information such as credentials.

Validation rules

The setup process validates the configuration before it runs.

Validation includes:

• Required configuration settings are present
• Referenced variables can be resolved
• Paths use valid absolute path formats
• Application naming limits are respected
• Required tool locations are defined

Note: Correcting configuration issues before running setup helps prevent build and deployment failures.