Run Deliveries

You can run a delivery on runtimes from the command line or from Semarchy xDI Production Analytics.

Refer to Manage Runtime Deliveries to learn how to start deliveries from Semarchy xDI Production Analytics

Run a Delivery from the Command Line

Two scripts are available in the runtime installation folder to run deliveries:

  1.|bat: The start delivery script creates a new Java process and runs the delivery as a standalone process without the need of a running runtime.

  2.|bat: This script allows you to connect to a runtime and runs the execute delivery command to run that delivery. See Execute Delivery for more information about this command.

To optimize resource consumption, preferably use the startcommand script, as all the deliveries will be executed in an existing runtime, saving the overhead of a new Java process.

Start Delivery Script

The start delivery script has two main syntaxes to start a delivery by its name or by its file name.

./ -name [DELIVERY_NAME]
./ -file [DELIVERY_FILE]

The start delivery script is synchronous, and has the following return codes:

  • For Window:

    • 0: The session was completed successfully.

    • -1: The session did not complete successfully.

    • -2: The session was stopped by a user.

  • For Linux/Unix/macOS:

    • 0: The session was completed successfully.

    • 255: The session did not complete successfully.

    • -2: The session was stopped by a user.

      See the following article for more information about return codes for Unix.


You can pass variables values to the delivery using the following syntax:

./ -name [DELIVERY_NAME] \
    -var [VARPATH1] [VALUE1]
    -var [VARPATHN] [VALUEN]

For example:

./ -name myDelivery \
    -var ~/var1 value1


When working with multi-configuration deliveries, you can pass the configuration to use for the execution using the following syntax:

./ -name [DELIVERY_NAME] \
    -configuration [CONFIGURATION_NAME]

Session Name

By default, the session name is the same as the delivery name. You can set a specific name for the session using the

./ -name [DELIVERY_NAME] \
    -sessionName [SESSION_NAME]


If your runtime is configured to use a deliveries repository, you can provide the repository name. The delivery is searched in the specified repository.

./ -name [DELIVERY_NAME] \
    -repository [REPOSITORY_NAME]

Return Code Path

You can the path of a session variable that contains the code the script returns when the execution completes.

./ -name [DELIVERY_NAME] \
    -returnCodePath [VARIABLE_NAME]
Example 1. Return the session duration as the return code.
./ -name MyDelivery \
    -returnCodePath CORE_DURATION
Example 2. Return a specific variable value as the return code.
./ -name MyDelivery \
    -returnCodePath  ~/MyProcess/MyVariable

Log Level

You can specify the level of logging used for the session.

./ -name [DELIVERY_NAME] \
    -loglevel [LOG_LEVEL]

See log level for more details about the various log level values.