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

- Previous: O
- Next: R

# P

## persistence-manager-factory-resource

Defines a persistence manager factory resource for container-managed persistence (CMP).

### Superelements

resources

### Subelements

The following table describes subelements for the `persistence-manager-factory-resource` element.

Table 1–91 `persistence-manager-factory-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 `persistence-manager-factory-resource` element.

Table 1–92 `persistence-manager-factory-resource` Attributes

Attribute | Default | Description
--- | --- | ---
`jndi-name` | none | Specifies the JNDI name for the resource.
`factory-class` | `com.sun.jdo.spi.persistence.support.sqlstore.impl.PersistenceManagerFactoryImpl` | (optional) Deprecated. Do not specify this attribute for the built-in CMP implementation.
`jdbc-resource-jndi-name` | none | Specifies the jdbc-resource from which database connections are obtained. Must be the `jndi-name` of an existing `jdbc-resource`.
`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.

## principal

Contains the principal of the servlet or EJB client.

### Superelements

security-map

### Subelements

none - contains data

## profiler

Configures a profiler for use with the Application Server. For more information about profilers, see the Sun Java System Application Server Platform Edition 8.1 2005Q2 Update 2 Developer’s Guide.

### Superelements

java-config

### Subelements

The following table describes subelements for the `profiler` element.

Table 1–93 `profiler` Subelements

Element | Required | Description
--- | --- | ---
jvm-options | zero or more | Contains profiler-specific JVM command line options.
property | zero or more | Specifies a property or a variable.

Note –

Subelements of a `profiler` element can occur in any order.

### Attributes

The following table describes attributes for the `profiler` element.

Table 1–94 `profiler` Attributes

Attribute | Default | Description
--- | --- | ---
`name` | none | Specifies the name of the profiler.
`classpath` | none | (optional) Specifies the classpath for the profiler.
`native-library-path` | none | (optional) Specifies the native library path for the profiler.
enabled | `true` | (optional) Determines whether the profiler is enabled.

## property

Specifies a property. A property adds configuration information to its parent element that is one or both of the following:

- Optional with respect to the Application Server

- Needed by a system or object that the Application Server doesn’t have knowledge of, such as an LDAP server or a Java class

  For example, an `auth-realm` element can include `property` subelements:

      <auth-realm name="file"
           classname="com.sun.enterprise.security.auth.realm.file.FileRealm">
           <property name="file" value="domain-dir/config/keyfile"/>
           <property name="jaas-context" value="fileRealm"/>
       </auth-realm>

  Which properties an `auth-realm` element uses depends on the value of the `auth-realm` element’s `name` attribute. The `file` realm uses `file` and `jaas-context` properties. Other realms use different properties.

### Superelements

admin-object-resource, admin-service, alert-service, audit-module, auth-realm, config, connector-connection-pool, connector-resource, custom-resource, das-config, domain, ejb-container, ejb-timer-service, external-jndi-resource, filter-config, http-listener, http-service, iiop-listener, jacc-provider, java-config, jdbc-connection-pool, jdbc-resource, jms-host, jms-service, lifecycle-module, listener-config, log-service, mail-resource, manager-properties, mdb-container, module-log-levels, module-monitoring-levels, monitoring-service, orb, persistence-manager-factory-resource, profiler, provider-config, resource-adapter-config, security-service, server, session-properties, store-properties, transaction-service, virtual-server, web-container

### Subelements

The following table describes subelements for the `property` element.

Table 1–95 `property` Subelements

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

### Attributes

The following table describes attributes for the `property` element.

Table 1–96 `property` Attributes

Attribute | Default | Description
--- | --- | ---
`name` | none | Specifies the name of the property or variable.
`value` | none | Specifies the value of the property or variable.

## provider-config

Specifies a configuration for one message security provider.

Although the `request-policy` and `response-policy` subelements are optional, the `provider-config` element does nothing if they are not specified.

Use property subelements to configure provider-specific properties. Property values are passed to the provider when its `initialize` method is called.

### Superelements

message-security-config

### Subelements

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

Table 1–97 `provider-config` Subelements

Element | Required | Description
--- | --- | ---
request-policy | zero or one | Defines the authentication policy requirements of the authentication provider’s request processing.
response-policy | zero or one | Defines the authentication policy requirements of the authentication provider’s response processing.
property | zero or more | Specifies a property or a variable.

### Attributes

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

Table 1–98 `provider-config` Attributes

Attribute | Default | Description
--- | --- | ---
`provider-id` | none | Specifies the provider ID.
`provider-type` | none | Specifies whether the provider is a `client`, `server` , or `client-server` authentication provider.
`class-name` | none | Specifies the Java implementation class of the provider. Client authentication providers must implement the `com.sun.enterprise.security.jauth.ClientAuthModule` interface. Server authentication providers must implement the `com.sun.enterprise.security.jauth.ServerAuthModule` interface. Client-server providers must implement both interfaces.

- Previous: O
- Next: R

- © 2010, Oracle Corporation and/or its affiliates