WebSphere Message Broker, Version 8.0.0.7 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

See information about the latest product version

Data conversion

Convert data that your message flows are transferring between different environments by using WebSphere® MQ or WebSphere Message Broker facilities.

Data conversion is the process by which data is transformed from the format recognized by one operating system into the format recognized by a second operating system with different characteristics such as numeric order.

If you are using a network of systems that use different methods for storing numeric values, or you need to communicate between users who view data in different code pages, you must consider how to implement data conversion.

Code page conversions
Code page conversion might be required for one or more of the following reasons:
  • ASCII versus EBCDIC
  • Code pages that are specific to national language
  • Code pages that are specific to operating systems

In WebSphere MQ, these factors are handled by the CCSID field in the MQMD header. For more information about the MQMD header, see "MQMD - Message descriptor" in the Application Programming Reference section of the WebSphere MQ Version 7 Information Center online. For more information about code page support, see "Code page conversion", also in the Application Programming Reference section.

Encoding
Encoding (byte order) conversion might be required for one or both of the following reasons:
  • Big endian versus little endian

    Endian is an attribute of data that describes whether it is stored in computer memory or transmitted with the most significant byte first (big endian) or last (little endian).

  • Floating point number representations

In WebSphere MQ, these factors are handled by the Encoding field in the MQMD header. For more information about the MQMD header, see "MQMD - Message descriptor" in the Application Programming Reference section of the WebSphere MQ Version 7 Information Center online. For more information about encoding, see "Machine encoding", also in the Application Programming Reference section.

If you are configuring a message flow to receive messages:
  • Messages received across a WebSphere MQ protocol that uses WebSphere MQ headers, contain code page encoding characteristics in the MQMD header, and optionally in other WebSphere MQ headers.
  • Messages received across protocols that do not use WebSphere MQ headers do not include these characteristics. Configure these characteristics by using properties on the nodes in your message flows. For example, set the Message coded character set ID and Message encoding properties on the FileInput node.
If you are configuring a message flow to send messages to other applications or systems:
  • Messages sent across a WebSphere MQ protocol contain code page encoding characteristics in the MQMD header, and optionally in other WebSphere MQ headers.
  • Messages sent across protocols that do not use WebSphere MQ headers must be modified to include these characteristics in the Properties folder in the logical message tree structure. The parser called by the output node uses these values to generate the correct bit stream.

When you use WebSphere Message Broker, you can use the data conversion facilities of WebSphere Message Broker, WebSphere MQ, or both.

WebSphere Message Broker facilities
You can model your messages in the MRM through the WebSphere Message Broker Toolkit. Predefined elements of the messages are converted according to their type and physical layer characteristics. For further details, see Message Sets: Configuring physical properties. You can also use self-defining messages. You can then use the Compute, JavaCompute, or PHPCompute node to configure encoding and CCSIDs. You do not need WebSphere MQ data conversion exits.
  • String data is converted according to the CCSID setting.
  • Decimal integer and float extended decimal types are converted according to the CCSID setting.
  • Decimal integer and float (other physical data types) are converted according to the Encoding setting.
  • Binary and Boolean data is not converted.

WebSphere Message Broker can also convert the WebSphere MQ headers for which parsers are provided.

When you use WebSphere Message Broker facilities, the whole message is not converted to the specified encoding and CCSID: you can specify a different encoding, or CCSID, or both, in each header to perform a different conversion for the following part of the message. The encoding and CCSID in the last header defines the values for the message body.

WebSphere MQ facilities

Headers and message body are converted according to the values set in the appropriate MQMD fields, and other header format names. You might need to set up data conversion exits to convert the body of your messages.

When you use WebSphere MQ facilities, the whole message is converted to the specified encoding and CCSID, according to the setting of the format in the WebSphere MQ header.

For more detail about data conversion using WebSphere MQ facilities, see "Data conversion" in the Application Programming Reference section of the WebSphere MQ Version 7 Information Center online.

Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2016Copyright IBM Corporation 1999, 2016.

        
        Last updated:
        
        Last updated: 2016-05-23 14:46:01


Concept topicConcept topic | Version 8.0.0.7 | ac00650_