FactoryTalk Transaction Manager

Student Manual
Version: September 15, 2016
For Rockwell and Partner Use Only!

Copyright 2015 Rockwell Automation, Inc.

This page intentionally left blank

2 of 74

Table of Contents
FactoryTalk Transaction Manager ................................................................................................................ 4
Introduction to FactoryTalk Transaction Manager ................................................................................... 10
Configurations ...................................................................................................................................... 10
Configurations that use online edits ..................................................................................................... 10
Monitor configurations.......................................................................................................................... 11
Control connectors ............................................................................................................................... 12
Enterprise database connectors .......................................................................................................... 13
Enterprise application connectors ........................................................................................................ 14
Transactions ........................................................................................................................................ 14
Lab 1: Creating the FTTM_Training Database ........................................................................................ 19
Part A - Creating a Database Using SQL Server Management Studio ............................................... 19
Lab 2: Creating a FactoryTalk Transaction Manager (FTTM) Edit Enable Application ......................... 23
Lab 3: Editing a Running FactoryTalk Transaction Manager Edit Enable Application ........................... 41
Lab 4: Bidirectional Transaction with Bind Transaction Result Option .................................................. 46
Part A - Adding an FTTM Data Object ................................................................................................. 46
Part B - Adding FTTM Data Points to a Running Configuration .......................................................... 48
Part C - Adding a FTTM Transaction to a Running Configuration ....................................................... 50
Lab 5: Discussion of FTTM Errors and Data Buffering/Loss .................................................................. 56
Part A - Setting Up the VM-Image Desktop ......................................................................................... 56
Part B - Enterprise Connector Failure .................................................................................................. 57
Part C - Database Connection Failure ................................................................................................. 60
Lab 6: Using FTTM Stored Procedures .................................................................................................. 65
Part A - Adding a FTTM Data Object ................................................................................................... 65
Part B - Adding the Machine Setup Data Points .................................................................................. 66
Part C - Adding the Machine Setup Transaction ................................................................................. 68

3 of 74

FactoryTalk Transaction Manager

What you will learn:

Configuring a FactoryTalk enabled application

Selecting the connectors
Configuring the connectors
Adding FactoryTalk data points
Creating a data object
Creating a unidirectional transaction
Running and monitoring a FactoryTalk Transaction Manager (FTTM) application
Using stored procedures in a FTTM transaction

4 of 74

5 of 74

6 of 74

7 of 74

8 of 74

9 of 74

Introduction to FactoryTalk Transaction Manager

Configurations
A FactoryTalk Transaction Manager configuration consists of a set of user-defined transactions that
use control and enterprise connector services to perform required tasks. A configuration contains
information that is crucial to the successful exchange of data between an industrial control system,
FactoryTalk Transaction Manager, and an enterprise database system. You may create numerous
configurations in FactoryTalk Transaction Manager, but the Transaction Manager service can run
only one configuration at a time. Therefore, all the transactions required to implement an application
must be included in a single configuration.
You can create a FactoryTalk Transaction Manager configuration by using the Configuration
Checklist, which is designed to easily walk you through the steps required to create a configuration.
Refer to the Configuration Checklist topic in the online help for further details.
Tip: FactoryTalk Transaction Manager also has the ability to change data points and
transactions in a configuration while it is running. This type of configuration is a
configuration that uses online edits. For more information, see Configurations that use
online edits.

Configurations that use online edits

You can make changes to data points and transactions in configurations that use online edits while
they are running. These changes are referred to as pending edits. In a configuration that use online
edits, the Transaction Control Manager is used instead of the Transaction Manager service.
Transaction Control Manager is a service similar to the Transaction Manager, but with the additional
functionality of the FactoryTalk Live Data control connector embedded in it. In a configuration that use
online edits, the Transaction Control Manager replaces the separate Transaction Manager and
control connector services.
Keep in mind the following guidelines while you are working with configurations that use online edits.
In a running configuration that uses online edits, you can:

create new and modify existing data points

create new and modify existing transactions
enable and disable transactions
save and assemble pending edits
view differences between current transaction definitions and transactions with pending edits

In a running configuration that uses online edits, you cannot:

modify configuration properties

modify error logging properties
add new, modify, or delete existing enterprise connectors
modify enterprise or control connector properties
use any control connector except FactoryTalk Live Data

Tip: Additional FactoryTalk-related overview, task, and definition information can be found
in the online help for the FactoryTalk Administration Console.

10 of 74

modify database connection properties

add new, modify, or delete existing data objects
modify a starting or stopping event definition
change data point names or modes
delete data points
delete transactions (although you can disable them)

If you have a running configuration with pending edits and then stop it, you cannot make any further
changes to those items with pending edits until you cancel or assemble the pending edits.

Monitor configurations
You can monitor transactions as they are executed while your configuration runs. Click Transaction
Monitor on the toolbar for a summary of cumulative activity by transaction. The Monitor automatically
updates, but you can manually update it by clicking on a column heading.
Tip: Click any column heading except Total to resort the listed transactions.
The following columns display in the Transaction Monitor view:

Total --Total number of transactions that have been triggered.

