T

table-name

Specifies the name of a database table. The table must be present in the database schema file. See Automatic Database Schema Capture in Sun GlassFish Enterprise Server v2.1.1 Developer’s Guide.

Superelements

entity-mapping, secondary-table (sun-cmp-mappings.xml)

Subelements

none - contains data

target-server

Specifies the IIOP listener for the target server. Also specifies IIOP endpoints used for load balancing. If the Enterprise Server instance on which the application client is deployed participates in a cluster, the Enterprise Server finds all currently active IIOP endpoints in the cluster automatically. However, a client should have at least two endpoints specified for bootstrapping purposes, in case one of the endpoints has failed.

A listener or endpoint is in the form host:port, where the host is an IP address or host name, and the port specifies the port number.

Not used if the deprecated endpoints property is defined for load balancing. For more information, see client-container.

---

Note –

Some topics in the documentation pertain to features that are available only in domains that are configured to support clusters. Examples of domains that support clusters are domains that are created with the cluster profile or the enterprise profile. For information about profiles, see Usage Profiles in Sun GlassFish Enterprise Server v2.1.1 Administration Guide.

---

Superelements

client-container (sun-acc.xml)

Subelements

The following table describes subelements for the target-server element.

Table A–127 target-server subelements

Element	Required	Description
description	zero or one	Specifies the description of the target server.
security	zero or one	Specifies the security configuration for the IIOP/SSL communication with the target server.

Attributes

The following table describes attributes for the target-server element.

Table A–128 target-server attributes

Attribute	Default	Description
name	none	Specifies the name of the application server instance accessed by the client container.
address	none	Specifies the host name or IP address (resolvable by DNS) of the server to which this client attaches.
port	none	Specifies the naming service port number of the server to which this client attaches.  For a new server instance, assign a port number other than 3700. You can change the port number in the Admin Console. Click the Help button in the Admin Console for more information.

tie-class

Specifies the automatically generated name of a tie implementation class for a port component.

Superelements

webservice-endpoint (sun-web.xml, sun-ejb-jar.xml)

Subelements

none - contains data

timeout

Specifies the cache-mapping specific maximum amount of time in seconds that an entry can remain in the cache after it is created or refreshed. If not specified, the default is the value of the timeout attribute of the cache element.

Superelements

cache-mapping (sun-web.xml)

Subelements

none - contains data

Attributes

The following table describes attributes for the timeout element.

Table A–129 timeout Attributes

Attribute	Default	Description
name	none	Specifies the timeout input parameter, whose value is interpreted in seconds. The field’s type must be java.lang.Long or java.lang.Integer.
scope	request.attribute	(optional) Specifies the scope from which the input parameter is retrieved. Allowed values are context.attribute, request.header, request.parameter, request.cookie, request.attribute, and session.attribute.

transport-config

Specifies the security transport information.

Superelements

ior-security-config (sun-ejb-jar.xml)

Subelements

The following table describes subelements for the transport-config element.

Table A–130 transport-config Subelements

Element	Required	Description
integrity	only one	Specifies if the target supports integrity-protected messages. The values are NONE, SUPPORTED, or REQUIRED.
confidentiality	only one	Specifies if the target supports privacy-protected messages. The values are NONE, SUPPORTED, or REQUIRED.
establish-trust-in-target	only one	Specifies if the target is capable of authenticating to a client. The values are NONE, SUPPORTED, or REQUIRED.
establish-trust-in-client	only one	Specifies if the target is capable of authenticating a client. The values are NONE, SUPPORTED, or REQUIRED.

transport-guarantee

Specifies that the communication between client and server is NONE, INTEGRAL, or CONFIDENTIAL.

• NONE means the application does not require any transport guarantees.

• INTEGRAL means the application requires that the data sent between client and server be sent in such a way that it can’t be changed in transit.

• CONFIDENTIAL means the application requires that the data be transmitted in a fashion that prevents other entities from observing the contents of the transmission.

In most cases, a value of INTEGRAL or CONFIDENTIAL indicates that the use of SSL is required.

Superelements

webservice-endpoint (sun-web.xml, sun-ejb-jar.xml)

Subelements

none - contains data