│CIMON-SCADA Help User’s Manual│

1 ODBC
ODBC (Open DataBase Connectivity) is a standard of access method to the database. By
connecting CIMON-SCADA to the common databases such as Access, Oracle, the user
may register data to the common databases or acquire the data from the database
system. Also, using a standard SQL query enables the user to manage the database by
updating, registering, removing the data.

1.1 Window Composition

Double-click [ODBC] or select [Tools] – [ODBC] to bring up the [ODBC] window.

1
On the left side of the window, the DSN of the database system, which is connected to
CIMON-SCADA, and its queries are displayed in tree form. On the right side of the
window, the queries of the selected DSN are listed.

1
DSN(Data Source Name): Name of the application which requested a connection to the data source.

1-1
 ODBC

1.2 Menu

(1) New DBMS

You can configure the DSN of the new DBMS, which will be connected to CIMON-
SCADA system. You can bring up the [DBMS Configuration] system by selecting [Edit] –
[New DBMS] or icon.

Item Description

Enter the ODBC DSN. The name must be identical to the name of the DSN
DB Name registered at “Control Panel\System and Security\Administrative
Tools\ODBC Data Sources”.
Enter the User ID to connect the database assigned to the ‘DB Name’. The
User ID User ID must have authority to process the queries. If you do not need the
User ID, you may leave the field blank.
If you assigned a User ID, enter the password for the ID. If you have not
Password assigned a User ID or it is not necessary to use password, leave the field
blank.
Description Enter the description of the currently configuring database.

1-2
 │CIMON-SCADA Help User’s Manual│

(2) New Query

After the registration of new DBMS, press icon to bring up the [Query
Configuration] window. You can configure the queries of the DBMS in this window.

Item Description

Query Name Enter the name of the Query.

Description Enter the short description of the Query.
Select the Query type between ‘SELECT Statement’ and ‘Others’.
SELECT
This Query type is often used to read multiple records.
Query Type Statement
This Query type is often used to read single record or
Others
update, register, deletion of the record.
Create SQL Brings up the configuration window of the selected Query type.
Automatically executes the Query at regular interval. The
Regular interval can be assigned from 0 to 100 seconds. If you
Interval select ‘Running Base’ option, the query is executed at the
moment of the CIMON-SCADA execution.
Query Operation On Time Executes the Query at the specified time.
Executes the Query on the assigned condition. You may
Event
use conditional expression to execute the Query.
Execute By Executes the Query with the function used in the Script or
Command the command expression.

1-3
 ODBC

(3) Query Type

[SELECT Statement]

You can configure the SELECT Statement when you have selected the ‘SELECT
Statement’ in the [Query Configuration] window. You may configure the SELECT
Statement in 4 sections.

When you link a tag, the data type in DBMS and CIMON-SCADA must be
identical. Also, be aware of the data capacity when you use string field.
E.g.) If data type in DBMS is ‘SMALLINT’, ‘SMALLINT’ must be selected in
ODBC.

1-4
 │CIMON-SCADA Help User’s Manual│

Item Description

No Duplicate Data Select the checkbox to avoid the duplicated data in the Query results.
Defines the record field created by the execution of query. You can bind the
record field and the CIMON-SCADA tag.

Field Name Enter the field name which is defined in the database table.

Assign the tag to be bound to the field. The value of the tag
may be written to the database or the value from the
Tag Name
database can be written to the tag. Generally, the virtual
tags are assigned.
Displays the list of tags in the CIMON-SCADA. You may
Browse
select a tag to assign the value to the ‘Tag Name’ field.
Selects the data type of the assigned field. The selected data

New Field type must be identical to the data type assigned in the
DBMS.

Data Type

DBMS CIMON-SCADA

Text CHAR, VARCHAR, LONGVARCHAR

DECIMAL, SMALLINT, REAL, INTEGER,

Number FLOAT, DOUBLE, NUMERIC, BIT, TINYINT,
BIGINT
Time DATE, TIME, TIMESTAMP

Description Enter the short description of the field.

Edit You may select the configured field on the list and edit the field.

Delete Deletes the selected field.

1-5
 ODBC

▲/▼ Moves the selected field upward or downward.

Assign the table name where the assigned fields belong to. The table name
FROM
must be identical to the name used in the actual database.
Assign the SQL statement to find the desired data. You may use standard
WHERE
SQL.
ORDER BY Assign the criterion of the record alignment.

