IBM WebSphere Adapter for FTP, version 6.1.0.2 notes

This document contains the following sections:
Enhancements and fixes
New and modified connector properties
Upgrade notes

This table lists the enhancements and fixes in interim fix version 6.1.0.2.
Enhancements
#CRAPARTitleDetails
176465FTP Adapter is incompatible with FTPS servers such as FileZilla and Jscape FTPS server.
Symptom: The Adapter does not work properly with recent FTPS servers like FileZilla and Jscape FTPS server in implicit FTPS mode. These servers expect PBSZ and PROT commands to be issued before opening a data connection.
Resolution: This problem is fixed so that the adapter works well with FTPS servers such as FileZilla and Jscape FTPS server. The adapter issues PBSZ 0 and PROT P commands before opening a new data connection.
Fixes
#CRAPARTitleDetails
176286BO framework not handling anonymous data types.
Symptom: While using anonymous data type in the XSD to declare customer's data object types, adapter always add the string "_._type" after the data type name when serializing the data object into xml file.
Resolution: Adapter serializes the data object into xml file correctly even while using anonymous data type to declare the type of data objects.
276680Adapter not able to process list commands when working with EMC-SNAS FTP server
Symptom: Adapter fails to process list commands as the output of the long list command(ls -l) is not as per the standard format. The name token has absolute path in it. The standard behavior is that it should have only the relative name.
Resolution: This problem is fixed by processing the absolute path and fetching the name from it.
37670632353Adapter throws ArrayIndexOutOfBoundException when the files in the event directory are deleted before the adapter picks them.
Symptom: The adapter throws ArrayIndexOutofBoundException when the files in the event directory are deleted before the adapter pick these files for processing.The adapter tries to download the files which are not existent on the FTP server.
Resolution: This problem is fixed so that the adapter works well when the files in the event directory are deleted.


