|
Terminates all enterprise servers associated with a requester.
|
|
Syntax:
|
RqRtTrm(service name, entry number, supervisor password)
|
|
Parameters:
|
service name: An Alpha variable or constant with a service name.
entry number: Numeric values indicating the internal number of the runtime engine, within the list returned by the RqRts function. If the value is 0 then all runtime engines will be terminated.
supervisor password: An Alpha variable or constant with the password specified in the Broker initialization file.
|
|
Returns:
|
True when the enterprise server has been terminated.
False is returned when the enterprise server has not been terminated.
|
|
Example:
|
RqRtTrm('Data Server', BA, 'Secret') The virtual numeric variable BA temporarily stores the runtime engine number. This number is returned from the execution of the RqRts function.
|
|
Exception:
|
This function is supported only while using the Broker as a middleware.
|
|
Note:
|
You must run the RqRts function before using this function.
An invalid service name or runtime engine number causes the function to fail and return false. If the password is not the supervisor password, then the function also fails.
|
|
See also:
|
RqRtTrmEx
The Online and Rich Client Samples projects (program ES11 and RES11)
|