[Others]

You can configure the other statement when you have selected the ‘Others’ in the
[Query Configuration] window.

 When you link a tag, the data type in DBMS and CIMON-SCADA
must be identical. Also, be aware of the data capacity when you
use string field.
 When you write an SQL statement, you must use quotation marks
to the tag value which corresponds to the string field in the DBMS.
E.g.) When there are numeric tags [1], [2] and string tag [3] in the

1-6
 │CIMON-SCADA Help User’s Manual│

record named ‘DataTable’, write the statement as shown below.

INSERT INTO DataTable
VALUES ([1], [2], ‘[3]’)

Item Description

Assign the tag which will correspond to the SQL statements. When you edit
Binding the SQL statement, assign the value area as “[n]”(n: Decimal Integer). This
area will be replaced with the corresponding tag value.
Assign a tag to be bound to the SQL statement.

Enter the tag name. The assigned tag value will replace the
Tag Name
[n] area of the SQL statement.
Displays the list of tags in the CIMON-SCADA. You may
Browse
select a tag to assign the value to the ‘Tag Name’ field.
Selects the data type of the assigned field. The selected data
type must be identical to the data type assigned in the

New Tag DBMS.

Data Type

DBMS CIMON-SCADA

Text CHAR, VARCHAR, LONGVARCHAR

DECIMAL, SMALLINT, REAL, INTEGER,

Number FLOAT, DOUBLE, NUMERIC, BIT, TINYINT,
BIGINT
Time DATE, TIME, TIMESTAMP

1-7
 ODBC

Description Enter the short description of the field.

Edit You may select the configured field on the list and edit the field.
Delete Deletes the selected field.
▲/▼ Moves the selected field upward or downward.
Write a standard SQL. You may assign the value area as [n]. [n] will be
SQL
replaced with the tag value of corresponding number.

(4) Edit

Press icon to edit the selected DBMS or queries in the corresponding configuration
window.

(5) Delete

Press icon to delete the selected DBMS or queries.

1-8
 │CIMON-SCADA Help User’s Manual│

1.3 Related Features

2
In this section, you can find functions and subroutines frequently used for ODBC. Please
refer to the table below for applicable functions/subroutines. For more detailed
information of each function and subroutine, please refer to the next section.

 You cannot use ODBC related functions in CIMON-WEB/VIEW Control

Server.
 When you use a function in the script, there must be brackets since it
has a return value. Brackets should be removed in subroutines.
 When you use functions and subroutines in command expression,
they must be used with brackets.
 In the script, the functions and subroutines have to be differentiated.

Command Description

Let the database manager execute the query and receive the
Subroutine CSqlOpen
result.
Subroutine CsqlClose Closes the query in the database and ends the operation.

Deletes the currently displayed record from the database

Subroutine CSqlDelete
manager.
Subroutine CSqlFirst Transfers the topmost record data to the tag.
Subroutine CSqlGetRecord Reads the data according to the assigned record number.

Returns the number of active records in the database

Function CSqlGetRecordNo
manager.
Subroutine CSqlInsert Inserts a new record to the database manager.
Subroutine CSqlLast Reads the last record data from the database.

2
Subroutine operates a certain action without any value returned, unlike the functions have return value.

1-9
 ODBC

Subroutine CSqlNext Reads the next record data.

Subroutine CSqlPrev Reads the previous record data.
Subroutine CSqlReconnect Reconnects to the DBMS in case of the disconnection.
Subroutine CsqlRequery Executes the query again and reads the record data again.
Subroutine CSqlRun Let the database manager execute the query.

Updates the record data from database manager with the

Subroutine CSqlUpdate
current tag value.
Subroutine RawSqlRun Executes the command in SQL statement to database.
Function CSqlGetError You can find the error with the return value of the function.

1-10
 │CIMON-SCADA Help User’s Manual│

1.3.1 Functions for ODBC

CSqlOpen Let the database manager execute the query and receive the result.

Command CSqlOpen (“Query Name”)

Subroutine
Script CSqlOpen “Query Name”

‘‘Query Name’ must be registered as SELECT statement in ODBC configuration

window. This subroutine must be called before the execution of any other
record and cursor related functions. When the operation ends, CSqlClose
Description
function must be used to end the operation.
Cursor related functions include the reading, removal, modification and

