CreateRequest Function [Revelation On-Line Wiki]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.

====== CreateRequest Function     ======


 
==== Description ====
 
Executes a request on a queue opened with the [[createqueue|CreateQueue]] function.
 
==== Syntax ====
 
Error = CreateRequest(Request, Queue, Script, Arg1, Arg2, ...)
 
==== Parameters ====
 
The CreateRequest function has the following parameters.

^Parameter^Description^
|Request|Handle for the request.  Pass null.  CreateRequest will return a request handle.|
|Queue|Handle obtained from a call to [[createqueue|CreateQueue()]].|
|Script|Command to be executed.|
|Arg1, Arg2, ...|Arguments to the request.||

 
==== Note ====
 
See the client program example for coding an entire request/response message loop.  See [[callfunction|CallFunction()]] and [[callsubroutine|CallSubroutine()]] for a simpler approach.
 
==== See Also ====
 
[[createqueue|CreateQueue()]], [[callfunction|CallFunction()]], [[callsubroutine|CallSubroutine()]]
 
==== Example ====
 
<code>
// Execute a request on a queue.

Error = CreateEngine(Engine,"\\DEVSERVER","SYSPROG", CREATE_ENGINE_OPEN_ALWAYS$,1)

// error checking for CreateEngine()

 

Error = CreateQueue(Queue, Engine, "", "SYSPROG", "SYSPROG")

 

// error checking for CreateQueue()

 

Error = CreateRequest(Request, Queue, "RUN GET_APP_INFO 'SYSPROG'")

if (Error) then

CloseQueue(Queue)

CloseEngine(Engine)

return

end

 
 
 
 
</code>