This section provides the command line syntax and details to run artifacts in JSON and XML formats.

If the map or process runs successfully, error messages are not displayed and the command prompt appears. For further confirmation that the run has completed without errors, review the log file.

If the return code is zero, it indicates successful execution. If it is non-zero, it indicates that the log may contain error messages.

To a run a map in JSON format, use the following syntax:

This runs the map using the settings exactly as they appear in the map runtime configuration file.

If the map RTC file is in the same directory you are running djengine from, then {fullPathAndFileNameOfMapRTC} can be only the file name of the map RTC and the full path is not required. The entry point is only the map file name. For example:

Map RTC file content:

If the map file is not in the same directory as the map RTC file, the RTC's entry point must be a relative path from the RTC file or absolute path. For example:

Map RTC file content:

To a run a process in JSON format, use the following syntax:

djengine -RC {fullPathAndFileNameOfProcessRTC}

This runs the process using the settings exactly as they appear in the process runtime configuration file.

If the process RTC file is in the same directory you are running djengine from, then {fullPathAndFileNameOfProcessRTC} can be only the file name of the process RTC and the full path is not required. The entry point is only the process file name. For example:

Process RTC file content:

If the process file is not in the same directory as the process RTC file, then {fullPathAndFileNameOfProcessRTC} is the full path of the process RTC file. The entry point is the a relative path to the rtc file or the absolute path. For example:

Process RTC file content:

To run multiple maps or processes (in JSON format) from the command line, the syntax is:

The map or the process RTC file can be inside or outside the djar file.

The djengine.exe must be in your path and DJLIB must be set to point to the engine's cosmos.ini file. The cosmos.ini must have a valid license file specified in the LicenseFile property. For more information, see Invoking Runtime Engine Using CLI.

For example:

The entry point must be:

Map RTC content:

Process RTC content:

To run a map (XML format) from the command line, the syntax is:

This runs the map using the settings exactly as they appear in map_file.tf.xml.

Enter the global options before the map or process file name on the command line:

To run a process (XML format) from the command line, the syntax is:

The process runs using the settings in the file process_file.ip.xml.

To change or add settings, use global options but you must specify that you are running a process first using the process execute –pe option:

For example:

You can run more than one map or process from a single command line. They are executed sequentially from left to right. Processes with options must be preceded by –pe. The options that is applied to each map or process must be specified immediately before that map or process. For example, the following command line indicates to run map_1 map and then called process_1 process:

Any options specified before the map_1 applies to the map and any option specified after ‑pe, but before process_1 applies to the process. Therefore, in the command line:

Items -option1 and -option2 apply to map_1, -option3 applies to process_1, and ‑option4 applies to map_2.

If you want to build complex collections of options and save these for repeated use, you can create a specification file. This is an ASCII text file containing as many global options as required plus the map or process file name. Specification files were previously known as optfiles.

To read a specification file, prefix the file path name with an ampersand @:

You can use additional global options with a specification file. Also, additional specification files may be used (usage is not restricted to a single specification file).

Parameter values containing spaces, special characters, and binary values must be used in quotation marks. If a value contains no special characters, then quotes is optional. Runtime Engine supports several quote conventions for representing data:

Single quotes indicate to use the values enclosed in single quotes literally. No escaping is used with single quotes. Single quotes (') are used around text values that include blanks, equal signs (=), or semicolons (;). For example:

Enclose multi-word values (containing spaces or special characters) in quotes, otherwise only the characters prior to the space or special character is used. For example, C:\Program Files\MyData is read as C:\Program unless the string is enclosed in quotes.

Double quotes enable escaping through the use of the backslash (\). For example, if the special character semicolon is a value that is in double quotes, it must be represented as backslash semicolon (\;) so that the Runtime Engine uses the actual value (;).

Sometimes values are already enclosed in double quotes. In this case, the backslash character must be used prior to the special characters. For example:

If the data includes control characters or binary values, double quotes (") must be used. When enclosed by double quotes, the backslash (\) can be used as the escape mechanism. This escaping convention is similar to the one used in the C language. When a backslash appears in the text, it indicates the start of an escape sequence. The following escape sequences are supported:

 

If an option file override string is enclosed in double quotes, then Runtime Engine uses backslash as an escape character. To avoid errors, you can do any of the following: