Programming Guide



post

Posts an event

Synopsis

post EVENT eventName TYPE msgType (message) [postOption]...

Arguments

EVENT eventName
The event to be posted, where eventName can be up to 31 characters long, but cannot start with a period (.) or sm.

TYPE msgType
Specifies the data type of the message to accompany this event posting, where msgType is one of these values:

message
Data to accompany the event posting; the message's format must conform to the TYPE-specified data type.

postOption
One or more of the following options:

NOREPLY
The event broker does not wait for replies from subscribers to the event before returning to the posting agent.

NOTIMEOUT
The event posting is not subject to blocking timeouts; however, transaction timeouts remain in effect.

OUTSIDE_TRANSACTION
Execute the event posting operation outside of the current transaction (if issued within a transaction). If you specify this option, transaction-level exception and unload handlers are not executed when their corresponding events are generated.

Environment

Oracle Tuxedo

Scope

Client, Server

Description

The post command lets a client or server post an event. When an event is posted, the event broker notifies all subscribers of the event. If successful, post sets the tp_return property to the number of notifications dispatched; otherwise, it sets tp_return to TP_FAILURE. For information about the Oracle Tuxedo event broker and configuration requirements, refer to "Event Brokering" in JetNet/Oracle Tuxedo Guide; also refer to your Oracle Tuxedo documentation.

Exceptions

The post command can generate these exceptions:

Exception Severity Cause
TP_EVTBROKER_ACCESS_FAILED
TP_COMMAND

Unable to access the event broker sever.

TP_NO_OUTSIDE_TRANSACTION
TP_WARNING

There is no current transaction.

TP_POSTING_FAILED
TP_COMMAND

An error occurs when posting a transactional event to either a service routine or a reliable queue on behalf of the caller's transaction.

TP_INVALID_COMMAND_SYNTAX
TP_COMMAND

Command syntax is invalid.

TP_INVALID_VARIABLE_REF
TP_COMMAND or TP_WARNING

Unable to resolve reference to Panther variable.

See Also

subscribe, unsubscribe