Copyright © TIBCO Software Inc. All Rights Reserved

> tibemsMsgRequestor_Create
> Function
> Purpose
> Create a message requestor.
> C Declaration
> tibems_status tibemsMsgRequestor_Create(
> tibemsSession session,
> tibemsMsgRequestor* msgRequestor,
> tibemsDestination destination);
> COBOL Call
> CALL "tibemsMsgRequestor_Create"
> USING BY VALUE session,
> BY REFERENCE msgRequestor,
> BY VALUE destination,
> RETURNING tibems-status
> END-CALL.

> | session, msgRequestor and destination have usage pointer.

> Parameters

> Parameter | Description
> session | The requestor operates within this session. This session must not use transaction semantics. Its delivery mode must be either TIBEMS_AUTO_ACKNOWLEDGE or TIBEMS_DUPS_OK_ACKNOWLEDGE.
> msgRequestor | The function stores the new requestor in this location.
> destination | The requestor sends request messages to this destination, and waits for replies on an internally created temporary destination. If the destination that request messages are sent to is a queue, then an internal temporary queue is created and used. If the destination that request messages are sent to is a topic, then an internal temporary topic is created and used. You must create this destination using the session you supply as the first argument.

> Remarks
> We recommend that programs follow these steps:

> 1. | Create a tibemsSession, and use it to create a tibemsQueue or tibemsTopic for requests and replies.

> 2. | Create a tibemsMsgRequestor, using the session and destination as arguments.

> 3. | Send a request and receive a reply with tibemsMsgRequestor_Request. You may repeat this step for several request and reply pairs.

> 4. | Close the requestor object. tibemsMsgRequestor_Close also closes the requestor’s session as a side effect.

> See Also
> tibemsDestination on page 144
> tibemsMsgRequestor_Close on page 197
> tibemsMsgRequestor_Request on page 200
> tibemsSession on page 286

Copyright © TIBCO Software Inc. All Rights Reserved