Contents Previous Next Subchapters

Starting O-Matrix
Syntax status = OMServer.Start(exeName)
See Also comopen

Description
Start a new instance of O-Matrix or the O-Matrix Run-Time Engine. The character row vector exeName must equal OMATRIX or OMVM. If the string OMATRIX is provided the server will attempt to start an instance of O-Matrix, and if the string OMVM is provided the server will attempt to start an instance of the O-Matrix virtual machine.

By default the server will look for the O-Matrix executable in the directory c:\omwin and the virtual machine executable in the directory c:\omvm. If you installed O-Matrix in a different directory you must set the environment variable OMATRIX to specify the location of the O-Matrix executable. If you installed the virtual machine in a different directory you must set the environment variable OMVM to specify the location of the O-Matrix virtual machine executable. The OMServer.Start method only creates a new instance of O-Matrix or the O-Matrix run-time engine. The OMServer.Open method must be called before your client application can communicate with O-Matrix.

The returned value status is an integer OM Server Status code. This value will equal 1 if this function succeeded.

Example
See the file StartOM.VBS in the devkit\Examples\vbsScripts directory of your installation for examples of starting O-Matrix and the run-time engine.