MQCreateTemporaryDestination

The MQCreateTemporaryDestination function creates a temporary destination and passes its handle back to you.

MQCreateTemporaryDestination(const MQSessionHandle sessionHandle
 MQDestinationType destinationType,
 MQDestinationHandle * destinationHandle);

Return Value

MQStatus. See the MQStatusIsError() function for more information.

Parameters

sessionHandle

The handle to the session with which you want to associate this destination.

destinationType

An enum specifying the destination type, either MQ_QUEUE_DESTINATION or MQ_TOPIC_DESTINATION.

destinationHandle

Output parameter for the handle to the newly created temporary destination.

You can use a temporary destination to implement a simple request/reply mechanism. When you pass the handle of a temporary destination to the MQSetMessageReplyTo function, the consumer of the message can use that handle as the destination to which it sends a reply.

Temporary destinations are explicitly created by client applications; they are deleted when the connection is closed. They are maintained (and named) by the broker only for the duration of the connection for which they are created. Temporary destinations are system-generated uniquely for their connection and only their own connection is allowed to create message consumers for them.

For more information, see The Request-Reply Pattern in Sun Java System Message Queue 4.3 Technical OverviewChapter 5, Managing a Broker , in Sun Java System Message Queue 4.3 Administration GuideChapter 5, Managing a Broker , in Sun Java System Message Queue 4.3 Administration GuideChapter 6, Configuring and Managing Connection Services, in Sun Java System Message Queue 4.3 Administration GuideChapter 11, Managing Administered Objects, in Sun Java System Message Queue 4.3 Administration Guide.

Common Errors

MQ_INVALID_DESTINATION_TYPE
MQ_SESSION_CLOSED