Using IBM Transformation Extender for Application Programming on USS

IBM® Transformation Extender for Application Programming contains Java™ interface components that run the UNIX System Services (USS) SDK on z/OS® operating systems in a UNIX environment. Because the native character-encoding of USS differs from the native character-encoding of JVM, you must set type tree properties to accommodate the difference in encoding.

The USS environment uses EBCDIC encoding, and the Java JVM uses UTF-8 encoding. LATIN-1 data is the most appropriate data type to exchange with the JVM.

When you write a map to call a Java-based adapter on USS, set the following properties:
  • In the type tree, set the Data language property to LATIN-1 for all character text data items that are to be passed to the adapter.
  • The Java-based adapter typically returns a LATIN-1 encoded byte stream. In most cases, use the following type tree properties to set the format of output results that are to be passed from the adapter to the map:
    • Set the Item Subclass property to Text.
    • Set the Interpret as property to Binary.

    These settings are especially important if the results are to be used as input into another map or adapter.

For additional information about the Java programming code page considerations, see the reference information for Java on z/OS on the IBM web site.