ApplicationRuntimeMBean


Overview  |   Related MBeans  |   Attributes  |   Operations

Overview

An application represents a J2EE Enterprise application packaged in an EAR file or EAR exploded directory. The EAR file or directory contains a set of components such as WAR, EJB, and RAR connector components, each of which can be deployed on one or more targets. A target is a server or a cluster. Modules in the application can have one of the following states:

ApplicationRuntimeMBean encapsulates runtime information about a deployed Enterprise application.

       
Security rolesThe following roles have read, write, and invoke permission for all non-encrypted attributes and operations in this MBean:
  • Operator
Fully Qualified Interface NameIf you use the getMBeanInfo operation in MBeanTypeServiceMBean, supply the following value as this MBean's fully qualified interface name:
weblogic.management.runtime.ApplicationRuntimeMBean
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.


    ClassRedefinitionRuntime

    If class fast-swap feature is enabled for the application, return the runtime mbean to monitor and control the class fast-swap within the application.

           
    Factory Methods No explicit creator method. The child shares the lifecycle of its parent.
    Privileges Read only
    TypeClassRedefinitionRuntimeMBean
    Relationship type: Containment.

    CoherenceClusterRuntime

    Returns the Coherence Cluster related runtime mbean

           
    Privileges Read only
    TypeCoherenceClusterRuntimeMBean
    Relationship type: Reference.

    ComponentRuntimes

    Returns the list of component runtime instances for each J2EE component (such as an EJB or a Web application) that is contained in this Enterprise application.

           
    Factory Methods No explicit creator method. The child shares the lifecycle of its parent.
    Privileges Read only
    TypeComponentRuntimeMBean[]
    Relationship type: Containment.

    KodoPersistenceUnitRuntimes

    Provides an array of KodoPersistenceUnitRuntimeMBean objects for this EJB module.

    Deprecated. As of 11.1.2.0, use getPersistenceUnitRuntimes instead

           
    Factory Methods No explicit creator method. The child shares the lifecycle of its parent.
    Privileges Read only
    TypeKodoPersistenceUnitRuntimeMBean[]
    Relationship type: Containment.

    LibraryRuntimes

    Returns the list of library runtime instances for each J2EE library that is contained in this Enterprise application.

           
    Factory Methods No explicit creator method. The child shares the lifecycle of its parent.
    Privileges Read only
    TypeLibraryRuntimeMBean[]
    Relationship type: Containment.

    MaxThreadsConstraintRuntimes

    Get the runtime mbeans for all MaxThreadsConstraints defined at the app-level

               
    Lookup OperationlookupMaxThreadsConstraintRuntime(String name)

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

    Privileges Read only
    TypeMaxThreadsConstraintRuntimeMBean[]
    Relationship type: Reference.

    MinThreadsConstraintRuntimes

    Get the runtime mbeans for all MinThreadsConstraints defined at the app-level

               
    Lookup OperationlookupMinThreadsConstraintRuntime(String name)

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

    Privileges Read only
    TypeMinThreadsConstraintRuntimeMBean[]
    Relationship type: Reference.

    OptionalPackageRuntimes

    Returns the list of optional package runtime instances for each J2EE optional package that is contained in this Enterprise application.

           
    Factory Methods No explicit creator method. The child shares the lifecycle of its parent.
    Privileges Read only
    TypeLibraryRuntimeMBean[]
    Relationship type: Containment.

    PersistenceUnitRuntimes

    Provides an array of PersistenceUnitRuntimeMBean objects for this ear module.

           
    Factory Methods No explicit creator method. The child shares the lifecycle of its parent.
    Privileges Read only
    TypePersistenceUnitRuntimeMBean[]
    Relationship type: Containment.

    QueryCacheRuntimes

    Returns a list of QueryCacheRuntimeMBeans configured for this application.

               
    Lookup OperationlookupQueryCacheRuntime(String name)

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

    Privileges Read only
    TypeQueryCacheRuntimeMBean[]
    Relationship type: Reference.

    RequestClassRuntimes

    Get the runtime mbeans for all request classes defined at the app-level

               
    Lookup OperationlookupRequestClassRuntime(String name)

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

    Privileges Read only
    TypeRequestClassRuntimeMBean[]
    Relationship type: Reference.

    WorkManagerRuntimes

    Returns the list of work manager runtime instances for each application-scoped work manager that is associated with this Enterprise application.

               
    Lookup OperationlookupWorkManagerRuntime(String name)

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

    Privileges Read only
    TypeWorkManagerRuntimeMBean[]
    Relationship type: Reference.

    WseeRuntimes

    Returns the list of Web Service runtime instances that are contained in this Enterprise application.

    Deprecated. Use getWseeV2Runtimes from the web app or EJB component instead

           
    Privileges Read only
    TypeWseeRuntimeMBean[]
    Relationship type: Reference.

    WseeV2Runtimes

    Returns the list of Web Service runtime instances that are contained at the application scope of this Enterprise application. This can happen when javax.xml.ws.Endpoint.publish() is called from within an application lifecycle listener

               
    Lookup OperationlookupWseeV2Runtime(String name)

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

    Privileges Read only
    TypeWseeV2RuntimeMBean[]
    Relationship type: Reference.


    Attributes

    This section describes the following attributes:


    ActiveVersionState

    Specifies whether this application version is the currently active version.

    An application can be the only version currently deployed, or it can have more than one version currently deployed, using the side-by-side deployment feature. If more than one version is deployed, only one version can be active. This attribute specifies the state in which the current application version is in.

    An application can be in an INACTIVE state, which means that it has not been activated yet, or that there is more than one version of the application deployed (using side-by-side deployment) and this one is retiring.

    An application can be in ACTIVE_ADMIN state, which means that it is the currently active version for administrative channel requests.

    An application can be in ACTIVE state, which means that it is the currently active version for normal (non-administrative) channel requests.

    See weblogic.deploy.version.AppActiveVersionState for state values.

           
    Privileges Read only
    Typeint

    ApplicationName

    The name of the Enterprise application.

           
    Privileges Read only
    Typejava.lang.String

    ApplicationVersion

    The Enterprise application's version identifier.

    This is particularly useful, when using the side-by-side deployment feature, to differentiate between two different versions of the same application that are deployed at the same time.

           
    Privileges Read only
    Typejava.lang.String

    CachingDisabled

    Private property that disables caching in proxies.

           
    Privileges Read only
    Typeboolean

    HealthState

    The HealthState mbean for the application.

    See weblogic.health.HealthState for state values.

           
    Privileges Read only
    Typeweblogic.health.HealthState

    MBeanInfo

    Returns the MBean info for this MBean.

    Deprecated.

           
    Privileges Read only
    Typejavax.management.MBeanInfo

    Name

    The name of this configuration. WebLogic Server uses an MBean to implement and persist the configuration.

           
    Privileges Read only
    Typejava.lang.String

    ObjectName

    Returns the ObjectName under which this MBean is registered in the MBean server.

    Deprecated.

           
    Privileges Read only
    Typeweblogic.management.WebLogicObjectName

    Parent

    Return the immediate parent for this MBean

           
    Privileges Read/Write
    Type

    Registered

    Returns false if the MBean represented by this object has been unregistered.

    Deprecated.

           
    Privileges Read only
    Typeboolean

    Type

    Returns the type of the MBean.

           
    Privileges Read only
    Typejava.lang.String


    Operations

    This section describes the following operations:


    getKodoPersistenceUnitRuntime

    Provides the KodoPersistenceUnitRuntimeMBean for the EJB with the specified name.

    Deprecated. As of 11.1.2.0, use getPersistenceUnitRuntime instead

       
    Operation Name"getKodoPersistenceUnitRuntime"
    ParametersObject [] {  unitName }

    where:

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

      unitName

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

    getPersistenceUnitRuntime

    Provides the PersistenceUnitRuntimeMBean for the application with the specified name.

       
    Operation Name"getPersistenceUnitRuntime"
    ParametersObject [] {  unitName }

    where:

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

      unitName

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

    hasApplicationCache

    returns True if the application has an (EJB) Application Level Cache

       
    Operation Name"hasApplicationCache"
    Parametersnull
    Signaturenull
    Returns boolean

    preDeregister

       
    Operation Name"preDeregister"
    Parametersnull
    Signaturenull
    Returns void
    Exceptions
    • java.lang.Exception

    reInitializeApplicationCachesAndPools

    If the application has an (EJB) Application Level Cache then this method will reinitialize the cache and any of its associated pools to their startup time states if possible.

       
    Operation Name"reInitializeApplicationCachesAndPools"
    Parametersnull
    Signaturenull
    Returns void