Using Apama with Software AG Designer Version 10.5.3 May 2020 This document applies to Apama 10.5.3 and to all subsequent releases. Specifications contained herein are subject to change and these changes will be reported in subsequent release notes or new editions. Copyright © 2013-2020 Software AG, Darmstadt, Germany and/or Software AG USA, Inc., Reston, VA, USA, and/or its subsidiaries and/or its affiliates and/or their licensors. The name Software AG and all Software AG product names are either trademarks or registered trademarks of Software AG and/or Software AG USA Inc. and/or its subsidiaries and/or its affiliates and/or their licensors. Other company and product names mentioned herein may be trademarks of their respective owners. Detailed information on trademarks and patents owned by Software AG and/or its subsidiaries is located at http://softwareag.com/licenses/. Use of this software is subject to adherence to Software AG's licensing conditions and terms. These terms are part of the product documentation, located at http://softwareag.com/licenses/ and/or in the root installation directory of the licensed product(s). This software may include portions of third-party products. For third-party copyright notices, license terms, additional rights or restrictions, please refer to "License Texts, Copyright Notices and Disclaimers of Third Party Products". For certain specific third-party license restrictions, please refer to section E of the Legal Notices available under "License Terms and Conditions for Use of Software AG Products / Copyright and Trademark Notices of Software AG Products". These documents are part of the product documentation, located at http://softwareag.com/licenses/ and/or in the root installation directory of the licensed product(s). Document ID: PAM-DES-1053-20200525 Table of Contents About this Guide........................................................................................................................................7 Documentation roadmap..................................................................................................................8 Online Information and Support.....................................................................................................9 Data Protection.................................................................................................................................10 1 Overview of Developing Apama Applications...............................................................................11 Starting Software AG Designer......................................................................................................12 Demos and tutorials.........................................................................................................................12 The Apama interface........................................................................................................................13 The Apama Workbench perspective..............................................................................................13 The Apama Developer perspective................................................................................................14 The Apama Runtime perspective...................................................................................................14 About Apama projects.....................................................................................................................15 Building Apama projects.................................................................................................................20 Launching Apama projects.............................................................................................................20 2 Working with Projects..........................................................................................................................23 Creating Apama projects.................................................................................................................24 Adding resources to Apama projects............................................................................................25 Editing Apama files..........................................................................................................................48 Navigating in Apama files..............................................................................................................52 Building Apama projects.................................................................................................................54 Importing projects............................................................................................................................60 Importing adapter configurations..................................................................................................61 Setting up the environment before importing projects...............................................................61 Exporting project information........................................................................................................63 Deleting projects and resources......................................................................................................67 Adding the Apama nature to a project..........................................................................................68 Adding the Java nature to an Apama project...............................................................................68 Viewing all EPL objects in all projects...........................................................................................69 Internationalizing Apama applications.........................................................................................69 Checking the error log.....................................................................................................................70 Checking the Apama log file for Software AG Designer............................................................70 Specifying an adapter configuration in a launch configuration................................................70 Using Software AG Designer to configure adapters that use Universal Messaging..............71 3 Using Query Designer..........................................................................................................................75 Adding query files to projects........................................................................................................76 Steps for using Software AG Designer to implement queries...................................................77 Overview of creating a query in the Design tab..........................................................................78 Creating queries in Query Designer..............................................................................................78 Configuring query projects...........................................................................................................102 Exporting query deployment scripts...........................................................................................102 Using Apama with Software AG Designer 10.5.3 iii Table of Contents 4 Launching Projects..............................................................................................................................103 Running Apama projects...............................................................................................................104 Monitoring Apama applications..................................................................................................113 5 Debugging EPL Applications...........................................................................................................121 Adding breakpoints.......................................................................................................................122 Launching a debug session...........................................................................................................122 Debugging a remote application..................................................................................................123 Debug view for an EPL application.............................................................................................124 Breakpoints view for an EPL application...................................................................................125 Variables view for an EPL application........................................................................................125 Command-line debugger..............................................................................................................125 6 Debugging JMon Applications........................................................................................................127 Preparing the correlator for remote debugging.........................................................................128 Creating a debug run configuration............................................................................................129 Debug perspective..........................................................................................................................130 Example debug session..................................................................................................................131 Additional resources for Java debugging...................................................................................133 7 Profiling EPL Applications...............................................................................................................135