# 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`

Copyright © Cloud Software Group, Inc. All rights reserved.