> For the complete documentation index, see [llms.txt](https://docs.sealights.io/knowledgebase/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sealights.io/knowledgebase/setup-and-configuration/sealights-agents-and-plugins/abap-agent-2.0/command-line-interface/validate-your-pipeline-setup.md).

# Validate Your Pipeline Setup

After creating your Initial Build Map, you can validate that your pipeline is correctly configured end-to-end before enabling continuous build modification monitoring. This is done by manually triggering a build modification for a specific transport, letting you confirm that SeaLights detects the code change and displays it correctly in the Coverage Dashboard.

## Prerequisites

Before proceeding, confirm that your Initial Build Map is complete and visible in the SeaLights Coverage Dashboard. See [Create an Initial Build Map for your Pipeline](/knowledgebase/setup-and-configuration/sealights-agents-and-plugins/abap-agent-2.0/command-line-interface/create-an-initial-build-map-for-your-pipeline.md). The check also needs the production usage data that the Initial Build Map creates for the pipeline's PRD RFC Destination.

The agent server must also be running, because the command runs its work on the server. See [Start the Agent Server](/knowledgebase/setup-and-configuration/sealights-agents-and-plugins/abap-agent-2.0/command-line-interface/start-the-agent-server.md). If the server cannot be reached, the command exits with code `12`.

## Step 1: Choose a Transport

Select a transport number from your QAS system that:

* Has already been **imported into the QAS system** — only imported transports can be reported to SeaLights.
* Contains code changes you know how to test.
* Has a corresponding test in your testing tool that covers those changed objects.
* Changes objects in packages that the Initial Build Map covers (or in customer packages, whose names start with `Z` or `Y`). Build Modifications only include objects from those packages, so changes to objects in other packages do not appear. Deleted objects are not limited. See [Which objects are included](/knowledgebase/setup-and-configuration/sealights-agents-and-plugins/abap-agent-2.0/command-line-interface/monitor-your-pipeline-for-build-modifications.md#which-objects-are-included).
* Has **not previously been reported to SeaLights** — each transport can only be reported once.

Choosing a transport with a known test lets you verify the complete flow: code change detected → visible in SeaLights → covered by a test run.

## Step 2: Trigger a Build Modification

Run the following from your PowerShell window:

Triggers a single build modification for a specific transport. Use this to validate your pipeline setup before enabling continuous monitoring with `slabapcli buildmods run`.

{% tabs %}
{% tab title="Command Prompt" %}
{% code title="Syntax" overflow="wrap" %}

```batch
watcher.exe BUILD_MODS <pipeline-name> --transport_num <TRANSPORT_NUMBER>
```

{% endcode %}
{% endtab %}

{% tab title="PowerShell" %}
{% code title="Syntax" overflow="wrap" %}

```powershell
.\watcher.exe BUILD_MODS <pipeline-name> --transport_num <TRANSPORT_NUMBER>
```

{% endcode %}
{% endtab %}
{% endtabs %}

| Parameter         | Required | Description                                          |
| ----------------- | -------- | ---------------------------------------------------- |
| `<pipeline-name>` | Yes      | The pipeline name (as shown in `pipeline list`).     |
| `--transport_num` | Yes      | The transport number to process (e.g. `EH4K901492`). |

## Example

{% tabs %}
{% tab title="Command Prompt" %}
{% code title="Command" overflow="wrap" %}

```batch
watcher.exe BUILD_MODS "MyApp-Q40" --transport_num "EH4K901492"
```

{% endcode %}
{% endtab %}

{% tab title="PowerShell" %}
{% code title="Command" overflow="wrap" %}

```powershell
.\watcher.exe BUILD_MODS 'MyApp-Q40' --transport_num 'EH4K901492'
```

{% endcode %}
{% endtab %}
{% endtabs %}

{% code title="Expected output (PowerShell, abbreviated)" overflow="wrap" lineNumbers="true" %}

```log
.\watcher.exe BUILD_MODS 'MyApp-Q40' --transport_num 'EH4K901492'
[2026-03-08 14:22:15.102+02:00] [info] Log level: info
[2026-03-08 14:22:15.103+02:00] [info] Current ANSI Code Page: 65001 (UTF-8) (65001)
[2026-03-08 14:22:15.103+02:00] [info] Current version: '2.1.2.175'
[2026-03-08 14:22:15.347+02:00] [info] Transport number supplied on the command line: 'EH4K901492'. One-shot path: no SeaLights lookup, no polling, and the SeaLights build is named with the current clock-synced time.
...
```

{% endcode %}

{% hint style="warning" %}
This command triggers a single build modification for validation purposes only. It does not start continuous monitoring, and it does not change where scheduled monitoring resumes (see [Monitor your Pipeline for Build Modifications](/knowledgebase/setup-and-configuration/sealights-agents-and-plugins/abap-agent-2.0/command-line-interface/monitor-your-pipeline-for-build-modifications.md#where-monitoring-resumes)). To enable continuous build modification monitoring, use `slabapcli buildmods run`.
{% endhint %}

{% hint style="info" %}
The command does not start while an initial build map or a build modification run is already running for the same pipeline (including a scheduled run that is in progress). It then exits with code `10` or `11`. Wait for the running task to finish and run the command again.
{% endhint %}

{% hint style="info" %}
When you specify a transport number, the agent uses the **current** time as the build timestamp (not the transport's historical import time). This ensures the build appears at the correct position in the SeaLights dashboard timeline.
{% endhint %}

{% hint style="info" %}
This manual check does not change where scheduled monitoring resumes. If the transport was imported after that point, scheduled monitoring still processes it later, under its import time. See [Where monitoring resumes](/knowledgebase/setup-and-configuration/sealights-agents-and-plugins/abap-agent-2.0/command-line-interface/monitor-your-pipeline-for-build-modifications.md#where-monitoring-resumes).
{% endhint %}

## Step 3: Verify in SeaLights

Once the command completes, verify the result in the SeaLights Coverage Dashboard:

1. Open the **Build history** window for your application.
2. Confirm the transport appears as a new Build Modification in the format `<Transport name>|<datetime>`, where the datetime is the time you ran the command.
3. Select the Build Modification and open the **Code Changes** tab to verify the modified objects are listed correctly.

<figure><img src="https://4057366433-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAjqTCMRYvHhDgsdPLUnc%2Fuploads%2FmpAGYQ8dYta5cSnmnMdE%2Fimage.png?alt=media&amp;token=8039ccd9-4605-43a6-9400-f9e3a893e150" alt=""><figcaption></figcaption></figure>

<figure><img src="https://4057366433-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAjqTCMRYvHhDgsdPLUnc%2Fuploads%2FFPCG3bEziHJHDGGjtSkI%2Fimage.png?alt=media&amp;token=2a563536-5e2e-4eca-b0bf-542b55dad76e" alt=""><figcaption></figcaption></figure>

## Next Steps

With your pipeline validated, complete the following steps to begin collecting coverage data:

1. [**Collect Footprints data for your Pipeline**](/knowledgebase/setup-and-configuration/sealights-agents-and-plugins/abap-agent-2.0/command-line-interface/collect-footprints-data-for-your-pipeline.md) — configure the Agent to collect details for test executions in Tosca. When you run a test, the Agent matches the ABAP components that you executed against objects in the latest Build Modification and sends this data to SeaLights as a Footprint.
2. **Run your tests** — the default configuration automatically manages the test stage. SeaLights will match the executed ABAP components against the Build Modification and report coverage.
3. **Enable continuous monitoring** by proceeding to [Monitor your Pipeline for Build Modifications](/knowledgebase/setup-and-configuration/sealights-agents-and-plugins/abap-agent-2.0/command-line-interface/monitor-your-pipeline-for-build-modifications.md).

{% hint style="info" %}
Step 3 applies to customers moving forward with a full SeaLights deployment. If you are in an evaluation phase, your setup is complete — continuous monitoring can be enabled at any time when you are ready to go live.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.sealights.io/knowledgebase/setup-and-configuration/sealights-agents-and-plugins/abap-agent-2.0/command-line-interface/validate-your-pipeline-setup.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.