IBM InfoSphere Streams Version 4.1.0

Submitting an application bundle file to an instance

To run an application in Streams Studio, submit a job in the Project Explorer view or the Streams Explorer view.

About this task

An application bundle file is generated by the compiler and can be used to submit the application to the InfoSphere® Streams runtime system. If you are working with an SPL application project in your workspace, you can find the application bundle file in the following directory:

<SPL Project>/<Output>/<Main Composite Name>/<Build Output Dir>/*.sab

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.

Procedure

In Streams Studio, you can submit an application bundle file to an instance in one of the following ways.

Submit an application bundle file from the Project Explorer view:
1. In the Project Explorer view, locate the application bundle file that you want to submit.
2. Right-click the application bundle file and select Submit Job from the menu.
3. In the Select Instance window, select the instance to which you would like to submit the application bundle file.
4. Click OK.
5. If submission values are required by the SPL application that is being submitted, you are prompted to enter the submission values.
Submitting jobs in the Streams Explorer view.

Results

When you submit an application bundle file, the InfoSphere Streams instance automatically transfers the file to the host where the job runs. When you compile the application, the necessary artifacts are included in the file. The file includes most toolkit artifacts and libraries that are needed to run the application. You can also specify dependent artifacts with the <sabFiles> tag in the info.xml file. By including these resources, your application can be relocated.

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

You can find information about a submitted job in the Streams Studio Console in the Console view. The hover help for a job in the Instance Graph view displays the submission time values for a job.