TAO_CosNotification: CosNotification Namespace Reference


Classes
struct	Property
	Define a name/value pair. More...
struct	_EventType
	Define event type names. More...
struct	PropertyRange
	A structure to define property ranges. More...
struct	NamedPropertyRange
	A named property range. More...
struct	PropertyError
	Describe the problems detected with an application requested QoS. More...
exception	UnsupportedQoS
	Exception used to describe problems with one or more QoS requests. More...
exception	UnsupportedAdmin
	Exception used to describe problems with one or more Admin properties. More...
struct	FixedEventHeader
	Define the 'fixed' part of the event header. More...
struct	EventHeader
	Complete event header. More...
struct	StructuredEvent
	Define structured events. More...
interface	QoSAdmin
	Interface used to control the QoS properties of an Event Service components (Channel, Proxy, etc.). More...
interface	AdminPropertiesAdmin
	Define the interface to manipulate the Admin properties of a Notification Service components. More...
Different kinds of property sequences
The following are all sequences of Property, but serve different purposes.
typedef PropertySeq	OptionalHeaderFields
	Property sequence used for optional header fields.
typedef PropertySeq	FilterableEventBody
typedef PropertySeq	QoSProperties
	Specify quality of service properties.
typedef PropertySeq	AdminProperties
	Specify administrative properties.
Constants for QoS Properties
The following constant declarations define the standard QoS property names and the associated values each property can take on. The name/value pairs for each standard property are grouped, beginning with a string constant defined for the property name, followed by the values the property can take on.
const string	EventReliability = "EventReliability"
const short	BestEffort = 0
const short	Persistent = 1
const string	ConnectionReliability = "ConnectionReliability"
	Can take on the same values as EventReliability.
const string	Priority = "Priority"
const short	LowestPriority = -32767
const short	HighestPriority = 32767
const short	DefaultPriority = 0
const string	StartTime = "StartTime"
	StartTime takes a value of type TimeBase::UtcT.
const string	StopTime = "StopTime"
	StopTime takes a value of type TimeBase::UtcT.
const string	Timeout = "Timeout"
	Timeout takes on a value of type TimeBase::TimeT.
const string	OrderPolicy = "OrderPolicy"
const short	AnyOrder = 0
const short	FifoOrder = 1
const short	PriorityOrder = 2
const short	DeadlineOrder = 3
const string	DiscardPolicy = "DiscardPolicy"
	DiscardPolicy takes on the same values as OrderPolicy, plus.
const short	LifoOrder = 4
const string	MaximumBatchSize = "MaximumBatchSize"
	MaximumBatchSize takes on a value of type long.
const string	PacingInterval = "PacingInterval"
	PacingInterval takes on a value of type TimeBase::TimeT.
const string	StartTimeSupported = "StartTimeSupported"
	StartTimeSupported takes on a boolean value.
const string	StopTimeSupported = "StopTimeSupported"
	StopTimeSupported takes on a boolean value.
const string	MaxEventsPerConsumer = "MaxEventsPerConsumer"
	MaxEventsPerConsumer takes on a value of type long.
Constants for Admin Properties
Admin properties are defined in similar manner as QoS properties. The only difference is that these properties are related to channel administration policies, as opposed message quality of service
const string	MaxQueueLength = "MaxQueueLength"
	MaxQueueLength takes on a value of type long.
const string	MaxConsumers = "MaxConsumers"
	MaxConsumers takes on a value of type long.
const string	MaxSuppliers = "MaxSuppliers"
	MaxSuppliers takes on a value of type long.
const string	RejectNewEvents = "RejectNewEvents"
	RejectNewEvents takes on a value of type Boolean.
Typedefs
typedef string	Istring
typedef Istring	PropertyName
	Properties are named using a string.
typedef any	PropertyValue
	Property values are stored using anys.
typedef sequence< Property >	PropertySeq
	Define a sequence of properties.
typedef sequence< _EventType >	EventTypeSeq
	A sequence of event types.
