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.
Note: 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

tibemsMsgRequestor_Close

tibemsMsgRequestor_Request

tibemsSession