IBM Support

Using the IBM WebSphere FTP adapter with the IBM WebSphere Transformation Extender Launcher generates a -1003 error code

Technote (troubleshooting)


Attempts to FTP a file using the IBM WebSphere® FTP adapter from a IBM WebSphere® Transformation Extender map fails with a -1003 error code.


The FTP attempted by the WebSphere Transformation Extender Launcher fails.


The FTP session has timed out

Diagnosing the problem

Enable the adapter trace option by adding -TV+ to the corresponding map card command or rule. Using an output card as an example, the cards' command would look like:

-TV+ -is:functionName Create -is:Filename file.txt -wtx:ispec -wtx:record -mcf:userName userid -mcf:outputDirectory outputdirectoryname -mcf:password password -mcf:protocol FTP -mcf:hostName hostname -mcf:secondServerProtocol FTP[

Recompile and deploy the map/system to your Launcher environment

Restart the Launcher and attempt to FTP files to reproduce the failed behavior.

Once the FTP fails, review the trace file that was generated. By default, the trace file will be named and it can be found in the same directory as the compiled map. In this trace file, look for text similar to:

Error code: -1003 , Error message: The specified Directory could not be found for performing this operation. Either it does not exist or there is not adequate permission for performing this operation on it, error code.


Error code: -1003 , Error message: javax/resource/ResourceException.<init>(Ljava/lang/Throwable

Resolving the problem

Edit the WebSphere Transformation Extender configuration file, that has a default name of dtx.ini and add the following parameter:

IdleFTP Resource Adapter=xx

where xx is a numeric value, representing the number of seconds that a FTP connection can remain idle (no activity) before the connection is dropped.

Restart the Launcher.

In this situation, an FTP connection was established then, after a period of inactivity, the FTP connection has become invalid. The connection has timed out based on the FTP servers timeout value, which in most environments is set to 300 seconds (5 minutes). The IdleFTP Resource Adapter parameter instructs the WTX Launcher to remove an FTP connection if it has been idle for more than the specified number of seconds. When an FTP connection is needed, a new FTP connection will be created if no idle FTP connections exists. Check with your FTP server System Administrator to determine the FTP timeout value and then set the IdleFTP Resource Adapter parameter to a value less than the FTP server timeout value.

Product Alias/Synonym

Ascential Mercator DataStage TX

Document information

More support for: Transformation Extender
FTP Adapter

Software version: 8.2, 8.3, 8.4

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

Reference #: 1592963

Modified date: 06 March 2015

Translate this page: