IBM Streams 4.3.0

Editing SPL mixed-mode source

You create and edit the contents of a mixed-mode application with the SPL mixed-mode editor. A mixed-mode application contains Perl scripts that are embedded in it to generate an SPL application.

The SPL mixed-mode editor handles mixed-mode files (the files with the .splmm extension). The SPL mixed-mode editor automatically launches when you double-click an SPL mixed-mode file in your project.

The pane on the left of the SPL mixed-mode editor shows the content of the SPL mixed-mode application, while the Preview pane displays a preview of the generated SPL source. The Preview pane is refreshed whenever the SPL mixed-mode file is saved. The generated SPL source file is marked as derived. When you share projects in a team environment, derived resources are not shared.

Note: You can also open the generated SPL source file in the SPL Graphical Editor.

To help you develop an SPL mixed-mode application, the SPL mixed-mode editor provides the following support:

Multi-pane layout displays the SPL mixed-mode source and resulting SPL source side-by-side.
Linking support correlates the SPL mixed-mode source and the generated source easily.
Outline view support displays the content of the generated SPL source in a logical manner.
Configuring preprocessor arguments provides a quick link to edit preprocessor arguments.

Note: The SPL mixed-model editor supports viewing and editing files that are part of the workspace. Opening external files with the SPL mixed-mode editor results in errors and exceptions.

Note: You might see the "out-of-sync" label in the SPL pane of the SPL mixed-mode editor. This message is shown when the generated SPL source file is older than the SPL mixed-mode (.splmm) source file, indicating that the SPL file was not generated by the preprocessor successfully. When this message is displayed, the linking between the SPL mixed-mode pane and the SPL pane might not function correctly. In addition, linking between the Outline view and the SPL mixed-mode editor might not function correctly. To correct this problem, save the SPL mixed-mode file to trigger the preprocessor to run. You also need to make sure that you enter the correct preprocessor arguments, and the preprocessor completes without errors. The label is removed when the SPL file can be generated successfully.