rerunning of the records.

Executes the query named ‘RetrieveAll’ and receives the result.

Example
CSqlOpen (“RetrieveAll”)

CSqlClose Closes the query in the database and ends the operation.
Command CSqlClose (“Query Name”)
Subroutine
Script CSqlClose “Query Name”

Ends the query when the operations with CSqlOpen and curser-related

functions have finished.

Description
‘‘Query Name’ must be registered as SELECT statement in ODBC configuration
window.

Ends the query named ‘RetrieveAll’.

Example
CSqlClose(“RetrieveAll”)

1-11
 ODBC

CSqlDelete Deletes the currently displayed record from the database manager.
Command CSqlDelete (“Query Name”)
Subroutine
Script CSqlDelete “Query Name”

Deletes the selected record from the DBMS. ‘Query Name’ must be registered
Description as SELECT statement in ODBC configuration window. Also, CSqlOpen
function must be executed beforehand.
Deletes the currently displayed record from the query named ‘RetrieveAll’.
Example
CSqlDelete(“RetrieveAll”)

CSqlFirst Transfers the topmost record data to the tag.

Command CSqlFirst (“Query Name”)
Subroutine
Script CSqlFirst “Query Name”

Moves the current cursor to the topmost record. The indicated record data
replaces the corresponding tag value.
Description
‘Query Name’ must be registered as SELECT statement in ODBC configuration
window. Also, CSqlOpen function must be executed beforehand.
Retrieves the topmost record data of query named ‘RetrieveAll’ to the

Example corresponding tag.

CSqlFirst(“RetrieveAll”)

CSqlGetRecord Reads the data according to the assigned record number.

Command CSqlGetRecord(“Query Name”, Record Number)
Subroutine
Script CSqlGetRecord“Query Name”, Record Number

Reads the data of the assigned Record Number from ‘Query Name’ to the
connected tag.
Description
The ‘Record Number’ starts at 1. If you assign the ‘Record Number’ as –n, it

represents the nth data from the last record.

Reads the first record data of the query named ‘RetrieveAll’ to the bound tag.
Example
CSqlGetRecord(“RetrieveAll”, 1)

1-12
 │CIMON-SCADA Help User’s Manual│

CSqlGetRecordNo Returns the number of active records in the database manager.

Operation CSqlGetRecordNo (“Query Name”)
Function
Script n = CSqlGetRecordNo (“Query Name”)

Description Returns the number of records from the ‘Query Name’’.

Returns the number of record from the query named ‘RetrieveAll’.

Example
CSqlGetRecordNo (“RetrieveAll”) = n

CSqlInsert Inserts a new record to the database manager.

Command CSqlInsert (“Query Name”)
Subroutine
Script CSqlInsert “Query Name”

Assigns the tag values as field value on the moment of the subroutine
execution. Then composes a new record and adds to the DBMS.
Description
‘Query Name’ must be registered as SELECT statement in ODBC configuration
window. Also, CSqlOpen function must be executed beforehand.
Inserts a new record to the query named ‘RetrieveAll’.
Example
CSqlInsert (“RetrieveAll”)

CSqlLast Reads the last record data from the database.

Command CSqlLast (“Query Name”)
Subroutine
Script CSqlLast “Query Name”

Moves the current cursor to the last record and the indicated field value is
moved to the connected tag.
Description
‘Query Name’ must be registered as SELECT statement in ODBC configuration
window. Also, CSqlOpen function must be executed beforehand.
Reads the last record data from the database and saves it to the connected

Example tag.

CSqlLast (“RetrieveAll”)

1-13
 ODBC

CSqlNext Reads the next record data.

Command CSqlNext (“Query Name”)
Subroutine
Script CSqlNext “Query Name”

Moves the current cursor to the next record and the indicated field value is
moved to the connected tag.
Description
‘Query Name’ must be registered as SELECT statement in ODBC configuration
window. Also, CSqlOpen function must be executed beforehand.
Reads the next record data from the database and saves it to the connected

Example tag.

CSqlNext (“RetrieveAll”)

CSqlPrev Reads the previous record data.

Command CSqlPrev (“Query Name”)
Subroutine
Script CSqlPrev “Query Name”

