CORBA Notification Service API Reference

Using the CORBA Notification Service

CosNotifyChannelAdmin::StructuredProxyPushConsumer::
push_structured_event

Synopsis

Posts events to the event channel.

OMG IDL

void push_structured_event(
        in CosNotification::StructuredEvent notification ) 
     raises( CosEventComm::Disconnected );

Exceptions

CosEventComm::Disconnected

Never raised.

CORBA::IMP_LIMIT

Indicates one of the following problems:

Tobj_Events::POST_UNSUPPORTED_VALUE_IN_ANY

Tobj_Events::POST_UNSUPPORTED_PRIORITY_VALUE

Tobj_Events::POST_DOMAIN_CONTAINS_SEPARATOR

Tobj_Events::POST_TYPE_CONTAINS_SEPARATOR

Tobj_Events::POST_SYSTEM_EVENTS_UNSUPPORTED

Tobj_Events::POST_EMPTY_DOMAIN

Tobj_Events::POST_EMPTY_TYPE

Tobj_Events::POST_DOMAIN_AND_TYPE_TOO_LONG

Note: For more information on exceptions and corresponding minor codes, see "Exception Minor Codes" on page -59.

Descriptions

Used when posting events. This operation is used in poster applications to post events to the event channel.

Note: This operation differs from the standard CORBA definition in the following ways:

a. The Priority in the variable header section of the event, if specified, must be short value in the range of 1 to 100.

b. If event filterable data filtering (versus filtering on domain and type only) is required, or if events are to be received by a BEA Tuxedo subscriber, then additional restrictions apply. See "Structured Event Fields, Types, and Filters" on page -5 and "Interoperability with BEA Tuxedo Applications" on page -9.

Note: This operation has transactional behavior when used in the context of a transaction. For more information, see Using Transactions.

Examples

Note: Code examples shown here are abbreviated. For complete code examples, see "Creating and Posting Events" on page -4.

C++ code example:

proxy_push_consumer->push_structured_event(notification);

CosNotifyChannelAdmin::StructuredProxyPushConsumer::push_structured_event