5.5 FileQueueService

The FileQueueService service allows files 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=Cp037

dq.put.encoding=Cp037

mq.get.encoding=Cp037

mq.put.encoding=Cp037

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.get.modify.declaration=*no

dq.put.modify.declaration=*no

mq.get.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.get.encoding.declaration=iso-8859-1

dq.put.encoding.declaration=iso-8859-1

mq.get.encoding.declaration=iso-8859-1

mq.put.encoding.declaration=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 FileQueueService supports the following commands:

5.5.1 SERVICE_LOAD

5.5.2 SERVICE_GET

5.5.3 READ

5.5.4 WRITE

5.5.5 SERVICE_UNLOAD

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