Object Overview

This object defines a persistent connection to a local ORMQ Provider (one running on the same physical host). ORMQ pipe connections are generally utilized to connect to ORMQ Providers running on the same physical host but within different memory / process space.

ORMQDestinations and ORMQSubscriptions may be embedded within this Connection object to both create message queues on the connected Provider, and subscribe to already-created message queues.

Example Object Definitions

... directly within the top-level ServerConfiguration object:

Minimal Configuration:

<ORMQPipeConnection name=""ORMQConnection1"
                    pipeAddress="test-pipe1"
                    username="user123"
                    password="secret123"/>

Overview:

Interprocess communications pipe connection to a locally running ORMQ Provider, using the pipe address "test-pipe1". This object utilizes the login "user123" and password "secret123" when logging into the ORMQ Provider.

Complex Configuration (all possible attributes shown):

<ORMQPipeConnection name=""ORMQConnection1" tags="ORMQ local connection"
                    description="local ORMQ connection via an interprocess pipe"
                    pipeAddress="test-pipe1"
                    username="user123"
                    password="secret123">

   ... ORMQ destinations and subscriptions go here ...

</ORMQPipeConnection>

Overview:

Interprocess communications pipe connection to a locally running ORMQ Provider, using the pipe address "test-pipe1". This object utilizes the login "user123" and password "secret123" when logging into the ORMQ Provider.

Supported Attributes

General Attributes:

• name - (usage: required): Public name of the configuration object. This name must be globally-unique across the entire AlchemyPoint ServerConfiguration definition.

• description - (usage: optional): Textual description of the configuration object.

• tags - (usage: optional): Space-delimited list of one or more tags used to describe the configuration object.

Object Attributes:

• pipeAddress - (usage: required): The name of a local interprocess communications pipe that should be utilized to communicate with the ORMQ Provider.

• username - (usage: required): The username to utilize when logging into the ORMQ Provider.

• password - (usage: required): The password to utilize when logging into the ORMQ Provider.

Supported Child Configuration Elements

ORMQ:

• ORMQDestination - A named queue residing on the connected ORMQProvider. These queues may be written to (via a DispatcherSource? , InputConnector or any of the ProtocolListeners), or subscribed to. ORMQ queues support a variety of delivery and reliability options, to operate successfully in a variety of messaging scenarios.

• ORMQSubscription - Subscription to an ORMQDestination queue on the connected ORMQProvider. Bindings may be embedded within ORMQ subscriptions to specify actions, transformations, and triggers that should be utilized on received ORMQ messages.

Connector Facades:

• ORMQInputConnector - Accesses named queue destinations on an ORMQ Provider in a polling fashion, checking for new messages on a regular interval. This object differs from an ORMQSubscription in that messages are only retrieved from the queue on an interval, versus being processed as soon as they are available.

• ORMQOutputConnector - Posts messages to an ORMQ named queue destination using rate limiting and pipelining. This object is useful when it is necessary to limit the speed at which messages are posted to an ORMQ queue, as ORMQDestination does not inherently support any sort of rate / message limiting capabilities.