blob: 247f3d1e7cb1aaa9e25e7bd6403d0585f7544dff [file] [log] [blame]
<!--
Copyright (c) 1997, 2018 Oracle and/or its affiliates. All rights reserved.
This program and the accompanying materials are made available under the
terms of the Eclipse Public License v. 2.0, which is available at
http://www.eclipse.org/legal/epl-2.0.
This Source Code may also be made available under the following Secondary
Licenses when the conditions for such availability set forth in the
Eclipse Public License v. 2.0 are satisfied: GNU General Public License,
version 2 with the GNU Classpath Exception, which is available at
https://www.gnu.org/software/classpath/license.html.
SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
-->
<!-- The PUBLIC ID (defined in DOCTYPE) associated with this dtd is:
"-//Sun Microsystems, Inc.//DTD Sun ONE Application Server 7.0 Connector 1.0//EN";
-->
<!ENTITY % boolean "(yes | no | on | off | 1 | 0 | true | false)">
<!-- Each deployed Resource Adapter (RAR) Module, will have ias-ra.xml
associated with it, which specifies several dynamic configuration
properties. Key aspects are pool sizing and security role maps.
-->
<!ELEMENT sun-connector (resource-adapter, role-map?)>
<!-- Resource adapter configuration
jndi-name name by which, this adapter will appear in JNDI tree
max-pool-size maximum size of connection to EIS
steady-pool-size initial and minimum number of connections to be maintained
max-wait-in-millis if a connection is not readily found, caller will have to
wait this long, before a connection is created. A value of
0 implies, wait till a connection becomes available. If the
pool is completely utilized and the timer expires, an
exception will be delivered to the application.
idle-timeout-in-seconds A timer thread periodically removed unused connections.
The interval at which this thread runs. All idle
connections will be removed, while mainataining
the configured steady-pool-size.
-->
<!ELEMENT resource-adapter (description?, property*)>
<!ATTLIST resource-adapter jndi-name CDATA #REQUIRED
max-pool-size CDATA "32"
steady-pool-size CDATA "4"
max-wait-time-in-millis CDATA "10000"
idle-timeout-in-seconds CDATA "1000">
<!-- Perform mapping from principal received during Servlet/EJB
authentication, to credentials accepted by the EIS. This
mapping is optional. The map consists of several 2-tuples
map-id is the name of the mapping
-->
<!ELEMENT role-map (description?, map-element*)>
<!ATTLIST role-map map-id CDATA #REQUIRED>
<!-- It is possible to map multiple (server) principal to the
same backend principal.
-->
<!ELEMENT map-element (principal+, backend-principal)>
<!-- Principal of the Servlet and EJB client -->
<!ELEMENT principal (description?)>
<!ATTLIST principal user-name CDATA #REQUIRED>
<!-- Backend EIS principal -->
<!ELEMENT backend-principal EMPTY>
<!ATTLIST backend-principal user-name CDATA #REQUIRED
password CDATA #REQUIRED
credential CDATA #REQUIRED>
<!ELEMENT description (#PCDATA)>
<!-- Syntax for supplying properties as name value pairs -->
<!ELEMENT property EMPTY>
<!ATTLIST property name CDATA #REQUIRED
value CDATA #REQUIRED>