Moves the current cursor to the previous record and the indicated field value is
moved to the connected tag.
Description
‘Query Name’ must be registered as SELECT statement in ODBC configuration
window. Also, CSqlOpen function must be executed beforehand.
Reads the previous record data from the database and saves it to the

Example connected tag.

CSqlPrev (“RetrieveAll”)

1-14
 │CIMON-SCADA Help User’s Manual│

CSqlReconnect Reconnects to the DBMS in case of the disconnection.

Command CSqlReconnect (“DBMS Name”)
Subroutine
Script CSqlReconnect “DBMS Name”

Reconnects to the DBMS. To use DBMS when the connection is broken due
to the unexpected reason, you must use this subroutine.
Description
The DBMS named ‘DBMS Name’ must be registered in CIMON ODBC
configuration.
Reconnects to the DBMS named ‘SampleDB’.
Example
CSqlReconnect (“SampleDB”)

CSqlRequery Executes the query again and reads the record data again.
Command CSqlRequery (“Query Name”)
Subroutine
Script CSqlRequery “Query Name”

Executes the assigned query’s SELECT statement, and reads the record data
again.
Description
‘Query Name’ must be registered as SELECT statement in ODBC configuration
window. Also, CSqlOpen function must be executed beforehand.
Executes the query named ‘RetrieveAll’ again and reads the record data again.
Example
CSqlRequery (“RetrieveAll”)

CSqlRun Let the database manager execute the query.

Command CSqlRun (“Query Name”)
Subroutine
Script CSqlRun “Query Name”

Description Executes the query which is registered in the CIMON-SCADA ODBC.

Executes the query named ‘RetrieveAll’.

Example
CSqlRun (“RetrieveAll”)

1-15
 ODBC

CSqlUpdate Updates the record data from database manager with the current tag value.
Command CSqlUpdate (“Query Name”)
Subroutine
Script CSqlUpdate “Query Name”

Updates the record data from database manager with the tag value indicated
by the cursor.
Description
‘Query Name’ must be registered as SELECT statement in ODBC configuration
window. Also, CSqlOpen function must be executed beforehand.
Updates the record data from database manager with the tag value indicated

Example by the cursor.

CSqlUpdate (“RetrieveAll”)

RawSqlRun Executes the command in SQL statement to database.

Command RawSqlRun(“DBMS Name”, “SQL Statement”)
Subroutine
Script RawSqlRun “DBMS Name”, “SQL Statement”

Executes the command in SQL statement to database. You may use double
Description
quotation marks (“ “) to use the SQL as the second parameter.
Execute the SQL in ‘SampleDB’ , which changes the ‘Data1’ field value of the

record number 4, into 66.