This table lists the enhancements and fixes in fix pack version 6.1.0.1.
Enhancements
#CRAPARTitleDetails
176219During outbound processing, server to server operation does not have a return value to determine the file transfer status
Symptom: During outbound processing, server to server operation does not have a return value to determine the success or failure of the file transfer.
Resolution: This is an enhancement which enables the server to server outbound operation to have a return value. The return value determines the success or failure status of the file transfer.
Fixes
#CRAPARTitleDetails
175700JR29939Adapter doesn't use the configured encoding during outbound
Symptom: The adapter takes the default encoding used by the base rather than the configured encoding during outbound operation. Adapter should be capable of passing the encoding to the base prior to setting the contents in the record.
Resolution: The adapter pre-sets the configured encoding in the record prior to setting the contents.
275923JR30447Adapter fails when there is a directory path with a dot(".").
Symptom: The adapter fails when there is a dot (".") in the directory name.
Resolution: The adapter now has the capability to handle dot in the directory name.
375977Adapter throws inappropriate error messages during outbound request.
Symptom: The adapter throws inappropriate error messages during outbound request.
Resolution: The adapter now generates appropriate error messages while validating the directories.
476026When poll frequency is greater than the ftp server timeout, adapter throws a exception.
Symptom: The adapter throws a exception when poll frequency is greater than the ftp server timeout.
Resolution: The adapter now has the capability to handle such unknown exception.
576027JR28166During outbound processing, create operation takes a long time when there are large number of files in the specified output directory.
Symptom: During outbound processing, create operation takes a long time to complete.
Resolution: This is a performance fix. The filename check performed during outbound was checking with all the files in the directory rather than with the filename. The check has been modified to include the filename.
676028JR28535When inbound FTP adapter is configured to use partition drives for local event directory and local archive directory, the archiving of the event files fails.
Symptom: When inbound FTP adapter is configured to use partition drives for local event directory and local archive directory, the archiving of the event files fail as the java io api rename method cannot rename files from one partition drive to another.
Resolution: When java io api rename method fails, the adapter reads data from event file and writes to archive file. The adapter uses a buffer of 2 MB to read data. This type of archiving is performance intensive and may slow throughput for very large event files.
776029FTP server to server outbound operation precedence is not proper.
Symptom: The adapter does not take the servertoserver properties in proper precedence.
Resolution: The adapter handles the precedence of the servertoserver properties appropriately. The precedence is as follows : Properties set at wrapper business object> Interaction specification properties > Managed connection factory properties.
876032FTP inbound fails in databinding when no wrapper is used.
Symptom: The adapter does not process the inbound business object when the wrappers are not used, it fails to process such business objects.
Resolution: The adapter has the capability to handle business objects without wrapper during inbound processing.
976033The wrapper business object values must be set on the record only when isSet is true.
Symptom: The wrapper business object values must be set on the record only when isSet is true.
Resolution: The adapter now sets the wrapper business object values on the record only when isSet is true.
1076060JR30898Adapter throws a NPE after FTP server restart
Symptom: The adapter throws a NPE when it performs a outbound request after the FTP server restart
Resolution: The adapter now has the capability to handle such unknown exception
1195755JR28511During outbound retrieve operation,the adapter returns even a binary data in AsText attribute of UnstructuredContent.
Symptom: The adapter returns even a binary data in AsText attribute of UnstructuredContent for outbound retrieve operation. This must be set on AsBinary attribute instead.
Resolution: The adapter uses the file transfer type property of the request business object. If this value is set to ascii then the AsText attribute is populated. If it is set to binary then the AsBinary attribute of the UnstructuredContent business object is populated. The default value of file transfer type if it is not set in the request business object is binary.
1276119Inbound with timestamp sorting fails
Symptom: Inbound with timestamp sorting fails as there is a mismatch in activation specification properties and resource adapter
Resolution: The value in the activation specification properties and resourceadapter is now matched
1376121Adapter does not support null namespace using 6.1 version of adapter
Symptom: Adapter encounters errors while generating the wrapper objects for user defined objects when null namespace is used
Resolution: The adapter supports the null namespace objects. It generates wrapper objects successfully for user defeined objects with null namespace
1476122Adapter is defaulting to UTF-8 if no encoding is used
Symptom: Adapter is defaulting to UTF-8 if no encoding is used
Resolution: The adapter uses the system's default encoding if the encoding is not set
1576126The GenerateUniqueFile feature during append operation adds extraneous characters to the filename when the adapter runs on RedHat Platform
Symptom: Extra characters are appended to the generated unique filename when the Adapter is run on the RedHat platform
Resolution: With the fix,the Adapter is capable of creating the filename appropriately on the RedHat Platform
1676127FileNotFound exception is generated while trying to read the file from archive directory at endpoint when using filepassbyreference
Symptom: For filepassbyreference feature the file is not available at the archive directory immediately when the business object reaches the endpoint
Resolution: The adapter archives the file appropriately, so that the business object is accessible in the enpoint
1776129Port numbers are not automatically changed to default in properties view using assembly editor when protocol is changed
Symptom: Port numbers are not automatically changed to default in properties view using assembly editor when protocol is changed
Resolution: The adapter changes the port numbers automatically to corresponding default ports specific to the selected protocol using assembly editor
1876128Outbound retrieve operation is not backward compatible with version 602
Symptom: Outbound retrieve operation is not backward compatible with version 602
Resolution: The adapter now supports the retrieve operation backward compatibility with version 602
1976131Outbound operation like create failed when using Apache ftp server
Symptom: The adapter failed to create a file when used with Apache ftp server as the NLST command failed with incorrect set of parameters
Resolution: The adapter passes the correct set of parameters for NLST to work
2093077"Method is deprecated messages" in the log/console
Symptom: A lot of warning messages appear in the log/console when the adapter is running
Resolution: Filtered these messages in the log/console
2193143JR30855Infinite inbound loop when assuredOnceDelivery is false
Symptom: Infinite inbound loop when assuredOnceDelivery is false
Resolution: Change the source code to support this issue when assuredOnceDelivery is false
2293148Improve the adapter exception case
Symptom: Crash or hang situation appears since Base Class does not handle the exception
Resolution: Handle the exception thrown by logging and ensure the work completion status be notified to workcontroller.
2376299Adapter on WTX throws null pointer exception.
Symptom: Null Pointer Exception is generated while performing outbound or inbound communication with Websphere Adapter on WTX.
Resolution: NO more Null pointer exception are generated by the Adapter on WTX while performing outbound and inbound operation.


This table lists new connector properties
#VersionPlatformAdd or RemoveProperty (Note that property names are case sensitive)
There is no new connector property introduced/modified for this version of interim fix.


To upgrade to the interim fix version 6.1.0.2, do the following:
1. Ensure you have followed the 'Installation Instructions' section in the download link before proceeding further.
2. If you need to use the Fix Pack for EMD, delete the connector project in the WID, import the new rar and apply the EIS specific dependency files. The following steps describe how to do the same.
   a. Open the Java Build Path for the SCA module and remove the Connector project selected on projects tab.
   b. Open the dependency editor and remove the connector project.
   c. Delete the connector project from workspace.
   d. Import the new rar file. Add any dependency files from EIS specific APIs as needed.
   e. Open Java build path for the SCA module and select the Connector project selected on projects tab.
   e. Open the dependency editor and add the connector project if it is not already present and check "Deploy with Module".
3. If you need to update deployed applications on the WPS.
   a. Select "Update" for the corresponding application on the WPS Admin Console.
   b. Select "Single Module" with relative path as name of the rar file - CWYFT_FTPFile.rar.
   c. Click the "Browse" button on local file system to select the updated rar file that has the changes.
   d. Select the default values in the remaining steps and click 'Finish'. This will ensure that existing configurations e.g. MCF, are not changed and jars will be merely updated.


To see a list of files that have been updated in this interim fix, refer to the file 'updatedFileList.txt'

June 19th, 2009 6:00 PM
(C) 2009 IBM Corporation. Proprietary and Confidential. All Rights Reserved.