Passed -- The number of completed transactions without errors.
Failed -- The number of failed transaction.
% Passed -- Passed/Total * 100
Cached -- The number of transactions currently in Cached Transaction files.
Database Passed -- The number of transactions that have been successfully executed by
the database.
Database Failed --The number of transactions that have experienced a database error.
Pending -- The number of transactions that have been started but not completed.

11 of 74

Control connectors
The control connector services in the FactoryTalk Transaction Manager facilitate the exchange of
data between the Transaction Manager service and the industrial control systems, such as
programmable logic controllers (PLC) or HMI servers. The Transaction Manager service
communicates with the data server (DDE or OPC) using one of the following control connectors.
FactoryTalk Live Data
FactoryTalk Transaction Manager uses FactoryTalk Live Data to communicate with FactoryTalk Live
Data servers, such as RSLinx and FactoryTalk View SE. FactoryTalk Transaction Manager connects
to the FactoryTalk Directory, which allows FactoryTalk Transaction Manager to browse the available
data items within a FactoryTalk application. Rockwell Automation, Inc. recommends using the
FactoryTalk Live Data control connector for most user applications.
Dynamic Data Exchange (DDE)
The DDE control connector service is provided for legacy connections to DDE servers or to provide
functionality that is not supported by the OPC specification.
RSLinx Classic OPC
The RSLinx Classic control connector service is the preferred method to use when browsing for data
tags that reside in Allen-Bradley Programmable Logic Controllers (PLC), except for the ControlLogix
processors. You should use Generic OPC or FactoryTalk Live Data control connectors with
ControlLogix processors.
RSView32
The RSView32 control connector service is used to interface with tags provided by RSView32
applications. The RSView32 control connector must be installed on the same computer on which the
RSView32 project is running.
Generic OPC
The Generic OPC control connector service is used to interface with items provided by any OPC
server that conforms to OPC interface specifications.
Tips: Please keep the following in mind:

These control connectors are Windows 2000/2003/XP services that support bidirectional
transactions.
If the configuration uses online edits, the Transaction Control Manager service communicates
only with the FactoryTalk Live Data connector.

12 of 74

Enterprise database connectors

The Connector Definition dialog allows you to define the following enterprise database connectors:
ODBC connectors

The ODBC enterprise database connector allows you to interface with virtually any ODBCcompliant database including Microsoft Access, MS SQL Server 6.5 or later, DB2 or Sybase.
When you create an ODBC database connection, you must enter a valid system data source
name (DSN) for the ODBC server. A system DSN is available to all users and Windows
2000/2003/XP services while a user DSN is available only to the user who configured it. The
ODBC enterprise connector requires a system DSN to connect to an ODBC data source.
If the FactoryTalk Transaction Manager user interface resides on a computer that is remote
from the computer(s) containing the enterprise connector(s), you must provide a connection
for the target database on both computers and they must have the same name. This
connectivity is necessary so the enterprise connector can send data to the database.

OLE DB connectors

The Microsoft OLE DB enterprise database connector should only be used for interfacing with
Microsoft SQL Server 2005 (Service Pack 1) Standard. Microsoft OLE DB allows you to
browse a SQL Server 2005 database without a data source name (DSN) and is the preferred
method of connection.

OCI connectors

The Oracle Call Interface (OCI) enterprise database connector allows you to connect to
database objects from an Oracle server. If you are using Oracle OCI in FactoryTalk
Transaction Manager, you need to install SQL*NET 2.3x or later, Net8, or Oracle Net
services (all from Oracle) locally. You can then connect to an Oracle database versions 8.1
through 10g R2.
Tip: When using an OCI enterprise connector, ensure that you have local administrator
privileges on your computer. Either add the OCI enterprise connector user to the local
administrators group in Windows, or change the user of the OCI enterprise connector to an
existing user that has administrator privileges.

Once you have defined an enterprise database connector, you can create data objects in
FactoryTalk Transaction Manager that point to a table or stored procedure. Then, after you have
defined the data objects, you can use them in FactoryTalk Transaction Manager transactions.
Tip: In a running configuration that uses online edits, you cannot add new, modify, or
delete existing enterprise connectors.

13 of 74

Enterprise application connectors

The Connector Definition dialog allows you to define the following enterprise application connectors:
Microsoft COM+
The Microsoft COM+ enterprise application connector allows you to interface with Microsoft COM+
application components. These components must be integrated into a Windows 2000/2003/XP COM+
environment.
Time-series data compression
This Time-series data compression enterprise application connector compresses data from the
control system via a lossless algorithm to conserve space. This connector can only be used by and
configured by FactoryTalk Historian Classic.
FactoryTalk Metrics
The FactoryTalk Metrics enterprise application connector is used only with FactoryTalk Metrics and
can be configured only through the Service Console. The connector stores data in the Information
Services Manager.

You can create new, modify existing, and delete unwanted enterprise application connectors. In
addition, you can test a connector and edit it before sending it to the database. You can create a
FactoryTalk Transaction Manager data object from the enterprise applications objects.
Tip: In a running configuration that uses online edits, you cannot add new, modify, or
delete existing enterprise connectors.

Transactions
Unidirectional transactions
Unidirectional transactions in FactoryTalk Transaction Manager use information from the control
system to add records to a database table, update the contents of existing records, or call stored
procedures that do not contain output parameters.
Unidirectional transactions are commonly used to log production data to a database, including:

