call

Invokes a specified application.

Available in:

Apps (win)	Apps (char)	Reportwriter	RPC	Standalone PL
X	X	X	X	X

Syntax

expr call(run-file[,parm,...])
string    run-file
expr      parm

Description

Returns the results of run-file, up to 400 bytes.

run-file	specifies the name of the function to call.
parm	(optional) specifies the function's parameter(s), which can also be accessed in the trigger's main application.

Notes

You must ensure that either:

runpath is specified in trim.ini or
provide the full pathname of run-file.

Specifying the .run extension is optional. This function is similar to overlay(), except that the calling function call() receives the run-file's results. overlay() replaces itself with the run-file and the results are returned to a main trigger.

Example

Invokes TRIMmenu:

call("trimmenu.run");

The following example invokes an application and passes the TRIMrun start time as a parameter.

call("app1.run",g.time);