Upload usage data to an RFC Destination

The ABAP agent normally obtains usage data from a Production system. However, you can provide your own usage data from files exported from the SAP ST03N transaction (saved to a new directory as .txt files in Unconverted format).

To see how to upload usage data, run the following from your PowerShell window:

PS C:\apps\SLABAPAgent\bin> .\slabapcli.exe rfc help
[2025-06-20 15:31:03.206+01:00] [info] Current ANSI Code Page: 65001 (UTF-8) (65001)
[2025-06-20 15:31:03.207+01:00] [info] Config pathname: ../config/config.toml
rfc <command> [args]:
commands:
  list : list rfc connections
  test : test rfc connection
    --name <rfc>
  set  : set rfc connection
    --name <rfc> : rfc name
    --hostname <hostname> : rfc hostname
    --sysnr <sysnr>       : rfc system number (instance number)
    --client <client>     : rfc client
    --lang <language>     : rfc login language
    username and password are entered interactively
  phd  : import performance history data
    --qas <rfc> : qas rfc name
    --prd <rfc> : prd rfc name
    --dir <directory> : directory containing usage data to import

You’ll need to provide the names of your QAS and Production systems, and the directory where you saved the usage data (in this example, we’re using S21 as both the QAS and Production systems).

Note: If your directory path contains spaces, enclose it in single quotes.

PS C:\apps\SLABAPAgent\bin> .\slabapcli.exe rfc phd --qas S21 --prd S21 --dir c:\temp\phd
[2025-06-20 15:41:05.626+01:00] [info] Current ANSI Code Page: 65001 (UTF-8) (65001)
[2025-06-20 15:41:05.627+01:00] [info] Config pathname: ../config/config.toml
qas: S21
prd: S21
dir: c:\temp\phd
[2025-06-20 15:41:05.632+01:00] [info] PHD Data
  Separators: ',', '|', '       '
  Mnemonic Field Tokens:
    'Function Module'
    'Funktionsbaustein'
    'Nombre de report o transacción'
    'Path, URL'
    'Program'
    'Report or Transaction name'
    'Report- oder Transaktionsname'
    'Report/Transacción'
    'Report/Transaction'
    'TA/Rep.'
    'Task Type'
    'Trans/Rep.'
    'Trans/Rep'
    'Transaction name'
  Steps Field Tokens:
    '# Aufrufe'
    '# Calls'
    '# Schritte'
    '# Steps'
    '# pasos'
    'Calls'
    'Connectns'
    'Number of steps'
  Description Field Tokens:
    'Short text'
    'Kurzbeschreibung'
    'Descripción breve'