Performance monitoring
Quality analysis sampling
Real-time production information collecting
Material consumption tracking
Product tracking
End of job/batch/shift reporting

Unidirectional transactions are the simplest transaction type. They can be used to perform database
Insert or Update commands. They can also be used to perform simple stored procedures, provided
no output parameters or return codes exist. In most applications, unidirectional transactions account
for the majority of transaction volume. Data may be collected frequently from a large number of data
points.

14 of 74

Bidirectional transactions
Bidirectional transactions in FactoryTalk Transaction Manager take data from the control system and
call a stored procedure that exercises some logic, and then provides the software with output values
that can be written back to the control system. You can also set up bidirectional transactions so that
data is not sent to a database, but only downloaded from a database to a control system.
This transaction type is the most powerful because it allows transactions to interact with a database
stored procedure or Microsoft COM+ method. This capability makes it possible for FactoryTalk
Transaction Manager to perform functions that were previously possible only through custom
application development. Applications that are possible with this type of transaction include:

Product parameter downloading

Dynamic routing
Dynamic production scheduling
Controller centralizing
Production floor interacting
Automated storage and retrieval warehousing

A bidirectional transaction with input/output bindings implements a data transfer from the enterprise
system and sends it to the control system, binding database stored procedure input and output
parameters. The control system data serves as input to a stored procedure. The results of a stored
procedure can be written back to data points in the control system (enabling the creation of
sophisticated transactions that allow a high degree of interaction between a database system and the
factory floor).
Transactions with output bindings must use the Real Time Thread Storage option on the Transaction
Definition dialog because the procedure or method must complete before data can be returned to the
Transaction Manager service or Transaction Control Manager service. FactoryTalk Transaction
Manager allows you to specify the number of database threads used by a connector to improve
performance.
When creating a transaction using input/output bindings, parameters are bound in the same manner
as columns in a table. The input data points are collected, any expressions are evaluated, and the
procedure is called. If the procedure succeeds, any output parameters are written to the control
system.

Transactions with input/output bindings use the following types of parameters:

Input parameters
Input parameters for a stored procedure must have a binding (a data point, expression, or a null).
Select a data object parameter, right-click and select either Bind Data Point or Bind Null Value from
the menu. A transaction must have all input parameters bound to it before it can be enabled. Binding
a null value to an input eliminates the need to gather a value from the database.
Output parameters
Output parameters do not require a binding. The results of the bound value display under the Bound
Value column. If an output parameter is not bound or is bound to a null, the value is ignored and this
column is empty. A procedure must succeed before output parameters can be returned to the control
system. Normally, you bind outputs to a data point in the control system; upon the successful
completion of a transaction, a value is written from the stored procedure to the datapoint.

15 of 74

Input/output parameters
Input/output parameters are handled as a single binding unless they are separated using the
Separate Input/output option. This option permits separate data points to be bound to the same
procedure parameter. This implies that the address from which the input parameter is derived is
different from the address to which the output parameter is written. This also implies that if an
input/output parameter is used only for output, then the input portion can be bound to a null value.
Leaving an input/output parameter bound to a single data point causes the value to be read prior to
executing the procedure and the output value to be written upon completion of the transaction.
The Microsoft SQL Server RETURN_CODE contains data that can be bound as an output to a
stored procedure. This value is only available if the procedure executes successfully. A successful
return code does not guarantee a successful transaction as the transaction is not yet complete.
Unidirectional or bidirectional transactions with transaction result bindings
A bidirectional or unidirectional transaction with a transaction result binding implements a data value
that is written back to the control system; that data value allows you to determine if the transaction
completed successfully. The control system can then take appropriate action based on the success or
failure of the transaction. For example, consider a high liability manufacturing environment where a
verifiable quality record is a requirement for each product produced. At various steps in the
manufacturing process, a transaction may send a test result to be stored in a central database. If that
test result is not recorded successfully, the part on the production line may become worthless.
The Transaction Result, which notifies the control system that the transaction was successful, is sent
variably based on the type of transaction. In a real-time transaction (where data flows straight to the
database), the Transaction Result is sent upon data being successfully logged into the database.
However in a cached transaction, where a cache is used to ensure data integrity, the Transaction
Result is sent once data has been logged into the cache, and not necessarily into the database. The
Transaction Result is used to confirm that the test result was recorded. If the Transaction Result
indicates the test result was not recorded, the control system can respond appropriately by alerting an
operator, changing the part's routing, or retrying the transaction. Some examples may include:

Validated data logging

Closed-loop quality tracking

The Transaction Result Binding option allows a transaction to return a Transaction Result code to the
control system. To enable the Transaction Result Binding option, select the Bind Transaction Result
check box on the Transaction Definition dialog, then select a data point to accept the Transaction
Result code. The control system should take appropriate action depending upon the result of the
transaction.
The Transaction Result code is a 16-bit integer. Bit 0 is the least significant, Bit 15 is the most
significant. The Transaction Result code consists of:
Bit 0 - Done bit
A 1 indicates the transaction has completed, a 0 indicates that it has not completed. No
information is given as to whether the transaction was successful or unsuccessful.
Bit 1 - Error bit
A 1 indicates there was an error, a 0 indicates no error.
Bits 2 through 15 - Error code

