JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Oracle GlassFish Server Message Queue 4.5 Administration Guide
search filter icon
search icon

Document Information

Preface

Part I Introduction to Message Queue Administration

1.  Administrative Tasks and Tools

2.  Quick-Start Tutorial

Part II Administrative Tasks

3.  Starting Brokers and Clients

4.  Configuring a Broker

5.  Managing a Broker

6.  Configuring and Managing Connection Services

7.  Managing Message Delivery

8.  Configuring Persistence Services

9.  Configuring and Managing Security Services

10.  Configuring and Managing Broker Clusters

11.  Managing Administered Objects

12.  Configuring and Managing Bridge Services

13.  Monitoring Broker Operations

14.  Analyzing and Tuning a Message Service

15.  Troubleshooting

Part III Reference

16.  Command Line Reference

17.  Broker Properties Reference

18.  Physical Destination Property Reference

19.  Administered Object Attribute Reference

20.  JMS Resource Adapter Property Reference

About Shared Topic Subscriptions for Clustered Containers

Disabling Shared Subscriptions

Consumer Flow Control When Shared Subscriptions Are Used

ResourceAdapter JavaBean

ManagedConnectionFactory JavaBean

ActivationSpec JavaBean

21.  Metrics Information Reference

22.  JES Monitoring Framework Reference

Part IV Appendixes

A.  Distribution-Specific Locations of Message Queue Data

B.  Stability of Message Queue Interfaces

C.  HTTP/HTTPS Support

D.  JMX Support

E.  Frequently Used Command Utility Commands

Index

ActivationSpec JavaBean

Table 20-3 shows the configurable properties of the ActivationSpec JavaBean. These properties are used by the application server when instructing the Resource Adapter to activate a message endpoint and associate it with a message-driven bean.

Table 20-3 ActivationSpec Properties

Property
Type
Default Value
Description
addressList1,2
String
Value of connectionURL property of ResourceAdapter JavaBean (see Table 20-1)
Message service address for connecting to Message Queue service
userName1,2
String
Inherited from ResourceAdapter JavaBean (see Table 20-1)
User name for connecting to Message Queue service.
password1,2
String
Inherited from ResourceAdapter JavaBean (see Table 20-1)
Password for connecting to Message Queue service.
clientId3
String
None
Client ID for connections to Message Queue service

This property must be set if subscriptionDurability is set to Durable.

addressListBehavior1,2
String
Inherited from ResourceAdapter JavaBean (see Table 20-1)
Order in which to attempt connection or reconnection to Message Queue service:

PRIORITY: order specified in address list

RANDOM: Random order

addressListIterations1,2
Integer
Inherited from ResourceAdapter JavaBean (see Table 20-1)
Number of times to iterate through addressList attempting to establish or reestablish a connection.

When this limit is reached an exception will be thrown and a new connection attempt will begin, with no limit.

reconnectAttempts1,2
Integer
Inherited from ResourceAdapter JavaBean (see Table 20-1)
Number of times to attempt connection or reconnection to each address in addressList before moving on to next.
reconnectInterval11,2
Integer
Inherited from ResourceAdapter JavaBean (see Table 20-1)
Interval, in milliseconds, between reconnection attempts
destination3
String
None
Name of destination from which to consume messages

The value must be that of the destinationName property for a Message Queue destination administered object.

destinationType3
String
None
Type of destination specified by destination property:
  • javax.jms.Queue: Queue destination

  • javax.jms.Topic: Topic destination

messageSelector1,3
String
None
Message selector for filtering messages delivered to consumer
subscriptionName3
String
None
Name for durable subscriptions

This property must be set if subscriptionDurability is set to Durable.

subscriptionDurability3
String
NonDurable
Durability of consumer for topic destination:
  • Durable: Durable consumer

  • NonDurable: Nondurable consumer

This property is valid only if destinationType is set to javax.jms.Topic, and is optional for nondurable subscriptions and required for durable ones. If set to Durable, the clientID and subscriptionName properties must also be set.

acknowledgeMode1,3
String
Auto-acknowledge
Acknowledgment mode:
  • Auto-acknowledge: Auto-acknowledge mode

  • Dups-ok-acknowledge: Dups-OK-acknowledge mode

customAcknowledgeMode
String
None
Acknowledgment mode for MDB message consumption

Valid values are No_acknowledge or null.

You can use no-acknowledge mode only for a nontransacted, nondurable topic subscription; if you use this setting with a transacted subscription or a durable subscription, subscription activation will fail.

endpointExceptionRedeliveryAttempts
Integer
6
Number of times to redeliver a message when MDB throws an exception during message delivery
sendUndeliverableMsgsToDMQ
Boolean
true
Place message in dead message queue when MDB throws a runtime exception and number of redelivery attempts exceeds the value of endpointExceptionRedeliveryAttempts?

If false, the Message Queue broker will attempt redelivery of the message to any valid consumer, including the same MDB.

options1
String
None
A list of additional connection factory properties to be used when creating connections to a Message Queue broker.

When specified, the value of options must be a comma-separated list of connection factory properties and their values, in the form:

propertyName=value

If value contains a comma or an equals sign, precede the symbol with a backslash (\) or enclose the entire value in quotes; for example:

prop1=comma\,val,prop2="equals=val"

The options property cannot be used to specify properties that are configured internally or that have their own setter methods, specifically: imqReconnectEnabled, imqReconnectAttempts, imqReconnectInterval, imqDefaultUsername, imqDefaultPassword, imqAddressList, imqAddressListIterations, imqAddressListBehavior. Any values specified in options for these properties are ignored.

useSharedSubscriptionInClusteredContainer
Boolean
true
Controls whether topic subscriptions created using this ActivationSpec will be shared when running in a clustered container, as described in About Shared Topic Subscriptions for Clustered Containers.

Set to true (the default) to share subscriptions.

Set to false to not share subscriptions. This setting should only be used for nondurable subscriptions.

1Optional

2Property specific to Message Queue JMS Resource Adapter

3Standard Enterprise JavaBean (EJB) and J2EE Connector Architecture (CA) property

Note that there is no reconnectEnabled property for the ActivationSpec JavaBean.