JMSBean


Overview  |   Related MBeans  |   Attributes  |   Operations

Overview

The top of the JMS module bean tree.

JMS modules all have a JMSBean as their root bean (a bean with no parent). The schema namespace that corresponds to this bean is "http://xmlns.oracle.com/weblogic/weblogic-jms"

       
Security rolesThe following roles have read, write, and invoke permission for all non-encrypted attributes and operations in this MBean:
  • Deployer
Fully Qualified Interface NameIf you use the getMBeanInfo operation in MBeanTypeServiceMBean, supply the following value as this MBean's fully qualified interface name:
weblogic.j2ee.descriptor.wl.JMSBean
Factory Methods No factory methods. Instances of this MBean are created automatically.


Related MBeans

This section describes attributes that provide access to other MBeans.


ConnectionFactories

Defines a set of connection configuration parameters that are used to create connections for JMS clients.

Connection factories can configure properties of the connections returned to the JMS client, and also provide configurable options for default delivery, transaction, and message flow control parameters.

           
Factory MethodscreateConnectionFactory (java.lang.String name)

destroyConnectionFactory (JMSConnectionFactoryBean connectionFactory)

Factory methods do not return objects.

See Using factory methods.

Lookup OperationlookupConnectionFactory(String name)

Returns a javax.management.ObjectName for the instance of JMSConnectionFactoryBean named name.

Privileges Read only
TypeJMSConnectionFactoryBean[]
Relationship type: Containment.

DestinationKeys

Defines a unique sort order that destinations can apply to arriving messages.

By default messages are sorted in FIFO (first-in, first-out) order, which sorts ascending based on each message's unique JMSMessageID. However, you can configure destination key to use a different sorting scheme for a destination, such as LIFO (last-in, first-out).

           
Factory MethodscreateDestinationKey (java.lang.String name)

destroyDestinationKey (DestinationKeyBean destinationKey)

Factory methods do not return objects.

See Using factory methods.

Lookup OperationlookupDestinationKey(String name)

Returns a javax.management.ObjectName for the instance of DestinationKeyBean named name.

Privileges Read only
TypeDestinationKeyBean[]
Relationship type: Containment.

DistributedQueues

Defines a set of queues that are distributed on multiple JMS servers, but which are accessible as a single, logical queue to JMS clients.

Distributed queues can help with message load balancing and distribution, and have many of the same properties as standalone queues.

           
Factory MethodscreateDistributedQueue (java.lang.String name)

destroyDistributedQueue (DistributedQueueBean distributedQueue)

Factory methods do not return objects.

See Using factory methods.

Lookup OperationlookupDistributedQueue(String name)

Returns a javax.management.ObjectName for the instance of DistributedQueueBean named name.

Privileges Read only
TypeDistributedQueueBean[]
Relationship type: Containment.

DistributedTopics

Defines a set of topics that are distributed on multiple JMS servers, but which are accessible as a single, logical topic to JMS clients.

Distributed topics can help with load balancing and distribution, and have many of the same properties as standalone topics.

           
Factory MethodscreateDistributedTopic (java.lang.String name)

destroyDistributedTopic (DistributedTopicBean distributedTopic)

Factory methods do not return objects.

See Using factory methods.

Lookup OperationlookupDistributedTopic(String name)

Returns a javax.management.ObjectName for the instance of DistributedTopicBean named name.

Privileges Read only
TypeDistributedTopicBean[]
Relationship type: Containment.

ForeignServers

Defines foreign messaging providers or remote WebLogic Server instances that are not part of the current domain.

This is useful when integrating with another vendor's JMS product, or when referencing remote instances of WebLogic Server in another cluster or domain in the local WebLogic JNDI tree.

           
Factory MethodscreateForeignServer (java.lang.String name)

destroyForeignServer (ForeignServerBean foreignServer)

Factory methods do not return objects.

See Using factory methods.

Lookup OperationlookupForeignServer(String name)

Returns a javax.management.ObjectName for the instance of ForeignServerBean named name.

Privileges Read only
TypeForeignServerBean[]
Relationship type: Containment.

Queues

Defines a point-to-point destination type, which are used for asynchronous peer communications. A message delivered to a queue is distributed to only one consumer.