16 of 74

If Bit 1 contains a 1, these bits contain the error code. Otherwise, these bits are zeros. If you
chose to use the Transaction Result code, you can run the FactoryTalk Transaction Manager
error utility by selecting Start > Programs > Rockwell Software > FactoryTalk Transaction
Manager > Error Messages. This eliminates the need to decode the integer to determine the
error code.
To convert the error code to a proper error number:
1. Select Start > Programs > Rockwell Software > FactoryTalk Transaction Manager > Error
Messages. The FactoryTalk Transaction Manager Error Messages dialog appears.
2. Enter the Transaction Result code number (binary or decimal).
3. Click the Bind Transaction Result Error radio button.
4. Click Apply.
For example, a transaction result code of 0000000000000001 (binary) or 1 (decimal) indicates that
the transaction has completed without errors.
If the Transaction Result code is: 0000010111101111 (1519 decimal)
Then the FactoryTalk Transaction Manager error code is: 33147
Verify transactions
It is important to verify transactions so that FactoryTalk Transaction Manager can check for
conflicts between the defined data points and the corresponding data object columns. Click Verify on
the Transaction Definition dialog. The Verify Transaction dialog displays.
You may see the following types of information on the Verify Transaction dialog:
errors
Fatal errors that must be corrected before the transaction can be enabled.
warnings
Non-fatal errors that may cause unexpected behavior.
informational
Errors that provide advice about common parameter settings and possible interactive behaviors.
Click Close to close the Verify Transaction dialog and return to the Transaction Definition dialog.
The type of verification for the transaction displays in the Transaction Validation group.
In a running configuration that uses online edits, you must save and assemble the data points with
pending edits before you verify a transaction (if you wish to use the new data point definitions).
FactoryTalk Transaction Manager verifies only transactions with pending edits (if any exist). The
transactions with pending edits are verified using current data point definitions (data points that have
been saved and assembled).
In a stopped configuration that uses online edits, FactoryTalk Transaction Manager verifies
transactions with pending edits (if any exist). If no pending edits exist, FactoryTalk Transaction
Manager verifies the current transaction definition.
To verify a transaction on the main FactoryTalk Transaction Manager dialog, select it in the right
pane, right-click, and then select Verify Transaction from the menu.

17 of 74

You can verify multiple transactions at once on the main FactoryTalk Transaction Manager dialog by
using the Verification Report. Select Tools > Verification Report. On the Verification Report
dialog, choose to verify either enabled or disabled transactions or both.
View transaction differences
The Transaction Differences dialog allows you to view the differences between the current transaction
definition and the transaction with pending edits. You can view transaction differences after you save
pending edits, but before you assemble.
1. On the Pending Transaction Definition dialog, click Show Differences.
2. On the Transaction Differences dialog, select one of the following view options:

All
Displays all the parameters and bindings in the current transaction definition and the pending
edits transaction definition.

Differences
Displays only those parameters that have been changed for the current transaction and the
transaction with pending edits.
Bindings for current data points and data points with pending edits display.

3. Close the dialog.

Tip: You can also access the Transaction Differences dialog from the Pending Edit Alerts
dialog.
Pending edit alerts
Pending edit alerts are informational messages about the pending edits you are trying to assemble.
Pending edit alerts are caused because some transactions require "state" information (internal buffers
that contain information about the current and previous states of the transaction). This state
information is no longer valid if certain changes are made to a data point or transaction that cause it
to be reset when it is assembled. A transaction that is reset behaves as if it is running for the first
time. The conditions necessary for a transaction to be reset are described in detail below.
To review transactions that have pending edit alerts (and will be reset), open the Pending Edit Alerts
dialog. FactoryTalk Transaction Manager warns you that the transaction will be reset by displaying a
pending edit alert message. If the transaction includes any of the following characteristics, it requires
state information:

Ignore First Unscheduled Event (Trigger and Storage Parameters dialog)

Transactions Stores Data On Number of Completed Transactions (Trigger and Storage
Parameters dialog)
Transactions Stores Data On Data Change and/or Rate (Trigger and Storage Parameters
dialog)
Expression using DIFF function (Expression Editor dialog)
Expression using Data Point Range function used in conjunction with the Min, Max, and Avg
functions (Expression Editor dialog)

A pending edit alert occurs if your enabled transaction contains state information and you perform any
of the following tasks or change any of the parameters:

18 of 74

Lab 1: Creating the FTTM_Training Database

Part A - Creating a Database Using SQL Server Management Studio
1. On VM-Image1, double-click the SQL Server Management Studio icon.

2. Click Connect.

3. From the File menu select Open > File.

19 of 74

4. From the C:\Class Files\IS Core FTTM DB folder select the FTTM_ISCore.sql file.
a. Click Open

b. Click the Execute icon.

20 of 74

5. Verify that the command(s) completed successfully.

a. Right-click on Databases and select Refresh

6. Expand the Databases tree and verify that the FTTM_Training database was created.

21 of 74

7. From the File menu select Exit.

This lab is complete

22 of 74

Lab 2: Creating a FactoryTalk Transaction Manager

Edit Enable Application
1. From the Desktop, double-click on the FactoryTalk Transaction Manager (FTTM) Icon.

2. If the RA Foods configuration is running (green light), right-click on it and select Stop
Configuration.

