Request Reply (-RQSTRPL)

Use the Request Reply adapter command (-RQSTRPL) to request to receive the confirmation message receipt (the reply). The Request Reply adapter command (-RQSTRPL) is used on data targets only.

-RQSTRPL

For example, to send the message to the output_RCV subject name with the request for confirmation for the message receipt, the syntax would be:

-SBN output_RCV -RQSTRPL

The adapter assumes that the listener for the reply is operational and has established delivery tracking with the receiver of the output map message. When the Request Reply adapter command (-RQSTRPL) is specified, the adapter invokes either the TIBCO Rendezvous tibrvTransport_SendRequest function call (without certified messaging) or the tibrvcmTransport_SendRequest (with certified messaging) function call. This function call blocks until either the receipt of the replied message or until the call times out, whichever is first to occur. The timeout period for which to wait until the reply can be specified is specified using the Request Listen (-RQSTLSN) adapter command.

When the subscribing application (recipient) receives the message, the TIBCO Rendezvous callback function is activated and the subscribing application extracts the inbox reply subject name from the received message. This inbox subject name is automatically generated by the tibrvTransport_SendRequest or the tibrvcmTransport_SendRequest function call. The subscribing application must then format the reply message and send it to the subject.

To implement a reply in a map receiving a message, use an input card to receive a message from a subject that has published a message using the tibrvTransport_SendRequest function call. Next, map the data object representing the header reply from an input card to the data object representing the header subject in an output card. The presence of the subject in the header forces the adapter to publish the reply to the subject.