|
Loads the information of all of the opened contexts of the enterprise server in which it is evaluated. The function returns the total number of these contexts. The RqRtCtxs function needs to be evaluated prior to the RqRtCtx function that queries a given context.
|
|
Syntax:
|
RqRtCtxs(service/server name, runtime engine number)
|
|
Parameters:
|
service/server name: An Alpha variable or constant with a service name.
runtime engine number: Numeric value indicating the internal sequential number of the runtime engine within all the runtime engines associated with the service. The RqRts function must be called first.
|
|
Example:
|
RqRtCtxs('My Service',3)
This example loads the information of all the contexts that are opened by Engine number 3 of the 'My Service' service, and returns the total number of opened context by the given engine.
|
|
Exception:
|
This function is supported only while using the Broker as a middleware.
|
|
Note:
|
Every RqRtCtxs activation clears the previous activation of the function.
|
|
|
This function is relevant for multi-threaded background enterprise servers. When it is used in a non-background enterprise server, it will always return 0.
|
|
See also:
|
The Online and Rich Client Samples projects (program ES05 and RES05)
|
