Tuxedo
0

Using the CORBA Notification Service

 Previous Next Contents Index View as PDF  

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  2-66.

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  2-5 and "Interoperability with BEA Tuxedo Applications" on page  2-10.

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-4.

C++ code example:

proxy_push_consumer->push_structured_event(notification);

Java code example:

proxy_push_consumer.push_structured_event(notification);

 

Back to Top Previous Next
Contact e-docsContact BEAwebmasterprivacy