Full Name | Short Name | Argument | Description |
|---|---|---|---|
-Help | -h | - | Displays a list of all available commands, including their short names, argument details, and brief descriptions. Additionally, it shows version, copyright, and registration information for the engine. Note: Do not use this option with any other option. |
-Repeat_Count | -r | Number | Sets the number of times the map or process will be run. If set to zero, then the file is run continuously. |
-Verbose | -v | - | Displays informational messages during execution. |
-Version | -V | - | Displays the version number and some other information of the installed Runtime Engine. Note: Do not use this option with any other option. |
-Base | -b | Filename | Specify either the directory containing the djar or the specific djar file that includes the entry point referenced by the runtime configuration. • If a directory is provided, the djar name is determined based on the package name and version specified in the runtime configuration. • This option is required if the djar is not in the same directory as the runtime configuration or if the djar name differs from what the engine expects based on the package name and version. When a djar is created in DataConnect, it includes an internal rtc. The -b and -RC options allow referencing an external rtc outside of the djar. Example of running a djar: djengine -RC C:\MyIntegrations\MyDjar-1.0.djar\SampleProcess-1.0\SampleProcess.process.rtc The above example is providing the rtc referenced INSIDE the djar. Example of running a djar and referencing an external rtc: djengine -b C:\MyIntegrations\MyDjar-1.0.djar -RC C:\Users\Temp\SampleProcess.process.rtc -b is used to specify the djar and -RC is used to reference the external rtc. |
-RuntimeConfig | -RC | Filename | Used to specify the runtime configuration file that must be used. The runtime configuration file contains all the necessary configurations, parameters, or settings that are requied to run a map or a process. This file also contains log configurations like, logLevel and logfileName which are required for log file generation. Example: djengine -cl -RC MyProcess.process.rtc |
-Source_List | -ss | - | Displays the available source connections that can be used as source file types. |
-Target_List | -ts | - | Displays the available target connections that can be used as target file types. |
-Initialization_Info | -i | Filename | Sets the location of the initialization file. It is recommended to use the default cosmos.ini file. Alternatively, you can create a custom initialization file based on the default cosmos.ini. Ensure there are no errors in its format or content. For details on cosmos.ini settings, see Cosmos.ini Settings. |
-Clear_Logfile | -cl | - | Clears the log file before each run. If multiple engine steps (processes or maps) are involved, the log file is cleared at each step. If a repeat count is specified, only the log file from the last repetition is retained. |
-Single_Thread | -ot | - | (Windows only) Force single threaded mode. |
-Debug | -d | - | Displays additional information about the steps that are run. |
-Trace | -t | - | Trace the map execution. |
-Define_Macro | -D | String | Sets a macro value that can be used in the map or process. Instead of specifying directory paths in a map, Macros are set using the following syntax: -Define_Macro NAME=filepath where: • NAME: Name of the macro set up in Map Editor • filepath: Value for the macro. Note: You can use macros in Connection Strings for ChangeSource, ChangeTarget, SDK interfaces, and the engine Command Line Interface (CLI) for portability. For information about setting up macros in Map Editor, see Managing Macro Sets and Macros. |
-Http_Monitor | -mh | Number | Sets a simple progress monitor on the port specified using HTTP. To monitor the progress, open a web browser and enter the HTTP URL using the name of the local host and the port number provided for the Runtime Engine. For example, if the host name is engine.abcd.com and the port number is 100, the URL is: http://engine.abcd.com:100 Note: The URL is only valid while the engine is running. |
-Macro_File | -mf | Filename | Specifies the location of an XML or JSON file that has been created to store the macros used by the engine. |
-Profile | -P | - | Turns on profiling but does not create the Execution Profiles folder within the related project folder. If this folder does not exist, the map runs but the profile.out file is not generated or written. Hence, use -PF with -P and specify the location where the profile.out file must be generated or written. The profile.out file is written to disk in the specified location. For example: djengine -P -PF C:\myworkspace\myproject\profile.out -RC C:\myworkspace\myproject\MyMap.map.rtc |
-Profile_To_File | -PF | String | Turns on profiling. The specified argument is the path name for the profiling output file. |
-Profile_Filter | -PM | Number | Mask of events that will be profiled. |