The engine_package tool assembles EPL files, JAR files and event files into a correlator deployment package (CDP). You can inject a CDP file into the correlator just as you inject an EPL file or a JAR file containing a JMon application. CDP files use a proprietary, non-plaintext format that treats files in a manner similar to the way a JAR file treats a collection of Java files. In addition, using a CDP file guarantees that all files, assuming no errors, are injected and are injected in the correct order. See Injecting code into a correlator for details about how the correlator handles an error in a file that is in a CDP. See also Deploying a correlator for alternative ways to deploy the correlator or for creating CDPs from Software AG Designer projects.

While the names of events, monitors, aggregates, and JAR files that are contained in a CDP file are visible to the correlator utilities engine_inspect, engine_manage, and engine_delete, the code that defines them is not.

The executable for this tool is located in the bin directory of the Apama installation. Running the tool in the Apama Command Prompt (see Setting up the environment using the Apama Command Prompt) ensures that the environment variables are set correctly.

To package files into a CDP file, run the following command:

When you run this command with the –h option, the usage message for this command is shown.

The engine_package tool creates a correlator deployment package (CDP). A CDP file contains one or more files. You specify the name of the CDP file to create as an argument to the -o option.

You can specify the files you want to include on the command line, or you can use the -m option and specify a manifest file that contains the names of the files. The manifest file is a text file; each line in the file specifies a relative or absolute path to a file. Files should be listed in the order in which you want them to be injected into the correlator.

You can also specify another CDP file to include in this package. The files from the original CDP are injected in the specified place in the order within this package.

The engine_package tool takes the following options:

The engine_package tool takes the following operands:

The engine_package tool returns the following exit values:

The following example describes how to create a correlator deployment package file with multiple monitor files and inject the CDP file into a running correlator.