| Table of Contents

Command line options

The command-line options for OmniMark Single Processing Engine are listed below. Many command line options have short forms.

Loading and running OmniMark programs

• To run an OmniMark script from source, use one of the following

  • -s sourcefile.xom

  • -source sourcefile.xom

  • -src sourcefile.xom

• The following options are functionally identical to the above. In earlier versions of Omnimark they were used to suppress the display of the OmniMark banner. The OmniMark banner is no longer displayed when starting OmniMark.

  • -sb sourcefile.xom

  • -sourcebrief sourcefile.xom

• To load and execute a compiled OmniMark script:

  • -load myprog.xvc

• To specify a maximum time, in seconds, that OmniMark Single Processing Engine should continue to try to obtain authorization:

  • -licto (time in seconds)

• To specify a time, in seconds, that OmniMark Single Processing Engine should wait between attempts to obtain authorization:

  • -licri (time in seconds)

• To specify an arguments file that is to be read as part of the command line, use one of the following:

  • -argsfile testprogram.xar

  • -f testprogram.xar

• To specify the directory where OmniMark Single Processing Engine should create temporary files when processing referents:
  • UNIX example:

    -temppfx /usr/bin/omnimark/temp/

  • Windows example:

    -temppfx c:\omnimark\temp\

Locating external function libraries

• To specify a directory in which OmniMark Single Processing Engine should look for external function libraries:
  • UNIX example:

    -xflpath /usr/bin/omnimark/lib/=L.so

  • Windows example:

    -xflpath c:\omnimark\lib\=L.dll

  • Short Form:

    -x /usr/bin/omnimark/lib/=L.so
    -x c:\omnimark\lib\=L.dll

You must specify the file extension used for shared libraries on the platform OmniMark Single Processing Engine is running on. On UNIX, you must add the trailing slash and "=L.so". On Windows, you must add the trailing slash and "=L.dll". If the command line has more than one "-xflpath" option, OmniMark Single Processing Engine will search those directories in the order you've specified them.

• To specify a path to the include files, use one of the following:

  • -i path

  • -include path

• To force OmniMark Single Processing Engine to ignore include paths and external function library paths specified in environment variables and Windows registry entries:

  • -noenvarg

  • -noea

Specifying the default output destination

• To specify a file to capture the data that OmniMark Single Processing Engine writes to standard output:

  • -of my-output.txt

• To specify a file to which the data that OmniMark Single Processing Engine writes to standard output will be appended:

  • -aof my-output.txt

Setting global variables in the OmniMark script

You can set the initial values of global variables in the OmniMark script. Initial values set on the command line override those specified in the program source.

• To set a switch variable to true, use one of the following:

  • -activate my-switch

  • -a my-switch

• To set a switch variable to false, use one of the following:

  • -deactivate my-switch

  • -dea my-switch

• To set the value of an integer or int32 variable, use one of the following:

  • -counter my-counter 44

  • -c my-counter 44

• To set the value of a stream variable, use one of the following:

  • -define email-addr "[email protected]"

  • -d email-addr "[email protected]"

Information and logging

• To specify a file to which OmniMark Single Processing Engine will write log messages generated by the OmniMark script, specify one of the following:

  • -log testprogram.log (to overwrite the existing log file)

  • -alog testprogram.log (to append to the existing log file)

• To add program execution statistics, including memory usage and execution times, to the log:

  • -stats

• To display the version of OmniMark Single Processing Engine, specify:

  • -version

• To display the authorization key for your OmniMark Single Processing Engine, or to view diagnostic information the the case of an authorization failure, specify:

  • -authkey

Controlling markup error reporting

• To suppress the message output at the end of program execution giving the number of reported markup error and warning messages:

  • -nocount

• To suppresses the XML/SGML error number when XML/SGML error and warning messages are reported:

  • -noernum

• To limit the number of XML/SGML error messages reported:

  • -limit 50
    -threshold 20

Locating SGML entity libraries

• To specify the name of a file containing OmniMark SGML/XML library declarations and comments to be used when resolving external text entities:

  • -library my-library.xlr

• To specify a directory in which OmniMark Single Processing Engine should look for files specified in the system identifier portion of an OmniMark library declaration:
  • UNIX example:

    -libpath /usr/bin/lib/

  • Windows example:

    -libpath c:\lib\

  • Short Form:

    -l /usr/bin/lib/
    -l c:\lib\

If the command line contains more than one "-libpath" option, OmniMark Single Processing Engine 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 Single Processing Engine searches for it.

Generating a license request key

• To generate a licence request key (for Unix users), which OmniMark Single Processing Engine will write to standard output:

  • -reqkeygen "SN-Yy3X-ptdi-gpa-u[4" [email protected] "Machine Sol23"  40999

  OmniMark 8.0
  EUM94-0204, generated: October 5, 2005 at 04:46:41 pm
  If you have any comments about this section of the documentation, send email to [email protected]