DCL Compiler Maven Plugin

Maven plugin for compiling DCL (Data Control Language) files into DCN (Data Control Notation) format for local application testing.

Installation

Add the plugin to your pom.xml (see also the Testing guide for full integration examples):

<build>
    <plugins>
        <plugin>
            <groupId>com.sap.cloud.security.ams.dcl</groupId>
            <artifactId>dcl-compiler-plugin</artifactId>
            <version>${sap.cloud.security.ams.dcl-compiler.version}</version>
            <executions>
                <execution>
                    <goals>
                        <goal>compile</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

WARNING

Note: Its version and release cycle is decoupled from the client library and therefore not managed by the ams-bom. We recommend defining an additional property, e.g. sap.cloud.security.ams.dcl-compiler.version, and keeping both up-to-date independently.

The latest version can be found on Maven Central.

Goals

dcl:compile

Compiles DCL files to DCN format. Bound to the generate-test-resources phase by default.

dcl:validate

Validates DCL files without generating output. Bound to the validate phase by default. Useful for CI/CD pipelines.

Configuration

Parameter	Default	Description
sourceDirectory	.../src/main/resources/ams/dcl	Directory containing DCL source files
outputDirectory	.../generated-test-resources/ams/dcn	Output directory for compiled DCN files (compile only)
skip	false	Skip plugin execution
verbose	false	Enable verbose output
failOn	error	Failure threshold: error, warning, or deprecation
readDcn	false	Allow reading .dcn files as input
timeout	60000	CLI timeout in milliseconds
additionalArguments	-	Additional CLI arguments

Parameters can be set in <configuration> or overridden via command line with -Ddcl.<parameter>, e.g. mvn compile -Ddcl.verbose=true.

Platform-Specific Binaries

The plugin bundles platform-specific AMS CLI binaries for:

• macOS (Intel and Apple Silicon)
• Linux (x86_64 and ARM64)
• Windows (x86_64)

The relevant binaries are automatically extracted and cached in ~/.ams-cli/binaries/{version}/ on first use.

Troubleshooting

Timeout errors — Increase the timeout for large projects: <timeout>120000</timeout>

Permission denied (Unix) — The plugin sets executable permissions automatically. If this fails:

chmod +x ~/.ams-cli/binaries/{version}/{os}-{arch}/ams