3. Click Yes.
Note: In the following steps we will be creating a new FTTM application and we can have
only one FTTM application running at a time on a computer

4. Click on the Configuration tab and select New.

23 of 74

5. In the Configuration Name textbox enter My_FTTM_Application.

a. Click the Step 1 button

6. In the Path textbox enter C:\My_FTTM_Application.

a. Check the Enable Online Edits checkbox
Note: When you select the Enable Online Edits checkbox the only Control connector that
can be selected is the FactoryTalk Live Data connector. This connector is selected by
default.
b. Check the ODBC checkbox
c.

Click Apply

7. Click OK.

24 of 74

8. Click Close.

9. Click the Step 2 button.

10. In the Password textbox enter rockwell (all lower case).

a. Click Passwords then OK to the next 2 dialog boxes
b. Click Apply (may require Yes response and an OK)

25 of 74

11. From the Connector Service listbox select ODBC Connectors.

a. In the Connector Name textbox enter ODBC
b. Click Apply and then click OK to any dialog boxes
c.

Click Close

12. Click Step 3.

13. Select RA Foods.

a. Click OK

26 of 74

14. Expand the BL1 Folder to Online > Program:Proof_Oven > OvenUDT.
a. Note: You can use the Ctrl key to select more than one tag
b. Select the TempZone1, TempZone2, TempZone3 and TempZone4 tags
c.

Click the Add Selected Tag(s) button

15. Verify that the selected tags were added.

a. Click Apply and then OK to any dialog boxes
b. Click Close

27 of 74

16. Click Step 4.

17. In the Name textbox enter t_FTTM_Training.

a. Click the Database Connection browse icon

18. Click the System DSN browse icon.

28 of 74

19. Select the System DSN tab.

a. Click Add

20. From the Name list box cursor to the end and select SQL Server Native Client 10.0.
a. Click Finish

21. In the Name textbox enter dsn_FTTM_Training.

a. In the Server textbox type (local)
b. Click Next

29 of 74

22. Select the With SQL Server authentication option.

a. In the Login ID textbox enter FTTM_User
b. In the Password textbox enter Rockwell1
c.

Click Next

23. Verify that the FTTM_Training database is selected.

Note: If the FTTM_Training database is NOT selected check with your instructor
a. Click Next

30 of 74

24. Click Finish.

25. Click the Test Data Source button.

31 of 74

26. Verify that the test completed successfully.

a. Click OK

27. Click OK.

32 of 74

28. Click OK.

29. From the System DSN list box select dsn_FTTM_Training.

a. In the User Name textbox enter FTTM_User
b. In the Password text box enter Rockwell1
c.

Click Apply and then OK to any dialog boxes

d. Click Close

33 of 74

30. From the Table listbox select the dbo.t_FTTM_Training table.

a. Select all items on left and click the move to right icon
b. Verify that all the columns in the table were moved to the Data Object Columns window
c.

Click Apply and then OK to any dialog boxes

d. Click Close

31. Click Step 5.

34 of 74

32. Do the following steps.

a. In the Transaction Name textbox enter BL1_OvenTemps
b. In the Data Object Name list box select t_FTTM_Training
c.

In the Transaction Status pane select the Enable option

d. Right-click on String1 and select Bind Expression

33. In the Expression String window enter Baking.

Note: The string expression must be in double quotes
a. Click OK

35 of 74

34. Right-click on String2 and select Bind Expression.

35. In the expression window enter Line 1.

Note: The string expression must be in double quotes
a. Click OK

36. Double-click in the blank area of the Bound Value column.

Note: This will open the Data Points dialog

36 of 74

37. Drag and drop TempZone1 to Data1.

a. Drag and drop TempZone2 to Data2
b. Right-click on TransTime and select Bind Expression
Note: We will be adding TempZone3 and TempZone4 as Online edits in a later lab

38. Click the TransTimestamp() button.

Note: The TransTimestamp() is a built in function and by default adds to correct syntax to
the Expression window
a. Click OK

37 of 74

39. Click the Trigger / Storage button.

40. For the Scan Rate enter 10 and select the Seconds option.
a. Click OK

41. Click Apply and then OK to the message dialog box if it is displayed.
a. Click Close

42. Click Close to close the configuration checklist dialog.

38 of 74

43. Highlight the My_FTTM_Application, right-click and select Start Configuration.

44. Click Yes.

Note: When Starting or Stopping a FTTM Configuration you are always asked to confirm
the action being taken

45. Select the View tab and select Transaction Monitor.

46. Verify that both the Transaction and the Database actions are passing (will take a little time for
the values to start incrementing).

47. Open the SQL Server Manager by double-clicking the SQL Server Manager icon.

39 of 74

48. Click the Connect button.

49. Expand the Databases tree to FTTM_Training > Tables.

a. Highlight the dbo.t_FTTM_Training table, right-click and select Select Top 1000 Rows

50. Verify that the data is being inserted in to the String1, String2, Data1, Data2 and TransTime
columns.
a. Verify the that Transtime timestamps are occurring every 10 seconds

51. Close FactoryTalk Transaction Manager and SQL Server Management Studio.

This lab is complete

40 of 74

Lab 3: Editing a Running FactoryTalk Transaction

