---
title: "Troubleshooting"
description: "Invantive Data Hub runs unattended, so a failure is read afterwards from the output rather than seen on a screen."
language: es
source_language: en
translation_state: pending
canonical: https://documentation.invantive.eu/es/docs/invantive-data-hub/troubleshooting
original: https://documentation.invantive.eu/en/docs/invantive-data-hub/troubleshooting
updated: 2026-11-18T01:33:23Z
license: https://documentation.invantive.eu/es/
---

Invantive Data Hub runs unattended, so a failure is read afterwards from the output rather than seen on a screen. Two habits make that reading much shorter.

## Read Past `itgencun016`
Nearly every failure in a run is reported twice: once wrapped and once in full. The wrapped line looks like

```
Error itgencun016: Error itgencmr406: No provider available to handle requested Get OAuth Token.
```

`itgencun016` is the wrapper and says nothing about the cause. **The code directly after it is the one to look up**, here `itgencmr406`. Searching the forums for `itgencun016` therefore yields little; searching for the inner code yields the answer.

## Reproduce with a Trace
Where the message alone is not enough, a trace records what the engine actually did. Two environment variables switch it on and a third chooses the folder:

- `INVANTIVE_TRACE_ACTIVE` to `true`;
- `INVANTIVE_TRACE_TO_FILE` to `true`;
- optionally `INVANTIVE_TRACE_FOLDER` to a folder with a few gigabytes free. Without it the trace is written to the folder `Trace` of the Invantive configuration folder, such as `~/Invantive/Trace` or `%USERPROFILE%\Invantive\Trace`, which Invantive Data Hub creates at its first start; see [[Environment Variables/Folders|Folders]].

From release 27.0 the options `/trace`, `/tracetofile` and `/tracefolder` of the [[Invantive Data Hub/Command Line Options|command line]] do the same for one run, and the statement [[Set Trace]] traces one step of a script. Ver [[Trace Settings]].

A trace file holds the statements, the addresses called and the credentials context, so treat it as confidential and send it to support rather than posting it.

From release 28.0 an error is followed by a line `Trace ID: <trace id>`. The trace ID finds the statement in the trace file of the run, and the calls it made in the trace files of the Invantive servers it reached, so quote it together with the message code.

Send the file whose name ends in `-c`: that is the closed form, written when the run ended, and it holds the whole run including the reason it stopped. A file still ending in `-writing` belongs to a run that is either still busy or was killed.

The file of `/logfile` deserves the same care from release 27.0 onward. It used to hold the messages of the run alone, and now holds the results of the statements as well, on lines carrying the channel `STDOUT`, so it can contain business data. `/results:false` keeps them out of it; see [[Invantive Data Hub/Command Line Options|Command Line Options]].

## Logging On Fails
- `itgenuty726`: the catch-all for a connection which could not be established. The line under it names the real reason, often a time-out or a `System.Net.WebException`.
- `itgencmr406`: no provider is available to handle the OAuth token request. The message lists the data containers which were opened, and the one expected to serve the token is missing from that list.
- `itgeneuy106`, `itgenobr113`, `itgenobr344`, `itgenoda494`: authentication against Exact Online. `itgenoda494` is the clearest of them: a refresh token which has been superseded cannot be used, which happens when one Exact Online user is coupled twice to the same OAuth app.

Several of these were defects which a later release closed; re-authentication after an upgrade to release 26.0 is one such case, corrected in 26.0.167. Check the release in the banner against the current release before investigating further.

An unattended run cannot answer a question. Where the licence or the agreement is missing, the product opens its menu, reports `itgencmm002` because nothing answers, and ends with `itgenlic681` and [[Invantive Data Hub/Exit Code|exit code]] 7. Run it once by hand on that device; see [[Invantive Data Hub/Configuration|Configuration]].

## The Program Does Not Start
- `itgencuy002` with exit code 9: the `appsettings` file cannot be read. Up to release 27.0 it was also reported when the file of the environment was missing, with `appsettings.json` alone not enough; from release 28.0 a missing file is no longer an error.
- `itgeneay003`: up to and including release 27.0.36, the `ElasticApm` settings left out `Description` or carried the value of the sample. Add any `Description`, or upgrade.
- `itgendhb002` with exit code 5: a command line argument is in an invalid format. Arguments take a slash and a colon; see [[Invantive Data Hub/Command Line Options|Command Line Options]].
- `itgendhb297` with exit code 5: the command line carries a script file as well as one or more statements, while only one of the two can be the source of the run. Disponible a partir de la versión 27.0.
- `itgendhb298` with exit code 5: `/statement` was given without the statement it was to carry, for instance as the last argument of the command line. Disponible a partir de la versión 27.0.
- `itgendir105`: the installation is incomplete, usually a download which was broken off.

## A Statement Fails Against the Platform
The platform decides what it accepts, and its refusal is passed through unchanged. `itgenoda059` is typical: Exact Online refuses a quantity with decimals on an item which is not divisible, and returns `500 Internal Server Error` with a message whose placeholders it did not fill in.

Two things help there. The system messages on Invantive Cloud record the last natural key of the failing row, which usually contains the API address including the identification of the record, so the row can be found. And a `synchronize` statement reports the context it was working on in `itgendhb173` just before the failure, which names the statement and the target table.


## Notas de la Versión

- [Invantive Data Hub ](/es/release-notes/products?product=invantive-data-hub)
  - [De 26.0 a 27.0](/es/release-notes/products?product=invantive-data-hub&step=26.0-to-27.0)
  - [De 25.0 a 26.0](/es/release-notes/products?product=invantive-data-hub&step=25.0-to-26.0)
