MQ

RemnodeMQ is a transport for sending messages on BEA Message Queue (BMQ). It requires that you to have
BEA Message Queue installed on your node. This message queue is good for the safe delivery of messages
to a remote node even if it is not up at the moment you send your message. Vice versa,
messages will safely be delivered to you.

This documentation expects you to have basic knowledge on BEA Message Queue. In basic the communication
runs on a specific bus. Each node has group-number and can only communicate to other groups on the same bus.
On each group several queues can be configured.

To be able to start this transport of course the Message Queue software needs to be running. You also need some
environment variables to be set. These are:

DMQ_BUS_ID

DMQ_GROUP_ID

DMQ_GROUPNAME

In the RemnodeMQ-object you configure on which BMQ-queue to receive messages in the attribute MyQueue.
You also configure the remote nodes group-number and queue to send to in the attributes TargetGroup and
TargetQueue.

Sending messages

Similarly to UDP and TCP-transports RemTrans. Address[0,1] are used to identify the message. Address[0]
represents the message-class and Address[1] represents the message-type (according to the BMQ-nomenclature).
Address[2,3] are used to define what type of delivery mode (Address[2]) that should be used and what action
should be taken when a message cannot be delivered (Address[3]).

Possible delivery modes are:

PDEL_MODE_WF_SAF 25

PDEL_MODE_WF_DQF 26

PDEL_MODE_WF_NET 27

PDEL_MODE_WF_RCM 28

PDEL_MODE_WF_MEM 29

PDEL_MODE_AK_SAF 30

PDEL_MODE_AK_DQF 31

PDEL_MODE_AK_NET 32

PDEL_MODE_AK_RCM 33

PDEL_MODE_AK_MEM 34

PDEL_MODE_NN_SAF 35

PDEL_MODE_NN_DQF 36

PDEL_MODE_NN_NET 37

PDEL_MODE_NN_RCM 38

PDEL_MODE_NN_MEM 39

PDEL_MODE_WF_DEQ 40

PDEL_MODE_AK_DEQ 41

PDEL_MODE_WF_CONF 42

PDEL_MODE_AK_CONF 43

PDEL_MODE_WF_ACK 44

PDEL_MODE_AK_ACK 45

and possible actions are:

PDEL_UMA_RTS 1
PDEL_UMA_DLJ 2
PDEL_UMA_DLQ 3
PDEL_UMA_SAF 4
PDEL_UMA_DISC 5
PDEL_UMA_DISCL 6

Not all combinations are possible (see BEA Message Queue documentation for more information).

Recommended combinations are,

for safe delivery of message
Address[2] = 26
Address[3] = 4

and for discarding the message if it cannot be delivered
Address[2] = 39
Address[3] = 5

If Address[2,3] are both set to zero, a default setting will be used. The default is to discard the
message if it cannot be delivered.

Receiving messages

Address[0,1] are used to identify the message. Address[0] represents the message-class and Address[1]
represents the message-type (according to the BMQ-nomenclature).