This appendix describes the dotted name attributes that can be used to address the MBean and its attributes. Every element in the domain.xml file has a corresponding MBean. Because the syntax for using these names involves separating names between periods, these names are called dotted names.
A * (asterisk) can be used anywhere in the dotted name and it acts like the wildcard character in regular expressions. The benefit of using a wildcard character is that it can collapse all the parts of the dotted name. For example, a long dotted name like this.is.really.long.hierarchy can be abbreviated to th*.hierarchy. However, the . always delimits parts of the name. An * will get you the entire list of dotted-names.
This appendix contains the following topics:
The following conditions must be adhered to for all top level elements in the domain.xml file:
Each server, configuration, cluster, or node agent must have a unique name.
Servers, configurations, clusters, or node agents cannot be named domain.
Server instances cannot be named agent.
The following table identifies the top level elements and the corresponding dotted name prefix.
Element Name |
Dotted Name Prefix |
---|---|
applications |
domain.applications |
resources |
domain.resources |
configurations |
domain.configs |
servers |
domain.servers Every server contained in this element is accessible as server-name. Where server-name is the value of the name attribute for the server subelement. |
clusters |
domain.clusters Every cluster contained in this element is accessible as cluster-name. Where cluster-name is the value of the name attribute for the cluster subelement. |
node-agents |
domain.node-agents |
lb-configs |
domain.lb-configs |
system-property |
domain.system-property |
Two levels of aliasing are available:
The first level of alias allows access to attributes of server instances or clusters without going through the domain.servers or domain.clusters prefix. So, for example, a dotted name of the form server1 maps to the dotted name domain.servers.server1 (where server1 is a server instance).
The second level of alias is used to refer to configurations, applications, and resources of a cluster or a standalone server instance (target).
The following table identifies dotted names beginning with the server name, or cluster name, that are aliased to top level names under the domain:
Dotted Name |
Aliased to |
Comments |
---|---|---|
target.applications.* |
domain.applications.* |
The alias resolves to applications referenced by the target only. |
target.resources.* |
domain.resources.* |
The alias resolves to all jdbc-connection-pool, connector-connection-pool, resource-adapter-config, and all other resources referenced by the target. |
The following table identifies dotted names beginning with the server name, or cluster name, that are aliased to top level names within the configuration referenced by the server or cluster.
Dotted Name |
Aliased to |
---|---|
target.http-service |
config-name.http-service |
target.iiop-service |
config-name.iiop-service |
target.admin-service |
config-name.admin-service |
target.web-container |
config-name.web-container |
target.ejb-container |
config-name.ejb-container |
target.mdb-container |
config-name.mdb-container |
target.jms-service |
config-name.jms-service |
target.log-service |
config-name.log-service |
target.security-service |
config-name.security-service |
target.transaction-service |
config-name.transaction-service |
target.monitoring-service |
config-name.monitoring-service |
target.java-config |
config-name.java-config |
target.availability-service |
config-name.availability-service |
target.thread-pools |
config-name.thread-pools |
A clustered instance should not be aliased. To get a system property for a clustered instance, the dotted name attribute you should use is as follows: domain.servers.clustered-instance-name.system-property , not clustered-instance-name.system-property.
The asadmin get, set, and list commands work in tandem to provide a navigation mechanism for the Application Server's abstract hierarchy. There are two hierarchies: configuration and monitoring and these commands operate on both. The list command provides the fully qualified dotted names of the management components that have read-only or modifiable attributes.
The configuration hierarchy provides attributes that can be modified; whereas the attributes of management components from monitoring hierarchy are purely read only. The configuration hierarchy is loosely based on the domain's schema document. Use the list command to reach a particular management component in the desired hierarchy. Then, invoke the get and set commands to get the names and values or set the values of the attributes of the management component. Use the wildcard (*) option to fetch all matches in a given fully qualified dotted name. For examples of using the get, set, and list commands, see the following man pages: