> 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-1.5/command-line-reference/rfc-destinations.md).

# RFC Destinations

RFC Destinations allow the ABAP Agent to connect to your SAP systems. The `rfc` commands let you create, test, and list RFC Destinations.

## Verify the SAP time zone configuration

Before you begin, make sure that the SAP system and its operating system have the same time zone. If they don't match, the ABAP Agent won't be able to collect accurate time data.

In SAPGUI, use transaction SE16 to display table TTZCU and confirm that field TZONESYS contains the same time zone as the OS time zone. If not, then use transaction STZAC to correct the system time zone.

{% hint style="warning" %}
The time zone for the SAP user account that creates an RFC Destination must also match the SAP system's time zone. To verify or update an SAP user account's time zone, use transaction **SU01** and check the **Logon Data** tab.
{% endhint %}

## Create an RFC Destination

The `rfc set` command creates a new RFC Destination or updates an existing RFC Destination. It stores the details in your `config.toml` file, with your SAP username and password stored in an encrypted format. The `rfc set` command also runs `rfc test` to test the connection.

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

```batch
slabapcli.exe rfc set --name <rfc> --hostname <hostname> --sysnr <sysnr> --client <client> --lang <language>
```

{% endcode %}
{% endtab %}

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

```powershell
.\slabapcli.exe rfc set --name <rfc> --hostname <hostname> --sysnr <sysnr> --client <client> --lang <language>
```

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

| Parameter    | Required | Description                          |
| ------------ | -------- | ------------------------------------ |
| `--name`     | Yes      | RFC Destination name (e.g. `S21`).   |
| `--hostname` | Yes      | SAP system hostname.                 |
| `--sysnr`    | Yes      | SAP system number (instance number). |
| `--client`   | Yes      | SAP client number.                   |
| `--lang`     | Yes      | SAP login language (e.g. `EN`).      |

### Example

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

```batch
slabapcli.exe rfc set --name "S21" --hostname "vwsvtstsap13.tricentis.com" --sysnr "00" --client "100" --lang "EN"
```

{% endcode %}
{% endtab %}

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

```powershell
.\slabapcli.exe rfc set --name 'S21' --hostname 'vwsvtstsap13.tricentis.com' --sysnr '00' --client '100' --lang 'EN'
```

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

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

```log
.\slabapcli.exe rfc set --name 'S21' --hostname 'vwsvtstsap13.tricentis.com' --sysnr '00' --client '100' --lang 'EN'
[2026-05-07 11:37:08.572+01:00] [info] Config pathname: ..\config\config.toml
Enter username: hunterh
Enter password:
Confirm password:
Password accepted (a3f***...***d2b).
Running 'rfc test --name S21' to verify the new RFC destination...
[2026-05-07 11:37:15.910+01:00] [info] Testing rfc: S21
  Connected
  System info:
    RFCDBHOST: sapqas01
    RFCSYSID: S21
    RFCIPADDR: 10.0.1.50
    RFCKERNRL: 753
    RFCSAPRL: 750
  SeaLights ABAP add-on:
    Installed
  SeaLights ABAP add-on version:
    Installed version: RELEASE=2025_01 EXTRELEASE=0012 (minimum supported ...)
  Time synchronization:
    ...
  RFC function modules:
    All required RFC function modules callable
  Tables:
    All required tables readable
  SCMON Configuration:
    ...
    SCMON is running and configured to stay active until 2027-12-31
  SCMON_COLLECT callability:
    SCMON_COLLECT call succeeded
```

{% endcode %}

{% hint style="info" %}
For security, the command output doesn't display your SAP password.
{% endhint %}

## Test an RFC Destination

The `rfc test` command tests the connection to an RFC Destination and performs a comprehensive set of diagnostic checks to verify the following:

* SAP connectivity.
* SAP system information.
* ABAP addon installation and version.
* Time synchronization.
* RFC function module and table authorizations.
* SCMON configuration.
* Callability of the `SCMON_COLLECT` function.

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

```batch
slabapcli.exe rfc test --name <rfc>
```

{% endcode %}
{% endtab %}

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

```powershell
.\slabapcli.exe rfc test --name <rfc>
```

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

| Parameter | Required | Description                       |
| --------- | -------- | --------------------------------- |
| `--name`  | Yes      | The RFC Destination name to test. |

### Example

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

```batch
slabapcli.exe rfc test --name "S21"
```

{% endcode %}
{% endtab %}

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

```powershell
.\slabapcli.exe rfc test --name 'S21'
```

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

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

