Object Overview

This object enables an ORMQProvider to service ORMQ clients connecting via local shared memory streams. It is useful for allowing ORMQ clients to access an ORMQProvider running on the same physical host and process / memory space. Memory stream listeners cannot accept connections from remote ORMQ clients, or clients running within a different memory / process space (another AlchemyPoint Server instance).

A single Provider may utilize multiple Listeners, allowing for simultaneous communication over several transports (Sockets, interprocess pipes, and shared memory streams). Multiple Listeners of each type may also be defined (allowing for binding to several IPs/ports, pipes, and shared memory streams).

Example Object Definitions

... directly within the an ORMQProvider object:

Minimal Configuration:

<ORMQMemListener name="ORMQListener1"
                 portNum="4005"/>

Overview:

An ORMQ listener object named "ORMQListener1" listening for client connections on the local shared memory stream port "4005".

Complex Configuration (all possible attributes shown):

<ORMQMemListener name="ORMQListener1" tags="ormq listener"
                 description="example ORMQ shared memory stream connection listener"
                 portNum="4005"/>

Overview:

An ORMQ listener object named "ORMQListener1" listening for client connections on the local shared memory stream port "4005".

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:

• portNum - (usage: required): A numeric value indicating the local shared memory stream port to utilize for accepting ORMQ memory connections.

Supported Child Configuration Elements

None.