Manager Edit Enable Application
1. Open the FTTM Manager by double-clicking the FTTM icon on the desktop.

2. Verify that the My_FTTM_Application is running (Green traffic light).

Note: The My_FTTM_Application must be running for this lab

3. Double-click on the BL1_OvenTemps transaction (may need to click off and then back on the
My_FTTM_Application configuration first to give it focus).

4. Click the Create Edits button.

41 of 74

5. Highlight String3, right-click and select Bind Expression.

6. In the Expression Editor enter ProofOven and then click OK.

Note: The string must be in double quotes

7. Double-click in the Bound Value window.

Note: This will open the Data Points dialog

42 of 74

8. Drag and drop TempZone3 to Data3.

a. Drag and drop TempZone4 to Data4
b. Right-click on TransTime_MS and select Bind Expression

9. Click the MTransTimestamp() button.

Note: The MTransTimestamp() is a built in function and by default adds to correct syntax
to the Expression window
a. Click OK

43 of 74

10. Click the Save Edits button and then OK or Yes to any dialog boxes.
a. Click Assemble Edits and the OK or Yes to any dialog boxes
b. Click Close

11. Open the SQL Server Manager by double-clicking the SQL Server Management Studio icon.

12. Click the Connect button.

44 of 74

13. Expand the Databases tree to FTTM_Training > Tables.

a. Highlight the dbo.t_FTTM_Training table, right-click and select Select Top 1000 Rows

14. Verify that the data is being inserted in to the String1, String2, String3. Data1, Data2, Data3,
Data4, TransTime and TransTime_MS columns.
Note: You will have to scroll down to the end of the results to see the new data.

Note: If you have more than 1000 rows of data you will have to modify the query as follows
and rerun the query. Delete the Top 1000 and click Execute

15. Close SQL Server Management Studio and Transaction Manager.

This Lab is complete

45 of 74

Lab 4: Bidirectional Transaction with Bind

Transaction Result Option
Part A - Adding an FTTM Data Object
1. Open the FTTM Manager by double-clicking the FTTM icon on the desktop.

2. Stop the My_FTTM_Application by highlighting the My_FTTM_Application, then right-click and

select Stop Configuration. Click Yes to the confirmation dialog box.
Note: The My_FTTM_Application must be stopped when creating a Data Object

3. Expand the My_FTTM_Application tree to ODBC Connectors > ODBC.

a. Highlight ODBC, right-click and select Define Data Object

46 of 74

4. In the Name textbox enter t_Handshake.

a. From the Database Connection list box select dsn_FTTM_Training
b. From the Table list box select dbo.t_Handshake
c.

Select all the Database Columns and move them to the Data Object Columns window using
the right double arrow icon

d. Click Apply and then OK or Yes to any dialog boxes

e. Click Close

5. Highlight the My_FTTM_Application, right-click and select Start Configuration.

6. Click Yes.
Note: When Starting or Stopping a FTTM Configuration you are always asked to confirm
the action being taken

47 of 74

7. Select the View tab and select Transaction Monitor.

8. Verify that both the Transaction and the Database actions are passing.

Part B - Adding FTTM Data Points to a Running Configuration

1. Expand the My_FTTM_Application tree and select FT.
a. Right-click and select Define Data Points

2. Expand the BL1 tree to Online > Programs:HB_HandShake.

a. Select the Heartbeat_Toggle_Bit
b. Click Add Selected Tag(s)

48 of 74

3. Cursor to the right and change the Mode of the Heartbeat_Toggle_Bit to Unsched.

4. Expand the Program:HB_HandShake tree and select the HS folder.

a. Select the HS_Comm_Error, HS_Error_Code, HS_Missed and HS_Number data points
b. Click the Add Selected Tag(s) button

5. Select ALL the Red rows. You must select the entire rows.
a. Click Save Edits then OK or Yes to any dialog boxes
b. Click Assemble Edits and then OK or Yes to any dialog boxes
c.

Click Close

49 of 74

Part C - Adding a FTTM Transaction to a Running Configuration

1. Right-click in the white space in the right window and select Define Transaction.

2. IMPORTANT: Verify that the Pending Transaction Definition dialog box is completely blank.

3. In the Transaction Name textbox enter t_Handshake.

a. From the Data Object Name list box select t_Handshake
b. From the Transaction Status options select Enable
c.

Select the Use Real Time Thread option

d. Highlight the HS_Source column then right-click and select Bind Expression

50 of 74

4. In the Expression Editor enter Baking BL1 ControlLogix Processor

a. Note: The string expression must be in double quotes
b. Click OK

5. Double-click in the white space (see screen shot) to open the Filter and Data Point Editor.

51 of 74

6. Drag and Drop as follows (Note: the tags name are using the last part of the FTLD name).

HS_Number to HS_ID
HS_Missed to HS_Num_Missed
HS_Comm_Error to HS_Comm_Error
HS_Error_Code to HS_BindTranResult_Error

a. Check the Bind Transaction Result check box

b. Drag and Drop the HS_Error_Code to the Bind Transaction list box
c.

Highlight the TransTime data column then right-click and select Bind Expression

7. Click the TransTimestamp() button.

Note: The TransTimestamp() is a built in function and by default adds to correct syntax to
the Expression window
a. Click OK

