--db2z-databasechangeloglock-index

Last updated: March 26, 2026

--db2z-databasechangeloglock-index is a global parameter that specifies the index name for the DATABASECHANGELOGLOCK table on DB2 z/OS. There is no default value; you must provide the index name explicitly.

On DB2 z/OS, when Liquibase creates tracking tables in a pre-existing tablespace, Db2 does not automatically create the required indexes. Without an index, the DATABASECHANGELOGLOCK table remains unavailable, preventing Liquibase from running.

When specifying a pre-existing tablespace, you must set --db2z-databasechangelog-index, --db2z-tracking-tables-location-tablespace, and (if applicable) --db2z-tracking-tables-location-database together with this parameter. Omitting any of these parameters may leave the tracking tables unavailable or prevent Liquibase from running.

Syntax

You can set this parameter in the following ways:

Option

Syntax

Liquibase properties file (defaults file)

liquibase.db2z.databasechangeloglock.index: <string>

Global flow file argument

globalArgs: { db2z-databasechangeloglock-index: "<string>" }

Global CLI parameter

liquibase --db2z-databasechangeloglock-index=<string>

JVM system property (JAVA_OPTS environment variable)

Unix:

JAVA_OPTS=-Dliquibase.db2z.databasechangeloglock.index=<string>

Windows:

JAVA_OPTS=-D"liquibase.db2z.databasechangeloglock.index"=<string>

Liquibase environment variable

LIQUIBASE_DB2Z_DATABASECHANGELOGLOCK_INDEX=<string>