typedef sequence< NamedPropertyRange >	NamedPropertyRangeSeq
	A sequence of named property ranges.
typedef sequence< PropertyError >	PropertyErrorSeq
	List of property errors.
typedef sequence< StructuredEvent >	EventBatch
	Sequence of events, for batch processing.
Enumerations
enum	QoSError_code { UNSUPPORTED_PROPERTY, UNAVAILABLE_PROPERTY, UNSUPPORTED_VALUE, UNAVAILABLE_VALUE, BAD_PROPERTY, BAD_TYPE, BAD_VALUE }
	Describe QoS errors. More...

Detailed Description

Typedef Documentation

typedef string CosNotification::Istring

Dummy typedef for strings, if the intent was to support I18N strings the spec should have used wstring

Definition at line 26 of file CosNotification.idl.

typedef Istring CosNotification::PropertyName

Properties are named using a string.

Definition at line 29 of file CosNotification.idl.

typedef any CosNotification::PropertyValue

Property values are stored using anys.

Definition at line 32 of file CosNotification.idl.

typedef sequence<Property> CosNotification::PropertySeq

Define a sequence of properties.

Definition at line 50 of file CosNotification.idl.

typedef PropertySeq CosNotification::OptionalHeaderFields

Property sequence used for optional header fields.

Definition at line 60 of file CosNotification.idl.

typedef PropertySeq CosNotification::FilterableEventBody

Property sequence used for the event body that can be used in filtering

Definition at line 64 of file CosNotification.idl.

typedef PropertySeq CosNotification::QoSProperties

Specify quality of service properties.

Definition at line 67 of file CosNotification.idl.

typedef PropertySeq CosNotification::AdminProperties

Specify administrative properties.

Definition at line 70 of file CosNotification.idl.

typedef sequence<_EventType> CosNotification::EventTypeSeq

A sequence of event types.

Definition at line 88 of file CosNotification.idl.

typedef sequence<NamedPropertyRange> CosNotification::NamedPropertyRangeSeq

A sequence of named property ranges.

Definition at line 115 of file CosNotification.idl.

typedef sequence<PropertyError> CosNotification::PropertyErrorSeq

List of property errors.

Definition at line 162 of file CosNotification.idl.

typedef sequence<StructuredEvent> CosNotification::EventBatch

Sequence of events, for batch processing.

Definition at line 225 of file CosNotification.idl.

Enumeration Type Documentation

enum CosNotification::QoSError_code

Describe QoS errors.

Enumerator:

UNSUPPORTED_PROPERTY	The application has requested an unsupported QoS property.
UNAVAILABLE_PROPERTY	The application has requested a QoS property that, though supported, cannot be set in the requested scope.
UNSUPPORTED_VALUE	The application has requested a QoS property with an unsupported value.
UNAVAILABLE_VALUE	The application has requested a QoS property with a supported value, but unavailable at the requeste scope.
BAD_PROPERTY	The property name is unknown or not recognized.
BAD_TYPE	The value type for the requested property is invalid.
BAD_VALUE	The value for the requested property is illegal.

Definition at line 122 of file CosNotification.idl.

00122                      {
00123     /// The application has requested an unsupported QoS property
00124     UNSUPPORTED_PROPERTY,
00125     /// The application has requested a QoS property that, though
00126     /// supported, cannot be set in the requested scope.
00127     UNAVAILABLE_PROPERTY,
00128     /// The application has requested a QoS property with an
00129     /// unsupported value.
00130     UNSUPPORTED_VALUE,
00131     /// The application has requested a QoS property with a supported
00132     /// value, but unavailable at the requeste scope.
00133     UNAVAILABLE_VALUE,
00134     /// The property name is unknown or not recognized.
00135     BAD_PROPERTY,
00136     /// The value type for the requested property is invalid
00137     BAD_TYPE,
00138     /// The value for the requested property is illegal
00139     BAD_VALUE
00140   };