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
|
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:
- Create a
tibemsSession
, and use it to create atibemsQueue
ortibemsTopic
for requests and replies. - Create a
tibemsMsgRequestor
, using the session and destination as arguments. - Send a request and receive a reply with
tibemsMsgRequestor_Request
. You may repeat this step for several request and reply pairs. - Close the requestor object.
tibemsMsgRequestor_Close
also closes the requestor’s session as a side effect.