IBM InfoSphere Streams Version 4.1.1

Setting preferences for Streams Studio

IBM® InfoSphere® Streams Studio preferences control how you want the Streams Studio functions to operate. The preferences are part of the Eclipse workbench preferences and are used each time that you start to configure your workbench. For more information about the Eclipse preferences, see the Eclipse documentation and look under Workbench Basics > Reference > Preferences.

Procedure

To set preferences for Streams Studio:

  1. From the Streams Studio menu bar, click Window > Preferences.
  2. To set preferences for InfoSphere Streams, click InfoSphere Streams and select the preferences that you want to set. You can set the following preferences:
    Table 1. Streams Studio preferences
    Preference Description
    InfoSphere Streams Instance automatic refresh policy This preference controls how often the Streams Explorer, instance graph, and metrics are refreshed. Do not set below 3 seconds, which is the refresh rate of the run time for metrics.
    Graph Coloring Options This preference defines the colors that are used for the elements in the SPL Graphical Editor.
    Graph expansion depth This preference sets the default expansion of the graphs. Setting to 0 does not expand any jobs or composites.
    Important: If set to a value greater than 1, it can cause delays as graphs are expanded and rendered to deeper levels.
    Graph View Hovers This preference controls the amount and type of hover information that is displayed in the hover help for elements in the Instance Graph and Application Graph views. You can configure the hover delay to specify the time to delay in milliseconds before the hover help is displayed for an element.
    Graphical Editor This preference controls whether the Graphical Editor prompts you when it overwrites properties or reloading graphs with errors or file updates.
    Linking This preference controls whether selections in one view cause corresponding elements in other views to be selected. Set this preference if you want selections in one view to affect other views.
    Metrics This preference defines the maximum number of historical metric values that are displayed in the Metrics view. By default, you can view the previous 10 metric values in the Details view of the Metrics view. This preference also enables the user to reset all built-in metrics and custom metrics alert range settings.

    You can also set alert range threshold for several InfoSphere Streams metrics.

    • Connection
    • Consistent Region
    • Input Port
    • Output Port
    • PE
    • Resource

    Ranges are used to validate the metric values in the Metrics view and to generate an alert when the metric is outside the range. The ranges are signed long integers. The format is <minimum value>,<maximum value>. For unlimited minimum or maximum, enter ?. For example, if the default for Tuples processed (nTuplesProcessed) is set to 1, ?, an alert is generated if no tuples are processed. Any alert is displayed as yellow in the Health color scheme.

    SPL This preference displays SPL warnings if auto build is not active. Certain functions require up to date builds to work correctly. These warnings are displayed if auto build is not on to indicate that results might not be accurate.
    SPL > Formatter This preference sets the format options that control how SPL editors format code. The SPL Graphical Editor always applies this format when you save the .spl file.
    SPL > Refactoring This preference controls the settings for the SPL refactoring support.
    SPL > Syntax Coloring This preference sets the colors that are used for highlighting syntax elements.
    SPL > Templates The preference makes code templates available to the SPL and SPL mixed-mode editor. The templates are code snippets that are available as completions for the content assist function. You can edit existing templates, or add new templates, or remove templates that are no longer needed from this Preferences window. Templates that are enabled have a check mark next to them.
    To edit a template, select the template and click Edit.
    Tip: Create a central set of standard code templates that are shared by the developers on a project. These templates help ensure standard code and provides a good mechanism for defining common code snippets for reuse.
    For more information about code templates, see Setting up and using code templates.
    SPL Build This preference controls the following settings:
    • Toolkit lookup path(s)
      • Specifies how the toolkits are resolved.
    • Rebuild samples only when sample source is changed
      • By default toolkit sample projects are rebuilt when the containing toolkit is rebuilt. Set this preference to rebuild samples only when the sample source is changed.
    • Automatically clean projects which are copied to a remote host
      • Set this preference to do a clean build after you import a project with a remote context
    • Show environment variables in build console
      • Set this preference to display the configured environment variables in the SPL Build Console view every time a build configuration is built.
    SPL Build > Environment This preference controls the workspace default environment variables in effect when building toolkits and compiling SPL applications.
    SPLDOC This preference sets the parameters for the spl-make-doc command. This command generates documentation by interpreting the SPLDOC markup in the SPL code and model files in a toolkit.
    Streams Explorer This preference controls settings for the Streams Explorer view.
    • Domain Certificate

      Use the Certificate file field to specify the certificate file to use for authentication. If you specify a path to a PKCS #12 file that contains the certificate, you are prompted for the PKCS #12 password. This password is stored in Eclipse's Secure Storage.

  3. To set preferences for remote systems, expand Remote Systems.
    Table 2. Remote system preferences Streams Studio
    Preference Description
    Remote Reconciler This preference controls the general preferences for the Remote Reconciler, such as prompting for remote deletion of a resource and deleting a remote resource when you delete it locally.
    Unix Remote Projects This preference controls the files that are synchronized by the Remote Reconciler. Files that match the patterns in the Ignore File Patterns area are not synchronized.