Consultor Eletrônico

SUMMARY:

The function browseQueue can be used to access the queue's browsing feature of SonicMQ through the Sonic Adapter. However the manual is missing one of the parameters you need to pass to this procedure in order for it to work properly.

EXPLANATION:

Different Progress manuals contain sections on the Sonic adapter in versions from 9.1B to 9.1D. There is a write up on the BrowseQueue method that among other things says:

"The browseQueue method receives the name of the queue, a selector
expression, and a Message Consumer object as input parameters."

However, when you look at the API guide it has this syntax:

PROCEDURE browseQueue.
DEFINE INPUT PARAMETER queueName AS CHAR.
DEFINE INPUT PARAMETER messageConsumer AS HANDLE.

And, if you try to call this method, you will get an error as follows:

Mismatched number of parameters passed to procedure <procedure>.
(3234).

SOLUTION:

The syntax should read similar to that used for calling receiveFromQueue:

PROCEDURE browseQueue.
DEFINE INPUT PARAMETER queueName AS CHAR.
DEFINE INPUT PARAMETER messageSelector AS CHAR. /*Optional. If UNKNOWN, receives all messages.*/
DEFINE INPUT PARAMETER messageConsumer AS HANDLE.

References to Written Documentation:

Information on Sonic Adapter and browseQueue can be found in these manuals:
9.1B: Progress On the Web
9.1C: Version 9 Product Update Bulletin
9.1D: External Program Interfaces