Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 6 Requestor : tibemsMsgRequestor : tibemsMsgRequestor_Create

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
 
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
Copyright © TIBCO Software Inc. All Rights Reserved