SYS600 Application Design
SYS600 Application Design
SYS600 Application Design
4
Application Design
Trace back information:
Workspace Main version a50
Checked in 2015-06-08
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Contents
1 Copyrights ............................................................................................. 19
2 Introduction ........................................................................................... 21
2.1 This Manual .................................................................................. 21
2.2 Use of symbols ............................................................................. 21
2.3 Related documents ....................................................................... 22
2.4 Document conventions ................................................................. 22
2.5 Document revisions ...................................................................... 23
3
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
4
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
5
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
6
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
7
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
8
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
9
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
10
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
11
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
12
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
13
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
14
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
15
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
22 Authorization .........................................................................................493
22.1 Default authorization levels ...........................................................494
22.2 Authorization Groups .................................................................... 494
22.2.1 Customization authorization groups ............................... 496
22.2.2 Control authorization groups ...........................................499
22.2.3 Configure authorization groups .......................................500
16
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
25 Terminology ...........................................................................................517
Appendices
17
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
18
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
1 Copyrights
The information in this document is subject to change without notice and should not be
construed as a commitment by ABB Oy. ABB Oy assumes no responsibility for any
errors that may appear in this document.
In no event shall ABB Oy be liable for direct, indirect, special, incidental or consequential
damages of any nature or kind arising from the use of this document, nor shall ABB Oy
be liable for incidental or consequential damages arising from the use of any software
or hardware described in this document.
This document and parts thereof must not be reproduced or copied without written
permission from ABB Oy, and the contents thereof must not be imparted to a third party
nor used for any unauthorized purpose.
The software or hardware described in this document is furnished under a license and
may be used, copied, or disclosed only in accordance with the terms of such license.
Copyright © 2015 ABB Oy. All rights reserved.
Trademarks
ABB is a registered trademark of ABB Group. All other brand or product names
mentioned in this document may be trademarks or registered trademarks of their respective
holders.
Guarantee
Please inquire about the terms of guarantee from your nearest ABB representative.
Third Party Copyright Notices
List of Third Party Copyright notices are documented in "3rd party licenses.txt" and
included in SYS600 and DMS600 installation packages.
19
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
2 Introduction
Although warning hazards are related to personal injury, and caution hazards are
associated with equipment or property damage, it should be understood that operation
of damaged equipment could, under certain operational conditions, result in degraded
process performance leading to personal injury or death. Therefore, comply fully with
all warnings and caution notices.
21
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
22
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
23
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
25
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
The application requires its own connections to the process equipment in the form of
system and application objects. System objects describe how the system is configured.
Application objects are more related to signal flow, when indications are received in the
application database or process devices, which are controlled in the application. For
more information, see SYS600 Application Objects and SYS600 System Objects.
The Power Process Library is included in SYS600. This library contains generic functions
for building process displays for distribution/transmission network. These functions can
be used during application engineering to model application related processes. Each
standard function contains a set of configurable attributes, which specify how the signal
flow is passed between the process devices and the application database.
The following standard functions are included in the Power Process Library:
• Station
• Bay
• Switching Device
• Tap Changer
• Measurement
• Alarm Indicator
• Auto Reclose
• Trip Signal
• Generator
• Line Indicator
If the SYS600 system also contains Standard Application Library LIB 5xx products,
they are included in the list of standard functions as well.
26
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
For more information on symbols, see Chapter 6 Standard functions of Power Process
Library.
Expand the SA_LIB Process node, select a standard function, then click Install or press
ENTER. The Standard Function Tool is now opened, see Figure 3.3.
Standard Function Tool contains the Attributes, Programs, and Tools tabs, see
Figure 3.3.
27
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
In Standard Function Tool, the standard function related configurable attributes are
displayed and configured in the Attributes tab. In the Programs tab, select the program
that is to be edited. The standard function specific tool is found on the Tools tab.
When Standard Function Tool is opened, the default values are assigned in the attribute
list. During application engineering, these attributes are engineered to the values required
by the application in question. When Apply is clicked, the configuration for these
attributes is created. The next step is to start the Process Object Tool from the Tools tab.
This can be done either by double-clicking the Process Object Tool in the list or by
selecting the Process Object Tool and clicking Open.
28
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
29
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
The OA and OB attributes are displayed and handled as process object type dependent
encoded values, like in the Process Object Form of Object Navigator, thus they are not
necessarily the same values as stored in the SYS600 process database. The titles for OA
and OB fields are surrounded with brackets to indicate this encoding and slight address
naming inaccuracy. Both the OA and OB attributes are displayed as decimal numbers,
ignoring the Output Type attribute definition.
A separate edit area (bottom of the Existing tab) is used for editing purposes in this tab.
Read only columns for the attributes are also shown in the process object list of the
Existing tab.
When an existing process object is selected in the Process Object Tool, the current
attribute values for IU, SS, UN, OA and OB are displayed in the edit area together with
their corresponding dialog commands. When multiple process objects are selected, the
attribute values of the first selected object are shown in the edit area. If an attribute value
is modified, it affects the attribute value for all the selected process objects.
However, if multiple process objects are selected, then the OA and OB attribute fields
are disabled. The UN attribute is the only address attribute that can be changed alone.
If either OA or OB attribute is changed, all the three/two address attributes must be
defined before applying the change. If all address attributes UN, OA and OB have their
initial values (UN=0, OA=0 and OB=16), they are shown as empty fields.
The change in IU or SS attribute value is executed immediately after modifying the value
of the edit control, except for multiple selected objects. After this, a confirmation prompt
appears. The UN, OA and OB attribute changes are executed only after the user clicks
the Enter button on the right hand side of the attribute edit areas, or presses the ENTER
key on the keyboard.
The Other tab shows indexes that are not recognized by a standard function. This happens
when the user creates new indexes for an existing process object group in the Object
Navigator. For more information on the Object Navigator, see SYS600 Application
Objects.
Object Browser can be used for creating display symbols based on existing process
objects in the process database. The browser contains the insertable objects structured
in tree view. Object Browser is opened by selecting Object Browser in the Actions
menu of the Display Builder.
Object Browser displays the object structure for all applications. An application can be
selected from the drop-down list in the upper part of the dialog. Select an application
from the list and click the Select... button to update the view.
Symbols can be inserted in the display by dragging them to the drawing area. Station
and bay symbols are dragged from the corresponding node. As an example, dragging an
Incoming 110kV object in Fig. 3.5 creates a bay symbol in the display. Dragging an
Eastwick object creates a station symbol.
30
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
The workflow when using SCL Importer as well as the different options that can be used
are described in the following chapters.
The SCL Importer tool is opened from the Tool Manager's Application Objects tab.
31
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
1. In the Main view, browse the SCD/CID file to be imported. If the selected file is of
CID type, Object Identification needs to be filled in.
2. Select the Application and Language from the drop-down list.
3. Define the additional options found from the Main view and from the Options menu.
4. Click Preview to see details of the data being imported.
5. Click Import.
6. View the created process objects and their indexes by clicking View Log, which is
activated after importing.
32
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
33
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
In case of SCD files, unit numbers are given at this phase for all IEDs found from the
file.
Once the Unit Number(s) are defined, a dialog for assigning properties for External DA
Client Configuration file is shown.
OPC Server ProgID lists available OPC DA Servers. If none is found, then option
<Unknown IEC 61850 Server> is available. In this case, the External OPC DA Client
configuration file can be created, but the correct IEC 61850 OPC server information has
to be filled in later on to the OPC Client Config file.
34
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
After the IEC 61850 OPC server configuration is done, server information can be defined
with External OPC Client Configuration Tool.
If Assign IED to Client Automatically is selected in the Main view, MicroSCADA
SCL Importer resolves the correct OPC Server ProgID for the IED.
OPC Client Config File defines the name and location of the configuration file.
If Override File is checked, a new file for External OPC DA Client is created. This file
will contain only the configuration defined in imported SCD/CID file. Backup is taken
from the existing one.
CPI Node Number is the node number of the External DA Client in MicroSCADA
configuration.
System Messages Enabled (SE) defines how system messages (used for System Self
Supervision purposes) are updated to MicroSCADA process database. When 1 is selected,
analog status points are updated. When 4 is selected, both analog and binary status points
are updated.
As the status for the IEDs is received as binary information, 4 should be used.
In the IED Name field, the name of the IED being configured is shown.
When Overwrite Process Objects is selected in the Main view, process object that has
the same Logical Name (LN) that is being created by MicroSCADA SCL Importer is
deleted and then re-created.
If Preserve Modified Attribute Values is selected, a copy is taken from the existing
process object before it is deleted, and the attributes of the copied object and a new object
are merged. This way, for example, if a certain Event Handling object was connected to
a process object, the same configuration is also found from the new process object.
35
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
In Options > Import Settings, there is a possibility to affect to the amount of process
objects that are created, and to enable or disable the possibility to affect the logical name
of process objects.
When Create process Objects according to Datasets is selected, the program checks
that a Logical Node (e.g. CSWI) is found both from substation section and data set in
CID/SCD file. If both conditions are fulfilled, process objects are created for the Logical
Node in question.
When Use Character Mappings is selected, the mappings made in the Options >
Character Mapping dialog are taken into account when creating process objects.
When Use Device Name Mappings is selected, the mappings made in the Preview >
Device Name Mapping dialog are taken into account when creating process objects.
When Use Logical Naming Conventions is selected, the rules defined in the Options
> Logical Naming Conventions dialog are taken into account when creating process
objects.
36
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Create Process Objects for DuoDriver Server status is enabled only if DuoDriver is
installed. When this function is used, process objects for DuoDriver server supervision
are created during the SCL import. Preferably dedicated Unit numbers should be assigned
for DuoDrivers, since they do not belong to any IED.
During import, the logical name of a process objects is formed from Substation, Voltage
Level and Bay defined in the SCL Importer Main view. Also, this information is set to
the object identification (OI attribute).
For process objects, the allowed characters are the letters A-Z, all digits and the underscore
(_). However, there can be cases when some special characters are wanted to be used in
object identification e.g. "ä". In those cases, the characters that are not allowed in the
logical name of process objects can be converted into allowed characters with the help
of the Character Mapping dialog.
By default, some character conversion are shown. In order to add a new character
conversion, click the last shell in the Character column and add the character to be
37
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
converted. Then, click the corresponding Converted column field and fill in the converted
character.
With the Logical Naming Conventions dialog, it is possible to affect the length of the
logical name of the process objects.
The number of characters taken to the process object name from Station, Voltage Level,
Bay and Device in Main view can be defined.
For example, if Station Name Characters is 3, the three first letters from a station name
is used in process object name and so on.
It is also possible to define a separator. If this option is selected, the underscore (_)
character will be used as a separator.
38
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
With Device Name Mapping, it is possible to affect the device name part of object
identification and the logical name of the process objects. By default, the IEC61850
Logical Node information found from the CID/SCD file is used for this part, or a device
name is created by internal algorithms in MicroSCADA SCL Importer.
Device Name Mapping dialog can be opened from the Import Preview dialog. All
device names found from the CID/SCD file are shown on the left side, and the converted
value can be defined on the right side.
In order to change the device name, click the field in the Converted column and type
in a new device name.
39
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
When the data is written from the Input Object to the process database, it is done in two
phases, which are always required to write data to the process database:
1. First, the Input Object sets the data variable to a certain value, for example, when
the mouse moves above the Input Object slider. The data variable value is changed
accordingly, but the value is not yet written into the process database. The data
variable for the set operation can be defined by selecting the data variable in the
Input Object Properties dialog.
2. The data variable is written to the data source (MicroSCADA OPC server). This
happens when the user clicks on the object. The data variable for writing can be
defined in the Rules tab of the Input Objects Properties dialog, see Fig. 3.17.
There are two ways to create an Input Object and connect it to the process database:
• Set a data variable to a certain value and write the value to a data source in the same
object, as described in the example below.
• Do it in separate objects. For example, there can be two buttons: the first button sets
a variable1 to value x, and the second button writes the value of variable1 (x) to
variable2.
2. 2. Select the location for the Input Object by dragging a rectangle on the drawing
area. Now you can see the Input Object on the drawing area, see Fig. 3.15.
3. Right-click the Input Object and select Input Object Properties to open the Input
Object Properties dialog. The data variable that is mapped to the object is displayed
in the Variables field , see Fig. 3.16.
40
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
4. To change the mapped data variable, click Change and select the data variable.
5. Click OK.
6. Right-click the Input Object and select Properties.
7. Click the Create a New Rule button on the Rules tab, see Fig. 3.17.
41
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
8. Select Write Data Var to Data Var from the drop-down list in the Action column
to open the Data selection for the Writable Vars dialog.
9. Select the data varible you want to write to. You can select the same variable that
was defined in the Input Object Properties dialog.
10. The Data Selection dialog is displayed. Select the variable from where the data is
read in this dialog. This can be the same data variable that was used as the target
data variable.
As default, Input Object is shown as a slider. To change its layout, right-click the Input
Object and select the Types tab in the Input Object Properties dialog and select another
layout.
42
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
To define application options, select Settings > Application Settings. The user can
specify application specific options, such as:
• System name
• System location
• Startup display, first display shown after login
• Application language
• Daylight Saving time handling
• Process controlling dialog settings
• Hard disk space limit supervision
To modify these options, authorization level must be Engineering (2). For more
information see, Chapter 22 Authorization.
43
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
A certain Process Display can be defined to be shown after logging by browsing the
Process Display to the Startup Display box. The Process Display can be any .v or .sd
type. It is also possible to define other displays by clicking the Startup Display box.
Select the Display and add the existing preconfiguration name after the display, for
example Event Display MyPreconfiguration.
System location is an attribute that needs to be configured. This defines whether SYS600
is running as Network Control Center (NCC) or Substation Control System (SCS).
To be able to make any changes in the application settings, the user's authorization level
must be Engineering (2) in the authorization group PRO_OPTIONS_HANDLING. For
more information about authorization, see Chapter 19 User Account Management.
To save the new settings, click OK or Apply. Clicking Cancel returns the previous
settings.
44
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
45
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
When Automatically adjust applications for daylight saving time changes option is
enabled, application specific actions can be defined in the following command procedures:
• BGU_TIMEFO:C, executed when the clock is moved forwards (Daylight saving
time activated).
• BGU_TIMEBA:C, executed when the clock is moved backwards (Daylight saving
time deactivated).
The point of execution time is 20 seconds after the change. Command procedures are
executed in each found LOCAL application according to the application mapping.
When the Automatically adjust applications for daylight saving time changes option
is enabled, the application handling the actions can be selected from the drop-down list.
To save the new settings, click OK or Apply. Clicking Cancel returns the previous
settings.
46
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Control timeout defines the timeout for control confirmation dialog used to execute or
cancel operations. With Dialog timeout, it is possible to define the user inactivity time
in the desktop before the Control Dialog expires.
Horizontal offset and Vertical offset values configure the position of the Control Dialog.
To activate or deactivate option, select or clear the check box. To save the new settings,
click OK or Apply. Clicking Cancel returns the previous settings.
47
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
The user can give a lower alarm limit for disk space by selecting the alarm limit from
the Alarm limit drop-down list. The required limit can also be typed in. The limit is
presented as megabytes.
If the alarm limit is set to zero (0), the hard disk supervision is stopped. A warning limit
is calculated from the alarm limit. The warning limit is 10% higher than the low alarm
limit.
To save the new settings, click OK or Apply. Clicking Cancel returns the previous
settings.
48
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
49
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
50
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
5 SQL Exporter
SQL Exporter is used to get an HSI (human-system interface) for selecting process
objects to be sent to an SQL database. With SQL Exporter, a process object can be
connected to a history database, a measurement database (cyclic) or to both.
To set up the connection between the SQL server and SYS600:
1. Create a database.
2. Create tables for cyclical measurement recording and history recording.
3. Create user accounts.
4. Enable communication between the SQL database and SYS600.
5. Edit command procedures.
6. Test the user accounts and database.
51
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
The main menu bar contains four menus: File, Edit, View, and Help.
• File contains three menu commands:
- Exit
- Import from file
- Export to file
For more information about the import and export functions, see Section 5.9 Exporting
list and Section 5.12 Importing list.
• Edit has three menu commands:
- Clean RDBMS Objects
- SQL Logging enabled and SQL Logging disabled
For more information about the functions, see Section 5.13 Cleaning objects and
Section 5.5.1 Enabling and disabling SQL logging .
• View contains one menu command:
- Toolbar, which hides the main toolbar.
• Help contains one menu command
- About SQL Exporter, which provides information about SQL Exporter and
the SYS600 system, such as version numbers and license information.
52
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
5.1.2 Toolbar
• Database Objects
Process objects in the database are filtered according to the database filter options.
When an object is selected, the object's OI (Object Identifier) and OX (Object Text)
are shown in the Selected Process Object field. If the object can be added to the
SQL system, Add is activated.
• Selected Process Object info
When a process object in the Database Objects or the objects list is clicked, the
object is displayed in this field. If several objects are selected, the field is empty.
• RDBMS objects
The process objects connected to the SQL database are listed under the objects.
When a process object is selected, information about the object is displayed in the
Selected Process Object info field and Remove... is activated.
• Database selection
To choose whether the object should be connected to the history database, the cyclic
database or both, select one of the check boxes or both. SQL Exporter suggests the
history database for indications and alarms and the cyclic database for analog values.
If more than one object is selected, no suggestions are made.
• The Add and Remove... buttons
To add or remove objects that are to be connected to the SQL system, use the Add
or Remove... buttons. These buttons are enabled and disabled according to what is
allowed to do with the selected process objects. For more information about adding
or removing process objects, see Section 5.8.1 Adding process object and
Section 5.8.2 Removing process objects.
• Process object filter options
53
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
The five optional filters can be used one at a time or together. The selected filters
apply to both the process objects and to the SQL process objects lists. For more
information about the filter options, see Section 5.8.4 Using database filter options.
54
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
• Moment
• Moment_IX
If several signals from a process object have the same LN and IX, the values are indexed
with the Moment_IX time stamp.
To create a table:
1. Open the Enterprise Manager and create a new table.
2. Name the table columns for the database as shown in Figure 5.3.
55
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Figure 5.4 describes how an update of a process object’s value is distributed to the cyclic
database, that is, to the MSPDB SQL table.
MSPDB
What is updated?
Process Object
· When the user adds a process object
to the cyclic database in the tool, the
process object is added to a list in the
file T_objects.dat
· When the object is removed from the
cyclic database it is also removed from
T_objects.dat
Updating data
Time Channel Command Procedure
SQL_FLUSH_T SQL_FLUSH_T
· Executes the SQL_FLUSH_T command · Executes com.proc. SQL_FLUSH
procedure with variable TIME=yes
· Execution cycle (CY2) = 15 min · SQL_FLUSH reads from
T_objects.dat which process objects
values to update in MSPDB
56
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
57
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
58
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
When the user adds a process object to the history database (MSPDB_Hist SQL table)
in SQL Exporter, the process object is connected to the SQL_WRITE_DB_EVENT
event channel. Figure 5.6 describes how, for example, a change in an indication object
is distributed to the history database.
MSPDB_HIST
Queuing data
Process Object Event Channel Command Procedure
· Connected to the event SQL_WRITE_DB_EVENT SQL_WRITE_DB_EVENT
channel via attribute AN · Connected to the · Writes SQL commands to
· Action Activation (AA) command procedure via Queue.txt about what to
on new value or ack. attribute AN insert to MSPDB_Hist
Dequeuing data
Time Channel Command Procedure
SQL_FLUSH
· Executes the SQL_FLUSH SQL_FLUSH
command procedure · Reads SQL commands from Queue.txt
· Execution cycle (CY2) = 5 sec about what to insert into MSPDB_Hist.
The SQL tables register changes only. If the states of the process objects are static,
nothing is updated in the tables.
59
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
2. Define options for the new SQL user, see Figure 5.8.
3. Type the user name in the Name field.
4. Select the SQL Server Authentication option from the Authentication field.
5. Type the default password in the Password field.
6. Select a database created before, for example SCADA, from the Database drop-down
list.
7. Select the Database Access tab.
60
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
8. Define the database that the user can access by selecting the database defined before,
see Figure 5.9.
9. Select the new user from the Database Role field.
61
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
10. Click Properties to open the Database User Properties dialog, see Figure 5.10.
11. Define the needed permissions.
62
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Select Edit > SQL enabled/SQL disabled to turn on or off the logging to SQL. The
function is useful when working with the application.
63
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
3. Select the SQL Server in the Create New Data Source dialog, see Figure 5.12.
64
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
65
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
8. Click Next.
9. Select the SQL server authentication and type the user name and password in the
Login ID and Password fields, see Figure 5.14. Use the same user name as created
in Section 5.5 Creating user accounts.
66
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
67
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
68
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
14. Click Finish. After creating the database, test it as described in Section 5.7 Testing
user accounts and databases.
To enable SQL Exporter to log on to the SQL database, edit the SQL_FLUSH command
procedure in SYS600, see Table 5.2.
Table 5.2: Command procedures to be edited
SQL_DATABASE Rename the value with the same name as used to
refer to the data source in Section 5.6 Enabling com-
munication between SQL database and SYS600.
SQL_USER Rename the value with the same name as created in
Section 5.5 Creating user accounts.
SQL_PASSWD Rename the value with the same name as created in
Section 5.5 Creating user accounts.
@SQL_DATABASE="MQIS"
@SQL_USER="Administrator"
@SQL_PASSWD="RSSlabra"
;*********************************************
69
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Order by mspdb.moment
Order by mspdb_hist.rt
70
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
2. Select whether to add the process objects to the history or to the cyclic database or
both.
3. Click Add.
In general, measurements are added to the cyclic database while indications, alarms, and
so on are added to the history database.
Note that this action does not actually remove anything from
the history database with the SQL Exporter. This only stops
the process object's value from being registered in the history
database when it is removed from the objects list. Clicking the
Remove... button does not remove any rows from the cyclic
database. It only stops the object's value from being updated
in the SQL database.
Excel can be used to create a list where the user has selected which process objects are
to be connected to the SQL database. Create a list in Excel with four columns:
1. In the first column, add logical names (LN).
2. In the second column, add an index (IX).
3. In the third column, add an X if the process object should be connected to the history
database.
4. In the fourth column, add an X if the process object should be connected to the
measurement database.
The import function in the SQL Exporter starts reading process objects only from the
second row, so if a process object is on the first row, it is ignored. Make sure that the
71
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
columns are separated with commas or semicolons and not with any other character.
Otherwise, the SQL Exporter cannot read the file correctly. For more information about
saving the Excel list in a correct format, see Section 5.12 Importing list.
An easy way to get a pre-made list of the process objects in the current application is to
use the export function in SQL Exporter. For more information about exporting, see
Section 5.9 Exporting list. After exporting, import the list to Excel and add the X:s. For
more information about importing, see Section 5.10 Opening list in Excel.
The process objects in the SYS600 and SQL databases can be filtered according to their
attributes LN, IX, PT, OA and UN. To use a filter, select the check box of the desired
filter. It is possible to use the filters independently or several filters combined.
Note that both the Database Objects and RDMS Objects lists
in the SQL Exporter are filtered using the same filters.
Filters:
• LN (Logical Name): Use an asterisk (*) as a wildcard character at the end of the
filter string. The filter is case sensitive.
• IX (Index): Enter an index number. It is only possible to enter numbers, wildcard
characters are not allowed.
• PT (Process Object Type): Select the desired type of objects list to be visible:
- 3 – Single indication
- 6 – Digital input
- 9 – Analog input
- 12 – Double indication
• OA (Object Address): Enter an object address number. It is possible to enter numbers
only, wildcard characters are not allowed.
• UN (Unit Number): Enter a unit number. It is possible to enter numbers only,
wildcard characters are not allowed.
72
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
• IX
• Send to history database
• Send to measurement database
Mark the process objects that are connected to the history or the measurement database
respectively with an X in the corresponding column.
The CSV file can be imported to, for example, Excel. For more information about opening
the CSV file in Excel, see Section 5.10 Opening list in Excel.
73
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
74
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
8. Click OK.
To refresh the external data range when the original text file changes:
1. Click Refresh Data on the External Data toolbar.
2. Select the text file in the Import Text File dialog.
3. Click Import.
To change the settings made in the Text Import Wizard:
1. Click Edit Text Import on the External Data toolbar.
2. Select the text file in the Import Text File dialog.
3. Click Import.
4. Make the desired changes in Text Import Wizard.
To import only part of the data in a text file as a refreshable data range, a query can be
created to retrieve the data.
The CSV file can be generated, for example, with Excel or Notepad. Save the file as a
CSV file. The most convenient way to create a list to be imported to SQL Exporter is to
use Excel on an existing process object list.
To import a list by using Excel:
75
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
4. The file is saved as a text file with semicolons separating the columns and each row
ending with a carriage return.
Make sure that the columns are separated with commas or semicolons, and not with any
other character. Check this by opening the file with, for example Notepad, see Figure 5.21.
Otherwise, SQL Exporter cannot read the text file correctly.
If any other character than semicolon or comma is used as a delimiter, replace the
character with a semicolon or comma. To replace delimiters in Notepad, select Edit >
Replace.
Example:
In Figure 5.22, the process object FMU_ALARM is added to the history database and
B_HDS is added to the measurement database.
76
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
All process objects available in the current application do not necessarily have to be
included in the imported list. Including only the desired objects to the SQL system is
enough.
An error log is created:
• If the process object list contains a process object that does not exist in the user's
current application.
• If the user tries to add a process object that already is connected to an event channel
to the history database.
The error log is located in the same folder as the file that is being imported (filename:
<imported file>_ERROR.LOG).
77
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
79
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Procedure U_INTERLOCKING
This procedure can be used for defining custom interlocking conditions for the control
dialog. The procedure is executed at control dialog startup. The procedure must return
a LIST with the following attributes:
Table 6.2: Attributes for Procedure U_INTERLOCKING
Attribute Description
OPEN_INTERLOCKED BOOLEAN, open interlocking state. If TRUE, the Open button
is disabled in the control dialog.
CLOSE_INTERLOCKED BOOLEAN, close interlocking state. If TRUE, the Close button
is disabled in the control dialog.
INTERLOCKING_CAUSE TEXT, reason of the interlocking to be displayed in control
dialog info field.
80
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
6.4 Station
This chapter describes the installation of station standard function from the Power Process
Library. The standard function for the station is found in the directory
/SA_LIB/BASE/BBONE/INST and it should be installed by using the Power Process
Library installation procedures (SA_LIB/Process/Station). The standard function can be
configured by using the Object Navigator tool.
The Power Process symbol for station standard function is installed by using Display
Builder functions:
1. Object Browser
2. Palette
For more information, see the SYS600 Process Display Design manual.
Table 6.3: Power Process symbol for station standard function
File name Symbol
Station BI.sd
The station standard function has the following attributes to be configured with the
Standard Function Tool:
Table 6.4: Configurable attributes
Attribute Meaning Default
STATION_NAME Name of the substation -
P_OBJECT_LN Logical name of database pro- -
cess objects
STATION_TYPE The type of control device & LON
protocol
CMD_PARAMETER The type of control command N/A
for
OUTPUT_STATUS Process objects for output N/A
status with DNP 3.0 protocol
81
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
For more detailed description on the configurable attributes, see Section 6.15 Descriptions
of the configurable attributes.
Depending on the configuration of the station standard function, the Process Object Tool
creates a certain set of the process objects into the database. Process objects that will be
linked to the actual process should be edited to have a station number, an address and a
proper switching state. Otherwise, by default, all other attributes should have suitable
values for normal operation.
The Process Object Tool creates process objects based on the following list:
Table 6.5: Process objects created by the Process Object Tool
Index Explanation Purpose
10 Station local/remote switch The station local/remote switch is used to determine
indication whether the control of station objects is allowed from
the panel (local), from the substation control system,
from the remote control system or whether station
authority checking is out of use.
11 Station local/remote switch The station local/remote switch to Local command
to Local command or Sta- object is an output object which is designed to set
tion/Remote command the station control to local (panel) when the attribute
IND_DOUBLE_BINARY is checked.
If IND_DOUBLE_BINARY is not checked, output
object is used for setting the switch either to Station
or Remote.
82
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
83
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
This section describes the structure of the station standard function. All subdrawing files
form pictures, help and other text files, as well as database objects are included. The
station is a part of the standard functions of Power Process Library and has a directory.
6.4.3.2 Files
The table below lists all of the station standard function related files and their
functionality.
Table 6.7: Station standard function related files
File Functionality
Station BI.sd Power Process symbol for /PROG/GRAPHICSEN-
Station.sd station standard function GINE/PALETTE/04-SA_Indica-
tion
FORM5SAGR1.PIC Generic format picture for /SA_LIB/BASE/BBONE/USE
printing
The following Text Translation Tool compatible text files are used by the station standard
function. The path is /SA_LIB/BASE/BBONE/LANG0.
Table 6.8: Text Translation Tool compatible text files
File Functionality
SAI_STA2.TXT Text file for the database creation of the stand-
ard function
The following configuration files are used by the station standard function. The path is
/SA_LIB/BASE/BBONE/INST.
84
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
The following text file is used by the station. The path is /SA_LIB/BASE/BBONE/USE.
Table 6.11: Another text file used by the station
File Functionality
BGU_AUTH.TXT Contains the SCIL code for the station authority
check. The code is executed by the dialog for
the station.
The following process objects are created depending on the configuration of the station.
Table 6.12: Process objects created by manually operated station local/remote
switch
Index Obj. Process object Remarks Group identifier
type
10 DB/BI Station local/remote switch ind. - FPASTAILRS
15 AI Blockings Internal FPASTAXBLK
16 AI Station selected on monitor Internal FPASTAXMEV
110 EVREC Station local/remote switch ind. RP-570 only FPASTAELRS
110 AI Station local/remote switch ind. ANSI only FPASTAELRS
85
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
At the first installation, the station creates the scale 1_1 (linear 1:1 scale). For
SPACOM/SRIO (ANSI) station type, the installation will also create the scale
FPU_1_1000 (linear 1:1000 scale).
At the first installation, the station creates the command procedure BGU_UPDATE,
which updates process objects when they are update-deblocked. This feature is similar
to the SYS600 Blocking Display function. It is also used by the Update process data
function in the control dialog.
For SPACOM/SRIO (ANSI) station type, the installation creates the command procedure
BGU_AI2DB, which updates the station level local/remote switch indication double
binary from an analog input.
For SPACOM/SRIO (ANSI) station types, the installation creates the event channel
BGU_AI2DB, which is set to activate the command procedure BGU_AI2DB.
6.5 Bay
This section describes the installation of the bay standard function in Power Process
Library. The standard function for the bay is found in the directory
86
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
The Power Process symbol for the bay standard function is installed by using the Display
Builder functions:
1. Object Browser
2. Palette
For more information, see the SYS600 Process Display Design manual.
Table 6.14: Bay Switch Indication
File name Symbol
Bay BI.sd
The bay standard function has the following attributes to be configured with the Object
Navigator:
Table 6.15: Configurable attributes
Attribute Meaning Default
STATION_NAME Name of the substation -
BAY_NAME Name of the bay -
P_OBJECT_LN Logical name of database pro- -
cess objects
STATION_TYPE The type of control device & LON
protocol
CMD_PARAMETER Parameter for control method N/A
for IEC 60870-5-101/104 and
DNP 3.0 protocol
OUTPUT_STATUS Process objects for output N/A
status with DNP 3.0 protocol
AUTHORIZATION_GROUP The name of the authorization MV_CONTROL
group
BAY_LR_IN_USE Physical L/R-switch exists/not Bay L/R-switch exists
available
BAY_LR_POLARITY Polarity of the bay L/R switch L1
87
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
For more detailed description on the configurable attributes, see Section 6.15 Descriptions
of the configurable attributes.
Depending on the configuration of the bay standard function, the tools create a certain
set of process objects in the database. Those process objects that will be linked to the
actual process should be edited to have a station number, an address and a proper
switching state. Otherwise, by default, all other attributes should have suitable values
for normal operation.
The tools create process objects based on the following list:
Table 6.16: Process objects created for the bay
Index Explanation Purpose
10 Bay local/remote The bay (disabled)/local/remote switch is used to determine
switch indication whether the control to the bay objects is completely inhibited, or it
is allowed locally or remotely.
11 Bay local/remote The bay local/remote switch to Disabled command object is an
switch to Disabled output object which is designed to set the bay control to disabled
command, or bay (no control locally or remotely).
local/remote com- If IND_DOUBLE_BINARY is not checked and STATION_TYPE is
mand IEC 61850-8, this output object is used for setting bay L/R switch
either to local or remote.
12 Bay local/remote The bay local/remote switch to Local command object is an output
switch to Local object, which is designed to set the bay control to the local (panel).
command
88
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
89
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
This section describes the structure of the bay standard function. All subdrawing files,
form pictures, help and other text files, as well as database objects are included. The bay
is a part of the standard functions of the Power Process Library and has a directory.
90
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
6.5.3.2 Files
The table below lists all bay standard function related files and their functionality.
Table 6.18: Bay standard function related files
File Functionality Path
Bay BI.sd Power Process symbol for the /PROG/GRAPHICSENGINE/PALETTE/04-
Bay.sd bay standard function SA_Indication
FORM5SAGR1.PIC Generic format picture for printing /SA_LIB/BASE/BBONE/USE
The following Text Translation Tool compatible text files are used by the bay standard
function. The path is /SA_LIB/BASE/BBONE/LANG0.
Table 6.19: Text Translation Tool compatible text files
File Functionality
SAI_BAY2.TXT Text file for the database creation of the standard function
The following configuration files are used by the bay standard function. The path is
/SA_LIB/BASE/BBONE/INST.
Table 6.21: Configuration files used by the bay standard function
File Functionality
SAI_BAY2.DAT Contains the configuration data for the bay when it is created, modified
or deleted by the configuration tools.
SAI_BAY2.POT Contains the process object definitions for the Object Navigator.
INDEX5_B1.TXT Selection list of Power Process Library standard functions for the install-
ation tool.
The following text file is used by the bay. The path is /SA_LIB/BASE/BBONE/USE.
91
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
At the first installation, the bay creates the command procedure BGU_UPDATE, which
updates process objects when they are update-deblocked. This feature is similar to the
SYS600 Blocking Display function. It is also used by the Update process data dialog.
Table 6.23: Command procedures used by bay
File Functionality
BGU_CONTROL Performs the actual control operations.
The following process objects are created depending on the configuration of the bay.
Table 6.24: Process objects created by manually operated bay local/remote switch
Index Obj. Process object Remarks Group identifier
type
10 DB/BI Bay local/remote switch ind. - FPABAYILRS
15 BI Interl. in use/out of use (SW) Hardware sw. FPABAYIINH
(MFU)
Optional
16 BI Interl. in use/out of use (HW) Software sw. FPABAYIINH
(MFU)
Optional
17 BO Interl. in use/out of use -cmd Command to MFU FPABAYCINH
Optional
18 BI Interl. in use/out of use Internal FPABAYIINH
Optional
19 BO Interl. in use/out of use -cmd Internal FPABAYCINH
Optional
20 AI Blockings Internal FPABAYXBLK
Optional
21 AI Bay selected on monitor Internal FPABAYXMEV
Optional
110 EVREC Bay local/remote switch ind. RP-570 only FPABAYELRS
Optional
110 AI Bay local/remote switch ind. ANSI only FPABAYELRS
115 EVREC Interl. in use/out of use (SW) RP-570 only FPABAYEINH
Optional
92
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
93
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
At the first installation, the bay creates the scale 1_1 (linear 1:1 scale). For
SPACOM/SRIO (ANSI) station type. The installation also creates the scale FPU_1_1000
(linear 1:1000 scale).
For SPACOM/SRIO (ANSI) station type, the installation creates the event channel
BGU_AI2DB, which is set to activate the command procedure BGU_AI2DB.
94
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
This section describes the installation of the switching device standard function from
the Power Process Library. The standard function for the switching device is found in
the directory /SA_LIB/BASE/BBONE/INST and it should be installed by using the
Power Process Library installation procedures (SA_LIB/Process/Switching Device).
This standard function is configured by using configuration tools, such as the Object
Navigator.
The Power Process symbol for the switching device standard function is installed by
using the following Display Builder functions:
1. Object Browser
2. Palette
For more information, see the SYS600 Process Display Design manual.
Table 6.26: Power Process symbol for switching device standard function
File name Representation Symbol
Horizontal Vertical Horizontal Vertical
Breaker H.sd Breaker.sd ANSI
95
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
The switching device standard function has the following attributes to be configured
with the Object Navigator:
Table 6.27: Configurable attributes
Attribute Meaning Default
STATION_NAME Name of the substation -
BAY_NAME Name of the bay -
DEVICE_NAME Name of the device -
P_OBJECT_LN Logical name of database process -
objects
SWITCHING_DEVICE_TYPE Type of switching device Circuit breaker
SWITCHING_DEVICE_PURPOSE Usage of the selected switching Circuit breaker
device type
SWITCH_SECTION Switch section of the truck or 3- Truck: first section
state switch 3-state switch: dis-
connector
STATION_TYPE Type of control device & protocol LON
INDICATION_TYPE Type of position indication pro- Double binary
cess object
MOTORIZED Selection of motorized or manu- Motorized
ally operated
CMD_PARAMETER Parameter for control method for N/A
IEC 60870-5-101/104 and DNP
3.0 protocol
CONTROL_TYPE Type of control process object(s) Secured control
with 4 binary out-
puts
OUTPUT_STATUS Process objects for output status N/A
with DNP 3.0 protocol
CONTROL_PULSE_LENGTH Length of control pulse 0
CONTROL_BITS Bits to be used to send a control Empty vector
command
AUTHORIZATION_GROUP Name of the authorization group MV_CONTROL
BAY_LR_POLARITY Polarity of bay L/R switch L1
TAGOUT Release the Tagout function for Not used
this switching device
AUXILIARY_PLUG Selection if the switching device Stand-alone switch
is mounted in the truck
EVENT_RECORDING Process objects for event record- No process objects
ing with RP-570
96
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
For more detailed description on the configurable attributes, see Section 6.15 Descriptions
of the configurable attributes.
Depending on the configuration of the switching device standard function, the tools
create a certain set of process objects in the database. Those process objects that will be
linked to the actual process should be edited to have a station number, an address and a
proper switching state. Otherwise, by default, all other attributes should have suitable
values for normal operation.
The tools create process objects based on the following list:
Table 6.28: Process objects created for switching device
Index Explanation Purpose
10 Position indication Used for position indication of the switching
device state open/closed/ intermediate/faulty.
11 Open select or Depending on the defined control type it is used
open execute for sending Open select or Open execute to
the control unit.
12 Close select or Depending on the defined control type it is used
close execute for sending Close select or Close execute to
the control unit.
97
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
98
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
99
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Attribute Value
CONTROL_TYPE Secured control with 4
binary outputs
OUTPUT_STATUS N/A
CONTROL_PULSE_LENGTH N/A
CONTROL_BITS N/A
AUTHORIZATION_GROUP MV_CONTROL
BAY_LR_POLARITY L1
TAGOUT No
AUXILIARY_PLUG No
EVENT_RECORDING N/A
This section describes the structure of the switching device standard function. All
subdrawing files, form pictures, help and other text files, as well as database objects are
included. The switching device is a part of the standard functions of the Power Process
Library and has a directory.
6.6.3.2 Files
The table below lists all switching device standard function related files and their
functionality.
Table 6.30: Switching device standard function related files
File Functionality Path
Breaker.sd SA ANSI symbol for breaker /PROG/GRAPHICSEN-
GINE/PALETTE/03 - SA_ANSI
Disconnector.sd SA ANSI symbol for discon- /PROG/GRAPHICSEN-
nector GINE/PALETTE/03 - SA_ANSI
Truck.sd SA Common symbol for truck /PROG/GRAPHICSEN-
GINE/PALETTE/01 - SA_Com-
mon
Breaker.sd SA IEC symbol for breaker /PROG/GRAPHICSEN-
GINE/PALETTE/02 - SA_IEC
Contactor.sd SA IEC symbol for contactor /PROG/GRAPHICSEN-
GINE/PALETTE/02 - SA_IEC
Disconnector.sd SA IEC symbol for disconnect- /PROG/GRAPHICSEN-
or GINE/PALETTE/02 - SA_IEC
100
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
The following Text Translation Tool compatible text files are used by the switching
device standard function. The path is /SA_LIB/BASE/BBONE/LANG0.
Table 6.31: Text Translation Tool compatible text files
File Functionality
SAI_SSW.TXT Text file for the database creation of the stand-
ard function
The following configuration files are used by the switching device standard function.
The path is /SA_LIB/BASE/BBONE/INST.
Table 6.33: Configuration files used by the switching device standard function
File Functionality
SAI_SSW.DAT Contains the configuration data for the switching
device when it is created, modified or deleted
by the configuration tools.
SAI_SSW.POT Contains the process object definitions for the
Object Navigator.
INDEX5_B1.TXT Selection list of the Power Process Library
standard functions for the installation tool.
101
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
The following text file is used by the switching device. The path is
Table 6.34: Another text file used by the switching device
File Functionality
BGU_AUTH.TXT Contains the SCIL code for the station authority
check. The code is executed by the dialog of
the switching device.
At the first installation, the bay creates the command procedure BGU_UPDATE, which
updates process objects when they are update-deblocked. This feature is similar to the
SYS600 Blocking Display function. It is also used when simulation mode is disabled in
the control dialog.
For the indication type of single indication (BI), the installation will create the command
procedure BGU_BI2DB, which updates the position indication double binary from the
binary input.
For the indication type of an analog input (AI), the installation will create the command
procedure BGU_AI2DB, which updates the position indication double binary from the
analog input.
For the indication type of two single indication (2xBI), the installation creates the
command procedures BGU_2BI2DB and BGU_SETDB, which are used to update the
position indication double binary from two binary inputs.
Table 6.35: Command procedures used by the switching device
BGU_CONTROL Performs the actual control operations
Function Functionality
OBJECT_INFO Gets configuration of the standard function.
GET_OI_TEXT Gets object identification text.
SELECT_ON_MONITOR Sets standard function to selected on monitor
state.
OPEN_SELECT Performs open select command on standard
function.Uses text file
/sa_lib/base/bbone/use/BGU_SW_SEL.TXT
UNSELECT_ON_MONITOR Removes selected on monitor state from
standard function.
CLOSE_SELECT Performs close select command on standard
function.Uses text file
/sa_lib/base/bbone/use/BGU_SW_SEL.TXT
OPEN_EXECUTE Performs open execute command on standard
function.Uses text file
/sa_lib/base/bbone/use/BGU_SW_EXE.TXT
102
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Depending on the configuration the following process objects are common to all switching
devices.
103
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
The following process objects are created depending on the configuration of the switching
device.
Table 6.37: Manually operated circuit breaker, disconnector or earth switch. The
process objects to be created with the tools.
Index Obj. type Process object Remarks Group identifier
10 DB Position indication FPQxxxIPOS
19 AI Object selected Optional FPQxxxXMEV
on monitor
21 BI Auxiliary plug in- Optional FPQxxxIAUX
dication
49 DI Tagout indication Tagout released FPXTAGXIND
50 DI Tagout history Tagout released FPXTAGXEVT
108 BI Close position in- Indication type FPQxxxEPOS
dication 2xBI
110 BI or AI Position indication Ind. type AI, BI or FPQxxxEPOS
or open position 2xBI
indication
110 EVREC Event recording Indication type FPQxxxEPOS
DB for position indica- DB
tion RP-570 only
Optional
121 EVREC Event recording RP-570 only FPQxxxEAUX
BI for auxiliary plug Optional
indication
208 EVREC Event recording Indication type FPQxxxEPOS
BI for close position 2xBI
indication RP-570 only
Optional
210 EVREC Event recording Ind. type AI, BI or FPQxxxEPOS
BI or AI for position indica- 2xBI RP-570 only
tion or open posi- Optional
tion indication
104
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Table 6.38: Motorized circuit breaker, disconnector or earth switch. The process
objects to be created with the tools.
Index Obj. type Process ob- Remarks Group identifier
ject
10 DB Position indica- FPQxxxIPOS
tion
11 BO Open com- Sec. control with 4xBO, FPQxxxCOBC
mand or Open 2xBO or 2xDO
execute
12 BO Close com- Sec. control with 4xBO, FPQxxxCOBC
mand or Close 2xBO or 2xDO
execute
13 BO Execute com- Sec. control with 4xBO, FPQxxxCOBC
mand or or 5xBO
Open/Close
select and Ex-
ecute/Cancel
command or
Open execute
command
14 BO Cancel com- Sec. control with 4xBO FPQxxxCOBC
mand or close or 5xBO
execute com-
mand
15 BI/AI External con- AI when the selected FPQxxxIBLK
trol blocking station type is
IEC 61850-8
16 BI External inter- Optional FPQxxxIINH
lock for open
cmd
17 BI External inter- Optional FPQxxxIINH
lock for close
cmd
18 AI External inter- Optional FPQxxxIINH
locking cause
19 AI Object selected Optional FPQxxxXMEV
on monitor
20 BI Object com- Optional FPQxxxICEV
mand event
21 BI Auxiliary plug Optional FPQxxxIAUX
indication
25 BO Cancel com- 5xBO FPQxxxCOBC
mand
105
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
106
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Table 6.39: Manually operated truck. The process objects to be created with the
tools.
Index Obj. type Process object Remarks Group identifi-
er
30 DB Position indication FPQT01IPOS
39 AI Object selected on Optional FPQT01XMEV
monitor
49 DI Tagout indication Tagout released FPXTAGXIND
50 DI Tagout history Tagout released FPXTAGXEVT
128 BI Close position indic- Indication type 2xBI FPQT01EPOS
ation
130 BI or AI Position indication Ind. type AI, BI or FPQT01EPOS
or open position in- 2xBI
dication
130 EVREC Event recording for Indication type DB FPQT01EPOS
DB position indication RP-570 only
Optional
228 EVREC Event recording for Indication type 2xBI FPQT01EPOS
BI close position indic- RP-570 only
ation Optional
230 EVREC Event recording for Ind. type AI, BI or FPQT01EPOS
BI or AI position indication 2xBI RP-570 only
or open position in- Optional
dication
Table 6.40: Motorized truck. The process objects to be created with the tools.
Index Obj. type Process object Remarks Group identifi-
er
30 DB Position indication FPQT01IPOS
107
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
108
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Table 6.41: Manually operated three-state switch. The process objects to be created
with the tools.
Index Obj. type Process object Remarks Group identifier
10 DB Position indication Disconnector sec- FPQ301IPOS
tion
11 DB Position indication Earth switch sec- FPQ301IPOS
tion
25 AI Object selected Optional FPQ301XMEV
on monitor
49 DI Tagout indication Tagout released FPXTAGXIND
50 DI Tagout history Tagout released FPXTAGXEVT
108 BI Close position in- Indication type FPQ301EPOS
dication 2xBI
Disconnector sec-
tion
109 BI Earth position in- Indication type FPQ301EPOS
dication 2xBI
Earth switch sec-
tion
109
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Table 6.42: Motorized three-state switch. The process objects to be created with
the tools.
Index Obj. type Process object Remarks Group identifi-
er
10 DB Position indication Disconnector sec- FPQ301IPOS
tion
11 DB Position indication Earth switch section FPQ301IPOS
12 BO Open command or Sec. control with FPQ301COBC
Open execute 4xBO, 2xBO or
2xDO
13 BO Close command or Sec. control with FPQ301COBC
Close execute 4xBO, 2xBO or
2xDO
14 BO Free command or Sec. control with FPQ301COBC
Free execute 4xBO, 2xBO or
2xDO
110
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
111
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
112
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
At the first installation, the switching device creates the scale 1_1 (linear 1:1 scale). For
indication type of analog input, the installation will also create the scale BGU_1_1000
(linear 1:1000 scale).
In a switch control dialog, the CO, CV, CE and CL attributes of the DB process object
are used for operation counting. Regardless of whether the counting is used or not, the
attributes are always readable.
6.7 Tagout
Tagout is a procedure for disabling equipment to protect maintenance and service
personnel from either an unexpected release of energy, or an accidental start-up while
performing field activities.
The Tagout function provides locks (control block)/inhibits (update blocks) on control/data
points.
A tagout can be assigned to switching devices. The main focus is on breaker tagout
facility. The facility allows for selection from a set of user defined tagout classes, which
specify lock, remote lock, inhibit, remote inhibit, priority and other class attributes.
Lock, remote lock specifies whether a control can pass through locally or remotely.
Inhibit, remote inhibit specifies whether status will be reported locally or remotely.
113
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
The system allows operators to lock control of devices by means of a secure, multi-level
tag feature. This feature allows operators to apply an unlimited number of tags to each
point, each tag being stored with a date/time stamp and an operator entered description.
Every tag and un-tag operation can be logged and it generates an event.
The system permits no means of bypassing the control inhibit caused by a tag. This
applies to any and every application interacting with the system.
A tag symbol indicating the control inhibit conditions can be displayed next to the device
on all displays where the device is presented. The following information can be defined
for each tag type:
• tag symbol to be displayed
• tag priority
• tag reason
• type of controls that will be inhibited by the tag, i.e. open and close, or information
only (no control inhibit)
• other optional tag information
The Tagout function can be enabled with the Power Process Library Standard Function
Configuration tool.
For the Tagout function to be taken into use for selected switching devices, it has to be
configured. For that purpose, the attribute TAGOUT within the Standard Function
Installation and Configuration Tool for switching devices can be used. This attribute is
disabled by default. It will be enabled after the Tagout function has been initialized. The
initialization takes place with the first Tagout Class Editor usage.
The tagout attribute will be used for the Control dialog to show/hide the Tagout tab.
A set of attributes forms a Tagout Class. Tagout classes can be adjusted with the Tagout
Class Editor.
Table 6.43: Tagout class attributes
Attribute name Description and properties
Mandatory attributes
Date/Time Date and time of tagout activation and modification.
Priority None, Very Low, Low, Medium, High, Very High.
The list content can be modified with the Tagout Class Editor.
Reason Men at work, equipment in service, abnormal condition, other.
The list content can be modified with the Tagout Class Editor.
Owner The user/owner name will be taken over from the current
active MicroSCADA user.
114
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
The attribute names and their properties can be modified with the Tagout Class Editor.
Each attribute has the following basic properties:
1. Name (internal name, not editable),
2. Title, editable with Tagout Class Editor,
3. Used or not used within this class,
4. Visible in tagout views as there are, Control Dialog Tagout tab and Tagout List,
5. Enabled, attribute value is visible but the user cannot change the default value,
6. Logging release,
7. History/event handling release.
Class data
Only one tagout class can be active at a time. Out of the amount of pre-configured classes,
one class can be activated.
The active tagout class can only be changed when there is no tagout assigned to any
switching device.
All class properties are stored in a SYS600 SCIL Database (SDB) located in the
application \apl_ directory.
The tagout class database is located in sc/'application name'/apl_.
The database file name is apl_tagout.sdb.
Active tagout
Active tagout(s) on a control/data point will be stored in the tagout class database with
their logical name (LN) and index (IX) as section name.
115
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Multiple tagouts, as well as multiple priorities on one object are supported. Depending
on the used tagout presentation type, the tagout indicators for either the highest priority,
or all priorities will be shown on the display.
116
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
117
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Date + Time + Object Identifier + Prefix OX + Separator + Owner Attr. Title + Owner
Name
Table 6.44: Event descriptions
Event Item Description Definition in Class Editor Default
Date Date and time of tagout Tagout Date attribute value
activity
Time Tagout Time attribute value
Object identifier From position indication
object
Prefix OX Tagout name descriptor Root node\Settings\His- Tagout:
tory\Tagout prefix OX
Owner name Current logged on Micro-
SCADA user
Owner attribute title Title for the attribute Active class\attribute\own- Owner
Owner er\title
Separator Separator between each Root node\Settings\His- ,
event item in the object tory\Separator
Attribute Title Title for the attribute Active class\attribute title
causing the event
Attribute Value New value assigned to Active class\attribute value
the attribute causing the
event
The Event state text uses the event handling object SAGR_TAGOUT_HIST. The state
text can be modified with the Tagout Class Editor by editing the root/settings/history
section.
118
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
The log file entry for the different activities has the following format:
For edit and remove attribute actions:
Date + Time + Separator + Object Identifier + Separator + Owner Name + Separator +
Tagout activity + Separator + Attr. Title + Separator + Attr. Value
29-05-2009 Rivers Wilbur Q0 DEMO Attr. value changed Reason Out of service
17:33:44
29-05-2009 Rivers Wilbur Q0 DEMO Attribute removed local Set
17:29:14 lock
119
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Time
Object Identifier From position indication object
Owner Name Current logged on MicroSCADA user
Tagout Activity Root node\Settings\Log-
ging\Tagout Action Text
The following table shows some possible symbols. In this example, the ANSI type of
breaker function is used.
Table 6.46: Tagout presentation symbols
Presentation Priority value
Option 1 Option 2 Option 3 Option 4
(Bit weight)
Priority order 5 priority levels
Pattern frame Solid frame Text Indicator
2
(1)
(2)
120
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
(3)
16
(4)
32
(5)
62
(1,2,3,4,5)
56
Only one representation type per tagout instance can be used. It is not possible for the
operator to change the representation type for a tagout instance.
One special type of symbol is part of the delivery. This symbol acts as a container for
up to 8 subdrawings, which can be modified on a project specific base. See Figure 6.5
below.
121
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
The quantifier is the value stored in the tagout indication process object value (OV) for
the selected priority.
The priority plays the most important role when it comes to the tagout symbol shown in
the displays.
122
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
For the simple type of symbols as, for example, Tagout with solid frame, the color
selection is based on the currently assigned priority. If multiple tagouts are assigned, the
highest priority will be used for the color presentation.
By using the Tagout indicator symbol, the priority (up to 5 priority levels) for all active
tagouts for one switching device can be made visible.
The tagout symbol colors representing the different priority states can be modified with
the Color Setting Tool, see Figure 6.7 below.
The following table shows the relation between priority quantity and Power Process
Library color indexes.
Table 6.47: Color index reference to priority value
Data variable Power Process Lib- Class attribute
rary
Value Color index Priority (default) Quantity
>=0 and <1 116 None (Lowest) 0
>=1 and <2 115 Very low 1
>=2 and <4 114 Low 2
>=4 and <8 113 Medium 4
>=8 and <16 112 High 8
>=16 and <32 111 Very high 16
>=32 and <64 110 Highest 32
>=64 and <128 117 Free (Reserve 1) 64
>=128 and <256 118 Free (Reserve 2) 128
- 119 Reserved 3 -
123
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
The tagout symbols are installed with Display Builder tool using the Object Browser.
There are three options for installing a tagout symbol:
1. As a group of symbols, switch device symbol together with the tagout symbol, with
automatic creation and mapping of all used data variable. See Figure 6.8 below.
2. Only the tagout symbol, with automatic creation and mapping of all used data
variable. See Figure 6.9 below.
124
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
3. From the 01 - SA_Common palette without automatic creation and mapping of all
used data variable. See Figure 6.10 below.
125
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
In the Switch Control dialog, the Blocking tab will be replaced with a Tagout tab if the
active tagout class contains action method attributes. The Tagout tab is only visible for
objects where the tagout function has been enabled with the Standard Function
Configuration Tool.
The properties and view for the Tagout tab can be adjusted with the Tagout Class Editor.
The Tagout tab is used for presenting all active tagouts for the selected switching device,
see Figure 6.11 below.
The tab is also the only place where the user can add, edit and remove tagouts by using
the Add, Remove... and Edit buttons. Active tagouts can only be edited and removed
by the owner of the tagout. The owner name is fetched from the currently logged on
MicroSCADA user.
126
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
The dialog for adding and editing tagouts can contain several tabs, see Figure 6.12 above.
The title and position of these tabs can be adjusted with the Tagout Class Editor.
In case of an error in communication between Switch Control dialog and the tagout class
database, the user will be informed with and error notification dialog, see Figure 6.13
below.
The error message text can be modified with the Tagout Class Editor.
127
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
The standard blocking attributes need a special treatment when used within the Tagout
function. To highlight this, the term Action_Methods is be used for these attributes.
Table 6.48: Tagout Action Methods
Method name Purpose SYS600 attribute notation
Local lock Block control from SA system UB update blocking commands
Lock remote Block control form remote system Depends on remote connection. For COM
500i, commands received from an NCC will
be blocked and a negative action confirma-
tion will be sent back to the NCC.
Inhibit local Update block from process UB update blocking for indication. Reset will
force a data update to the process level
device
Inhibit remote Update block upwards to NCC Depends on the remote connection. For
COM 500i, sending an update to NCC will
be blocked.
Standard blocking attributes
Inhibit Alarm Blocks all alarm activation from alarm- AB, alarm blocking
ing objects within the current group
Inhibit Event Blocks all alarm events for objects with HB, history blocking
enabled history function within the cur-
rent group
Inhibit Printout Blocks all prinouts for objects with en- PB, printout blocking
abled printout function within the current
group
Inhibit Processing Blocks all further processing for objects XB, activation blocking
with enabled reprocessing function
within the current group
Blocking attributes, which have been activated or deactivated with the Tagout function,
are not enabled in other standard blocking attribute views, such as the Blocking list and
the Blocking tab inside the Switch Control dialog. The blocking state will be visible but
it cannot be changed.
The set of process objects included in the object search, depends on the selection made
in the Tagout Class Editor, see Section 6.7.6.8 Action Method settings.
Every change in any of the action method attributes will launch the user defined command
procedure SAGR_TAGOUT_AMUD.
The following parameters will be provided:
• Logical Name
• Main indexes (Index 10 for Indication, Index xx for commands, depending on
command type)
• Action Method attribute name, e.g. LOCALLOCK, REMOTEINHIBIT
• New value for changed attribute
128
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
This user defined command procedure can be used, for project specific code, to perform
actions related to process level devices, either to activate some locking inside an IED or
to inform a possible external gateway, for example, COM6xx or COM581, about tagout
changes related to their function.
Tagout Class Editor is a tool for modifying the properties of each tagout class and their
attributes.
Figure 6.14: Tagout Class editor, Class root page, Attributes tab
129
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
The following basic settings for tagout class attributes can be done in the class root page
(see Figure 6.14 above):
• Taking an attribute in use or out of use.
Attributes set to Not in use will be ignored in all Tagout function components
• Setting an attribute as Visible in List and Tab view
• Enabling changing attribute value in add/edit dialog
• Releasing attribute changes for logging and event generation (history) purposes
• Assigning an attribute to any existing tab of the add/edit dialog
The following figures show the different behavior for attributes depending on the settings
described above.
The first attribute local inhibit is out of use and will not be used at all.
The second attribute remote inhibit is in use but not visible anywhere. The specified
default value will be used when a tagout is added.
The third attribute local lock is in use and visible. The specified default value will be
used when a tagout is added.
The fourth attribute remote lock is in use, visible and enabled. The user can change the
specified default value before a new tagout is added.
130
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Tabs can only be removed when there is no class attribute assigned to them.
131
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
The absolute attribute position within the Switch Control dialog Tagout List can be
changed with the Down and Up buttons.
The relative attribute position in the assigned tab of the Add/Edit Tagout dialog can also
be changed with the Down and Up buttons.
For attributes of the type Selector, the following properties can be modified:
• The attribute title shown in the Switch Control dialog's Tagout List view and in the
Add/Edit Tagout dialog.
• The default value used for the add/edit dialog when a new tagout is added
132
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
The quantifier is the value that is written into the process object database for the selected
title. In the current version, the quantifier will be used only for the priority attribute.
It is possible to add, remove or edit the attribute selector titles and quantifier. However,
at least one selector title must remain.
With the Insert button, a new row can be added above the selected row. With the context
menu that opens when a row is right-clicked, a new row can be added above or below
the selected row.
A special treatment for post processing activities is needed for the priority attribute. Post
processing activities are attribute changes which depend on priority value selection.
The post processing selection, shown in Figure 6.20 below, is only available for classes
containing action methods. Only action methods that are a part of the selected class and
in use can be used in post processing.
133
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
The action method attribute values are set with the Add/Edit Tagout dialog after the
priority value selection has been made. Below, Figure 6.21 shows Add/Edit Tagout dialog
for the rows handled above in Figure 6.20.
134
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Class activation
The activation of one class out of the list of existing classes can be done in the Main
page of the Activate Class tab, see Figure 6.24 below.
135
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
The active class can only be changed if there are no active tagouts at that moment. Once
a tagout has been activated, the properties from the active tagout class will be made read
only. This prevents any mismatch in properties between active tagouts and active tagout
class.
The following settings are available on the Settings tab (see also Section 6.7.6.8 Action
Method settings):
• Only main indication and command objects included
Index 10 (and 11 for three-state switch) for the status indication
Main object command indexes for switch device control (Index range depends on
command type)
• Filter on Object Identification (OI)
or
• Filter on Logical Name (LN).
Blockings will be set for all process objects based on the defined filter condition.
Excluded from object search command are all internal objects, such as:
136
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
• Selected on monitor
• Tagout indication object (Index 49)
• Tagout event & logging object (Index 50)
For the event (History) handling, the following settings are available on the Settings tab
(see Figure 6.26):
By using the History enabled check box, the event generation can be taken out of use
for all tagout activities. This setting will overrule the history handling settings made for
class attributes.
For the Logging function the following settings are available on the Settings tab (see
Figure 6.27):
137
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Using the Logging enabled check box the logging function can be taken out of use for
all tagout activities. This setting will overrule the logging handling settings made for
class attributes.
Tagout Lists opens from the View menu of the Tagout Class Editor. The Active Tagouts
tab of Tagout List presents all active tagouts, see Figure 6.28 below. Tagout List can be
added as an item into the existing menu structure. Also, launching via a toolbar button
or icon from any display will be supported. The Tagout List can only be used to view
active tagouts.
138
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
The Tagout Log Viewer is integrated in the Tagout List as a separate Log Viewer tab.
The Tagout List can be set to be opened from the menu as a Visual SCIL dialog. The
following item properties should be used for the set up in the Specify VSCIL Tool dialog
(see also Figure 6.30 below):
• File: C:\sc\Stool\AplBuild\TOEDIT.VSO
• Object name: TOList
• Tool Appearance: Tool size: Size 1 (960x720)
139
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Figure 6.30: Settings for Tagout List to open as Open Visual SCIL Tool
To make the Tagout List open as a Visual SCIL dialog from a display, the following
settings should be used in the Tool Launcher Settings dialog (see Figure 6.31 below):
• The Visual SCIL dialog radio button should be selected
• VSO file: C:\sc\Stool\AplBuild\TOEDIT.VSO
• Visual SCIL object name: TOList
140
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
The Blocking Display can also be used to present all active blockings including the
blockings activated by the Tagout function, see Figure 6.32 below. However, it is not
possible to modify the blocking attributes set by the Tagout function in the Blocking
Display.
141
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
The Event Display can be used to list all historical tagout activities. The Tagout filter
function in the Filter Settings dialog can be used for listing only tagout related events
in Event Display.
142
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
6.7.8 Localization
Tagout Class Editor dialog items and notification messages can be translated with the
Text Translation Tool.
Tagout Class attributes are part of the Tagout Class and need to be translated with the
Tagout Class Editor. The tagout Class attributes include, for example, attribute titles,
which are used for the Switch Control Dialog Tagout tab and Tagout List.
Some basic text, for example the button caption text for the Switch Control Dialog Tagout
Tab, needs to be translated with third party software. This text is located in the Control
Dialog resource file ControlDialog2_EN.dll. See Table 17.1.
6.7.9.1 Files
The table below lists all the Tagout function related files and their functionality.
Table 6.49: Tagout function files
File Functionality Path
BGU_TAGOUT.SDB Class database template /SA_LIB/DEFAULTS/TAGOUT
ToEdit.vso Class editor /STOOL/APLBUILD
Tagout 8xSymbol.sd / PROG/GRAPHICSEN-
GINE/PALETTE/01 - SA_Common
Tagout 8xSymbol BottomUp.sd / PROG/GRAPHICSEN-
GINE/PALETTE/01 - SA_Common
Tagout 8xSymbol LeftRight.sd / PROG/GRAPHICSEN-
GINE/PALETTE/01 - SA_Common
Tagout 8xSymbol RightLeft.sd / PROG/GRAPHICSEN-
GINE/PALETTE/01 - SA_Common
Tagout 8xSymbol TopDown / PROG/GRAPHICSEN-
overlay.sd GINE/PALETTE/01 - SA_Common
Tagout 8xSymbol TopDown.sd / PROG/GRAPHICSEN-
GINE/PALETTE/01 - SA_Common
Tagout Indicator H.sd / PROG/GRAPHICSEN-
GINE/PALETTE/01 - SA_Common
Tagout Indicator.sd / PROG/GRAPHICSEN-
GINE/PALETTE/01 - SA_Common
Tagout PatternFrame.sd / PROG/GRAPHICSEN-
GINE/PALETTE/01 - SA_Common
Tagout SolidFrame.sd / PROG/GRAPHICSEN-
GINE/PALETTE/01 - SA_Common
Tagout Text.sd / PROG/GRAPHICSEN-
GINE/PALETTE/01 - SA_Common
143
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
At the first Tagout Class Editor usage, the following command procedures will be created:
Table 6.50: Tagout function related command procedures
Name Functionality
SAGR_TAGOUT SCIL interface to tagout Class Database
SAGR_TAGOUT_AM Action Method (blocking) handling
SAGR_TAGOUT_AM_EX Interface with COM 500i
SAGR_TAGOUT_AM_UD For user defined action on Action Method activ-
ation and deactivation
SAGR_TAGOUT_HIST Logging handling
SAGR_TAGOUT_LOG Event and History handling
During the installation with the Standard Function Installation tool, two process objects
within the switching device logical name group will be created:
Table 6.51: Process object attributes related to Tagout function
Index Obj. Process object Remarks Group Identifier
49 DI Tagout Indication Internal FPXTAGXIND
50 ID Tagout History activ- Internal FPXTAGXEVT
ation
144
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
This chapter describes the installation of the Tap changer standard function from the
Power Process Library. The standard function for the Tap changer is found in the directory
/SA_LIB/BASE/BBONE/INST and it should be installed by using the Power Process
Library installation procedures (SA_LIB/Process/Tap Changer). This standard function
is configured by using configuration tools, such as the Object Navigator.
The Power Process symbol for the tap changer standard function is installed by using
the following Display Builder functions:
1. Object Browser
2. Palette
For further information, see the SYS600 Process Display Design manual.
Table 6.53: Power Process symbol for tap changer standard function
File name Representa- Symbol
tion
Horizontal Vertical Horizontal Vertical
02 -SA_ANSI Trans- Trans- ANSI
former2w H.sd former2w.sd
145
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
The Tap changer standard function has the following attributes to be configured with
the Object Navigator:
Table 6.54: Tap changer attributes configured with the tools
Attribute Meaning
STATION_NAME Name of the substation -
BAY_NAME Name of the bay -
DEVICE_NAME Name of the device -
MIN_POSITION Minimum position of tap changer 1
MAX_POSITION Minimum position of tap changer 19
P_OBJECT_LN Logical name of database process -
object
STATION_TYPE The type of control device & pro- ANSI
tocol
CMD_PARAMETER A selector for selecting of control N/A
method. This attribute has mean-
ing only if IEC 60870-5-101/104
or DNP 3.0 protocol is selected,
otherwise this attribute is disabled.
OUTPUT_STATUS Process objects for output status N/A
with DNP 3.0 protocol.
AUTO_MANUAL_IND_TYPE The type of the auto/manual sig- 01=manual,
nal 10=auto (DB)
AUTHORIZATION_GROUP The name of the authorization MV_CONTROL
group
146
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Attribute Meaning
TRANSFORMER_TYPE The number of windings 2-winding
OPC_ITEM_PREFIX Specifies the OPC Item Prefix to IEC61850 Subnet-
as IEC 61850 instance informa- work.IED1.LD1
tion.
OPC_LN_INSTANCES Specifies the OPC Logical Node VECTOR
names used as IEC 61850 In-
stance information.
OPERATOR_PLACE_HANDLING Specifies the operator place (loc- None
al/Station/NCC) handling of the
device
For more detailed description on the configurable attributes, see Section 6.15 Descriptions
of the configurable attributes.
Depending on the configuration of the Tap changer standard function, the tools create a
certain set of process objects into the database. Process objects that will be linked to the
actual process should be edited to have a station number, an address and a proper
switching state. Otherwise, by default, all other attributes should have suitable values
for normal operation.
When process objects are created, default scales are assigned to the analog input signals
meant to be connected to the process (indices 24,25 and 26).
Table 6.55: Process objects created for tap changer
Index Explanation Purposes
10 Tap position indication Used for indication of the tap changer position.
11 Tap ch. auto/manual Used for indication of the transformer auto
ind. manual state.
12 Tap ch. single/parallel Used for indication of the transformer single /
ind. parallel state.
13 Tap ch. master/slave Used for indication of the transformer Mas-
ind. ter/Slave state.
14 Tap ch. manual cmd Used for sending "manual" command to the
control unit.
15 Tap ch. auto cmd Used for sending "auto" command to the control
unit.
16 Tap ch. raise cmd Used for sending "raise" command to the control
unit.
17 Tap ch. lower cmd Used for sending "lower" command to the con-
trol unit.
18 Tap ch. single/parallel Used for sending "single" or "parallel" command
cmd to the control unit.
147
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
148
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
This section describes the structure of the Tap changer standard function. All subdrawing
files, form pictures, help and other text files, as well as database objects are included.
The Tap changer is a part of the standard functions of Power Process Library and has
the directory /SA_LIB/BASE/BBONE and the standard Power Process Library
subdirectories INST, LANG0 and USE.
6.8.3.2 Files
The table below lists all Tap changer standard function related files and their functionality.
Table 6.57: Tap changer standard function related files
File Functionality Path
Transformer2w.sd SA ANSI symbol for two /PROG/GRAPHICSEN-
winding transformer GINE/PALETTE/03 - SA_ANSI
Transformer3w.sd SA ANSI symbol for three /PROG/GRAPHICSEN-
winding transformer GINE/PALETTE/03 - SA_ANSI
Transformer2w.sd SA IEC symbol for two /PROG/GRAPHICSEN-
winding transformer GINE/PALETTE/03 - SA_IEC
Transformer3w.sd SA IEC symbol for three /PROG/GRAPHICSEN-
winding transformer GINE/PALETTE/02 - SA_IEC
FORM5SAGR1.PIC Generic format picture for /SA_LIB/BASE/BBONE/USE
printing
The following Text Translation Tool compatible text files are used by the Tap changer
standard function. The path is /SA_LIB/BASE/BBONE/LANG0.
Table 6.58: Text Translation Tool compatible text files used by the tap changer
standard function
File Functionality
SAI_TR2R.TXT Text file for the database creation of the stand-
ard function
SAI_TR2S.TXT Text file for the database creation of the stand-
ard function
SAI_HVT2.TXT Text file for the database creation of the stand-
ard function network topology coloring
SAI_HVT3.TXT Text file for the database creation of the stand-
ard function network topology coloring
149
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
The following configuration files are used by the Tap changer standard function. The
path is /SA_LIB/BASE/BBONE/INST.
Table 6.60: Configuration files used by the tap changer standard function
File Functionality
SAI_TRI_2.DAT Contains the configuration data for tap changer
when it is created modified or deleted by config-
uration tools.
SAI_TRI_2.POT Contains the process object definitions for the
Object Navigator.
SAI_HVT23.POT Contains the process object network topology
coloring definitions for the Object Navigator.
SAI_TRAIDX.TXT Contains the process object network topology
coloring definitions for the Object Navigator.
SAI_HVT2.TPL Contains the process object network topology
coloring template definitions for the Object
Navigator.
SAI_HVT3.TPL Contains the process object network topology
coloring template definitions for the Object
Navigator.
INDEX5_B1.TXT Selection list of Power Process Library standard
functions for installation tool.
The following text file is used by the Tap changer. The path is
/SA_LIB/BASE/BBONE/USE .
Table 6.61: Text file used by the tap changer
File Functionality
BGU_AUTH.TXT Contains the SCIL code for station authority
check. The code is executed by the dialog of
the tap changer.
150
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
At the first installation, the Tap changer creates the command procedure BGU_UPDATE,
which updates process objects when they are update-deblocked. This feature is similar
to the SYS600 Blocking Display function.
For ANSI type of station, the command procedure BGU_AI2DB will be created while
installing. The command procedure BGU_AI2DB updates the position indication double
binary from the analog input. The command procecure BGU_TCCO is created for
updating the operation counter object.
Table 6.62: Command procedures used by the tap changer
BGU_TRAFO Performs the control operations
Function Description
AUTOMATIC_SELECT Performs select operation for automatic com-
mand on transformer standard function.
AUTOMATIC_EXECUTE Performs execute operation for automatic com-
mand on transformer standard function.
Uses text file
/SA_LIB/BASE/BBONE/USE/BGU_SW_EXE.TXT
AUTOMATIC_CANCEL Performs cancel operation for automatic com-
mand on transformer standard function.
LOWER_SELECT Performs select operation for lower command
on transformer standard function.
LOWER_EXECUTE Performs execute operation for lower command
on transformer standard function.
LOWER_CANCEL Performs cancel operation for lower command
on transformer standard function.
MANUAL_SELECT Performs select operation for manual command
on transformer standard function.
MANUAL_EXECUTE Performs execute operation for manual com-
mand on transformer standard function.
MANUAL_CANCEL Performs cancel operation for manual command
on transformer standard function.
PARALLEL_SELECT Performs select operation for parallel command
on transformer standard function.
PARALLEL_EXECUTE Performs execute operation for parallel com-
mand on transformer standard function.
PARALLEL_CANCEL Performs cancel operation for parallel command
on transformer standard function.
RAISE_SELECT Performs select operation for raise command
on transformer standard function.
RAISE_EXECUTE Performs execute operation for raise command
on transformer standard function.
RAISE_CANCEL Performs cancel operation for raise command
on transformer standard function.
151
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
The following process objects will be created depending on the configuration of the Tap
changer.
Table 6.63: Process objects for Generic tap changer
Index Object type Meaning of Pro- Remarks Group identifier
cess object
10 AI Tap changer posi- - FPTAVRIPOS
tion
11 BI/DB Tap changer - FPTAVRIMAN
manual/auto -ind.
152
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
153
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
At the first installation, the Tap changer creates the scale 1_1 (linear 1:1 scale). For ANSI
station type, the installation creates also the scale BGU_1_1000 (linear 1:1000 scale).
In the Tap changer control dialog, the AZ, OV, IU and HI attributes of the dedicated
analog input point are used for operation counting. The AZ, OV and HI attributes are
not readable if the IU attribute value is 0.
6.9 Measurement
This chapter describes the installation of measurement standard function from the Power
Process Library. The standard function for the measurement is found in the directory
/SA_LIB/BASE/BBONE/INST and it should be installed by using the Power Process
Library installation procedures (SA_LIB/Process/Measurement). This standard function
is configured by using the configuration tools, such as the Object Navigator:
The Power Process symbol for the measurement standard function is installed by using
the Display Builder functions:
1. Object Browser
2. Palette
For further information, see the SYS600 Process Display Design manual.
154
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Line Graph 20
Sample.sd
Value.sd
Circle.sd
The measurement standard function has the following attributes to be configured with
the Object Navigator:
Table 6.65: Configurable measurement picture function attributes
Attribute Meaning Default
STATION_NAME Name of the substation -
BAY_NAME Name of the bay -
DEVICE_NAME Name of the device -
P_OBJECT_LN Logical name of database -
process objects
STATION_TYPE The type of control device & LON
protocol
TYPE_MEAS_'number' The type of the measurement None
155
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
For more detailed description on the configurable attribute, see Section 6.15 Descriptions
of the configurable attributes.
Depending on the measurement standard function configuration, the tools create a certain
set of process objects in the database. Process objects that will to be linked to the actual
process should be edited to have a station number, an address and a proper switching
state. Otherwise, by default, all other attributes should have suitable values for normal
operation.
Table 6.66: Process objects created for measurement
Index Explanation Purpose
10 Current L1 Current measurement on phase L1
11 Current L2 Current measurement on phase L2
12 Current L3 Current measurement on phase L3
13 Neutral current I0 Neutral current measurement
156
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
157
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
158
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
With RTU 2xx/RP-570 type of stations Event recording objects (for accurate time stamp)
are created with convention Index + 100. These are optional.
The configuration of the measurement with a horizontal field can be given as an example:
Table 6.67: Measurement configuration
Attribute Value
STATION_NAME Eastwick
BAY_NAME Outgoing HA2
DEVICE_NAME CT
P_OBJECT_LN ESTHA02CT
STATION_TYPE LON
TYPE_MEAS_1 Current L1
FOLDER_1_TITLE IL1
MEAS_1_DECIMALS 0
TYPE_MEAS_2 Active power P
FOLDER_2_TITLE P
MEAS_2_DECIMALS 1
TYPE_MEAS_3 Reactive power Q
FOLDER_3_TITLE Q
MEAS_3_DECIMALS 1
TYPE_MEAS_4 None
FOLDER_4_TITLE N/A
MEAS_4_DECIMALS N/A
AUTHORIZATION_GROUP MV_CONTROL
EVENT_RECORDING N/A
This section describes the structure of the measurement standard function. All subdrawing
files, form pictures, help and other text files, as well as database objects are included.
The measurement is a part of the standard functions of Power Process Library and has
a directory /SA_LIB/BASE/BBONE, and the standard Power Process Library
subdirectories INST, LANG0 and USE.
159
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
6.9.3.2 Files
The table below lists all measurement standard function related files and their
functionality.
Table 6.68: Measurement standard function files
File Functionality Path
Bar Graph.sd Measurement bar graph /PROG/GRAPHICSENGINE/PALETTE/05 -
symbol SA_Measurement
Line Graph.sd Measurement line graph /PROG/GRAPHICSENGINE/PALETTE/05 -
symbol SA_Measurement
Value.sd Measurement value /PROG/GRAPHICSENGINE/PALETTE/05 -
symbol SA_Measurement
Circle.sd Measurement circle /PROG/GRAPHICSENGINE/PALETTE/05 -
symbol SA_Measurement
Current Transducer SA ANSI symbol for cur- /PROG/GRAPHICSENGINE/PALETTE/05 -
ANSI.sd rent transducer SA_Measurement
Current Transducer SA IEC symbol for cur- /PROG/GRAPHICSENGINE/PALETTE/05 -
IEC.sd rent transducer SA_Measurement
Voltage Transducer SA ANSI symbol for /PROG/GRAPHICSENGINE/PALETTE/05 -
ANSI.sd voltage transducer SA_Measurement
Voltage Transducer SA IEC symbol for /PROG/GRAPHICSENGINE/PALETTE/05 -
IEC.sd voltage transducer SA_Measurement
FORM5SAGR1.PIC Generic format picture /SA_LIB/BASE/BBONE/USE
for printing
The following Text Translation Tool compatible text file is used by the measurement
standard function. The path is /SA_LIB/BASE/BBONE/LANG0.
Table 6.69: Language text file
File Functionality
SAI_ME.TXT Text file for the database creation of the stand-
ard function
160
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
The following configuration files are used by the measurement standard function. The
path is /SA_LIB/BASE/BBONE/INST.
Table 6.71: Configuration files used by the measurement standard function
File Functionality
SAI_ME1.DAT Contains the configuration data for measure-
ment when it is created modified or deleted by
configuration tools.
SAI_ME1.POT Contains the process object definitions for the
Object Navigator.
INDEX5_B1.TXT Selection list of Power Process Library standard
functions for installation tool.
At the first installation, the measurement creates the command procedure BGU_UPDATE,
which updates process objects when they are update-deblocked. This feature is similar
to the SYS600 Blocking Display function. It is also used when simulation mode is
disabled in control dialog.
Table 6.73: Command procedures used by measurement
BGU_CONTROL Performs the control operations
Function Description
OBJECT_INFO Gets configuration of the standard function.
GET_OI_TEXT Gets object identification text.
CHECK_AUTHORITY_WORKPLACE Checks if the used workstation is authorized to
make control operations.
GET_ALARMS Gets alarms of standard function.
GET_OFFSETS Gets index offsets for indexes that are used for
indicating command event, selection on monitor,
control blocking, alarm, external blocking, open
blocking and close blocking.
161
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
The following process objects are created depending on the configuration of the
measurement.
Table 6.74: Measurement process objects
Index Obj. Process object Remarks Group identifier
type
10 AI Current L1 - FPPMEAMCUR
11 AI Current L2 - FPPMEAMCUR
12 AI Current L3 - FPPMEAMCUR
13 AI Neutral current I0 - FPPMEAMNCU
14 AI Directional neutral - FPPMEAMDNC
current Ij
15 AI Maximum demand - FPPMEAMMDC
I15min
16 AI Voltage U12 - FPPMEAMVOL
17 AI Voltage U23 - FPPMEAMVOL
18 AI Voltage U31 - FPPMEAMVOL
19 AI Residual voltage - FPPMEAMRVL
U0
20 AI Active power P - FPPMEAMAPW
21 AI Reactive power Q - FPPMEAMRPW
22 AI Apparent power S - FPPMEAMAPP
23 AI Power factor Cosj - FPPMEAMCOS
24 AI Frequency f - FPPMEAMFRQ
162
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
163
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
For RP-570, event recordind objects are created with convention shown in the table
below. These are Optional.
164
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
At the first installation, the measurement creates the scale 1_1 (linear 1:1 scale). For
ANSI station type, the scale BGU_1_1000 (linear 1:1000 scale) is also created at the
installation.
This chapter describes the installation of alarm indicator standard function from the
Power Process Library. The standard function for the alarm indicator is found in the
directory /SA_LIB/BASE/BBONE/INST and it should be installed by using the Power
Process Library installation procedures (SA_LIB/Process/Alarm Indicator). This standard
function is configured by using configuration tools, such as the Object Navigator.
The Power Process symbol for alarm indicator standard function is installed by using
the Display Builder functions:
1. Object Browser
2. Palette
For further information, see the SYS600 Process Display Design manual.
Table 6.76: Power Process symbol for the alarm indicator standard function
File Name Symbol
Alarm A.sd
Alarm Bell.sd
Alarm Led.sd
Alarm Star.sd
165
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
The alarm indicator standard function has the following attributes to be configured with
the Object Navigator:
Table 6.77: Alarm indication attributes to be configured with the tools
Attribute Meaning Default
STATION_NAME Name of the substation -
BAY_NAME Name of the bay -
DEVICE_NAME Name of the device -
P_OBJECT_LN Logical name of database process -
object
STATION_TYPE The type of control device & pro- LON
tocol.
TYPE_OF_SIGNAL’x’ The type of the input signal. -
SIGNAL’x’_TEXT Identification for signal shown in Not available
event lists, alarm list and so on
ALARMING_STATE_OF_SIGNAL’x’ The state of the signal when an Not available
alarm (warning) is activated.
LINK_SIGNAL’x’_LN The logical name of the process Not available
object to which the signal is
linked.
LINK_SIGNAL’x’_IX The index of the process object to Not available
which the signal is linked.
AUTHORIZATION_GROUP The name of the authorization MV_CONTROL
group.
EVENT_RECORDING Selection whether the event re- Not available
cording process objects are cre-
ated when the RP-570 protocol is
used.
For more detailed description on the configurable attributes, see Section 6.15 Descriptions
of the configurable attributes.
Depending on the configuration of the alarm indicator standard function, the tools will
create a certain set of process objects in the database. Process objects that will be linked
to the actual process should be edited to have a station number, an address and a proper
switching state. Otherwise, by default, all other attributes should have suitable values
for normal operation.
If the value of the attribute TYPE_OF_SIGNAL'nr' is linked, the process object is not
created by the tools, but the name and the index of the signal is given to the attributes
LINK_SIGNAL'nr'_TO_LN and LINK_SIGNAL'nr'_TO_IX.
166
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
This section describes the structure of the alarm indicator standard function. All
subdrawing files, form pictures, help and other text files, as well as database objects are
included. The alarm indicator is a part of the standard functions of Power Process Library
and has a directory /SA_LIB/BASE/BBONE, and the standard Power Process Library
subdirectories INST, LANG0 and USE.
6.10.2.2 Files
The table below lists all alarm indicator standard function related files and their
functionality.
Table 6.80: Alarm indicator standard function related files
File Functionality Path
Alarm A.sd Power Process sym- /PROG/GRAPHICSENGINE/PALETTE/04 -
bol for alarming A SA_Indication
Alarm Bell.sd Power Process sym- /PROG/GRAPHICSENGINE/PALETTE/04 -
bol for alarming bell SA_Indication
167
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
The following Text Translation Tool compatible text files are used by the alarm indicator
standard function. The path is /SA_LIB/BASE/BBONE/LANG0.
Table 6.81: Text Translation Tool compatible text file used by the alarm indicator
File Functionality
SAI_AI.TXT Text file for the database creation of the stand-
ard function
The following configuration files are used by the alarm indicator standard function. The
path is /SA_LIB/BASE/BBONE/INST.
Table 6.83: Configuration files used by the alarm indicator
File Functionality
SAI_AI.DAT Contains the configuration data for alarm indic-
ator when it is created modified or deleted by
configuration tools.
SAI_AI.POT Contains the process object definitions for the
Object Navigator.
INDEX5_B1.TXT Selection list of Power Process Library standard
functions for installation tool.
168
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
This chapter describes the installation of Auto Reclose standard function from the Power
Process Library. The standard function for the Auto Reclose is found in the directory
/SA_LIB/BASE/BBONE/INST and it should be installed by using the Power Process
Library installation procedures (SA_LIB/Process/Auto Reclose). This standard function
is configured by using configuration tools, such as the Object Navigator.
The Power Process symbol for Auto Reclose standard function is installed by using the
Display Builder functions:
1. Object Browser
2. Palette
For further information, see the SYS600 Process Display Design manual.
Table 6.84: Power Process symbol for Auto Reclose standard function
File Name Symbol
Auto-Reclosing BI.sd
Auto-Reclosing.sd
The Auto Reclose standard function has the following attributes to be configured with
the Object Navigator:
Table 6.85: Auto Reclose standard function configurable attributes
Attribute Meaning Default
STATION_NAME Name of the substation -
BAY_NAME Name of the bay -
DEVICE_NAME Name of the device -
P_OBJECT_LN Logical name of database process -
objects
STATION_TYPE The type of control device & pro- LON
tocol
OUTPUT_STATUS Process objects for output status N/A
with DNP 3.0 protocol
169
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
For more detailed description on the configurable attributes, see Section 6.15 Descriptions
of the configurable attributes.
Depending on the configuration of the Auto Reclose standard function, the tools create
a certain set of process objects in the database. Process objects that will be linked to an
actual process should be edited to have a station number, an address and a proper
switching state. Otherwise, by default, all other attributes should have suitable values
for normal operation.
Table 6.86: Process objects created for Auto Reclose
Index Explanation Purpose
10 Auto-reclosing in use/out of Indicates if the auto-reclose is in use
use indication (optional) (software switch of the auto-reclosing
unit).
11 Auto-reclosing in use/out of Indicates if the auto-reclose is in use
use indication (optional) (hardware switch of the auto-reclosing
unit).
12 Auto-reclosing in pro- Indicates if there is an auto-reclosing
gress/not in progress ind. sequence running.
(optional)
13 Auto-reclosing interrupt Interrupts the auto-reclosing se-
command (optional) quence.
14 Auto-reclosing in use/out of Enables/disables the auto-reclosure.
use command (optional)
170
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
This section describes the structure of the Auto Reclose standard function. All sub-drawing
files, form pictures, help and other text files, as well as database objects are included.
The Auto Reclose is a part of the standard functions of Power Process Library and has
a directory /SA_LIB/BASE/BBONE, and the standard Power Process Library
subdirectories INST, LANG0 and USE.
6.11.2.2 Files
The table below lists all Auto Reclose standard function related files and their
functionality.
Table 6.87: Auto Reclose standard function related files
File Functionality Path
Auto-Reclosing.sd Power Process symbol for /PROG/GRAPHICSEN-
Auto Reclose GINE/PALETTE/04 - SA_Indica-
tion
FORM5SAGR1.PIC Generic format picture for /SA_LIB/BASE/BBONE/USE
printing
171
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
The following Text Translation Tool compatible text files are used by the Auto Reclose
standard function. The path is /SA_LIB/BASE/BBONE/LANG0.
Table 6.88: Text Translation Tool compatible text file used by the Auto Reclose
standard function
File Functionality
SAI_ARC2.TXT Text file for the database creation of the stand-
ard function
The following configuration files are used by the Auto Reclose standard function. The
path is /SA_LIB/BASE/BBONE/INST.
Table 6.90: Configuration files used by the Auto Reclose stardard function
File Functionality
SAI_ARC2.DAT Contains the configuration data for the Auto
Reclose when it is created, modified or deleted
by configuration tools.
SAI_ARC2.POT Contains the process object definitions for the
Object Navigator.
INDEX5_B1.TXT Selection list of Power Process Library standard
functions for installation tool.
The following process objects are created for the Auto Reclose standard function.
Table 6.91: Process objects created for the Auto Reclose standard function
Index Obj. type Process object Remarks Group ident.
10 BI Auto-reclosing in Software switch FPFARCISCE
use Optional
11 BI Auto-reclosing in Hardware switch FPFARCISCE
use Optional
172
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
At the first installation the Auto Reclose creates the scale 1_1 (linear 1:1 scale). For
multiple shots with ANSI station type, the installation creates also the scale BGU_1_1000
(linear 1:1000 scale).
This chapter describes the installation of Trip Signal standard function from the Power
Process Library. The standard function for the Trip Signal is found in the directory
/SA_LIB/BASE/BBONE/INST and it should be installed by using the Power Process
Library installation procedures (SA_LIB/Process/Trip Signal). This standard function
is configured by using the configuration tools, such as the Object Navigator.
173
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
The Power Process symbol for Trip Signal standard function is installed by using the
Display Builder functions:
1. Object Browser
2. Palette
For further information, see the SYS600 Process Display Design manual.
Table 6.92: Power Process symbol for the Trip Signal standard function
File Name Symbol
Tripping.sd
The Trip Signal standard function has the following attributes to be configured with the
Object Navigator:
Table 6.93: Configurable Attributes
Attribute Meaning Default
STATION_NAME Name of the substation -
BAY_NAME Name of the bay -
DEVICE_NAME Name of the device -
P_OBJECT_LN Logical name of database process -
objects
STATION_TYPE The type of control device & pro- LON
tocol
OUTPUT_STATUS Process objects for output status N/A
with DNP 3.0 protocol
EVENT_RECORDING Process objects for event record- No process objects
ing with RP-570
LINK_TRIP_TAG_TO_LN_x The logical name of the database -
process objects to which this trip
tag is linked.
LINK_TRIP_TAG_TO_ The module to which this trip tag No linking
is linked.
For more detailed description on the configurable attributes, see Section 6.15 Descriptions
of the configurable attributes.
Depending on the configuration of the Trip Signal standard function, the tools create a
certain set of process objects in the database. Process objects that will be linked to actual
174
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
process should be edited to have a station number, an address and a proper switching
state. All other attributes should have suitable values for normal operation by default.
Table 6.94: Process objects created for Trip Signal
Index Explanation Purpose
10 General protection trip indic- The general protection trip indication
ation (optional) can be used as ON/OFF type indica-
tion of any protection trip within the
bay.
11 General trip relay latched The general trip relay latched indica-
indication (optional) tion can be used as ON/OFF type in-
dication of any latched protection trip
relay within the bay.
12- General trip relay reset The general trip relay reset command
command (optional) object is an output object which can
be used to reset latched output relays,
trip indicators and memorised paramet-
ers.
110 General protection trip indic- Event recording object (for accurate
ation (optional) time stamp) with RTU 2xx/RP-570
type of stations.
111 General trip relay latched Event recording object (for accurate
indication (optional) time stamp) with RTU 2xx/RP-570
type of stations.
112- Indication for command ter- Indicates with IEC 60870-5-101/104
mination (optional) and -103 whether the issued com-
mand was successful or not.
This section describes the structure of the Trip Signal standard function. All subdrawing
files, form pictures, help and other text files, as well as database objects are included.
The Trip Signal is a part of the standard functions of Power Process Library and has the
directory /SA_LIB/BASE/BBONE, and the standard Power Process Library subdirectories
INST, LANG0 and USE.
6.12.2.2 Files
The table below lists all Trip Signal standard function related files and their functionality.
Table 6.95: Trip Signal stardard function related files
File Functionality Path
Tripping.sd Power Process symbol PROG/GRAPHICSENGINE/PALETTE/04 -
for Trip Signal SA_Indication
175
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
The following Text Translation Tool compatible text file is used by the Trip Signal
standard function. The path is /SA_LIB/BASE/BBONE/LANG0.
Table 6.96: Text Translation Tool compatible text file used by the Trip Signal
standard function
File Functionality
SAI_TRIP2.TXT Text file for the database creation of the stand-
ard function
The following configuration files are used by the Trip Signal standard function. The path
is /SA_LIB/BASE/BBONE/INST.
Table 6.98: Configuration files used by the Trip Signal standard function
File Functionality
SAI_TRIP2.DAT Contains the configuration data for Trip Signal
when it is created modified or deleted by config-
uration tools.
SAI_TRIP2.POT Contains the process object definitions for the
Object Navigator.
INDEX5_B1.TXT Selection list of Power Process Library standard
functions for installation tool.
The following process objects are created for the Trip Signal standard function.
176
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
At the first installation the Trip Signal creates the scale 1_1 (linear 1:1 scale).
6.13 Generator
This chapter describes the installation of generator standard function from the Power
Process Library. You can find the standard function for generator in the
/SA_LIB/BASE/BBONE/INST directory and install it by using the Power Process Library
installation procedures (SA_LIB/Process/Generator). To configure this standard function,
you can use the Object Navigator.
The Power Process symbol for the Generator standard function is installed by using the
following Display Builder functions:
1. Object Browser
2. Palette
For further information, see the SYS600 Process Display Design manual.
177
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Table 6.100: Power Process symbol for the generator standard function
File Name Symbol
Generator.sd
The following generator standard function attributes can be configured with the Object
Navigator:
Table 6.101: Generator standard function configurable attributes
Attribute Meaning Default
STATION_NAME Name of the substation -
BAY_NAME Name of the bay -
DEVICE_NAME Name of the device -
P_OBJECT_LN Logical name of database process -
objects
For more detailed description on the configurable attributes,see Section 6.15 Descriptions
of the configurable attributes.
This section describes the structure of the generator standard function. All the subdrawing
files, form pictures, help and other text files, as well as database objects are included in
it. The generator is a part of the standard functions of Power Process Library and has
the directory /SA_LIB/BASE/BBONE and the standard Power Process Library
subdirectories INST, LANG0 and USE.
178
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
6.13.2.2 Files
The table below lists all the generator standard function related files and their
functionality.
Table 6.103: Generator standard function related files
File Functionality Path
Generator.sd Power Process PROG/GRAPHICSENGINE/PALETTE/
symbol for the 01 - SA_Common
generator
The following Text Translation Tool compatible text file is used by the generator standard
function. The path is /SA_LIB/BASE/BBONE/LANG0.
Table 6.104: Text Translation Tool compatible text file used by the generator
standard function
File Functionality
SAI_GEN.TXT Text file for the database creation of the stand-
ard function
The following configuration files are used by the generator standard function. The path
is /SA_LIB/BASE/BBONE/INST.
Table 6.106: Configuration files used by the generator standard function
File Functionality
SAI_GEN.DAT Contains the configuration data and process
object definitions for the generator when it is
created, modified or deleted by configuration
tools.
INDEX5_B1.TXT Selection list of Power Process Library standard
functions for the Installation tool.
179
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
The following process object is created for the generator standard function.
Table 6.107: Process object created for the generator
Index Obj. type Process object Remarks Group ident
255 AI Generator color - BCHTCIXPCD
At the first installation the generator creates the scale 1_1 (linear 1:1 scale).
This chapter describes the installation of line indicator standard function from Power
Process Library. The standard function for the line indicator can be found in the
/SA_LIB/BASE/BBONE/INST directory and it can be installed by using the Power
Process Library installation procedures (SA_LIB/Process/Line Indicator). To configure
this standard function, the Object Navigator can be used.
The Power Process symbol can be installed for the line indicator standard function by
using the Display Builder functions:
1. Object Browser
2. Palette
For further information, see the SYS600 Process Display Design manual.
Table 6.108: Power Process symbol for the line indicator standard function
File Name Symbol
Horizontal Vertical Horizontal Vertical
Line Indicator H.sd Line Indicator.sd
The line indicator standard function has the following attributes to be configured with
the Object Navigator.
180
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
For more detailed description on the configurable attributes, see Section 6.15 Descriptions
of the configurable attributes.
Configuration of the line indicator creates a certain set of process objects in the database.
Table 6.110: Process objects created for the line indicator
Index Explanation Purpose
10 DMS 600 color number Used for line indicator coloring object
by DMS 600
253 Virtual switch for Topol. Col. Virtual switch for network topology
coloring
254 Ext. ground ind. For Topol. External ground indicator for network
Col. topology coloring
255 Infeed color for Topol. Col. Infeed color for network topology col-
oring
This section describes the structure of the line indicator standard function. All the
subdrawing files, form pictures, help and other text files, as well as database objects are
included. The line indicator is a part of the standard functions of Power Process Library
and has the directory /SA_LIB/BASE/BBONE, and the standard Power Process Library
subdirectories INST, LANG0 and USE.
6.14.5.2 Files
The table below lists all the line indicator standard function related files and their
functionality.
181
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
The following Text Translation Tool compatible text file is used by the line indicator
standard function. The path is /SA_LIB/BASE/BBONE/LANG0.
Table 6.112: Text Translation Tool compatible text file used by the line indicator
standard function
File Functionality
SAI_LIND.TXT Text file for the database creation of the stand-
ard function
The following configuration files are used by the line indicator standard function. The
path is /SA_LIB/BASE/BBONE/INST.
Table 6.114: Configuration files used by the line indicator
File Functionality
SAI_LIND.DAT Contains the configuration data and process
object definitions for the line indicator when it is
created, modified or deleted by configuration
tools.
INDEX5_B1.TXT Selection list of Power Process Library standard
functions for the Installation tool.
182
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
At first installation, the Line indicator creates the command procedure SAI_MTSTS,
which updates the status of the line indicator color.
For the indication type of an analog input (AI), the installation creates the command
procedure SAI_MT2TC, which updates the fictitious power indicator, grounding indicator
and active voltage color.
The following process objects are created for the line indicator standard function.
Table 6.115: Process objects created for the line indicator
Index Obj. type Process object Remarks Group ident.
10 AI DMS 600 color - BCHMTCXFCD
number
253 BI Virtual switch for - BCHTCIXFPI
Topol. Col.
254 AI Ext. ground ind. - BCHTCIXCCD
for Topol. Col.
255 AI Infeed color for - BCHTCIXPCD
Topol. Col
At first installation, the line indicator creates the scale 1_1 (linear 1:1 scale).
STATION_NAME
A selector type of an editable combo box to select or enter the name of the substation.
By default, the maximum length of the text is 9 characters. The selection list shows up
to ten latest entries.
The configurable attribute is read directly from the process object database, if there is
any process object linked to the selected station picture function. Therefore, the
configurable attribute within a picture function has only meaning when the process
objects have not been created.
This text is used as a substation identifier of the common station objects on event list,
alarm list, printout, database query, and so on. It is very important that this text is similar
to all objects within the same substation.
183
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
P_OBJECT_LN
The logical name of the database process objects. The maximum length of the text is 10
characters. Allowed characters are letters A-Z, all digits and the underscore (_).
The logical names of process objects have to be unique throughout the entire system,
that is, different objects cannot have the same logical name. Therefore, it is very important
to have a proper naming convention for the process object database.
Certain naming convention is also required to speed up the opening time of the main
dialogs. With the predefined naming convention it is possible to collect all station and
bay related database objects without searching through the complete database. Therefore,
it is advised to use the following naming convention:
• The first three characters identify the substation
• The following four characters identify the bay
• The last three characters can be freely used to identify the source of the signal, that
is device, unit, and so on.
The following list is presented as an example of the proper naming convention within
one bay. The station name is Green Bay and the bay name is HA12 Downtown:
• GRB, station
• GRBHA12BAY, bay
• GRBHA12Q0, circuit breaker Q0
• GRBHA12Q1, truck Q1
• GRBHA12Q9, earth switch Q9
• GRBHA12CT, measurements/current transformer
• GRBHA12VT, measurements/voltage transformer
• GRBHA12ALA, alarm indicator
• GRBHA12AR, auto-reclosing tag
• GRBHA12TRP, tripping tag
• GRBHA12R1, feeder terminal or protection unit 1
• GRBHA12R2, feeder terminal or protection unit 1
If some other naming convention than 3+4 is used, it usually takes a longer time to open
the main control dialogs.
STATION_TYPE
A selector type of a combo box to select the station type of the objects.
The database process objects are created for the station type defined here. The list of
supported protocols is as follows:
• SPA
• ANSI
• LON
• RP-570
• RP-570 with FTABs
• IEC 60870-5-101/104
• IEC 60870-5-103
• IEC 61850-8
184
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
• DNP 3.0
• Modbus RTU/ASCII/TCP
• PROCOL
CMD_PARAMETER
A selector type of a combo box to select a command parameter for the control method.
This attribute has meaning only if IEC 60870-5-101/104 or DNP 3.0 protocol is selected.
Otherwise this attribute is disabled.
The supported control parameters for the IEC 60870-5-101/104 protocol are:
• Single command (ASDU 45)
• Double command (ASDU 46)
• Single command with time tag (ASDU 58)
• Double command with time tag (ASDU 59)
• Normalized value (ASDU 48)
• Scaled value (ASDU 49)
• Short floating point number (ASDU 50)
• Normalized value with time tag (ASDU 61)
• Scaled value with time tag (ASDU 62)
• Short floating point number with time tag (ASDU 63)
and for DNP 3.0 protocol:
• Direct
• Direct - No ack.
OUTPUT_STATUS
An ON/OFF type of a toggle button to select whether there is need for output status
process objects with the DNP 3.0 protocol. If STATION_TYPE is other than DNP 3.0,
the configurable attribute is disabled, and the value has no meaning.
AUTHORIZATION_GROUP
A selector type of an editable combo box to select the authorization group for the object.
The maximum length of the text is 63 characters. The given text has to be usable as a
SCIL list attribute name. For more information about the SCIL list attribute name, see
SYS600 Programming Language SCIL. The contents of the selection list is taken from
the existing authorization groups.
185
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
STATION_LR_IN_USE
An ON/OFF type of a toggle button to select if the station local/remote switch is in use,
that is, a physical switch exists.
By default, the station local/remote switch is in use.
If this selection is set OFF, the control authority is given to everyone whose personal
authorization level is high enough for the control actions. This is gained by setting the
state (value) of the station local/remote switch permanently out of use.
The process object for station local/remote switch is created regardless of the selection.
If the station local/remote switch is NOT in use, the process object should be left as it
is created, that is, switching state (SS) to manual and value (DB) as 3 (out of use).
IND_DOUBLE_BINARY
An ON/OFF type of toggle button to select whether the station/remote switch or bay
local/remote indication type is double binary or single binary. This selection is disabled
and it has no meaning if the station/remote switch or bay local/remote is not in use, that
is, STATION_LR_IN_USE or BAY_LR_IN_USE is not set.
Depending on the actual field device or communication protocol, the indication of the
local/remote switch is sent either as a single binary (0/1) or as a double binary (0/1/2/3)
format.
Station:
Binary input:
0 = Remote
1 = Station
Double binary input:
0 = Local
1 = Station
2 = Remote
3 = Out of use
Bay:
Binary input:
Local or Remote. Depends on Bay L/R switch polarity
Double binary input:
0 = Disabled
186
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
1 = Local
2 = Remote
3 = Reserved
IND_ANALOG_INPUT
An ON/OFF type of toggle button to select whether the bay switch indication type is
analog input. This selection is disabled and it has no meaning if the local/remote switch
is not in use, that is, BAY_LR_IN_USE is not set.
Analog input:
0 = Off
1 = Local
2 = Remote
3 = Error
4 = Error
5 = All
LR_REMOTELY_CONTROLLABLE
An ON/OFF type of a toggle button for the selection, whether the station local/remote
switch can be controlled remotely by SYS600 or not.
By default, the station local/remote switch is defined as manually controllable only.
Typically, if there is a remote control for the station local/remote switch, switching
election between the station and remote can be done remotely, whereas switching election
to or from local has to be performed locally.
Switching to and from local can be achieved by setting the attribute SS (switching state)
of the local command process object to OFF (0). Setting the SS attribute to 0 will make
the relevant Radio button in the dialog insensitive for selections.
EVENT_RECORDING
An ON/OFF type of a toggle button to select whether there is need for event recording
process objects with the RP-570 protocol. If STATION_TYPE is other than RTU 2xx
or RTU 2xx/FTABs, the configurable attribute is disabled and the value has no meaning.
With the RP-570 the time stamp from process device comes into the event recording
process object. If no accurate time stamp is needed or available, or the device is emulating
the RP-570 without an event recording possibility, do not set this attribute ON.
187
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
OPC_ITEM_PREFIX
Specifies the OPC Item Prefix used as an IEC 61850 instance information. The default
is IEC61850 Subnetwork.IED1.LD1.
OPC_LN_INSTANCES
Specifies the OPC Logical Node names used as IEC 61850 instance information. The
default is VECTOR("LLN0").
BAY_NAME
A selector type of an editable combo box to select or enter the name of the bay (feeder).
By default, the maximum length of the text is 14 characters. The selection list shows up
to ten latest entries.
The configurable attribute is read directly from the process object database, if there is
any process object linked to the selected bay picture function. Therefore, the configurable
attribute within a picture function has meaning only when the process objects have not
been created.
This text will be used as a bay (feeder) identifier of the common bay objects on event
list, alarm list, printout, database query, and so on. It is very important that this text is
similar to all objects within the same bay (feeder).
BAY_LR_IN_USE
An ON/OFF type of a toggle button to select if the bay local/remote switch is in use,
that is, a physical switch exists.
By default, the bay local/remote switch is in use.
It is typical that if RTU 200 or RTU 210 is used as a remote terminal unit, there is no
bay local/remote switches at bay level. The control authority of a single bay is determined
by using station local/remote switch only.
The process object for bay local/remote switch is created regardless of the selection. If
the bay local/remote switch is NOT in use, the process object should be left as it is
created, that is, switching state (SS) to manual and value (DB) as 2 (remote).
BAY_LR_POLARITY
The polarity of the bay local/remote switch input signal.
LR_REMOTELY_CONTROLLABLE
An ON/OFF type of a toggle button to select if the bay local/remote switch can be
controlled remotely by SYS600. This selection is disabled and it has no meaning if the
bay local/remote switch in not in use, that is, BAY_LR_IN_USE is not set.
By default, bay local/remote switch is defined as manually controllable only.
188
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
It is typical that if there is a remote control for bay local/remote switch, shift to local can
be done remotely, whereas shift from local to remote has to be performed locally. This
can be achieved by setting the attribute SS (switching state) of the local command process
object to OFF (0). By setting the SS-attribute to 0, the relevant Radio button on dialog
becomes insensitive for shifting.
DEVICE_NAME
A selector type of an editable combo box to select or enter the name (identifier) of the
switching device. By default, the maximum length of the text is 5 characters. The selection
list shows up to ten latest entries.
The configurable attribute is read directly from the process object database, if there is
any process object linked to the selected switching device.
Therefore, the configurable attribute within a picture function has meaning only when
the process objects have not been created.
This text will be used as an identifier of the switching device on event list, alarm list,
printout, database query, and so on.
SWICHING_DEVICE_TYPE
A selector type of a combo box to select the type of the switching device. By default,
the type is a circuit breaker.
The configurable attribute has a great effect since it defines the index range for process
objects, the texts within database and dialogs, the functionality and methods on dialogs,
and so on. It is also used by the event and alarm list when filtering certain types of
switching devices.
Circuit breakers:
• Circuit breaker
• Circuit breaker with synchro-check
• Circuit breaker-disconnector (no full breaking capacity)
Disconnectors:
• Disconnector
• Fuse switch
• Load breaking switch
Earth switch
Fault-making switch
Truck
Three-state switch
189
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
SWICHING_DEVICE_PURPOSE
A selector type of a combo box to select the purpose of the switching device.
The configurable attribute has just an informative purpose since, by the default, it is not
used by any function within LIB 5xx. The attribute is stored into process object database
(the 25th or the 26th character of the RX attribute) for user defined purposes, for example,
for special search condition on the alarm or event list.
Circuit breakers:
• Circuit breaker
• Main busbar circuit breaker
• Main busbar A circuit breaker
• Main busbar B circuit breaker
• Reserve busbar circuit breaker
• By-pass circuit breaker
• Bus-section circuit breaker
• Bus-coupler circuit breaker
Disconnectors:
• Disconnector
• Main busbar disconnector
• Main busbar A disconnector
• Main busbar B disconnector
• Reserve busbar disconnector
• By-pass disconnector
• Line disconnector
• Line disconnector A
• Line disconnector B
• Bus-section disconnector
• Bus-section A disconnector
• Bus-section B disconnector
• Bus-section C disconnector
• Bus-coupler disconnector
Earth switches:
• Earth switch
• Main busbar earth switch
• Main busbar A earth switch
• Main busbar B earth switch
• Reserve busbar earth switch
• By-pass earth switch
• Line earth switch
• Line earth switch A
• Line earth switch B
• CT-section earth switch
Fault-making switch
Truck
190
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Three-state switch
SWITCH_SECTION
A selector type of a combo box to select the switch section for the truck and the three-state
switch. If SWITCHING_DEVICE_TYPE is some other than truck or 3-state switch, the
configurable attribute is disabled, and the value has no meaning.
In Power Process library this attribute is not relevant, but for backward compatibility
reasons it is not removed.
INDICATION_TYPE
A selector type of a combo box to select the type of the position indication process
object(s). By default, the process object type is defined as a double indication (DB).
The purpose of this configurable attribute is to support other data type than double
indication as the position indication of the switching device. The supported data types
are:
• Double indication (DB)
• Single indication (BI)
• 2 x Single indications (2 x BI)
• Analog input (AI)
The interface between the picture function and the process object database is always
with double indication object, that is, there is an additional process object(s) receiving
information and then passing it to double indication.
MOTORIZED
An ON/OFF type of a toggle button to select if the switching device is motorized and
remotely controllable. By default, the switching device is defined as a motorized object.
By selecting Motorized option, the Process Object Tool (POT) will create a set of process
objects for control purpose, and all configurable attributes related to control are being
enabled.
CONTROL_TYPE
A selector type of a combo box to select the control method and the type of the control
process object(s). If the configurable attribute MOTORIZED is not selected, this attribute
is disabled, and the value has no meaning.
The purpose of this configurable attribute is to support other control methods and process
object types than the conventional one. The conventional control method depends very
much on the configurable attribute STATION_TYPE since there is a certain default
method for each protocol to control the switching device. The supported control methods
are:
• Secured command with four binary outputs
191
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
CONTROL_PULSE_LENGTH
An input field for integer value to set the pulse length of the control pulses. The
configurable attribute is enabled, if the attribute MOTORIZED is set and
CONTROL_TYPE is secured control with two digital outputs.
CONTROL_BITS
A vector type of an input field for integer values to specify the bits to be used to send a
control command to the switching device. The configurable attribute is enabled if the
attribute MOTORIZED is set and CONTROL_TYPE is a secured control with an analog
output.
The user must specify two or four elements for that vector. If two elements are specified,
the first element represents the bit for Open execute while the second element is for
Close execute.
When four elements are used, the first represents the bit for Open select, the second
represents Close select, the third represents Execute and the fourth represents Cancel.
When five elements are used, the first represents the bit for Open select, the second
represents Close select, the third represents Open execute, the fourth represents Close
execute and the fifth represents Cancel.
The bit vector shall be given to the SCT in the following way: (0,1) or (9,10,11,8) or
(0,0,1,2,3).
AUXILIARY_PLUG
An ON/OFF type of a toggle button to select whether the device utilizes an auxiliary
plug or not. If the SWITCHING_DEVICE_TYPE is truck or three-state switch, the
configurable attribute is disabled, and the value has no meaning.
The process object for an auxiliary plug informs if the control cable from the switching
device to the cubicle has been disconnected, that is, if the switching device is fully racked
out from the cubicle. In that case, no switching device symbol is shown in the single line
diagram.
192
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
The process object can also be used as an internal tag without the process connection.
In that case, the control dialog asks the auxiliary plug state when the object state is
intermediate.
INTERLOCKING_BYPASS
An ON/OFF type of a toggle button to select whether the switching device has interlocking
bypass capability. This attribute is enabled only when IEC 61850-8 protocol is selected.
SYNCHROCHECK_BYPASS
An ON/OFF type of a toggle button to select whether the switching device has
synchrocheck bypass capability. This attribute is enabled only when IEC 61850-8 protocol
is selected.
QUALIFIERS
Qualifier is a value that is written to the QL attribute of process object when writing the
control command. The qualifiers are given as a vector of integers. Minimum length is 0
(default) and maximum length 5. The vector items have the following meanings:
Item Meaning
1 = Qualifier for open select
For example, (1,2,3) defines qualifier 1 for open select, qualifier 2 for close select and
qualifier 3 for open execute.
It is not possible to give empty items e.g. (,,,,3), but all the
values must be given, e.g. (0,0,0,0,3).
MIN_POSITION
The minimum position of the tap changer.
MAX_POSITION
The maximum position of the tap changer.
TRANSFORMER_TYPE
Selection for the 2-winding or 3-winding transformer.
DIRECT_TAP_POS_SETTING
An ON/OFF type of a toggle button to select whether it is possible to directly control
tap changer to a certain tap position instead of stepwise raise or lower operations.
193
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
OPERATION_MODE
Selection for the operation mode, where regulator is running. Depending on this attribute
the following indications/settings are possible in control dialog:
• Single
- Auto
- Manual
• Parallel - Master/Slave
- Parallel
- Single
- Auto/Manual, when regulator is in Single mode
- Master/Slave, when regulator is in Parallel mode
• Parallel - Negative Reactance Principle
- Parallel
- Single
- Auto
- Manual
• Parallel - Minimizing Circulating Current
- Parallel
- Single
- Auto
- Manual
Single/Parallel setting is available only with IEC 61850 protocol, otherwise it is indication
only.
With IEC 61850 protocol Master/Slave setting can be enabled/disabled by setting the
IU attribute of indexes 33 and 34 to in use/not in use.
AUTO_MANUAL_IND_TYPE
Either BI or DB type of process object can be created for the auto/manual indication.
This attribute must be configured before the process objects are created.
TYPE_MEAS_'number'
The type of the measurement. The type identifies the measurement for the creation of
database (indexes, object texts, units...). In case no suitable alternative can be found, the
indexes 27...37 can be used. The indexes 27 ... 32 are for user defined analog (AI) objects,
and the indexes 33 ... 37 are for user-defined pulse counter (PC) objects.
The database objects are not created until the Process Object
Tool has been used to create them.
194
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
FOLDER_'number'_TITLE
The name of the measurement to be shown in the measurement dialog. Attribute is
optional, if it is not given, the measurement is referred to as Meas. 'number' in the dialog.
If the configurable attribute TYPE_MEAS_'number' is not configured, this attribute is
disabled, and the value has no meaning.
MEAS_'number'_DECIMALS
The number of decimals used when presenting the measurement value in the dialog.
If the configurable attribute TYPE_MEAS_'number' is not configured, this attribute is
disabled, and the value has no meaning.
OPC_LN_INSTANCE_1
Specifies the OPC Logical Node names used as IEC 61850 Instance information for the
measurement type 1. The default is VECTOR("MMXU1").
OPC_LN_INSTANCE_2
Specifies the OPC Logical Node names used as IEC 61850 Instance information for the
measurement type 2.
The default is VECTOR("MMXU1").
OPC_LN_INSTANCE_3
Specifies the OPC Logical Node names used as IEC 61850 Instance information for the
measurement type 3.
The default is VECTOR("MMXU1").
OPC_LN_INSTANCE_4
Specifies the OPC Logical Node names used as IEC 61850 Instance information for the
measurement type 4.
The default is VECTOR("MMXU1").
TYPE_OF_SIGNAL'nr'
A selector type of a combo box to select the type of the signal. The list of supported
input signals is as follows:
• Binary Input (BI)
• Double Binary (DB)
• Analog Input (AI)
• Linked
195
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
If any of the first three choices is selected, the process objects are created by using the
Process Object Tool. When Linked is selected, the logical name and the index of the
process object where the signal is connected to has to be given. When an empty string
is selected, it means that the signal is discarded by the alarm indicator.
SIGNAL'nr'_TEXT
This text is used as an identifier of the signal on event list, alarm list, printouts, and so
on.
ALARMING_STATE_OF_SIGNAL'nr'
The alarming state of the signal is defined by this attribute. The value of the attribute is
related to the type of the signal. The following examples clarify how this attribute should
be defined:
• Type of signal is BI, alarming state is 1 value to be set: (1)
• Type of signal is DB, alarming states are 0 and 3 values to be set: (1,0,0,1)
• Type of signal is AI.
LINK_SIGNAL'nr'_TO_LN
The logical name of the process object to which the signal is linked.
LINK_SIGNAL'nr'_TO_IX
The index of the process object to which the signal is linked.
AR_WITH_MULTIPLE_CYCLES
An ON/OFF type of a toggle button to select the object type for the indication
auto-reclosing in progress. The configurable attribute is enabled if the attribute
P_OBJECT_LN has been configured. The database process objects will be created either
as a binary input or as an analog input depending on the selection.
SHOW_AR_IN_USE
An ON/OFF type of a toggle button to select if the tag is shown when the auto-reclosing
is in use. The configurable attribute is enabled if the attribute P_OBJECT_LN has been
configured.
By default no tag is shown. This is useful when the auto-reclosure is normally OFF and
a warning should be produced if the auto-reclosing is in use.
SHOW_AR_NOT_IN_USE
An ON/OFF type of a toggle button to select if the tag is shown when the auto-reclosing
is not in use. The configurable attribute is enabled if the attribute P_OBJECT_LN has
been configured.
196
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
By default, no tag is shown. This is useful when the auto-reclosure is normally ON and
the warning should be produced if the auto-reclosing is not in use.
LINK_AR_TAG_TO_LN
The logical name of the database process objects of the auto-reclosing module. The
maximum length of the text is 10 characters.
Allowed characters are the letters A-Z, all digits and the underscore (_). However, an
object name cannot begin with a digit or an underscore.
The configurable attributes LINK_AR_TAG_TO_LN and
LINK_AR_TAG_TO_MODULE are utilized to create a link between existing
auto-reclosing objects from the other Object Browser function (for example, auto-reclosing
module) and the auto-reclosing tag. It even supports linking of user defined process
objects as LINK_AR_TAG_TO_MODULE is an editable selector.
LINK_AR_TAG_TO_MODULE
An editable selector type of a combo box to select the type designation of the
auto-reclosing module. The configurable attribute is enabled if the attribute
LINK_AR_TAG_TO_LN has been configured.
By default, all auto-reclosing modules from the SPACOM family have been implemented
for the users to choose from. The supported modules are:
SPCT 2C5
SPCT 2D38
index 70 HSAR started/reset (E1/E2)
SPCT 2D46
index 91 HSAR forward started/reset (E1/E2)
During the relay installation and configuration, the following indexes have to be created
and SPACOM events have to be enabled as a minimum requirement for the auto-reclosing
tag by using the SPACOM Relay Configuration Tool:
SPCT 2C5
index 65 auto-reclosing started/reset (E1/E2)
SPCT 2C17
index 151 auto-reclosing started/reset (E1/E2)
SPCT 5D54
index 32 auto-reclosing interrupted by ARINH (E30)
SPTO 6D3
197
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
LINK_TRIP_TAG_TO_LN_x
The logical name of the database process objects of the protection module x (x=1..5).
The maximum length of the text is 10 characters. Allowed characters are the letters A-Z,
all digits and the underscore (_).
The configurable attributes LINK_TRIP_TAG_TO_LN_x and
LINK_TRIP_TAG_TO_MODULE_x are utilized to create a link between the existing
protection tripping indication objects from the other picture function (for example,
protection module) and the trip indication tag. It even supports linking user defined
process objects as LINK_TRIP_TAG_TO_MODULE_x, which is an editable selector.
LINK_TRIP_TAG_TO_MODULE_x
An editable selector type of a combo box to select the type designation of the protection
module x (x=1..5). The configurable attribute is enabled if the attribute
LINK_TRIP_TAG_TO_LN_x has been configured.
By default, all protection modules from the SPACOM family have been implemented
for the users to choose from. The supported modules are:
SPAM 05x
The minimum requirement for the tripping tag to function is that the following indexes
have been created and SPACOM events have been enabled by using the Relay
Configuration Tool:
SPAM 05x
index 122 thermal trip (E5/E6)
SPCD 2D55
index 26 TS2 (E31/E32) Note!
SPCD 3C21
198
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
199
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
SPCJ 4D40
index 95 TS2 (E33/E34)
SPCJ 4D44
index 108 TS2 (E25/E26)
SPCJ 4D61
index 135 TS2 (E31/E32) Note!
SPCP 3C2
index 62 U>, U>> trip (E3/E4)
SPCS 2D26
index 95 TS2 (E19/E20) Note!
SPCS 2D32
index 107 TS2 (E22/E30) Note!
SPCS 2D37
index 22 TS2 (E23/E24) Note!
SPCS 3C4
index 29 I0> trip (E3/E4)
SPCS 4D11
index 121 TS2 (E25/E26)
SPCS 4D12
index 134 TS2 (E25/E26)
SPCS 4D13
index 147 TS2 (E25/E26)
SPCU 1C1
index 12 U> trip (E3/E4)
SPCU 1C6
index 16 U0> trip (E3/E4)
SPCU 1D39
index 126 TS2 (E23/E24) Note!
SPCU 1D47
200
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
LINE_INDICATOR_COLORED_BY
A selector type of combo box to select the color of line indicator.
The line indicator can get its color either from DMS 600, Network Topology Coloring
or by manual settings.
ADD_CAUSE_IX
The ADD_CAUSE_IX attribute defines the index of a process object created for showing
the possible failure of select and execute operations. AddCause functionality is available
only with IEC 61850-8 protocol.
The AddCause feature is informative, that is, the AddCause process object value does
not prevent an execution operation in control dialog.
201
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Values -35- -30, -25- -22, 1- 18, 1000-1018, 2000-2018 and 3000-3018 have a descriptive
text for AddCause, otherwise a number is displayed as a description.
Assuming that the AddCause value is 1001, the following text is shown if the AddCause
value changes after the selected operation: Control failed: Not supported
(1001).
Assuming that the AddCause value is 1020, the following text is shown if a descriptive
text is not available: Control failed: 1020.
LIB_OBJECT_TYPE
A selector type of a combo box to select the lib object type for the object. The lib object
type can be used to configure:
• Index convention of process objects.
• Value semantic of process objects.
• Predefined custom methods.
• Object specific process object.
DEFINE_ITEM_NAME
An ON/OFF type of a toggle button to select whether the filling of OPC item path (to
IN attribute) is done when the process objects are created. This attribute is enabled only
when IEC 61850-8 protocol is selected.
OPC_ITEM_PREFIX
Defines the OPC path to the subnetwork level. This path has to be same as the object
path in IEC 61850 OPC server configuration. When this attribute is filled, the information
can be utilized when automatically generating External OPC DA Client configuration.
OPERATOR_PLACE_HANDLING
Defines the operator place handling for the Bay, Switch Device and Tap Changer objects.
Depending on the configuration the operator place can be switched between
Local/Station/NCC.
• None, there is no operation place checking
• MicroSCADA Internal, fictive process object is created for operator place
• Loc, process object for device level L/R switch is created
• LocSta, process objects for device level Station/NCC switch are created
• Loc and LocSta, process objects for device level L/R switch and device level
Station/NCC are created
Loc and LocSta are available only for IEC 61850-8 protocol.
202
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
MULTILEVEL_CONTROL
By enabling multi level control, process object for indication multilevel operator place
is created. Multilevel control means that both Station and NCC are authorized operator
places.
203
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
5. Click OK in the warning dialog box. Type the new values for the attributes in the
text boxes, or select one of the shared selector values from the combo boxes.
Clicking the enable/disable button next to each text or combo box includes or
excludes the attribute to/from the configuration. See Figure 6.36.
204
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
6. Click OK. A dialog for confirming the group configuration action appears. Click
OK to accept the new configuration. Once the group configuration operation is
finished, a log dialog appears showing the missing attributes and/or attributes
excluded from the configuration.
2. To add an attribute, click Add and type the name of the new attribute to the text
box.
3. To delete an attribute, select the attribute to be deleted and click Delete.
4. When the attributes to be configured are defined, click Close to close the dialog.
6.17.1 General
There may be project specific needs to make adaptations to control dialogs or to the
structure of the process database. With object type, it possible to affect to the behavior
of standard Power Process Library objects both in the configuration phase and during
runtime. The object type can be used to configure:
• Index convention of process objects.
• Value semantic of process objects.
• Predefined custom methods.
205
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Object type is an ASCII file with suffix .DAT. Object types are located in directory
\sc\sa_lib\defaults\Object_Types or alternatively in \sc\apl\'apl
name'\APLMOD4\Defaults\Object_Types.
The content of the object type file is a SCIL list dump. From object type of view, the
content can be divided as attributes and methods.
6.17.2.1 Attributes
Attributes can be used for defining the index convention of the object (at run time). This
is useful, for example, if the control dialog is connected to process database built with
convention, where indexes differ from the ones that are created by Power Process Library
function.
Attributes can also be used to override selections made in Standard Function Tool. All
attributes of the standard function do not have to be defined in the object type.
206
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
6.17.2.2 Methods
Object type methods can be divided into two categories: ones that are executed in
configuration phase and the ones that affect the run time functionality of the control
dialog. The run time methods are dependent on the Power Process Library function.
Object type methods can be written directly into the object type file or method can be a
reference to an external file which is executed with #DO READ_TEXT … statement.
The name of the object type file should be carefully considered in order to avoid duplicate
file names. File name could contain e.g. some device specific or protocol specific
information, for example REx5xx_IEC104.DAT.
6.17.3.1 Attributes
Object type for switch device has the following attributes to modify the index convention.
Table 6.116: Attributes for index convention
Process object meaning Default Power Pro- Attribute in object type
cess Library index
Position indication 10 INDICATION_DB_IX
Open select command 11 OPEN_CMD_IX
Close select command 12 CLOSE_CMD_IX
Execute command 13 EXECUTE_CMD_IX
Open execute command 13 EXECUTE_OPEN_CMD_IX
207
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
For example, if the open and close interlocked signals would come from indexes 71 and
72, the definition in the object type is done in a following manner.
LIST(-
OPEN_ILOCK_IX=71,-
CLOSE_ILOCK_IX=72)
These methods can be utilized when a process database is created with Process Object
Tool.
208
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
@v_Object_Type_Process_Object = VECTOR(-
LIST(LN=%LN,IX=201,...),-
...
LIST(…))
#return %v_Object_Type_Process_Objects
Depending on IED or protocol, certain signals can have a different value for same
meaning. For example, some IED can send value 1 when Device is interlocked, whereas
some other IED can send value 0 in a same situation.
In order to support different value conventions in control dialog, it is possible to define
value conversions in the object type.
Table 6.118: Method for value conversion
Method Meaning
METHOD_GET_INDICATIONS This method is executed when user opens
control dialog and used for value conversion.
209
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
It is possible to define object type specific localization of the strings for control dialog
according to user language, see REPLACE_STRINGS.DAT, where languages EN and
FI are implemented as an example.
String ID:s are returned by method METHOD_GET_STRING_REPLACEMENTS of
object type. To replace, e.g. id 100, define attribute ID100 in list returned by the method.
See REPLACE_STRINGS.DAT how to do this.
Contents of REPLACE_STRINGS.DAT:
LIST(METHOD_GET_STRING_REPLACEMENTS=VECTOR(-
210
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
"@strings=LIST(-",-
"ID296=""Hand..."",-",-
"ID297=""Auto..."",-",-
"ID315=""Are you sure you want to change the switch to Hand state?"",-",-
"ID316=""Are you sure you want to change the switch to Auto state?"")",-
"#block_end",-
"@strings=LIST(-",-
"ID296=""Kasi..."",-",-
"ID297=""Automaatti..."",-",-
"ID272=""Kytkin on kasitilassa"",-",-
"ID273=""Kytkin on automaattitilassa"",-",-
"#block_end",-
"#RETURN %strings"))
211
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
6.17.3.6 Configuration
Once the object type description is made, it can be taken in use while installing Switch
device.
In Standard Configuration Tool there is an attribute LIB_OBJECT_TYPE. The appropriate
object type can be selected from the combo pop down.
212
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
If the object type has own control methods, CONTROL_TYPE attribute has to be
configured "Use from Object Type". When this is selected object type has to have all
control methods defined. See section 6.17.3.4 Methods for customized control .
213
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
214
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
7 Sequence Configurator
7.1 Overview
SYS600 Sequencer offers creation, execution and monitoring of switching device
command sequences in MicroSCADA Pro. Sequencer has two separate tools one for
creation and configuration of sequences (Sequence Configurator) and another tool for
execution of sequences (Sequence Executor). This chapter describes sequence creation
and configuration using Sequence Configurator. More details regarding Sequence
Executor tool can be found from SYS600 Operation Manual.
A Sequence is a collection of one or more steps/commands for switching type devices.
These sequences can be created and configured by a MicroSCADA user with sufficient
engineering rights using Sequence Configurator/SeqConf tool. For each step of the
sequence, the command to be executed is defined together with optional precondition
and postcondition checks or delays. Currently supported commands are switching device
open/close command or message box display. For information on how to execute
sequences see SYS600 Operation Manual.
Sequences can also be started from internal and external triggers in addition to an
interactive user. Internal triggers include event channel and Schedule function of the
MicroSCADA Pro Calendar. Using external triggers, the sequences can be started from
NCC via COM500i functionality or from DMS600.
Sequencer also supports creation and execution of sequences from external system via
MicroSCADA OPC server interface. This is used by DMS600 for dynamic sequence
creation and execution.
7.2 Terminology
This chapter defines the terminology used in relation to Sequencer
Sequence Configurator – a tool for creation and configuration of sequences
Sequence Executor - a tool intended for execution and monitoring of configured
sequences
Sequence – List/collection of steps
Step – a configured command to execute or a message to display to an interactive user.
The configuration of a step consists of:
• Precondition or command execution delay
• Command
• Postcondition or proceed with next step delay
Precondition/Postcondition – several comparisons of process objects with defined
values. If the condition is fulfilled the sequence execution continues. If the condition
fails the further sequence execution will be interrupted.
215
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
216
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
During installation the following line gets added to LIB5INIT_1:C command procedure
#exec epu_seq_main_mng_clear_queue:c
epu_seq_main_mng_clear_queue:c command procedure resets possible interrupted
sequence executions due to abnormal system halt.
The following line gets added to LIB5INIT_H:C command procedure.
#exec epu_seq_main_continue_executing:c
The above command procedures ensures that running sequence will continue to execute
when a switch-over occurrs in a Hot-Standby system. Both the above calls are removed
automatically during sequencer uninstallation.
217
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Menu bar
The menu bar in Sequence Configurator consists of different menus.
The descriptions of the each menu functions are described in Table 7.1 below.
218
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Sequences are used to control specific switching objects that are configured in sequence
steps. Table 7.2 below lists all the sequence parameter which can be configured using
the Sequence Configuration tool.
Table 7.2: Sequence configuration parameters and corresponding descriptions
Parameter Description Type Values/Range
Sequence Name Textual identification of Text 1-30 character
the sequence
User Response Timeout for waiting Integer 1-60 Minutes
Timeout user response during Default: 1 min
sequence execution. If
no user response re-
ceived within the
timeout, the sequence
execution is aborted
219
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
220
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
221
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
A sequence containing only Process Object links to one bay (based on OI) can be used
as template to duplicate the sequence to other equivalent bays.
222
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
223
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
8. Edit delay after command execution in seconds. This option is available in case no
postcondition is set
9. Edit postcondition in help of the condition wizard (see Figure 7.8)
10. Edit postcondition check time in seconds if postcondition is set
11. Edit text for INT user when postcondition is not fulfilled
224
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
The precondition and postcondition can be constructed in help of the condition wizard.
225
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
ID_APL
ID_APL is an INTEGER, 1.. 2147483647 (MAX_INTEGER), sequence number, unique
within MicroSCADA application. This value is used in the command to start the sequence
from NCC via COM500i. ID_APL value is stored in the index table which is saved in
\sc\apl\<apl name>\SEQUENCER\SEQUENCES\index.csv file.
Sequence ID_APL numbers are generated by the sequencer configuration tool. Sequencer
will ensure that the ID_APL number of the executable sequence is unique within an
application. If the user copies the sequence file from another application, Sequencer
assignes a new unique and unused ID_APL for the copied sequence file.
226
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
227
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
External triggers can be used e.g. to start a sequence from NCC via COM500i.
There is a check box for each configured NCC connection in COM500i, that is used to
allow (when checked) or deny the execution of the sequence from the corresponding
NCC.
For user types INT and SYS the external trigger permissions are not checked. See details
in Table 7.3 Below.
Table 7.3: Summary of sequence execution triggers
Trigger Internal User Name Type Activation Output Results Available
source
INT <Interactive user name> Interactive User Sequence Execution
• Sequence Execution Tool
Tool
• Event and Alarm List
• SYS600 Notify
• Execution log
SYS SYS Internal trigger
• By Command pro- • Event and Alarm List
cedure • SYS600 Notify
• By Event Channel • Execution log
DMS DMS External trigger Command from DMS
• Event List and Alarm List
• SYS600 Notify
• Execution log
228
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
When a sequence starts by an interactive user (”INT” User Type), sequence execution
gets aborted during HSB takes over. However, when a sequence starts by internal trigger
(SYS user) or by an external trigger (“COM” or “DMS” user type), sequence execution
continues automatically on HSB take-over.
Note: During installation procedure SCIL-code is already added in LIB5INIT_H:c for
Sequencer HSB to work:
#exec epu_seq_main_continue_executing:c
;THIS STRING IS CREATED AUTOMATICALLY.
;PLEASE DO NOT EDIT IT MANUALLY
229
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Validation checking ensures that the sequence fullfils the valid startup requirments e.g.
needed Process Objects and standard function configuration data exists. Validation
checking can be performed manually from Sequence Configurator's menu by selecting
Sequence>Validation Check. When an interactive user selects a sequence to run it in
Sequence Executor, validation is checked before the selected sequence is loaded for
execution. If validation checking fails the sequence cannot be loaded.
After validation checking is completed, user can see three type of checking messages in
Validation Check dialog:
• OK – Value or Validation checking passed
• FAIL – Unexpected values
• ERR – Validation checking error
When a validation check fails, the checking can be repeated from validation check dialog
by pressing the Repeat Check button.
Sequence controllablity check is done in addition to validation check and it is done only
during execution. Every single step of the sequence will be checked before the execution
will start.
Controllability check includes:
• All station, bay and device local/remote keys and operation place indications are in
the expected position
• Switching Device to be controlled is not interlocked or blocked by the process
• All Process Objects included:
- must exist
- are in use
- have proper Object Status
- are not blocked
The failed checks are visible in Figure 7.13.
230
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Figure 7.13: Controllability Check Dialog showing a failure due to Bay local/remote switch
inhibition of control
231
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Display Builder is an editor that lets the user create complete graphical interfaces. It is
the primary tool that is used when Process Displays are created. The user can draw the
displays and map the signals before or after process objects have been created to the
process database, except that the Object Browser requires an existing and running
application.
Symbols representing the process objects can be created to an empty display from the
palette, and the signal mappings can be done manually. Alternatively, the symbols and
mappings can be created with the Object Browser. After adding the symbols for process
objects and busbars to the display, the network topology coloring can be built manually
or by using Display Builder's automatic functions. For more information on the Display
Builder, see SYS600 Process Display Design.
233
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
for symbols that are dragged into the display from the object browser tree, and connects
the symbol to the variables. Sometimes, it is necessary to edit these settings manually.
In the data source settings, the application number can be set to all data variables that
exist in the data source. This makes it possible to create more than one data source in
the same picture and define the application for them separately.
234
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
This application number is applied to all data variables that are created under this
data source.
5. Click Rescan.
235
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Data variables can also be created with vector and matrix data from MicroSCADA.
To create data variables with vector and matrix data:
1. In Display Builder, open Edit -> Data Variables.
2. Create a MicroSCADA data source and connect it to an application.
3. Create a data variable to MicroSCADA data source.
4. Give an object reference in MicroSCADA data variable settings.
5. Select Generic signal as variable type.
6. Select Create and edit new file... in Run SCIL combo box.
7. Modify the result value.
8. Click Apply. Shape options are activated in Data Variable group.
9. Select vector or matrix shape. For vector data source, Length setting is activated.
For matrix data source, rows/cols setting is activated.
10. Type appropriate length or row/column value.
11. Create a graph object and select Graph Properties from context menu of the object.
12. Select suitable type from Types tab sheet of Graph Properties window (e.g. surface
type for matrix).
13. Connect the graph to data variable and set suitable range in Variables tab sheet.
When matrix data type is used, the data must be a vector set. Each inner vector represent
one column. For example, when defining a matrix that has two rows and three columns,
it is represented following way:
VECTOR(VECTOR(1,2),VECTOR(3,4),VECTOR(5,6))
As SCIL code this would be
#modify
L_INPUT:V=LIST(VALUE=VECTOR(VECTOR(1,2),VECTOR(3,4),VECTOR(5,6)))
#RETURN %L_INPUT.VALUE
Following example returns vector of length 3:
#modify L_INPUT:V=LIST(VALUE=VECTOR(1,2,3))
#RETURN %L_INPUT.VALUE
When an OPC item with vector data type is used to launch SCIL code, the VALUE
attribute is not created in %L_INPUT, and %L_INPUT. DATA_TYPE value is NONE,
and therefore it cannot be used as an argument. Instead, create the value with SCIL. This
way, it can be passed to data variable.
236
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
237
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
238
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Figure 8.5: Rescanning configuration and updating and saving index configurations
4. Ensure that the indexes were updated correctly, see Figure 8.6.
• Select a Status color Signal Type data variable on the left pane.
• Used indexes are displayed in the Status Color Indexes field and semantics as
a tool tip.
239
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
240
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
241
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
General settings are used to control some features of the Object Browser. Normally, it
is not necessary to modify these.
The RX (or LN or ST) values are separated with the colon (:).
Whitespace (except spaces) between separators and RX (or
LN or ST) values are not skipped.
242
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Filtering settings can be used to show and hide process objects in the Object Browser.
The RX (or LN or ST) values are separated with the colon (:).
Whitespace (except spaces) between separators and RX (or
LN or ST) values are not skipped.
243
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Key Value
IxMax Used for hiding process objects with IX value
greater than a certain value from the Object
Browser. This setting is useful for skipping
LIB510 event recording objects that all have IX
> 100.
0 = not used
<n> = Skip objects with larger IX
To include larger IX values for some objects use
IncludeAllIndicesForRxValues and IncludedSpe-
cifiedIndicesForRxValue settings.
IncludeAllIndicesForRxValues Shows all IX values for certain RX values in the
Object Browser. This setting overrides IncludeIx
setting.
IncludedSpecifiedIndicesForRxValue Specified indices for the specified RX values,
which are shown in the Object Browser. This
setting overrides other RX and IX filter settings.
Indices are separated with the comma (,). In-
dices are listed after RX value and the # charac-
ter. Note that whitespace (except spaces)
between separators are not skipped. Range of
indices is defined with a dash e.g. 10-17
ExcludedRxValues RX values that will be hidden from the Object
Browser. This setting overrides the In-
cludeAllIndicesForRxValues setting.
ExcludeLNsStartingWith Hides all LNs that start with these substrings
from the Object Browser. This setting overrides
both RX, IX, and ST filter settings.
ExcludedStValues ST values that will be hidden in the Object
Browser. This setting overrides RX and IX filter
settings.
In addition to general and filtering settings, the configuration file contains symbol
definitions for process objects. These are under [RX_Settings] and [RX_Mapping]
sections in the configuration file. [RX_Settings] section defines what part of the RX
value is used for identifying devices in the configuration file, and [RX_Mapping] section
defines what graphical symbols are available for the process object/device. It is possible
to add, remove, and modify symbol definitions in the configuration file.
Table 8.5: RX_Settings
Key Value
StartIndex Used to specify the start position of the substring
in the RX attribute value that contains the object
type. The default value is 23.
Length Used to specify the length of the RX attribute
substring that contains the object type. The de-
fault value is 4.
244
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Key Value
DetailedLength Used to specify the length of the RX attribute
substring that contains the detailed object type.
The detailed object type can be used to differen-
tiate devices that have the same value specified
by Length setting but different value when more
characters are taken to substring. The default
value is 8.
In a SYS600 product, a device has an instance in the process database. The device has
both static and dynamic data. This data is represented in the process display using
graphical symbols. Graphical symbols available in the Object Browser for the device
and the data linked to the symbol are configured to the configuration file. The syntax of
the symbol definition is in its simplified form.
Single symbol
device_id = [symbol], e.g. QB01 = 02 - SA_IEC\Breaker.sd
Symbol group
device_id = [symbol_group], e.g. QE01 = <02 - SA_IEC\Disconnector.sd:0,0:IEC Earth
Switch, vertical & 01 - SA_Common\Earth.sd::0,-1000:Earth symbol>
It is possible to define the following properties for symbols in the configuration file:
• Name
• Path to symbol file
• Coordinates
• Data mappings
245
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
246
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
The following listing shows the default settings for the Object Browser:
[Options]
UsesReversedSingleIndications=0
UsesReversedDoubleIndications=1
247
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
LocalRemoteSwitchRxValues = ASTA:ABAY:AGRP
PcmObjectSubdrawing = 01 - SA_Common\IED_pcm.sd
UsePtSpecificMappingRxValues = ASTA:ABAY:FARC:AGRP
[Filters]
IncludeIx=10
IxMax=99
IncludeAllIndicesForRxValues = PMEA:WDDD:WDDS:FMFUISTR:FMFUITRP:FTRPISTR:FTRPITRP
ExcludedRxValues = ASYS:ESYS:PCOS:MFUI:WMFU:WNETINET
ExcludeLNsStartingWith = BNCC:SAGR_:TOPO_
ExcludedStValues = IN_COLOR
[RX_Settings]
StartIndex=23
Length=4
DetailedLength=8
248
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Normally, each object presented in the browser has at least one symbol presentation.
The configuration file contains default symbols for common process objects. The user
has the possibility to create symbol definitions for any object shown in the browser that
have unique device identification.
In general, the syntax for symbol definition for one symbol is the following:
device_id = [symbol]
To create new symbol definition for the object, use the following instructions:
1. Open the configuration file and locate symbol definitions. The new line to be added
is a key-value pair. Here, WSYS = 06 - SA_Supervision\Server.sd is used as an
example.
2. Start a new line and enter an object identification followed by the = character, e.g.
WSYS=
a. Object identification consists of an object type and possibly an object IO type.
The object type is taken from the RX value of the object. The object IO type is
taken from the ST value of the object. Examples are shown in the table in section
0.
b. The RX value can be more detailed as well, see the DetailedLength setting.
3. After the = character, enter a file name for the symbol, e.g. 06 -
SA_Supervision\Server.sd.
a. Note that relative paths can be used. For example, directories and symbols in
the Palette directory can be found using relative paths. For more information,
see Section 23.1 Search Path and Relative Paths in Process Displays.
4. Items 1-3 are mandatory and the symbol definition is now ready. However, the
symbol definition misses optional definitions for process mapping, as well as a
descriptive display name of the symbol. Process mapping is introduced in more
detail in Section 8.6.9 Create a process mapping definition for the symbol, and
display name in Section 8.6.7 Change the symbol name in the browser.
5. Save the configuration file and restart Display Builder.
Object Browser makes possible to instantiate many symbols at the same time for the
object shown in the browser. The symbols may include an image of the device, status
symbol, and some labels, for example, for identifying the device. These symbols form
a symbol group, which can be manually configured to the configuration file. The initial
design of the symbol group is done using an empty process display. Note that it is not
possible to export the design automatically to the configuration file. The design in the
empty process display is only used to help in finding valid coordinates for each symbol
of the symbol group. These coordinates can then be used in the symbol definition.
249
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
The symbol group can be written directly to the configuration file by using a text editor,
but the procedure described below makes it easier to get correct coordinates for the
symbols in the group. In general, the syntax for symbol definition for a symbol group is
the following:
device_id = <[symbol] & [symbol] & …>
Symbol coordinates inside the symbol group is based on the width and height of the
symbols in the symbol group, as well as to the coordinates of the main symbol. Symbol
coordinates is an optional definition of the symbol, see Section 8.6.3 Symbol definitions.
Example:
Designing a symbol group having symbols with different dimensions.
This example illustrates how to configure the symbol group containing three other
symbols (Label) on the right side of the main symbol (Server). The labels are distributed
vertically even to the height of the Server symbol.
1. Create all symbols that form the symbol group from the Palette and place the main
symbol in the middle of the new process display, i.e., the anchor point of the main
symbol is in coordinates (0,0). Move other symbols as they would appear surrounding
the main symbol. This will help to define the exact coordinates for other symbols
surrounding the main symbol.
a. The symbols in this example have the following properties as seen in the Display
Builder:
Server (main symbol in the group) Label L (left justified text)
Width: 2000 Width: 1500
Height: 2000 Height: 400
Anchor point: middle center Anchor point: middle left
b. The anchor point of the symbol can be seen in Display Builder when selecting
the symbol. The anchor point is shown with a dot. Observe the anchor points
of all symbols and how they relate to the main symbol width/height.
2. Next, the difference between the X-axis and Y-axis values of the symbols are
calculated. Notice that the main symbol is now located in the coordinate (0,0).
a. The difference between the anchor points of the main symbol and other symbols
in the X-axis is the main symbol width divided by two, i.e., 1000. Therefore,
the X-axis value for other symbols is 1000.
b. The Y-axis values are also calculated taking the anchor points into account:
Label Y-axis value
Topmost label Server symbol height divided by two
=1000, the anchor point of the label symbol
is in the middle, therefore 400/2=200. The
vertical distance between the anchor points
is 1000-200=800. The Y-axis value for the
topmost label is 800.
250
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
3. The calculated values can be verified by observing the symbol's X-axis and Y-axis
values in the symbol properties. Replace the symbol's X-axis and Y-axis values with
the calculated values. There should be only minor changes in the symbol positions.
Otherwise, there is something wrong with the calculated values.
4. When the coordinate values are calculated and verified, symbol group definition
can be added to the configuration file.
a. WSYS=<Server.sd & Label L.sd::1000,800:Server with labels & Label
L.sd::1000,0 & Label L.sd::1000,-800>
5. Save the configuration file.
Note that the process mapping definition, located before the coordinate definition,
was skipped, hence the marking "::".
8.6.6.3 Create symbol definition containing alternative symbols for the object
Each object may have alternative symbols, and the user can select a symbol to be created
when the object is inserted into process display. In general, the syntax for symbol
definition for alternative symbols is the following:
device_id = [symbol] | [symbol]
The | operator is used to determine alternative symbols. To create an alternative symbol
definition for the object, use the following instructions:
1. Open the configuration file and locate symbol definitions.
2. Find an existing symbol definition and go to the end of the definition. Insert the |
operator to the end of the line and then enter the new symbol definition.
3. Save the configuration file and restart Display Builder.
251
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
When an object uses the same symbols as another object, it is possible to define a
reference to the other object's symbol definition. This reduces duplicate symbol definitions
and maintenance of the configuration file. This functionality is helpful when similar
device types should have the same symbol definitions.
In general, syntax for symbol definition reference is the following:
device_id = [device id]
A referenced symbol definition is surrounded with brackets, [ and ]. To create a symbol
definition reference for the object, use the following instructions:
1. Open Object Browser configuration file.
2. Find a device identification, whose symbol definition is to be referenced and write
it down, e.g. WSYS.
3. Instead of repeating the symbol definition of another device, use device reference
syntax:
• E.g. let device QB02 to use same symbols as device QB01:
• QB02 = [QB01]
4. Save the configuration file and restart Display Builder.
When the device reference is encountered, the referenced device is searched. The search
continues until a symbol definition is found. If there is a circular reference or the reference
hierarchy is too deep, an error message is shown.
Once the object has been selected, all the symbols available for that object are shown in
a drop-down list. The name shown in the list can be changed to give the user more
information about the symbol e.g. shape, color or other properties.
The symbol definition is the following:
symbol = [symbol path] : [data mappings] : [coordinate] : [symbol name]
1. Open the configuration file and locate symbol definitions.
2. The symbol name is the fourth parameter for the symbol.
3. Enter a descriptive name for the symbol e.g. Nuclear Power Plant.
4. Save the configuration file.
If the symbol definition is a symbol group, the symbol name is read from the first symbol
of the group. If the symbol name is not defined at all, the symbol path is shown instead.
When there are several symbols defined for the object, it is possible to change the order
of the symbols shown in the drop-down list. This functionality enables the user to place
252
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
frequently used symbols to the beginning of the list. The symbol definition is the
following:
device_id = [symbol] | [symbol] | …
The | operator is used to separate different symbols. The more left the symbol is, the
higher the order in the drop-down list. Symbol order can be changed by swapping the
symbol definitions between two | operators.
To change the symbol order:
1. Open the configuration file and locate symbol definitions.
2. Locate symbol definition for the object whose symbol order needs to be changed.
3. Swap symbol definitions between two | operators, e.g.:
Original: WSYS = Communication Server.sd | Database Server.sd
Swapped: WSYS = Database Server.sd | Communication Server.sd
4. Save the configuration file.
The drop-down list is generated by reading the symbol definition and parsing all symbols
separated by the | character. Symbols are shown in the order they are specified in the
symbol definition.
Symbols have some dynamic functionality based on process data mapped to the symbols.
The process mappings are defined in the Object Browser configuration file. There are
four types of data mapping:
• No data mapping.
• Map to constant.
• Map to dynamic value.
• Map to calculated dynamic value (status and color).
A symbol may have many data items mapped. The count of data items is relative to the
data variables published by the symbol. The data items defined for the symbol must be
entered in the same order as they will populate the data variables of the symbol. For
example, the first data variable of the circuit breaker symbol is Position and the second
is Status Color, the data items are defined so that the first item presents the position and
the second the status color. In the configuration file, the delimiting character for data
items is the comma (,).
Data mapping types are introduced below. The syntax of data mapping is specified in
Section 8.6.3 Symbol definitions.
No data mapping
It is possible to define that nothing is mapped to the data item of the symbol. This is
indicated with the - character. Leaving data mapping section of the device empty means
that there are no data mappings at all.
253
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Map to constant
It is possible to give a constant value for the data item. The constant value can be numeric,
alphabets, or alpha numeric. Constant string value is surrounded with quotation marks
("example").
254
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
In case of syntax errors, error messages might appear. The most common error is a
mismatch between data types of the process data item and the data variable of the symbol.
Object names are automatically read from the MicroSCADA process database, and there
is no setting to change the format or the name of the object in the configuration file. The
object names can be changed by changing the process object attributes in the process
database, for example by using Object Navigator.
The object name is generated from the following information found from the process
database:
• Object Identifier: The last substring of OI attribute value.
• Object Text: The value of OX attribute.
The format of the object name in the browser is following:
%Object Identifier% (%Object Text%)
The changes are applied when the process database is updated by using the Select...
button. The object name is changed in the browser.
255
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Figure 8.7: The relationship of the topology model, process objects, and process displays (red
dots illustrate process objects)
The data flow of the functionality is shown in the figure Figure 8.8. The network topology
model is built from displays and it is entered into the process database. It is combined
with the data from the process. Then, the process database calculates the topological
state which is sent for coloring the process displays.
Topologies may contain several types of network items, such as line segments, different
kinds of switching devices, transformers, generators, line indicators and earths.
256
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Line indicators can be used for connecting embedded displays to an overview display,
to act as a power feed, or as an output. To connect an overview display to an embedded
display, add a line indicator to the embedded display and snap a line segment to it in the
overview display.
Transformers can be used to convert a voltage level to another. In network topology
coloring, the transformer always emits the configured voltage level. It does not matter
what the input voltage is. The earth travels through transformers.
It is possible to design a large display that contains all network objects, but, normally,
subnetworks are designed as small displays which are then used to design a large overview
display. This section introduces several ways to build a network topology. These include
putting all network objects to one large display, or dividing a network to small displays
and then combining them to one large overview display. For each option, a description
is given, and pros and cons are listed in the aspect of engineering, operation, and
maintenance.
257
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
A network can contain one or more network topology models. For most applications,
using only one model leads to the best solution. For a large application that may have
several hundreds of process displays, and if the network contains non-interconnected
parts, it may be useful to divide a network to several different models. Importing a model
with a large number of displays may take a while. Having many models does not have
a performance impact on a live system.
All network objects are put to one large display, there are no other displays. There are
two different aspects to this option. This option is suitable for small networks, where it
is not necessary to view subnetworks separately. This option is not recommended for
large networks.
Configuration
There is only one large display, which is built in Display Builder. This is the only display
that is shown to the operator. See also Section 8.7.1.1 Enabling network topology coloring
for a display.
Pros
• Engineering: Easy for small networks.
• Operation: One display, and therefore network status is easy to see and status is
propagated to whole network.
• Maintenance: Only one display to maintain.
258
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Cons
• Engineering: If the network is large, designing needs excessive zooming and
shrinking of graphical symbols. Finding engineering errors in the large network is
a time taking process.
• Operation: Awkward navigation and controlling of large network.
• Maintenance: -
A large network is divided into subnetworks, and a small display is designed for each
subnetwork. A small display normally presents a substation. There is no overview display
presenting the large network.
Configuration
Topology model is built of all the displays. If the displays have common items that exist
in two or more displays, the state is displayed identically in all displays.
See Section 8.7.1.1 Enabling network topology coloring for a display.
Pros
• Engineering: It easier to design a subnetwork when it is presented in a small display.
The engineer can easily see the subnetwork with one glimpse without zooming and
panning the display.
• Operation: Zooming and panning of displays is unnecessary. Controlling the network
objects is easy because graphical symbols are larger.
• Maintenance: It is easier to maintain a subnetwork, because there is one small display
corresponding each subnetwork.
Cons
• Engineering: -
• Operation: There is no overview display.
• Maintenance: -
A large network is divided into subnetworks. A small display is designed for each
subnetwork. A small display normally presents a substation.
Additionally, an overview display is designed embedding small displays to an overview
display and connecting them to each other using line indicators and line segments. The
correct network status is achieved with the sum of network statuses in small displays.
259
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Configuration
The network can be displayed as a larger Process Display containing the whole network
or as smaller Process Displays containing a part of the larger network. This section
describes how the information can be consistent in different Process Displays and how
the subnetworks are connected to the network overview.
Start building the network overview by creating the subnetworks and adding them to the
network overview.
260
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
261
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Pros
See also Pros, on page 259 in Section 8.7.1.3 Many small displays.
• Engineering: Designing the overview display is easy, just embed small displays and
connect them to each other with busbar symbols. Small displays are references in
the overview display, thus, it is easier to handle small display in the overview display
when only one symbol is selected.
• Operation: There are small displays and an overview display that can be used for
viewing network status. The coloring in small displays is always in accordance with
the status calculated from the overview display.
• Maintenance: -
Cons
See also Cons, on page 259 in Section 8.7.1.3 Many small displays.
• Engineering:-
• Operation: -
• Maintenance: -
262
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
In addition to network objects shown in the simple small display, detailed small displays
normally contain measurement data; values and bars. Detailed small display is built using
a simple small display and measurement value/graph symbols.
Configuration
1. First build simple small display, see section Simple small displays.
2. Create a new process display for detailed small display.
3. Embed simple small display.
4. Create measurement values and bars beside the simple small display.
5. Save detailed small display.
Detailed small displays are not included in the network overview display since detailed
information in this display is not part of the topology. Instead, simple small displays are
included in the network overview display.
There might be a need for a small overview display, which is used to get a quick view
of the large overview display. Usually, this display contains less than fifty network
objects, which are referring to the large overview display. Normally, the network objects
selected to this display are important nodes in the network. When the important node
has an unusual state, it usually means this affects the whole network.
Configuration
Summary overview display requires that a valid overview display is configured to the
network topology coloring system. To create a summary overview and to reference
network objects in the overview displays, the following steps should be followed:
1. Create a new process display, which will be a summary overview.
2. Open a network overview display.
3. Copy network objects from the network overview display.
a. If network objects are inside the embedded display, open the display and copy
the network objects.
b. An embedded display can also be copied.
4. Paste the network objects to the summary overview display.
5. Repeat steps 3 and 4 to each network object to be referenced.
6. Save the summary overview display and open it in Monitor Pro.
7. Verify that the network objects in the summary overview are colored with the same
color as in the network overview.
Note that referred network objects cannot be used to propagate their state to adjacent
network objects. Also, if there is a network object that is not part of the network overview
display, the line segment is not colored.
263
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
This scenario is mostly suitable in electric networks. An additional circuit breaker and
an earthing switch can be used after an incoming line indicator. The devices can be
264
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
virtual or real. In this scenario, virtual devices are created. These two switches simulate
the state of the upper level network enabling to simulate all the states that a feeding line
may have, except for looped the state.
1. Open Tool Manager > Object Navigator.
2. Select Object > Install Standard Function.
3. Browse for Standard Functions/SA_LIB/Process/Switching Device and click Install.
4. Fill in STATION_NAME, BAY_NAME, DEVICE_NAME and P_OBJECT_NAME.
5. Click Apply.
6. Open Process Object Tool from the Tools tab.
7. Click Create All.
8. Repeat steps to to create more virtual circuit breakers.
9. Use Object Browser in Display Builder to create symbols to the station Process
Display.
It is recommended to separate virtual circuit breakers from the station picture.
An example of an earthed upper level network (Rivendell 110 kV) is shown in Figure 8.11.
Generally, measurements can be used to control the direction of the line indicator
(incoming/outgoing, or powered/not powered, respectively) from the transmission
network.
1. Create a new process object of type Analog Input(AI).
2. Create an Event channel.
The Event channel updates the value of the new object to positive when the line
indicator is incoming.
265
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
3. Map the new process object as the position indication of the line indicator.
The Event channel can also set the status on the process object. If the status is set to 1
or 10, the line indicator propagates an uncertain value.
Because the value of the line indicator is propagated to the network, the Event channel
should be designed so that it only changes the value when necessary.
Network topology coloring of a display can be removed by removing the display from
the model. This will inform network topology coloring system to not to calculate the
state of the network for that display.
To remove the configuration:
1. Open Display Builder.
2. Select Actions > Manage Topology Models....
3. Select a model in which the display is.
4. Select a display from the list and click Remove display.
Verify the removal by opening the removed display in Monitor Pro.
266
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
States used in network topology coloring are defined in Table 8.8. Configure the state's
color by using the Color Setting tool, see SYS600 Process Display Design. The network
object can have one of the following states:
• Powered
• Unpowered
• Looped
• Uncertain
• Error
• Earthed
Table 8.8: States and colors
Color name Description Color
Earthed The object is connected to Yellow
ground.
Error The color is used in error situ- Magenta
ations. For example, powered line
segment is earthed.
Looped (meshed) The color is used when there is a Red
loop, e.g. two or more feeding
points.
Powered/active, common Default color used on powered Green
objects.
Powered, generator Color used for line after generator. Green
Powered, incoming line indicator Color used for line segment after Green
line indicator.
Powered, transformer (primary) Color used for line segments Cyan
when power flows to transformer
primary winding side.
Powered, transformer (secondary) Color used for line segment after Dark Green
transformer secondary winding.
Powered, transformer (tertiary) Color used for line segment after Olive Green
transformer tertiary winding.
Powered, transformer (quaternary) Color used for line segment after Dark Cyan
transformer quaternary winding .
267
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
In the network, situations can arise where a line segment can have two or more colors
that could be used in the line segment, for example, generator and transformer colors.
A default priority order of colors are shown in Table 8.9. Some of the priorities are not
configurable and the user can only configure priorities of feeding point types.
Table 8.9: Color priority order
State Priority Configur- Description
able
Error 1 NO
Uncertain 2 NO The used color after uncertain
switching device.
Looped 3 NO
Earthed 4 NO Earthed color is always indicated
before powered and unpowered.
Powered, feeding line 5 YES The priority of a feeding point
type color in powered line seg-
ments is configurable. Function-
ality can be seen in the line seg-
ments, which are looped. The
coloring mode must be set to
feeding point or voltage source
type to enable priorities.
Powered, generator 5 YES
Powered, transformer, windings 5 YES
(primary, secondary, tertiary, quatern-
ary)
268
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
The Network Topology Manager tool is used for configuring the voltage levels of the
power process (network topology schema POWER) in the current application. It shows
network topology models of the power process in the current application.
To configure the voltage levels:
1. Open the NT Manager tool by selecting Tools > Engineering Tools > Tool Manager
> Application Objects > NT Manager.
2. View the default voltage levels by clicking Levels > Restore Defaults.
Power process may have up to 20 voltage levels. Levels are numbered starting from zero.
Each level consists of three items:
269
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
@t_LN = %PF_ID
@i_IX = %PF_INDICATION_INDEX
@b_Earthed = False
@b_Prevent_Closing = True
@t_Additional_Text = ""
@l_NO = 't_LN':PNO'i_IX'
270
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
@l_CN = 'l_NO:vLN':PCN'l_NO:vIX'
#loop_with i = 1 .. length(%l_CN)
@tmp_LN = %l_CN(%i).LN
@tmp_IX = %l_CN(%i).IX
;if line_segment
;if earthed
#case 'tmp_LN':PNT'tmp_IX'
#when 0 #block
@b_Prevent_Closing = True
@t_Additional_Text = "Unknown"
#block_end
#when 1 #block
@b_Prevent_Closing = False
@t_Additional_Text = ""
#block_end
#when 2 #block
@b_Prevent_Closing = True
@t_Additional_Text = "Uncertain"
#block_end
#when 3 #block
@b_Prevent_Closing = True
@t_Additional_Text = "Powered"
#block_end
#when 4 #block
@b_Prevent_Closing = True
@t_Additional_Text = "Error"
#block_end
#when 5 #block
#block_end
#case_end
#block_end
271
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
#loop_end
@CLOSE_INTERLOCKED = TRUE
#block_end
#block_end
#RETURN LIST(OPEN_INTERLOCKED=%OPEN_INTERLOCKED,
CLOSE_INTERLOCKED=%CLOSE_INTERLOCKED, INTERLOCKING_CAUSE=%INTERLOCKING_CAUSE)
272
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
273
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
9 Event Display
This chapter describes the technical aspects of the Event Display. For information on
the usage of the display, see the SYS600 Operation Manual.
Event Display provides a list of events. The purpose of the list is to provide the operator
a view of what is happening in the system. It is also possible to receive information, such
as activities carried out by other users, acknowledging of alarms, editing of limit values,
and logins.
List of displayed columns can be configured, and the list can be filtered using different
criteria. The configuration of the list can be readymade for operators. Events can be
commented. When an event is double clicked or the Comment... option is selected from
a context menu, a comment dialog appears. Each event can contain one comment.
Chapters Section 9.1 Attributes, Section 9.3 General Settings, Section 9.4 Layout Settings,
Section 9.5 Locate Object, and Section 9.6 Filters and Preconfigurations are applicable
to Event Displays, Alarm Displays and Blocking Displays.
9.1 Attributes
Almost all attributes can be subscribed to the list. However, there are a few exceptions.
Attributes that cannot be subscribed to the list are described in Table 9.1.
Table 9.1: Attributes which cannot be subscribed to the list
Attribute Description
CN Connected Network Objects
ND Network Topology Data
NF Network Feeds
NO Network Object Connection
RO Referenced Objects
275
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
The content of the attributes are described in the SYS600 Application Objects manual.
There are, however, some additional attributes. Attributes that are common to all lists
are described in Table 9.2.
Table 9.2: Common list specific attributes
Attribute Description
OI1-OI5 OI1 The 1st level of Object Identifier (OI) attrib-
ute
OI2 The 2nd level of Object Identifier (OI) attribute
OI3 The 3rd level of Object Identifier (OI) attribute
OI4 The 4th level of Object Identifier (OI) attribute
OI5 The 5th level of Object Identifier (OI) attribute
SX Translated text (TX) is used instead of SX
Time attributes For all time attributes, the millisecond part of the
time is automatically appended.
276
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
If DMS 600 software is installed, it is also possible to locate objects in DMS 600. In this
case, a Locate object in DMS function is available in the context menu. Locate functions
can be disabled from the Settings dialog.
277
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
The configuration is done by using the PV (Process Views) attribute of the Process
Object.
• In Object Navigator, right-click the Process Object and select Group Properties.
• Select the Process Views (PV) tab and click New.
• Select the Process Display(s) to be added to Process Views.
It is possible to add several Process Views. In such cases, an Option dialog is shown in
Monitor Pro for selecting the appropriate Process Display.
@LN=argument(1)
@IX=argument(2)
@IL=’LN’:PIL’IX’
#return %IL.STA
If the GET_DISPLAY_NAME.TXT procedure file does not exist or its execution fails,
the function reads the PI attribute value of the object that produces the alarm or event.
The PI attribute value contains a display name without the file extension.
278
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Filters can be created using an OI based filtering condition, signal function, alarm class
and custom SCIL condition. Complex conditions can be added as custom SCIL conditions.
For example, condition (AC == 2 AND OI==”Eastwick*”) OR ((AC == 1 or AC == 2)
and OI==”Rivers*”) fetches all events from Eastwick station with Alarm Class (AC) 2,
and all events from Rivers station with Alarm Class (AC) 1 or 2.
It is possible to save filter conditions as a preconfiguration. Start creating a
preconfiguration by creating a filter. Then, select Filter Settings > Preconfigurations....
Enter a name for preconfiguration and click the Save button.
Preconfigurations can be either user specific or application specific. Application specific
preconfigurations can be used by all users, and user specific preconfigurations can be
used only by the user who has created it. The engineer can create readymade lists for
operators using preconfigurations. It is possible to configure the used credentials so that
operators do not have permission to enter a filter, but only select one from the readymade
preconfigurations.
279
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
9.8 Blockings
The list provides a quick access for controlling signal blockings. For signals, there is a
context menu item for opening the Signal blocking state dialog. With the dialog, the user
can control the blockings of the selected signal.
The blockings dialog can be disabled from the lists’ General settings.
280
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
10 Alarm Display
This chapter describes the technical aspects of the Alarm Display. For more information
on the usage of the display, see the SYS600 Operation Manual.
SYS600 Alarm Display displays a summary of the present alarm situation of the
supervised process. There are two Alarm Display templates, and both templates share
the same settings and preconfigurations. Template 1 contains separate lists for persisting
alarms and fleeting alarms. Persisting alarms are alarms that are in active and
unacknowledged state. Fleeting alarms are alarms that are in inactive and unacknowledged
state. Template 2 contains one list for all alarms. An example of Alarm Display template
1 is shown in Figure 10.1.
One signal can have only one alarm. If a new alarm is created for a signal with an existing
alarm, the new alarm overrides the earlier alarm.
Lists allow the user with adequate authorization level to acknowledge alarms. The user
can acknowledge either all alarms, a single alarm, all visible alarms or selected alarms.
Most of the process object attributes can be added to the list. There is also an alarm list
specific attribute STATUS, which contains a textual explanation of the alarming state.
Both alarm list templates support coloring, filtering, preconfigurations and signal blocking.
These features are explained in sections from Section 9.6 Filters and Preconfigurations
to Section 9.8 Blockings.
281
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Authorization groups used in Alarm Displays are described in Table 10.1. If authorization
level for a specific authorization group is not defined for the user, the authorization level
of authorization group GENERAL is used. For more information about authorization,
see Chapter 22 Authorization.
Table 10.1: Authorization groups related to Alarm Display
Authorization Group Level Enabled Action
ALARM_HANDLING >= 1, Control Acknowledge alarm
PRO_ALARMS_CUSTOMIZE >= 2, Engineering Change Application level set-
tings in alarm list
Modify preconfigurations
BLOCKING_HANDLING >= 1, Control Change blocking states
282
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
11 Blocking Display
This chapter describes the technical aspects of the Blocking Display. For more information
on the usage of the display, see the SYS600 Operation Manual.
SYS600 Blocking Display displays a summary of the present signal blocking situation
of the supervised process. The Blocking Display is used for viewing and controlling
signal blockings. The list can contain either signals with blockings or all signals. Signals
can be filtered. Blocking columns are editable. If the user has adequate authorization,
the user can either block or deblock signals. An example of a Blocking Display is shown
in Figure 11.1.
With default settings, an event is generated when a blocking attribute is changed. This
can be changed with a configuration option.
The Blocking Display supports coloring, filtering, preconfigurations and signal blocking.
These features are explained in sections from Section 9.6 Filters and Preconfigurations
to Section 9.8 Blockings.
Authorization groups used in the Blocking Display are described in Table 11.1. If
authorization level for a specific authorization group is not defined for the user, the
authorization level of authorization group GENERAL is used. For more information
about authorization, see Chapter 22 Authorization .
283
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
284
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
This chapter describes the technical aspects of the User Activity Log Display. For more
information on the usage of the display, see the SYS600 Operation Manual.
SYS600 User Activity Log Display displays important user activated events for later
analysis. The User Activity Log Display is a read only list.
The User Account Log Display supports coloring, filtering and preconfigurations. These
features are explained in sections from Section 9.6 Filters and Preconfigurations to
Section 9.8 Blockings.
Authorization groups used in the User Account Log Display are described in table below.
For more information about authorization, see Chapter 22 Authorization.
Table 12.1: Authorization groups related to User Account Log Display
Authorization Group Level Enabled Action
GENERAL 5, System Management View User Account Log Display
285
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
13 Trends Display
Trends Display is used for trend analyses, as well as for showing measured values in
curve or table form.
A trend is a time related follow-up of process data. All types of process objects, such as
in and out data or binary, analogue and digital data can be illustrated as trends.
287
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
The following is an example of trends coloring in an application, and the steps of how
it has been defined in the Color dialog.
To modify the color settings in the Trends Display:
1. In the Trends Display, select Settings > Display Settings > Graph Settings... or
select > Graph Settings... on the toolbar. The dialog opens, see Figure 13.2.
2. Select Common settings > and check the Use Color Schemecheck box if the color
from the current active Color Scheme should be used.
3. Click Change.
4. In the Color Setting Tool dialog, select Graphical View in the Category list.
5. Click the color field for any of the available colors.
6. Specify the color values in the Color dialog and click OK.
7. In the Category list, select Tabular View and change the colors in the same way.
8. Edit the settings on the Axis properties and Curve Properties tabs if necessary.
Click OK to save the changes.
The color used for the gridlines in the Trends Display can be configured in the following
way:
1. In the Trends Display, select Settings > Display Settings > Graph Settings... or
select > Graph Settings... on the toolbar. The dialog opens, see Figure 13.2.
288
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
2. Click Change in the Grid properties to change the gridline color. The Color Settings
Tool opens, see Figure 13.3.
289
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
3. Click the color box next to the Gridline. The Color dialog opens, seeFigure 13.4.
290
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
4. Select the color and click OK. The Color dialog closes and the selected color can
be seen in the Gridline color box.
The number and maximum length of the data logs used in the Trends Display are
application specific parameters. Their effect on the system performance should always
291
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
be measured by using the actual hardware. Too large values of these parameters may
cause poor system performance.
After changing one of the parameters, restart the Trends Display and delete the existing
data logs. After this, the changes take effect.
Trends Display uses data objects named FTU_TRD*, where * means 1 to the maximum
number of trends. The default maximum trend number is 20 (NUMBER_OF_DATALOGS
parameter of the bgu_ta_setup.txt file).
292
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
14 Measurement Reports
Measurement Reports is used for various types of time related reports, such as hourly,
daily, weekly, monthly and yearly reports.
Measurement Reports can be used for reporting:
• Energy (active, reactive)
• Current (for example bay level)
• Voltage (for example bay level)
• Frequency
• Temperature
• Other measured data
Generally, the reports are time related followups of process data, metered data, or
calculated data. The data can be illustrated as reports in tabular or graphical form. The
data for the reports is calculated and stored in real time. Report data is collected and
calculated cyclically. The most common method is to collect raw data from the process,
refine it and store it in the report database.
The collection and calculation of report data can be initiated in the following ways:
• At predefined time intervals
• As a result of a spontaneous event
• As a result of a calculation
• Based on a condition
• On the operator's request
293
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
294
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
If other than real process data needs to be collected, it can be done either on the user's
request via a project specific data entering tool, or as event or time driven request using
a Command Procedure. In both cases, the output must be written to a Process Object.
295
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
CURRENT
ACTIVE ENERGY
VOLTAGE
………
Sub level: Location and Report Base type
Station A: Day Report
Station B: Week Report
………
Main level: Location
REGION A
REGION B
Substation X
………
Sub level: Measurement type and Report Base type
DAY Report CURRENT
ENERGY WEEK Report
………
296
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
The engineering tools are available only for local applications. The Measurement Reports
branch will be hidden for external applications.
A valid license is needed for Measurement Reports for the user to be able to use/engineer
the Measurement Reports. Otherwise, the Measurement Reports node will be hidden.
All Report Object type data will be shown in a table. No other view option is available.
The tabular view will have a similar Look-and-Feel as the one used for other Application
Objects, and it is based on the view used for Process Objects.
If the Measurement Reports node is selected, some overall configurations can be made.
This configuration procedure has been moved here from Monitor Pro Application Settings
dialog.
297
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Period Settings
These period settings will be used as default settings for all new Report Objects.
If, for some Report Objects, different period settings are needed, they can be changed
on Report Object level.
Changes will be applied to all Report Objects that use these default settings.
Sampling Period
Cycle time *
Range: 1, 2, 3, 5, 6, 10, 15, 20, 30 minutes
Default: 3 minutes
Base Period
Cycle time (BP)*
Range: 10, 15, 30 or 60 minutes
298
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Execution delays
Ranges:
• 0–60 seconds for the sampling period, default value is 0 seconds
• 60–300 seconds for the base period, default value is 60 seconds
The execution delays can be defined both for base period cycle and for sampling period
cycle. The execution delays must be used when process objects are not spontaneous, and
the execution delays need an update command to be used before the current value is
available in the process database. After time channels are triggered, an execution delay
defines how long the program waits for before the evaluation of values starts.
When update commands are used, the commands are sent after the time channels are
triggered. The data logger program reads the value from the process database after the
execution delay.
The execution delay for sampled values must be less than both the delay for base period
values and the smallest used sampling period.
The execution delay for base period values must be less than the smallest used sampling
period.
299
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Call-back procedure
Three tables are available for Reports Objects: one for all Report Objects, one for
measured objects and one for calculated objects.
The table length (number of lines per page) and the column size auto-adjustment option
can be changed from the Object Navigator's Options menu.
300
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Data presentation
Modifications, e.g. add new, remove (delete) or edit, to any report object type in existing
object properties will not be immediately activated. All changes will be stored temporarily.
This temporary stored data will be kept until the user has decided to store it permanently
or explicitly undos the temporary changes. If, for any object, a temporary data set exists,
the corresponding item in the object data table will be highlighted by using a different
background color:
New Green
to be Delete Red
Modified Blue
Active not modified White
Each report object type contains a set of attributes, which can be removed or added to
the object table with the help of the User Defined attributes drop-down menu.
Sorting
Double-clicking a table column title will sort the table based on the selected column
data. The current sort order will be shown in the 5th field of the Status bar.
Page navigation
Page navigation works in a similar way as the other application objects in the Object
Navigator.
301
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Filter handling
With the filter dialog, the user can enter a condition to filter out certain objects.
All available object attributes can be used for the filter condition. Mixed logical filter
operations (and/or in one condition) are not allowed. It is not possible to enter any
condition freely.
For text value conditions, the leading and trailing quotes can be omitted.
Before activating the condition, the selected condition can be validated. In case the
condition is invalid, an information dialog will be shown with details about the condition
status.
Commands
The most common commands can be activated from the Toolbar, the Menu bar or with
keyboard shortcuts.
302
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Toolbar
Keyboard shortcuts
The following keyboard shortcuts can be used:
• Ctrl+N: New
• Ctrl+D: Delete
• Ctrl+A: Select All
• F5: Refresh
• Ctrl++: Add all user defined attributes
• Ctrl+-: Remove all user defined attributes
Context menu
The following functions are available from the object table context menu:
303
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
• Properties: Open the Object Property dialog for the selected object.
• New...: Open the new object name input dialog.
• Undo Selected Object(s): Undo all modifications for the selected object(s) that
have not been activated already.
• Undo Calculation Order change: Undo possible calculation order changes.
• Activate All: Activate all modifications for all modified objects.
• Activate Selected Object(s): Activate all modifications for selected modified objects.
• Activate Calculation Order: Activate possible calculation order changes.
• Add all User-Defined Attributes: Add all user-defined attributes to the object table.
• Remove all User-Defined Attributes: Remove all user-defined attributes from the
object table.
In case the current attribute value is invalid, the corresponding label will be colored red.
In the example above, the sampling period cycle has a larger value than the base period
value, which causes the invalidation. For SCIL instruction type attributes, the code will
be validated on update request. Invalid SCIL instructions cannot be updated to the
corresponding attribute.
304
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Object modifications cannot be saved as long as any of the attributes has an invalid value.
The Object Property dialog containing invalid attribute values will be closed without
notification if the user clicks Cancel or presses the ESC key, navigates to another object
or fetches the current valid configuration data. In case valid modifications are detected,
a confirmation dialog will appear if the user attempts to navigate to another object or to
click the Cancel or Fetch button.
Commands
305
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Button Explanation
OK When the OK button is pressed, the Report Object modifications
are saved and the dialog is closed.
Cancel or the ESC key Pressing the Cancel button discards all changes and closes the
dialog.
Apply When the Apply button is pressed, the Report Object modifications
are saved and the dialog stays open.
Fetch The last saved configuration will be restored to the property dialog.
Add new
The new object name will be validated before the detailed configuration can be made.
If the new entered name is invalid, a notification dialog shows the name rule violation.
Modify existing
To modify existing object configuration, either double-click the corresponding line in
the object table or select the appropriate item in the menu or toolbar.
306
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Delete new: New, not yet activated objects will be immediately and permanent removed
from the configuration database. No undo function is available.
Delete active: Object configuration will be marked as to be deleted in the configuration
database. Final deletion will be done with the activation command.
Activation
Based on the selection in the object table, modified or new objects can be activated. The
activation can be selected from the context menu.
Undo
Undo actions will be applied immediately, and no confirmation dialog will appear. The
Undo function is only available for modified selected objects.
Table 14.2: UnDo actions
State (CS) Action
New (N) Same as Delete New Objects but without confirmation.
Deleted (D) The tag to delete the object will be removed. If the object data has been modified
before it has been tagged as to be deleted, the modified configuration will be re-
stored.
Modified (M) All modifications will be removed. The original active configuration data will be
restored.
Each Report Object owns a set of attributes. These attributes describe the functionality
for every object within the Reports Objects as there are, beside others:
• Which process data should be logged for the reports: Process Object connection
• How often should the process data be sampled: Sampling Period SP
• How often should the sampled data be calculated: Base Period BP
• How long should the sampled data and the calculated data be hold: History Length
for sampling and base period SP_HL and BP_HL
• What type of calculation should be performed for the calculated (base period) values
based on the sampled data: Type ID
The maximum number of Report Objects is limited to 10 000.
307
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Report Object configuration tools are accessible from the Object Navigator object tree
as shown in Figure 14.19.
Attributes
Table 14.3: Attributes for measured Report Objects
Description Attribute m/o Type Range Remarks
Configuration State CS m Text M, N, D M=Modified, N=New, Deleted, empty =
Active
Logical name LN m Text 1..59 characters
Report Object Type ID m Text MS, MN, MX, MM Measured:
MS = sum calculated
MN = min calculated
MX = max calculated
MM = mean calculated
MP = period value
Comment CM o Text 0..240 characters 'P_LN':POX'P_IX' from connected Process
Object will be used.
Unit ST o Text 0..255 characters 'P_LN':PST'P_IX' from connected Process
Object will be used.
Sampling Period SP o Integer 1, 2, 3, 5, 6, 10, Minutes, shown as seconds in the object
15, 20, 30 table.
Sampling Period history length SP_HL o Integer 0..365 Days
Base Period BP o Integer 10, 15, 30, 60 Minutes, shown as seconds in the object
table.
Base Period history length BP_HL o Integer 0..5 years The current year plus the number of selec-
ted BP_HL years.
Forecast period FP o Integer 0..1 day
Application of Process Object P_APL o Integer 0..255 For performance reason, it is recommended
to connect Process Objects from the local
application only.
308
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Attributes marked with m (mandatory) are always visible. The other attributes are optional
and can be added and removed from the table with the selection box for user defined
attribute columns. Attributes marked with a minus (–) sign cannot be added to the table
at all, for example if the data type for that attribute is a vector of SCIL commands.
Status bar
If an object is selected, the details shown in the Status bar depend on the selected Report
Object type. Details can be found in the table below.
309
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Properties Dialog
The Properties dialog is designed to add new Report Objects, as well as modify or copy
existing (the Add button) Report Objects.
Report Objects marked as to be deleted cannot be modified. In that case, all attributes
are disabled.
The upper part of the Properties dialog is the same for all Report Object types. The lower
part contains the object type specific attributes separated in three tabs. This lower part
is invisible for new Report Objects as long the Report Object type (ID) has not been
selected.
310
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
311
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Figure 14.21: Period Settings tab in Properties dialog for Report Objects
In this tab, the value for the sampling and base (calculation) period can be selected. These
values can either be retrieved from the default application settings, or some object specific
setting can be applied.
Figure 14.22: Data Object tab in Properties dialog for Report Objects
In this tab, the Data Objects which store the sampled (sampling period) and the calculated
values (base period) can be selected, and the Data Object form can be loaded for all
existing Data Objects (the Show Data Object button).
Calculation tab
The properties dialog for calculated Report Objects has no Connected Object tab, but it
has a special Calculation tab for the calculation settings.
312
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Within this tab, the input Report Object names and the calculation instruction can be
added with the help of the Visual SCIL Program Editor.
The period settings for calculated objects cannot be changed. They will be automatically
set to the period settings attribute values from the entered input Report Objects.
The input Report Objects must use the same period settings in order to be validated.
313
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Examples:
;Single line operation for one input Report Object
%OBJ + 100
Calculation order
The two Calculation order lists for sampled and base period values show the current
order of all existing calculated objects. The lists can also be used to change the order of
the current selected object.
1. Calculation order modified, shown in the Status bar if the calculated Report Object
is selected in the object table.
2. New not activated calculated Report Object.
3. Calculated Report Object marked as to be deleted.
The changed calculation order can be activated or removed (Undo) with the help of the
Object table context menu:
• Undo Calculation Order change
Used to undo possible changes in the calculation order.
• Activate Calculation Order change
used to activate possible changes in the calculation order.
314
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
315
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
316
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Attributes
Table 14.7: Attributes for Report Displays
Description Attribute m/o Type Range Remarks
Configuration State CS m Text M, N, D
Display Id LN m Text FIXED
Report Base RB m Text HOUR, DAY_10, DAY_15,
DAY_30, DAY_60, WEEK,
MONTH, YEAR
Report Type RT m Text Pre-defined types for all report Used for Monitor Pro/Naviga-
base types: tion/Measurement Reports/ menu
• Active Energy
• Reactive Energy
• Active Power
• Reactive Power
• Current
• Voltage
• Temperature
• User defined
Display Header DH m Text 0..100 character Used for Monitor Pro naviga-
tion/Measurement Reports/Report
type/sub menu
Comment CM o Text 0..255 characters
Unit ST o Text 0..10
Scale SC o Real -1,000 .. 1,000
Interval TI o Integer 1, 2, 3, 5, 6, 10, 15, 30 Minutes, only available for Report
Base = HOUR
Summary Information SU1..4 o Text SUM, MIN, MAX, MEAN, NONE, SU 1..3: RB = HOUR, WEEK
In-Day periods if defined in Calen- SU 1..4: RB = DAY_xx
dar Tool SU 1: RB = MONTH and YEAR
Page Configuration PC o Text Link to Page configuration
Authorization Group AG o Text REPORTS, GENERAL, other
Forecast area enabled FC o Boolean True or false
Attributes marked with m (mandatory) are always visible. The others are optional and
can be added and removed from the table with the selection box for user-defined attribute
columns.
Statusbar
Table 14.8: Statusbar for Report Displays
Selection / Attribute
Base Type
Field 1 Field 2 Field 3 Field 4 Field 5
No object se- Number of ob- Total number Sorting order
lected jects in current of objects
view
317
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Selection / Attribute
Base Type
Field 1 Field 2 Field 3 Field 4 Field 5
All ST SC SP BP Sorting order
Properties Dialog
The properties dialog is designed to add new, modify or copy (Add button) existing
Report Display configurations.
The properties dialog replaces the Standard Function installation and configuration tool
for Measurement Reports.
Report Displays marked as to delete cannot be modified. In this case all attributes are
disabled.
Type tab
1. Connect to a existing Page Configuration using the Application Object selector tool
2. Open the property dialog for the current selected Page Configuration
The values for Report Type and the Display Header attribute are used to construct the
Monitor Pro Measurement Report navigation menu. Text succeeding a comma in the
Report Type attribute will not be shown in the menu and can be used as additional
information.
318
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Figure 14.28: Relation Report Display attributes and Monitor Pro Navigation menu
Using numerical character’s as pre-fix for both menu parts helps to get the menu
constructed in a desired order.
Figure 14.29: Summary Information tab in Properties dialog for Report Displays
The time range used for the Day, Night or other In-Day periods can be defined in help
of the Calendar Tool.
319
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Other tab
320
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Each Report Page configuration can be used for all Report Display base types.
It is not necessary to create different Page configurations for, e.g. HOUR and DAY based
Report Displays, if the same Report data should be presented.
Attributes
Table 14.10: Attributes for Report Pages
Description Attribute m/o Type Range Remarks
Configuration CS m Text M, N, D M=Modified, N=New, Deleted, empty
State = Active
Page Id LN m Text
Comment CM m Text
Number of pages NP m Integer
Page data List
321
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Status bar
If a configuration is selected, the shown details depend on the selected Report Page type.
Details can be found in the table below.
Table 14.13: Status bar for Report Pages
Selection Attribute
Field 1 Field 2 Field 3 Field 4 Field 5
No object se- Number of ob- Total number Sorting order
lected jects in current of objects
view
All LN CM Sorting order
Properties Dialog
The properties dialog is designed to create new Report Page configurations, or modify
or copy (Add) the existing Report Page configurations.
322
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
for the selected page. This can be usefull for a copied page to replace e.g. the bay
designation.
3. Using the numeric spinner up button will add a new column. The down button
removes the last column.
4. Edit the column properties for each report object. Double-click with the left mouse
button will activate the cell data edit handler.
5. Buttons to change the position of the selected column.
Column Data
Below the corresponding column data input functions are described more detailed.
Column Title
Object name(s)
The Report Object names which should be added to the selected column can be freely
selected using the standard selection methods. If more than one Report Object has been
323
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
added some operation must be specified. If no operation is defined the summary of all
selected objects will be used as default calculation.
Operation
324
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
In help of this tab the position for the selected page can be changed.
325
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
326
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Five pre-defined conditions are available for the following measurement types:
1. Current
2. Voltage
3. Active Power
4. Energy
5. Temperature
It is recommended to handle different types of measurements in separate steps, for
example to create all Report Objects for current measurement first, then energy
measurements etc.
The input list will be refreshed automatically with every user condition change.
To include only some of the found Process Objects from the input list for Report Object
generation, the Process Objects must be selected. If no Process Object from the input
list is selected, all will be included in the Report Object generation.
327
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
328
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
329
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
330
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
The table shows the main attributes from input Process Objects, the applied rule, the
constructed Report Object LN and the build progress state for every object.
Table 14.16: Build progress state details
State Details Remarks
Included Ready to create
Ready to modify Report Object already exist and the overwrite option is enabled.
Excluded No group/rule enabled This measurement Process Object is excluded because either the
corresponding group or the measurement item rule has been dis-
abled.
The applied rule has no Report Object type Select a Report Object in the Build rules tab for the measurement.
(ID) defined
Duplicate Report Object LN found Use the Type ID as appendix for the Report Object LN construction
to avoid this duplication detection.
Report Object LN already exists Report Object already exist and the overwrite option is disabled.
Report Object LN to long The limit of 59 character length for the Report Object LN has been
reached. Most likely, the P_OI_P_OX attribute combination is selected
for the Report Object LN construction.
Max Report Object count reached The limit of 10 000 Report Objects has been reached.
331
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
332
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Below is a description of the sequential execution of the two main tasks for the sampling
and base period.
Sampling Period
1. Collect all Report Object names that belong to this sampling period cycle.
2. Execute the update instructions, ReportObject.P_ACT = 1.
3. Execute sampling period after sampling period execution delay.
4. Calculate Data Object Index for the actual time.
5. Handle the measured Report Objects (Type ID = MS, MN, MM, MX and NOT MP):
a. Use the instruction attribute (IN) from the Data Object for the sampling period
to evaluate the sampled value.
b. Store the sampled value to the Data Object.
6. Handle the calculated Report Objects in defined sampling period calculation order:
a. Collect the stored sampled values for all input Report Objects from DATAIN
attribute.
b. Execute the calculation operation from OPER attribute.
c. Store the calculated value to the Data Object.
7. Execute the callback procedure for the sampling period.
Base period
1. Collect all Report Object names that belong to this base period cycle.
2. Execute the update instructions, ReportObject.P_ACT = 1 and Type ID = MP.
3. Base period execution after base period execution delay.
4. Calculate Data Object Index for the actual time.
5. Handle the measured Report Objects (Type ID = MS, MN, MM, MX and MP):
a. If Type ID = MP, store the actual input Process Object value to the Data Object
for the sampling period (one value only).
b. Type ID <> MP: collect all sampled values from the last expired base period
from the sampling period Data Object, e.g. for SP = 1 minute and BP = 15
minutes 15 sampled values to collect.
c. Based on Type ID, calculate the base period value from the collected sampled
values, Type ID =
MS: calculate the sum value from the collected sampled values.
MX: calculate the maximum value from the collected sampled values.
MN: calculate the minimum value from the collected sampled values.
MM: calculate the mean value from the collected sampled values.
MP: collect the value from the Data Object for sampling period.
d. Store the calculated value to the Data Object for the base period.
6. Handle the calculated Report Objects in defined base period calculation order:
a. Collect the stored base period values for all input Report Objects from DATAIN
attribute.
b. Execute the calculation operation from OPER attribute.
c. Store the calculated value to the Data Object.
333
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Data provider
The Report data to be shown in Monitor Pro Report displays will be provided by the
SAGR_REPORTS_* command procedures.
User actions, such as edit values or add a comment, are also handled by the data provider.
All edit actions will be logged to the following file:
Reports/bmu_edit.log
All comments will be stored in separate files for every Report Display:
Reports/‘Report Display LN’.mno
334
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
If the classic LIB510 Measurement Reports still needs to be used, no upgrade action
should be performed.
The upgrade for LIB510 based Measurement Reports needs to be done in two steps.
Step 1
DAT export tool selection from the Tool Manager.
335
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Figure 14.41: Dat Export tool for LIB510 Measurement Report upgrade
The Configuration Data Export tool locates the report configuration of the picture
functions from the SCIL picture. The tool transfers the separated information to
Measurement Reports related configuration files.
Step 2
See Section 14.8.2 Upgrade from MicroSCADA Pro 9.x based Measurement Reports.
The upgrade forthe Measurement Report build with SYS600 MicroSCADA PRO version
will not be performed automatically.
The Report Object types EN (Entered data), GA (Gauge meter) are not supported anymore.
They will be automatically converted to MP (Measured Period) type. Also user defined
groups are not supported anymore.
The upgrade is as the other Reports engineering tool integrated in the Object Navigator.
An upgrade information message appears on the Measurement Reports node selection
of the Object tree.
336
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
337
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
14.9 Localization
All tool and dialog items, notification messages and object attribute texts can be translated
using the Text Translation Tool.
1. Measurement Reports Visual SCIL tools integrated in Object Navigator can be found
in the <MicroSCADA installation drive>:\sc\sTool\apl_build directory. The file
name for all this tools start with OBJMR.
2. The Language text database <MicroSCADA installation
drive>:\sc\Stool\AplBuild\OBJMR_LANG.SDB contains the Report Object, Report
Display and Report Page attribute titles, help text and descriptions.
338
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
15 Group alarm
The group alarm function can be used to summarize the alarm state of alarm points that
can be freely selected. Groups can be defined, for example, for alarms from a specific
location or alarms with the same functional background.
Group alarms can be further summarized and included as inputs to other groups of alarms
in a tree structure. The group alarm state can be used to create an alarm overview display.
339
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
The group alarm database is a copy of a template. The database is copied when the Group
Alarm Editor is used for the first time.
The template database is located in sc\sa_lib\defaults\Group_Alarm, and the template
database file name is bgu_grpal.sdb.
340
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
The group alarm database is located in sc\'application name'/apl_ and the database file
name is apl_grpal.sdb.
The group alarm database contains three types of sections:
1. The group alarm structure.
2. The group member attributes.
3. The group alarm processing settings.
The section names in the group alarm structure always start with A000-A999. Each
section contains the following attributes:
1. Name
The name is used as an object text for the group state Process Object. The name can
be changed in the Group Alarm Editor.
2. Array of member names
The attributes contain the names of all group members.
Attribute sections are used for the group members. Every process object acting as a
member of an existing group gets its own section. The section name uses the group
member logical name and the index.
Each section contains the following attributes:
1. LN: The logical name for the process object.
2. IX: The index for the process object.
3. PATH: Describes the location of the process object within the group alarm structure.
The PATH variable is used to quickly locate the alarming object within the group
structure and to calculate the new group alarm state.
341
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
342
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
343
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
The following commands are available in the toolbar to manage the group alarm database:
1.
: New Alarm
2.
: New Group
3.
: Delete Group
4.
: Edit Group name
The commands can also be selected by right-clicking the structure and selecting them
from the context menu:
New groups can be added anywhere in the existing structure. Click or select New
Group from the context menu. Enter the group name into the Input Dialog.
There are no restrictions for the group name, except that the group names must be unique
within a group branch.
Existing group names can be edited at any time. Renaming the groups does not affect
the group alarm processing routine.
344
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Alarm signals or groups can be deleted at any time. Deleting group objects also removes
the linked group state process object.
Before deleting an alarm group, a confirmation dialog is displayed.
345
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
It is possible to hide process objects by adding a filter through the Filter dialog.
346
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Process object groups starting with BGU_A should be removed from the process object
browser. These names are reserved for group alarm state objects. Also, Process Objects
with Alarm Class equal to 0 cannot be assigned to a group.
When new alarm signals are added, the object browser can stay open. It is possible to
select different groups in the group structure. New alarms are always added to the selected
group.
The appearance of the properties page depends on the selected object type.
Figure 15.10: The Properties view for the group alarm member object
347
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Figure 15.11: The Properties view for the group alarm state object
The Alarms page presents the state of all connected alarm signals for the selected group.
As a default, the attributes OI, OX and the alarm state are shown in the Alarms view.
The symbol for the alarm state for each signal can be seen in the first column. Additional
attributes can be added by using the + and - buttons and by selecting the attribute from
the list.
The - button removes the last column. Befault columns cannot be removed.
348
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
The Viewer mode is started by supplying a list as a custom argument in Monitor Pro
with an attribute called LN. This must be the Logical Name for the group state Process
Object, e.g.:
LIST(LN="BGU_A000")
The Viewer mode can be opened from Monitor Pro in two ways:
349
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
The Group Alarm Viewer can also be launched by using the Display Builder Tool
Launcher feature for any element in the display.
350
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
To install the symbol, the group state process object must be selected with the Display
Builder Object Browser.
The data variable Name is mapped to the object text (OX) attribute during symbol
installation and used as a label in the symbol.
351
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
15.8 Localization
The Group Alarm Editor dialog items and notification messages can be translated with
the Translation Tool. To access the Translation Tool, select Text Tool in the User Interface
tab of the Tool Manager.
The following table shows all group alarm function related files and their functionality.
Table 15.1: Group alarm function related files
File Functionality Path
BGU_GRP_AL.SDB Group alarm database tem- /SA_LIB/DE-
plate FAULTS/GROUP_ALARM
GaEdit.vso Group Alarm Editor /STOOL/APLBUILD
Group Alarm LED.sd Group alarm symbol /PROG/GRAPHICSEN-
GINE/PALETTE/01 - SA_Com-
mon
When the Group Alarm Editor is used for the first time, the following command
procedures are created.
Table 15.2: Group alarm function related command procedures
Name Functionality
SAGR_GA_MAIN Main Routine
SAGR_GA_APL_ALARM Connected to pre-defined event channel
APL_ALARM
SAGR_GA_APL_ALARM_ACK Connected to pre-defined event channel
APL_ALARM_ACK
SAGR_GA_APL_BLOCKING Connected to pre-defined event channel
APL_BLOCKING
SAGR_GA_CALCGROUPSTATE Calculation for the group alarm state
352
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
The following table shows the group alarm function related process object attributes.
Table 15.3: Process object attributes
Logical Name Index Obj. type Process Ob- Remarks Group
ject identifi-
er
BGU_A* 10 BI Group alarm Internal BAEAL-
name AXALA
* LN Convention:
LN[1..4] always BGU_
LN[5..8] A000..A999 for first level groups
LN[9..12] B000..B999 for second level groups
LN[13..16] C000..C999 for third level groups
LN[17..20] D000..D999 for fourth level groups
LN[21..24] E000..D999 for fifth level groups
353
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
355
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
When the Customize dialog is open, the main menu and context
menus can be displayed differently than at runtime. It is not
possible to select any menus during customization.
1Some menu commands (for example, the menu commands in the Process menu, or
items in application specific menus) and some toolbars (for example, the buttons in
application specific toolbars) are not customizable because they are generated
programmatically.
The tool context menu can be used for customization, see Figure 16.1. The tool context
menu can be displayed while the Customize dialog is open. It can be opened by
right-clicking the toolbar button. The styles for this tool are the following:
• Default Style: includes both the text and icon, if available.
• Text Only: only the text (caption of the tool) is shown.
• Image Only: only the icon is displayed, if available.
• Image and Text: includes both the text and icon, if available.
356
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
When the Customize dialog is open, toolbar buttons and menu commands can be moved
around. Create a copy of the tool by pressing down the CTRL key while moving the
tool.
If the user is allowed to customize the toolbar, a More tools button is displayed, see
Figure 16.2. This quick customization context menu allows the user to show or hide tools
357
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
from the toolbar without opening the Customize dialog. However, menu commands must
be customized by using the Customize dialog.
When the created toolbar is selected, the Rename and Delete buttons become active and
the user can rename or delete the toolbar. By clicking Revert in the Toolbars tab, the
last saved layout can be loaded. By clicking Keyboard in the Toolbars tab, a new dialog
is displayed, see Figure 16.4.
358
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
In the Categories section, a new keyboard shortcut can be added to the menu commands
and toolbars. The Categories list contains:
• Built-in Menus: all top-level menus
• Start with characters mi: all menus that have sub menu commands
• Start with characters tb: all toolbars (except user defined toolbars, i.e. menus created
by using the Customize dialog)
The Commands list contains:
• Sub menu commands and buttons of a selected category
To give a new value for a tool (menu command or button in the toolbar), do the following:
1. In the Categories list, select the category in which the menu command or toolbar
buttons are located.
2. In the Commands list, select the tool (menu command or toolbar buttons).
3. Type the new shortcut key combination in the text box Press new shortcut key.
4. Click Assign and the shortcut key appears in the Current keys field.
With Remove..., the selected shortcut key in Current keys section can be removed. Reset
the shortcut keys by clicking Reset All.
The user can configure the visibility of the toolbars and menus. Toolbar visibility and
position are display specific: if, for example, the alarm row is moved to a certain position
in Process Display, it will not affect the alarm row position in Event Display. For toolbar
customization, use either the Customize dialog's Toolbars tab, or right-click the toolbar
area and select or deselect toolbars. The user has access to different toolbars according
to the display used. Table 16.1 lists the toolbars visible by default in each display.
359
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
360
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Display Toolbars
Measurement Reports Alarm Row
- Graphical View Measurement Reports Display
Measurement Reports Graphical View
Navigate
Process Displays
Zoom
Main
Menu Bar
- Tabular View Alarm Row
Measurement Reports Display
Measurement Reports Tabular View
Navigate
Process Displays
Main
Menu Bar
Toolbar visibility is Display specific. For Process Display, Alarm Display, Event Display,
Blocking Display, Trends Display and full screen mode, there are different configurations
on which toolbars are shown. Change the visibility of the toolbar in a view by selecting
the view and changing the visibility of toolbars. The configuration is automatically saved
when some other view is selected.
361
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
362
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
The Categories and Commands functions are the same as in assigning new keyboard
shortcut keys, as described in Section 16.3.1 Toolbars tab.The tools can be moved around
as described in the beginning of Section 16.3 Customize dialog. When the Modify
Selection button is clicked, a same kind of context menu appears as when a toolbar
button or menu command is right-clicked while the Customize dialog is open. The Modify
Selection button becomes active when a tool is selected either from the menu or from
the toolbar.
363
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
The user can take the personalized menus into use via the Options tab. Only the most
recently used menus are visible.
The data of menu usage is saved when the application is exited, and loaded again when
the application is restarted (or the user logs into some application and user specific layout
loading actions are done). Also, logging into the application loads the menu usage data
in addition to the user specific layout file. Correspondingly, when logging out, the menu
usage data is saved in addition to the user specific layout file.
In the Options tab, the user can select to use menu animations and the size of icons
(Small, Medium or Large). The menu usage data can be deleted by clicking the Reset
usage data button.
364
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
365
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
6. Define a function for the menu. For more information about menu functions, see
Section 16.14 Custom commands in Monitor Pro.
366
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Submenus can be created in the same way as a new menu, see Section 16.5.1 Creating
a new menu. When the new menu has been created, select the menu item with the mouse
and drag it to the menu where it is required, see Figure 16.9.
367
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
368
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
369
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
5. Right-click a new toolbar and select Name to rename the toolbar with a descriptive
name.
6. Define a function for the toolbar. For more information about menu functions, see
Section 16.18 Resetting icons.
370
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Add a menu command by dragging it from the Commands tab to the new menu, see
Figure 16.16. The new menu command acts as the original menu command.
Move a menu command by dragging it from the existing menu to the new menu, see
Figure 16.17. A new menu command acts as the original menu command.
371
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
372
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
The menu structure is similar to the Windows Start menu. The menu commands are
organized as folders and files in the file system. Therefore, no special tool is needed to
configure the menu. The configuration is done by organizing the files, such as programs,
documents or shortcuts and the directories in a file system.
A menu command can be, for example:
• a file
• a folder containing submenu commands
• a link
• a shortcut to a file
• a shortcut to a directory
• an Internet hyperlink
Object types and instances have separate directories, where files, such as technical
documentation, Internet shortcuts or control commands (SCIL or VB scripts) exist. There
is also a folder for the common menu commands. Table 16.7 shows the parameters that
can be defined with a BAT, COM, SCIL, VBS or VSO file.
373
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Language support
The menu commands have a national language support (NLS). Changing the language
of the application window in run time affects the menu commands. However, this is not
the case with the files, because the file name determines the name of the menu command.
Thus, for each culture (country or language), there should be a folder where language
specific files are located. Language specific menus can be built in these directories.
Use two-letter language codes when generating a menu structure. For more information
about language codes, see http://www.w3.org/WAI/ER/IG/ert/iso639.htm.
374
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
When an object is right-clicked in Display Builder, three menu items are available for
configuring context menus for objects. These items are:
• Edit runtime menu for object
• Edit runtime menu for object type
• Edit runtime menu for all objects
To edit the runtime menu for the current display, select Actions > Edit runtime menu
for current display....
In this dialog, the user can configure context menus. There are three different dialogs:
• In the Menu for object dialog, a context menu for this individual object can be
defined.
• In the Menu for object type dialog, a context menu for this object type can be defined.
Object type can be e.g. Breaker, Disconnector etc.
• In the Menu for all objects dialog, a context menu can be defined that is applied to
all objects.
The user can define the context menus only for SA objects,
i.e. objects that are displayed on sheets SA_* in Palette.
375
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
The object must have a name before the user can define a
runtime menu for it. The object name must contain only
characters that are valid in directory name. If the user gives a
name that contains characters that are invalid for directory
name, the following error message is displayed:
MENUS directory
The MENUS directory consists of directories such as all, objecttypes and instances.
• Menu commands, which are to be shown on each context menu, should be stored
under the directory all.
• The directory objecttypes consists of all object types that a station overview can
have. Menu commands that each object type can have are also located here.
• It is also possible that an instance of a breaker might have some menu commands
that are instance specific, such as a figure of a breaker, online video stream,
maintenance log or a web link to the manufacturer's home page. In that case, the
menu commands are located in \<unique object id>.
• The menu for all objects are located in <apl>\MENUS\all.
16.7.2 Troubleshooting
376
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
377
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
For more information about the national language support (NLS), see Language support,
on page 374. For more information about the icons, see Title, icon, and command, on
page 374.
Common files for the process are located in [Appl path]\PICT\COMMON_MENU\. The
files are displayed before the command separator in the Process menu.
Process Display specific files are separate files. For example, Process Display specific
files for Example.v are in [Example]\MENU\, where the [Example] folder is the name
of the Process Display file without the suffix v. The picture specific files are displayed
after the command separator in Process Menu.
It is possible to make more specific configurations to the dialog in the Monitor Pro -
Customize Search dialog. The configurations are global, i.e. they affect all users.
378
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Configuring requires system administrator user rights. With the correct authorization,
the Configure... button in the Search dialog is enabled.
To configure the Process Display search:
1.
Open the Monitor Pro - Search dialog by clicking the icon on the Process Display
toolbar.
The Search dialog opens.
2. Click the Configure... button, see Figure 16.22.
The Monitor Pro - Customize Search dialog opens.
3. Set the configuration in the Customize Search dialog, see Figure 16.22. The following
options are available:
• Remember dialog placement (session specific): When this box is checked,
Monitor Pro opens the dialog in the same location during the whole session
until logout.
• Zoom level default value: Defines the zoom level used when the located object
is selected from the result row and viewed in the Process Display.
• Result with coordinates: Checking this box makes the coordinates of the object
visible on the Search dialog result row.
• Result with OPC Item ID: Checking this box makes the OPC Item ID visible
on the result row.
• Auto-select result row: When this box checked and one of the First/Last radio
buttons is selected, either the first or last result row is automatically selected in
the Search dialog results. The Zoom automatically box can also be checked
to make Monitor Pro automatically zoom on the selected result.
4. Click OK to take the configurations into use.
379
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
VSO dialog can be made modal by selecting the Modal option in VSO Dialog Editor.
Modal dialog means that it is not possible to make any actions in Monitor Pro main
window before the modal dialog is closed. Note that there are some limitations in support
of modal VSO dialogs in Monitor Pro:
• If non-modal VSO dialog opens modal sub-dialog, other non-modal VSO dialogs
that are open are not blocked. For example, when Tool Manager is open and another
VSO dialog opens a modal sub-dialog, Tool Manager is not blocked.
• Setting a dialog to modal programmatically with SCIL is not supported.
380
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
The following list describes optional functions that can be defined in the Visual SCIL
dialog for getting data from Monitor Pro to the custom Visual SCIL dialog. Define these
methods as public methods in the Visual SCIL dialog. See Figure 16.25.
381
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
When opening the Visual SCIL dialog, methods are called in the following order:
1. INIT method of the dialog
2. GetAuthorizationGroup
3. SetAuthorizationLevel
4. SetDialogPosition
5. SetCustomData
6. SetDisplayInfo
7. SetIconInfo
8. SetFontInfo
9. SetColorsInfo
GetAuthorizationGroup
The GetAuthorizationGroup method is called by the underlying root object to get the
authorization group from the VSO dialog. It will be applied when finding out the
authorization level for the dialog. The method must return SCIL data type TEXT that
defines the authorization group. For example, if the dialog should follow the MY_TOOLS
authorization group, the implementation of the function would be:
#RETURN "MY_TOOLS"
SetAuthorizationLevel
The SetAuthorizationLevel method is called by the underlying root object to indicate
the authorization level for the dialog. The function gets the authorization level as an
INTEGER argument. For example, if the authorization group returned by function
GetAuthorizationGroup is MY_TOOLS and the authorization level for this group in the
User Management tool of MicroSCADA is 1, this function gets INTEGER value 1 as
an argument. If the authorization group MY_TOOLS does not exist in the User
Management tool of MicroSCADA, the authorization level of the GENERAL
authorization group is passed as an argument into this function.
382
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
SetDialogPosition
SetDialogPosition method gets the following arguments that can be used when positioning
the Visual SCIL dialog:
Argument(1) = The upper left corner of Frame window, LIST(X=value, Y=value)
Argument(2) = Screen coordinates of a mouse-click , LIST(X=value, Y=value)
Argument(3) = Frame window dimensions, LIST(TOP=value, LEFT=value,
BOTTOM=value, RIGHT=value)
Argument(4) = Symbol dimensions, LIST(TOP=value, LEFT=value, BOTTOM=value,
RIGHT=value)
where, value=screen coordinate
Below is an example of the method SetDialogPosition, which places the dialog on the
right hand side of the symbol. If there is no room on the right hand side, the dialog is
shown on the left hand side.
#local l_CursorPos = LIST(x=0,y=0) ;Coordinates of mouse click
#local l_SymbolDimensions=LIST(Left=0,Right=0,Top=0,Bottom=0); Coordinates of
symbol
#local l_FrameWindowDimensions=LIST(Left=0,Right=0,Top=0,Bottom=0); Coordinates
on Monitor
#local l_MyGeometry = this._geometry, x = 0, y = 50, i_Xoffset = 20, i_Yoffset =
75
#local i_SymbolMiddleY, i_SymbolMiddleX, i_MonitorMiddleX, v_MonBSZ = MON:BSZ,
i_ScreenNumber = 1 ;MON:BSZ = Screen resolution
#if argument_count > 1 #then l_CursorPos = argument(2)
#if argument_count > 2 #then l_SymbolDimensions = argument(3)
#if argument_count > 3 #then l_FrameWindowDimensions = argument(4)
i_ScreenNumber = trunc(l_CursorPos.x / v_MonBSZ(1)) + 1
i_MonitorMiddleX = v_MonBSZ(1) / 2 + (i_ScreenNumber - 1) * v_MonBSZ(1)
i_SymbolMiddleX = l_SymbolDimensions.Left + ((l_SymbolDimensions.Right -
l_SymbolDimensions.Left) / 2)
i_SymbolMiddleY = l_SymbolDimensions.Top + ((l_SymbolDimensions.Bottom -
l_SymbolDimensions.Top) / 2)
;x coordinate
#if l_SymbolDimensions.Right + l_MyGeometry.w < l_FrameWindowDimensions.Right
#then #block
x = l_SymbolDimensions.Right + i_Xoffset
#if x + l_MyGeometry.w > v_MonBSZ(1) * i_ScreenNumber #then x =
l_SymbolDimensions.Left - l_MyGeometry.w - i_Xoffset
#block_end
#else #block
x = l_SymbolDimensions.Left - l_MyGeometry.w - i_Xoffset
#if x < 0 #then #block
#if l_CursorPos.x < i_MonitorMiddleX #then x = i_MonitorMiddleX + i_Xoffset
#else x = i_MonitorMiddleX - l_MyGeometry.w - i_Xoffset
#block_end
#block_end
;y coordinate
y = v_MonBSZ(2) - i_SymbolMiddleY - l_MyGeometry.h / 2
#if y < i_Yoffset #then y = i_Yoffset
383
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
SetCustomData
The argument for SetCustomData function can be defined in the Tool Launcher dialog
of the Display Builder, see Figure 16.26.
Figure 16.26: Custom data argument in Tool Launcher dialog of Display Builder
SetDisplayInfo
SetDisplayInfo method is called with argument type of list. This list contains various
kinds of data that can be useful in dialog design, for example OPCITEMID. See
Figure 16.27.
384
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
SendDisplayCommand
Use the SendDisplayCommand method for sending data to Monitor Pro. The method is
available in an underlying, invisible Visual SCIL dialog that handles communication
between Visual SCIL and Monitor Pro. This function is called in the parent object of the
user's dialog.
There is a certain set of commands that can be passed to Monitor Pro. These commands
are similar to those that can be passed to Monitor Pro as command line arguments.
385
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Examples
parent.SendDisplayCommand("test.v -ll:-1000,-1000 -ur:1000,1000")
parent.SendDisplayCommand("alarmlist_temp1 myPreconfiguration")
parent.SendDisplayCommand("LOCATE_OBJECT:OI=Rivers Barnes
Q1;LN=RIVH04_Q1;IX=10")
The available commands are listed in Table 16.3.
Table 16.3: SendDisplayCommand
Command Meaning
ALARML- Alarm Display to be opened in an appropriate template.
IST_TEMP1 Preconfigured name can be given as an additional argument.
ALARML-
IST_TEMP2
BLOCKING- Blocking Display to be opened.
LIST
EVENTLIST Event Display to be opened (event list).
Preconfiguration can be given as an additional argument.
RE- Reports Display, (graphical or tabular) to be opened with an appropriate type.
PORTS_GRAPH- Preconfiguration can be given as an additional argument.
ICAL
RE-
PORTS_TABU-
LAR
TRENDS_GRAPH- Trends Display to be opened with an appropriate type (graphical or tabular).
ICAL Preconfiguration can be given as an additional argument.
TRENDS_TAB-
ULAR
<display Process Display to be opened. Display argument may contain a path. Otherwise,
name>.v the file is searched from the PICT directory.
Process display can have the following additional arguments:
-ll:x1,y1 -ur:x2,y2
This means lower left (x1,y1) and upper right coordinates (x2,y2) of Process
Display area to be zoomed to.
An -ll and -ur argument can also be given without a process display name. In
this case, these arguments refer to the display itself.
Examples:
"test.v -ll:-1000,-1000 -ur:1000,1000"
"-ll:-1000,-1000 -ur:1000,1000"
LOCATE_OB- Locate object from opened Process Display.
JECTO
:=
I<O>
IL
;N=<LN>X
I;=<X
I > OI, LN and IX should be specified accordingly.
386
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
DisplayInfo
The DisplayInfo method is called by the underlying root object to notify the dialog about
activity that happens in the Monitor Pro window. The function gets data describing the
activity as a LIST argument. The argument LIST always contains three attributes:
MESSAGE (name of message), MESSAGE_DATA (message data contents) and MSG_ID
(identifier of the message). The function is called when:
Display changes (e.g. when user navigates to another process display)
Message name: DISPLAY_CHANGED
MESSAGE_DATA contents:
Attribute Meaning
DISPLAY_ARG Name of the display that was opened
DISPLAY_TYPE Type of display that was opened. The type can be one of following
values:
PROCESS_GRAPHICS
ALARMLIST_TEMP1
ALARMLIST_TEMP2
EVENTLIST
BLOCKINGLIST
TRENDS_GRAPHICAL
TRENDS_TABULAR
REPORTS_GRAPHICAL
REPORTS_TABULAR
Example:
LIST(MESSAGE="DISPLAY_CHANGED",-
MESSAGE_DATA=LIST(DISPLAY_ARG="C:\SC\APL\MYAPP\PICT\S1.v",-
DISPLAY_TYPE="PROCESS_GRAPHICS"),MSG_ID=1)
Monitor Pro window is moved or resized on the screen
Message name: WINDOW_CHANGED
MESSAGE_DATA contents:
Attribute Meaning
BOTTOMRIGHT_X X-coordinate of bottom right corner of window client area in screen
coordinates
BOTTOMRIGHT_Y Y-coordinate of bottom right corner of window client area in screen
coordinates
TOPLEFT_X X-coordinate of top left corner of window client area in screen
coordinates
TOPLEFT_Y Y-coordinate of top left corner of window client area in screen
coordinates
Example:
387
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
LIST(MESSAGE="WINDOW_CHANGED",MESSAGE_DATA=LIST(BOTTOMRIGHT_X=1302,-
BOTTOMRIGHT_Y=946,TOPLEFT_X=446,TOPLEFT_Y=258),MSG_ID=2)
Process display object is clicked
Message name: PD_OBJECT_CLICKED
MESSAGE_DATA contents:
Attribute Meaning
MOUSE_X X-coordinate where the mouse was clicked (in screen coordin-
ates)
MOUSE_Y Y-coordinate where the mouse was clicked (in screen coordin-
ates)
OBJECT_NAME Name of the object that was clicked
OBJECT_OPCITEM_ID OPC item ID of the object that was clicked
OBJECT_TYPE Object type
Example:
LIST(MESSAGE="PD_OBJECT_CLICKED",MESSAGE_DATA=LIST(MOUSE_X=717,MOUSE_Y=546,-
OBJECT_NAME="Node1",OBJECT_OPCITEM_ID="",OBJECT_TYPE="IED
Generic"),MSG_ID=5)
Process display dialog is opened
Message name: PD_DIALOG_OPENED
MESSAGE_DATA contents:
Attribute Meaning
MOUSE_X X-coordinate where the mouse was clicked (in screen coordin-
ates)
MOUSE_Y Y-coordinate where the mouse was clicked (in screen coordin-
ates)
CUSTATTR_KEY_NAME Custom attribute name defining ProgID of the dialog to be opened
CUSTATTR_KEY_VALUE Custom attribute value defining ProgID of the dialog to be opened.
Example:
LIST(MESSAGE="PD_DIALOG_OPENED",MESSAGE_DATA=LIST(MOUSE_X=200,-
MOUSE_Y=200,CUSTATTR_KEY_NAME="ToolLauncherProgId",CUSTATTR_KEY_VALUE=-
"ControlDlgs.Launcher"),MSG_ID=6)
Visual SCIL dialog is opened
Message name: VSCIL_TOOL_VSO_OPENED
MESSAGE_DATA contents:
388
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Attribute Meaning
MOUSE_X X-coordinate where the mouse was clicked (in screen coordin-
ates)
MOUSE_Y Y-coordinate where the mouse was clicked (in screen coordin-
ates)
VSCIL_VSO Name of VSO file that was opened
VSCIL_OBJECT_NAME Name of VSO object that was opened
VSCIL_STYLE Windows style of the VSO dialog that was opened (Modern
look&feel)
VSCIL_SGTS Semigraphic tool size that has been set to VSO dialog
Example:
LIST(MESSAGE="VSCIL_TOOL_VSO_OPENED",MESSAGE_DATA=LIST(MOUSE_X=200,-
MOUSE_Y=200,VSCIL_VSO="c:\sc\apl\demo\pict\test.vso",VSCIL_OBJECT_NAME="MAIN",-
VSCIL_STYLE="1",VSCIL_SGTS="0"),MSG_ID=7)
Visual SCIL tool is opened with tool ID
Message name: VSCIL_TOOL_ID_OPENED
MESSAGE_DATA contents:
Table 16.4:
Attribute Meaning
MOUSE_X X-coordinate where the mouse was clicked (in screen coordin-
ates)
MOUSE_Y Y-coordinate where the mouse was clicked (in screen coordin-
ates)
VSCIL_TOOLID Visual SCIL Tool ID that was opened
VSCIL_SGTS Semigraphic tool size that has been set to tool
Example:
LIST(MESSAGE="VSCIL_TOOL_ID_OPENED",MESSAGE_DATA=LIST(MOUSE_X=200,-
MOUSE_Y=200,VSCIL_TOOLID="USR_MGR",VSCIL_SGTS="0"),MSG_ID=8)
There are several methods that can be utilized when making the Visual SCIL dialog
design. These methods are called with the following syntax:
Parent.'method name'
389
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
GetColorsInfo
Returns a list of background, foreground and high light color values as defined in the
framewindow.
Example of a return value:
LIST(-
BGCOLOR = LIST(B = 200, G = 208, R = 212),-
FGCOLOR = LIST(B = 0, G = 0, R = 0),-
HLCOLOR = LIST(B = 214, G = 194, R = 187))
GetCustomData
Returns the defined custom data argument similar to the SetCustomData. See Figure 16.26.
GetDisplayInfo
Returns the same displayinfo list that is also set by the DisplayInfo method. See
Figure 16.27.
GetFontInfo
Font info that is used by the Monitor Pro.
Example of a return value:
LIST(-
CHARSET = 0,-
NAME = "MS Shell Dlg",-
SIZE = 8)
GetIconInfo
Icon size used in the Monitor Pro.
Example of a return value:
LIST(SIZE = "16x16")
GetLanguage
Configured user's language, for example EN.
GetWorkplaceNumber
Workplace number, for example 1.
GetUserName
User name, for example DEMO.
390
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
GetMonitorNumber
Monitor number, for example 101.
GetClickPosition
Cursor position of the mouse click which opened the Visual SCIL dialog. This information
is not updated afterwards, so it is mainly useful for initial placement only.
Example of a return value:
LIST(-
X = 1648,-
Y = 583)
GetFrameWindowPosition
Current Monitor Pro window position. This is updated if the window is moved.
Example of a return value:
LIST(-
X = 1490,-
Y = 125)
GetDialogPositionHint
Recommended placement for the dialog. If the dialog does not handle the
SetDialogPosition method call, this is the offset where the dialog will be placed when
opened.
Example of a return value:
LIST(-
X = 1590,-
Y = 225 )
GetFrameWindowDimensions
Dimensions of the frame window. This information is updated when the frame window
size and position changes.
Example of a return value:
LIST(-
BOTTOM = 941,-
LEFT = 1490,-
RIGHT = 2537,-
TOP = 125)
GetSymbolDimensions
Symbol size and position at the time of the click.
391
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
GetColorScheme
Returns the color scheme file currently in use.
Example of a return value:
LIST(FILE = "C:\sc\apl\demo\PAR\APL\ColorSchemes\SYS600_colors_grey.clut")
392
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
f. Tool IDs can be found in the Tools.ini file and each part of the file is a tool ID.
If LIB 500 is installed, the file is located in \sc\lib4\base\bbone\use, otherwise
it is located in \sc\Stool\Misc.
4. Add the VsoAuthGroup custom key for the subdrawing object, and define a
authorization group name that specifies the authorization level for the tool in the
User Management. The authorization group can be MY_TOOLS, for example.
5. In User Management, add the new authorization group for the users, for example
MY_TOOLS.
6. Define the authorization level for the group.
7. Create an ini file for the tool, for example EXAMPLE.INI.
[EXAMPLE]
Tool_Type_=OBJ
Tool_Description_=Example Tool
Tool_VSO_File_=EXAMPLE.vso
Tool_VSO_Dialog_=Main
Tool_VSO_Method_=
Tool_Default_Path_=
Tool_Ver_Maj_=1.0
Tool_Ver_Min_=2
Tool_Icon_=Product_Icon_M
Tool_Exclusive_=1
8. Create the new tool ID to the Tools.ini file by adding the following lines:
[EXAMPLE]
Tool_Dir_ = \sc\apl\510_403_1\APLMOD4\USE
393
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
394
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Parameter Definition
-loginruntoolid:[id,size] After successful login scil tool is executed with selected size (0,1,2,3,4).
Tool sizes: 0=640x480,1=960x720,2=1280x960,3=1600x1200,4=1920x1440
-loginrunvso:[file,ob- After successful login vso file executed with appropriate object name, modern look&feel (0,1), selected
ject,look&feel,size,cus- size (0,1,2,3,4) and custom scil attribute value.
tom] Tool sizes: 0=640x480,1=960x720,2=1280x960,3=1600x1200,4=1920x1440.
Mask the "-chars inside custom data using \" - chars.
-logoutonce Logout from all Monitor Pros with appropriate user that have the argument defined.
-noborder Start Monitor Pro without borders (cannot be used with -noclose).
-noclose Start Monitor Pro without possibility to close the application window from Windows system menu
(cannot be used with command line arguments -noborder or -light).
-nomaximize Start Monitor Pro without possibility to maximize the application window.
-nominimize Start Monitor Pro without possibility to minimize the application window.
-nomove Start Monitor Pro without possibility to move the application window.
-noresize Start Monitor Pro without possibility to resize the application window.
-notify{:[process id]} Print traces to SYS600 Notification Window. Process id can be defined to enable/disable trace
printing in running Monitor Pro process.
-pid Show Monitor Pro process id in application window title.
-scold:[.bat file] When SYS600 application turns to cold the contents of .bat file is executed.
-sdown:[closemonitor- Close Monitor Pro or Terminal Server Session when SYS600 is stopped.
pro|closetssession]
-setlogin Initialize login dialog with appropriate username and SYS600 application.
-silentexit Exit Monitor Pro without information messages in following cases:
• SYS600 is forced stopped
• SYS600 is stopped and -sdown:closemonitorpro is defined
• Autologout occurs and it is defined to close Monitor Pro in such situation
-topmost Open Monitor Pro as topmost application window.
-tsid Show current terminal server session id in application window title.
-wait Wait for SYS600 to start.
-version Show version information.
-windowname:[stringid] Start Monitor Pro as named window.
395
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
If Monitor Pro is started by using the -wait command line argument, SYS600 is started
with a delay and the Monitor Pro - Waiting dialog is displayed, see Figure 16.29. The
command line argument can be used when the Monitor Pro program file (exe) is added
to the Start menu, for example.
• Clicking Skip Waiting opens Monitor Pro but the connection to SYS600 is not
established.
• Clicking Exit Monitor Pro closes Monitor Pro.
When SYS600 is running, the Monitor Pro login dialog is displayed. For more information
about login in Monitor Pro see SYS600 Operation Manual.
396
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
The availability of the application and system specific appearances are checked when
the user logs in. The toolbars are also synchronized. The unique IDs of the toolbar in the
application and the system specific appearances are compared with the IDs in the user
specific appearance. The unique ID is generated when the toolbar is set as application
or system specific. The ID is also saved to the user specific appearance. When the user
logs in and the ID does not match with the user specific appearance, the contents of
application or system specific toolbar or menu is copied to the user specific appearance.
Toolbars and menus can be set as system or application specific in the customization
mode in Monitor Pro. Making application specific changes to appearance requires
engineering level user rights, and system manager rights are required for system level
changes. For more information about authorization levels, see Chapter 22 Authorization.
To change the appearance, right-click, for example, a toolbar and select Set as System
Specific or Set as Application Specific, see Figure 16.30. For more information about
the customization mode, see Chapter 16 Customizing application window. The whole
toolbar or menu is set as system or application specific, and it is updated for other users
when they log in. By default, the toolbar is visible in every display. If the toolbar is
closed, it is not visible in the display in question.
Toolbar names support translation. For more information about translating the application
specific appearance, see Section 17.7 Translating user interface components.
Table 16.6: Customization files
File path Use
A default appearance for the user.
\sc\prog\sa_lib\SDIActiveBar.tb2
397
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
398
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
It is not possible to authorize the Process Displays Toolbar buttons. For more
information about authorization levels, see Chapter 22 Authorization.
The user specific appearance defines the basic appearance for the user, for example
toolbars and menus. The layout file is SDIActiveBar.tb2 and it can be found in
\sc\apl\[appl]\par\[user].
The user specific appearance consists of the following files:
• The TB2 file is the layout file including menus, toolbars, menu commands, toolbar
buttons, icons and so on.
• The CHG file includes the layout changes, for example, toolbar positions.
• The MNU file is used when the personalized menus and toolbars are taken into use
in the Customize dialog.
The default layout file for all users is located in \sc\prog\sa_lib. By default, the system
and application specific layout files do not exist in a user specific folder. Copy the files
to the folder. In addition, copy the files to the user specific folder used for translation.
The Monitor Pro appearance changes are saved in the user specific file. For more
information about translating user specific appearance, see Section 17.7 Translating user
interface components.
399
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
The open display function opens a defined display with specific settings. The display
can be opened in the same or in a new application window.
To define a display to be opened:
1. Select Settings > Customize to open the Customize dialog.
2. Right-click a menu or a toolbar and select Open Display.
3. The Specify Display dialog opens. See Figure 16.31.
400
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
401
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
16.14.1.1 Alarms
The alarms function opens the Alarm List Template 1 or Alarm List Template 2 display
with defined filters. The display can be opened in the same or in a new application
window.
16.14.1.2 Blockings
The blocking function opens the Blocking Display with defined preconfigurations. The
display can be opened in the same or in a new application window.
• Select Blocking Display in the Display type box.
• Select a display to be opened in the Arguments field.
• If preconfigurations are defined for the selected display, they are displayed in the
Predefined Values box.
16.14.1.3 Events
The events function opens the Event Display with defined filters. The display can be
opened in the same or in a new application window.
• Select Event Display in the Display type box.
• Select a display to be opened in the Arguments field.
• If filters are defined for the selected display, they are shown in the Predefined
Values box.
16.14.1.4 Trends
The trends function opens the Trends Display in a Graphical or Tabular View. A display
can contain preconfigurations. The display can be opened in the same or in a new
application window.
402
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
The measurement reports function opens the Measurement Reports Display in a Graphical
or Tabular View. The display can contain preconfigurations. The display can be opened
in the same or in a new application window.
Custom commands can also be defined for the Process Display objects.
Opens the Process Display with the defined picture. The display can be opened in the
same or in a new application window.
• Select Process Display in the Display type box.
• Select a display to be opened in the Arguments field.
403
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Opens the Process Display with the defined zoom area. The display can be opened in
the same or in a new application window.
• Select Process Display in the Display type box.
• Select a display to be opened in the Arguments field.
• Select the defined zoom area from application or from the user specific tab sheets.
Runs the defined command lines. Table 16.7 shows the parameters of the command lines
that can be defined with a BAT, COM, SCIL, VBS or VSO file. It is possible to define
whether the parameters are provided for the EXE files.
Table 16.7: Parameters for the command lines
Parameter Description
1 SYS600 user name
2 SYS600 user authorization level (GENERAL)
3 SYS600 user authorization level (TOOLS)
4 SYS600 user authorization level (ALARM_HANDLING)
404
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Parameter Description
5 SYS600 user authorization level (EVENT_HANDLING)
6 SYS600 user authorization level (REPORTS)
7 SYS600 user language
8 SYS600 user path
9 SYS600 application name
10 SYS600 application number
11 SYS600 installed drive
12 SYS600 application path
13 SYS600 application is a LIB application
14 SYS600 application is a prepared LIB application
15 Current open picture file path
16 Monitor Pro window handle
17 Monitor Pro process ID
18 Terminal server sessions identifier
19 Mouse pointer X-coordinate, Mouse pointer Y-coordinate
20 Object name where applicable
21 OPC item ID where applicable
22 Configured authorization group for current item
23 Configured authorization level for current item
24 Real authorization for the current item in the SYS600 user management
25 SA object name where applicable
26 Object dimensions (top,left,bottom,right) when opened from context menus.
27 Object custom attributes when opened from context menus. Key and value separ-
ated with "=", key and value pairs with ",". If no value for the key exists the "-" is
used.
28 Object variable mappings when opened from context menus. Key and value sep-
arated with "=", key and value pairs with ",". If no value for the key exists the "-"
is used.
29 OPC Item ID (21) in SCIL format when opened from context menus
30 Computer name when running locally, terminal server client name in terminal
server session
31 Custom argument that is given for Custom Commands or Tool Launcher (if applic-
able). If there are several arguments (=includes spaces), the rest of the attributes
in this table will not match unless capsulated inside quotes, for example "My Argu-
ments Passed to Executables".
32 VSCIL tool offset (x,y), defined in Application Settings dialog. Can be used for
other tools also for harmonization.
33 Monitor Pro application window topleft (x,y) in screen coordinates
34 Monitor Pro application window dimensions (top,left,bottom,right)
405
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Parameter Description
35 Monitor Pro font. Consists of font name, character set and size separated with
comma.
36 Monitor Pro icon size. Possible values are 16x16, 24x24 and 32x32
37 Monitor Pro background color (r,g,b)
38 Monitor Pro foreground color (r,g,b)
39 Monitor Pro highlight color (r,g,b)
40 Control Dialog offset (x,y), defined in Application Settings dialog. Can be used for
other tools also for harmonization.
41 Control Dialog (inactivity) timeout, defined in Application Settings dialog. Can be
used for other tools also for harmonization.
42 Monitor Pro instance ID
406
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
407
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Argument Description
PROCESS_ID Monitor Pro process ID
TERMINAL_SERVER_ID Terminal server sessions identifier
MOUSECOORDS Mouse pointer X coordinate, Mouse pointer Y
coordinate
OBJECT_NAME_EXT Object name where applicable
OPCITEMID OPC item ID where applicable
CURRENT_CONF_AUTH_GROUP Configured authorization group for current item
CURRENT_CONF_AUTH_LEVEL Configured authorization level for current item
CURRENT_REAL_AUTH_LEVEL Real authorization for the current item in the
SYS600 user management
OBJECT_NAME SA object name where applicable
OPCITEMID_SCIL OPC Item ID (OPCITEMID) in SCIL format
WORKPLACE_NAME Computer name when running locally, terminal
server client name in terminal server session.
TOOL_OFFSET VSCIL tool offset (x,y), defined in Application
Settings dialog. Can be used for other tools also
for harmonization.
APPWND_TOPLEFT Monitor Pro application window topleft (x,y) in
screen coordinates.
CONTROLDLG_OFFSET Control Dialog offset (x,y), defined in Application
Settings dialog. Can be used for other tools also
for harmonization.
CONTROLDLG_TIMEOUT Control Dialog (inactivity) timeout, defined in
Application Settings dialog. Can be used for
other tools also for harmonization.
INSTANCE_ID Monitor Pro instance ID
MAPPED_DATA_VARS Object variable mappings. Data packed to a
vector with each name and value pair as a list
element, e.g. MAPPED_DATA_VARS(VEC-
TOR(LIST(Name = "ItemName", Value = "Item-
Value"))).
CUSTOM_ATTRS Object custom attributes. Data packed to a
vector with each name and value pair as a list
element, e.g. CUSTOM_ATTRS(VEC-
TOR(LIST(Name = "ItemName", Value = "Item-
Value"))).
Opening a Visual SCIL tool can be defined by selecting the tool from the list or by
defining the file used.
408
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
4. Define the VSCIL tool used in the Specify VSCIL Tool dialog.
• File
• Object Name
• Custom SCIL Attribute Value
Table 16.9: Examples of SCIL expressions
Expression SCIL data type
"Some text" TEXT
VECTOR(“A”,!) VECTOR
LIST(LN=”ABC”, IX=10) LIST
409
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
In option group Tool Appearance, some settings for the visual scil tool can be defined.
• Tool Size
Defines size setting used for semigraphics tools opened from this visual scil tool.
This setting is equivalent to setting monitor size when opening classic monitor. Note
that this setting affects only the VSO tool opened from the menu item/toolbar button
and it does not affect appearance of VSO tool itself.
• Use Modern Style
Defines the look and feel of Visual SCIL controls that are used in the VSO dialog.
When the Use Modern Style is checked, dialog controls are displayed in the same
style as Windows dialogs, as shown in the left image of LINK IS MISSING. The
default style is shown to the right of LINK IS MISSING.
A .vso file can also be dragged from Windows Explorer and dropped to the required
toolbar or menu in Monitor Pro.
Define and monitor the state of the configured alarm indicators based on the value in
the OPC Item. The configured alarm states are described in Table 16.10.
Table 16.10: Configured alarm indicator states
State Description Example
0 No active, unacked alarms The configured command is dis-
abled
1 Active, acknowledged alarms The configured command is en-
abled (not blinking)
2 Active, unacked alarms The configured command is blink-
ing
410
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
A global shortcut key can be defined for opening the Login dialog to
\sc\prog\sa_lib\default_framewindow.ini file:
1. Find the following text in the \sc\prog\sa_lib\default_framewindow.ini file.
[SHORTCUTS]
;Keyboard shortcut for showing the Login dialog (Ctrl+[character]). If not
defined using the default value Ctrl+L
411
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
LoginDlg=
412
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Clicking on the Process Display Shortcut Configuration Tool opens the Process Display
Visibility dialog, shown in Figure 16.40.
The Process Displays currently available for current SYS600 application are shown in
the left window. The right window displays the currently visible Process Display
Shortcuts. Visibility is configured to be either Application specific of User specific.
Application specific visibility allows all the users in current SYS600 application to access
the configured Process Displays.
User specific visibility allows the selected user access to the configured Process Displays.
To enable the Process Display shortcut:
1. Select the required Visibility by checking the appropriate radio button.
If User specific visibility is selected, select the required user from the Users window
to the right.
2. Select the required Process Display shortcut from the All list on the left.
3. Click the button with right-facing arrow ( >).
The shortcut is moved to the Selected list.
4. Click OK to apply the changes.
413
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Application specific Process Display shortcuts are shown to all users. The shortcut files
are located in [Appl path]\PAR\APL\PROCESS\
User specific Process Display shortcuts are shown individually to each user. The user
specific shortcut files are located in [User path]\PROCESS\ TOOLBAR_SHORTCUTS.
The user is not allowed to open Process Displays that are not defined on toolbar of the
user specific Process Displays.
It may also be required to hide a Process Display from the Process Displays toolbar. This
is achieved by changing the file attributes of the specific Process Display file (.v file),
through the file properties context menu in Windows Explorer.
Process Displays combo box can be enabled by accessing the Add or Remove menu
and clicking the Process Displays menu item, see Figure 16.41.
414
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Process Displays combo box can be disabled by clicking the Process Displays menu
item again.
415
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
(icon storage). If the path to the icon is available in the user specific icon settings
(change icon functionality) the specific icon size is loaded from the icon file.
For ABB.ico, only size 32x16 is supported.
416
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
4. The visible alarm count of Alarm Row is set to the configured one.
5. Click Close to exit the Customize dialog.
417
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
17 Localizing application
Translations of the text are included in SYS600 Visual SCIL Objects. For example,
button labels and menu texts are normally defined by using the Dialog Editor and stored
in same objects. For more information on using language dependent texts, see SYS600
Visual SCIL Application Design.
Other translations of application texts, for example texts describing process objects and
their states, are stored in the text databases. The texts are translated explicitly by the
TRANSLATION function, or implicitly by referencing the object's language sensitive
attribute. Text Translation Tool translates the texts.
To save the translation, a Windows based localization tool, such as RCWinTrans,
Multilizer or Lingobit Localizer can be used. For example, the Lingobit Localizer can
be downloaded from http://www.lingobit.com/.
419
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
2. The text databases listed by the application attribute, APL:BTD, are used by various
software products, such as LIBxxx products and their localizations.
3. The system text database, SYS_TEXT.sdb, is delivered with the product and should
not be modified.
The databases are searched in the scope order, APL_TEXT.sdb first and SYS_TEXT.sdb
last.
420
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
If some of the text still displays in English in spite of the fact that the localization file
exists, the resource file is likely not up-to-date and must be updated towards the _EN.*
file. The file may have new strings that are not yet localized.
PH = %l_Global_Paths,-
421
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
TD = VECTOR("APL_/SYST_TEXT_DE.SDB","APL_/SYST_TEXT_DE.SDB"),-
; Text databases
-; QD = (1,1,0,0,0,0,1,1,1,1,1,1,1,1,1),-
-; RC = VECTOR("FILE_FUNCTIONS_CREATE_DIRECTORIES"),-
422
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
For more information on how to use Text Tool, see SYS600 Installation and
Administration Manual.
7. Shutdown SYS600 and modify the application language:
#CREATE APL:V = LIST(-
PH = %l_Global_Paths,-
TD = VECTOR("APL_/SYST_TEXT_DE.SDB","APL_/SYST_TEXT_DE.SDB"),-
; Text databases
LA = "DE",-
-; QD = (1,1,0,0,0,0,1,1,1,1,1,1,1,1,1),-
423
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
-; RC = VECTOR("FILE_FUNCTIONS_CREATE_DIRECTORIES"),-
;Revision compatibility
424
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Figure 17.2: Main window of the Localizer and the Project Wizard dialog
2. Click Next to open the list of dll files, see Figure 17.3.
3. Click Add to add more files, and Remove... if there are unnecessary files on the
list.
425
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
4. Click Next to open the dialog for selecting the languages, see Figure 17.4.
5. Select the original language from the drop-down list and click Add to select the
target language.
426
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
6. Click Next to open the list of dll files in the application window. The list is shown
on the left side of the window, see Figure 17.5.
427
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
7. Click the dll files to see the strings to be translated. The resources are collected to
a string table, and all the strings in each table should be translated, see Figure 17.6.
428
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
8. Click the string to be translated and type in the translation in the language column.
The strings that are not translated use the original language, see Figure 17.7.
9. When the translations are done, save them by selecting Edit >Save.
10. To generate the dll files, open the Language to export dialog by selecting Project
> Create Localized Files, see Figure 17.8.
11. Select the language to which the dll files are generated to and click OK.
429
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
12. The translated dll files can be found where the project was created, which is
c:\data\SYS600 in this example, see Figure 17.9. Depending on the project setup
and the generated languages, there is a directory for each language. As only Finnish
language was generated in this example, there is only one subdirectory in the project
structure c:\data\SYS600\Finnish-Finland.
13. When the files have been generated, they should be copied from the project directory
to c:\sc\prog\sa_lib\FI and renamed according to Table 17.2.
430
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
431
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
To translate a component:
1. Select Settings > Customize to open the Customize dialog.
2. Right-click a component and select Localize to open the Localize dialog, see
Figure 17.10.
3. Select the In Use check box in the Localizations field or the User Definition field.
• To use the translations, select the check box in the Localizations field.
• To use the user specific definition, select the check box in the User Definition
field.
To use a translation:
1. Select the In Use check box in the Localizations field, see Figure 17.10.
2. Click New to add a new translation.
3. Select the target language, see Figure 17.11.
432
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
433
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
To remove a translation:
1. Select Settings > Customize to open the Customize dialog.
2. Right-click a component and select Localize to open the Localize dialog.
3. Click Remove... either in the Localizations field or in the User Definition field.
4. Click OK to remove the translation.
434
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
c. To add an input language, select the appropriate language from the Input
Language drop-down list. If the Keyboard layout/IME check box is selected,
it is possible to write, for example, the Chinese characters with the keyboard.
d. Click OK.
e. If the Visual SCIL tools do not accept the special characters from the keyboard,
set the language used as a default input language by selecting the appropriate
language from the Default input language drop-down list.
f. Click OK.
3. Select the Administrative tab to set the local language as a system locale and load
the code pages:
a. Select Change system local... to open the Region and Language Settings dialog.
b. Select the appropriate language from the Language for non-Unicode programs
drop-down list.
c. To display the text correctly, use the fonts that contain the local language
characters or load more code pages. In the Code page conversion tables field,
select the appropriate code pages to be loaded.
d. Click OK.
4. Click OK and restart the computer so that the new setting takes effect.
Use Text Translation Tool to translate a new language in MicroSCADA Pro. For more
information about Text Translation Tool, see SYS600 Installation and Administration
Manual.
To take the user language into use, see Section 17.8 Adding new language in Monitor
Pro.
435
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
2. Select the Formats tab and select the language for the time format accordingly.
3. On the Keyboards and Languages tab, select Change keyboards...
4. In the Text Services and Input Languages dialog, select the default input language.
436
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
5. On the Administrative tab select Change system local... to open the Region and
Language Settings dialog.
6. Select the language for non-unicode programs.
7. Click OK.
437
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
18.1 General
System Self Supervision (SSS) provides the means in MicroSCADA Pro systems to
supervise and monitor the system itself. Hardware and software status information is
shown by the application objects and supervision symbols in the product.
The status of the supervised objects can be received to MicroSCADA via system messages
or predefined event channels like APL_EVENT, SYS_EVENT and OS_EVENT.
If necessary, the information is refined by supervision routing (a set of command
procedures, event channels and time channels) and the end result (application objects)
is used for showing events, alarms and status information.
439
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
18.1.1 Installation
The Supervision Base functionality is installed to the system in one of the following
ways:
• Installation of SSS functionality is enabled from the Tools menu of the System
Configuration Tool. The SSS base functionality will be installed according to the
system configuration.
• The SSS functionality will be installed when the SSS object is installed in Object
Navigator. The SSS base functionality is then installed only for that specific object
at the time.
440
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
In order to obtain full operability, System Self Supervision sets the following
environmental requirements:
• System Self Supervision routing switch is defined and enabled in
SYS_BASCON.COM (System Variable attribute):
SV = (0,- ;System Variables
t_Version = "9.3")),-
OT = (Bit_Mask(0,1,2,3,4),-
Bit_Mask(0,1,2,3,44),-
Bit_Mask(0,1,2,3,4)))
For more information about parallel queues, see SYS600 System Objects manual.
• System and Operating System events are enabled in MicroSCADA application
(System Event Enabled attribute in SYS_BASCON.COM):
EE = 1,- ;System Events & Operating System Events (1=Enabled, 0=Disabled)
• Additionally, application diagnostics can be enabled. This way, the status information
of the application state from external application is received as events:
Apl_DI = 10,- ;Application diagnostic interval (0 = Disabled)
441
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Installation and configuration of the communication related parts is done by using the
System Configuration Tool.
Before building the application, the user should consider whether the system messages
are sent as binary information, analog information or both. The required configuration
is done in file SSS_SETUP.SCL. For more information about SSS_SETUP.SCL, see
Section 18.5.2.4 Configuration files.
In practice, the SSS symbols supports binary model, so using binary model is
recommended. However, it should be noted that if analog model is disabled, it is not
possible to get events to the Log Viewer.
In Hot-stand-by systems, the system configuration can be done in WD application to
speed up the take over time.
When the system configuration is done in WD application, some configuration is needed
from the perspective of SSS in order to get the SSS related information to the main
application. One possible sequence is described below:
1. Make the system configuration in WD application with the System Configuration
Tool.
2. Open the configuration in the main application.
3. Enable System Self Supervision and save the configuration.
4. Open the configuration in WD application. Disable System Self Supervision and
save the configuration.
Resending system messages needs to be initiated during take over. The required
configuration is done in command procedures APL_INIT_1:C and APL_INIT_H. Below
is an example code of how this is done for communication node and station objects.
#SET NET3:SOS = 1 ;updates the status of communication node
442
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
SSS objects support the partitioning of the Object identification in a similar way as Power
Process Library functions. By default, the following conventions are used.
Table 18.1: OI- structure
Field Purpose Comment
Station name System name System name can be defined in Application Settings
(SYS:BCX) dialog
Bay name Monitoring object Monitoring object names by default: OS,SYS, APL,
name e.g. Station Node, NET, Line, Station, SLCM and Printer
Device name Monitoring object -
number
443
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
18.5.1 Configuration
This section describes the structure of the Supervision Base. All files, form pictures and
database objects are included. The SSS Backbone related files will be located under
System Tools in the /STOOL/SUPERV folder.
The following Text Translation Tool compatible text files are used by the SSS Backbone.
The path is /STOOL/SUPERV/LANG_TEXTS.
Table 18.2: Text Translation Tool compatible text files
File Functionality
SSSTexts.ini Text file for the database creation and for log
event presentations of the SSS Backbone
functionality
444
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
The following initialization files are used by the System Self Supervision. The path is
/STOOL/SUPERV/.
The main function of the initialization files is to include configuration data concerning
the objects to be supervised in the system, and event filtering data concerning the events
to be notified in supervision routing.
The data stored into these files is utilized actively during supervision routing through
Supervision Routing Interpreter via System Configuration Manager Services. Initialization
file for configuration data is updated during the installation of the System Self Supervision
functionality.
Initialization file for event filtering data has the default settings after installation of the
System Self Supervision. Default event filtering file includes references to communication
units, communication unit lines, stations, LON Clock Masters, printers, predefined and
specified events, that is, references to the supported objects in the System Self
Supervision.
These default settings can be modified as project specific by using Supervision Filter
Editor. Supervision Filter Editor can be opened from System Configuration Tool
(Tools/System Self Supervision Filter Editor menu item).
The following configuration file is used by the System Self Supervision. The path is:
/STOOL/SUPERV/.
Table 18.4: Configuration file used by System Self Supervision
File Functionality
SSS_SETUP.SCL Contains the configuration data for the general
parameters of the System Self Supervision.
445
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
The configuration file contains the configuration data for the general parameters of
System Self Supervision. In the specified, file the following settings are defined:
If the application specific modifications to the general parameters are needed, the
configuration file can be copied under the application folder /SUPERV and do the
modifications there.
The contents of general parameters in running MicroSCADA system are shown by the
Supervision Filter Editor tool. This tool is accessible from System Configuration Tool.
To view these parameters:
1. Select Tools > System Self Supervision Filter Editor.
2. Select View > Supervision Settings.
ENABLE_ALARM
In addition to primary process object receiving the system message, another process
object is created for showing the alarm in Alarm List. Process objects are created
dynamically as new system messages are coming to system.
ENABLE_ANALOG_MODEL
A process object type of analog input is created for receiving system messages.
ENABLE_BINARY_MODEL
A process object type of binary input is created for receiving system messages.
446
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
ENABLE_EVENT
In addition to primary process object receiving the system message, another process
object is created for showing the event in Event List. Process objects are created
dynamically as new system messages are coming to system.
ENABLE_LOG
Log file is updated when the system message is coming to system. In order to have this
functionality, analog model needs to be enabled.
ENABLE_STATION_MESSAGES
With this flag the rerouting of system messages for stations can be enabled/disabled.
The following System Configuration Manager files are used by the System Self
Supervision. The path is /STOOL/SUPERV/.
Table 18.5: System Configuration Manager files used by System Self Supervision
File Functionality
SSS_MGR.MOD Contains the source code of the System Config-
uration Manager services used in the System
Self Supervision.
SSS_MGR2.MOD Contains the source code of the System Config-
uration Manager services used in the System
Self Supervision.
The following text files are used by the System Self Supervision.
Table 18.6: System Configuration Manager files used by System Self Supervision
File Functionality
SSS_APLINIT.SCL Contains the source code for initialization of
local applications at system start-up for the
System Self Supervision.
SSS_APLOBJ.SCL Contains the source code for creating command
procedures, time channels, data objects and
event channels for System Self Supervision.
SSS_INIT.SCL Contains the source code for enabling/disabling
the use of command procedures for System Self
Supervision.
SSS_LOGINIT.SCL Contains the source code for initialization of log
files at system start-up for the System Self Su-
pervision.
447
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
File Functionality
SSS_REV Contains the revision info for the System Self
Supervision
SSS_UPDATE.SCL Contains the source code for updating applica-
tion objects after revision update for the System
Self Supervision.
In System Self Supervision, the process objects are created for the following purposes:
• For receiving system messages from the communication units.
• For indicating the state of the object.
• For event and alarm handling.
The process object groups, as well as default naming and index conventions used in the
database are described in more detailed below.
Table 18.7: Communication unit (NET) and base system nodes
Process object Type of usage Indexes
SYS_N<number>I Communication unit 10 - indication for communication unit (PC NET)
(PC NET) 11 - indication for redundant frontend pair
110 - routing point for communication unit (PC NET)
111 - routing point for redundant frontend pair
121...128 - routing points for communication unit lines
210 - Communication status of PC NET (BI)
SYS_N<number>I Base system 10 - indication for global memory pool supervision
SYS_N<num- Event objects Indexes are created in ascending order
ber>E
SYS_N<num- Alarm objects Indexes are created in ascending order
ber>A
448
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
449
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
At first installation of System Self Supervision, the scale 1_1 (linear 1:1 scale) is created
(if it does not exist).
At first installation of System Self Supervision, the data object for the log file counters
is created (SYS_CNTR).
Each log file will contain maximum of 1000 events by default. If the number of events
is exceeded, a backup file is created and the collecting of events is started again. The
dedicated data object for the log file counters is allocated for counting the cumulative
number of events in each of the log file categories.
At first installation of System Self Supervision, the following command procedures are
created (the path for the source code files of the command procedures is
/STOOL/SUPERV/):
Table 18.12: Command procedures
Command procedure Functionality
SYS_APLER Command procedure for receiving APL_EVENT
events
SYS_NETLMR Command procedure for receiving system
messages for communication unit lines (NET
lines)
SYS_NETMR Command procedure for receiving system
messages for communication units (NET)
SYS_NETSR Command procedure for communication unit
supervision.
SYS_OSER Command procedure for receiving OS_EVENT
events
450
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
At first installation of System Self Supervision, the time channel for the communication
unit supervision is created (SYS_NETSR).
At first installation of System Self Supervision, the following event channels are created:
Table 18.13: Event channels
Event channel Functionality
APL_EVENT Event channel for receiving APL_EVENT events
OS_EVENT Event channel for receiving OS_EVENT events
SYS_EVENT Event channel for receiving SYS_EVENT events
SYS_NETLMR Event channel for communication unit line sys-
tem messages
SYS_NETMR Event channel for communication unit system
messages
SYS_PRIMR Event channel for printer system messages
SYS_SLCMR Event channel for LON Clock Master system
messages
SYS_STAMR Event channel for station system messages
451
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
The following Visual SCIL object files are used by System Self Supervision. The path
is /STOOL/SUPERV/.
Table 18.14: Visual SCIL object files
File Functionality
SSSLVIEWER.VSO Supervision Log dialog
SSSLVIEWER.INI Initialization file for the Supervision Log dialog
SSS_CTRLDLG.VSO Control dialog for SSS objects
This section describes the installation of the Application status standard function from
the Power Process Library. The standard function for the Application status is found in
the directory /SA_LIB/BASE/BBONE/INST and it should be installed by using the
Power Process Library installation procedures (SA_LIB/Supervision/Application status).
The Power Process symbol for the Application status standard function is installed by
using the following Display Builder functions:
1. Object Browser
2. Palette
For more information, see SYS600 Process Display Design manual.
452
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
The application standard function has the following attributes to be configured with the
Standard Function Tool:
Table 18.16: Configurable attributes
Attribute Meaning Default
AUTHORIZATION_GROUP The name of authorization group SUPERVISION
APL_NUMBER The physical number of the super- APL:BAN
vised applications.
HOT_STAND_BY Indicates whether the system is a FALSE
single or a Hot Stand-By (Warm-
Stand-By) system.
NODE_NUMBER The node number of the Micro- SYS:BND
SCADA base system containing
the supervised application.
EXT_WD_APL_NR The logical number of the watch- 0
dog application in the "remote"
(i.e. other than the current) base
system, "adjacent watchdog".
The database objects related to the application object are created automatically in
background as Apply button is being clicked. The following process objects are created:
453
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
454
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
This section describes the structure of the application status standard function. All
subdrawing files, form pictures, help and other text files as well as database objects are
included.
The application status is a part of the standard functions of Power Process Library and
has the directory /SA_LIB/BASE/BBONE and the standard Power Process Library
subdirectories INST, LANG0 and USE.
18.6.4.2 Files
The following configuration files are used by the Application status standard function.
The path is /SA_LIB/BASE/BBONE/INST.
Table 18.22: Configuration files used by the application status standard function
File Functionality
SAI_APL.DAT Contains the configuration data for application
status when it is created, modified or deleted by
the configuration tools.
SAI_APLDEL.VSO Tool for deleting process objects and SSS con-
figuration for application status.
455
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
At first installation, the application object creates the following command procedures if
the supervised application refers to an external application or there is a hot-stand-by
(warm-stand-by) system in question.
Table 18.23: Command procedures
Command procedure Functionality Remarks
SYS_APLE1 Command procedure for ap- In case of external application
plication supervision.
SYS_APLE2 Command procedure for ap- In case of external application
plication supervision.
SYS_APLH1 Command procedure for ap- In case of hot-stand-by system
plication supervision.
SYS_APLH2 Command procedure for ap- In case of hot-stand-by system
plication supervision.
At first installation, the application object creates the following time channels if the
supervised application refers to an external application or there is a hot-stand-by
(warm-stand-by) system in question.
Table 18.24: Time channels
Command procedure Functionality Remarks
SYS_APLE Time channel for application In case of external application
supervision.
SYS_APLH Time channel procedure for In case of hot-stand-by system
application supervision.
At first installation, the application object creates the event channel SYS_EVENT, if it
does not exist.
This section describes the installation of the DuoDriver Server status standard function
from the Power Process Library. The standard function for the DuoDriver Server status
is found in the directory /SA_LIB/BASE/BBONE/INST and it should be installed by
using the Power Process Library installation procedures (SA_LIB/Supervision/DuoDriver
Server status).
456
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
The Power Process symbol for the DuoDriver Server status standard function is installed
by using the following Display Builder functions:
1. Object Browser
2. Palette
For more information, see SYS600 Process Display Design manual.
Table 18.25: Symbol for DuoDriver Server status standard function
File Name Symbol
Status-101 with label.sd
The DuoDriver Server status standard function has the following attributes to be
configured with Standard Function Tool:
Table 18.26: Configurable attributes
Attribute Meaning Default
STATION_NAME Name of the substation SYS:BCX
BAY_NAME Name of the bay DuoDriver
DEVICE_NAME Name of the device -
P_OBJECT_LN Logical name of process objects SYS_D0001I
INSTANCE_NAME The name of DuoDriver server in- DD1
stance
LINE_A Identification of line A Line A
LINE_B Identification of line B Line B
AUTHORIZATION_GROUP Name of the authorization group SUPERVISION
Depending on the configuration of the DuoDriver Server status standard function, the
tools create a certain set of process objects in the database. Process objectsthat will be
linked to the actual process should be edited to have a station number, an address and a
proper switching state. Otherwise, by default, all other attributes should have suitable
values for normal operation.
457
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
This section describes the structure of the DuoDriver Server status standard function.
All subdrawing files, form pictures, help and other text files as well as database objects
are included.
The DuoDriver Server status is a part of the standard functions of Power Process Library
and has the directory /SA_LIB/BASE/BBONE and the standard Power Process Library
subdirectories INST, LANG0 and USE.
458
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
18.7.4.2 Files
The path to the DuoDriver Server status help text file is /SA_LIB/BASE/BBONE/LANG0.
Table 18.30: DuoDriver Server status help file
File Functionality
SAI_DUOS.HLP Standard function installation help file
The following configuration files are used by the DuoDriver Server status standard
function. The path is /SA_LIB/BASE/BBONE/INST.
Table 18.31: Configuration files used by the DuoDriver Server status standard
function
File Functionality
SAI_DUOS.DAT Contains the configuration data for
DuoDriver Server status when it is created,
modified or deleted by the configuration
tools.
SAI_DUOS.POT Contains the process object definitions for
the DuoDriver Server status.
INDEX5_B1.TXT Selection list of Power Process Library
standard functions for the installation tool.
This section describes the installation of the DuoDriver Device status standard function
from the Power Process Library. The standard function for the DuoDriver Device status
is found in the directory /SA_LIB/BASE/BBONE/INST and it should be installed by
459
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
The Power Process symbol for the DuoDriver Device status standard function is installed
by using the following Display Builder functions:
1. Object Browser
2. Palette
For more information, see SYS600 Process Display Design manual.
Table 18.32: Symbol for DuoDriver Device status standard function
File Name Symbol
Status-101 with label.sd
The DuoDriver Device status standard function has the following attributes to be
configured with Standard Function Tool:
Table 18.33: Configurable attributes
Attribute Meaning Default
STATION_NAME Name of the substation -
BAY_NAME Name of the bay -
DEVICE_NAME Name of the device -
P_OBJECT_LN Logical name of process objects -
OPC_ITEM_PREFIX OPC path to logical device level IEC61850 Subnet-
work.IED1.LD0
OPC_LN_INSTANCES The instance name of IEC 61850 ("LPHD1")
logical node for physical device
information
DATA_OBJECT Common Data class, Data Object ("RSS;Src-
and Data attribute for DuoDriver St.stValA","RSS;Src-
port status information St.stValB")
DATA_TEXT Signal texts for data objects ("Port Status 1/2
Line A","Port
Status 1/2 Line B")
AUTHORIZATION_GROUP Name of the authorization group SUPERVISION
460
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Depending on the configuration of the DuoDriver Device status standard function, the
tools create a certain set of process objects in the database. Process objects that will be
linked to the actual process should be edited to have a station number, an address and a
proper switching state. Otherwise, by default, all other attributes should have suitable
values for normal operation.
Table 18.34: Process objects for DuoDriver Device status
Index Obj. type Process object Remarks Group identifier
21 BI Port status Line A Server Instance 1 BSWDDDI MSC
22 BI Line B status Server Instance 1 BSWDDDI MSC
This section describes the structure of the DuoDriver Device status standard function.
All subdrawing files, form pictures, help and other text files, as well as database objects,
are included.
The DuoDriver Device status is a part of the standard functions of Power Process Library
and has the directory /SA_LIB/BASE/BBONE and the standard Power Process Library
subdirectories INST, LANG0 and USE.
461
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
18.8.4.2 Files
The following configuration files are used by the DuoDriver Device status standard
function. The path is /SA_LIB/BASE/BBONE/INST.
Table 18.38: Configuration files used by the DuoDriver Device status standard
function
File Functionality
SAI_LPHD.DAT Contains the configuration data for DuoDriver
Device status when it is created, modified or
deleted by the configuration tools.
SAI_LPHD.POT Contains the process object definitions for the
DuoDriver Device status.
INDEX5_B1.TXT Selection list of Power Process Library standard
functions for the installation tool.
This section describes the installation of the Device status via SNMP standard function
from the Power Process Library. The standard function for the Device status via SNMP
is found in the directory /SA_LIB/BASE/BBONE/INST and it should be installed by
462
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
The Power Process symbol for the Device status via SNMP standard function is installed
by using the following Display Builder functions:
1. Palette
The Device Status via SNMP standard function has the following attributes to be
configured with Standard Function Tool:
Table 18.39: Configurable attributes
Attribute Meaning Default
STATION_NAME Name of the substation -
BAY_NAME Name of the bay -
DEVICE_NAME Name of the device -
P_OBJECT_LN Logical name of process objects -
SNMP_DEVICE_TEMPLATE Template for the SNMP device -
AUTHORIZATION_GROUP Name of the authorization group SUPERVISION
Depending on the configuration of the Device status via SNMP standard function, the
tools create a certain set of process objects in the database. Process objects that will be
linked to the actual process should be edited to have a station number, an address and a
proper switching state. Otherwise, by default, all other attributes should have suitable
values for normal operation.
By default, there are four templates provided for SNMP devices creating the followings
sets of process objects.
Table 18.40: Device status via SNMP (Network switch 20 ports)
Index Obj. type Process object Remarks Group identifier
1 … 20 DB Port status BSSNMPIDEV
100 AI Temperature BSSNMPIDEV
102 DB Power supply 1 BSSNMPIDEV
463
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
The following predefined templates for SNMP device control dialogs can be found from
file \sc\apl\'apl name'\SUPERV\SSS_CTRLDLG.INI:
• SNMP_SWITCH_20
• SNMP_SWITCH_8
464
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
• SNMP_SWITCH_4
• SNMP_GPS
• SNMP_COMPUTER
• SNMP_PRINTER
The launching of the control dialog for SNMP devices is done in Display builder/Tool
Launcher settings.
1. In Display Builder, drag and drop a suitable symbol for SNMP device.
2. Open the Tool Launcher by right-clicking the symbol.
3. Select Open > Visual SCIL.
4. Define VSO file = SYS_TOOL/SSS_CTRLDLG.VSO.
5. Define Visual SCIL object name = MAIN and Custom argument = LIST(LN="ln",
OBJECTTYPE="object type'"), where 'ln' is the logical name of process objects and
object type is one of the objects types defined in file SSS_CTRLDLG.INI, e.g
LIST(LN="GPS", OBJECTTYPE="SNMP_GPS").
465
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Table 18.44: Example of Device status via SNMP standard function configuration
Attribute Value
STATION_NAME NCC 1
BAY_NAME Network Switch
DEVICE_NAME 1
P_OBJECT_LN SYS_NSW1
SNMP_DEVICE_TEMPLATE Network switch 20 ports
AUTHORIZATION_GROUP SUPERVISION
466
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
This section describes the structure of the Device status via SNMP standard function.
All subdrawing files, form pictures, help and other text files as well as database objects
are included.
The Device status via SNMP is a part of the standard functions of Power Process Library
and has the directory /SA_LIB/BASE/BBONE and the standard Power Process Library
subdirectories INST, LANG0 and USE.
18.9.4.2 Files
Table 18.45: Device status via SNMP standard function related files
File Functionality Path
Router.sd Power Process symbol for /PROG/GRAPHICSEN-
Status -101.sd Device status via SNMP GINE/PALETTE/06-SA_Supervision
Communication Port x 4.sd standard function
Router - RuggedRouter.sd
Wireless Router.sd
Switched Hub.sd
Modem.sd
Firewall.sd
Printer.sd
FORM5SAGR1.PIC Generic format picture for /SA_LIB/BASE/BBONE/USE
printing
The path to the Device status via SNMP help text file is /SA_LIB/BASE/BBONE/LANG0.
Table 18.46: Device status via SNMP help file
File Functionality
SAI_SNMP.HLP Standard function installation help file
The following configuration files are used by the Device status via SNMP standard
function. The path is /SA_LIB/BASE/BBONE/INST.
467
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Table 18.47: Configuration files used by the Device status via SNMP standard
function
File Functionality
SAI_SNMP.DAT Contains the configuration data for Device status
via SNMP when it is created, modified or deleted
by the configuration tools.
SAI_SNMP.POT Contains the process object definitions for the
Device status via SNMP.
SAI_SNMP.TPL Contains device templates for SNMP devices.
INDEX5_B1.TXT Selection list of Power Process Library standard
functions for the installation tool.
It is possible to modify the existing SNMP device templates or add new templates in file
/SA_LIB/BASE/BBONE/INST/SAI_SNMP.TPL. Copy the file to \sc\apl\'apl
name'\APLMOD4\INST directory and make the modification there.
File format
A template file has two kinds of sections:
1. Device template section, describes the SNMP device templates in file.
2. Device types sections, describes the details of each SNMP device.
468
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
469
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Control dialog automatically resolves the object type based on the logical name of the
process object. When resolving the object type, the naming conventions described in
Section 18.5.2.7 Process objects are used as a rule.
SYS_?xxxx, where ? determines the type of object:
• A = BASE_APL_SINGLE or BASE_APL_HSB
• N = COM_PCNET, COM_61850, or BASE_SYS in case xxxx equals to SYS:BND
or RX attribute contains BSWSYSYS
• S = STA
• xxxx - defines the object number argument
If, for some reason, the automatic detection is not suitable, OBJECTTYPECALLBACK
can be used to extend the control dialog to support object types not supported by auto
detection.
OBJECTTYPECALLBACK program should return an empty string for auto detection
or a text which references to object type section in the configuration file.
By default OBJECTTYPECALLBACK program returns contents of OBJECTTYPE list
attribute if defined in custom argument of the symbol.
Each section has the following keys. If the key value is type of VECTOR, the length of
the vector has to be same for these keys.
Table 18.52: Keys in objects types
Key Meaning Example value
TABS Reference to TABS section, Vector("BASE_MAIN")
i.e. what tabs will be loaded
when the dialog is opened.
470
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Keys in the TAB section depend on the type of tab (the value of OBJECT key). The
common keys for all tabs and keys of the built in tabs are described below.
Table 18.53: Tab sections
Key Meaning
OBJECT The name of Visual SCIL object that is loaded
from VSO. Name is prefixed with NBP_ by the
dialog framework and the object must be of a
type NOTEBOOK_PAGE
VSO The path to the VSO file where the OBJECT is
loaded. If this key is missing or empty
SSS_CtrlDlg.VSO is defaulted to. VSO and
OBJECTS keys can be used to extend the
control dialog functionality without the need to
modify the dialog code itself.
TABTITLE Defines the title of the dialog tab. This key is
EVALUATED by SCIL and can contain variables
expansions.
471
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Key Meaning
PRELOAD This key defines a function which is executed
before the tab loading is started. It can be used
to initialize global variables needed by the
notebook page's init method. If STATUS after
PRELOAD method is non-zero, the tab loading
is skipped.
POSTLOAD The function defined in this method is EVALU-
ATED and executed after the tab is successfully
loaded. In case the STATUS after the tabs
LOAD call is non-zero POSTLOAD method is
not executed.
ONSELECT The function in this key is EVALUATED and
executed every time user selects the tab in
question.
This chapter lists the predefined tab types and the related configuration settings.
General table
With general table, is possible to show information from MicroSCADA base system or
file system in a table view.
OBJECT = GEN_TABLE in tab definition
Table 18.54: Keys for general table
Key Meaning
ATTRIBUTES Values to show in the table. This vector specifies
the attributes to be added to the table. Either
objects from MicroSCADA or file system.
SOURCE Vector with the equal length as ATTRIBUTES
vector. Specifies where the value in question is
searched from. Possible values are "SYS",
"FILE" or "STATIC". Static definition only dis-
ables the variable expansion that is done with
the SYS type.
VISIBILITY Similar visibility vector as for Object type. Vector
defines the minimum authorization level for
corresponding attribute to be shown.
ATTRTITLES Attribute name or description to be shown in the
left column of table. This is key is optional and
if it is missing SCIL function APPLICATION_OB-
JECT_INFO is attempted. In case the value of
an element is "", the same SCIL function is used.
If the function fails to provide a name for the at-
tribute, the attribute itself is shown.
472
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Key Meaning
UPDATERATE How often the table is refreshed. Value is in
seconds. Missing key or 0 means that the table
is only refreshed when the dialog is opened.
FILEx This key has to be referenced from ATTRIB-
UTES key. It defines the file which is read.
FILEx_PRE This key defines a callback function which is
called every time the value of FILEx is about to
be refreshed. It is not recommended to call ex-
ternal programs whose execution takes more
than the update rate, as this would render the
dialog unusable.
FILEx_POST This key defines the callback, which is called
after the file value has been refreshed.
COLSEPARATOR Key defines the separator character used for
splitting the file input into a vector. Key must be
single character (suitable for SCIL function
SEPARATE). If not defined, " " if used.
EVENT_UPDATE Key defines a vector of process objects whose
update causes the table to be refreshed. Re-
fresh is similar that is done with UPDATERATE,
but is event based instead time based. If more
than one PO listed in the key is refreshed simul-
taneously, each update causes the table to be
refreshed.
Force takeover
With the Force takeover tab, it is possible to initiate take over in Hot Stand-By system.
OBJECT = FORCE_TAKEOVER in tab definition
This tab has no specific configuration options.
473
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Device control
With the Device control tab, it is possible to set station in use/out of use, send general
interrogation for station and send time synchronization command to the station.
OBJECT = DEV_CTRL in tab definition
Table 18.56: Keys for Device control
Key Meaning
STATION_CONTROL Defines the minimum authorization level re-
quired in SUPERVISION group to control the
station.
GI_CONTROL Defines the minimum authorization level re-
quired to send GI command.
SYNC_CONTROL Defines the minimum authorization level re-
quired to send Time Sync command to the
device.
GICALLBACK In case there is a need for GI for station types
not supported by default implementation, this
key can define a vector which will implement
the GI
TIMESYNCCALLBACK In case there is a need for time sync for time
sync commands for unsupported station types,
this key should define the vector which will im-
plement the command.
Alarms tab
Shows the alarm states under one process object group (LN) and has possibility to
acknowledge all or selected alarms
OBJECT = ALARMS in tab definition
Table 18.57: Keys for Alarms
Key Meaning
LOGICALNAME Overrides the logical name where alarm
statuses are fetched. Defaults to LN defined in
the symbol.
Diagnostic counters
It is possible to load Diagnostic counters from System Configuration Tool for Device
and Line diagnostics by specifying a VSO as STOOL/SYSCONF.VSO and Object as
STATION_DIAGNOSTIC_COUNTERS (for station) or LINE_DIAGNOSTIC
COUNTERS (for lines).
This tab has no specific configuration options.
474
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
This section describes the structure of the SSS control dialog. Files will be located under
System Tools in /STOOL/SUPERV folder.
Table 18.58: SSS Control dialog related files
File Functionality
SSS_CTRLDLG.VSO Main Visual SCIL dialog. Contains most of the
implementation.
SSS_CTRLDLG.SCL Contains the help functions used and called
from application specific ini files. Functions such
as GET_NODE_LINE_NUMBERS,
LIN_DIAG_PRELOAD and LIN_DIAG_POST-
LOAD are implemented in this file and called
from ini file with DO(READ_TEXT … statement.
It is not recommended to customize this file in
projects, but instead define a project specific
SCL file which is called similarly from the ini-file.
SSS_CTRLDLG.INI Default dialog configuration template included
in the product. This file is copied to APL\SU-
PERV during SSS initialization.
475
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
476
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
This section describes the elements and functions of user management. The authorization
level for User Management tool is System manager (5).
With the User Management Tool it is possible to:
1. Add and remove users
2. Define users properties and roles
3. Set users default role
4. Reset users password
5. Define Groups and Roles
6. Define Password policy
7. Define Timeouts for Monitor Pro
19.1 Users
In the Users leaf it is possible to:
1. Add users
2. Remove users
3. Set user properties
4. Define users roles
477
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
19.1.1 Properties
Disabled
A user can be temporarily disabled. This means that user cannot log in to application
while being disabled. Disabled user is shown with red color.
Language
The language, that is used for the user after login, can be selected from the available
languages in the system.
19.1.2 Roles
User can have more than one role. Default role is shown as green. If user has more than
one role, the role is selected during the login. The access rights for the role are configured
in Groups and Roles leaf.
To change Properties or Roles of the user, double click the cell in the table. Click OK
or Apply to save the changes.
To add a user click the Add User button. In Add User dialog define the following
attributes:
1. User name. User name can be any valid file name.
2. Copy data from User. You can copy Properties and Roles settings from another user.
3. Copy Folders from user. You can copy Monitor Pro and Display Builder layout and
configuration settings.
4. Password. Password must be given according to Password Policy settings.
5. User must change password at first login.
478
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
To remove a user, select the user from row heading, click Remove User button and
confirm operation.
To set default role for the user, select the user from row heading and click Set Default
Role button. Save changes by clicking OK or Apply.
To reset the users password, select the user from row heading and click Reset Password.
479
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
There are the following default roles that cannot be removed or renamed.
Table 19.1: Roles
Role Meaning Remarks
Viewer Role to be assigned to users IEC 62351-8 standard role.
needing access permissions
only allowing read-only use of
the product.
Operator Role to be assigned to users IEC 62351-8 standard role.
needing access permissions
allowing to operate the primary
equipment via the product.
Engineer Role to be assigned to users IEC 62351-8 standard role.
needing access permissions
allowing the modification and
installation of applications con-
figuration parameters
480
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
The access rights of the role can be fine-tuned by setting the authorization level for the
groups. The following access levels can be defined:
Table 19.2: Authorization levels
Authorization level Meaning
- 1 - Reserved Reserved for future.
0 - View The operator is allowed to view the functions,
but not to make control operations.
1 - Control The operator is allowed to make control opera-
tions, for example to control switching devices
with limited rights.
2 - Engineering All rights are granted, excluding user manage-
ment, which can be performed only by the sys-
tem manager.
3 - Reserved Reserved for future.
4 - Reserved Reserved for future.
5 - System Manager The user with this authority level is the system
manager. All rights are granted, including the
rights to add and remove users and authoriza-
tion groups. The user who first logs into an ap-
plication is the system manager. Thus, each
application has only one system manager.
481
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
To add an authorization group, click Add Group and select predefined group or type in
your own group.
To remove a group, select group from row heading and click Remove Group and confirm
operation. GENERAL group cannot be removed.
To add a role click Add Role. Copy data from Role copies the authorization levels from
selected role to the new one.
To remove a role, select the role from column heading, click Remove Role and confirm
operation.
To rename a role, select the role from column heading, click Rename Role, type in the
new role name and confirm operation.
482
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
To define the password policy enable policy, set the policy settings and click OK or
Apply.
19.4 Timeouts
You can define timeouts for a role. These timeouts are used in Monitor Pro. 0 means
that timeout is not in use.
Monitor Pro Session Timeout starts to run after login. If Monitor Pro Session Timeout
is defined, user is logged out after the specified time has elapsed.
If Monitor Pro inactivity time is defined, user is logged out if there are no user input,
like cursor movement, within the specified time.
483
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Define the timeouts for different roles in the table and click OK or Apply.
484
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
20 SYS600 Historian
SYS600 Historian can be used for creating measurement reports, charting, and data
analysis. SYS600 Historian works well with large applications and high load. Arbitrary
many signals can be logged to SYS600 Historian.
Any binary input (BI), binary output (BO), double binary input (DB), digital input (DI),
digital output (DO), analog input (AI), analog output (AO), and pulse counter (PC) signal
or data objects with numerical value can be connected to SYS600 Historian. When a
signal is connected to SYS600 Historian, the values updated to the signal are automatically
sent to the SYS600 Historian. The data collected by SYS600 Historian can be further
processed using aggregate functions. For example, averages, maximums, and minimums
can be calculated.
Many SYS600 systems can log to same SYS600 Historian and a single SYS600 system
can log to multiple SYS600 Historians. SYS600 systems can be either stand alone or
HSB systems. SYS600 Historian installation is referenced using a Database Location.
Location is an URL with following theh form tcp://<host-name>/<database-name>.
Each logged process object and data object has a Tag and a Variable in SYS600 Historian.
These are created automatically when Logging objects are created. Tags and Variables
contain configuration information about the signal. Relevant fields are filled and updated
automatically.
485
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
a. List the used aggregate functions. The available aggregate can be checked from
the SYS600 Historian using Vtrin user interface (Maintenance > System >
HistoryLists > History Collection Templates).
b. Set In Use (IU).
c. click OK.
4. Create an OBJECT object.
a. Connect the signals to logging profiles. Click Add... > Select... and choose the
signals to be connected.
b. Set In Use (IU).
c. click OK.
Now the Tags and Variables should be created automatically and the values should be
automatically logged to the SYS600 Historian. The instructions above used the default
settings for all objects. For additional configuration parameters, refer to the Application
Object manual.
For pulse counter objects, two aggregate variables are created. The name of the Variable
for pulse value in engineering units is prefixed with E and the name of the Variable for
time derivation is prefixed with D.
The bit count (BC) and pulse scaling (SC) attributes must be
properly defined for pulse counter signals to work correctly
with SYS600 Historian.
SYS600 generates a name for each Tag. If there already is a tag that has a name that
conflicts with the generated name, the tag gets a new name. The SYS600 generated name
is a proposed name. The actual name of the tag is stored in the GN attribute of the process
object or the data object.
Some attributes are defined by patterns. Patterns are defined in a DATABASE logging
object. Patterns are statements of the SCIL Data Derivation Language (SDDL). The
description of the SDDL can be found in Programming Language SCIL manual.
Table 20.1: The automatically filled fields of a Tag
Field Name Description Source
Name The unique name of the Tag. Based on the proposed name
attribute.
External Name Name of the tag in an external SCIL name of the object. E.g.
system. ESTH01_Q0:P10.
Proposed Name Name of the Tag generated by Generated as defined by the
SYS600. NP or ND attribute in DATA-
BASE object.
Equipment Path A path used for defining the Generated as defined by the
Tags location in the equipment EP or ED attribute in DATA-
model. Comparable to the OI BASE object.
of the process objects.
486
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
The automatically filled fields in Variables and Tags are described in Table 20.1 and
Table 20.2.
When the signals are unconnected from a logging object, the corresponding tags are not
removed from the SYS600 Historian. Delete unused tags by clicking the Synchronize
Tags button in DATABASE logging object.
Logging objects cannot be removed if there are connections to other objects. To remove
a logging object with profile OBJECT, open it using Object Navigator. Select all
connected objects and disconnect them. Then, the logging object can be removed from
the Object Navigator main window (Main menu > Edit > Delete).
To remove a logging object with profile DATABASE or HISTORY, the user must first
either delete all connected logging objects with profile OBJECT or disconnect them. To
487
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
disconnect, open the logging object with profile OBJECT and remove the corresponding
row from the storage attribute (ST).
20.3 Monitoring
The system has several diagnostics attributes. Each DATABASE object has an Object
Status (OS) attribute. This attribute contains the state of the connection between SYS600
and SYS600 Historian. DATABASE objects also contain a diagnostics counter attribute
(DC). Object statuses and diagnostics counters are listed in Application Object manual.
SYS600 also generates application events when the status of the connection is changed.
The events are emitted to the APL_EVENT channel. The list of emitted events can be
found in the Application Object manual.
488
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
21 Integrating PCM600
The PCM600 relay symbols can be added to a Process Display from the Object Browser
of the Display Builder.
Object Browser displays the relay symbols if PCM600 is installed and the relay objects
exist in the PCM600 projects. For more information about installing PCM600, see the
PCM600 Installation and Commissioning Manual.
To install the PCM600 relay symbols:
1. Install both SYS600 and PCM600.
2. Select Actions > Object Browser to open the Object Browser of the Display Builder.
3. Select PCM600 Projects from the Application drop-down menu.
4. Click Select... to display the relay tools in the Object Browser tree.
5. Drag IED to the drawing area to create a symbol in a Process Display.
For more information about using Object Browser, see SYS600 Process Display Design.
If the user management is in use in PCM600, the user name and password must be the
same in both SYS600 and PCM600 in order to be able to open the relay symbols in
Object Browser. If the user names and passwords differ from each other, installing the
relay symbols and opening the relay tools is not possible in Monitor Pro and an error
message is displayed.
For more information about using the PCM600 tools, see PCM600 Help.
489
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
/ListInstances
/Start <instanceName> [<user> [<password>]]
/Stop <instanceName>
/IsStarted <instanceName>
Example
set inst=an_instance_name
set user=a_user_name
set pwd=user_password_in_PCM
set project=a_project_name
490
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
;list all child objects of the given object in the PLANT structure
491
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
22 Authorization
User names are associated with a certain user profile that restricts the user’s access rights,
for example to access Process Displays. The authorization levels are defined in Table 22.1.
Table 22.1: Authorization levels
Authorization Description
level
0 - View The operator is allowed to view the functions, but not to make control operations.
1 - Control The operator is allowed to make control operations, for example to control
switching devices with limited rights.
2 - Engineering All rights are granted, excluding user management, which can be performed
only by the system manager.
5 - System The user with this authority level is the system manager. All rights are granted,
Management including the rights to add and remove users and authorization groups. The user
who first logs into an application is the system manager. Thus, each application
has only one system manager.
The system administrator can restrict a user's access rights either by defining an
authorization level for each object in a Process Display or by defining shortcuts for
Process Displays.
It is possible to define the authorization level for each object in a Process Display. The
authorization level for the object is defined in Display Builder. Right-click the object
and select Tool Launcher.... In the Tool Launcher dialog, select the Required check box
and define the authorization level.
The user's access rights can be restricted also by defining the shortcuts for the Process
Displays. The system manager can define that the user can access Process Displays only
through the shortcuts and prevent the use of the menu commands. For example, the user
cannot open a Process Display by selecting Main > Open. The shortcuts are displayed
on the toolbar of each Process Display. For more information about defining shortcuts,
see Section 16.16 Defining shortcuts to Process Displays.
The user is automatically logged off if Monitor Pro is not used when a certain time has
elapsed since the last login.
If the user has the access rights for the appropriate authorization level, the user can
configure the authorization group and the level which is needed for using certain menu
commands and toolbar buttons. The menu commands and toolbar buttons are disabled
if the user is not authorized to use them. The configurable authorization level definitions
override the default authorization group in Monitor Pro. If some menu commands are
disabled due to the authorization group, default values in the user management. It is
possible to override the default values with the configurable authorization level definitions.
The authorization levels can be managed in the customization mode in Monitor Pro. For
example, right-click the menu or the toolbar button and select Authorize. For more
information about the customization mode, see Section 16.3 Customize dialog.
493
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
If a standard function does not have an authorization group defined, or the group is not
included in the authorization definitions, a General authorization level from a predefined
group is used. The authorization group GENERAL cannot be removed.
Only the system manager can add and remove users and grant access rights to the users.
The password is selected and can be changed by the user exclusively. Password is changed
in the Change Password dialog.
494
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Figure 22.1: Setting the authorization level for the menu command
495
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Figure 22.2: Setting the authorization level for the submenu command
The following authorization groups define the authorization levels for customizing menus,
toolbars and different displays.
PRO_MENU_CUSTOMIZE
Defines the required authorization level for customizing menus. The following operations
are allowed for the PRO_MENU_CUSTOMIZE group:
• Using menu shortcut keys for copying and moving menu commands without opening
the Customize dialog.
- To move a menu command, press down the ALT key and drag the menu
command between menus.
- To copy a menu command, press down the CTRL key and drag the menu
command between menus.
• Using the menu commands in the Customize dialog.
• Using the following menu operations:
- Tools > Set Font.
496
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
PRO_TOOLBAR_CUSTOMIZE
Defines the required authorization level for customizing toolbars. The following operations
are allowed for the PRO_TOOLBAR_CUSTOMIZE group:
• Using toolbar shortcut keys for copying and moving toolbar buttons without opening
the Customize dialog.
- To move the toolbar button, press down the ALT key and drag the toolbar button
between toolbars.
- To copy a menu command, press down the CTRL key and drag the menu
command between menus.
• Using the menu commands in the Customize dialog
• Locking and unlocking toolbars (View > Lock Toolbars).
• Hiding and showing toolbars.
- Right-click a toolbar and select or clear a checked commad from the context
menu.
• Using the following menu operations:
- Tools > Set Font.
- Tools > Reset > Reset Toolbars.
- Tools > Reset > Reset Layout.
- Tools > Reset > Reset Localizations.
If the current authorization group is not found, the group GENERAL is used. To customize
toolbars, the authorization level 1 (Control) is required.
PRO_ALARMS_CUSTOMIZE
Defines the required authorization level for customizing Alarm Displays.
If the current authorization group is not found, the authorization group GENERAL is
used. The authorization level information for Alarm Displays is listed as follows:
Authorization levels 0 (View) and 1 (Control)
• Read-only access rights for application specific settings
• Read-only access rights for layout specific settings
• Read-only access rights for color specific settings
• Read/write access rights for user specific settings
• Read/write access rights for user specific layout settings
• Read/write access rights for user specific color settings
Authorization levels 2 (Engineering) and 5 (System Management)
• Read/write access rights for application specific settings
• Read/write access rights for layout specific settings
497
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
PRO_EVENTS_CUSTOMIZE
Defines the required authorization level for customizing Event Display.
If the current authorization group is not found, the authorization group GENERAL is
used. The authorization level information for Event Displays is listed as follows:
Authorization levels 0 (View) and 1 (Control)
• Read-only access rights for application specific settings
• Read-only access rights for layout specific settings
• Read-only access rights for color specific settings
• Read/write access rights for user specific settings
• Read/write access rights for user specific layout settings
• Read/write access rights for user specific color settings
Authorization levels 2 (Engineering) and 5 (System Management)
• Read/write access rights for application specific settings
• Read/write access rights for layout specific settings
• Read/write access rights for color specific settings
• Read/write access rights for user specific settings
• Read/write access rights for user specific layout settings
• Read/write access rights for user specific color settings
PRO_BLOCKINGS_CUSTOMIZE
Defines the required authorization level required for customizing Blocking Display.
If the current authorization group is not found, the authorization group GENERAL is
used. The authorization level information for Blocking Displays is listed as follows:
Authorization levels 0 (View) and 1 (Control)
• Read-only access rights for application specific settings
• Read-only access rights for color specific settings
• Read/write access rights for user specific settings
• Read/write access rights for user specific color settings
Authorization levels 2 (Engineering) and 5 (System Management)
• Read/write access rights for application specific settings
• Read/write access rights for color specific settings
• Read/write access rights for user specific settings
• Read/write access rights for user specific color settings
498
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
PRO_TRENDS_CUSTOMIZE
Defines the required authorization level for customizing Trends. The following operations
are allowed for the PRO_TRENDS_CUSTOMIZE group:
• Customizing the Trend display in a graphical view mode by using the Graph
Properties dialog.
- Right-click the display and select Graph Properties to open the dialog.
If the current authorization group is not found, the authorization group GENERAL is
used. To customize Trends, the authorization level 1 (Control) is required.
PRO_REPORTS_CUSTOMIZE
Defines the required authorization level for customizing Measurement Reports. The
following operations are allowed for the group PRO_REPORTS_CUSTOMIZE:
• Customizing the Measurement Reports display in a graphical view mode by using
the Graph Properties dialog.
- Right-click the display and select Graph Properties to open the dialog.
If the current authorization group is not found, the authorization group GENERAL is
used. To customize Measurement Reports, the authorization level 1 (Control) is required.
The following authorization groups defines the authorization levels for controlling
devices.
ADVANCED_VIEW_AUTHORITY
Used to lock the advanced view for not authorized user.
MV_CONTROL
MV_CONTROL is the default authorization group for Power Process library control
dialogs. Authorization group can be configured in Standard Function Tool when installing
objects.
FORCED_OPERATION_AUTHORITY
Define the required authorization level for using the forced operation function in Power
Process library control dialogs.
SIMULATION_HANDLING
Block unauthorised access to the simulation function in Control Dialog.
499
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
The following authorization groups define the authorization levels for configuring for
example measurement reports, trends, alarms, events and blockings.
ALARM_HANDLING
Defines the required authorization level for handling alarms.
If the current authorization group is not found, the authorization group GENERAL is
used. The authorization level information for controlling devices is listed as follows:
Authorization level 0 (View)
• Read-only access rights for application specific filter settings
• Read/write access rights for user specific filter settings
Authorization level 1 (Control)
• Read-only access rights for application specific filter settings
• Read/write access rights for user specific filter settings
• Read/write access rights for acknowledgement
Authorization levels 2 (Engineering) and 5 (System Management)
• Read/write access rights for application specific filter settings
• Read/write access rights for user specific filter settings
• Read/write access rights for acknowledgement
BLOCKING_HANDLING
Defines the required authorization level for handling blockings.
If the current authorization group is not found, the authorization group GENERAL is
used. The authorization level information for controlling devices is listed as follows:
Authorization level 0 (View)
• It is not possible to change the blocking state.
Authorization level 1 (Control)
• It is possible to change the blocking state.
Authorization levels 2 (Engineering) and 5 (System Management)
• It is possible to change the blocking state.
EVENT_HANDLING
Defines the required authorization level for handling events.
If the current authorization group is not found, the authorization group GENERAL is
used. The authorization level information for controlling devices is listed as follows:
500
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
GENERAL
The default authorization group. All the tools and standard picture functions configured
to the group will automatically start using the definitions of the GENERAL group.
MV_RELAYS
Used in LIB5xx based relay tools to prevent e.g. unauthorised actions like write/change
parameter.
PRO_AUTHORIZE
Defines the required authorization level for authorizing menu commands and toolbar
buttons.
If the current authorization group is not found, the authorization group GENERAL is
used. To configure the authorization levels for specific commands, the authorization
level 2 (Engineering) is required.
PRO_CONFIG_COMMANDS
Defines the required authorization level for configuring custom commands to menu
commands and toolbar buttons.
If the current authorization group is not found, the authorization group GENERAL is
used. To configure the custom commands, the authorization level 2 (Engineering) is
required.
PRO_MANAGE_LAYOUTS
Defines the required authorization level for managing layouts in Monitor Pro. The
following operations are covered:
• Configuring the visibility of menus or toolbars in Monitor Pro
• Customizing menus and toolbars with certain visibility in Monitor Pro
501
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Visibility means project, application or user one. Menus and toolbars with:
• Project visibility are shown in all application for all users
• Application visibility are shown in certain application for all users
• User visibility are shown for certain user
PRO_NOTEMARKER_HANDLING
Defines the required authorization level for handling Process Display Note
If the current authorization group is not found, the authorization group GENERAL is
used. To handle Process Display Notes, the authorization level 1 (Control) is required.
Process Display Notes can be viewed with the authorization level 0 (View).
PRO_OPTIONS_HANDLING
Defines the authorization level 2 (Engineering) for making changes in the Application
Settings dialog. If the current authorization group is not found, the authorization group
GENERAL is used.
PRO_TOPOLOGY_HANDLING
Defines the required authorization level for handling network topology coloring. The
following operations are allowed for the PRO_TOPOLOGY_HANDLING group:
• Network topology coloring in the engineering mode.
• Select Tools > System Tools > Network Topology Coloring to open the network
topology coloring.
• Network topology coloring in the non-engineering mode (read only).
If the current authorization group is not found, the authorization group GENERAL is
used. To handle network topology coloring, the authorization level 1 (Control) is required.
PRO_ZOOMAREA_HANDLING
Defines the required authorization level for handling zoom area definitions.
Editing, deleting or adding the zoom area definitions in the Save/Restore Zoom dialog
are allowed for the PRO_ZOOMAREA_HANDLING group.
If the current authorization group is not found, the authorization group GENERAL is
used. To handle zoom area definitions, the authorization level 1 (Control) is required.
REPORTS
Defines the required authorization level for handling Measurement Reports.
• Editing application specific preconfigurations.
• Showing or hiding the measurement reports by using the Measurement dialog.
502
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
If the current authorization group is not found, the authorization group GENERAL is
used. To handle Measurement Reports, the authorization level 1 (Control) is required.
To edit the application specific preconfigurations, the level 2 (Engineering) is required.
SUPERVISION
Used in System Self Supervision control dialog.
TOOLS
Defines the required authorization level for tools to cover appropriate functionality. Used
for example in Display Builder and Tool Manager.
TREND_HANDLING
Defines the required authorization level for handling Trends:
• Editing Trend Basket
• Editing application specific preconfigurations
• Trend Curves dialog modifications
If the current authorization group is not found, the authorization group GENERAL is
used. To handle trends, the authorization level 1 (Control) is required. To edit the
application specific preconfigurations, the level 2 (Engineering) is required.
503
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
505
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
24 Tool Manager
The primary use of the Tool Manager is to start tools of various categories. The Tool
Manager is divided into several pages with tool icons. The user is allowed to add both
pages and tools. The geometry of the Tool Manager is saved at the end of a session.
From an application, the Tool Manager is opened by choosing ToolManager from the
Tools & Engineering Tools menu in Monitor Pro.
Figure 24.1: User Interface page. Each page in the Tool Manager represents a category of tools
24.1 General
Tool types
The Tool Manager handles three kinds of tools: services, system tools and object tools.
Services are automatically started when the Tool Manager is started. Services provide
other tools with functionality when they are used. System tools are used when the SYS
environment and its applications are being maintained. Object tools use services provided
by the project database management service, which is not shown in the standard version.
It is part of the CAP package.
The toolbar
The toolbar functions are listed in Figure 24.2.
507
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Tool pages
Tool pages can be added to the Tool Manager by choosing Insert Tool Page from the
Edit menu. Tool pages cannot be deleted before all tools are removed from the page.
The tool page title can be changed by choosing Tool Page Properties from the Edit
menu.
24.2 Tools
This section describes how to manage tools using Visual SCIL. The pictures are managed
the same way, except adding pictures is done differently.
To add tools:
1. Choose Insert Tool from the Edit menu.
508
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Figure 24.3: The tool to be added to the Tool Manager can be selected from the Installed
Tools List
2. Select the tool that should be added from the list. The list is retrieved from the tool
registry. Add unregistered tools by clicking the User Defined button.
3. Click OK.
Adding a user defined tool is done in the dialog box shown in Figure 24.4.
509
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
1. In the General page, enter the tool title and its associated Visual SCIL Object
resource filename. Use the browse facility if needed.
a. Following the same procedure you can add an icon referring to a picture
anywhere in the file system. Enter picture title and complete filename or use
the Browse PIC button to locate the picture file.
2. In the Tool Options page, type additional information like the Tool Type (service,
sys or obj, default=sys), Dialog name (default=MAIN), Method to run when loading
the dialog (default=none), Exclusive state (0 or 1, default=0) and the Default Path
for the tool. If the VSO contains a VS_IMAGE named PRODUCT_ICON_M, it is
shown as the icon by default.
• The specified method can also have parameters, for example:
MyMethod("PAGEVIEW", 5)
Tools can be moved from one tool page to another. To move a tool:
1. Select the tool.
2. Choose Move Tool from the Edit menu. The Move Tool dialog appears.
Figure 24.5: Dialog for moving a tool icon from one page to another.
510
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Figure 24.6: General Page where you determine the tools to be inserted and its properties
2. Type Product ID and associated Tool Registry file for the tool in the General page.
Tool Manager locates tools by their product IDs from either the Sys_Tool or
Cmd_Tool logical paths. The settings file contains detailed information about the
tool.
• The Tool Settings File page shows information from the tool's settings file.
Figure 24.7. These settings cannot be changed from the Tool Manager.
511
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
• The User Settings page has the same text boxes as in the Insert Tool dialog box,
see Figure 24.8. In the User Settings page of this dialog, it is possible to override
the settings in the tool's settings file. For example, it is possible to override the
Exclusive state by setting it to its opposite value. Change the settings if needed.
3. Click OK.
512
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Tools can be deleted by choosing Delete Tool from the Edit menu. Deleting a tool does
not affect the Tool Manager registry of installed tools, only the active user's tool
collection.
Figure 24.10: The Font Properties dialog which allows user to set Global Font
Check the Font... check box to enable the Set Font button, which allows to choose any
of the listed fonts.
513
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Figure 24.11: The Font Chooser dialog that allows user to select Fonts
When the font is set, the following tools will be launched with the selected font.
• Object Navigator
• NT Manager
• Picture Editor
• Import/Export Tool
• Search Tool
• SCIL Editor
• Test dialog
• License Tool.
• DMT
For the above mentioned tools when the Font is set globally
and if fonts are not set specifically for each of these tools, then
it will be launched with the Global Font that is set.
514
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
24.6 Pictures
Adding a picture icon into the Tool Manager:
1. Choose Insert Tool from the Edit menu.
2. Click User Defined button.
3. Click Browse PIC.
4. Select a file from the list of picture files.
5. Click OK in the Tool Properties dialog.
Otherwise, pictures are handled in the Tool Manager the same way as tools made using
Visual SCIL.
515
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
25 Terminology
Term Description
Action tool Used to perform an action within the application. An action tool can be a menu
command or a toolbar tool. A tool can be any of the following types: button, drop-
down button, textbox, combo box, label, separator.
Docking area Monitor Pro defines four docking areas on the top, bottom, right and left edges of
the control's dialog. It also defines an area for free position (floating).
Context The context menu appears when you right-click for example a selection, a toolbar,
menu or a taskbar button. It lists commands pertaining only to that screen region or se-
lection.
517
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
26 Abbreviations
Abbreviation Description
CSV Comma delimited text file
HSI Human-System Interface
NCC Network Control Center
DLL Dynamic linking Libraries
NLS National language support
NTC Network Topology Coloring
SA-LIB Power Process Library
SCS Substation Control System
SSS System Self Supervision
VBA Visual BASIC for Applications
519
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
The architecture of NTC is changed in SYS600 9.3 FP1. From now on, the calculation
is done in the base system and the result of topological state of the network is stored in
the process database.
Due to this change, some manual changes regarding NTC are required when the
application is migrated to SYS600 9.3 FP1 or later.
521
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
522
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Figure A.1: Error message due to switch device symbol connected twice to same process
object in one display
523
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
The Topology Models dialog shows the reasons for the messages and proposes
actions for fixing the errors and warnings. The user can zoom to the object causing
the error or warning also by right-clicking it in the object tree or in the Errors or
Warnings tab.
6. Click Save.
Some errors are discovered during saving. If errors are detected at this phase, repeat
steps 5 and 6.
The rules for building NTC are stricter in 9.3 FP1 than in
previous versions, which may result in a number of errors
and warnings when NTC is generated.
Fix all errors and check all warnings before saving the
topology.
The new NTC algorithm allows that switch device can be in the same display only once.
If there were duplicate objects in the display, remove them.
Draw breaker with truck so that breaker is in the middle and truck symbols are directly
connected to it on both sides.
The line indicator can also feed Uncertain color. During the first startup after installing
9.3 FP1 or later, line indicators are turned to manual state automatically if they are
configured so that the line indicator is colored by Busbar Coloring or manually.
There may be a configuration error indicating that line indicator(s) are colored by DMS
600 although it should be colored by Busbar Coloring. In such a case, the line indicator(s)
(index 10) needs to be turned to manual state (SS=1).
524
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
In SYS600 9.3 FP1 or later, the line indicator does not contain Topology color data
variable anymore. Also, the topology color data variable of line segment and generator
symbol is now used by the NTC. If some customer specific solution was created based
on this, it needs to be recreated.
525
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
This chapter provides information on the migration tools needed during the application
design when the existing LIB 5xx based applications are migrated to use the Monitor
Pro Process Displays.
Usually, an existing application contains a set of pictures and their related process database
built with LIB 5xx application library. SYS600 contains the engineering tools to migrate
these applications in a straightforward way. During the migration, the picture configuration
information from the existing pictures is copied to the process database. The Monitor
Pro user interface uses the copied information. The connection between the existing
process objects of the migrated application and the graphical symbols of the Process
Displays is made by dragging and dropping the complete objects during the single line
diagram engineering with Display Builder.
PDB
Another migration tool is needed for the event handling concept introduced in SYS600.
In this concept, the Event Objects are displayed in the application's process database.
Another event architecture has been used with the existing application, which database
has been built with LIB5xx application library and contains the LIB 500 Event List. To
provide a continuum from the existing LIB 500 Event List to the SYS600 Event List, a
migration tool to migrate the existing application to the new event handling concept is
introduced. The following figure describes both the event handling processes and the
role of the migration tool.
527
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
528
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
process database, these parameters need to be extracted from the pictures and made
available for the new control dialogs.
The Configuration Data Export tool is used for this purpose. It extracts the needed
information from the pictures and stores it to the process database, from where it is
available for the Control dialogs of Power Process library. The configuration of the
Measurement Reports is extracted to a separate files, to directory sc/apl/'apl
name'/reports/preconf.
The Configuration Data Export tool offers the means to reuse the pictures and process
database built with LIB 5xx application library when an application is upgraded to the
Monitor Pro user interface. First, Configuration Data Export can separate the configuration
of the picture functions from the SCIL picture. Next, the tool copies the information to
the process database. In case of Measurement Reports, tool creates the external
configuration data files that are saved in apl\apl name\REPORTS\PRECONF. The Process
Displays and measurement report displays in Monitor Pro can utilize the exported
configuration data. For more information on the picture engineering, see SYS600 Process
Display Design.
To start the Configuration Data Export tool, select Miscellaneous > Tool Manager >
DAT Export.
529
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Main view
The Source directory shows where the SCIL pictures are located. The destination directory
is always the /POBJCONF directory under the application. When the Override existing
configuration option is checked, the configuration data is recreated, if it already exists.
The SCIL pictures found from the source directory are listed in the Pictures tab.
B.1.1.2 Options
The purpose of the Export Options is to filter out the picture functions that are not related
to the process graphics. These kinds of functions are, for example, components that are
used for building the network topology coloring into the LIB 500 single line diagrams.
In this way, the amount of the data files can be reduced. Also, by having this kind of
filter, the creation of unnecessary configuration data will be prevented.
530
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
531
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Format pictures are still needed to print the events to the Event
Printer. Due to this, the format picture information in process
database is not modified during the conversion.
Start Event Conversion Tool from Tool Manager. Select the Miscellaneous tab and click
Event Conversion.
532
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
533
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
Modified Process Objects tab shows the list of all process objects that are successfully
connected to event objects.
The conversion can be done by clicking the Search... button, which looks for the known
conventions within the application. Clicking the Modify DB button makes the changes
to the process database. If the user does not want to examine the event conventions
beforehand, the Modify DB button can be clicked directly.
When the conversion is ready, the result can be saved to a log file. The log file contains
all the data found from three tabs in the Event Conversion Tool.
534
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
In this example, the following definitions are made in object type for switch device.
• Indexes for controlling are changed to 210 (Select), 211 (Execute), 212 (Cancel)
• Control methods (METHOD_OPEN_SELECT … ) are used for device specific
control actions
• METHOD_INIT_SIGNAL is utilized for creating process objects for controlling
• METHOD_CUSTOMIZE_OBJECTS is used for changing certain attribute values
of process objects
• METHOD_GET_INDICATIONS is used for converting the value of switch state
indication, interlocking signals, bay L/R indication and synchrocheck indication.
• Interlocking and synchrocheck bypass is enabled in control dialog
-;
-;
INDICATION_DB_IX=10,-
OPEN_CMD_IX=210,-
CLOSE_CMD_IX=210,-
EXECUTE_CMD_IX=211,-
535
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
CANCEL_CMD_IX=212,-
EXECUTE_OPEN_CMD_IX=211,-
EXECUTE_CLOSE_CMD_IX=211,-
EXT_CNTR_BLK_IX=15,-
OPEN_ILOCK_IX=16,-
CLOSE_ILOCK_IX=17,-
ILOCK_CAUSE_IX=18,-
SEL_ON_MON_IX=19,-
CMD_EVENT_IX=20,-
AUX_PLUG_IX=21,-
SYN_IND_IX=22,-
-;
-;
METHOD_OPEN_SELECT=VECTOR("#DO READ_TEXT(""SAGR_OBJT/CMD_SELECT.TXT"")"),-
METHOD_CLOSE_SELECT=VECTOR("#DO READ_TEXT(""SAGR_OBJT/CMD_SELECT.TXT"")"),-
METHOD_OPEN_EXECUTE=VECTOR("#DO READ_TEXT(""SAGR_OBJT/CMD_EXECUTE.TXT"")"),-
METHOD_CLOSE_EXECUTE=VECTOR("#DO READ_TEXT(""SAGR_OBJT/CMD_EXECUTE.TXT"")"),-
METHOD_CANCEL=VECTOR("#DO READ_TEXT(""SAGR_OBJT/CMD_CANCEL.TXT"")"),-
-;
-;
METHOD_GET_INDICATIONS=VECTOR("#DO READ_TEXT(""SAGR_OBJT/GET_INDICATIONS.TXT"")"),-
-;
-;
METHOD_INIT_SIGNALS=VECTOR("#DO READ_TEXT(""SAGR_OBJT/CREATE_PO.POT"")"),-
METHOD_CUSTOMIZE_OBJECTS=VECTOR(-
"#LOOP_WITH I = 1 .. LENGTH(%OBJECTS)",-
"@OBJECT=%OBJECTS(%I)",-
"@LN=%OBJECT.LN",-
"@IX=%OBJECT.IX",-
"#CASE %IX",-
536
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
"#CASE_END",-
"#LOOP_END"),-
-;
-;
SYNCHROCHECK_BYPASS = TRUE,-
INTERLOCKING_BYPASS = TRUE,-
SA_LIB_INDEXES = "20,19,210")
@v_Object_Type_Process_Objects = VECTOR(-
LIST(-
IX = 210,- ;index =
537
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
information
LIST(-
IX = 211,- ;index =
538
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
LIST(-
IX = 212,- ;index =
#return %v_Object_Type_Process_Objects
#BLOCK_END
; %FORCED_OPERATION, boolean
539
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
;---------------------------------------------------------------------------------------------
@NACK = STATUS
#ERROR IGNORE
@SELECT_VALUE = 0
#CASE %FORCED_OPERATION_VALUE
#WHEN 3 @SELECT_VALUE = 10
#WHEN 5 @SELECT_VALUE = 20
#WHEN 7 @SELECT_VALUE = 30
#CASE_END
#BLOCK_END
#BLOCK_END
#ELSE #BLOCK
@SELECT_VALUE = 1
#CASE %FORCED_OPERATION_VALUE
#WHEN 3 @SELECT_VALUE = 11
#WHEN 5 @SELECT_VALUE = 21
#WHEN 7 @SELECT_VALUE = 31
#CASE_END
#BLOCK_END
#BLOCK_END
@NACK = STATUS
CMD_EXECUTE.TXT
; This is example program for Power Process Library switching device execution
service
540
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
; %FORCED_OPERATION, boolean
;---------------------------------------------------------------------------------------------
@NACK = STATUS
#ERROR IGNORE
@EXECUTE_VALUE = 0
#CASE %FORCED_OPERATION_VALUE
#WHEN 3 @EXECUTE_VALUE = 10
#WHEN 5 @EXECUTE_VALUE = 20
#WHEN 7 @EXECUTE_VALUE = 30
#CASE_END
#BLOCK_END
#BLOCK_END
#ELSE #BLOCK
@EXECUTE_VALUE = 1
#CASE %FORCED_OPERATION_VALUE
#WHEN 3 @EXECUTE_VALUE = 11
#WHEN 5 @EXECUTE_VALUE = 21
#WHEN 7 @EXECUTE_VALUE = 31
#CASE_END
#BLOCK_END
#BLOCK_END
@NACK = STATUS
CMD_CANCEL.TXT
541
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
; This is example program for Power Process Library switching device cancel service
;---------------------------------------------------------------------------------------------
@NACK = STATUS
#ERROR IGNORE
#SET 'CANCEL_LN':P'CANCEL_IX' = 1
@NACK = STATUS
#error ignore
#case 'RESULT_LIST:VBAY_LR_OBJECT_LN':POV'RESULT_LIST:VBAY_LR_OBJECT_IX'
542
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
#case_end
#return %RESULT
543
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
Index
BAY_NAME .... 87, 90, 96, 99, 146, 148, 155, 159,
A 1 6 6 – 1 6 7 , 1 8 8
Active tagout ....................................................... 115 Binary Input (BI) .................................................. 167
Add/Edit Tagout dialog ............................... 127, 135 blocking attributes .............................................. 128
ALARMING_STATE_OF_SIGNAL1 ................... 167 Blocking List ....................................................... 141
ALARMING_STATE_OF_SIGNAL’nr’ ................. 196
ALARMING_STATE_OF_SIGNAL’x’ .................. 166 C
Alarm limit ............................................................. 48
APL_TEXT.SDB .................................................. 419 CMD_PARAMETER ................................... 146, 185
Application ............................................................ 43 Configuration
Application language ............................................ 44 Of the station picture function ........................... 83
application objects ................................................ 26 Of the switching device .................................... 99
Application Settings .............................................. 43 Configuration Data Export tool ........................... 529
AR_WITH_MULTIPLE_ CYCLES ....................... 196 configuring complete objects ................................ 25
Attributes .................. 82, 88, 97, 104, 107, 147, 170 Configuring Process Display search .................. 378
Authorization ....................................................... 493 CONTROL_BITS .................................. 96, 100, 192
AUTHORIZATION_GROUP .... 82–83, 87, 90, 96, CONTROL_PULSE_LENGTH ............. 96, 100, 192
100, 146, 148, 156, 159 CONTROL_TYPE ................................ 96, 100, 191
Authorization groups for configuring ................... 500 creating configuration file ..................................... 28
ALARM_HANDLING ...................................... 500 creating display symbols ...................................... 30
BLOCKING_HANDLING ................................ 500 creating graphical interfaces .............................. 233
EVENT_HANDLING ....................................... 500 creating process displays ................................... 233
PRO_AUTHORIZE ......................................... 501 Customization dialog .......................................... 356
PRO_CONFIG_COMMANDS ........................ 501 Commands tab ............................................... 363
PRO_NOTEMARKER_HANDLING ................ 502 Options tab ..................................................... 363
PRO_OPTIONS_HANDLING ................. 501–502 Toolbars tab .................................................... 359
PRO_TOPOLOGY_HANDLING ..................... 502 Customize Search dialog ................................... 379
PRO_ZOOMAREA_HANDLING .................... 502 Customizing search ............................................ 379
REPORTS ...................................... 499, 501–503
TREND_HANDLING ...................................... 503 D
Authorization groups for controlling .................... 499
MV_CONTROL .............................................. 499 Data Objects ....................................................... 292
Authorization groups for customization .............. 496 Default authorization levels ................................ 494
PRO_ALARMS_CUSTOMIZE ........................ 497 DEVICE_NAME .... 96, 99, 146, 148, 155, 159, 166–
PRO_BLOCKINGS_CUSTOMIZE ................. 498 1 6 7 , 1 8 9
PRO_EVENTS_CUSTOMIZE ........................ 498 Dialog Editor ....................................................... 419
PRO_REPORTS_CUSTOMIZE ..................... 499 Display Builder ........................................... 124, 233
PRO_TOOLBAR_CUSTOMIZE ..................... 497 DLL ..................................................................... 420
PRO_TRENDS_CUSTOMIZE ........................ 499 Dynamic Linking Libraries .......................... 420, 431
Authorization level .......................................... 43–44
AUTO_MANUAL_IND_TYPE ............................. 146
AUXILIARY_PLUG ............................... 96, 100, 192
E
engineering tools ................................................ 527
B EVENT_RECORDING .... 82–83, 88, 90, 96, 100,
1 5 6 , 1 5 9 , 1 6 6 , 1 8 7
Basic tagout class attribute settings ................... 129 Event Conversion Tool ....................................... 531
BAY_LR_IN_USE ................................... 87, 90, 188 Event List ............................................................ 142
BAY_LR_POLARITY .......................................... 188 Export Options .................................................... 530
545
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
IU .......................................................................... 29
F
Filters L
LN (Logical Name) ........................................... 72
OA (Object Address) ........................................ 72 Language identifiers ........................................... 419
PT (Process Object Type) ................................ 72 Language settings ................................................ 44
UN (Unit Number) ............................................. 72 LIB 5xx application library .................................. 527
FOLDER_1_TITLE ............................................. 159 LINE_INDICATOR_COLORED_BY ................... 201
FOLDER_2_TITLE ............................................. 159 Line Indicator.sd ................................................. 180
FOLDER_3_TITLE ............................................. 159 Line Indicator H.sd ............................................. 180
FOLDER_4_TITLE ............................................. 159 line indicator standard function ........................... 180
FOLDER_’number_TITLE .................................. 156 LINK_AR_TAG_TO_LN ...................................... 197
FOLDER_’number’_TITLE ................................. 195 LINK_AR_TAG_TO_MODULE ........................... 197
LINK_SIGNAL’nr’_TO_IX ........................... 166, 196
LINK_SIGNAL’nr’_TO_LN .......................... 166, 196
G LINK_SIGNAL’x’_IX ............................................ 166
Generator.sd ....................................................... 178 LINK_SIGNAL’x’_LN .......................................... 166
generator standard function ............................... 177 LINK_TRIP_TAG_TO_LN_x ............................... 198
Group alarm ........................................................ 339 LINK_TRIP_TAG_TO_ MODULE_x ................... 198
adding new alarm ........................................... 345 loading last saved layout .................................... 358
adding new group ........................................... 344 Local language ..................................................... 44
command procedures ..................................... 352 LR_REMOTELY_ CONRTOLLABLE .................. 188
database ......................................................... 339 LR_REMOTELY_CONTROLLABLE .... 82–83, 88,
deleting ........................................................... 345 9 0 , 1 8 7
editing ............................................................. 344
engineering ..................................................... 352 M
group member attributes ................................ 341
initializing ........................................................ 342 MAX_POSIT ....................................................... 148
localization ...................................................... 352 MAX_POSITION ........................................ 146, 193
member list ..................................................... 348 MEAS_1_DECIMALS ......................................... 159
optional settings ............................................. 348 MEAS_2_DECIMALS ......................................... 159
processing ...................................................... 351 MEAS_3_DECIMALS ......................................... 159
process objects .............................................. 353 MEAS_4_DECIMALS ......................................... 159
properties ....................................................... 347 MEAS_’number_DECIMALS .............................. 156
settings ........................................................... 341 MEAS_’number’_DECIMALS ............................. 195
structure ......................................................... 344 menu configuration ............................................. 359
symbol ............................................................ 351 MIN_POSIT ........................................................ 148
Viewer ............................................................. 349 MIN_POSITION .................................................. 146
Monitor Pro ......................................................... 355
customization ................................................. 355
H layout .............................................................. 355
HSI (human-system interface) .............................. 51 MOTORIZED .......................................... 96, 99, 191
I N
Icons Network Control Center (NCC) ............................. 44
reset ............................................................... 415 Network topology coloring .................................. 255
IND_DOUBLE_BINARY ......................... 82–83, 186
INDICATION_TYPE ................................ 96, 99, 191 O
installing complete objects ................................... 25
Install Standard Function dialog ........................... 27 OA ........................................................................ 29
INTERLOCKING_BYPASS .......................... 97, 193 OB ........................................................................ 29
546
1MRS758089 MicroSCADA Pro SYS600 9.4
Issued: 3.6.2015 Application Design
Version: B/3.6.2015
547
SYS600 9.4 MicroSCADA Pro 1MRS758089
Application Design
548
Contact us
www.abb.com/substationautomation