Cumin Help

Main - Broker - Queue

Bind a Queue to an Exchange

Allows an existing queue to bind to an existing exchange. Select one or more exchanges from the list and enter the exchange key and other required information. Each exchange type has different required information.

  • A "direct" exchange uses the queue name as the binding key so no input is required.
  • A "fanout" exchange does not require a binding key
  • A "topic" exchange requires a binding key
  • A "xml" exchange reqires a binding key and an XQuery. Selecting an "xml" exchange displays an XQuery input box.
  • A "headers" exchange requires:
    • a binding key
    • an x-match type of "all" or "any"
    • zero or more match keys. If a match key is entered, an optional type, value can be entered.
    Selecting a "headers" exchange displays the additional inputs.

The exchanges listed default to all available exchanges. To view only "Active" exchanges, select the Active option above the list.

Adding a new Queue

Allows the creation of a new queue and optionally allows binding to an existing exchange. A new queue requires a name and has several attributes:

  • Durable Will the queue survive if the broker becomes unavailable.
  • Exclusive
  • Auto Delete

Optionally, a queue can be bound to one or more exchanges. Select an exchange from the list and enter the exchange key and other required information. Each exchange type has different required information.

  • A "direct" exchange uses the queue name as the binding key so no input is required.
  • A "fanout" exchange does not require a binding key
  • A "topic" exchange requires a binding key
  • A "xml" exchange reqires a binding key and an XQuery. Selecting an "xml" exchange displays an XQuery input box.
  • A "headers" exchange requires:
    • a binding key
    • an x-match type of "all" or "any"
    • zero or more match keys. If a match key is entered, an optional type, value can be entered.
    Selecting a "headers" exchange displays the additional inputs.

The exchanges listed default to all available exchanges. To view only "Active" exchanges, select the Active option above the list.

Adding a new Exchange

Allows the creation of a new exchange. An exchange name is required. Choose one of the exchange types listed.

Adding a Broker Link

Allows the creation of a new link between brokers. An broker address is required. It can be an IP address or a host name. A port, username and password are optional. If a port is entered, it must be a numeric value.

A durable link survives after a broker is restarted.

Closing a Broker Link

Closes the links between the current broker and all selected brokers. If a linked broker has link routes (also known as bridges), they will be abandoned.

Adding a Route to a Broker Link

Adds a Route to an existing Broker Link. Messages are exchanged with a linked broker based on Routes. A Route requires an exchange and a routing key.

Optionally, a tag and exclude list can be supplied.

Remove a Link Route

Closes and deletes a route between the current broker and a linked broker.

Edit Job Attributes

There are three types of job attributes that can be edited:

Boolean
Choose between and .
Number
Enter any numeric value. Numeric fields are surround by a dashed blue box.

If a non-numeric value is entered in a numeric field, the surrounding box changes to red dashes and an error message is displayed.

A blank value in a numeric field is considered an error.

Text
Enter any sequence of numbers or characters.
Text fields are surround by a light grey box.

If the initial value of a text field is longer than forty characters, a larger input box is provided.

Job Actions

The following actions can be performed on a job:

Hold
Prevent the job from running until it is manually released.
Release
Release a job from the Held state.
Remove
Mark the job as removed. Removed jobs will not run. Removed jobs are only viewable by selecting the button on the jobs page.

When any of these actions are performed on a job group, the action is performed on all the jobs in the group.

Edit Concurrency Limits

Change the maximum number of jobs that can be run concurrently using a limiter.

A Limiter is a resource that must be allocated to a job before the job can run.