tibemsTopicRequestor_Create


Function

Purpose

Create a topic requestor.

C Declaration

tibems_status tibemsTopicRequestor_Create( 
    tibemsTopicSession session, 
    tibemsMsgRequestor* msgRequestor, 
    tibemsTopic topic ); 

COBOL Call

CALL "tibemsTopicRequestor_Create" 
     USING BY VALUE session, 
           BY REFERENCE msgRequestor, 
           BY VALUE topic, 
           RETURNING tibems-status 
END-CALL. 

session, msgRequestor and topic have usage pointer.

Parameter
Description
session
The requestor operates within this topic 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.
topic
The requestor sends request messages to this topic, and waits for replies on the same topic.
You must create this topic using the topic session you supply as the first argument.

Remarks

We recommend that programs follow these steps:

  1. Create a tibemsTopicSession, and use it to create a tibemsTopic for requests and replies.
  2. Create a TopicRequestor, using the topic session and topic as arguments.
  3. Send a request and receive a reply. 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

tibemsTopic

tibemsMsgRequestor_Close

tibemsMsgRequestor_Request

tibemsTopicSession


TIBCO Enterprise Message Service™ C and COBOL Reference
System Release 4.3, February 2006
Copyright © TIBCO Software Inc. All rights reserved
www.tibco.com