Ultra Messaging Streams

The Ultra Messaging Streams connector allows connection to the Streaming Edition of Informatica Ultra Messaging products.

You can either select any of the following Configuration Types:

• Configuration File

• Manual Configuration

Using Ultra Messaging Streams - Configuration File

1. When creating a new data table, select Ultra Messaging Streams from the Connect to Data dialog. The Ultra Messaging Connection dialog is displayed.

   

2. Select Configuration File in the Configuration Type drop-down list.

3. Browse to the Configuration File source.

4. For the Topic section, can either:

1. • just enter the Topic name if you are using the Specific Topic type, or

   • enter the Topic pattern if you are using the Perl-compatible Regular Expression (regex) Topic type then check the Wildcard box.

5. Select any of the following Message Types:

1. • Fix

   • XML

   • JSON

   • Text

   The dialog slightly changes to allow specification of the following:

2. 

1. 1. • Text Qualifier

   This drop-down list box specifies if fields are enclosed by text qualifiers, and if present to ignore any column delimiters within these text qualifiers.

   1. • Column Delimiter

   This drop-down list box specifies the column delimiter to be used when parsing the text file.

   1. • First Row Headings

      1. This checkbox determines if the first row should specify the retrieved column heading, and not to be used in data discovery.

6. Select the Decimal Separator. This specifies the character for decimal separation, when parsing a numeric value. By default this is “.”

7. Click Add Column.

8. Enter or select:

9. • Name

   • XPath/JsonPath/Fix Tag/Text Column Index (for example, price/@stock)

   • Type (Numeric, Text or Date/Time)

   • Date/Time format when the Data Type is Time

1. NOTE:

2. To parse and format times with higher than millisecond precision, the format string needs to end with a period followed by sequence of lower case Fs. There can be no additional characters following them.

3. For example: yyyy-MM-dd HH:mm:ss.ffffff

10. • Enabled (whether the message field should be processed)

    • Filter (Defined parameters that can be used as Filter)

NOTE: The Filter option is only available for JSON, Text, and XML Message types

Fix

JSON

Text

XML

You can also opt to click to delete a column in the list.

9. Select the ID Column.

10. You can select any of the following Time ID Columns:

    • No Time ID

Enter the Real-time limits. Default is 1000.

3. • Automatic Time ID

Enter the following:

1. 1. • Time ID Column Name

      • Time Window (seconds). Default is 0.

11. The schema of the source file is then defined by clicking the Generate Columns… button.

This populates the list of columns, with the data type found from inspecting the first ‘n’ rows of the file.

12. Click Add Column… to add more columns and specify their properties.

13. Click OK. The source data is returned in the Data Prep, with the fields displayed in the Data Source Preview.

 

Using Ultra Messaging Streams - Manual Configuration

1. When creating a new data table, select Ultra Messaging Streams from the Connect to Data dialog. The Ultra Messaging Connection dialog is displayed.

   

2. Select Manual Configuration in the Configuration Type drop-down list.

The dialog changes to display two tabs:

1. • Basic Settings

   

2. For the Topic Resolution, you can either select:

1. 1. • Multicast

   1. 1. • Enter the IP address for the Multicast Group.

         • Enter the Destination Port (a numeric value between 1 and 65535).

1. 1. • Unicast

      1. • Click Add then enter the Resolver Daemon IP Address and the Port. You can also select an added IP Address and click Remove to delete it in the list.

   2. • Enter the IP address or CIDR notation pattern matching network interface on the host on which the connector is running in the Local Network Interface box.

      • Select the Reception Mode: Streaming, Persistent and then enter the Persistent Session ID, or Ultra Load Balancing and then enter the ULB Receiver Type ID.

1. • Advance Settings

1. 1. • Add then enter the Scope, Attribute and Value. You can also select an added Advanced setting then click Remove to delete it in the list.

3. For the Topic section, can either:

1. • just enter the Topic name if you are using the Specific Topic type, or

   • enter the Topic pattern if you are using the Perl-compatible Regular Expression (regex) Topic type then check the Wildcard box.

4. Select any of the following message types:

1. • Fix

   • XML

   • JSON

   • Text

   The dialog slightly changes to allow specification of the following:

2. 

   1. • Text Qualifier

This drop-down list box specifies if fields are enclosed by text qualifiers, and if present to ignore any column delimiters within these text qualifiers.

1. 1. • Column Delimiter

This drop-down list box specifies the column delimiter to be used when parsing the text file.

1. 1. • First Row Headings

   1. This checkbox determines if the first row should specify the retrieved column heading, and not to be used in data discovery.

5. Select the Decimal Separator. This specifies the character for decimal separation, when parsing a numeric value. By default this is “.”

6. Click Add Column.

7. Enter or select:

1. • Name

   • XPath/JsonPath/Fix Tag/Text Column Index (for example, price/@stock)

   • Type (Numeric, Text or Date/Time)

   • Date Format

   • Enabled (whether the message field should be processed)

   • Filter (Defined parameters that can be used as Filter)

NOTE: The Filter option is only available for JSON, Text, and XML Message types

Fix

JSON

Text

XML

You can also opt to click to delete a column in the list.

8. Select the ID Column.

9. You can select any of the following Time ID Columns:

   • No Time ID

Enter the Real-time limits. Default is 1000.

3. • Automatic Time ID

Enter the following:

1. 1. • Time ID Column Name

   2. • Time Window (seconds). Default is 0.

10. The schema of the source file is then defined by clicking the Generate Columns… button.

This populates the list of columns, with the data type found from inspecting the first ‘n’ rows of the file.

11. Click Add Column… to add more columns and specify their properties.

12. Click OK. The source data is returned in the Data Prep, with the fields displayed in the Data Source Preview.