Home
Developing
Develop stream applications with the Streams Processing Language (SPL), Java, and Python.
Compiling stream applications
The Streams Processing Language (SPL) Compiler is called sc and is included with the Teracloud® Streams installation package. You compile SPL to create files to run on your Teracloud Streams instance.
SPL Compiler
The SPL compiler is an incremental compiler that generates artifacts needed to run your stream application. These artifacts include, for example, C++ code for several entities in your SPL program and an application bundle file.
Auto-generated makefiles
The SPL compiler can generate a sample makefile that can be used to easily manage compiler options and compile the application quickly from the command line.

Welcome
Learn about the core capabilities of Teracloud® Streams, its architecture, and key concepts.
Installing
Use this information to install, upgrade, and uninstall the Teracloud® Streams product.
Configuring
Create a basic or an enterprise domain which is a single point for configuring and managing common resources, security, and instances.
Administering
Administer the product by using the Teracloud® Streams graphical user interface, APIs, or the streamtool command-line interface.
Developing
Develop stream applications with the Streams Processing Language (SPL), Java, and Python.
- Development concepts
  Development of stream applications consists of several components such as operators, streams, tuples, Streams Processing Language, toolkits, and more.
- Writing stream applications
  Teracloud® Streams provides features and functions to help you write your applications to fulfill your business needs.
- Enabling Streams data exchange
  Teracloud® Streams provides a data exchange REST API for inserting and retrieving Streams job data. You can add one or more endpoint operators to your Streams application to enable Streams data exchange. Providing a standard REST interface for Streams data exchange eases the integration of Streams data with other data services and externally hosted applications.
- Compiling stream applications
  The Streams Processing Language (SPL) Compiler is called sc and is included with the Teracloud® Streams installation package. You compile SPL to create files to run on your Teracloud Streams instance.
  - SPL Compiler
    The SPL compiler is an incremental compiler that generates artifacts needed to run your stream application. These artifacts include, for example, C++ code for several entities in your SPL program and an application bundle file.
    - Application directory layout
      The application directory is the current working directory where you issue the sc command.
    - Auto-generated makefiles
      The SPL compiler can generate a sample makefile that can be used to easily manage compiler options and compile the application 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 colon ':' separated list of paths. Multiple appearances of the -t option are also supported.
    - Compiler-generated artifacts
      The SPL compiler generates artifacts that are needed to run your stream application.
  - Application development and deployment options
    Various application development and deployment options are provided by the SPL compiler, sc command.
  - Compiler intrinsic functions
    The SPL compiler provides these built-in functions.
  - Code generation features
    The SPL compiler is an incremental compiler, which generates C++ code.
  - Static and dynamic stream connections in SPL
    There are two types of stream connections in an SPL program that runs in the Teracloud® Streams system: static and dynamic. Static stream connections are required connections. Dynamic stream connections are optional connections.
  - Facade tuples
    The compiler provides facade tuples to avoid serialization processing.
  - SPL binary and character encoding
    SPL uses a platform independent binary and character encoding for serializing and deserializing data. This encoding is used for the FileSource, TCPSource, and UDPSource operators, as well as the FileSink, TCPSink, and UDPSink operators.
- Performance improvements for stream applications
  You can improve the processing of your stream application by following these guidelines and tips.
- Debugging stream applications
  The Streams Processing Language (SPL) Streams Debugger (sdb) provides a command line-based interactive debugger for debugging stream applications.
- Developing toolkits and operators
  You can create custom toolkits and operators for your applications.
Troubleshooting
Resolve problems with Teracloud® Streams using the troubleshooting tools provided with the product as well as the resources offered by Teracloud Support.
Reference
Find details on the SPL language, toolkits, APIs, commands, and more.
Glossary
Use this glossary to find terms and definitions for Teracloud® Streams.

Auto-generated makefiles

The SPL compiler can generate a sample makefile that can be used to easily manage compiler options and compile the application quickly from the command line.

The sc command generates a sample makefile when given the -m, --makefile-generation option. For example, you can issue the command sc -m -M my.sample::FooBar to generate the following makefile with the name Makefile:


.PHONY: all distributed clean 

SPLC_FLAGS ?= -a
SPLC = $(STREAMS_INSTALL)/bin/sc
SPL_CMD_ARGS ?= 
SPL_MAIN_COMPOSITE = my.sample::FooBar

all: distributed

distributed:
	$(SPLC) $(SPLC_FLAGS) -M $(SPL_MAIN_COMPOSITE) $(SPL_CMD_ARGS)

clean: 
	$(SPLC) $(SPLC_FLAGS) -C -M $(SPL_MAIN_COMPOSITE)

When you issue a make command in the application directory, this makefile is used to compile a stream application . The -a, --optimized-code-generation option turns on all code generation optimizations, and passes the highest optimization options to the C++ compiler for compiling the generated code.