52 of 74

8. Highlight the TransTime_MS data column then right-click and select Bind Expression.

9. Click the MTransTimestamp() button.

Note: The MTransTimestamp() is a built in function and by default adds to correct syntax
to the Expression window
a. Click OK

10. Click the Trigger / Storage button.

53 of 74

11. Select the On Unscheduled Event option AND the On High Transition option.
a. From the Unscheduled Event list box select the Heartbeat_Toggle_Bit
b. Click OK

12. Click Save Edits then OK or Yes to any dialog boxes.

a. Click Assemble Edits then OK or Yes to any dialog boxes
b. Click Close

13. From the desktop double-click the BL1 Heartbeat Status icon to open the FTView SE client.

54 of 74

14. If not already On (green), turn the BL1 Heartbeat Status On by clicking the RED HB Off button.

15. Verify that the BL1 Heartbeat Status is On (green) and that the HB Number is increasing
without any errors (may take some time to start).
Note: A heartbeat occurs every 20 seconds

16. From the FTTM Manager, select the View tab and then select Transaction Monitor (you may be
in this view from a previous lab).
a. Verify that the t_Handshake transaction is working and has no errors

Note: You can leave the FTTM Manager and the FTView Client open for the next lab

This lab is complete

55 of 74

Lab 5: Discussion of FTTM Errors and Data

Buffering/Loss
This lab will cover the following topics:

Differences between Cached and Real Time Transactions

Errors and data loss/saved from an enterprise connection failure
Errors and data loss/saved from a database failure
Errors and data loss/saved from a control side failure

Part A - Setting Up the VM-Image Desktop

1. The following steps will be used as an outline for this discussion.
a. From the VM-Server1 image open the FT Transaction Manager (if not already open)
b. From the View menu select Transaction Monitor
c.

Adjust the interface to the size indicated below

d. Open Windows Explorer

e. Open the C:\My_FTTM_Application folder
f.

Adjust the interface to the size indicated below

g. Observe that the .rsl file is changing (number in the file name is incrementing and timestamp
is updating). This is your cache file
h. Open the FTView BL1 Heartbeat Status Client (if not already open)
i.

Verify that the HB is running

56 of 74

Part B - Enterprise Connector Failure

1. Highlight the ODBC connector then right-click and select Stop Connector Service.
a. When the dialog box pops up click Yes

2. Verify that the BL1_OvenTemps transaction is passing and that the t_Handshake transaction is
failing.
a. Verify that the number of .rsl files are increasing. These are the BL1_OvenTemp data that
is being cached
Note: The t_Handshake data is lost BUT an error code is returned to the controller via the
Bind Transaction Result function
Note: The FTView client is displaying a 1235 error

57 of 74

3. From the Start menu select All Programs > Rockwell Software > FactoryTalk Transaction
Manager > Error Messages.

4. In the Error Number textbox enter 1235.

a. Select the Bind Transaction Result Error option
b. Click Apply
Note: An error message is returned that states the enterprise connector is not connected
to the Transaction Manager
c.

Click Close

58 of 74

5. Highlight the ODBC connector then right-click and select Start Connector Service.
a. When the dialog box pops up click Yes

6. The cached .rsl files are sent to the database and the error is cleared and both transactions are
now passing.

59 of 74

Part C - Database Connection Failure

In this section of the lab we will simulate the loss of the FTTM_Training database. To do this we will
need to stop the FTTM My_FTTM_Application and then pause the SQL server so that it will not allow
any new connections. Then, when we restart the My_FTTM_Application it will not be able to connect
to the FTTM_Training database because the SQL server is paused.
1. From the FTTM Manager select the My_FTTM_Application and click the Stop icon then click
Yes.

2. From either the Start menu or the desktop icon open the Microsoft SQL Server Management
Studio.
a. Highlight the vm-image1 server and right-click and then select Pause
b. Click Yes

3. From the FTTM Manager select the My_FTTM_Application and click the Start icon then click
Yes.

60 of 74

4. Note and verify the following:

a. The BL1_OvenTemp transaction is passing
b. The t_Handshake transaction is failing
c.

A file named dsn_FTTM_Training.sql was created. This file contains the content of the first
.rsl file that failed to have its data loaded into the FTTM_Training database.

d. Additional .rsl files are created once the Enterprise connector is aware that the database has
been lost.
e. A file named rt_dsn_FTTM_Training.sql was created and contains the real time
t_Handshake data
f.

An error number 1519 was returned to the controller via the Bind Transaction Result
function

61 of 74

5. From the Start menu select All Programs > Rockwell Software > FactoryTalk Transaction
Manager > Error Messages.

6. In the Error Number textbox enter 1519.

a. Select the Bind Transaction Result Error option
b. Click Apply
Note: An error message is returned that states to check the Enterprise connector log
c.

Click Close

62 of 74

7. From FTTM select the View tab and then Error Log Files.

8. Select the ODBC connector.

Note: The ODBC connector error log indicates an error occurred while trying to connect
to the FTTM_Training database

9. From either the Start menu or the desktop icon open the Microsoft SQL Server Management
Studio.
a. Highlight the vm-image1 server and right-click and then select Resume
b. Click Yes

63 of 74

