IBM Support

Preparing WTX/ITX maps to run on Unix platforms

Troubleshooting


Problem

When designing IBM WebSphere Transformation Extender (WTX) / IBM Transformation Extender (ITX) maps that will eventually be used on a Unix platform, any relative source references used for the file adapter should use the forward slash directory delimiter notation.

Symptom

A map with a compiled in setting using a relative source reference with a Windows back slash (..\Data\Input.txt) will fail to execute on Unix without an override (-IF1 ../Data/Input.txt):

Map could not complete (12): Source not available (0.002 seconds)

Cause

Windows and Unix have differing requirements for directory delimiters

Environment

IBM WTX or ITX on Unix platforms

Diagnosing The Problem

This issue can be seen when a map ends with 'Map could not complete (12): Source not available (0.002 seconds)' and the audit log shows that it was looking for a source file specified with a Windows back slash directory delimiter, on a Unix platform.

Resolving The Problem

It is recommended that any relative source references used for the file adapter should use the forward slash directory delimiter notation. This notation will also continue to work on Windows (test executions in the Design Studio) as the directory delimiter will be replaced on-the-fly.

[{"Product":{"code":"SSVSD8","label":"IBM Transformation Extender"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"Design Studio","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"},{"code":"PF035","label":"z\/OS"}],"Version":"9.0;8.4.1.3;8.4.1.2;8.4.1.1;8.4.1.0;8.4.1;8.4.0.5;8.4.0.4;8.4.0.3;8.4.0.2;8.4.0.1;8.4.0.0;8.4;8.3.0.6;8.3.0.5;8.3.0.4;8.3.0.3;8.3.0.2;8.3.0.1;8.3.0.0;8.3","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}}]

Document Information

More support for:
IBM Transformation Extender

Software version:
9.0, 8.4.1.3, 8.4.1.2, 8.4.1.1, 8.4.1.0, 8.4.1, 8.4.0.5, 8.4.0.4, 8.4.0.3, 8.4.0.2, 8.4.0.1, 8.4.0.0, 8.4, 8.3.0.6, 8.3.0.5, 8.3.0.4, 8.3.0.3, 8.3.0.2, 8.3.0.1, 8.3.0.0, 8.3

Operating system(s):
AIX, HP-UX, Linux, Solaris, Windows, z/OS

Document number:
544569

Modified date:
29 September 2018

UID

swg21978690