5.25 XMLBindQueueService

Service Name: XMLBindQueueService

The XMLBindQueueService 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 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 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

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

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 XMLBindQueueService supports the following commands:

5.25.1 SERVICE_LOAD

5.25.2 SERVICE_GET

5.25.3 BIND

5.25.4 CLOSE

5.25.5 GET

5.25.6 SET

5.25.7 WRITE

5.25.8 ARCHIVE

5.25.9 SERVICE_UNLOAD

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