tibemsQueueRequestor_Create


Function

Purpose

Create a queue requestor.

C Declaration

tibems_status tibemsQueueRequestor_Create( 
    tibemsQueueSession session, 
    tibemsMsgRequestor* msgRequestor, 
    tibemsQueue queue ); 

COBOL Call

CALL "tibemsQueueRequestor_Create" 
     USING BY VALUE session, 
           BY REFERENCE msgRequestor, 
           BY VALUE queue, 
           RETURNING tibems-status 
END-CALL. 

session, msgRequestor and queue have usage pointer.

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

Remarks

We recommend that programs follow these steps:

  1. Create a tibemsQueueSession, and use it to create a tibemsQueue for requests and replies.
  2. Create a tibemsMsgRequestor, using the queue session and queue 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

tibemsQueue

tibemsMsgRequestor_Close

tibemsMsgRequestor_Request

tibemsQueueSession


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