EXECUTE Message
Description
Method for executing entities.
Syntax
object = Repository('EXECUTE', entID, param1, param2, …, param20)
Parameters
The EXECUTE method has the following parameters.
| Parameter | Description | |
|---|---|---|
| Message | 'EXECUTE' | |
| entID | entID consists of four elements, which are '*' (asterisk) delimited: * Application name * Type ID * Class ID * Entity name Methods are executed as follows: if class specific, execute at the class level; if type specific, execute at the type level; otherwise, execute the method. Parameters passed are based on the entity type. For STPROC and STPROCEXE (stored procedures), up to 20 parameters can be passed to the stored procedure, passed as is. Specific parameter information is documented below. | |
| param1 | For MMEDIA.AUDIO and MMEDIA.WAVE, a boolean flag indicating whether or not to play the file or simply to load it. For WINEXE, a command line parameter string. For APPNOTE, MSG, and POPUP, the parent window name. For OIREPORT.RDLAYOUT, any command line parameters. For WINHELP, a field mark delimited dynamic array, with <1> = the name of the current window <2> = the command to pass to Windows help <3> = the associated information. | |
| param2 | For APPNOTE, MSG, and POPUP, an overriding row structure For OIREPORT.RDLAYOUT, a boolean flag indicating whether or not the report should be previewed first. | |
| param3 | For OIREPORT.RDLAYOUT, command line parameters to pass to RUNWIN. | |
Returns
null
Note: Always call the Get_Status function after calling Repository.
See Also
Repository() function, Get_Repos_Entities(). Also, Stored Procedures chapter in the Guide to Application Development.
Example
/* Execute the CENTERWINDOW stored procedure, passing the parameter TEST_WINDOW */
Declare Function Get_Repos_Entities, Repository, Get_Status
AppID = @APPID<1> ;* current application
TypeID = "STPROC" ;* OpenInsight stored procedures
ClassID = "" ;* Not Applicable
Stored_Proc_Name = 'CENTERWINDOW'
param1 = 'TEST_WINDOW'
entid = AppID : '*' : TypeID : '*' : ClassID : '*' : Stored_Proc_Name
result = Repository("EXECUTE", entid, param1)
If Get_Status(ErrCode) then
call msg(@window, 'Error Message returned: ' : ErrCode)
return 1
end