10. Once the database has resumed you should note and verify the following.
a. The .rsl cached files have been loaded in the database.
b. Both the dsn_FTTM_Training,sql and the rt_ dsn_FTTM_Training,sql file are still present
and the data in these files has not been transferred into the database. This must be done via
a program like a VB app or manually using the SQL Management Studio
c.

The error code has been cleared.

11. Close all the open applications/GUI interfaces.

This lab is complete

64 of 74

Lab 6: Using FTTM Stored Procedures

In the following lab we will use a FTTM Stored Procedure to download Machine Setup Parameters
from a MSSQL database to a ControlLogix controller. We will use a FTView SE client to select a set
of parameters and then trigger the FTTM stored procedure that will select the correct set of
parameters and download them to the Logix Controller.

Part A - Adding a FTTM Data Object

1. Open FTTM and Stop the My_FTTM_Application configuration.
a. Note: To create a new data object the FTTM configuration must be stopped

2. Expand the My_FTTM_Application and highlight the ODBC connector.

a. Right-click and select Define Data Object

65 of 74

3. In the Name textbox enter Machine_Setup.

a. From the Database Connection combo box select or verify dsn_FTTM_Training is selected
b. Select the Stored Procedure option
c.

From the Stored Procedure combo box select or verify dbo.Machine_Setup_sp is selected

d. Select and move all the Parameters in the Parameters window to the Data Object
Columns window by clicking the move all icon
e. Click Apply
f.

Click Close

Part B - Adding the Machine Setup Data Points

1. Expand the My_FTTM_Application and highlight FT.
a. Right-click and select Define Data Points

66 of 74

2. Expand the BL1 > Online tree to the Program:Machine_Setup folder.

a. Select all the Machine_Setup tags EXCEPT the Machine_Setup_ONS tag
b. Click Add Selected Tags button

3. Select the Machine_Setup_Get_Parameters tag.

a. Change the Mode from Sched to Unsched
b. Click Apply
c.

Click Close

67 of 74

Part C - Adding the Machine Setup Transaction

1. From the Define tab select Transaction.

2. Verify that the Data Object Column window is BLANK.

Note: If you have bindings in this window and you continue you are editing an existing
transaction

68 of 74

3. In the Transaction Name textbox enter BL1_Machine_Setup.

a. From the Data Name Object combo box select Machine_Setup
b. In the Transaction Status frame select the Enable option
c.

In the Transaction Option frame select the Use Real time Thread option

d. Highlight the @MachineSetupNumber

e. Right-click and select Separate Input/Output Parameter

4. Repeat last steps to separate the @Parameter1 and @Parameter2 parameters.

a. Verify that the Data Columns are as indicated below.

5. Highlight the @Parameter1 I (input) parameter, then right-click and select Bind Null Value.

6. Repeat step 5 for the @Parameter2 input parameter.

69 of 74

7. Note: Double-clicking in the blank Bound Value window will open the Data Points Dialog box.
a. Check the Bind Transaction Result check box
b. Drop and drag the following data values to bind them with the stored procedures parameters
@RETURN_VALUE
@MachineSetupNumber (input)
@MachineSetupNumber
(output)
@Parameter1 (output)
@Parameter2 (output)
Bind TractionResult
c.

BL1_Program:Machine_Setup.Machine_Setup_Error
BL1_Program:Machine_Setup.Machine_Setup_Number_Requested
BL1_Program:Machine_Setup.Machine_Setup_Number_Returned
BL1_Program:Machine_Setup.Machine_Setup_Parameter1
BL1_Program:Machine_Setup.Machine_Setup_Parameter2
BL1_Program:Machine_Setup.Machine_Setup_BTR_Error

Click the Trigger / Storage button

8. Select the On Unscheduled Event option.

a. Select the On High Transaction
b. Select the Machine_Setup_Get_Parameters tag
c.

Click OK

70 of 74

9. Click Apply
a. Click Close

10. From the FTTM Manager select the My_FTTM_Application and click the Start icon.
a. Click Yes

11. From the Desktop select the Machine Setup display icon.

71 of 74

12. Click the Machine Setup 1 button and verify that setup number 1 was loaded.
a. Click the Download Requested Machine Setup button
Note: No parameters were returned and the communication error of 99 was returned. This
indicates that no setup matched the requested number.

13. From the Desktop select the SQL Server Management icon.

14. Click Connect.

72 of 74

15. Expand the Database tree to FTTM_Training > Tables.

a. Highlight dbo.T_MachineSetup and then right-click and select Edit Top 200 Rows
Note: The table does not have any Machine Setups entered.

16. Enter the following 4 Machine Setups.

Note you must click on the last row to complete the edits
MachineSetupNumber
1
2
3
4

Parameter1
111
222
333
444

Parameter2
111
222
333
444

73 of 74

17. Return to the FTView SE Machine Setup Display client.

a. Verify that Machine Setup 1 is selected
b. Click the Download Requested Machine Setup
c.

Verify that Machine Setup 1 was downloaded without any errors

18. Select Machine Setup 2, 3 and 4 in turn and verify the correct parameters were downloaded.
19. Stop the My_FTTM_Application configuration.

20. Start the RA Foods configuration.

21. Close View Client, Transaction Manager and SQL Management Studio.

This lab and manual is complete

74 of 74