Example
RawSqlRun("SampleDB", "UPDATE DataTable SET Data1 = 66 WHERE

Number = 4")

1-16
 │CIMON-SCADA Help User’s Manual│

1.3.2 ODBC Function for Error

CSqlGetError You can find the error with the return value of the function.
Operation CsqlGetError(“Query Name”)
Function
Script n = CsqlGetError “Query Name”

This function checks out the operation state of the latest ODBC functions such
Description as SCqlInsert and CSqlOpen. If the function operated properly, this function
returns 0. Other return values indicate the errors.
Checks the operation state of the latest function which is executed on the
Example query named ‘RetrieveAll’.
X = CSqlGetError(“RetrieveAll”)

Return Value Description

-2 Invalid configuration, bind or statement.

-1 The function did not operate properly.

0 The function operated properly.

1 Undefined query. The query is not registered in the ODBC manager.

2 An error occurred in the memory.

100 The query is not in format of SELECT statement.

101 CSqlOpen subroutine is not executed.

102 Exceeded the record index.

Cannot close the record due to other references. The function is executed while the
103
database is opened.

The name of the data source does not exist and the base driver is not assigned. Data
1001
source name and the base driver are not assigned in Windows.

Failed to read data since the data does not exist beyond the cursor on the data
1002
source.

Failed to find the assigned field from the record. Or, the query requested by the
1003
SELECT or Other statements are invalid.

1004 The data type of the record and tag data are not equal.

1-17
 ODBC

Failed to update or delete the record. CsqlUpdate or CsqlDelete function is used for
1005 the data which have been already changed. The error occurs when the function is
executed again when the changes are not updated.

Duplicated values are entered in the index, basic key or relation, but the requested
1006 changes are not applied. The error occurs when the data is duplicated in the same
field.

1007 There is no record in the database.

1008 Tried data loading after the deletion of the record data.

1012 ODBC driver does not support Dynaset.

Script Settings when Dynaset Support Error Occurs

This section explains the basics of the feature. Please utilize the feature
according to your site environment.

In the CIMON-SCADA above version 2.4, the version has been changed to the Dynaset.
Therefore, the user cannot use the MS SQL Server driver to connect SCADA and ODBC.
In this case, use CIMON-SCADA V2.3 or lower versions. Alternatively, you may create a
script like “SQL_Select” as shown below.

Sub SQL_Select()

Dim ConnStr As String

‘//You must designate items such as server name.

ConnStr = "DRIVER=MySQL ODBC 5.3 ANSI Driver; SERVER=localhost; DATABASE=test;

User ID=root; Password=x1234"

‘//ADO Connection and creating an instance of record group entity.

Set conn = createobject("ADODB.connection")

Set rs = createobject ("ADODB.Recordset")

‘//Open Database Connection.

conn.Open ConnStr

‘//Inquiry

Set rs = conn.Execute("SELECT * FROM test")

SetTagVal "FIELD1", rs.fields(0)

‘//Close the ADO and record group entity connection.

rs.close

1-18
 │CIMON-SCADA Help User’s Manual│

conn.close

‘//Delete the ADO connection and record group entity.

set rs = nothing

set conn = nothing

End Sub

Sub SQL_INSERT()

Dim ConnStr As String

‘// You must designate items such as server name.

ConnStr = "DRIVER=MySQL ODBC 5.3 ANSI Driver; SERVER=localhost; DATABASE=test;

User ID=root; Password= x1234"

‘// ADO Connection and creating an instance of record group entity

Set conn = createobject("ADODB.connection")

Set rs = createobject ("ADODB.Recordset")

‘// Open Database Connection.

conn.Open ConnStr

‘//Insert

Set rs = conn.Execute("Insert INTO test Value('22')")

'SetTagVal "FIELD1", rs.fields(0)

‘// Close the ADO and record group entity connection.

'rs.close

conn.close

‘// Delete the ADO connection and record group entity.

Set rs = nothing

Set conn = nothing

End Sub

1-19
 ODBC

1.4 Exercise

This section explains the basics of the feature. Please utilize the feature
according to your site environment.

Exercise 1 : ODBC connection using Microsoft Access 2013

In this example, the database created in Microsoft Access will be added to DSN and
modified through the CIMON-SCADA.

(1) Creating Database in MS Access

a) Open Microsoft Access and create a new database named Sample.mdb. Assign the
path and press [Create] button.

b) Designate the table name as DataTable. Right-click on the [Table1] and press
[Design View] to configure the table.

1-20
 │CIMON-SCADA Help User’s Manual│

c) Define the table field as shown below.

Field Name Data Type Field Size

Number Number Integer

Data1 Number Single
Data2 Short Text 80

d) Save the configuration and double-click the table name on the left side of the
window. Then the screen will be changed as shown below to add records.

Number Data1 Data2

1 3.14 Process
2 19.5 Assembly
3 0.02 Examination
4 128.3 Shipment

1-21
 ODBC

(2) Register Access Database as DSN

To use the configured database in CIMON-SCADA, you must register the database as
DSN.

a) Go to Control Panel\System and Security\Administrative Tools and execute the

ODBC Data Sources.

If you are using a Windows Vista or above, and 64-bit OS, you must execute
‘odbcad32.exe’ in C:\Windows\SysWOW64 as administrator.

b) In [User DSN] or [System DSN] tab, press [Add] button.

1-22
 │CIMON-SCADA Help User’s Manual│

On Windows bootup, the user may log on with different user IDs. [User
DSN] is a DSN which allows only the specified user ID to use. [System DSN]
is a DSN which allows all users of the system to use.

c) In the [Create New Data Source] window, select the corresponding driver and press
[Finish]. If you are using Microsoft Access, select Microsoft Access Driver(*.mdb).

d) In the [ODBC Microsoft Access Setup] window, enter the Data Source name and
select [Select] button in ‘Database’ field. The Data Source name must be identical to
the name assigned in CIMON-SCADA ODBC.

1-23
 ODBC

