IBM Streams 4.2

Compiling streams processing applications

The SPL compiler is an incremental compiler that generates artifacts needed to run your streams processing application. These artifacts include, for example, C++ code for several entities in your SPL program and an application bundle file.

About this task

The SPL compiler analyzes changes in a streams processing application. The compiler then generates and compiles only code for the modified portions of the application. The SPL compiler must be run on a host that was installed using the main installation package, that is, a host that has all IBM® Streams product files.

To compile an application, the -M, --main-composite option is used to tell the sc command about the main composite of the application. The main composite name is a fully qualified name. For instance, if the name of the main composite is WordCount and its namespace is my.sample, then the sc command is started as follows:

        sc -M  my.sample::WordCount

The toolkit that defines the composite operator my.sample::WordCount must be in the SPL path of the SPL compiler.

  • Application directory layout
    The application directory is where the compilation happens, that is, it is the current working directory where you issue the sc compiler command.
  • Auto-generated makefiles
    You can use a makefile to easily manage compiler options and to compile streams processing applications quickly from the command line.
  • Working with multiple applications
    Different main composites can be compiled under the same application directory, by customizing the output directory for the individual invocations of the SPL compiler.
  • Working with toolkits paths
    The sc command searches for toolkits by using the SPL path. The SPL path can be specified by using the -t, --spl-path option with a : separated list of paths. Multiple appearances of the -t option are also supported.
Parent topic: Compiling streams processing applications