5.24 XMLQueueService

Service Name: XMLQueueService

The XMLQueueService service allows XML messages to be received from and sent to MQSeries message queues and IBM i Data queues.

The following service property entries can be used to control the data encoding used when data is received from the queue and send to the queue. When data is put to an IBM i data queue the data is padded with EBCDIC spaces. It is recommended that dq.put.encoding and dq.get.encoding values belong to the EBCDIC family. For example Cp037, Cp273 and Cp500 are valid values. By default the CCSID of the client program or the message is used to determine the encoding value.

dq.get.encoding

dq.put.encoding

mq.get.encoding

mq.put.encoding

The following service property entries can be used to stop the XML declaration being modified to suit the data encoding. The default value for these properties is *yes.

dq.put.modify.declaration=*no

mq.put.modify.declaration=*no

The following service property entries can be used to explicitly specifiy the XML declaration IANA encoding used by the XML declaration modification process.

If these service properties are missing then the IANA encoding is determined from the encoding.

dq.put.encoding.declaration= Any valid IANA encoding. ie iso-8859-1

mq.put.encoding.declaration= Any valid IANA encoding. ie iso-8859-1

IBM Java Unicode to EBCDIC byte encoders use the EBCDIC NL (New Line 0x15) character instead of the EBCDIC LF (Line Feed 0x25) character. When the Unicode XML result is converted to the selected encoding and this encoding is EBCDIC, the New Line character will be replaced with a Line Feed character. The default value for these properties is *no.

dq.put.ebcdic.nl2lf=*yes

mq.put.ebcdic.nl2lf=*yes

The XMLQueueService can be configured to handle text messages. If the keyword MESSAGE(*TEXT) is present on the SERVICE_LOAD command then the service is expecting text messages and the message value is wrapped with <text> and </text> tags.

 

<?xml version="1.0" encoding="utf-8"?>

<text>The quick brown fox jumped over the lazy dogs</text>

 

 

The XMLQueueService supports the following commands:

5.24.1 SERVICE_LOAD

5.24.2 SERVICE_GET

5.24.3 RECEIVE

5.24.4 SEND

5.24.5 ARCHIVE

5.24.6 SERVICE_UNLOAD

Refer to 5.1.13 MQSeries Built-In Functions for details of the MQSeries Built-In Functions.