e) In the [Select Database] window, find the database file named ‘Sample’ and press
[OK] to finish the configuration. If the file path changes, you must configure the
current settings again.

f) If the DSN is added correctly, the path of the file will be displayed on the [ODBC
Microsoft Access Setup] window. Press [OK] to finish the ODBC configuration.

1-24
 │CIMON-SCADA Help User’s Manual│

(3) CIMON-SCADA ODBC Settings

a) Select [Tools] – [ODBC] or icon. Alternatively, you may double-click the [ODBC]
on the Project Workspace.

b) Select [Edit] – [New DBMS] or icon to configure the DBMS.

 DB Name: Assign the DSN name. In this example, enter ‘Sample’.

 User ID: Enter the user ID for the database. In this example, leave the field blank
 Password: Enter the password of the user ID. In this example, leave the field
blank.
 Description: Enter a short description of the DBMS.

c) Press OK and the DBMS is added to the CIMON-SCADA.

1-25
 ODBC

(4) Database Reference – SELECT Statement

In CIMON-SCADA, the user may use standard SQL to write a query about the external
common database. In other words, you may acquire a data from the database and save
it in the tag, using SELECT statements.

a) In [ODBC] window, select [Edit] – [New Query] or icon to create a new query
about the DBMS.

 Query Name: RetrieveAll

 Query Type: SELECT Statement
 Query Operation: Execute By Command

1-26
 │CIMON-SCADA Help User’s Manual│

b) Press [Create SQL] button to bring up the [QUERY : SELECT Statement] window
and configure the details of the query. Press [New Field] to connect the database
table field and the CIMON-SCADA tag.

Field Name Tag Name Data Type Note

Number ODBC.NUMBER SMALLINT Tag: Analog, Virtual, INT16

Data1 ODBC.DATA1 REAL Tag: Analog, Virtual, Float
Data2 ODBC.DATA2 VARCHAR Tag: String, Virtual, 80 characters

1-27
 ODBC

c) After configuring the connection between field and the tag, enter the table name
at ‘FROM’ field and press [OK] to end the configuration. In this example, enter
DataTable in the ‘FROM’ field and leave ‘WHERE’ and ‘ORDER BY’ fields blank.

1-28
 │CIMON-SCADA Help User’s Manual│

(5) Configuring the Page

After saving the ODBC configuration, compose the graphic page to check the database
value as shown below.

a) Create an object for the connection to the database as shown below.

Functionality Touch
Action Command Expression
Command CSqlOpen("RetrieveAll")
Let the database manager execute the query (RetrieveAll) and receive the
Description
result

b) Create objects to display the tag value which are storing the field data.

Tag Name ODBC.NUMBER

Display Format ????

Tag Name ODBC.DATA1

Display Format ####.00

Tag Name ODBC.DATA2

Display Format ????

1-29
 ODBC

c) Create touch objects to read the records of database.

Functionality Touch
Action Command Expression

Command CSqlFirst("RetrieveAll")

Description Transfers the topmost record data to the tag.

Functionality Touch
Action Command Expression

Command CSqlPrev("RetrieveAll")

Description Reads the previous record data.

Functionality Touch
Action Command Expression

Command CSqlNext("RetrieveAll")

Description Reads the next record data.

Functionality Touch
Action Command Expression

Command CSqlLast("RetrieveAll")

Description Reads the last record data from the database.

d) Save the configured page and execute the project with CimonX.

e) Press the connection object. If the first record value appears on the page, you have
configured the connection successfully.

1-30
 │CIMON-SCADA Help User’s Manual│

f) Use the touch objects shown below to check if the all records are displayed
properly.

(6) Adding a New Record to the Database1 – SELECT Statement

a) Create objects to change the tag values as shown below.

Functionality EntryData

Action Numeric

Tag Name ODBC.NUMBER

Style Window Style 1

Functionality EntryData

Action Numeric

Tag Name ODBC.DATA1

Style Window Style 1

Functionality EntryData

Action Text

Tag Name ODBC.DATA2

Style Editbox style

b) Create a touch object to execute CSqlInsert("RetrieveAll") function.

Functionality Touch

Action Command Expression

Command CSqlInsert("RetrieveAll”)

Inserts a new record to the database

Description
manager.

c) Execute the project with CimonX and press the connection object.