[2025-06-20 15:41:05.632+01:00] [info] Import phd from 'c:\temp\phd' using qas=S21, prd=S21
[2025-06-20 15:41:05.632+01:00] [info] Import phd from 'c:\temp\phd' using qas=S21, prd=S21
[2025-06-20 15:41:05.633+01:00] [info] Importing file: c:\temp\phd\04-25.txt
[2025-06-20 15:41:05.633+01:00] [info] Inspecting file: c:\temp\phd\04-25.txt
[2025-06-20 15:41:06.598+01:00] [info] Separator        : '|'
[2025-06-20 15:41:06.598+01:00] [info] Field count      : 55
[2025-06-20 15:41:06.600+01:00] [info] Record count     : 2026
[2025-06-20 15:41:06.600+01:00] [info] Mnemonic index   : 0
[2025-06-20 15:41:06.601+01:00] [info] Steps index      : 2
[2025-06-20 15:41:06.601+01:00] [info] Description index: 49
[2025-06-20 15:41:06.602+01:00] [info] Cleaning file: c:\temp\phd\04-25.txt using '|'
[2025-06-20 15:41:06.729+01:00] [info] Found 2026 records in file 'c:\temp\phd\04-25.txt'
[2025-06-20 15:41:06.730+01:00] [info] Aggregated to 450 records
[2025-06-20 15:41:06.730+01:00] [info] Importing file: c:\temp\phd\05-25.txt
[2025-06-20 15:41:06.731+01:00] [info] Inspecting file: c:\temp\phd\05-25.txt
[2025-06-20 15:41:07.704+01:00] [info] Separator        : '|'
[2025-06-20 15:41:07.705+01:00] [info] Field count      : 55
[2025-06-20 15:41:07.705+01:00] [info] Record count     : 2067
[2025-06-20 15:41:07.705+01:00] [info] Mnemonic index   : 0
[2025-06-20 15:41:07.706+01:00] [info] Steps index      : 2
[2025-06-20 15:41:07.706+01:00] [info] Description index: 49
[2025-06-20 15:41:07.707+01:00] [info] Cleaning file: c:\temp\phd\05-25.txt using '|'
[2025-06-20 15:41:07.841+01:00] [info] Found 2067 records in file 'c:\temp\phd\05-25.txt'
[2025-06-20 15:41:07.842+01:00] [info] Aggregated to 439 records
[2025-06-20 15:41:07.842+01:00] [info] Importing file: c:\temp\phd\06-25.txt
[2025-06-20 15:41:07.842+01:00] [info] Inspecting file: c:\temp\phd\06-25.txt
[2025-06-20 15:41:08.551+01:00] [info] Separator        : '|'
[2025-06-20 15:41:08.552+01:00] [info] Field count      : 55
[2025-06-20 15:41:08.552+01:00] [info] Record count     : 1459
[2025-06-20 15:41:08.553+01:00] [info] Mnemonic index   : 0
[2025-06-20 15:41:08.553+01:00] [info] Steps index      : 2
[2025-06-20 15:41:08.553+01:00] [info] Description index: 49
[2025-06-20 15:41:08.554+01:00] [info] Cleaning file: c:\temp\phd\06-25.txt using '|'
[2025-06-20 15:41:08.648+01:00] [info] Found 1459 records in file 'c:\temp\phd\06-25.txt'
[2025-06-20 15:41:08.648+01:00] [info] Aggregated to 433 records
[2025-06-20 15:41:09.790+01:00] [info] Finding types using RFC connection: 'S21'
[2025-06-20 15:41:09.791+01:00] [info] Finding types for TCOD records
[2025-06-20 15:41:17.235+01:00] [info] Found 150 TCODs in 00:00:07.442
[2025-06-20 15:41:17.243+01:00] [info] Finding types for PROG records
[2025-06-20 15:41:35.974+01:00] [info] Found 390 PROGs in 00:00:18.730
[2025-06-20 15:41:36.021+01:00] [info] Finding types for WAPA records
[2025-06-20 15:41:36.369+01:00] [info] Found 0 WAPAs in 00:00:00.347
[2025-06-20 15:41:36.370+01:00] [info] Finding types for FUNC records
[2025-06-20 15:41:37.705+01:00] [info] Found 12 FUNCs in 00:00:01.334
[2025-06-20 15:41:37.709+01:00] [info] Finding types for IWSV records
[2025-06-20 15:41:38.263+01:00] [info] Found 0 IWSVs in 00:00:00.552
[2025-06-20 15:41:38.263+01:00] [info] Finding types for G4BA records
[2025-06-20 15:41:38.505+01:00] [info] Found 0 G4BAs in 00:00:00.239
[2025-06-20 15:41:38.506+01:00] [info] Finding types for WDYN records
[2025-06-20 15:41:39.065+01:00] [info] Found 0 WDYNs in 00:00:00.557
[2025-06-20 15:41:39.082+01:00] [info] Filtered 42 records without type. Remaining: 537
[2025-06-20 15:41:39.084+01:00] [info] Filtered 0 records using type queries. Remaining: 537
[2025-06-20 15:41:39.084+01:00] [info] Type: TCOD = 140
[2025-06-20 15:41:39.084+01:00] [info] Type: PROG = 385
[2025-06-20 15:41:39.084+01:00] [info] Type: WAPA = 0
[2025-06-20 15:41:39.085+01:00] [info] Type: G4BA = 0
[2025-06-20 15:41:39.085+01:00] [info] Type: FUNC = 12
[2025-06-20 15:41:39.085+01:00] [info] Type: IWSV = 0
[2025-06-20 15:41:39.085+01:00] [info] Type: WDYN = 0
[2025-06-20 15:41:39.086+01:00] [info] Writing PHD to database
[2025-06-20 15:41:39.103+01:00] [info] Wrote 537 records to CachedUsage table. Skipped 0 records.
[2025-06-20 15:41:39.109+01:00] [info] Total time: 00:00:33.484

Note: If you upload usage data for an RFC Destination in your Pipeline, the agent uses this instead of usage data obtained from your Pipeline’s Production system.