Defines a JavaMail (javax.mail.Session) resource.
The following table describes subelements for the mail-resource element.
Table 1–116 mail-resource Subelements
Element |
Required |
Description |
---|---|---|
zero or one |
Contains a text description of this element. |
|
zero or more |
Specifies a property or a variable. |
The following table describes attributes for the mail-resource element.
Table 1–117 mail-resource Attributes
You can set properties for the mail-resource element and then get these properties in a JavaMail Session object later. Every property name must start with a mail- prefix. The Enterprise Server changes the dash (-) character to a period (.) in the name of the property, then saves the property to the MailConfiguration and JavaMail Session objects. If the name of the property doesn’t start with mail-, the property is ignored.
For example, to define the property mail.password in a JavaMail Session object, first edit domain.xml as follows:
... <mail-resource jndi-name="mail/Session" ...> <property name="mail-password" value="adminadmin"/> </mail-resource> ...
After getting the JavaMail Session object, get the mail.password property to retrieve the value adminadmin, as follows:
String password = session.getProperty("mail.password");
For more information about JavaMail properties, see JavaMail API Documentation.
Configures a self-management rule, which associates a custom self-tuning, self-configuring, or self-healing action with an event in the Enterprise Server. The action is implemented by an MBean.
The following table describes subelements for the management-rule element.
Table 1–118 management-rule Subelements
Element |
Required |
Description |
---|---|---|
zero or one |
Contains a text description of this element. This description is included in server log messages about the management rule. For more information on logging, see log-service and module-log-levels. |
|
only one |
Defines the event that triggers the action associated with a management rule. |
|
zero or one |
Specifies the action of this management rule. If no action is specified, occurrence of the associated event is logged. |
The following table describes attributes for the management-rule element.
Table 1–119 management-rule Attributes
Attribute |
Default |
Description |
---|---|---|
name |
none |
Specifies the name of this management rule. |
enabled |
true |
(optional) If false, disables this management rule. |
Configures self-management rules, which associate custom self-tuning, self-configuring, and self-healing actions with events in the Enterprise Server.
The following table describes subelements for the management-rules element.
Table 1–120 management-rules Subelements
Element |
Required |
Description |
---|---|---|
zero or more |
Specifies a management rule. |
The following table describes attributes for the management-rules element.
Table 1–121 management-rules Attributes
Attribute |
Default |
Description |
---|---|---|
enabled |
true |
(optional) If false, disables all management rules. If true, the enabled attribute of each rule determines whether it is enabled. |
Specifies session manager properties.
The following table describes subelements for the manager-properties element.
Table 1–122 manager-properties Subelements
Element |
Required |
Description |
---|---|---|
zero or more |
Specifies a property or a variable. |
The following table describes attributes for the manager-properties element.
Table 1–123 manager-properties Attributes
Attribute |
Default |
Description |
---|---|---|
none; state is not preserved across restarts |
(optional) Specifies the absolute or relative path to the directory in which the session state is preserved between application restarts, if preserving the state is possible. A relative path is relative to the temporary directory for this web application. Applicable to the web container only if the persistence-type attribute of the web-container-availability element is memory. |
|
60 |
(optional) Specifies the time between checks for expired sessions. If the persistence-frequency attribute of the web-container-availability element is set to time-based, active sessions are stored at this interval. Set this value lower than the frequency at which session data changes. For example, this value should be as low as possible (1 second) for a hit counter servlet on a frequently accessed web site, or you could lose the last few hits each time you restart the server. |
|
-1 |
(optional) Specifies the maximum number of sessions that can be in cache, or -1 for no limit. After this, an attempt to create a new session causes an IllegalStateException to be thrown. |
|
internal class generator |
(optional) Not implemented. Use the uuid-impl-class property of the web-container-availability element instead. |
Specifies an MBean, which implements the javax.management.NotificationListener interface.
The following table describes subelements for the mbean element.
Table 1–124 mbean Subelements
Element |
Required |
Description |
---|---|---|
zero or one |
Contains a text description of this element. |
|
zero or more |
Specifies a property. Property subelements of the mbean element store the names and values of attributes defined in the MBean implementation class. |
The following table describes attributes for the mbean element.
Table 1–125 mbean Attributes
Configures the message-driven bean (MDB) container.
The following table describes subelements for the mdb-container element.
Table 1–126 mdb-container Subelements
Element |
Required |
Description |
---|---|---|
zero or more |
Specifies a property or a variable. |
The following table describes attributes for the mdb-container element.
Table 1–127 mdb-container Attributes
Attribute |
Default |
Description |
---|---|---|
10 |
(optional) Specifies the initial and minimum number of beans maintained in the pool. |
|
2 |
(optional) Specifies the number of beans to be removed when the idle-timeout-in-seconds timer expires. A cleaner thread removes any unused instances. Must be 0 or greater and less than max-pool-size . The pool is not resized below the steady-pool-size. |
|
60 |
(optional) Specifies the maximum number of beans that can be created to satisfy client requests. |
|
600 |
(optional) Specifies the maximum time that a bean can remain idle in the pool. After this amount of time, the bean is destroyed. A value of 0 means a bean can remain idle indefinitely. |
The following table describes properties for the mdb-container element.
Table 1–128 mdb-container Properties
Property |
Default |
Description |
---|---|---|
1 |
Specifies the maximum number of RuntimeException occurrences allowed from a message-driven bean’s onMessage() method when container-managed transactions are used. Deprecated. |
Specifies configurations for message security providers.
The following table describes subelements for the message-security-config element.
Table 1–129 message-security-config Subelements
Element |
Required |
Description |
---|---|---|
one or more |
Specifies a configuration for one message security provider. |
The following table describes attributes for the message-security-config element.
Table 1–130 message-security-config Attributes
Attribute |
Default |
Description |
---|---|---|
SOAP |
Specifies the message layer at which authentication is performed. The value must be SOAP or HttpServlet. |
|
none |
(optional) Specifies the server provider that is invoked for any application not bound to a specific server provider. |
|
none |
(optional) Specifies the client provider that is invoked for any application not bound to a specific client provider. |
Controls the level of messages logged by server subsystems to the server log. Allowed values (levels) of each subsystem attribute are, from highest to lowest: FINEST , FINER, FINE, CONFIG, INFO, WARNING, SEVERE, and OFF. Each value logs all messages for all lower values. The default value is INFO, which logs all INFO, SEVERE , and WARNING messages.
The following table describes subelements for the module-log-levels element.
Table 1–131 module-log-levels Subelements
Element |
Required |
Description |
---|---|---|
zero or more |
Specifies a property or a variable. |
The following table describes attributes for the module-log-levels element. The attribute names are the names of the Enterprise Server system loggers.
Table 1–132 module-log-levels Attributes
Attribute |
Default |
Description |
---|---|---|
root |
INFO |
(optional) Specifies the default level of messages logged by the entire Enterprise Server installation. |
server |
INFO |
(optional) Specifies the default level of messages logged by the server instance. |
ejb-container |
INFO |
(optional) Specifies the level of messages logged by the EJB container. |
cmp-container |
INFO |
(optional) Specifies the level of messages logged by the CMP subsystem of the EJB container. |
mdb-container |
INFO |
(optional) Specifies the level of messages logged by the MDB container. |
web-container |
INFO |
(optional) Specifies the level of messages logged by the web container. |
classloader |
INFO |
(optional) Specifies the level of messages logged by the classloader hierarchy. |
configuration |
INFO |
(optional) Specifies the level of messages logged by the configuration subsystem. |
naming |
INFO |
(optional) Specifies the level of messages logged by the naming subsystem. |
security |
INFO |
(optional) Specifies the level of messages logged by the security subsystem. |
jts |
INFO |
(optional) Specifies the level of messages logged by the Java Transaction Service. |
jta |
INFO |
(optional) Specifies the level of messages logged by the Java Transaction API. |
admin |
INFO |
(optional) Specifies the level of messages logged by the Administration Console subsystem. |
deployment |
INFO |
(optional) Specifies the level of messages logged by the deployment subsystem. |
verifier |
INFO |
(optional) Specifies the level of messages logged by the deployment descriptor verifier. |
jaxr |
INFO |
(optional) Specifies the level of messages logged by the XML registry. |
jaxrpc |
INFO |
(optional) Specifies the level of messages logged by the XML RPC module. |
saaj |
INFO |
(optional) Specifies the level of messages logged by the SOAP with Attachments API for Java module. |
corba |
INFO |
(optional) Specifies the level of messages logged by the ORB. |
javamail |
INFO |
(optional) Specifies the level of messages logged by the JavaMail subsystem. |
jms |
INFO |
(optional) Specifies the level of messages logged by the Java Message Service. |
connector |
INFO |
(optional) Specifies the level of messages logged by the connector subsystem. |
jdo |
INFO |
(optional) Specifies the level of messages logged by the Java Data Objects module. |
cmp |
INFO |
(optional) Specifies the level of messages logged by the CMP subsystem. |
util |
INFO |
(optional) Specifies the level of messages logged by the utility subsystem. |
resource-adapter |
INFO |
(optional) Specifies the level of messages logged by the resource adapter subsystem. |
synchronization |
INFO |
(optional) Specifies the level of messages logged by the synchronization subsystem. |
node-agent |
INFO |
(optional) Specifies the level of messages logged by the node agent subsystem. |
self-management |
INFO |
(optional) Specifies the level of messages logged by the self-management (management rules) subsystem. |
group-management-service |
INFO |
(optional) Specifies the level of messages logged by the Group Management Service. |
management-event |
INFO |
(optional) Specifies the level of messages logged by the self-management event subsystem. |
Controls the level of monitoring of server subsystems. Allowed values of each subsystem attribute are LOW, HIGH, and OFF.
The following table describes subelements for the module-monitoring-levels element.
Table 1–133 module-monitoring-levels Subelements
Element |
Required |
Description |
---|---|---|
zero or more |
Specifies a property or a variable. |
Attribute |
Default |
Description |
---|---|---|
thread-pool |
OFF |
(optional) Specifies the level of monitoring of the thread pool subsystem. |
orb |
OFF |
(optional) Specifies the level of monitoring of the ORB. |
ejb-container |
OFF |
(optional) Specifies the level of monitoring of the EJB container. |
web-container |
OFF |
(optional) Specifies the level of monitoring of the web container. |
transaction-service |
OFF |
(optional) Specifies the level of monitoring of the transaction service. |
http-service |
OFF |
(optional) Specifies the level of monitoring of the HTTP service. |
jdbc-connection-pool |
OFF |
(optional) Specifies the level of monitoring of the JDBC connection pool subsystem. |
connector-connection-pool |
OFF |
(optional) Specifies the level of monitoring of the connector connection pool subsystem. |
connector-service |
OFF |
(optional) Specifies the level of monitoring of the connector service. |
jms-service |
OFF |
(optional) Specifies the level of monitoring of the JMS service. |
jvm |
OFF |
(optional) Specifies the level of monitoring of the JVM. |
Configures the monitoring service.
The following table describes subelements for the monitoring-service element.
Table 1–135 monitoring-service Subelements
Element |
Required |
Description |
---|---|---|
zero or one |
Controls the level of monitoring of server subsystems. |
|
zero or more |
Specifies a property or a variable. |