TIBCO FTL R Programming Tutorial Software Release 5.3 October 2017

Size: px

Start display at page:

Download "TIBCO FTL R Programming Tutorial Software Release 5.3 October 2017"

Gilbert Henry
6 years ago
Views:

1 TIBCO FTL R Programming Tutorial Software Release 5.3 October 2017

2 1 Contents Introduction i 1 Getting Started with FTL Programming Set Up the Environment Start the Local Realm Server Build the Samples Run the Samples Understanding the Code ftlbasicpub.c ftlbasicsub.c Error Handling Running Without the Realm Server Adding Error Handling Understanding the Error Handling Code and Output Restart the Realm Server Working With Exceptions Messages and Fields FTL Field Types FTL API Functions to Set Field Values in a Message FTL API Functions to Get Field Values from a Message Working with Messages Introduction to Content Matchers Matcher Specification ftlbasicpub.c ftlbasicsub.c Build and Run the Samples Some Variations Exploring the Realm The Realm Server Web Interface The Realm Server Web API Defining an Application The Process Defining an Application Using the Realm Server Web Interface Defining an Application Using the Realm Server Web API... 45

3 2 8 Using Applications and Endpoints The Client Programs The Code Build and Run the Sample Applications Order Matters Clients Identifying Clients Properties The Properties API Property Names Using Properties Build and Run the Samples Identifying Clients Revisited Client Metrics Client-Realm Server Communication Run the Samples Examine the Metrics Introduction to Formats An Overview of Formats Format Types Defining a Format using the Realm Server Web Interface Defining a Format using the Realm Server Web API Using Formats Introduction Add the Format to an Application using the Realm Server Web Interface Add the Format to an Application Using the Realm Server Web API Modify the Samples Build and Run the Samples Examine the Client Metrics Summary Field References Introduction Field Reference API Modify the Samples Build and Run the Samples...125

4 i Introduction Welcome to FTL Programming! This tutorial will step you through using FTL to develop messaging applications through a series of lessons, with each addressing specific FTL functionality. The focus is on writing messaging applications using the C language, on 64-bit Linux or 64-bit OSX. Each lesson is designed to take from 60 to 90 minutes to complete. It is recommended that you complete the lessons in sequence, as each lesson builds upon the previous lessons. Throughout the tutorial, the term client program is used to refer to an application program using FTL for messaging. While the samples presented in this tutorial focus almost entirely on messaging capabilities, your own applications will contain business-specific code to generate or make use of the information being sent or received using FTL messaging. Typographic Conventions At various points throughout this tutorial, important concepts are pointed out. Each concept is called out using the format shown below: Concept 1. This is an example of an important concept or point. Output from commands appear in a monospaced font, enclosed in a box such as: An example of program output Commands to be entered appear in a similar manner, but in boldface: command arg1 arg2 For very long commands, a backslash (\) at the end of a line indicates the command is continued on the following lines: command "a long argument string" arg2 \ arg3 arg4 Enter the entire command on a single line, without the backslash. Listings (both code and output) are shown with line numbers on the left side for reference: 1 Line Line 3 Whenever overly-specific information appears in the output from a command, it is replaced with fill characters. This includes dates and times, version numbers, host names, IP addresses, and other items. In screenshots, this information is blurred.

5 ii Prerequisites In order to successfully complete this tutorial, you should: Be using 64-bit Linux or 64-bit OSX. Have available a C compiler appropriate to the platform. Have available the curl command-line utility. curl is an open-source utility found in most Linux distributions, and available as a binary or source download for most other platforms as well. Have installed the appropriate version of FTL. Have read through the TIBCO FTL R Concepts guide.

TIBCO FTL R Programming Tutorial Software Release 5.3 October 2017

TIBCO FTL R Programming Tutorial Software Release 5.3 October 2017 1 Contents Introduction i 1 Getting Started with FTL Programming 1 1.1 Set Up the Environment... 1 1.2 Start the Local Realm Server...