ONE Desktop ONE DQG ONE MDM ONE RDM ONE Runtime Server
latest (15.1.0) 14.5.x 13.9.x 13.8.x 13.7.x 13.6.x 13.5.0 13.4.x 13.3.x 13.2.x
User Community Service Desk Downloads
If you can't find the product or version you're looking for, visit support.ataccama.com/downloads

Run DQC Process

Run DQ Process icon

Runs a ONE plan or component in a new Java process: the task waits until the process finishes. This allows you to run the ONE plan within the new JVM while using a specific Java version and runtime parameters (such as memory settings).

The plan is validated before the run: if the plan is invalid, the task fails with FINISHED_FAILURE state and log details into a log. Logs of the process are stored in the task resources folder. The STDOUT log also contains a copy of the process command.

This task requires the Ataccama Home system or user environment variable to be correctly set, otherwise the task might fail. Make sure that ATACCAMA_HOME is set for the user running the online server (especially when the server is started as a Windows service; see Set ATACCAMA_HOME on Linux for Linux instructions).

Properties

Name Type Description Expression support

Plan File

mandatory

Relative (to the workflow file) or absolute path to the plan or component to run.

semi-expression

Parallelism Level

mandatory

Parallelism level for a ONE plan execution. Default value: 1.

none

Parameters

optional

Set of parameters to pass to the ONE component in the format specified in Parameters properties.

none

Path Variables

optional

Set of local path variables to use with the current task in the format specified in Path variables properties.

none

Java Dir

optional

Defines the path of the Java JRE or JDK directory to use. The defined directory must contain either bin/java or bin/java.exe executable.

If this attribute is not specified, the JRE is autodetected using Java’s java.home property of the current Java process. If this value cannot be resolved, the OS property JAVA_HOME is used instead. If none of the properties is defined, the task fails during validation.

none

Java Options

optional

Space-separated JVM Configuration to pass to the Java Virtual Machine.

none

Parameters properties

Name Type Description expression support

Name

mandatory

Name of the variable.

none

Expression

mandatory

Expression evaluating the value of the parameter. The expression must evaluate to a STRING data type value, otherwise an error is reported.

expression

Path variables properties

Name Type Description Expression support

Name

mandatory

Name of the path variable.

none

Value

mandatory

Value of the path variable.

text semi-expression

Predefined variables

None

Example

Sample
<executable class="com.ataccama.adt.task.exec.EwfDqcAsProcessTask">
    <planFile>one/param_component/myComponent.comp</planFile>
    <parameters>
        <parameter name="inputFile" expression="comp_inputFile"/>
        <parameter name="outputFile" expression="comp_outputFile"/>
    </parameters>
    <pathVariables>
          <pathVariable name="myPathVariable" value="d:/var/server-root/workflows/one-data/" />
    </pathVariables>
    <javaDir>c:/opt/java/jdk5_32</javaDir>
    <javaOptions>-Xms128m -Xmx512M</javaOptions>
</executable>

Set ATACCAMA_HOME on Linux

The Run DQC Process task is a separate Java task, so it does not inherit the ATACCAMA_HOME variable. To set ATACCAMA_HOME for Run DQC Process on Linux, you have to set it as a global variable. Make sure the variable is set by the user running the online server.

To set the global variable:

  1. Navigate to the root/home, for example, /home/<user_name>.

  2. Open the hidden file .bash_profile and add the following parameter:

    export ATACCAMA_HOME=/one20/app/server/runtime

    Make sure the parameter points to the correct distribution.

  3. Stop the server.

  4. Log out from your Linux account and log back in.

  5. Start the server.

Was this page useful?