Salesforce

RqRtCtx (Magic xpa 4.x)

« Go Back

Information

 
Created BySalesforce Service User
Approval Process StatusPublished
Objective
Description

RqRtCtx (Magic xpa 4.x)

Returns the information of a given context entry of a given service or server name. The RqRtCtxs function should be run before using this function.

Syntax:

RqRtCtx(service/server name, context entry number)

Parameters:

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

Context entry number: Numeric value indicating the internal number of the context within all contexts queried using RqRtCtxs. The RqRts function must be called first.

Returns:

A string with the following comma-delimited information:

  1. Context ID: The ID of the context.

  2. Request ID: The ID of the request that is active within this context.

  3. Program name: The name of the program that opened this context.

  4. User name: the name of the user logged into the system within this context.

  5. Status: The status of the context

E – Executing – The current entry is currently executing.

P – Pending Execution – The current entry is waiting for an event.

T – Pending Termination – The current entry is waiting for termination. This status can be retrieved when the context in the Browser Client was ‘unloaded’ by moving to a different page. Contexts in this status can be either terminated or revived.

  1. Last used: the amount of time that has passed since the last time the context was active in the HH:MM:SS format.

Example:

RqRtCtx('My Service',14)

This example returns the following information about the 14th entry that was queried using the 'My Service' service.

1324543108,128,Customer Entry,George,E,00:00:00

Exception:

This function is supported only while using the Broker as a middleware.

Note:

The Request ID is only available if the status of the context is Executing. Otherwise the Request ID is set to zero.

For example:

2314672146,0,Customer Entry,George,P,00:13:47

See also:

The Online and Rich Client Samples projects (program ES05 and RES05)

Reference
Attachment 
Attachment