This is a partial XML Schema Definition for common naming elements for resolving EJB, Web, services, or resource references. This schema will never be used directly but its elements are used in geronimo-application-client-2.0.xsd, geronimo-connector-1.2.xsd, geronimo-web-2.0.xsd, geronimo-tomcat-2.0.xsd, and geronimo-jetty-2.0.xsd. All the schema's or plans using elements of this schema must specify the top level element with one of the namespace specified as "http://geronimo.apache.org/xml/ns/j2ee/naming-1.2". The default location for this document is http://geronimo.apache.org/schemas-1.2/geronimo-naming-1.2.xsd. Import Geronimo Services deployment plans, the imported plan includes complex types like moduleType, environmentType, dependenciesType, etc. required by this plan schema. The element ejb-ref is used to map EJB references to EJB's in other applications using remote home and remote interface. The application which contains the EJB being referenced should either be in same EAR or should be included in dependency list of this application. Also note as the EJB's referenced are in a different JVM all the Client interfaces should also be included in current application. The element ejb-local-ref is used to map EJB references to EJB's in other applications using local home and local interface. The application which contains the EJB being referenced should either be in same EAR or should be included in dependency list of this application. Also note as the EJB's referenced are in a different JVM all the Client interfaces should also be included in current application. The element service-ref is used to map service references to service's in other applications. The application which contains the EJB being referenced should either be in same EAR or should be included in dependency list of this application. The element resource-ref is used to map resource references to resources's like JDBC resources, JMS resources, etc. configured outside the current application. The element resource-env-ref is used to map resource references to administrative objects deployed as a part of connectors. The element message-destination is used to configure a JMS queue or topic which act like a destination for the messages delivered. This group keeps the usage of the contained JNDI environment reference elements consistent across J2EE deployment descriptors. The element ejb-ref is used to map EJB references to EJB's in other applications using remote home and remote interface. The application which contains the EJB being referenced should either be in same EAR or should be included in dependency list of this application. Also note as the EJB's referenced are in a different JVM all the Client interfaces should also be included in current application. The element ejb-local-ref is used to map EJB references to EJB's in other applications using local home and local interface. The application which contains the EJB being referenced should either be in same EAR or should be included in dependency list of this application. Also note as the EJB's referenced are in a different JVM all the Client interfaces should also be included in current application. The element service-ref is used to map service references to service's in other applications. The application which contains the EJB being referenced should either be in same EAR or should be included in dependency list of this application. The element resource-ref is used to map resource references to resources's like JDBC resources, JMS resources, etc. configured outside the current application. The element resource-env-ref is used to map resource references to administrative objects deployed as a part of connectors. The element abstract-naming-entry is an abstract element used as a generic element for all the references. The element ref-name is used to identify this remote ejb reference. This name should be unique in a module and will be used by application as a part of JNDI name for the referenced ejb. The JNDI name used will be "java:/comp/env/ref-name. It should map to the "ejb-ref-name" provided in deployment descriptor. The element pattern is used to provide additional selection criterion for remote ejbs if multiple ejbs with same ejb-link exists in EAR or dependency modules. The pattern mapped should result in single remote EJB. Reference to corbaNameGroup defined later in this schema. This group defines the EJB using CORBA as communication protocol. The element ejb-link is used to identify the remote ejb specified in same EAR or dependency modules. This name should match the ejb-name defined in EJB deployment descriptor. If the name is not unique the pattern element will be used to uniquely identify this remote ejb. The element ref-name is used to identify this local ejb reference. This name should be unique in a module and will be used by application to as a part of JNDI name for the referenced ejb. The JNDI name used will be "java:/comp/env/ref-name. It should map to the "ejb-ref-name" provided in deployment descriptor. The element pattern is used to provide additional selection criterion for local ejb's if multiple local ejb's with same ejb-link exists in EAR or dependency modules. The pattern mapped should result in single local EJB. The element ejb-link is used to identify the local ejb specified in same EAR or dependency modules. This name should match the ejb-name defined in EJB deployment descriptor. If the name is not unique the pattern element will be used to uniquely identify this local ejb. The element ref-name is used to identify this resource reference. This name should be unique in a module and will be used by application to as a part of JNDI name for the referenced resource. The JNDI name used will be "java:/comp/env/ref-name. It should map to the "resource-ref-name" provided in deployment descriptor. The element pattern is used to provide additional selection criterion for resources if multiple resources with same resource-link or URI exists dependency modules. The pattern mapped should result in single resource. The element resource-link is used to identify the JDBC, JMS, or JavaMail resource specified in all the dependency modules. This name should match the connectiondefination-instance/name defined in resource adapter deployment descriptor. If the name is not unique the pattern element will be used to uniquely identify this resource. The element url is used to identify the resources of type java.net.URL deployed in all the dependency modules. If the url doesn't map to unique resource the pattern element will be used to uniquely identify this resource. The element gbean-ref is used to map gbean references to gbeans configured outside the current module. The element ref-name is used to identify this gbean reference. This name should be unique in a module and will be used by application to as a part of JNDI name for the referenced gbean. The JNDI name used will be "java:/comp/env/ref-name. It should map to the "ref-name" provided in deployment descriptor. The element ref-type is used to specify the interface implemented by GBean being referenced. The element pattern is used to provide additional selection criterion for gbeans if multiple gbeans with same name exists in dependency modules. The pattern mapped should result in single gbean. The element persistence-unit-ref is used to map persistence unit references to persistence units configured outside the current module. The element persistence-unit-ref-name is used to identify this persistence unit reference. This name should be unique in a module and will be used by application as a part of JNDI name for the referenced persistence unit. The JNDI name used will be "java:/comp/env/ref-name. It should map to the "ref-name" provided in deployment descriptor. The element persistence-unit-name is used to identify persistence unit specified in any of the dependency modules. This name should match the persistence-unit-name defined in deployment descriptor. If the name is not unique the pattern element will be used to uniquely identify this persistence unit. The element pattern is used to provide additional selection criterion for persistence units if multiple persistence units with same persistence-unit-name exists in dependency modules. The pattern mapped should result in single persistence unit. The element entity-manager-factory-ref is used to map persistence context references to persistence contexts configured outside the current module. The element ref-name is used to identify this persistence context reference. This name should be unique in a module and will be used by application as a part of JNDI name for the referenced persistence context. The JNDI name used will be "java:/comp/env/ref-name. It should map to the "ref-name" provided in deployment descriptor. The element persistence-unit-name is used to identify persistence context specified in any of the dependency modules. This name should match the persistence-unit-name defined in deployment descriptor. If the name is not unique the pattern element will be used to uniquely identify this persistence unit. The element pattern is used to provide additional selection criterion for persistence context's if multiple persistence context's with same persistence-unit-name exists in dependency modules. The pattern mapped should result in single persistence context. The element persistence-context-type is used to provide transaction features if persistence context reference. It can have value of transaction-scoped or extended. The element property is used to provide vendor specific properties for persistence context reference. The element key provides the key identifying this property. The element value provides the value for this property. The element cmp-connection-factory defines the connection pool which will be used by CMP entity beans to connect to datasource. This element will be used by openejb specifications. The element resource-adapter defines the JMS destination which will be used by MDB to connect to destination. This element will be used by openejb specifications. The element pattern is used to provide additional selection criterion for resources if multiple resources with same resource-name exists in dependency modules. The pattern mapped should result in single resource. The element resource-link is used to identify the JDBC, JMS, or JavaMail resource specified in all the dependency modules. This name should match the connectiondefination-instance/name defined in resource adapter deployment descriptor. If the name is not unique the pattern element will be used to uniquely identify this resource. The element url is used to identify the resources of type java.net.URL deployed in all the dependency modules. If the url doesn't map to unique resource the pattern element will be used to uniquely identify this resource. The element ref-name is used to identify this resource reference. This name should be unique in a module and will be used by application as a part of JNDI name for the referenced resource. The JNDI name used will be "java:/comp/env/ref-name. It should map to the "res-ref-name" provided in deployment descriptor. The element pattern is used to provide additional selection criterion for admin object's if multiple admin object's with same admin-object-link exists in dependency modules. The pattern mapped should result in single admin object. This element is deprecated and should not be used. Use admin-object-link instead. That is effectively a renamed version of this. The element admin-object-link is used to identify the admin object resource specified in any of the dependency modules. This name should match the message-definition-name defined in admin object section of deployment descriptor. If the name is not unique the pattern element will be used to uniquely identify this admin object resource. The element message-destination-name is used to identify this message destination reference. This name should be unique in a module and will be used by application to as a part of JNDI name for the message destination. The JNDI name used will be "java:/comp/env/ref-name. It should map to the "message-destination-name" provided in deployment descriptor. The element pattern is used to provide additional selection criterion for JMS destination's if multiple destination's with same admin-object-link exists in dependency modules. The pattern mapped should result in single destination. The element admin-object-link is used to identify the admin object resource specified in any of the dependency modules. This name should match the message-definition-name defined in admin object section of deployment descriptor. If the name is not unique the pattern element will be used to uniquely identify this admin object resource. The element workmanager defines the work manager implementation used by resource adapter. This element will be used by resource adapter plan. The element web-container defines the binding between web application and web container instance. It specifies which container application should be deployed to. The element pattern is used to provide additional selection criterion for gbean's if multiple gbean's with same name exists in dependency modules. The pattern mapped should result in single gbean. The element gbean-link is used to identify the gbean deployed in any of the dependency modules. This name should match the gbean-name defined in deployment plane. If the name is not unique the pattern element will be used to uniquely identify this gbean. The name for group containing module to match. By default is it considered wild card '*'. The name for module in a specified group to be matched. The version number for the module formatted by dot separated numbers. If no version is provided it will be defaulted latest available version matching other criterions. The value specified here should match the file name of the module referenced. The name element to identify the referenced GBean by name. This group contains the protocol, address, and port for a server The protocol element is used to specify the network protocol used for connection. This could be http or https. The host element is used to specify the network host to connect. The port element is used to specify the network port to connect. The port-name element provides the name to identify the port to connect. Reference to serverGroup defined later in this schema. The uri element provides the path to particular resource once connection is established. The credentials-name element provides the credentials name to identify the credentials used for secure connections. The element service-ref-name is used to identify this service reference. This name should be unique in a module and will be used by application to as a part of JNDI name for the web service. The JNDI name used will be "java:/comp/env/ref-name. It should map to the "service-ref-name" provided in service-ref of deployment descriptor. The element service-completion is used to provide missing information for web service. If this element doesn't exist all the information should be available in WSDL. The element port defines the ports available though service reference. If this element doesn't exist the port information should be available in WSDL. The element service-name provides the name of the service missing in service block of WSDL. The element port-completion provides the port information missing in WSDL. The element port provides the port used for web services connection. The element binding-name is used to provide the name for binding for a port and URL. This group contains the location of the CORBA name server, the name, and the client security server used to make interop calls. The corbaloc used to access the CORBA name server. The name of the object in the name server. The element css provides the gbean name to identify the client security service used. The css-link identify the client security service by its name.