1-31
 ODBC

d) Create a new record using the ‘EntryData’ objects and press [Insert] button to add
the record to the database. Please do not duplicate the value assigned to ‘NUMBER’
tag and the ‘Number’ field.

e) Terminate the CimonX and open the database file to check if the new record is
added.

1-32
 │CIMON-SCADA Help User’s Manual│

(7) Adding a New Record to the Database 2 – Other Statement

a) In [ODBC] window, select [Edit] – [New Query] or icon to create a new query
about the DBMS.

 Query Name: InsertRecord

 Query Type: Others
 Query Operation: Execute By Command

1-33
 ODBC

b) Press [Create SQL] button to bring up the [QUERY : Others] window.

Press [New Tag] to connect the database table field and the CIMON-SCADA tag. In
[SQL] field, use standard SQL to write a query. At the place where the tag values
will replace, enter the unique number of the tag. Also, use quotation mark in the
string field.

Tag Name Data Type Note

ODBC.NONSEL.NUMBER SMALLINT Tag: Analog, Virtual, INT16

ODBC.NONSEL.DATA1 REAL Tag: Analog, Virtual, Float
ODBC.NONSEL.DATA2 VARCHAR Tag: String, Virtual, 80 characters

c) Finish the ODBC configuration and return to the graphic page.

1-34
 │CIMON-SCADA Help User’s Manual│

d) Create a touch object to acquire the changed data.

Functionality Touch

Action Command Expression

Command CSqlRequery("RetrieveAll”)

Executes the query again and reread

Description
the record data.

e) Create objects to check and change the values of the newly added tags.
(ODBC.NONSEL.NUMBER, ODBC.NONSEL.DATA1, ODBC.NONSEL.DATA2)

f) Create a touch object to execute the query named “InsertRecord”.

Functionality Touch

Action Command

Command CSqlRun("InsertRecord")

Let the database manager execute

Description
the query.

1-35
 ODBC

g) Execute the project with CimonX and change the values of tags
(ODBC.NONSEL.NUMBER, ODBC.NONSEL.DATA1, ODBC.NONSEL.DATA2) as
shown below. Then press [Insert record with SQL statement] button to execute the
assigned command expression.

h) To check the added data, press the connection object. When the first record
appears on the window, press button to execute CSqlLast("RetrieveAll")
function.

1-36
 │CIMON-SCADA Help User’s Manual│

i) Terminate CimonX and open the database file to check the updated data.

(8) Removal of the Record From Database1 – SELECT Statement

a) Create a touch object to execute CSqlDelete() subroutine.

Functionality Touch

Action Command Expression

Command CSqlDelete("RetrieveAll")

Deletes the currently displayed record from

Description
the database manager.

b) Execute the project with CimonX and press the connection object.

c) When the first record data appears on the screen, use buttons to
display the record to be deleted.

d) Then press [Delete] button to execute CSqlDelete("RetrieveAll") function.

e) Press [Refresh] button to execute CSqlRequery("RetrieveAll") function.

1-37
 ODBC

f) Terminate the CimonX and open database file to check if the deleted record still
exists.

(9) Removal of the Record From Database 2 – Other Statement

a) In [ODBC] window, select [Edit] – [New Query] or icon to create a new query
about the DBMS.

 Query Name: DeleteRecord

 Query Type: Others
 Query Operation: Execute By Command

1-38
 │CIMON-SCADA Help User’s Manual│

b) Press [Create SQL] button to bring up the [QUERY : Others] window. Press [New
Tag] button to connect the database table field and the CIMON-SCADA tag. In
[SQL] field, use standard SQL to write a query.
Use ODBC.NONSEL.NUMBER tag to indicate the record to be deleted.

c) Finish the configuration and save the ODBC settings.

d) Create a touch object to execute the query named ‘DeleteRecord’.

Functionality Touch

Action Command Expression

Command CSqlRun("DeleteRecord")

Let the database manager

Description
execute the query.

1-39
 ODBC

e) Execute the project with CimonX and assign the key value of the record to be
deleted to ODBC.NONSEL.NUMBER tag. Then press the [Delete record with SQL
statement] button to delete.

f) You can check the result by using ‘RetrieveAll’ query or opening the database file
after the termination of the CimonX.

(10) Updating a Database Record1 – SELECT Statement