Several aspects of a queue's behavior can be configured, including thresholds, logging, delivery overrides, and delivery failure options.

           
Factory MethodscreateQueue (java.lang.String name)

destroyQueue (QueueBean queue)

Factory methods do not return objects.

See Using factory methods.

Lookup OperationlookupQueue(String name)

Returns a javax.management.ObjectName for the instance of QueueBean named name.

Privileges Read only
TypeQueueBean[]
Relationship type: Containment.

Quotas

Controls the allotment of system resources available to destinations.

For example, the number of bytes a destination is allowed to store can be configured with a Quota resource.

           
Factory MethodscreateQuota (java.lang.String name)

destroyQuota (QuotaBean quota)

Factory methods do not return objects.

See Using factory methods.

Lookup OperationlookupQuota(String name)

Returns a javax.management.ObjectName for the instance of QuotaBean named name.

Privileges Read only
TypeQuotaBean[]
Relationship type: Containment.

SAFErrorHandlings

Defines the action to take when the SAF service fails to forward messages to remote destinations.

Configuration options include an Error Handling Policy (Redirect, Log, Discard, or Always-Forward), a Log Format, and sending Retry parameters.

           
Factory MethodscreateSAFErrorHandling (java.lang.String name)

destroySAFErrorHandling (SAFErrorHandlingBean safErrorHandling)

Factory methods do not return objects.

See Using factory methods.

Lookup OperationlookupSAFErrorHandling(String name)

Returns a javax.management.ObjectName for the instance of SAFErrorHandlingBean named name.

Privileges Read only
TypeSAFErrorHandlingBean[]
Relationship type: Containment.

SAFImportedDestinations

Defines a collection of imported store-and-forward (SAF) destinations. A SAF destination is a representation of a queue or topic in a remote server instance or cluster that is imported into the local cluster or server instance, so that the local server instance or cluster can send messages to the remote server instance or cluster.

All JMS destinations are automatically exported by default, unless the Export SAF Destination parameter on a destination is explicitly disabled. Each collection of SAF imported destinations is associated with a remote SAF context resource, and, optionally, a SAF error handling resource.

           
Factory MethodscreateSAFImportedDestinations (java.lang.String name)

destroySAFImportedDestinations (SAFImportedDestinationsBean safImportedDestinations)

Factory methods do not return objects.

See Using factory methods.

Lookup OperationlookupSAFImportedDestinations(String name)

Returns a javax.management.ObjectName for the instance of SAFImportedDestinationsBean named name.

Privileges Read only
TypeSAFImportedDestinationsBean[]
Relationship type: Containment.

SAFRemoteContexts

Defines the URL of the remote server instance or cluster where a JMS destination is exported from. It also contains the security credentials to be authenticated and authorized in the remote cluster or server.

           
Factory MethodscreateSAFRemoteContext (java.lang.String name)

destroySAFRemoteContext (SAFRemoteContextBean safRemoteContext)

Factory methods do not return objects.

See Using factory methods.

Lookup OperationlookupSAFRemoteContext(String name)

Returns a javax.management.ObjectName for the instance of SAFRemoteContextBean named name.

Privileges Read only
TypeSAFRemoteContextBean[]
Relationship type: Containment.

Templates

Defines a set of default configuration settings for multiple destinations.

If a destination specifies a template and does not explicitly set the value of a parameter, then that parameter will take its value from the specified template.

           
Factory MethodscreateTemplate (java.lang.String name)

destroyTemplate (TemplateBean template)

Factory methods do not return objects.

See Using factory methods.

Lookup OperationlookupTemplate(String name)

Returns a javax.management.ObjectName for the instance of TemplateBean named name.

Privileges Read only
TypeTemplateBean[]
Relationship type: Containment.

Topics

Defines a publish/subscribe destination type, which are used for asynchronous peer communications. A message delivered to a topic is distributed to all topic consumers.

Several aspects of a topic's behavior can be configured, including thresholds, logging, delivery overrides, delivery failure, and multicasting parameters.

           
Factory MethodscreateTopic (java.lang.String name)

destroyTopic (TopicBean topic)

Factory methods do not return objects.

