IBM Streams 4.2

Submitting jobs

To start a streams processing application in IBM® Streams, you submit a job.

Before you begin

You must have add authority for the appropriate jobgroup_name instance object. For more information, see User authorization for IBM Streams.

About this task

You can submit jobs from the following interfaces:
  • Streams Studio. For more information, see Running SPL applications.
  • Streams Console from an application dashboard or from the management dashboard:
    • To submit a job from an application dashboard, click Submit Job from the main toolbar.
    • To submit a job from the management dashboard, click Instances and then select the instance where you want to deploy the application. Then click Submit Job.

    For more information on accessing Streams Console, see Opening the Streams Console.

  • The interactive streamtool interface by running the streamtool submitjob command.
Additionally, you can control how jobs are deployed by specifying submission-time configuration parameters. For more information, see Configuring submission-time parameters to optimize job deployment
  • Previewing a job before you deploy it
    Before you deploy an application to your run time environment, you can run a preview to see how the job will be deployed.
  • Configuring submission-time parameters to optimize job deployment
    You can specify submission-time parameters for a job before you deploy a streams processing application to your environment. Typically, configuring the parameters enables you to improve the run-time performance of the application without recompiling it.
  • Running applications in stand-alone and distributed execution environments
    You can submit and run your jobs in stand-alone or distributed execution environments. In a stand-alone execution environment, an application is a binary that you can launch directly, that is, it does not run on the IBM Streams instance. In a distributed execution environment, an application is run when you submit an application bundle file file to a IBM Streams instance.
  • Processing element placement
    For each submitted job, the application manager service chooses a resource for each processing element in accordance with any requirements specified by the streams processing application or by your job configuration overlays.

Results

Jobs remain in the system until they are canceled or the instance is stopped. A submitted job consists of one or more processing elements (PEs). The PEs are placed on one or more of the application hosts for the instance.

What to do next

Use the Streams Console or the streamtool lsjobs command to monitor the status of the job.
Parent topic: Administering jobs
Related reference:
streamtool submitjob