```log
.\slabapcli.exe rfc test --name 'S21'
[2026-05-07 11:45:36.907+01:00] [info] Config pathname: ..\config\config.toml
[2026-05-07 11:45:36.910+01:00] [info] Testing rfc: S21
  Connected
  System info:
    RFCDBHOST: sapqas01
    RFCSYSID: S21
    RFCIPADDR: 10.0.1.50
    RFCKERNRL: 753
    RFCSAPRL: 750
  SeaLights ABAP add-on:
    Installed
  SeaLights ABAP add-on version:
    Installed version: RELEASE=2025_01 EXTRELEASE=0012 (minimum supported RELEASE=2024_01 EXTRELEASE=0001)
  Time synchronization:
    K_DateTime: 2026-05-07 12:45:38
    L_DateTime: 2026-05-07 12:45:38
    Average delay of RFC connection: 00:00:00.022
    RFC K_Datetime: 2026-05-07 12:45:38. UTC offset: 02:00:00
    RFC UTC datetime: 2026-05-07 10:45:38
    (Local UTC datetime - RFC UTC datetime) difference: 00:00:00.864
    Agent UTC sent to SeaLights : 2026-05-07 10:45:43.906
    SeaLights server UTC        : 2026-05-07 10:45:44.301
    SeaLights - agent offset    : 00:00:00.395
  RFC function modules:
    All required RFC function modules callable
  Tables:
    All required tables readable
  SCMON Configuration:
    DEACTIVATE_ON: 20271231
    SCMON is running and configured to stay active until 2027-12-31
  SCMON_COLLECT callability:
    SCMON_COLLECT call succeeded
```

{% endcode %}

## List RFC Destinations

The `rfc list` command lists the details for each of your RFC Destinations.

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

```batch
slabapcli.exe rfc list
```

{% endcode %}
{% endtab %}

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

```powershell
.\slabapcli.exe rfc list
```

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

This command takes no parameters.

### Example

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

```log
.\slabapcli.exe rfc list
[2025-06-17 13:54:05.666+01:00] [info] Current ANSI Code Page: 65001 (UTF-8) (65001)
[2025-06-17 13:54:05.666+01:00] [info] Config pathname: ../config/config.toml
Name        : S21
Hostname    : vwsvtstsap13.tricentis.com
Sysnr       : 00
Client      : 100
Language    : EN
Username    : hunterh
Cached usage: false
Name        : S23
Hostname    : vwsvdevsap01.tricentis.com
Sysnr       : 00
Client      : 200
Language    : EN
Username    : hunterh
Cached usage: false
```

{% endcode %}

## Upload usage data

The ABAP Agent normally obtains usage data directly from a Production system. However, you can provide your own usage data from files exported from the SAP ST03N transaction. When you export your ST03N data, save the files to a new directory in unconverted format using the `.txt` extension.

The `rfc phd` command lets you upload usage data. To upload usage data for your Production system, you'll need to provide the names of your PRD and QAS RFC Destinations, and the directory where you saved the usage data.

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

```batch
slabapcli.exe rfc phd --qas <rfc> --prd <rfc> --dir <usage data folder>
```

{% endcode %}
{% endtab %}

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

```powershell
.\slabapcli.exe rfc phd --qas <rfc> --prd <rfc> --dir <usage data folder>
```

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

| Parameter | Required | Description                                                    |
| --------- | -------- | -------------------------------------------------------------- |
| `--qas`   | Yes      | The QAS RFC Destination name.                                  |
| `--prd`   | Yes      | The PRD RFC Destination name.                                  |
| `--dir`   | Yes      | The directory containing your exported ST03N usage data files. |

{% hint style="info" %}
**TODO (from v1.5 draft):** The source listed Parameters as "None" for `rfc phd`, but the example uses `--qas`, `--prd`, and `--dir`. Parameter table reconstructed from the example — please confirm.
{% endhint %}

### Example

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

```batch
slabapcli.exe rfc phd --qas "S21" --prd "S23" --dir "c:\temp\phd"
```

{% endcode %}
{% endtab %}

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

```powershell
.\slabapcli.exe rfc phd --qas 'S21' --prd 'S23' --dir 'c:\temp\phd'
```

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

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

```log
.\slabapcli.exe rfc phd --qas 'S21' --prd 'S23' --dir 'c:\temp\phd'
[2026-05-05 10:45:08.332+01:00] [info] Detected Windows version: Windows 11
[2026-05-05 10:45:08.332+01:00] [info] Config pathname: ../config/config.toml
qas: S21
prd: S23
dir: c:\temp\phd
<Upload details>
```

{% 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, and the optional `goal` query parameter:

```
GET https://docs.sealights.io/knowledgebase/setup-and-configuration/sealights-agents-and-plugins/abap-agent-1.5/command-line-reference/rfc-destinations.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
