Presentation on theme: "RSSql Tutorial Version 2.1 This tutorial has been developed using Microsoft’s PowerPoint. Simply click your mouse or hit the Enter key to advance. The."— Presentation transcript:
RSSql Tutorial Version 2.1 This tutorial has been developed using Microsoft’s PowerPoint. Simply click your mouse or hit the Enter key to advance. The Page Up and Page Down keys can also be used to scroll forward and back. Use the controls in the lower-left to navigate to a particular slide and to exit the tutorial.
RSSql Overview PLC DDE or OPC Server RSView/MMI Industrial Control System Enterprise Database(s) Enterprise System SQL Server Oracle etc. RSSql Enterprise Application RSSql (or Rascal) is a software product from Rockwell Software which functions as an industrial transaction manager. As such, RSSql allows an Industrial Control System on a factory floor to communicate, coordinate and share data with any Enterprise Software System which includes a database. The transaction model allows great flexibility in defining the interactions between these two systems to address a wide range of requirements. This tutorial will present an overview of RSSql’s capabilities and user interface. A more detailed tutorial is included with the RSSql Sample Application that is also included in this disk.
PLC DDE or OPC Server RSView/MMI Industrial Control System Enterprise Database(s) Enterprise System SQL Server Oracle etc. RSSql Enterprise Application RSSql Overview An Industrial Control System refers to the automated system which controls manufacturing processes in a plant. For RSSql’s purposes, it usually consists of a number of PLCs (or Programmable Logic Controllers) and one or more data server computers which run software compatible with the DDE (Dynamic Data Exchange) or OPC (OLE for Process Control) standards. RSLinx is an example of such a data server software package. In addition, the Industrial Control System may include some MMI stations (Man/Machine Interface) using a product like RSView32 that allows plant floor operators to interact with the Control System.
PLC DDE or OPC Server RSView/MMI Industrial Control System Enterprise Database(s) Enterprise System SQL Server Oracle etc. RSSql Enterprise Application The Enterprise System is a general term that refers to any application which uses a database system. RSSql does not interface with the Enterprise application itself, but directly with the underlying database. The database could be one that was created just to hold data from RSSql, or part of a larger application such as an Enterprise Resource Planning system or legacy application. RSSql Overview
Control Connector Services Industrial Control SystemEnterprise Database Transaction Manager Enterprise Connector Services RS Sql RS Linx RS View DDE Servers ODBC Databases RSLinx Connectors RSView Connectors OPC Connectors DDE Connectors OLE-DB Connectors OCI Connectors ODBC Connectors 2) Control Connector Services communicate between RSSql and the Industrial Control System. RSSql has four types of Control Connector Services : for interfacing with generic DDE or AdvanceDDE servers, with generic OPC servers, with RSLinx, and with RSView32. RSSql can scale to support multiple connections of each type for large applications. 1) RSSql is made up of 4 components: the Transaction Manager, Control Connector Services, Enterprise Connector Services, and the Transaction Builder. In a RSSql installation there will be one Transaction Manager and one or more Control Connector Services and Enterprise Connector Services, all of which run as NT Services. The Transaction Builder is the Graphical User Interface (GUI) to RSSql. 3) Enterprise Connector Services communicate between RSSql and the Database System. RSSql has three types of Enterprise Connector Services : for interfacing with databases via ODBC, via OLE DB, and via OCI (Oracle Callable Interface). These Connector Services enable RSSql to interface with many different database systems, including Microsoft SQL Server, Microsoft Access, Oracle, Sybase, and others. RSSql can support multiple connections of each type for large applications. RSSql Architecture
Control Connector Services Transaction Manager Enterprise Connector Services RSSql Industrial Control SystemEnterprise Database(s) SQL Server Oracle etc. DDE/OPC Server(s) RSLinx PLCs RSSql is sold in two versions, Standard and Professional. The Standard version, which is represented here, permits installation of the RSSql Transaction Manager and all Control Connector and Enterprise Connector Services on a single Microsoft NT computer. In addition, the DDE or OPC data server (such as RSLinx) for the Industrial Control System must also be installed on the RSSql computer. Connections to Databases on other computers are supported by this version. RSSql Installation - Standard Version
RSSql Installation - Professional Version Control Connector Services Transaction Manager Enterprise Connector Services RSSql DDE or OPC Servers Industrial Control SystemEnterprise Database(s) SQL Server Oracle etc. The Professional version of RSSql permits scaling for much larger installations. The Transaction Manager remains on a single NT computer, but the Control Connector Services and Enterprise Connector Services can be distributed to other computers. Communications between computers is accomplished using TCP/IP.
Starting RSSql When RSSql is run for the first time, this graphic will be presented. The top section shows how RSSql transactions bridge the gap between Control Systems and Enterprise Systems. The bottom section shows the overall structure of RSSql with its three major components: Transaction Manager, Control Connector Services, and Enterprise Connector Services. It also contains links to the Help system which explain each component and its role in the operation of the system. You can return to this graphic at any time by selecting the System Graphic button on the toolbar on the RSSql main screen.
Creating a Configuration To create an application, we must build a RSSql Configuration. A RSSql configuration is a set of RSSql transactions that are treated as a single unit, together with the Control Connectors and Enterprise Connectors required to perform them. You may create many configurations, but the RSSql Transaction Manager can run only one configuration at a time. There are two ways to create a new Configuration. Select “New” from the main toolbar, or from the Configuration menu select “New” or “Checklist”.
The Configuration Checklist screen outlines the steps to be taken to create a complete configuration. All of the functions it uses are accessible directly from the RSSql main screen, but the Configuration Checklist is a handy tool that imparts a step-by-step organization to the process. To create a new Configuration, type in a new name in the Configuration Name box, then click on the “Step 1” button.
2) In the bottom half of the screen, you select the Control Connector Services and Enterprise Connector Services that your configuration will use. Choose DDE for generic DDE or AdvanceDDE servers. RSLinx and RSView32 both use OPC with RSSql 2.1. Generic OPC is for OPC servers from third-party vendors. 1) Here we provide basic information about the RSSql Configuration. The Path entry tells RSSql where to store the data files associated with this configuration. If RSSql components are installed on other computers on the network, this Path must be a fully qualified UNC path name to which all those computers have access. 3) For Enterprise Connector Services, ODBC is the most common method which is supported by most database systems. Oracle OCI is the native interface for all Oracle databases. Use OLE DB for interfacing with SQL Server 7.0 only.
2) Notice on the RSSql main screen (which would be updated if we exited the Checklist screen), a root entry in the Configuration tree called Tutorial_Config has been created, and within it is an entry for each one of the three Connector Services we selected. Defining Connectors 1) This completes Step 1 of the Configuration Checklist, and you can see that Step 1 is checked off on the Checklist screen. Also under Step 2 on the Checklist is an indication that we have three Connector Services plus the Transaction Manager service, or four in total. This is a good time to note that we can exit this Configuration Checklist at any time and pick up later where we left off. 3) We have selected which Connector Services to use, and now in Step 2 of the Checklist we must define the Connectors and assign them to specific computers.
First we define where the Transaction Manager, which is an NT Service, will run. The default is the current computer and current user account. If this is a distributed RSSql installation and the Transaction Manager will run somewhere else, enter the information for that computer. The User Name must have administrator privileges to initialize an NT Service on the computer, and access to all necessary RSSql files on other computers. The Port Number is used for TCP/IP communications and should only be changed if there is a conflict. Enter the password for the user and hit “Apply” to save this information.
RSSql uses an Apply and Close button combination on any dialog where you can do the same type of task more than once. For instance, in this dialog, you could define the Transaction Manager, several Control Connectors and several Enterprise Connectors. The Apply/Close approach allows you to do this without leaving the dialog. In dialogs that support single actions, RSSql uses a standard OK/Cancel combination.
1) All of the connectors can be defined from this screen. Next we will define an RSLinx Connector. Type in a new name for the connector, and specify the NT host computer on which the service will run. The Connector service will run as an NT Service on that computer and will log on using the User Name and Password supplied here. By using the drop-down under the Connector Service field, we can define connectors for each of the three connector services we created without leaving this screen: OLE DB, RSLinx and RSView. Click “Apply” after each connector is defined. Note that if we have RSSql Professional and a distributed installation, we can create more than one Connector for each type of Connector Service, but each connector must run on a different host computer. In this example, all Connectors will run on the same local computer, which is called “rsi_mink”. 2) Clicking “Host/User” will set all of the Host Names, User Names, and Passwords of all of the Connector Services to match those on the current screen. In addition, all of the data file paths that RSSql uses will be set to the Configuration data file path. Clicking “Password” will change the passwords of all of the Connector Services to match the current one, making it easier to implement periodic password changes.
2) On the RSSql main screen, which would be updated if we exited the Checklist, we can also see the new connectors have been created in the Configuration tree. We are going to exit the Configuration Checklist and take a closer look at that main screen. 1) Once you have created at least one Connector for each Connector Service type in your Configuration, Step 2 is complete. Note we get an indication on the Checklist Screen that under steps 3 and 4 there are now two Control Connectors and one Enterprise Connector to be defined.
We have now created the basic outline for a RSSql Configuration called Tutorial_Config. This configuration consists of three Connectors: 1) OLE-DB_on_Mink that can connect to any number of OLE DB sources available to its host computer. These OLE DB sources may point to databases on other computers. 2) RSLinx_on_Mink which can connect to an RSLinx server running on its host computer, and 3) RSView_on_Mink which provides an optimized link to any active RSView32 project on its host computer. Now we need to define the Data Points and Data Objects that each of these connectors will use.
Defining Control System Data Points Control System Data Points are defined in Step 3 of the Configuration Checklist.
RSLinx Data Points This is the screen where we identify data points in the control system serviced by RSLinx that are to be used in RSSql transactions. The center of the RSLinx Data Points definition screen is the RSWho interface of RSLinx itself. Expand the tree to locate the RSLinx device containing the desired Data Points.
3) If a Tag File has been associated with the RSLinx server, the Tag File name will also be filled in. If there is a tag file which has not been associated, you may browse for it. RSSql provides the ability to connect directly to Tag Files of the AI Series and RSLogix Family of PLC programming software. This Tag File is the.RSP file generated by an RSLogix5 project. 4) Click on “Add Tags” to view the data points associated with the selected Tag file. 1) Click on the desired RSLinx device. 2) The Device Name will be automatically filled in on the screen.
3) Select the option of having the tag addresses resolved at runtime, or having RSSql do a one- time import of the tag addresses. 4) Click “Apply” and “Close” to create the data points in RSSql. 2)... or selecting one or more tag lines and using the “>>” button to move the tag to the right pane. 1) All the data point tags, PLC addresses, and other tag file information is listed. Choose the data points to make available to RSSql by double- clicking on the tag line,
The RSLinx data points are imported into RSSql and auto-named based upon the Connector name and the Tag Symbol. A new data point can be added by simply scrolling down and typing the information into a blank line.
2) Second, you can select Data Points in the lower window, right click, and select “Edit Collection Params of Selected Rows” to change the Collection Parameters for a set of data points. These first two options will bring up the Collection Parameters screen. 1) The right side of the Data Points window shows the Collection Parameters for each data point, which control how RSSql manages collecting the value of the data point. There are three methods to modify these parameters: First, you can click “Collection Defaults” to set parameters for the next data points to be added. Data Point Collection Parameters
2) Data Point Collection Type determines how the Control Connector gets new values for the data point. “Scheduled: Use the Current Subscribed Value” directs the RSLinx to send new values to the Control Connection periodically at the “Subscription Scan Rate”. The Control Connector caches the data value so it can provide it to the Transaction Manager upon request. “Scheduled: Request the Current Value from the Device” directs the Control Connector to ask RSLinx to read a new data point value from the device (PLC) whenever it is needed for a transaction. “Unscheduled: Send Subscribed Value Whenever It Changes” is a collection type that is driven by the RSLinx server. When the server detects a new data point value, it sends the value to the Control Connector, which passed the value to the Transaction Manager. This setting is required if a data point is to be a transaction trigger. 1) The Collection Parameters screen is used, with minor variations, with all RSSql Control Connectors.
1) There are two Timeout Properties RSSql uses in collecting Data Point values. “Data Retrieval” specifies how long the Transaction Manager will wait for the Control Connector to give it a data point value. If the Data Retrieval timeout is exceeded, the Substitution Properties to the right are invoked. “Data Valid” indicates how long a data value that is cached by the Transaction Manager is “fresh”. If a data point value is needed by a transaction, the Transaction Manager will first check to see if the data value it has in its buffers is “fresh” (within the time specified by “Data Valid”). If the value is fresh, the Transaction Manager will use it. If the value is stale, the Transaction Manager will collect a new value from the Control Connector. A Data Valid time of 0 will force RSSql to get the latest value from the Control Connector every time the data point is needed. 2) If the Transaction Manager cannot obtain a data value within the time specified by the “Data Retrieval” value on the left, the value will “time out”. In this case, you can specify one of three courses of action for RSSql. First, you can specify that there should be “No Substitution” for the timed out data point. In this case, the entire transaction that required the missing data value will fail. Second, you can direct RSSql to “Substitute Previous Value”, in which case the last known value for the missing data point will be used. Finally, you can specify an actual value to be substituted for the missing data value. 3) Clicking on “Apply” will apply any changes on this screen to the selected Data Points. “Factory Defaults” will restore the Data Point defaults.
1) Finally, Data Collection parameters can be changed one at a time by typing directly on the active grid (some are drop down, some accept a value). Changing the ORDERDONEBIT to Unscheduled mode allows it to be a transaction trigger. 2) When you are finished making changes, click “Apply” to apply the changes, and “Close” to dismiss the screen.
RSView32 Data Points 1) This screen is used to create Data Points from an RSView project. RSSql is tightly coupled with RSView32 and will detect any RSView32 project that is currently open or running on the host computer for the Connector. The RSView32 project name(s) automatically appears in the list. 2) Click on “Add RSView Tags” to access the data points.
1) All of the data points in the RSView32 project are displayed. To select them, move them into the right pane by simply double-clicking on the tag name, 2)...or highlighting the tag name and using the arrow key.
1) Again the data points are auto-named, and the collection parameters can be changed on the active grid or by right-clicking on the Data Point. 2) “Apply” applies the changes, and “Close” dismisses the screen.
OPC Data Points A new feature of RSSql 2.1 is the support of OPC, or OLE for Process Control, for interfacing with control systems. There is no OPC Connector in this RSSql Configuration, but we will briefly review the screens that are used to create OPC Data Points. This is the screen where we identify data points in the control system serviced by an OPC Server to be used by RSSql in transactions. All the OPC servers on the host computer for the OPC Connector are listed in this drop-down box. We’ll choose a third-party OPC server product called KEPServer which is sold by a company called KepWare.
1) Choose the host computer from the drop-down list, which can be a remote computer if the OPC server supports DCOM. 2) Click “Browse Server” to activate OPC Browse. 4)... bring up the right pane, which lists the data points symbols. This works with tag files of the AI Series and RSLogix Family of PLC programming software. You can also use CSV (comma separated variable) files to provide this information. 3) The Topics defined for the server are shown in the left pane. If a tag file has been associated with the Topic, clicking on the device will...
1) Highlight the Data Points (called Items or Item Leaf in OPC) that you wish to use in RSSql transactions. 2) Then click the “Add” button. 3) The Data Points appear in the lower pane. RSSql automatically assigns unique names to each data point. OPC Data Point collection parameters can be modified in the same ways as data points of other Connector types.
Defining Enterprise Connector Data Objects 2) The next step is to define the connections to the database and identify the table columns and stored procedure parameters that will be used in the RSSql transactions. RSSql is not limited to a pre-defined database schema - it can interface with databases, tables, views and stored procedures that you define. We will define combinations of database connections and database objects called Data Objects. This is Step 4 of the Configuration Checklist. 1) Back on the Configuration Checklist, the Data Points for both of the Control Connectors have been defined, and Step 3 is complete.
OLE DB Data Objects 1) The OLE DB connector is used to communicate with SQL Server 7.0. 3) This Data Object will append records to a database table. A Data Object can also Update existing database records. 4) The Database Connection field is used to select an OLE DB connection to a specific database, or create one if one does not already exist. Click on the Browse button to create a connection. 2) Many Data Objects can use the same connector, and each must be given a unique name.
1) An OLE DB database connection points to a specific database on a specific server. Choose a server from the drop-down list - the local computer is “rsi_mink”. 2) Click “Refresh” to get a list of all the OLE DB compatible databases on that server.
1) Select the database for this connection. RSSql automatically names the Connection. Fill in the user name and password that will be used to log into the selected database on the selected server. (The username “sa” and the default blank password for the system administrator is shown here, but is not recommended.) From this dialog you can create connections to databases on other computers. 2) You can Test the database connection before leaving this screen. Click “Apply” to save the Connection.
2) The database columns to be used in RSSql transactions are selected from the left pane and moved to the right pane with the buttons in the middle. Double-clicking a database column will also move it to the right pane. 3) Clicking “Apply” saves the Data Object. We have created an OLE DB Data Object called Machine_Status_Logging, which will insert records into the Machine_Status table in the server/database referenced by the \\RSI_MINK\RSSql_Tutorial connection, and the columns listed on the right are available to RSSql transactions. A RSSql transaction can refer to one Data Object only, so all the fields necessary for the transaction must be contained in the Data Object. If fields from different tables are required for the same transaction, you can create a View or a Stored Procedure in the database which references multiple tables. 1) The database connection is now specified. Select the desired table in the database from the drop- down list, and the columns contained in that table are listed on the left of the screen.
1) You may also create Data Objects that update records in a database table, as illustrated here. The Update Mode is selected... 2)...and an additional parameter is automatically assigned to each Data Object Column. Update fields are updated by the transaction, and non-Update fields are used to select the proper records in the table to be updated.
1) Finally, a Data Object can use a Stored Procedure. A Stored Procedure is like a database macro programwritten in SQL language. Stored Procedures can have inputs and outputs (called Parameters ), which can beused to create bi-directional transactions which pass information from the control system to the database, andreturn database values to the control system. Select “Stored Procedure”, 2) and choose the desired Stored Procedure fromthe list box. Note RSSql has a Wizard for buildingStored Procedures. 3) What we now see in the left pane are the input and output parameters or variables from the stored procedure. Theinput parameters will be passed into the stored procedure from RSSql, and the output parameters will be sent from thestored procedure to RSSql. All parameters are copied to the right pane to create the Data Object.
ODBC Data Objects RSSql also supports ODBC and Oracle OCI Connectors. Illustrated here is the screen for building ODBCData Objects. The process of creating Data Objects is identical to that for OLE DB Connectors. Only theprocess for defining Database Connections varies. Clicking the Browse button next to the DatabaseConnection field brings up...
…This ODBC Connection dialog box. Select a an existing System DSN from the drop-down box, or click theBrowse button to create a new one.
An ODBC System DSN is available to all users on the computer, including the RSSql ODBC Connectorservice, which runs as an NT service. User DSNs will not work with RSSql. All the existing System DSNsare listed in this Microsoft ODBC Administration tool dialog. Click “Add” to create a new System DSN. Youwill be prompted for a name, a server, a default database, and a user id and password. The System DSN“Tutorial” already exists on this system and is an ODBC connection to the RSSql_Tutorial database.
Choose the System DSN “Tutorial” from the drop-down listof System DSNs.
1) RSSql assigns a Connection Name which is the same as the System DSN, but can be modified. Here again,you may enter a user name and password for the targeted database, which will override the user name andpassword specified in the System DSN. (The username “sa” for the system administrator is shown here, but isnot recommended.) 2) Use the “Test” button to test theconnection before leaving thisscreen, then click “Apply” to savethe connection.
Here is the same Data Object for writing to the Machine_Status table that we created using OLE DB, nowcreated using ODBC. This illustrates the ability of RSSql to manage many different connections concurrently.Note that there is a convenient “Convert” button on all the Data Object screens which is used to convert anexisting Data Object from one connector to another (from ODBC to OLE DB, for example.)
Creating Transactions Now Step 4 has been completed. Now that both the Control System “end” and the Enterprise database system “end” have been defined, we must create the RSSql Transactions, which will bind these two systems together and allow them to exchange data. That is Step 5.
Transactions control the movement of data between the Control System and the Enterprise Database System. You can create many transactions within a configuration that will all be active at the same time. A transaction acts on a single Data Object, but can use Data Points from any Control Connector. First, name the transaction, then choose the Data Object the transaction will use from the drop-down list.
This data object adds a record to the Machine_Status table, and the table columns associated with the Data Object appear in the lower pane. The next task is to define how the data is to be supplied for each of these columns.
Drag and Drop Bindings 2) The checkboxes and drop-downs filter which DataPoints appear in the lowerpane. 3) Then just drag a Data Point from the rightwindow... 1) A double-click of themouse brings up awindow containing all ofthe data points availableto be bound to the DataObject Columns. 4)... and drop it on the correct Data ObjectColumn in the left window. This specifies that thetransaction will copy the current Data Point valueinto the corresponding Data Object Column whenthe transaction is executed. This method can beused for all of the bindings that do not requirecalculations.
Sophisticated calculations can be performed tocreate values to be stored in the database usingRSSql’s Expression Editor. Instead of binding aData Point to the Data Object column, we bind anExpression.
Expression Editor 1) The Expression Editor is a powerful tool that allows you to manipulate data prior to passing it to the database. 3) Diff() returns the difference between the current and previous values. It is ideal for dealing with Timer and Counter values as it automatically takes into account accumulator rollover. 2) Avg(), Min(), Max() and Sum() allow you to deal with aggregations of multiple points. When combined with the Data Point Range function, these functions can provide the same service for a single data point over a time period. 5) Data Points are available to include with expressions can be selected in this drop-down box, or from the... 6)...Filter Data Points screen, which allows you to drag and drop Data Points into the expression string above. 4) Parse() lets you extract individual elements from a data point array, which can contain multiple data types in a single data block. This function will let you strip out the elements you need and convert them to any supported data type.
Once the transaction bindings are complete, the Trigger/Storage button is used to define how the transaction is initiated, or triggered.
Triggers and Schedules 1) RSSql supports three kinds of triggers. “On Scheduled Event” means that RSSql will run the transaction at a prescribed interval between a Starting Event and a Stopping Event. This transaction will run every 10 seconds as long as the RSSql configuration is running. 2) To define new events that can be used for Starting and Stopping Events, click on “Scheduler”
We can create any number of Starting and Stopping Events to be used in triggering RSSql transactions, or modify the example events that are provided.
1) The second triggering option is to have a Control System Data Point be the trigger. This is done by selecting an On Unscheduled Event Trigger and choosing an Unscheduled Data Point. 3) The final trigger allows any external application to trigger a transaction. A call is provided that allows an external “C” or VB application to trigger a RSSql transaction by name. This enables RSSql to be integrated into a larger factory data management application. 4) Once a transaction has executed, you have control over whether or not the resulting data is passed to the database. “On Completion” sends the transaction data to the database after each transaction is executed. The other options allow you to conditionally pass the data to the Enterprise Connection, giving you even more control over the information that ends up in the Enterprise system. 2) Transactions can be triggered based upon a High or Low Transitionof the data point value. The “On Change” option allows you to set a“tolerance band” for the trigger Data Point. Data value changes withinthe band do not trigger a transaction, changes outside the band trigger atransaction. With the “On Scan Rate” option, the transaction willexecute repeatedly at the defined scan rate as long as the Data Pointvalue is non zero (True).
1) With the data bindings defined and the trigger identified, the transaction is nearly complete. Two other options give you important controls over how the transaction operates. The Transaction Timeout specifies how long the Transaction Manager will wait for a transaction to complete before failing. 2) The use of Cached Transaction Files or the Real Time Thread is a unique performance feature of RSSql and is explained in the next few slides.
Cached Transaction Files vs. Real-Time Thread The link between the Transaction Manager and the Enterprise Connector works in two different ways: either using Cached Transaction Files or via a Real-Time Link. Both are illustrated here on the RSSql System Graphic, highlighted in the red box.
Completed transactions can be queued to Cached Transaction Files and sent to the database in large blocks. This enables the Enterprise Connector to perform array inserts into the database, which is much more efficient than inserting one record at a time. RSSql automatically manages this process for maximum reliability. For example, if the Transaction Manager and the Enterprise Connector Services were running on different computers and the computer with the Enterprise Connector Services went down, the Transaction Manager would continue to run RSSql transactions and write to Cached Transaction files. When the computer with the Enterprise Connector Services becomes available, the Transaction Manager would send all of the Cached Transaction Files to it. There would be no interruption in RSSql service, and no transactions will be lost.
Other transactions may require a Real Time Thread (or link) to the database, and cannot use Cached Transaction Files. For example, transactions that use a database stored procedure with outputs need an interactive connection to the database since the database output values are required by the control system immediately.
RSSql will choose Real Time Thread if it required for the transaction to operate. If it is not required, you may still select Real Time Thread. This option is set by transaction.
Verifying and Enabling Transactions 1) Our Transaction is now complete. Click “Apply” to save it. The Transaction Status shows the transaction to be Valid, which means there were no errors in the Transaction Definition. Before the transaction can be Enabled, it must be Verified. 2) Verify performs an end-to-end check of the transaction, from the Data Points to the Data Object Columns, to ensure that there are no conflicts or unintended interactions.
Verify will produce three levels of results: ERRORS - which are fatal and must be corrected before the transaction can be enabled. WARNINGS - which are not fatal but may cause unintended behavior. Transactions with Warnings can be enabled. INFORMATIONAL - which advise you of the settings of some common parameters and their possible interactions. Transactions with Informational Notes can be enabled. The Verify function is also available from the RSSql main screen, where you also can verify multiple transactions and you have the option of saving the results to a file.
1) The transaction is now completely defined. By changing its status to Enabled, RSSql can run this transaction. Click “Apply” to save and “ Close” to dismiss the screen. 2) The binding Import/Export capability may be useful if you are creating multiple transactions that are similar. Import/Export allows you to Export the Binding information at the bottom of this screen to a TSV file (tab separated values). This file can be edited to make changes to the bindings, and the bindings Imported when creating another transaction.
Returning to the Configuration Checklist, all of the required steps are completed to create a minimal configuration. Step 5 can be repeated to create more transactions if they are required. The Verify button will Verify all transactions in the configuration.
A summary line about the first transaction appears on the RSSql main screen when the Transaction Definition toolbar button is selected. All transactions are shown when the Configuration name is selected in the tree. If an individual Connector is selected in the tree, only the transactions which use that Connector will appear. We will briefly show two more transactions to illustrate the important bi-directional capabilities of RSSql.
Transaction with Result Binding 2) Sending a Result code back to the Control System is accomplished by simply checking the “Bind TransactionResult” checkbox. This activates the drop-down box to the right, from which we can select the Data Point which willreceive the transaction result code. RSSql will return a “1” if the transaction completes successfully. Any other numberindicates an error, and the error code is embedded in the result code. The Control System must handle the resultconditions appropriately. Refer to the online Help system for more information on using the Transaction Result. 1) The simplest bi-directional data transfer is to have RSSql return a transaction result to the Control System. That way, the ControlSystem is assured that the data has been saved in the database. This transaction uses the Data Object that updated records in the database.
Transaction with Input/Output Bindings RSSql is capable of sophisticated bi-directional data transfers through database Stored Procedures. Stored Procedure Parameters, defined in a DataObject, can be bound to Data Points. Parameters can be inputs (accept data from the Control System to use in the Stored Procedure), outputs (passStored Procedure results to the Control System), or both. This bi-directional capability lends itself to complex applications.
2) The “stoplights” in the Configuration Tree will turn from red to green as the RSSql services are started.Each of the Connector Services (ODBC, OLE-DB, OPC, etc.) is an NT Service which is started on theappropriate host computer. Each Connector is initialized by the appropriate NT Service.When the Configuration is running, transactions will execute according to the triggering rules that were definedwhen the transaction was created. There is no further user intervention with RSSql at this point. Theconfiguration will continue to run until it is stopped. You can exit the RSSql GUI and the configuration willcontinue to run. In this example, some transactions are triggered by an operator at an RSView32 station.You can stop a RSSql Configuration by clicking on the Configuration name and choosing “Stop” from theConfiguration menu, or by hitting the “VCR” Stop button ( ) 1) In building this configuration, we have explored most of the major functions of RSSql.Now that the configuration is complete, it can be run. You start a RSSql configuration byhighlighting the configuration name in the configuration tree window, then choosing Startfrom the Configuration menu. Alternatively, you can highlight the configuration name andhit the “VCR” Start button ( ) from the RSSql toolbar. Running a Configuration
Monitoring a Configuration You can monitor the transactions as they are executed while your configuration runs. Select “Transaction Monitor”from the toolbar and you will see a summary of cumulative activity by transaction. The Monitor willautomatically update itself, but you can force an update by clicking on the Total column header.
Log Files Another way to monitor the RSSql Configuration is through the Error Log Files. There are Log Files generated atthe Configuration level (the Transaction Manager Log), and by each of the Connectors. The contents of the LogFiles can be sorted by any column by clicking on the column name.
1) To change the level of Error Logging, choose “ErrorLogging” from the “Define” menu. Changes made will takeeffect the next time the configuration is run. 2) Check here to sendRSSql messages to theNT Event Log. 3) Five levels of RSSqlmessages can be storedin the RSSql error logs.Here you can specifythe location of the logfiles, and theirmaximum size. 4) You can also specifythat errors be sent to ane-mail recipient.
RSSql Privileges Another important feature of a RSSqlconfiguration is Security. Select “Properties”from the Configuration menu.
The Privileges tab displays the currentprivileges that have been set for theconfiguration. The default is as you see ithere, which is no privileges. Thisremoves one obstacle to defining andtesting RSSql configurations, but you willwant to add security before theconfiguration is used. Double-clicksomewhere in the white space below theuser names to bring up the ConfigurationPrivileges screen.
1) Click “Enable Security” to activate RSSql’s securityfeatures. 2) Then select NT groups or NT users to add to the three levels of RSSqlprivileges: Admin, Modify, and View. These privileges apply only to usingthe RSSql User Interface, not to running RSSql services, which are definedfor each Connector Service. View members can only view RSSql configurations, Modify members can View and change RSSql configurations, and Admin members can do all of those things as well as start/stop RSSql configurations and change RSSql privileges. Note that privileges apply to asingle RSSql Configuration.
RSSql Wizards There are several Wizards which are not covered in this Tutorial but which may be quire helpful in building your RSSql configurations.“ Create Data Logging ” guides you through the process of creating a simple configuration to log Data Points to a table. The Control Connectors and Enterprise Connectors must be defined.“ Duplicate Data Points ” allows you to copy data points contained in a Control Connector to another Connector/Server/Topic, and to autoname the copied points.“ Duplicate Transaction ” is any easy way to create similar transactions from existing ones.
The Industrial Transaction System More information on the application used in this tutorial isavailable in the Samples section of this CD.