Applies To
OAQMsg
Description
Creates an instance of the OAQAgent for the specified consumer and adds it to
the OAQAgents list of the message.
Usage
OAQAgent* AQAgent(const char *name, const char *addr) const throw(OException)
Arguments
name
A string up to 30 bytes representing the name of the consumer of the message.
addr
An optional 128 byte string representing the protocol specific address of
recipient, such as schema.]queue[@dblink].
Remarks
The OAQAgent object represents a message recipient and is only valid for
queues which allow multiple consumers. Queue subscribers are recipients by default.
Use this to override the default consumers.
The maximum number of agents that a message can support is 10. The AQAgent
method returns an instance of an OAQAgent.
Note: The address is not supported in this release, but is provided for future
enhancements.