See Using factory methods.

Lookup OperationlookupTopic(String name)

Returns a javax.management.ObjectName for the instance of TopicBean named name.

Privileges Read only
TypeTopicBean[]
Relationship type: Containment.

UniformDistributedQueues

Defines a uniformly configured distributed queue, whose members have a consistent configuration of all distributed queue parameters, particularly in regards to weighting, security, persistence, paging, and quotas. These uniform distributed queue members are created on JMS servers based on the targeting of the uniform distributed queue.

Uniform distributed queues can help with message load balancing and distribution, and have many of the same properties as standalone queues, including thresholds, logging, delivery overrides, and delivery failure parameters.

           
Factory MethodscreateUniformDistributedQueue (java.lang.String name)

destroyUniformDistributedQueue (UniformDistributedQueueBean uniformDistributedQueue)

Factory methods do not return objects.

See Using factory methods.

Lookup OperationlookupUniformDistributedQueue(String name)

Returns a javax.management.ObjectName for the instance of UniformDistributedQueueBean named name.

Privileges Read only
TypeUniformDistributedQueueBean[]
Relationship type: Containment.

UniformDistributedTopics

Defines a uniformly configured distributed topic, whose members have a consistent configuration of all uniform distributed queue parameters, particularly in regards to weighting, security, persistence, paging, and quotas. These uniform distributed topic members are created on JMS servers based on the targeting of the uniform distributed topic.

Uniform distributed topics can help with message load balancing and distribution, and have many of the same properties as standalone topics, including thresholds, logging, delivery overrides, and delivery failure parameters.

           
Factory MethodscreateUniformDistributedTopic (java.lang.String name)

destroyUniformDistributedTopic (UniformDistributedTopicBean uniformDistributedTopic)

Factory methods do not return objects.

See Using factory methods.

Lookup OperationlookupUniformDistributedTopic(String name)

Returns a javax.management.ObjectName for the instance of UniformDistributedTopicBean named name.

Privileges Read only
TypeUniformDistributedTopicBean[]
Relationship type: Containment.


Attributes

This section describes the following attributes:


    Notes

    Optional information that you can include to describe this JMS module.

    JMS module saves this note in the JMS descriptor file as XML PCDATA. All left angle brackets (<) are converted to the XML entity &lt;. Carriage returns/line feeds are preserved.

    Note:

    If you create or edit a note from the Administration Console, the Administration Console does not preserve carriage returns/line feeds.

           
    Privileges Read/Write
    Typejava.lang.String

    Version

    The version of this file.

           
    Privileges Read/Write
    Typeint
    Default Value1


    Operations

    This section describes the following operations:


    isSet

    Return true if the given property has been explicitly set in this bean.

       
    Operation Name"isSet"
    ParametersObject [] {  propertyName }

    where:

    • propertyName is an object of type java.lang.String that specifies:

      property to check

    SignatureString [] { "java.lang.String" }
    Returns boolean
    Exceptions
    • java.lang.IllegalArgumentException
      IllegalArgumentException if propertyName is not a recognized property

    lookupQueue

    Locates a queue bean with the given name

    Queues are used for asynchronous peer communications. A message delivered to a queue will be distributed to one consumer. Several aspects of a queues behavior can be configured with a queue bean.

       
    Operation Name"lookupQueue"
    ParametersObject [] {  name }

    where:

    • name is an object of type java.lang.String that specifies:

      The name of the queue to lookup

    SignatureString [] { "java.lang.String" }
    ReturnsQueueBean

    lookupTopic

    Locates a topic bean with the given name

       
    Operation Name"lookupTopic"
    ParametersObject [] {  name }

    where:

    • name is an object of type java.lang.String that specifies:

      The name of the topic to lookup

    SignatureString [] { "java.lang.String" }
    ReturnsTopicBean

    unSet

    Restore the given property to its default value.

       
    Operation Name"unSet"
    ParametersObject [] {  propertyName }

    where:

    • propertyName is an object of type java.lang.String that specifies:

      property to restore

    SignatureString [] { "java.lang.String" }
    Returns void
    Exceptions
    • java.lang.IllegalArgumentException
      UnsupportedOperationException if called on a runtime implementation.