Error directory configuration

When cooperative file listening is enabled and the output card specifies OnFailure=Rollback, the File adapter moves the source-event file to an error directory when a map fails. The error directory is a subdirectory of the trigger directory. You can use the default error directory, or specify the error directory as an absolute file path, a relative file path, or an alias that is defined in the Resource Registry.

Specify the error directory in the Input(s) > card_name > SourceEvent > ErrorDirectory field of the Launcher settings. If the fully qualified path to the error directory exceeds 260 bytes, the Launcher does not start.

If a map fails when cooperative file listening is enabled in the dtx.ini file but no error directory is specified in the Launcher settings, the File adapter saves the source-event files in the default WTX_ERRDOCS subdirectory of the trigger directory.

The following table illustrates how the error directory paths resolve, relative to the C:\myInput trigger directory.

Table 1. Resolution of error subdirectory paths in C:\myInput
Specified path in ErrorDirectory field	Fully-qualified path
errors	C:\myInput\errors
C:\errors	C:\errors
..\myErrors	C:\myInput\..\myErrors
No directory specified	C:\myInput\WTX_ERRDOCS

If you disable cooperative file listening and you specify an error directory in the Launcher settings, the File adapter moves the source-event file to the error directory if a map fails and OnFailure is set to Rollback.

If cooperative file listening is disabled and you do not specify an error directory, the processing of the source-event file depends on the OnFailure setting.