Salesforce

RqRtInf (Magic xpa 4.x)

« Go Back

Information

 
Created BySalesforce Service User
Approval Process StatusPublished
Objective
Description

RqRtInf (Magic xpa 4.x)

Gives information about a specific enterprise server associated with a broker.

Syntax:

RqRtInf(service/server name, runtime engine number)

Parameters:

service/server name: An Alpha variable or constant with a server or service name.

runtime engine number: Numeric value indicating the internal number of the Runtime engine, within all Runtime engines associated with the RqRts list (the RqRts must be called before).

Returns:

String with the following comma-delimited information:

  1. Host name – The host where the Runtime engine is activated.

  2. Port number – The port that the Runtime engine is monitoring.

  3. Dotted address – In the form of nnn.nnn.nnn.nnn

  4. Process ID – The process ID of the Runtime engine in the host.

  5. Status – A numeric value indicating the following:

1 – Available for the current request type

3 – Unavailable for the current request type

4 – In Studio mode

5 – Unresponsive

8 – Unreachable (A Magic xpa server could not be connected, either since it is aborting or due to network problems.)

9 – License limit reached (A Magic xpa server executed with DeploymentMode=R that was restricted to a predefined number of requests has reached the limit and cannot serve subsequent requests.)

14 – Shutting down

15 – Waiting (as a client, waiting to get control, such as while performing a remote call or a call dll)

16 – Blocked (all requests to the engine are blocked)

17 – Externally blocked (only external requests are blocked - requests from the engine to itself are allowed)

  1. Open Application: The name of the opened application.

  2. Running threads: The number of running threads.

  3. Threads peak: The maximum number of open threads that was reached.

  4. Allowed threads: The maximum number of allowed threads.
    If the engine setting is zero, then it should return the maximum allowed according to the given license.

  5. Average request time: The average time in seconds that a request was processed by an enterprise server.

  6. Request served: The number of requests processed.

  7. Running users: The number of running users (when using the RIA license).

  8. Users peak: The maximum number of users that was reached (when using the RIA license).

  9. Allowed users: The maximum number of allowed users (when using the RIA license).

Example:

RqRtInf('Data Server',BA) where 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:

If an invalid service name or Runtime engine number is sent in the current application, the function returns an empty string.

See also:

The Online and Rich Client Samples projects (program ES02 and RES02)

Reference
Attachment 
Attachment