Defines a JavaMail (javax.mail.Session) resource.
The following table describes subelements for the mail-resource element.
Table 1–97 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–98 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 Application 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");
Specifies session manager properties.
The following table describes subelements for the manager-properties element.
Table 1–99 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–100 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 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. |
Configures the message-driven bean (MDB) container.
The following table describes subelements for the mdb-container element.
Table 1–101 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–102 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 created if a request arrives when the pool is empty (subject to the max-pool-size limit), or the number of beans to remove if idle for more than idle-timeout-in-seconds . |
|
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–103 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–104 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–105 message-security-config Attributes
Attribute |
Default |
Description |
---|---|---|
none |
Specifies the message layer at which authentication is performed. The value must be SOAP. |
|
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 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–106 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.
Table 1–107 module-log-levels Attributes
Attribute |
Default |
Description |
---|---|---|
root |
INFO |
(optional) Specifies the default level of messages logged by the entire Application 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. |
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–108 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–110 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. |