Sun GlassFish Message Queue 4.4 Administration Guide

target Attributes

Table 12–6 lists the attributes for the target element in the JMS Bridge XML configuration file.

Table 12–6 target Attributes

Attribute 

Type 

Description 

clientid

String 

A JMS client identifier for the message producer connection; if set, use a dedicated connection. 

Default value: not set 

connection-factory-ref

String 

The ref-name attribute value of the connection-factory element to associate with this target.

Default value: no default 

consume-no-transfer-on-transform-error [First available inMessage Queue 4.4 Update 1]

Boolean 

Controls processing when the message transformer's MessageTransformer.transform() method returns a null value or throws java.lang.Throwable:

  • If true, the message is sent to the DMQ and consumed from the source but not sent to the target.

  • If false, the link is stopped, and the message is neither consumed from the source nor transferred to the target.

Default value: false

destination-ref

String 

The ref-name attribute value of the destination element to associate with this target.

Beginning in Message Queue 4.4 Update 1, the value AS_SOURCE is also supported. This value causes the target destination name and type to be set to the source message's javax.jms.Message.getJMSDestination(), unless overridden by the message transformer's MessageTransformer.branchTo().

Default value: no default 

message-transformer-class

String 

A fully qualified class name that extends the Message Queue bridge MessageTransformer class. For more information, see Message Transformation During Message Delivery. Place this class under the IMQ_HOME/lib/ext directory.

Default value: not set 

retain-replyto

Boolean 

Should the value of the source message's JMSReplyTo header (if specified) be retained? For more information, see JMSReplyTo Header Processing.

Default value: false

stay-connected

Boolean 

If true, the message producer connection will stay connected, and be dedicated.

Default value: true