Defining MQ Support

The DNI interface supports MQ (Message Queues).

To define a MQ as a source DNI file, you must specify the DSN or LF parameter in the following way:

DSN=$MQ:queue_manager_name:queue_name

Where, $MQ indicates the file defined is a MQ; queue_manager_name defines the name of the queue manager and can contain 1 - 4 characters; and queue_name defines the name of the queue and can contain a maximum of 64 characters.

For example: DSN=$MQ:MQ1:FUSION.MESSAGE.QUEUE

In this example, the queue manager name is MQ1, and the queue name is FUSION.MESSAGE.QUEUE.

When a MQ is defined to DNI, the FAIL_ACTION and GOOD_ACTION parameters must not be defined. You cannot perform any postprocessing actions on MQs.

You can define the following additional parameter when using MQs under DNI:

MQ_DEPTH: defines the minimum number of records that must be in an MQ before DNI initiates a request to process the data. The value of this parameter can be 0 - 999,999. If this parameter is set to 0 or 1, the platform server initiates a task to process the data as soon as the data is written into the message queue. When this parameter is set to any other values, the platform server initiates a task to process data only when the MQ contains at least the number of records defined by this parameter.