This is the schema for the JMS resources descriptor.
Use it to deploy JMS resources (connection factories and/or destinations). The JMS resources can be deployed either as part of an application or standalone.
The jms-resources.xsd has the following structure:
XML Schema Description
Schema Element / Attribute |
Description |
jms-resources |
The root element of the XML schema. |
application-name |
Use this name if you want to deploy the jms-resources.xml as a standalone application via the Telnet command DEPLOY_JMS_RESOURCE from the JMSCONNECTOR group. If the jms-resources.xml is part of an EAR archive, then this name is ignored. Used in: jms-resources. |
connection-factory |
Defines the type of connection factory to use for the resources. The connection factory defines the JMS Connection Factory Object which can be later on used by the application. You can choose between the following types: ● sap-local-factory-type ● context-factory-type ● object-factory-type ● sjo-factory-type Here you declare only a proxy to the real object. Used in: jms-resources. Contains: name, sap-local-factory-type, alias, property, description, client-id. |
name |
The connection factory name. Later on, this name if used in JNDI lookups. For example, if the name is My_Connection_Factory, then you look it up using java:comp/env/My_Connection_Factory. Used in: connection-factory. |
sap-local-factory-type |
This is the SAP JMS Provider vendor-specific connection factory type. We recommend that you use this connection factory type. Used in: connection-factory. Contains: type, virtual-provider, name, user-name, property. |
type |
This is a switch that allows you to choose between the following types of connection factories: ● javax.jms.ConnectionFactory ● javax.jms.TopicConnectionFactory ● javax.jms.QueueConnectionFactory ● javax.jms.XAQueueConnectionFactory ● javax.jms.XATopicConnectionFactory ● javax.jms.XAConnectionFactory Used in: sap-local-factory-type. |
virtual-provider |
The name of the JMS Virtual Provider (VP). If there is no such Virtual Provider, it is automatically created. If it is omitted, the default Virtual Provider is used. Used in: sap-local-factory-type. |
name |
This is the name of the physical connection factory (the one created in the SAP JMS Provider). This element is optional. If you do not specify it, the name of the proxy factory is used. Used in: sap-local-factory-type. |
user-name |
A user name which is used when you create a connection from this connection factory with the createConnection() method. Used in: sap-local-factory-type. |
password |
This is the password that you use when you create a connection from this connection factory with the createConnection() method. It is used only if the <user-name> element is specified. Used in: sap-local-factory-type. |
property |
Additional properties that you can use with the JMS provider. More information about the JMS provider specific properties: Creating and Configuring JMS Resources and Resource References. Used in: context-factory-type, object-factory-type, sap-local-factory-type, destination, jms-resources, connection-factory, sap-local-destination-type Contains: description, config-property-name, config-property-value |
description |
Description of the additional property. Used in: property |
config-property-name |
Name of the additional property. Used in: property |
config-property-value |
Value of the additional property. Used in: property |
context-factory-type |
Defines a connection factory which will be acquired by JNDI lookup. Used in: connection-factory |
initial-context-properties |
The initial context properties. Used in: context-factory-type |
initial-context-factory |
The class name of the javax.naming.spi.InitialContextFactory implementation. Used in: initial-context-properties |
provider-url |
The URL for naming of the provider. If the provider is SAP, you do not have to use this tag. Used in: initial-context-properties |
security-principal |
The user for the naming of the JMS Provider. Used in: initial-context-properties |
security-credentials |
The password for the naming provider URL. Used in: initial-context-properties. |
link-factory-name |
JNDI name of the physical connection factory. You should use the fully qualified name. For SAP JMS Provider it is jmsfactory/<virtualProviderName>/<factoryName>. Used in: context-factory-type |
user-name |
A user name which is used when you create a connection from this connection factory with the createConnection() method. Used in: context-factory-type, object-factory-type, sjo-factory-type, external-destination-type |
password |
This is the password that you use when you create a connection from this connection factory with the createConnection() method. It is used only if the <user-name> element is specified. Used in: context-factory-type, object-factory-type, sjo-factory-type, external-destination-type |
library-name |
The name of a Java EE library. The client JAR file must be deployed on the AS Java as a library. Used in: context-factory-type, object-factory-type, sjo-factory-type, sjo-destination-type |
object-factory-type |
The object connection factory type. Used in: connection-factrory |
object-factory-name |
The fully qualified class name of the javax.naming.spi.InitialContextFactory implementation. Used in: object-factory-type |
class-name |
The fully qualified class name of the object that you want to create. This is the class name of the connection factory. Used in: object-factory-type |
sjo-factory-type |
The Serialized Java Object’s connection factory type. Used in: connection-factory |
sjo-file-name |
The full path to the file with Serialized Java Object. Used in: sjo-factory-type |
alias |
An additional name that can be used as an alias of the connection factory. Used in: connection-factory. |
client-id |
The client ID for the connection factory. Used in: connection-factory. |
description |
Description of the connection factory. Used in: connection-factory. |
destination |
Information about the JMS destination(s) that you want to create. A proxy object to a physical connection is created. If used with sap-local-destination-type, then a new destination is created, otherwise the physical destination should be already created in the JMS Provider. Used in: jms-resources. Contains: name, type, sap-local-destination-type, property, description. |
name |
The name that will be used by the application to refer to the destination. Later on, this name is used in JNDI lookups. For example, if the name is My_Connection_Factory, then you look it up using java:comp/env/My_Connection_Factory. Used in: destination. |
type |
The type of the destination. You can choose between: ● sap-local-destination-type. ● external-destination-type. ● sjo-destination-type. Used in: destination. |
sap-local-destination-type |
We recommend that you use this destination type. This is the SAP destination type. Used in: connection-factory. Contains: type, virtual-provider, name, user-name, property. |
virtual-provider |
The JMS Virtual Provider (VP) of the destination. It must be the same as the one defined in the <sap-local-factory-type>. Used in: sap-local-destination-type. |
name |
This is the name of the physical connection factory (the one created in the SAP JMS Provider). This element is optional. If you do not specify it, the name of the proxy factory is used. Used in: sap-local-destination-type. |
external-destination-type |
Used if you have an external destination. Used in: destination |
link-connection-factory |
The name of the connection factory that is used to acquire this destination. The destination is acquired via javax.jms.Session.create(Queue/Topic) methods from the JMS API. Used in: external-destination-type |
link-destination |
This is the name of the physical destination. If you do not specify it, the proxy destination name is used. Used in: external-destination-type. |
sjo-destination-type |
The Serialized Java Object’s destination type. Used in: destination |
sjo-file-name |
The fully qualified name of the Serialized Java Object class. Used in: sjo-destination-type |
description |
A description of the destination. Used in: destination. |