Configure ActiveMQ Artemis

Use the service port type ActiveMQ Artemis to connect to ActiveMQ Artemis queues or topics and to push and pull messages.

For detailed information on ActiveMQ Artemis, see the ActiveMQ Artemis documentation.

Configure your service port

Once you have created your service port, you can configure the general service port details:

Attribute

Description

General - Name

Enter the name of the service port.

General - Type

Select your service port technology.

Read / Write / Read & Write

Select what your service port should do with messages:

  • Read messages.

  • Write messages.

  • Read & Write messages.

Real Service

Select if you want to connect to a real service.

Forwarding

Allow OSV to forward requests to the real service. To use this option, you need to select Real Service.

Learning

Allow OSV to store forwarded messages in the Recorder tab. To use this option, you need to enable Forwarding.

Active

Select if you want your service port to be active, deselect to set it to inactive.

To connect to ActiveMQ Artemis, specify the following attributes:

Attribute

Description

Type

Select Queue or Topic.

What you select depends on how you push and pull your messages with ActiveMQ Artemis. Queues represent a one-to-one messaging pattern, topics allow one-to-many messaging.

Name

Enter the name of the queue or topic you want to connect to.

Host

Enter the name or IP address of the workstation that hosts ActiveMQ Artemis.

Username

If your connection requires authentication, enter your user name.

Password

If your connection requires authentication, enter your password.

MessageType

Specify what type of message you want to send and receive: JmsTextMessage or JmsBytesMessage.

Selector

Define a selector to filter the headers and properties of incoming JMS messages.

This enables you to receive only JMS messages that match your filter criteria. For detailed information on the predefined selectors for this technology, see the ActiveMQ Artemis documentation.

Port

Specify the port to listen to.

Unprocessable Messages

Define how to handle messages in a queue that a client can no longer process:

  • Delete the message.

  • Keep the message for processing by another client.

This applies only to queues, not to topics.

ActiveMQ Artemis service port

To save your changes, click Apply. To discard your changes, click Reset.

Once you have configured your service port, you can use your ActiveMQ Artemis connection for testing. For information on how to edit JMS messages for your OSV Scenarios, see chapter "Edit JMS messages".