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://www.bea.com/ns/weblogic/90"

       
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.
Access Points You can access this MBean from the following MBean attributes:


    Related MBeans

    This section describes attributes that provide access to other MBeans. For more information about the MBean hierarchy, refer to WebLogic Server MBean Data Model.


    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 arrriving 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.