| Table of Contents |

Installing and configuring OmniMark Concurrent Processing Engine on Windows

On a Windows machine, you install OmniMark Concurrent Processing Engine by running the OmniMark Concurrent Processing Engine installer. You will be guided through the installation and licensing process.

OmniMark Concurrent Processing Engine ships with a number of external function libraries. Your OmniMark scripts can call functions in these libraries. You can also write your own external function libraries or obtain libraries from third parties.

When you install OmniMark Concurrent Processing Engine on Windows, the installer records in the Windows registry the location of the external function libraries supplied with OmniMark Concurrent Processing Engine. OmniMark Concurrent Processing Engine can find these automatically. If you install external function libraries in other directories, you can do one of the following to allow OmniMark Concurrent Processing Engine to locate them:

• edit the registry
• use the -x command line option

If you edit the Windows registry, make sure to back up your registry before making changes.

The Windows registry entries are found under the key:

HKEY_LOCAL_MACHINE\SOFTWARE\Stilo\ConcurrentProcessingEngine9_0_1

There is one entry specifying the number of paths and then one entry for each path. The entry specifying the number of paths is:

\xflpath\Count

The entry specifying the first path is:

\xflpath\Item0

and the other paths are "Item1", "Item2", and so on, up to the value of Count - 1.

If you want a specific OmniMark script to use a different set of external function libraries, you can specify their location on the OmniMark Concurrent Processing Engine command line using the -x command line option. You can prevent OmniMark Concurrent Processing Engine from searching the directories named in the registry with the -noenvarg or -noea command line option.

When OmniMark Concurrent Processing Engine attempts to load an external function library, the following locations will be searched, in order:

1. the current directory
2. directories that the operating system searches when attempting to load an external function library. On Windows, this is all directories on the path.
3. paths specified on the OmniMark Concurrent Processing Engine command line
4. paths specified in the registry

OmniMark Concurrent Processing Engine ships with a number of include files, with names ending in ".xin", and modules, with names ending in "xmd". Your OmniMark scripts can call the functions defined in these files. If you run OmniMark scripts from source, OmniMark Concurrent Processing Engine must be able to locate these files. When you install OmniMark Concurrent Processing Engine on Windows, the installer records in the Windows registry the location of the include files. OmniMark Concurrent Processing Engine can find these automatically. If you install include files or modules in other directories, you can do one of the following to allow OmniMark Concurrent Processing Engine to locate them:

• Edit the registry.The Windows registry entries are found under the key:

  HKEY_LOCAL_MACHINE\SOFTWARE\Stilo\ConcurrentProcessingEngine9_0_1

  There is one entry specifying the number of paths and then one entry for each path. The entry specifying the number of paths is:

  \include\Count

  The entry specifying the first path is:

  \include\Item0

  and the other paths are "Item1", "Item2", and so on, up to the value of Count - 1.
  NOTE: If you choose to edit the Windows registry, make sure to back up your registry before making changes.
• Use the -i command line option. If you want a specific OmniMark script to use a different set of include files or modules, you can specify their location on the command line using the -i command line option. You can prevent OmniMark Concurrent Processing Engine from searching the directories named in the registry by using the -noenvarg or -noea command line option.

When searching for include files, OmniMark Concurrent Processing Engine searches in the following order:

1. the current directory
2. paths specified on the OmniMark Concurrent Processing Engine command line
3. paths specified in the Windows registry

  OmniMark 9.1.0
  EUM105 1108, generated: September 8, 2010 at 11:56:21 am
  If you have any comments about this section of the documentation, send email to [email protected]