The Queue device is a standard Connexion device formerly found on the System toolbar. It accepts messages from another device in the channel and queues them for distribution to devices further downstream in the channel. Messages can be manipulated before or after leaving the Queue device.

While the Queue device does have some configuration options, the display is mostly informational.

Device panel layout

The Queue device panel is divided into three main sections:

From this UI you can access the device toolbar, as well as filter and view messages.

The Queue device toolbar

The Queue device toolbar contains most of the device actions.

• Settings: access all of the settings for the Queue device (see "Using Settings" below)
• Execute Filter: Activate the filters you have set for the list of messages (see "Filtering Messages" below)
• Sort: Click to switch between viewing messages from newest to oldest and vice-versa.
• Enable/disable the message count.
• Use the arrows to browse between pages on of messages on the screen

Filtering messages

You can filter the list of messages by date/time and/or by queue by selecting values from the appropriate drop-down fields. You can also use the text boxes at the top of some of the table columns to filter the list.

To filter using the text boxes:

1. Enter the values you want to filter by in the text boxes as needed.
2. Click Execute Filter.

Previewing messages

At the bottom of the device panel are two fields. The one on the left displays the message as it will be brought into the queue. The field on the right displays the message after any modifications (transforms, etc.). To preview what a message will look like after it leaves the queue, click on it in the list. The Inbound and Outboud messages will be displayed. Compare and make any changes as needed.

Using Settings

Click the Settings button on the toolbar to view all of the settings available for the Queue device.

There are six categories of Queue device settings.

Queue Operations

The following settings are available:

• Empty Sleep time (ms): set the amount of time, in milliseconds, the queue device should sleep when there are no messages present.
• Batch size: the number of messages to process in each batch.
• Max Db update threads: the maximum number of threads to run for database updates.
• Compression Type: how messages should be compressed. You can choose to compress by:
  • Max throughput: compress to maximize the number of messages that pass through the queue
  • Max compression: maximize the degree of message compression, even if this cuts down on message through put.
• Synchronous: check this box if the queue should run in synchronous mode (a message must complete processing before the next message is processed).
• Store message change history: check this box if Connexion should store the change history for messages.
• Store history for messages with errors only: check this box if Connexion should only store change history for messages in the Error status

Throttling

You can choose to throttle message processing in the Queue. Throttling means that a short delay is inserted between each processed message (which would slow down processing time). If you choose to use throttling, set the following options:

• Default throttle (ms): the length of each pause in milliseconds (the typical throttling value is between 1 and 10 milliseconds).
• Schedule Throttling: if you only want to throttle the queue at certain times, check this option. Once checked, specific the following:
  • From and To times: the time during which the queue should be throttled
  • Throttle (ms): during the specified times, if you want to throttle the queue, select this option and specify the delay value in milliseconds
  • Disable queue: during the specified times, if you want to completely disable the queue, select this option

Logging

Use these settings to specify the logging behavior for the queue:

• the number of minutes after which a log entry should be generated if no messages are received
• the number of errors in a day after which a log entry should be generated
• the message age (in minutes) of messages in the queue after which a log entry should be generated

Message retention

This setting sets the number of days a message should be saved in the queue. The default is 90 days.

Display settings

These options control the display of the message list for the Queue. The Queue Page Size is the number of messages that are shown on each page; if the number of messages exceeds this, more pages will be generated. You can browse the pages by using the arrow buttons on the toolbar.

Each available column for display is indicated by a check box. If the box is checked, the column will be display in the message list. To hide a particular column, clear the check box.

External access

The External Access options are used if the queue will receive messages from a remote Connexion system via a Secure Sender device. To receive messages from a remote system:

1. Click the Enable External Queuing option.
2. Click Generate certificate.
3. Copy the certificate text and paste it into the Public Key field on the Secure Sender device.