Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Code Block
languagecpp
themeConfluence
FUNCTION xpfExecuteQuery (queryHandle                 : INTEGER;
         modelId                 argument1, ..., argumentN   : GENERIC);  -- argumentsoptional toargument
actual called query                        queryHandle   queryFunctionValue          : GENERIC;   : INTEGER;
                          argument1,           
 

Related functions:
==================

FUNCTION xpxSetVmTargetModelBN (repositoryNameOrRepositoryId : GENERIC;..., argumentN   : GENERIC)
                                modelNameOrModelId queryFunctionValue          : GENERIC;
                                modelAccessMode              : INTEGER); -- LATER: xpxAddModelToActiveTransaction if xpxRW
 
FUNCTION xpxSetVmTargetModel (modelId          : GENERIC;
                              modelAccessMode  : INTEGER;  -- LATER: xpxAddModelToActiveTransaction if xpxRW
 

 

...

See also:

...

Include Page
US:_xpxExecute common
US:_xpxExecute common

The argument “modelId” is optional, i.e., it is not “necessary” for the calling function to set the actual target data model for the called function. The data model (xpxTargetModelId) can be set in the called function itself by invoking one of the following two functions:

  1. xpxSetVmTargetModel
  2. xpxSetVmTargetModelBN

Note: An exception (error) will be raised when one of these two above listed functions are called within an “open” FROM statement. The xpfExecuteQuery function has an argument called “queryHandle”. In general, the concept “handles” is introduced in EDMvm to boost performance. Until now, items like local variables, global variables, functions, etc., has been search for using linked lists, but using handles , the actual handle gives a direct “address” to the actual item. A handle is only valid within one EDMvm session. Simplified, a handle is similar to “an open file descriptor”, i.e., it must be retrieved in each session of a program,

The following functions are introduced for retrieving handles:

  1. xpfGetQuerySchemaHandle
  2. xpfGetFunctionHandleBN
  3. xpfGetFunctionHandle

The xpfGetFunctionHandleBN and the xpfGetFunctionHandle functions can be used to get the “function handle” to any function in a query schema, not only query functions.

Arguments

...

Insert excerpt
US:_a_queryHandle
US:_a_queryHandle
nopaneltrue
Insert excerpt
US:_a_Arguments
US:_a_Arguments
nopaneltrue
Insert excerpt
US:_a_modelId_XPX
US:_a_modelId_XPX
nopaneltrue

Return Value

...

 

Insert excerpt
US:_r_queryFunctionValue
US:_r_queryFunctionValue
nopaneltrue

Options

...

 

 

Example

...

<example missing>

 

See also

Filter by label (Content by label)
showLabelsfalse
showSpacefalse
cqllabel = "execute_function" and parent = "5636522"
Filter by label (Content by label)
showLabelsfalse
showSpacefalse
cqllabel = "VM_functions" and parent = "5636522"