IBM InfoSphere Streams Version 4.1.0

Using the SPL application set launch configuration

You specify and save the SPL application set launch configuration within InfoSphere® Streams Studio.

About this task

To use an SPL application set launch configuration, first create one and then run it.
Tip: Specify your own names for launch configurations to find them again easily.

Procedure

  1. To create an SPL application set launch configuration, follow this procedure:
    1. Click the arrow next to the Debug icon This figure illustrates the Debug icon. or the Run icon This figure illustrates the Run icon. on the toolbar. From the menu, select Run Configurations or Debug Configurations.
    2. In the Run Configurations or Debug Configurations window, select SPL Application Set in the tree viewer on the left.
    3. Right-click and select New from the menu.
    4. For Project, select a valid and open SPL project. To see a list of SPL projects, click the Browse button next to the Project field.
    5. Use the Instance field as an instance identifier. Identify the instance on which to launch the application. To see a list of available instances, select the Browse button next to the Instances field. If you would like to launch the application onto the default instance, enter $default in the Instance field.
    6. You can set the Job Group field and Job Name name field to defaults for the configuration.
    7. From the Trace output level, select the tracing level for the application. Select $default to use the current setting in the application.
    8. The Submission Time Values table contains a set of submission time values for the applications that are contained by the selected application set project. Default values are completed, and values without defaults are displayed with an indication that a value is required. You must specify all submission time values. The dialog validates the entry fields, and you are given error messages when the entries do not create a valid launch configuration. When all values are entered and there are no more errors, click the Run or Debug icon on the launch configuration to do the actual launch. (In the Submission Time Values table, the Application Name indicates which application the submission time value applies to. In the case where the same application is included more than once in the application set, the application name has a counter [x] added to the end of the name to allow different values for each instance of the application to be specified.)
    9. The Always Prompt option controls whether you are prompted when this launch configuration is launched. If this option is enabled, you are presented with the launch configuration whenever this launch configuration is used. You can change the submission-time values or other options in this launch configuration before launching. If this option is disabled, you are prompted only if there are errors in your launch configuration. This option is enabled by default, if the launch configuration is generated by one of the launch shortcuts from Streams Studio.
    10. Click the Apply button to save your changes. Alternately, click the Revert button at any time during this procedure to return to the original starting point.
  2. To modify an SPL application set launch configuration, follow this procedure:
    1. Click the arrow next to the Debug icon This figure illustrates the Debug icon. or the Run icon This figure illustrates the Run icon. on the toolbar. From the menu, select Run Configurations or Debug Configurations.
    2. From the list of launch configurations, select the one you want to modify.
    3. Using the procedure in step 1, modify the launch configuration as needed.
    4. Click Apply to save the launch configuration. To save the modifications to a new launch configuration, you can enter a new name for the launch configuration, and then click Apply.
    5. Click Close when you are done.
  3. To run or debug using an SPL application set launch configuration, follow this procedure:
    1. Click the Debug icon This figure illustrates the Debug icon. or the Run icon This figure illustrates the Run icon. on the toolbar (not the arrow next to them). The most recent launch configuration is launched again.
    2. Clicking the arrow next to these icons shows a list of previously launched configurations at the top of the dialog. You can select one to launch that launch configuration.
    3. You can also launch from the launch configuration directly. Open a launch configuration, and click the Run or Debug button from the Launch Configuration window.
      Note: You can find additional information about the launch from Streams Studio Console in the Console view. The Streams Studio Console might be hidden in the Console view. To display the Streams Studio Console, use the Display Selected Console drop-down menu from Console view.