IBM Support

Media Transfer using RAF fails with "java.nio.charset.UnmappableCharacterException" error

Troubleshooting


Problem

Attempts to transfer media files ending in .html and/or .txt to a Microsoft Windows target system using the -m option results in the error "java.io.IOException: CTGRI0073E An error occurred while transferring a file" when using IBM Rational Automation Framework (RAF).

Symptom

Each time Rational Automation Framework connects to a target system, the files existing on the framework server that are different from the ones existing on the target system will automatically be copied and transferred over.

In the event that the input length is larger or smaller than what is to be expected, each action run will fail at the very beginning before any configuration changes are made.

Cause

This problem occurs when there is a page such as html and or a text file that contains a character that can not be recognized or translated into another language, causing corruption in the length of the file name causing it to be shorter or longer than expected.

This is commonly seen when working in Korean and in Chinese.

Diagnosing The Problem

The step log will consist of all three of the following errors:

  • Unexpected error:java.io.IOException Details:java.io.IOException: CTGRI0073E An error occurred while transferring a file.
  • Caused by: java.nio.charset.UnmappableCharacterException: Input length = 1
  • java.io.IOException: java.io.IOException: CTGRI0073E An error occurred while transferring a file.

Resolving The Problem

The following steps must be taken to resolve the problem.

  1. Open the rafw_home/product/conf/transfer.properties file

  2. Modify the properties file so that textfile.extensions is commented out

  3. Make a new field for .log files.

    BEFORE:

    textfile.extensions=.txt,.log,.html,.htm,.css


    AFTER:
    #textfile.extensions=.txt,.log,.html,.htm,.css

    textfile.extensions=
    .log

[{"Product":{"code":"SSYPT4","label":"Rational Automation Framework for WebSphere"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"General Information","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"7.1.1.2;7.1.1.3","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
20 April 2020

UID

swg21418011