IBM Streams 4.3.0

Running SPL applications overview

To run an SPL application, you submit a job to IBM® Streams with Streams Studio or the streamtool submitjob command, and specify the application bundle file for the application.

Before you run an SPL application in your runtime environment, you can preview the job to see how the operators will be placed into PEs when the job is submitted.

You can preview the job from IBM Streams Studio or Streams Console or by running the streamtool submitjob command with the --preview option. When you preview the job, you can determine which submission-time configuration parameters need to be adjusted to optimize the job. For more information, see Previewing a job before you deploy it.

You can run SPL applications as stand-alone processes or submit them to a started instance. Alternatively, you can submit a job to IBM Streams by using the streamtool submitjob command.

Note: The application contains a single main composite. In the Project Explorer view, the main composites are available for launching, and you select a main composite's build configuration to launch.

Streams Studio provides the following methods for running an application:

For actions on Main composites (Launch and Launch active build configuration), see Launching application Main composites.
For actions on build configuration (Launch), see Launching a build configuration.
For SPL application launchers (Run and Debug), see Using the SPL application launch configuration.
For SPL application set launchers (Run), see Using the SPL application set launch configuration.
For actions on instance (Submit job), see Submitting an application bundle file to an instance.
For actions on application application bundle file (Submit job), see Submitting an application bundle file to an instance.

In these cases, you provide any needed information in a dialog and the application is either submitted to an instance or run in stand-alone mode.

When you submit applications to an instance, the instance owner must have access to the directory where the application is located. When you use a remote workspace, ensure that the access permissions are set so that the instance owner can access the directory on the remote workspace.

If the application has user-defined parallelism, parallel transformation occurs when you submit a job for the application. Parallel transformation converts the logical application into a physical application that can be deployed on the hardware.