Jms-enqueue

The jms-dequeue element allows you to perform a enqueue on a JMS destination. It is used by Channel and routed-dequeue.

GVBuffer fields will be made available through the JMS message properties:

Field	JMS
system	SYSTEM
service	SERVICE
id	ID
retCode	RET_CODE
properties	p$<property name> (only GVBuffer properties with names that are valid Java identifier are managed)

It has the attributes:

Attribute	Type	Description
type	fixed	This attribute must assume the value enqueue.
class	fixed	This attribute must assume the value it.greenvulcano.gvesb.virtual.j2ee.JMSEnqueueOperation.
name	required	Operation name. Used in the Flow section to associate workflow nodes to VCL operations.
connection-factory	required	JMS connection factory JNDI name.
destination-name	required	Destination JNDI name. Set appropriately the destination-type parameter.
destination-type	optional	Destination type. Default: queue. The attribute's admitted values are: queue topic
transacted	optional	Specifies whether the enqueue has to open his own transaction or fall in a global transaction. 'true' open his own transaction and do not fall in the global transaction. 'false' fall in the active global transaction. Must be used a XA connection factory. This parameter is not relevant if the connection factory is not XA. Default: false.
acknowledge-type	optional	In transactional enqueue acknowledgment is managed by the application server. This parameter is meaningful only for non-transactional enqueue and can take the following values: auto-acknowledge: the acknowledgment from application server is automatically given upon delivery of the message. client-acknowledge: the client must explicitly acknowledgment the message. dups-ok-acknowledge: allows the JMS server to perform optimizations on the logic of acknowledgment messages, but can cause the redelivery of messages. Should only be used with systems that are tolerant to duplicated message. Default: auto-acknowledge
delivery-mode	optional	Specifies whether the JMS server must file on a persistent store the message before returning to the caller. Sending messages persistent slightly affects the performance but provides greater guarantees of delivery. The possible values for this parameter are: persistent : guarantees delivery. Default value non-persistent: don't guarantees delivery
priority	optional	Message priority. The messages with higher priority will be received before messages with lower priority. The priorities set for JMS ranging from 0 (lowest priority) to 9 (highest priority). The default priority of JMS messages is 4.
time-to-live	optional	Lifetime of sent messages, in milliseconds. Upon expiration of the time-to-live the JMS server is allowed to discard the message without delivering it. If not specified it is assumed a time-to-live of one year.
use-vcl-pool	optional	Indicates whether to use connection pooling capabilities of the VCL. Set to false if the container provides pooling capabilities. Default: true
invalidate-conn-on-pool-insertion	optional	Indicates whether connections should be marked as invalid before reinsertion on the pool. Is significant only if the pooling feature is enabled. Default: false
ref-dp	optional	Name of Data Provider to use. This Data Provider will return the JMS Message to send.
dump-message	optional	If true the message to be enqueued is dumped on log file, at DEBUG severity level. Default false

Its subelements are:

• Description
• JNDIHelper
• ServiceAlias
• XAHelper

XAHelper

The XAHelper Element is used by jms-dequeue and jms-enqueue.

Its attributes are:

Attribute	Type	Description
auto-enlist	optional	The attribute's default value is: false.
transaction-status	optional	The attribute's admitted values are: TMSUCCESS: default value TMFAIL

and its subelements:

• Description
• JNDIHelper