OmniMark Concurrent Processing VM runs programs written in the OmniMark programming language.
To run compiled OmniMark programs in OmniMark Concurrent Processing VM:
.xvc
file) from your project.
-load
command
line option.
You can write and compile OmniMark programs using OmniMark Studio for Eclipse, or use OmniMark Desktop Compiler or OmniMark Batch Compiler to compile. Compiled OmniMark
programs have the extension .xvc
. .xvc
files are platform-independent: that is, they can be run by OmniMark Concurrent Processing VM on all
supported platforms.
On a Windows machine, you install OmniMark by running the OmniMark installer. You will be guided through the installation and licensing process.
You configure your copy of OmniMark by choosing from the options in the installation program. To change your configuration, re-run the installation program at any later time: you will be presented with the option of modifying your installation.
OmniMark ships with a number of external function libraries. Your OmniMark programs can call functions in these libraries. You can also write your own external function libraries or obtain them from third parties.
When you install OmniMark on Windows, the installer records in the Windows registry the location of the external
function libraries supplied with OmniMark. OmniMark can find these automatically. You can prevent OmniMark from
searching the directories named in the registry with the
-noenvarg
(or -noea
) command line option. If you want a specific
OmniMark programs to use a different set of external function libraries, you can specify their location using the
-x
command line option.
When OmniMark attempts to load an external function library, the following locations will be searched, in order:
On a UNIX machine, you install OmniMark by untarring the files into a suitable directory. Once OmniMark is installed, you must license it. To license your copy of OmniMark you must request an authorization key from Stilo.
To receive and install your license key, begin by running OmniMark Concurrent Processing VM with the -reqkeygen
command-line option with the following arguments:
Capture the output in a file. For example, suppose that your serial number is SN-Yy3X-ptdi-gpa-u[4
and you want to save the request key in the file req.txt
:
omcpvm -log req.txt -reqkeygen "SN-Yy3X-ptdi-gpa-u[4" [email protected] "Machine Sol23"
OmniMark Concurrent Processing VM will generate a request key and write it to the specified file. Email the
contents of req.txt
in the body of a plain text email to [email protected]
. You
will receive an authorization key by return email.
Create an environment variable called OMNIMARK_INFO
and give it the value AUTH:
followed by your authorization key. If you already have an OMNIMARK_INFO
environment variable, you can
add your new key to the end of the existing key using a semi-colon as a separator. For details on setting
environment variables, consult the documentation for your shell or contact your system administrator.
OmniMark ships with a number of external function libraries. Your OmniMark programs can call functions in these libraries. You can also write your own external function libraries or obtain them from third parties.
You must configure your system so that OmniMark can find the external function libraries you install. When you install OmniMark on a UNIX system, external function library directories are not located automatically. You must do one of the following:
OMNIMARK_XFLPATH
environment variable, or
-x
command line options.
When setting the OMNIMARK_XFLPATH
variable under UNIX, paths should be separated by a colon. For
details on setting environment variables, consult the documentation for your shell or contact your system
administrator. You can prevent OmniMark from searching the directories named in the environment with the -noenvarg
(or -noea
) command line option. If you want a specific OmniMark
program to use a different set of external function libraries, you can specify their location on the OmniMark
command line using the -x
command line option.
When OmniMark attempts to load an external function library, the following locations will be searched, in order:
LD_LIBRARY_PATH
environment variable),
OMNIMARK_XFLPATH
environment variables.
To run an OmniMark program on Windows start a command line window by selecting Command Prompt
from the Windows Program Menu; on UNIX, bring up a shell prompt.
To run compiled OmniMark programs,
.xvc
file) from your project, and
-load
command line option.
Command line options preceded by a single hyphen ("-") character are interpreted by OmniMark Concurrent
Processing VM. Other command-line options (including those preceded by two or more hyphen characters) are
passed to the OmniMark program and are made available on the #args
shelf.
You can combine several command line options into a file called an arguments file. You then name the arguments
file on the OmniMark Concurrent Processing VM command line using the -f
command-line
option. The command-line options in the arguments file will be read as if they had been entered on the command
line. Arguments files are usually given the extension .xar
. The following command line
loads program.xvc
and reads command line options from the file arguments.xar
.
omcpvm -load program.xvc -f arguments.xar
If you place the -load
argument into an arguments file, you can start OmniMark Concurrent
Processing VM using an arguments file alone. The following command line causes OmniMark Concurrent
Processing VM to read options, including the -load
option, from the arguments file
program.xar
.
omcpvm -f program.xar
When you create an arguments file, you should place command line arguments one per line, like this:
#!/usr/bin/omcpvm -f -load program.xvc -d name Fred -c age 5 input.txt -of output.txt
You can include the #!
directive in an arguments file. It will be interpreted appropriately on a UNIX
system and will generally be ignored on a Windows system. If used, the #!
line must contain
the -f
command-line option, which causes OmniMark Concurrent Processing VM to read the
arguments file.
You may include command line arguments meant for the OmniMark program as well as OmniMark Concurrent Processing VM arguments in an arguments file. Additionally, you can load one arguments file from inside another arguments file.
The command-line options for OmniMark Concurrent Processing VM are listed below. Many command-line options have short forms.
A compiled OmniMark program can be loaded and executed using
-load myprog.xvc
To specify an arguments file that is to be read as part of the command line, use
-f testprogram.xarThe
-f
command-line option can also be written -argsfile
.
The -temppfx
command-line option is used to specify the directory where OmniMark should
create temporary files when processing referents
; for instance, a typical use on a UNIX system might be
-temppfx temp/
The -xflpath
command-line option can be used to specify a directory in which OmniMark
should look for external function libraries. On Windows, a typical use might be
-xflpath c:\omnimark\lib\=L.dllThe
-xflpath
command-line option can be shortened to -x
.
You must specify the file extension used for shared libraries on the platform OmniMark is running on: on Windows
this means adding the trailing slash and =L.dll
, while on UNIX this means adding the trailing
slash =L.so
. Note however that the appropriate suffix on
UNIX machines is platform-dependent: consult the documentation for your system or contact your system
administrator to find was suffix is appropriate for dynamic libraries on your system.
If the command line has more than one "-xflpath" option, OmniMark will search those directories in the order you've specified them.
To force OmniMark to ignore external function library paths specified in environment variables and Windows
registry entries, use
-noenvargThe
-noenvarg
command-line option can also be written -noea
.
To specify a file to capture the data that OmniMark writes to standard output, use the -of
option:
-of my-output.txtTo append to the output file instead of overwriting its contents, use the
-aof
command-line option:
-aof my-output.txt
You can set the initial values of global
s in the OmniMark program. Initial values set on the command
line override those specified in the program source.
To set a switch
variable to true
, use
-activate my-switchThe
-activate
command-line option can also be written -a
. To set a switch
variable to false
, use
-deactivate my-switchThe
-deactivate
command-line option can also be written -dea
.
To set the value of an integer
, use
-counter my-counter 44The
-counter
command-line option can also be written -c
.
To set the value of a stream
or string
, use one of the following:
-define email-addr "[email protected]"The
-define
command-line option can also be written -d
.
The -log
command-line option is used to specify a file to which OmniMark will write log
messages generated by the OmniMark program:
-log testprogram.logTo append to the log file instead of overwriting its contents, use the
-alog
command-line option:
-alog testprogram.log
To add program execution statistics, including memory usage and execution times, to the log, use
-stats
You can find out which version of OmniMark you are using the -version
command-line option.
To display the authorization key for OmniMark, or to view diagnostic information in the case of an authorization
failure, use the -authkey
command-line option.
If markup errors are encountered during processing, a count is given at the end of execution. To suppress this,
use the -nocount
command-line option.
To suppress the error number when markup error and warning messages are reported, use the -noernum
command-line option.
The number of XML/SGML error messages reported can be limited using the -limit
command-line
option:
-limit 50The
-limit
can also be written -threshold
.
To specify the name of a file containing OmniMark SGML/XML library declarations and comments to be used when
resolving external text entities, use the -library
command-line option:
-library my-library.xlr
To specify a directory in which OmniMark should look for files specified in the system identifier portion of an
OmniMark library declaration, use the -l
command-line option: for instance, a typical use on
a UNIX system might be
-l /usr/bin/lib/The
-l
command-line option can also be written -libpath
.
If the command line contains more than one -l
option, OmniMark will search those directories
in the order they are specified. Note that you must include a trailing directory name separator (/
on UNIX, \
on Windows) at the end of the specified path, as the path is
prepended to the name of the file when OmniMark searches for it.
To generate a licence request key, use the -reqkeygen
command-line option, providing it with a serial number, an email address, and an identifying string. For example,
-reqkeygen "SN-Yy3X-ptdi-gpa-u[4" [email protected] "Machine Sol23"The output goes to the log stream. It can be captured using the
-log
command-line option;
however, in this case the -log
command-line option must appear before the -reqkeygen
.