Breadcrumbs

Defining the Components

Having defined the composite artifact (for instance ActiveMQ_SimpleStatSendListen), define a front end SOAP service and the Java Virtual Machine (JVM), that are both resident of the composite.

JMSComponents01.png

Click New to insert a SOAP service definition.

JMSComponents02.png

Select E2ESOAPService from the drop-down box and click OK.

JMSComponents03.png

Assign a name (e.g. JMSClientService Artifact) and a port number.

Click OK.

JMSComponents04.png

Click New once again to add the Java VM.

JMSComponents05.png

Select JavaVirtualMachine from the drop-down box and click OK.

JMSComponents06.png

You may assign a divergent name to the Java VM or just leave it like it is.

Click OK.

JMSComponents07.png

The component Wizard created the JVM artifact and displays it in the right pane.

Click Next to proceed.

After having created an artifact of the JMS client port type definition, navigate to the artifact of the JavaVirtualMachine in the tree panel of the wizard (or click Next two times) to specify the JMS service.

JMSComponents08.png

The component wizard lists all JMS service templates (among others).

Select a template of the JMS service of your choice (e.g. ActiveMQ-5.5.0_Template) and click > to create an artifact.

JMSComponents09.png

Click OK.

JMSComponents10.png

Click Next.

JMSComponents11.png

Select the JMS Listener you defined in your model and click > to create an artifact.

JMSComponents12.png

Assign a name or leave the name suggested.

Click OK.

JMSComponents15.png

Navigate to the backend node in the tree panel of the wizard (or click Next multiple times until you get there).

Select the JMS provider template of your choice (e.g. ActiveMQProvider Template) and click > to create an artifact.

JMSComponents16.png

The default values of the parameters correspond to a default installation of the JMS Provider.

Adjust the settings according to your installation.

Click OK.

JMSComponents17.png

Alternatively, click New to define a new JMS Provider (e.g. JNDI Provider).

JMSComponents18.png

Not using a template, you have to administer the settings manually.

JMSComponents19.png

Click Next.

JMSComponents20.png

At this level, Click New to define a JMS destination interface component and artifact.

JMSComponents21.png

Assign a name and click OK.

JMSComponents23.png

In the tree panel. navigate to dependencies node of the Java Virtual Machine (or click Next multiple times).

Select the JMS destination and click > to create a dependency from the Java Virtual Machine to the JMS destination.

JMSComponents24.png

If you have not defined an alias yet, click New to define one.

Otherwise, select the appropriate alias.

JMSComponents25.png

Assign a name an click OK.

JMSComponents26.png

Now supply the parameters the JMS Provider needs to feed the listener.

In field Options specify the topic the listener should listen to, in the way <JMSDestination>.topic =<topicName>.

In field User supply the <user>/<password> of the JMS service.

If the JMS client does not listen to all messages of the specified topic, you may enter a Selector, too

In the finished component diagram, all these definitions may also be changed directly on the JMS Dependency. The list of options depends on the JMS provider's requirements.

For a detailed description of the JMS message header fields and parameters refer to JMS Message Header Fields and JMS Parameters in Detail.

If the JMS service communicates with the message queue dynamically, there is no need to specify the JMS dependency parameters. However, they may be created for documentation purposes

 

JMSComponents27.png

Click Skip as there is no need to make further definitions and finish the component wizard.