Execute

Synopsis

[Actions]
Execute:Namespace=namespace,[Additional Properties]

Description

Execute executes a class method or routine. InterSystems IRIS® executes the defined class method or routine when processing the [Actions] section during a configuration merge. The Execute parameters are always processed last. You specify the class method or routine and its arguments in the Execute definition, and the class method or routine must return a %StatusOpens in a new tab (%Library.StatusOpens in a new tab) value. During the merge, InterSystems IRIS runs the class method or routine defined by Execute.

Examples

You can execute a class method or a routine with Execute. For example:

Execute the class method SYS.ClassA.MethodZ() and pass three arguments to it; equivalent of SYS.ClassA.MethodZ("arg1","arg2","arg3"):

Execute:Namespace="%SYS",ClassName="SYS.ClassA",MethodName="MethodZ",Arg1="arg1",Arg2="arg2",Arg3="arg3"

Load and compile classes from an XML file; equivalent of $SYSTEM.OBJ.Import("c:\iris\test.xml","ck"):

Execute:Namespace="%SYS",ClassName="%SYSTEM.OBJ",MethodName="Import",Arg1="c:\iris\test.xml",Arg2="ck"

Run a routine and pass two arguments to it; equivalent of $$Tag2^ZTEST("arg1","arg2"):

Execute:Namespace="%SYS",RoutineName="$$Tag2^ZTEST",Arg1="arg1",Arg2="arg2"

Changing this Operation

This operation is designed to be used during a configuration merge. You can change Execute by editing the merge file in a text editor (as described in Editing the Active CPF).