Tagged Values
<<JMSAlias>>
Multiexcerpt |
---|
MultiExcerptName | jms_alias |
---|
|
Tagged Value | Description | Allowed Values / Example |
---|
acknowledgeMode | Specify the message acknowledge mode. We recommend using acknowledge mode transacted.
| Auto | Multiexcerpt |
---|
MultiExcerptName | acknowledgeMode_auto |
---|
| Each single message sent to a JMS provider will be acknowledged by the JMS provider (not the recipient) after recipience. Messages received from a JMS provider within an activity are acknowledged irrespective of subsequent activities. Consequently, if an error occurs during the execution of the activity diagram after message receipt, no rollback occurs. Using Auto acknowledge mode in a model, a client must be prepared for possible loss of messages. |
| Duplicate | Multiexcerpt |
---|
MultiExcerptName | acknowledgeMode_duplicate |
---|
| Duplicate acknowledge mode corresponds to Auto acknowledge mode. Additionally, the JMS provider may send the message more than once to the same destination. The receiving application must be tolerant of receiving duplicate messages. |
| Transacted | Multiexcerpt |
---|
MultiExcerptName | acknowledgeMode_transacted |
---|
| Messages sent to or received from a JMS provider within an activity are acknowledged explicitly after processing. Thus, the activity plays the role of a transactional lock. Info |
---|
| If the acknowledgeMode is specified as Transacted , a Bridge JMS client acknowledges a consumed message only after the activity diagram that implements the JMS adapter functionality completes without throwing an exception. This holds even if the activity diagram receives more then one message from, and/or sends messages to the queue during its execution. |
|
| timeToLive | |
| selector | Multiexcerpt |
---|
| Specify a selector to filter the received messages. Refer to the official Java Message Service Specification for the selector statement syntax. |
| e.g. JMSType='alpha'
| destinationName | Multiexcerpt |
---|
MultiExcerptName | destinationName |
---|
| Specify the name of the queue or topic. |
|
| options | Multiexcerpt |
---|
| Specify a list of comma separated options in form of <name>=<value>. These options will be interpreted as native options. The available options depend on the JMS provider. |
| e.g. queue.JMSDestination=aTestQueue
| user | Multiexcerpt |
---|
| Specify the JMS credentials in form of <user>/<password>. |
| e.g. system/manager | port | Multiexcerpt |
---|
| Specify the port the JMS provider is listening to. |
|
| protocol | Multiexcerpt |
---|
| Protocol used to communicate with the JMS provider. The protocol normally is set automatically. |
|
| jndiPath | Multiexcerpt |
---|
| Specify a path to the JNDI file (.bindings), if a JNDI provider is used and protocol is file. |
|
| host | Multiexcerpt |
---|
| Specify the host name of the JMS provider. |
| localhost | Default. | any other qualified host name |
| isJNDIProvider | Multiexcerpt |
---|
MultiExcerptName | isJNDIProvider |
---|
| Specify whether the JMS provider is also a JNDI provider. Default is false if not specified. |
| true | Multiexcerpt |
---|
MultiExcerptName | isJNDIProvider_true |
---|
| The JMS provider is a JNDI provider. |
| false | Multiexcerpt |
---|
MultiExcerptName | isJNDIPRovider_false |
---|
| The JMS provider is not a JNDI provider (default). |
| |
...
Multiexcerpt |
---|
|
Name | Type | Direction | Mandatory | Description |
---|
connectionInfo | JMSConnectionInfo | in |
| Specify the JMS connection details. See type type JMSConnectionInfo for more details. | sendParameter | JMSSendParameter | in |
| Specify the send action details. See type JMSReceiveParameter JMSSendParameter for more details. | messageString | String | in | () | This parameter contains the JMS message to be send, if it contains a String. Info |
---|
| One of messageString, messageBlob, jmsStringMessage or jmsBloblMessage must be specified. |
| jmsStringMessage | JMSStringMessage | in | () | This parameter contains the JMS message to be send including all message properties, if it is a String message. See type JMSStringMessage for more details. Info |
---|
| One of messageString, messageBlob, jmsStringMessage or jmsBloblMessage must be specified. |
| messageBlob | Blob | in | () | This parameter contains the JMS message to be send, if it contains a Blob. Info |
---|
| One of messageString, messageBlob, jmsStringMessage or jmsBloblMessage must be specified. |
| jmsBloblMessage | JMSBlobMessage | in | () | This parameter contains the JMS message to be send including all message properties, if it is a Blob message. See type JMSBlobMessage for more details. Info |
---|
| One of messageString, messageBlob, jmsStringMessage or jmsBloblMessage must be specified. |
| |
Anchor |
---|
| header_fields |
---|
| header_fields |
---|
|
JMS Standard
The JMS Message parameter contains the following headers/JMS properties:
Multiexcerpt |
---|
MultiExcerptName | header_fields |
---|
|
Name | Type | Description | Allowed Values |
---|
JMSCorrelationID | String | Multiexcerpt |
---|
MultiExcerptName | JMSCorrelationID |
---|
| A client can use this header field to link one message with another. A typical use is to link a response message with its request message. You can override JMSCorrelationID with a custom value. |
|
| JMSPersistentDeliveryMode | Boolean | Multiexcerpt |
---|
MultiExcerptName | JMSPersistentDeliveryMode |
---|
| This header field contains the delivery mode specified when the message is sent. |
| true | Multiexcerpt |
---|
MultiExcerptName | JMSPersistentDeliveryMode_true |
---|
| The JMS provider has to take extra care to ensure that the message is not lost in transit due to a JMS provider failure (default). The JMS provider must deliver the message once and only once. |
| false | Multiexcerpt |
---|
MultiExcerptName | JMSPersistentDeliveryMode_false |
---|
| The JMS provider may lose the message due to a JMS provider failure. |
| JMSDestination | String | Multiexcerpt |
---|
MultiExcerptName | JMSDestination |
---|
| This header field contains the destination, to which the message is sent. |
|
| JMSExpiration | Integer | Multiexcerpt |
---|
MultiExcerptName | JMSExpiration |
---|
| When a message is sent, its expiration time is calculated as the sum of the time-to-live value specified on the send method and the current GMT value. On return from the send method, the JMSExpiration header field of the message contains this value. When a message is received, its JMSExpiration header field contains the same value. |
| 0 | Multiexcerpt |
---|
MultiExcerptName | JMSExpiration_0 |
---|
| The JMS does not expire. |
| >0 | Multiexcerpt |
---|
MultiExcerptName | JMSExpiration_any |
---|
| The JMS message expires after the given period of time. |
| JMSMessageID | String | Multiexcerpt |
---|
MultiExcerptName | JMSMessageID |
---|
| This header field contains a value that uniquely identifies each message sent by a provider. A JMSMessageID is a string value, which should function as a unique key for identifying messages in a historical repository. A provider defines the exact scope of uniqueness. Combined with JMSCorrelationID , this header field is used to link messages, and thus to implement synchronous messaging. |
|
|
| JMSPriority | Integer | Multiexcerpt |
---|
MultiExcerptName | JMSPriority |
---|
| This header field contains the message’s priority. JMS defines a ten-level priority value, with 0 as the lowest priority and 9 as the highest. |
| 0-4 | Multiexcerpt |
---|
MultiExcerptName | JMSPriority_normal |
---|
| The JMS message has a normal priority (4 is the default value). |
| 5-9 | Multiexcerpt |
---|
MultiExcerptName | JMSPriority_expedited |
---|
| The JMS message has an expedited priority. |
| JMSRedelivered | Boolean | Multiexcerpt |
---|
MultiExcerptName | JMSRedelivered |
---|
| If a client receives a message with the JMSRedelivered indicator set to true, it is likely, but not guaranteed, that this message was delivered, but not acknowledged, in the past. In general, a provider must set this message header field to true whenever he redelivers a message. |
| true | Multiexcerpt |
---|
MultiExcerptName | JMSRedelivered_true |
---|
| The JMS message has been redelivered. This is an indication to the consuming application that the message may have been delivered in the past and that the application should take extra precautions to prevent duplicate processing. |
| false | Multiexcerpt |
---|
MultiExcerptName | JMSRedelivered_false |
---|
| The JMS message has not been redelivered. |
| JMSReplyTo | String | Multiexcerpt |
---|
MultiExcerptName | JMSReplyTo |
---|
| This header field contains the name of a destination, to which the recipient of the message should send a reply. The client sending the message specifies the JMSReplyTo field value. |
|
| JMSTimestamp | Integer | Multiexcerpt |
---|
MultiExcerptName | JMSTimestamp |
---|
| This header field contains the time a client passes the message to a provider to be sent. The time is not the actual transmission time of the message; the actual send may occur later due to transactions or other client side queuing of messages. |
|
| JMSType | String | Multiexcerpt |
---|
| This header field contains a message type identifier supplied by a client when the message is sent. Some messaging systems require that a message type definition is created for each application message and that each message specifies its type. In order to work with such JMS providers, JMS clients should assign a value to JMSType whether the application makes use of it or not. The assignment of a value ensures that the field is set properly for those providers that require a JMSType valuea JMSType value. |
|
| JMSCorrelationIDAsBytes | Blob | Contains the JMSCorrelationID in Blob format. |
| |
Custom
The JMS Message parameter contains arrays to define custom headers/JMS properties as name/value pairs (see JMSMessage below).
The following custom headers are provided automatically by the xUML Runtime:
Multiexcerpt |
---|
MultiExcerptName | header_fields_custom |
---|
|
Name | Type | Description | Allowed Values |
---|
X-Transaction-ID | String | Multiexcerpt |
---|
MultiExcerptName | X-Transaction-ID |
---|
| This header field contains a unique transaction ID (see Transaction ID). |
|
| |
JMS Adapter Parameter Types
...
JMSConnectionInfo
Class | Attribute | Type | Description | Allowed Values |
---|
JMSConnectionInfo | acknowledgeMode | JMSAcknowledgeModes | Multiexcerpt |
---|
MultiExcerptName | acknowledgeMode |
---|
| Message acknowledge mode. We recommend using acknowledge mode transacted. |
| Auto | Multiexcerpt include |
---|
MultiExcerptName | acknowledgeMode_auto |
---|
PageWithExcerpt | @self |
---|
|
|
Duplicate | Multiexcerpt include |
---|
MultiExcerptName | acknowledgeMode_duplicate |
---|
PageWithExcerpt | @self |
---|
|
|
Transacted | Multiexcerpt include |
---|
MultiExcerptName | acknowledgeMode_transacted |
---|
PageWithExcerpt | @self |
---|
|
|
name | String | Arbitrary name of the JMS session to distinct multiple sessions. |
|
user | String | |
|
password | String | JMS user password. |
|
path | String | Multiexcerpt include |
---|
MultiExcerptName | jndiPath |
---|
PageWithExcerpt | @self |
---|
|
|
|
protocol | String | Multiexcerpt include |
---|
MultiExcerptName | protocol |
---|
PageWithExcerpt | @self |
---|
|
|
|
host | String | Multiexcerpt include |
---|
MultiExcerptName | host |
---|
PageWithExcerpt | @self |
---|
|
|
|
port | Integer | Multiexcerpt include |
---|
MultiExcerptName | port |
---|
PageWithExcerpt | @self |
---|
|
|
|
properties | Array of JMSStringProperty | Array of key/value pairs used to specify additional JMS Provider properties (e.g. the message queue using ActiveMQ). |
|
JMSMessage
Class | Attribute | Type | Description | Allowed Values |
---|
| longProperties | JMSLongProperty | JMS properties. |
|
byteProperties | JMSByteProperty | JMS properties. |
|
booleanProperties | JMSBooleanProperty | JMS properties. |
|
doubleProperties | JMSDoubleProperty | JMS properties. |
|
stringProperties | JMSStringProperty | JMS properties. |
|
integerProperties | JMSIntegerProperty | JMS properties. |
|
floatProperties | JMSFloatProperty | JMS properties. |
|
shortProperties | JMSShortProperty | JMS properties. |
|
JMSCorrelationID | String | Multiexcerpt include |
---|
MultiExcerptName | JMSCorrelationID |
---|
PageWithExcerpt | @self |
---|
|
|
|
JMSPersistentDeliveryMode | Boolean | Multiexcerpt include |
---|
MultiExcerptName | JMSPersistentDeliveryMode |
---|
PageWithExcerpt | @self |
---|
|
| true | Multiexcerpt include |
---|
MultiExcerptName | JMSPersistentDeliveryMode_true |
---|
PageWithExcerpt | @self |
---|
|
|
false | Multiexcerpt include |
---|
MultiExcerptName | JMSPersistentDeliveryMode_false |
---|
PageWithExcerpt | @self |
---|
|
|
JMSDestination | String | Multiexcerpt include |
---|
MultiExcerptName | JMSDestination |
---|
PageWithExcerpt | @self |
---|
|
|
|
JMSExpiration | Integer | Multiexcerpt include |
---|
MultiExcerptName | JMSExpiration |
---|
PageWithExcerpt | @self |
---|
|
| 0 | Multiexcerpt include |
---|
MultiExcerptName | JMSExpiration_0 |
---|
PageWithExcerpt | @self |
---|
|
|
>0 | Multiexcerpt include |
---|
MultiExcerptName | JMSExpiration_any |
---|
PageWithExcerpt | @self |
---|
|
|
JMSMessageID | String | Multiexcerpt include |
---|
MultiExcerptName | JMSMessageID |
---|
PageWithExcerpt | @self |
---|
|
|
|
JMSPriority | Integer | Multiexcerpt include |
---|
MultiExcerptName | JMSPriority |
---|
PageWithExcerpt | @self |
---|
|
| 0-4 | Multiexcerpt include |
---|
MultiExcerptName | JMSPriority_normal |
---|
PageWithExcerpt | @self |
---|
|
|
5-9 | Multiexcerpt include |
---|
MultiExcerptName | JMSPriority_expedited |
---|
PageWithExcerpt | @self |
---|
|
|
JMSRedelivered | Boolean | Multiexcerpt include |
---|
MultiExcerptName | JMSRedelivered |
---|
PageWithExcerpt | @self |
---|
|
| true | Multiexcerpt include |
---|
MultiExcerptName | JMSRedelivered_true |
---|
PageWithExcerpt | @self |
---|
|
|
false | Multiexcerpt include |
---|
MultiExcerptName | JMSRedelivered_false |
---|
PageWithExcerpt | @self |
---|
|
|
JMSReplyTo | String | Multiexcerpt include |
---|
MultiExcerptName | JMSReplyTo |
---|
PageWithExcerpt | @self |
---|
|
|
|
JMSTimestamp | Integer | Multiexcerpt include |
---|
MultiExcerptName | JMSTimestamp |
---|
PageWithExcerpt | @self |
---|
|
|
|
JMSType | String | Multiexcerpt include |
---|
MultiExcerptName | JMSType |
---|
PageWithExcerpt | @self |
---|
|
|
|
JMSCorrelationIDAsBytes | Blob | JMSCorrelationID as a Blob. |
|
JMSBlobMessage
Class | Attribute | Type | Description | Allowed Values |
---|
JMSBlobMessage | Possible type of a JMS message body. Derives from JMSMessage. |
|
message | Blob | Blob message content. |
JMSStringMessage
Class | Attribute | Type | Description | Allowed Values |
---|
JMSStringMessage | Possible type of a JMS message body. Derives from JMSMessage. | message | String | String message content. |
|
message | String | String message content. |
|
JMSReceiveParameter
Class | Attribute | Type | Description | Allowed Values |
---|
JMSReceiveParameter | queueName | String | Specifies the name of the queue/topic, from which messages are received and is mandatory in order to receive messages |
|
selector | String | Used to filter the received messages (e.g. JMSType='alpha'). Refer to the official Java Message Service specification for the selector statement syntax. |
|
millisecondsToWait | Integer | Specifies the time the JMS adapter is waiting for a message from the specified queue/topic |
|
JMSSendParameter
Class | Attribute | Type | Description | Allowed Values |
---|
JMSSendParameter | queueName | String | Specifies the name of the queue/topic, to which messages are sent. |
|
timeToLive | Integer | Specifies the expiration time of a sent message (refer also to the description of JMSExpiration in JMS Adapter Header Fields the JMS headers/properties). |
|
JMSSessionParameter
Class | Attribute | Type | Description | Allowed Values |
---|
JMSSessionParameter | acknowledgeMode | JMSAcknowledgeModes | Multiexcerpt include |
---|
MultiExcerptName | acknowledgeMode |
---|
PageWithExcerpt | @self |
---|
|
| Auto | Multiexcerpt include |
---|
MultiExcerptName | acknowledgeMode_auto |
---|
PageWithExcerpt | @self |
---|
|
|
Duplicate | Multiexcerpt include |
---|
MultiExcerptName | acknowledgeMode_duplicate |
---|
PageWithExcerpt | @self |
---|
|
|
Transacted | Multiexcerpt include |
---|
MultiExcerptName | acknowledgeMode_transacted |
---|
PageWithExcerpt | @self |
---|
|
|
name | String | Arbitrary name of the JMS session to distinct multiple sessions. |
|
connectionFactoryClass | String | Name of the connection factory class. |
|
connectionFactoryProperties | JMSStringProperty | Properties of the connection factory. |
|
user | String | JMS user. |
|
password | String | JMS user password. |
|
Custom JMS Properties
Class | Attribute | Type | Description | Allowed Values |
---|
JMSBooleanProperty | key | String | Key of the JMS property. |
|
value | Boolean | Boolean property value. |
|
JMSByteProperty JMSIntegerProperty JMSLongProperty JMSShortProperty | key | String | Key of the JMS property. |
|
value | Integer | Integer property value. |
|
JMSDoubleProperty JMSFloatProperty | key | String | Key of the JMS property. |
|
value | Float | Float property value. |
|
JMSStringProperty | key | String | Key of the JMS property. |
|
value | String | String property value. |
...
JMSAcknowledgeModes
Enumeration | Type | Value | Description |
---|
JMSAcknowledgeModes | String | Auto | Multiexcerpt include |
---|
MultiExcerptName | acknowledgeMode_auto |
---|
PageWithExcerpt | @self |
---|
|
|
Duplicate | Multiexcerpt include |
---|
MultiExcerptName | acknowledgeMode_duplicate |
---|
PageWithExcerpt | @self |
---|
|
|
Transacted | Multiexcerpt include |
---|
MultiExcerptName | acknowledgeMode_transacted |
---|
PageWithExcerpt | @self |
---|
|
|