Entering content frame

Background documentation JMSCONNECTOR Locate the document in its SAP Library structure

This section describes the commands of the JMS Connector Service. They are added to the shell environment by executing the ADD JMSCONNECTOR on the command line.

DEFINE_JMS_LIBRARY

Syntax

DEFINE_JMS_LIBRARY <libraryNames>

Arguments

 

<libraryNames>

The names of one or more libraries that you want to register as JMS libraries

This graphic is explained in the accompanying text

If you want to enter more than one name, separate the names with an interval only.

Description

Registers an archive deployed as a J2EE Engine library and containing JMS library classes as a JMS library.

 

DEPLOY_DESTINATION

Syntax

DEPLOY_DESTINATION <applicationName> <factoryName> <destinationName> [user] [password]

Arguments

 

<applicationName>

The name of the application to which the JMS destination is associated.

Note

Since you cannot associate a JMS destination to an application that was already deployed, this name is in fact the name of the configuration object where the JMS destination is stored. If an application with this name already exists on the J2EE Engine, the system redeploys it, which causes data loss.

<factoryName>

The name of the used ConnectionFactory

Note

If you enter a non-existant ConnectionFactory name, the system creates but does not initialize the JMS destination. If you additionally deploy a ConnectionFactory with the specified name, the system detects it automatically and initializes the JMS destination.

<destinationName>

The name of the JMS destination that you create.

[user]

A valid username for authentication to the JMS Provider

[password]

A valid password that corresponds to the specified username

Description

Creates a JMS destination object with the specified properties and deploys it on the J2EE Engine.

 

DEPLOY_JMS_LIBRARY

Syntax

DEPLOY_JMS_LIBRARY <libraryName> <jarFiles>

Arguments

 

<libraryName>

An arbitrary name for the JMS library

<jarFiles>

The paths to one or more archive files that contain the classes of the JMS library

Description

Registers a JMS library on the J2EE Engine.

 

DEPLOY_JMS_RESOURCE

Syntax

DEPLOY_JMS_RESOURCE <xmlFiles>

Arguments

 

<xmlFiles>

The paths to one or more XML files describing the resource you want to deploy.

This graphic is explained in the accompanying text

The format of the XML files that describe JMS ConnectionFactory objects is defined by jms-factories.dtd. The format of the XML files that describe JMS Destination objects is defined by jms-destinations.dtd

Description

Deploys a JMS ConnectionFactory and the JMS destination described in the specified XML file(s).

 

UNDEFINE_JMS_LIBRARY

Syntax

UNDEFINE_JMS_LIBRARY <libraryNames>

Arguments

 

<libraryNames>

The names of one or more JMS libraries that you want to unregister.

Description

Removes one or more libraries from the list of registered JMS libraries.

 

UNDEPLOY_JMS_LIBRARY

Syntax

UNDEPLOY_JMS_LIBRARY <libraryNames>

Arguments

 

<libraryNames>

The names of one or more JMS libraries that you want to remove.

Description

Removes a JMS library previously deployed on J2EE Engine.

 

UNDEPLOY_JMS_RESOURCE

Syntax

UNDEPLOY_JMS_RESOURCE <applicationNames>

Arguments

 

<applicationNames>

The names of one or more applications that you want to remove.

Description

Removes the specified applications. If there are JMS resources (ConnectionFactory and Destination) associated to the applications, the command removes them too.

 

 

 

Leaving content frame