Sun Java System Application Server Platform Edition 8.1 2005Q2 Update 2 Administration Reference

- Previous: L
- Next: O

# M

## mail-resource

Defines a JavaMail (`javax.mail.Session`) resource.

### Superelements

resources

### Subelements

The following table describes subelements for the `mail-resource` element.

Table 1–75 `mail-resource` Subelements

Element | Required | Description
--- | --- | ---
description | zero or one | Contains a text description of this element.
property | zero or more | Specifies a property or a variable.

### Attributes

The following table describes attributes for the `mail-resource` element.

Table 1–76 `mail-resource` Attributes

Attribute | Default | Description
--- | --- | ---
`jndi-name` | none | Specifies the JNDI name for the resource.
`store-protocol` | `imap` | (optional) Specifies the storage protocol service, which connects to a mail server, retrieves messages, and saves messages in folder(s). Allowed values are `imap`, `pop3`, `imaps`, and `pop3s` .
`store-protocol-class` | `com.sun.mail.imap.IMAPStore` | (optional) Specifies the service provider implementation class for storage. Allowed values are:
    com.sun.mail.imap.IMAPStore
    com.sun.mail.pop3.POP3Store
    com.sun.mail.imap.IMAPSSLStore
    com.sun.mail.pop3.POP3SSLStore
`transport-protocol` | `smtp` | (optional) Specifies the transport protocol service, which sends messages. Allowed values are `smtp` and `smtps`.
`transport-protocol-class` | `com.sun.mail.smtp.SMTPTransport` | (optional) Specifies the service provider implementation class for transport. Allowed values are:
    com.sun.mail.smtp.SMTPTransport
    com.sun.mail.smtp.SMTPSSLTransport
`host` | none | The mail server host name.
`user` | none | The mail server user name.
`from` | none | The email address the mail server uses to indicate the message sender.
`debug` | `false` | (optional) Determines whether debugging for this resource is enabled.
`object-type` | `user` | (optional) Defines the type of the resource. Allowed values are: `system-all` - A system resource for all server instances and the domain application server. `system-admin` - A system resource only for the domain application server. `system-instance` - A system resource for all server instances only. `user` - A user resource.
`enabled` | `true` | (optional) Determines whether this resource is enabled at runtime.

### Properties

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");

## manager-properties

Specifies session manager properties.

### Superelements

session-manager

### Subelements

The following table describes subelements for the `manager-properties` element.

Table 1–77 `manager-properties` Subelements

Element | Required | Description
--- | --- | ---
property | zero or more | Specifies a property or a variable.

### Attributes

The following table describes attributes for the `manager-properties` element.

Table 1–78 `manager-properties` Attributes

Attribute | Default | Description
--- | --- | ---
`session-file-name` | 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.
`reap-interval-in-seconds` | `60` | (optional) Specifies the time between checks for expired sessions. 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.
`max-sessions` | `-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.
`session-id-generator-classname` | internal class generator | (optional) Specifies the name of the class that generates session IDs.

## mdb-container

Configures the message-driven bean (MDB) container.

### Superelements

config

### Subelements

The following table describes subelements for the `mdb-container` element.

Table 1–79 `mdb-container` Subelements

Element | Required | Description
--- | --- | ---
property | zero or more | Specifies a property or a variable.

### Attributes

The following table describes attributes for the `mdb-container` element.

Table 1–80 `mdb-container` Attributes

Attribute | Default | Description
--- | --- | ---
`steady-pool-size` | `10` | (optional) Specifies the initial and minimum number of beans maintained in the pool.
`pool-resize-quantity` | `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` .
`max-pool-size` | `60` | (optional) Specifies the maximum number of beans that can be created to satisfy client requests.
`idle-timeout-in-seconds` | `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.

### Properties

The following table describes properties for the `mdb-container` element.

Table 1–81 `mdb-container` Properties

Property | Default | Description
--- | --- | ---
`cmt-max-runtime-exceptions` | `1` | Specifies the maximum number of `RuntimeException` occurrences allowed from a message-driven bean’s `onMessage()` method when container-managed transactions are used. Deprecated.

## message-security-config

Specifies configurations for message security providers.

### Superelements

security-service

### Subelements

The following table describes subelements for the `message-security-config` element.

Table 1–82 `message-security-config` Subelements

Element | Required | Description
--- | --- | ---
provider-config | one or more | Specifies a configuration for one message security provider.

### Attributes

The following table describes attributes for the `message-security-config` element.

Table 1–83 `message-security-config` Attributes

Attribute | Default | Description
--- | --- | ---
`auth-layer` | none | Specifies the message layer at which authentication is performed. The value must be `SOAP`.
`default-provider` | none | (optional) Specifies the server provider that is invoked for any application not bound to a specific server provider.
`default-client-provider` | none | (optional) Specifies the client provider that is invoked for any application not bound to a specific client provider.

## module-log-levels

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.

### Superelements

log-service

### Subelements

The following table describes subelements for the `module-log-levels` element.

Table 1–84 `module-log-levels` Subelements

Element | Required | Description
--- | --- | ---
property | zero or more | Specifies a property or a variable.

### Attributes

The following table describes attributes for the `module-log-levels` element.

Table 1–85 `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.

## module-monitoring-levels

Controls the level of monitoring of server subsystems. Allowed values of each subsystem attribute are `LOW`, `HIGH``,` and `OFF`.

### Superelements

monitoring-service

### Subelements

The following table describes subelements for the `module-monitoring-levels` element.

Table 1–86 `module-monitoring-levels` Subelements

Element | Required | Description
--- | --- | ---
property | zero or more | Specifies a property or a variable.

### Attributes

Table 1–87 `module-monitoring-levels` Attributes

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.

## monitoring-service

Configures the monitoring service.

### Superelements

config

### Subelements

The following table describes subelements for the `monitoring-service` element.

Table 1–88 `monitoring-service` Subelements

Element | Required | Description
--- | --- | ---
module-monitoring-levels | zero or one | Controls the level of monitoring of server subsystems.
property | zero or more | Specifies a property or a variable.

- Previous: L
- Next: O

- © 2010, Oracle Corporation and/or its affiliates