> 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/command-line-interface/monitor-your-pipeline-for-build-modifications.md).

# Monitor your Pipeline for Build Modifications

## Monitor your Pipeline for Build Modifications

The next step is to configure the agent to monitor your Pipeline for Build Modifications. The agent creates Build Modifications from changes you make by importing transports into the Pipeline's QAS system.

Configures the agent to monitor a pipeline's QAS system for Build Modifications. The agent creates Build Modifications from changes you make by importing transports into the pipeline's QAS system.

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

```batch
slabapcli.exe buildmods run --pipeline <pipeline-name>
```

{% endcode %}
{% endtab %}

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

```powershell
.\slabapcli.exe buildmods run --pipeline <pipeline-name>
```

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

| Parameter    | Required | Description                                      |
| ------------ | -------- | ------------------------------------------------ |
| `--pipeline` | Yes      | The pipeline name (as shown in `pipeline list`). |

## Example

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

```batch
slabapcli.exe buildmods run --pipeline "HH_SLABAPCLI_170625"
```

{% endcode %}
{% endtab %}

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

```powershell
.\slabapcli.exe buildmods run --pipeline 'HH_SLABAPCLI_170625'
```

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

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

```log
.\slabapcli.exe buildmods run --pipeline 'HH_SLABAPCLI_170625'
[2025-06-18 09:24:49.485+01:00] [info] Current ANSI Code Page: 65001 (UTF-8) (65001)
[2025-06-18 09:24:49.486+01:00] [info] Config pathname: ../config/config.toml
[2025-06-18 09:24:49.516+01:00] [info] Total time: 00:00:00.031
```

{% endcode %}

This command creates a BUILD\_MODS scheduled task that runs every five minutes to create Build Modifications from transports imported into the pipeline's QAS system.

To stop monitoring, run:

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

```batch
slabapcli.exe buildmods stop --pipeline <pipeline-name>
```

{% endcode %}
{% endtab %}

{% tab title="PowerShell" %}
{% code title="Stop command" overflow="wrap" %}

```powershell
.\slabapcli.exe buildmods stop --pipeline <pipeline-name>
```

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

To display the Build Modifications in SeaLights, go to the Coverage Dashboard and open the **Build history** window for your app.

<figure><img src="/files/QA9s7FvK0Tp3zG1veil4" alt=""><figcaption></figcaption></figure>

In the Build column:

* The Initial Build Map name has the format Initial `<QAS system>|<QAS hostname>|<Creation datetime>`
* Build Modifications have the format `<Transport name>|<Import datetime>`

The Coverage Report's **Overall Coverage** tab lists all the objects in your SeaLights app.

<figure><img src="/files/40Tqx6rT3KOlNLjWPsD6" alt=""><figcaption></figcaption></figure>

The Coverage Report hierarchy has the following structure:

```
App
	<Development Class/Package>
		<Object Type>
			<Object Name>
				{} <Component Type> <Component Name>
				…
			…
		…
	…
```

The **Code Changes** tab lists all the code changes introduced by Build Modifications.

<figure><img src="/files/ej9FRMW6OxYqBi82zmwK" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
When you stop or replace a buildmods task, the agent automatically terminates any running watcher process for that task. Orphaned watcher processes are no longer possible.
{% endhint %}

### Watcher Exit Codes

If the watcher exits with a non-zero code visible in Windows Task Scheduler, use this table to interpret it:

| Exit code | Meaning                                                                                                      |
| --------- | ------------------------------------------------------------------------------------------------------------ |
| `0`       | Success.                                                                                                     |
| `1`       | General failure — check the watcher log for details.                                                         |
| `10`      | Another watcher for the same action is already running.                                                      |
| `11`      | Build-mode conflict — e.g. an INIT\_BUILD\_MAP task is still running when BUILD\_MODS starts, or vice versa. |

### Timestamp Behavior

When monitoring picks up a transport, it uses the **current** (clock-synced) time as the build timestamp. This ensures builds always appear in the correct chronological order in the SeaLights dashboard, even when the transport itself was imported some time ago.

## Stop monitoring a Pipeline for Build Modifications <a href="#toc201668102" id="toc201668102"></a>

To stop monitoring a Pipeline for Build Modifications, run the following from your terminal:

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

```batch
slabapcli.exe buildmods stop --pipeline "HH_SLABAPCLI_170625"
```

{% endcode %}
{% endtab %}

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

```powershell
.\slabapcli.exe buildmods stop --pipeline 'HH_SLABAPCLI_170625'
```

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

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

```log
.\slabapcli.exe buildmods stop --pipeline 'HH_SLABAPCLI_170625'
[2025-06-18 14:45:19.637+01:00] [info] Current ANSI Code Page: 65001 (UTF-8) (65001)
[2025-06-18 14:45:19.638+01:00] [info] Config pathname: ../config/config.toml
[2025-06-18 14:45:19.652+01:00] [info] Stopped buildmods run
[2025-06-18 14:45:19.652+01:00] [info] Total time: 00:00:00.015
```

{% endcode %}


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sealights.io/knowledgebase/setup-and-configuration/sealights-agents-and-plugins/abap-agent/command-line-interface/monitor-your-pipeline-for-build-modifications.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.