a) Create a touch object to execute CSqlUpdate () command.

Functionality Touch

Action Command Expression

Command CSqlUpdate("RetrieveAll")

Updates the record data from database

Description
manager with the current tag value.

1-40
 │CIMON-SCADA Help User’s Manual│

b) Execute the project with CimonX and press the connection object.

c) When the first record data appears on the screen, use buttons to
display the record to be updated.

d) Use the button below to change the value of ODBC.Data1 tag.

Functionality EntryData

Action Numeric

Tag name ODBC.DATA1

Display Window Style 1

e) Change the value and press [Update] button to update the change.

f) Terminate the CimonX and open the database file to check the changed data.

1-41
 ODBC

(11) Updating a Database Record 2 – Other Statement

a) In [ODBC] window, select [Edit] – [New Query] or icon to create a new query
about the DBMS.

 Query Name: UpdateRecord

 Query Type: Others
 Query Operation: Execute By Command

1-42
 │CIMON-SCADA Help User’s Manual│

b) Press [Create SQL] button to bring up the [QUERY : Others] window. Press [New
Tag] button to connect the database table field and the CIMON-SCADA tag. In
[SQL] field, use standard SQL to write a query. At the place where the tag values
will replace, enter the unique number of the tag. Also, use quotation mark in the
string field.

Tag Name Data Type Note

ODBC.NONSEL.DATA1 REAL Tag: Analog, Virtual, Float

ODBC.NONSEL.NUMBER SMALLINT Tag: Analog, Virtual, INT16

c) Finish the configuration and save the ODBC configuration.

1-43
 ODBC

d) Create a touch object to execute the query named ‘UpdateRecord’

Functionality Touch

Action Command

Command CSqlRun("UpdateRecord")

Let the database manager

Description
execute the query.

e) Change the value of ODBC.NONSEL.NUMBER and ODBC.NONSEL.DATA1 as

shown below. Press [Change record with SQL statement] to change the value. In
this example, the record number 4 will be changed.

f) To check the added data, press the connection object. When the first record
appears on the window, press button to find the changed
record.

1-44
 │CIMON-SCADA Help User’s Manual│

g) You can also find the changes in the database file after the termination of CimonX.

1-45
 ODBC

Exercise 2 : ODBC Connection with MS SQL Server 2014 Express

(1) Registration of MS SQL DNS

To use the configured database in CIMON-SCADA, you must register the database as
DSN.

a) Go to Control Panel\System and Security\Administrative Tools and execute the

ODBC Data Sources.

If you are using a Windows Vista or above, and 64-bit OS, you must execute
‘odbcad32.exe’ in C:\Windows\SysWOW64 as administrator.

b) In [User DSN] or [System DSN] tab, press [Add] button.

1-46
 │CIMON-SCADA Help User’s Manual│

c) In [Create New Data Source] window, select the SQL Server and press [Finish].

d) In [Create a New Data Source to SQL Server] window, enter the name to represent
the data source and the SQL Server to connect. Enter the server as [IP, PORT] or
[SQL Host Name\Server name].
E.g.) 172.x.x.x, xxxx or SERVERNAME\SQLEXPRESS

1-47
 ODBC

e) Change the SQL Server authenticity of the login ID and enter the Login ID, then
press [Next].
The ID must be registered beforehand. The ID ‘sa’ is a system administrator of SQL
Server and the password is assigned when you installed the SQL Server.

f) Change the default database and press [Next]. The database must be defined
beforehand.

1-48
 │CIMON-SCADA Help User’s Manual│

g) Configure the rest of the options and press [Finish].

h) [ODBC Microsoft SQL Server Setup] window will be brought up. Press [Test Data
Source] button to proceed the test, then press [OK[ to finish the ODBC
configuration.

1-49
 ODBC

(2) CIMON-SCADA ODBC Setup

a) Select [Tools] – [ODBC] or icon. Alternatively, double-click the ODBC from the
Project Workspace.

b) To configure the DSN of the new DBMS in the [DBMS Configuration] window,
select [Edit] – [New DBMS] or icon.

 DB Name: Enter the DSN.

 User ID: Enter the user ID of the database. This ID must have the authority to
process the queries.
 Password: Enter the password of the user ID.
 Description: Enter the short description of the configuration.

c) The external common database is registered to CIMON-SCADA.

1-50