SYS600 System Objects
SYS600 System Objects
3
System Objects
1MRS756662 MicroSCADA Pro SYS 600 9.3
Issued: 31.03.2010 System Objects
Version: B/31.12.2010
Technical Description
3
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
4
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
5
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
6
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
7
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
8
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
1.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
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 © 2010 ABB Oy
All rights reserved.
1.2. Trademarks
Registrations and trademarks used in this document include:
Windows: Registered trademark of Microsoft Corporation.
Echelon: Registered trademark of Echelon Corporation Inc.
LonWorks: Registered trademark of Echelon Corporation Inc.
9
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
10
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
2. Introduction
About this chapter
The purpose of this chapter is to introduce the role the system objects have in the
system. It introduces the system objects and their attributes.
System objects
System objects are programmable units that specify the system configuration and
communication of the SYS 600 distributed system.
There are two main types of system objects:
• Base system objects (B), which define the configuration for the base system.
• Communication system objects (S), which define the configuration and
communication properties for the process communication system.
The base system objects and the communication system objects, along with the
configuration data of the PC-NET units and communication frontends determine the
SYS 600 configuration. The communication system objects give the communication
units an image of the devices connected to them. The base system objects give the
SYS 600 main program an image of the devices and the software used by the base
system.
When connecting a device to the SYS 600 system, some configuration is required
either in base system configuration file or in one or more of the NET configuration
files or in both places. Connecting a station, for example, requires both a base system
and a communication object definition.
Attributes
The properties of a part of a system are described by system object attributes. For
instance, the baud rate of a communication line, the station address of a process
station and memory allocations in the base system are stored in a corresponding
11
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
system object attribute. Normally, a system object has several attributes and, thus,
contains several types of data. The attributes are identified by two letter names,
combined of letters A ... Z.
System object attributes, which specify the properties of a part of the system and
affect the system configuration, are called configurable attributes. Other attributes,
called dynamic attributes provide information related to a part of the system or may
cause an immediate action in its operation. A communication system object of type
SPA (a process station), for instance, has the following configurable attributes:
Station address, SA = 123
Unit type, UT = 3
Reply timeout, RT = 15
The same SPA object can be accessed by the following dynamic attributes:
State, ST = 1
Update points, UP = 1
Send Message, SM = “message”
12
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
Name
System objects have predefined names. The name of a system object is composed of
three predefined letters, A - Z, and an ordinal number, which is freely chosen. The
three letters in the name specify which type the object represents, the number
separates the object from others representing the same type. For example, SYS
denotes base systems, APL applications, NOD nodes, PRI printers, and STA
stations. APL3 denotes application 3, NOD4 node 4, STA5 station 5, etc.
The object number identifies the object within one application where the notation is
used. The same physical object can be known under different object numbers within
different applications. However, the object numbers of NOD objects must be unique
within the entire SYS 600 distributed system.
Alternatively, a freely chosen alias name may be given for a system object by
specifying its BN attribute, see Chapter 4.
The predefined base system object names are listed and described in Chapter 4 and
the communication system objects in Chapter 13.
Application
Application stands for a logical application number. The logical application number
is the application number as known to the present application (according to the
application mapping, the AP attribute, see Chapter 6.). A prerequisite for using
application number is that the applications recognise each others through the
application mapping.
Generally, there is no need to include application number in the system object
notation. Mostly, an application number is included when access to base system
objects defined in another base system is desired. Application number is also needed
when accessing communication system objects from an application, unknown (not
defined) to the NET from which the objects are accessed.
13
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
Type
The type is a letter specifying the system object type as follows:
B Base system objects
S Communication system objects
Attribute
The attribute represents the value or feature to be read or written with the object
notation. It is named by an attribute name, which is a combination of two letters,
A ... Z. The attribute determines the data type (see the Programming Language SCIL
manual) and the value of the entire object notation.
A communication system object notation must always contain an attribute. The base
system object notation can be used without an attribute only when creating a new
object.
Index
Indices are integer numbers, which are used together with some attributes. As a rule,
the indices refer to the elements of an attribute of vector type. The actual attribute
determines the data type of the elements.
An index or index range is marked in either of the following manners:
• With an integer number, either a positive integer value or an octal number.
• With an integer type expression embraced by brackets.
• With an interval (i .. j), where 'i' denotes the first index number and 'j' the last.
Two points surrounded by brackets, (..), is interpreted as all the indices of the
actual object notation. (i ..) means all indices larger than or equal to 'i', and (.. j)
all indices less than or equal to 'j'.
In one case (the STAn:SME attribute), the index refers to an address. In this case the
index cannot be given by an expression, it must be given as an octal number.
The indexing of the system object attributes is detailed in the attribute descriptions.
14
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
SYS object
The SYS object corresponds to the actual base system. The SYS object attributes
specify the base system properties, such as:
• Type of computer and operating system
• Station address and node number of the base system
• Memory spaces and queue lengths
• Properties and addresses of connected devices
15
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
PCs running
Semi-graphic workstations
X software
Local workstations
MON MON
MON MON
LIN
LIN
Common RAM
PRI or Integrated link
Standalone frontend
NOD
Process NOD NOD
communication DCP-NET DCP-NET
Internal
systems DCP-NET NOD
or PC-NET
Printer
PRI
MON
Remote workstations
MON
Base_system_objects.eps
Fig. 4.1.-1 The base system objects defined in the shaded SYS 600 base system
APL objects
Each application known to base system must be defined as an APL object. This
comprises not only all applications situated within the base system in question, but
also all those applications in other base systems that will communicate with the
applications in the base system.
The APL object attributes specify the properties of the applications, such as:
• Application type: Local or external (in the same or in another base system)
• Application state: HOT, WARM or COLD
• Logical connections to peripherals and stations (device mapping)
• Logical connections with other applications within the same base system and in
other base systems (application mapping)
16
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
MON objects
The MON objects correspond to the SYS 600 monitors that the operator opens to
view an application on a physical monitor screen. When an operator opens a
SYS 600 monitor, he reserves a MON object as a logical monitor.
IND objects
The IND objects define the user-input devices of semi-graphic workstations
(MicroWORKSTATION). Only one IND object for a workstation is needed.
PRI objects
Each printer used by the base system must be defined as a PRI object, including
printers that are connected to NET units, LAN or other base systems. The PRI
attributes specify the properties of the printers, such as:
• Printer type: Colour, black-and-white or “transparent”
• Connection type: Connected to a NET unit, to a base system or to a LAN
• Lines per page, header texts, etc.
LIN objects
The LIN objects define the links between the base system and adjacent nodes (base
systems and communication units). The link object attributes specify the link
properties, such as:
• Link type: Type of connection (RAM, serial line or LAN)
• Communication properties: Redundancy check, time-out length, etc.
• Diagnostic counters, etc.
NOD objects
Each base system and NET unit known to the base system must be defined as a NOD
object, also those which are not directly connected to the base system. The NOD
attributes specify the addresses and properties of the nodes. The NOD object
numbers are global and must be unique within the entire SYS 600 network.
STA objects
The STA objects correspond to the “stations” known to the base system, when the
term 'station' denotes process control units such as Remote Terminal Units (RTUs),
Protective Equipment, Central Stations and protocol converters. The STA attributes
specify the station properties that are relevant to the base system, for example:
• Type of station: S.P.I.D.E.R. RTUs, stations on ANSI lines, SPA units, P214, etc.
• Node number of the NET unit to which the station is connected and the device
number of the station as known by that NET unit (system object number).
Each station that will be known to the base system must be defined as a STA object
in the base system, unless it is of the STA default type connected to the default NET
unit.
17
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
STY objects
By using the STY objects, the system engineer can define station types that are not
predefined. A requirement is that the new station type can use an existing station
interface and that the protocol has been implemented in NET unit.
18
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
Principle
The base system objects are defined with SCIL using the SCIL command #CREATE
(see the Programming Language SCIL manual).
The base system objects cannot be modified with #MODIFY nor deleted with
#DELETE.
SYS_BASCON.COM
During start-up the base system objects are created and their attributes are given
values with the configuration file SYS_BASCON.COM. The main program at each
base system start-up automatically executes this text file containing SCIL
commands. If the file is missing or erroneous, the system cannot be started.
The base system configuration file SYS_BASCON.COM can be edited with a text
editor both off-line and on-line. The modifications in SYS_BASCON.COM are
taken into use when the system is started next time.
On-line configuration
With some restrictions, the base system configuration can be modified and extended
during operation directly with SCIL. For example it can be modified with command
procedures started by the initial event channels APL_INIT_1 or APL_INIT_2 (see
the Application Objects manual), or with the Base System Configuration tool. These
on-line changes are not stored, unless they are included in the base system
configuration file SYS_BASCON.COM.
Required definitions
The base system object definitions required for various types of system set-ups are
detailed in the System Configuration manual.
Attribute access
All attributes can be read with SCIL (the object notation), but all attributes cannot
be written. The main access levels are:
• Read-only: The attributes that cannot be written in any circumstances or given
values when the object is created with #CREATE.
• Read-only, configurable: The attributes that can be given values with the
#CREATE command, but the value cannot be changed later with #SET.
19
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
20
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
5.1. General
21
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
The SYS object attributes of another base system can be accessed with the notation:
SYS:mBat
where
'm' Is the number of an application in the other base system as
known to the present application (according to the application
mapping, see Chapter 6)
An alternative way of using freely chosen object names is described in Chapter 4.
ND Node Number
The node number of the base system computer. The number must be unique among
all the base system computers and communication units connected to the network.
Data type: Integer
Value: 0 ... 250
Default value: 9
Access: No restrictions
NN Node Name
The LAN node name of the computer (host name). NN attribute may, for example,
be used to identify the computers in a hot stand-by system.
Data type: Text
Value: Node name
Access: Read-only
SA Station Address
The station address of the base system. The station address is used by the SYS 600
internal protocol ACP. It is a number, which must be unique among all nodes, for
example base systems, and communication units throughout the entire SYS 600
network.
Data type: Integer
Value: 1 ... 255
Default value: 192
22
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
HW Hardware
The type of the base system computer.
Data type: Text
Value: "PC/AT"
Access: Read-only
23
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
OS Operating System
The operating system running in the base system computer.
Data type: Text
Value: "NT" Windows
Access: Read-only
Version OV OM
NT 4.0 4 0
2000 5 0
XP 5 1
Server 2003 5 2
Vista 6 0
Server 2008 6 0
Windows 7 6 1
Server 2008 R2 6 1
To find the combined value of OV and OM as a text string, see the SCIL function
OPS_NAME in the Programming Language SCIL manual.
The name of the running operating system is given by attribute ON, see above.
PR Product Name
The name of the product can be read from this attribute.
Data type: Text
Value: Product name
Access: Read-only
24
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
RD Revision Date
Date of the running SYS 600 kernel software build (hours, minutes and seconds are
all zeroes).
Data type: Time
Value: Revision date
Access: Read-only
RE Program Revision
The revision number of the running SYS 600 kernel software, for example 9.2.
Data type: Text
Value: Program revision
Access: Read-only
RS Revision State
The revision state of the running SYS 600 kernel software.
Data type: Text
Value: State of running SYS 600 kernel software build
"DEVELOPMENT", "PRODUCTION", ...)
Access: Read-only
25
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
Default value: 1
Access: No restrictions
Example:
The system object notation STA2:SIU is routed to the default NET unit, unless the
base system contains a STAn:B object referring to the same station according to the
device mapping. See the APL attributes in Chapter 6.
ER Enable Routing
Enabling and disabling message routing. The base system has the capability to route
messages to other nodes, see the example in Fig. 5.2.3.-1.
If routing is enabled (ER = 1) and the base system receives a message with another
destination address than the own station address, the message is routed to the
destination node. If the destination address is unknown to the base system, the
message is destroyed.
Data type: Integer
Value: 0 Routing disabled
1 Routing enabled
Default value: 0
Access: No restrictions
26
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
TI Timeout Length
The maximum time the base system is waiting for a response after it has sent a
message to a connected node. When this time has expired, an error status is
produced. This time-out can be temporarily and locally changed by the SCIL
function TIMEOUT (see the Programming Language SCIL manual).
Data type: Integer
Value: 1 ... 65 535
Unit: Seconds
Default value: 60
Access: No restrictions
TF Time Format
The format of text representation of dates.
Data type: Integer
Value: 0 yy-mm-dd
1 dd-mm-yy
2 mm-dd-yy
Default value: 0
Access: No restrictions
The TF attribute affects several time functions (such as TIME, TIMES, DATE and
TIME_SCAN) and the #SET_TIME command, the Programming Language SCIL
manual.
27
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
TM Time Master
The time master of synchronization of the base system time. The attribute specifies
who is responsible for maintaining time zone information required to convert time
values read from an external time source to the time reference of the base system.
Data type: Text keyword
Values: "APL" or "SYS"
Default value: "APL" (for compatibility)
Suggested value: "SYS"
Access: No restrictions
If TM is set to "APL", the application must set SYS:BTZ (Time Zone) to match the
current bias between the time reference of the base system and the time source
(PC32 or PC-NET). SYS:BTZ is added to the time received from the external time
source to calculate the system time. SYS:BTS (Time Season) is set according to
PC31/PC32 clock, if present, otherwise it must be set by the application if used by
the application.
If TM is set to "SYS", SYS:BTZ and SYS:BTS are not set nor used by the base
system. SCIL function LOCAL_TIME_INFORMATION may be used to obtain
time zone related information from the system. The time received from the external
time source (if any) is used to set the fraction of semi-hour (minutes 0 ... 29, seconds
and milliseconds) of the system clock only.
TR Time Reference
The time reference of the base system.
Data type: Text keyword
Values: "LOCAL" or "UTC"
Default value: "LOCAL"
Access: Read-only, configurable
When the base system runs in local time, all the time attributes of objects and time
arguments and return values of functions operate in local time. When it runs in UTC
time, they operate in UTC time.
The time reference of the system may be changed (SYS 600 must be restarted,
however). After the change, all the attributes in the databases are shown in the new
time reference.
If TR is set to "UTC" and the base system is synchronized by PC-NET, the TM
(Time Master) attribute should be set to "SYS" to enable different time references
of the programs.
Before starting to run SYS 600 in UTC time, the used application
software, including COM 500 and LIBxx applications, must be
checked for the support of this feature. Also, if the base system is
connected to another SYS 600 base system, they should both run in
UTC time or the application software used to do APL-APL
communication must be checked for the support of different time
references of the base systems.
28
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
TS Time Season
The time season - summer time / winter time - of the PC31/32 clock, if such is used
for synchronising the base system time. The TS attribute is updated from the PC31/
PC32 clock each time a valid time (valid according to the status register of the clock
board) is read from the clock. The attribute can be set by SCIL if there is no external
clock.
Data type: Text keyword
Values: "SUMMER", "WINTER" or "UNKNOWN"
Default value: "UNKNOWN"
Access: No restrictions
TZ Time Zone
Hours to add to the time given by an external time source to get the system time. See
attribute TM for details.
Data type: Real
Value: -12.0 ... +12.0
Unit: Hours
Default value: 0
Access: No restrictions
29
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
30
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
31
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
32
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
PH Global Paths
Defines the global paths of the system (paths common to all the applications).
Data type: List
Value: List of global paths
Access: Read-only, configurable
The attribute names of the value define the path names and attribute values define
the directories included in the path. The attribute value may be either a text value
defining one directory or a text vector defining one or more directories.
The attribute can only be set by in SYS_BASCON.COM.
RL Representation Libraries
Defines the global representation libraries of the system (libraries that are common
to all the applications).
Data type: List
Value: List of global representation libraries
Access: Read-only, configurable
The attribute names of the value define the logical representation library names and
attribute values define the library files included in the logical library. The attribute
value may be either text value defining one file or a text vector defining one or more
files.
The attribute can only be set in SYS_BASCON.COM.
33
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
SH Shadowing
The state of shadowing – is it in use or not in use.
Data type: Integer
Values: 0 No shadowing
1 Shadowing
Default value: 0
Access: Read-only, configurable
34
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
OP OPC Server
The state of the OPC Data Access Server.
Data type: Integer
Value: 0 OPC Server not running
1 OPC Server running
Default value: 0
Access: No restrictions
Setting this attribute to 1 starts the SYS 600 OPC Data Access Server. If set in
SYS_BASCON.COM, the OPC Server is started immediately after the applications
have been started.
Setting this attribute to 0 stops the running OPC Server.
The following errors may raise when setting the attribute:
SYST_OPC_SERVER_DISABLED (7292): OPC Server license has not been
installed.
OPCS_SERVER_ALREADY_RUNNING (5510): Only one OPC Server is
allowed. If this error occurs when opcs.exe is not running, the server has terminated
abnormally. The attribute should be set to 0 first and then to 1 again.
35
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
PA Primary Application
Defines the primary application of the system. The primary application works as the
default application of the SCIL API interface and as the default application of the
OPC Server name space.
Data type: Integer
Value: Application number, 1 ... 250
Default value: The number of the application that becomes hot first at system
start-up
Access: Read-only, configurable
This attribute is useful especially in Hot Stand-by systems, where the main
application is typically not started by SYS_BASCON.COM.
36
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
37
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
When cyclically reading the clock, the data is considered valid if any of the
statements listed apply:
FREE = 0
SYNC_AFTER_RESET = 1
SOURCE = 1
38
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
Default value: 0
Suggested value: >= 60
Access: No restrictions
CL External Clock
The type of the external clock, if any. The external clock synchronises the SYS 600
time. See also attributes TM, TZ and TS.
Data type: Text keyword
Value: "NONE" No external clock
"PC31" Radio clock of type PC31. The radio clock is
synchronized in accordance with Central European
radio time signals.
"PC32" PC clock card of type PC32
"PCI510" PC clock card of type PCI510
Default value: "NONE"
Access: No restrictions
CS Clock Status
The status register of an external clock. that provides additional clock information
when a radio or satellite clock (for example PC31/PC32) is used for synchronising
the base system. Each time the status register of the clock is read by the base system,
the value in the register (byte or word) is copied as such to the CS attribute. The
meaning of the value is clock type specific.
Data type: Integer
Value: 0 ... 255
Initial value: 0
Access: Read-only
Status byte bit meanings:
'1' '0'
D0 Clock state Free running DCF77 controlled
D1 Daylight saving Enabled Disabled
D2 Sync'ed since reset Yes No
D3 Dayl.sav. is going to change Yes No
D4 UTC time Yes No
D5 Leap second announced Yes No
D6 Board time from Serial iface DCF77
D7 On-board time invalid Yes No
39
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
SP SPACOM Protocol
Specifies whether the direct SPACOM communication is allowed or not.
Data type: Integer
Value: 0 Direct connection of SPACOM not allowed
1 Direct connection of SPACOM allowed
Default value: 0
Access: No restrictions
40
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
CX Comment Text
A freely chosen comment text.
Data type: Text
Value: Any text, up to 255 characters
Access: No restrictions
SV System Variables
The attribute can be used as global variable. It is reserved for ABB and should not
be used in application programs.
Data type: Vector
Value: Defined by ABB
Default value: A vector of 10 integer 0’s
Access: No restrictions
41
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
UV User Variables
The attribute can be used as global variables in application programs.
Data type: Vector
Value: Defined by the application
Default value: A vector of 10 integer 0’s
Access: No restrictions
Example:
The attribute works as a counter:
#SET SYS:BUV1 = SYS:BUV1 + 1
42
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
6.1. General
APL objects
Each application known to the base system must be defined as an APL object. This
concerns not only all applications situated in the current base system (local
applications), but also applications in other base systems (external applications)
which are communicating with the local applications. An external application is
defined with a reference to the application in the other base system.
At least one local application must be created with an application name (see the NA
attribute) and set to "HOT" (see the AS attribute) in the SYS_BASCON.COM file.
43
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
The APL attributes of applications in another base system are accessed with the
following object notation:
APLn:mBat
where
'm' The logical application number (according to the application
mapping, the AP attribute) of an external application (see the TT
attribute)
'n' The number of the application object in the other base system
An alternative way of using freely chosen object names is described in Chapter 4.
AN Application Number
The base system object number (the 'n' in the object notation above) of the
application. The number is defined when the APL object is created. This attribute is
not included in FETCH (see the Programming Language SCIL manual).
Data type: Integer
Value: 1 ... 250
Access: Read-only, configurable
Example:
The object number of the current application is shown:
!SHOW AN APL:BAN
AS Application State
The state of a local application (an application within the same base system). The
attribute determines whether the application is running (HOT), passive but available
(WARM) or passive, not available (COLD). Setting an application to COLD
performs a clean shut-down of the application.
A base system can contain several HOT applications.
Data type: Text keyword
Value: "HOT" The application is running. Its databases are stored
in the primary memory.
44
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
NA Name
The name of the local application. The application name is the same as the name of
the application directory branch used in the directory tree in the APL directory. The
directory tree must exist when the application is created. The name is obligatory for
all local applications.
Data type: Text
Value: Up to 10 characters
Access: Read, conditional write
TT Translation Type
Determines how the base system regards the application and where the application
is found, see example in Fig. 6.2.4.-1.
Data type: Text keyword
Value: "NONE" Off, the application is out of use
"LOCAL" Normal operating state
"ALIAS" The APL object number is translated to
another APL object determined by the TN
attribute
"EXTERNAL" The application is situated in another base
system computer. The application is defined
by the ND and TN attributes.
Default value: "NONE"
Access: No restrictions
Changing TT from normal operating state LOCAL to any other state will cause the
application state to be set COLD.
45
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
PH Paths
Defines the application specific paths.
Data type: List
Value: List of application specific paths
Access: Read, conditional write
The attribute names of the value define the path names and attribute values define
the directories included in the path. The attribute value may be either text value
defining one directory or a text vector defining one or more directories.
The attribute can only be set by the "#CREATE APL:B" command or the "#SET
APLn:BPH" command when the application is cold and its shadowing state is
"NONE".
46
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
RL Representation Libraries
Defines the application specific representation libraries.
Data type: List
Value: List of application specific representation libraries
Access: Read, conditional write
The attribute names of the value define the logical representation library names and
attribute values define the library files included in the logical library. The attribute
value may be either text value defining one file or a text vector defining one or more
files.
The attribute can only be set by the "#CREATE APL:B" command or the "#SET
APLn:BRL" command when the application is cold and its shadowing state is
"NONE".
Example:
#CREATE APL2:B=LIST(-
RL = LIST(DEFAULT = "c:\own_pirs\my_pir",-
"APL_/APL_STAND",-
"LAN_/LAN_STAND")),-
... )
TD Text Databases
Defines the application specific text databases.
Data type: Text vector of any length
Value: Names of application specific text database files
Default value: Empty vector
Access: Read, conditional write
The attribute must be written as a whole, individual elements
may not be set one by one.
The database file names are listed in their logical search order, site specific files first
and product specific files last.
The attribute can only be set by the "#CREATE APL:B" command or the "#SET
APLn:BTD" command when the application is cold and its shadowing state is
"NONE".
Example:
#CREATE APL2:B=LIST(-
TD = VECTOR("APL_/SPECIAL_TEXTS.SDB",-
"/LIB6/TEXTS/LIB666_TEXTS.SDB"),-
... )
47
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
Data_communication.eps
ND Node Number
When the application is located in another base system (TT = "EXTERNAL"), this
attribute is the node number (the NOD object number) of the base system where it
is found. The attribute is not applied for local applications (applications located in
the same base system).
Data type: Integer
Value: 0 ... 250
Default value: No
Access: Read, conditional write
Example:
The application that APL2 refers to is located in the base system whose node
number is 10. See also Fig. 6.2.4.-1 and the TN attribute below.
APL2:BTT == "EXTERNAL", and
APL2:BND == 10
48
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
Examples:
1. Creating an alias application:
#CREATE APL5:B = LIST(TN = 2, TT = "ALIAS")
APL2 in the current base system refers to APL1 in the base system with node
number 10. By using APL2 in application mapping (Section 6.3.), communication
is obtained with application 1 in the other base system.
2. Creating an external application:
#CREATE APL2:B = LIST(ND = 10, TN = 1, TT = "EXTERNAL")
AP Application Mapping
Enabling communication between different applications in the same or in the
different base systems.
Data type: Vector
Value: A vector of 250 integers in the range 0 ... 250. Physical numbers
of the connected applications. 0 = undefined.
Indexing: 1 ... 250. Logical application number
Default value: All elements = 0
Access: Read, conditional write
An application recognises other applications by logical application numbers. The
AP attribute is a translation table between the logical application numbers and the
corresponding physical application numbers (base system object numbers). The
logical numbers are used as indices and the physical numbers are the value of the
attribute.
The application gets access to the data bases of all applications that are known to it
by a logical application number. The logical application numbers are used in the
object notations after the colon when referring to an object in another application,
see Fig. 6.3.1.-1.
If no intercommunication between different applications is needed, the attribute
need not be set. The attribute is not needed for file shadowing.
Example:
The application knows application 2 (APL2) as application 5 (logical number). For
example, the notation BREAKER:5POV refers to the process object BREAKER in
application 2. See the Fig. 6.3.1.-1.
APL:BAP5 = = 2
49
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
Base system
APL1 APL2
AP1 = 1
.
.
AP5 = 2
50
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
APL1 APL2
Station_mapping_attribute.eps
MO Monitor Mapping
Mapping of logical monitor numbers to physical monitor numbers.
Data type: Vector
Value: Vector of up to 100 integers in the range -1 ... 100.
0 Not mapped
-1 Any physical monitor number will do
1 ... 100 Physical monitor numbers
Indexing: Logical monitor number, 1 ... 100
Default value: All elements = 0 (that is no monitor available for the application)
Access: Read, conditional write
The attribute defines how many SYS 600 monitors will be available for the
application, and which are the logical and physical numbers of monitors that the
application may use.
Only semi-graphic (MicroWorkstation) monitors require a fixed monitor mapping.
When a VS or an X monitor is opened, any free physical monitor number is allocated
for it. Physical monitor number -1 is configured in MO for such monitors. During
an open monitor session, the actual physical monitor number is shown in MO.
An open monitor may be unmapped by setting its MO index value to -1. This may
be used (with care, of course) to close a monitor from another monitor.
Logical monitor numbers are used in
• process object attribute PD (Picture Devices)
• SCIL programs to distinguish and communicate between monitors
51
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
Example:
Application APL1 reserves logical monitor numbers 1 and 2 for MicroWorkstations
(mapped to physical monitors 11 and 12) and numbers 3 to 7 for VS (or X)
monitors:
#CREATE APL1:B = LIST(-
.........
MO = (11,12,-1,-1,-1,-1,-1), -
.........)
PR Printer Mapping
Mapping of logical printer numbers to physical printer numbers.
Data type: Vector
Value: Up to 20 integers in the range 0 ... 20. Physical printer numbers.
Indexing: Logical printer number, 1 ... 20
Default value: Each element = the index (one-to-one mapping)
Access: Read, conditional write
Logical printer numbers are used in
• printout commands #PRINT and #LIST
• process object attribute LD (List Devices)
• communication system object notation PRIn:S.
Because one-to-one mapping is the default, PR attribute does not always have to be
specified.
ST Station Mapping
Mapping of logical station numbers to physical station numbers.
Data type: Vector
Value: Up to 50 001 integers in the range 0 ... 50 000. Physical station
numbers
Indexing: Logical station number, 0 ... 50 000
Default value: Each element = the index (one-to-one mapping)
Access: Read, conditional write
Logical station numbers are used
• as process object attribute UN (Unit)
• in communication system object notation STAn:S.
The translation of a STAn:S object notation is illustrated in Fig. 6.3.2.-2.
Because one-to-one mapping is the default, ST attribute does not always have to be
specified.
52
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
Base System
Application Software Base System Objects
APL1 APL1 Station Mapping:
ST1 =
Application program: ST2 =
#SET BREAKER:POV1 .
.
ST5 = 10
Process Database:
BREAKER:PUN 1 == 5 STA10:B ND = 3
TN = 20
ST = RTU
Communication Unit
NET3
STA20
Type: RTU
Station_number_transaltion.eps
53
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
The attribute is also the maximum time allowed for file destruction in the receiving
application.
SD Diagnostic Counters
The value of the diagnostic counters on the connection between the hot and the
stand-by base systems.
Data type: Vector
Value: Vector of 16 integer elements (elements 11 ... 16 not in use)
Counter values
Indices: Counter number, 1 ... 16. The attribute without index refers to
the entire vector (all indices). An index range cannot be used
when setting the attribute.
Access: Read-only, the values can be resettable
There are 10 counters:
1. TRANSMITTED MESSAGES
2. TRANSMITTED COMMANDS
3. TRANSMITTED TRANSACTIONS
4. TRANSMITTED BYTES
5. RECEIVED MESSAGES
6. RECEIVED COMMANDS
7. RECEIVED TRANSACTIONS
8. RECEIVED BYTES
9. RAM DUMP TIME
10.FILE DUMP TIME
54
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
Setting this attribute to a non-zero value slows down the dump phase
drastically. The attribute is more or less obsolete with today’s
operating systems and hardware.
SN Shadowing Number
The logical application number of the shadowing partner application (usually an
external application).
Data type: Integer
Value: 0 ... 250
Logical application number
Access: Read-only, configurable
Example: See the example of the SS attribute below
When the application is the sending part in a shadowing relation (see the SS attribute
below), the SN attribute is the number of the receiving application. When the
application is the receiving part, the SN attribute is the number of the sending
application.
55
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
SP Shadowing Phase
The shadowing phase in progress.
Data type: Text keyword
Value: "NONE" No shadowing
"HOT_RC" Normal operation of the stand-by
application in Hot Stand-by systems
"HOT_SD" Normal operation of the primary
application in hot stand-by systems
"TO_HOT_SD" On-going file dump or RAM dump
(primary application)
"TO_HOT_RC" On-going file dump or RAM dump
(stand-by application)
"WARM_RC" Normal operation of the stand-by
application in warm stand-by systems
(file shadowing)
"WARM_SD" Normal operation of the primary
application in warm stand-by systems
"TO_WARM_RC" On-going file dump or RAM dump
(stand-by application) in warm stand-
by systems
"TO_WARM_SD" On-going file dump or RAM dump
(primary application) in warm stand
by systems
Access: Read-only
56
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
When a process object is updated, it may activate an event channel for post-
processing the event by command procedures and data objects. The event channel
activation requests are queued and executed in turn. In a hot stand-by environment,
it is possible that a take-over occurs after a process object has been updated but
before the activated event channel has been executed. If the event channel queue has
not been shadowed, the post-processing of the event is lost.
If event channel shadowing is enabled (SQ = 1), the mechanism is as follows:
During shadowing, the event channel activation requests caused by process object
updates are transferred to the receiving application. Likewise are indications of
completed event channels transferred. (An event channel is completed when the
connected data object, command procedure or time channel has been executed).
After a take-over, the event channel queue is reconstructed in the running
application and the event channels are executed after APL_INIT_H. The events are
queued in the original order. If there were several pending activations for the same
object, only the last one is re-queued. The snapshot variables of the process object
are not shadowed but reconstructed from the current values in the running
application. Event channel activations generated by SCIL are not shadowed.
The event channel shadowing guarantees that each event channel activation is
executed in at least one of the HSB application pairs. However, there is a slight risk
that an event channel is executed twice (in both applications).
SS Shadowing State
The role of the application in the shadowing relation.
Data type: Text keyword
Value: "NONE"
"RECEIVE"
"HOT_SEND" File + RAM shadowing
"WARM_SEND" File shadowing
57
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
SW Shadowing Watchdog
The logical application number of the watchdog application.
Data type: Integer
Value: 0 ... 250
Access: Read-only, configurable
58
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
59
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
PQ Parallel Queues
The maximal number of parallel report queues that the application can use.
Data type: Integer
Value: 0 ... 30
Default value: 0
Access: Read, conditional write, only in "COLD" state
Example: See QP
60
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
2 Report printouts
Access: Read-only
QO Queued Objects
The names of objects in various system queues queued for execution, but not yet
started (c.f. attribute RO).
Data type: Vector
Value: Vector of 34 elements
Indexing: 1 The time channel queue.
2 The event channel queue.
3 to 17 The parallel queues 1 to 15.
18 The objects queued for parallel execution, but not
yet assigned to any particular parallel queue.
19 The objects to be executed in future, i.e. activated
by #EXEC_AFTER.
20 to 34 The parallel queues 16 to 30.
Access: Read only
If a queue is empty, the corresponding element of the attribute is an empty vector,
otherwise it is a text vector listing the queued objects. An object is identified by a
text string starting with character 'D' (for data object), 'C' (for command procedure),
'T' (for time channel object), 'A' (for event channel object) or 'E' (for event object)
followed by the name of object. In case of an event object, the index of the object
enclosed in parentheses follows.
This attribute is used for application debugging.
QD Queue Dedication
Defines whether parallel queues are dedicated or not.
Data type: Vector
Value: Vector of up to 30 integer values
0 Not dedicated
1 Dedicated
Indexing: Parallel queue number
Default: 0
Access: Read-only, configurable
Example: See QP
A dedicated parallel queue is a queue that does not execute report objects whose PQ
attribute is 0.
If all parallel queues are dedicated, a report object with PQ=0 (and PE=1) is run in
event channel queue.
61
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
QM Queue Maximum
The maximum length of queues.
Data type: Vector
Value: A vector of four integers in the range 1 ... 65 535
Indexing: 1 The time channel queue
2 The event channel queue
3 The parallel queues
4 The delayed execution queue (#EXEC_AFTER)
Default value: (1000,1000,1000,1000)
Access: No restrictions
This attribute is designed to protect the SYS 600 system against erroneous SCIL
applications. For example, a command procedure MYSELF that only requeues itself
twice (two #EXEC MYSELF:C commands) would very quickly eat all the system
resources and freeze or crash the whole program. When the limit specified by the
attribute is reached, #EXEC commands will fail by error code
REPF_EXECUTION_QUEUE_FULL (1118).
However, the length of the queues 2 and 3 may exceed the limit specified by the
attribute because of process events. The reasoning behind this is as follows:
The rate of incoming process events is supervised by the EU and EM attributes (as
well as PU and PM) attributes of the application.
When a process event is accepted into the process database (i.e. EU < EM and PU <
PM), the attribute EU is incremented, the value from the process is stored in the
database and, among other things, its event channel is activated. The event channel
may contain one or more command procedure and data object activations. These
objects are queued for execution in the event channel queue (queue 2), or in one of
the parallel queues. In this situation, the queue length maximum (QM(2)) is not
honoured, because otherwise events would be lost. When the execution of the
primary object of the event channel is finished, the EU attribute is decremented to
make the process database accept a new process event.
So, as an example, if each process message activates 5 command procedures (the
primary object of the event channel plus 4 secondaries) and the value of the EM
attribute is 500, the length of the event channel queue (QU(2)) is likely to be about
2500 in a rush situation, regardless of the value of QM(2).
62
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
QP Queue Priority
The priority of the parallel queue.
Data type: Vector
Value: Vector of up to 30 text keyword values ("NORMAL", "LOW" or
"HIGH")
Indexing: Parallel queue number
Default: "NORMAL"
Access: Read-only, configurable
The priority of the queue defines how the operating system is to allocate processor
time for the queue compared to the time channel queue, event channel queue and
other parallel queues. There are three priority classes: low, normal and high.
The priority of time channel and event channel queue is fixed (always 'normal').
Example:
CREATE APL1:B = LIST(NA = "NAME", -
... –
PQ = 3, -
QP = ("NORMAL" , "NORMAL" , "HIGH"), -
QD = ( 0 , 0 , 1))
An application is created with 3 parallel queues. The queues 1 and 2 run with normal
priority and serve report objects with PQ = 0. The queue 3 runs with a higher priority
and only accepts report objects, whose PQ attribute is 3.
QU Queue Used
The number of waiting executions in queues.
Data type: Vector
Value: A vector of four integers
Indexing: 1 The time channel queue
2 The event queue
3 The parallel queues
4 The delayed execution queue (#EXEC_AFTER)
Access: Read-only
RO Running Objects
The names of the data objects or command procedures currently under execution in
REPR queues.
Data type: Vector
Value: Vector of max. 32 text elements
Indexing: 1 The time channel queue
2 The event channel queue and
3 to 32 The parallel queues 1 to 30
Access: Read only
63
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
64
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
65
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
66
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
67
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
IT Input Timeout
Length of timeout for waiting for user input.
Data type: Integer
Value: 0 ... 65535, seconds to wait
Default value: 0 (no timing)
Access: No restrictions
The input timeout affects the semi-graphic input commands !INPUT_VAR,
!INPUT_KEY and !INPUT_POS. The execution of the SCIL program containing
the input command is interrupted by error PICO_INPUT_TIMEOUT (961), if the
operator does not respond in the specified time. The timer is reset by each character
typed.
The timeout is applied in all semi-graphic pictures shown by the monitors of the
application.
68
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
LA Language
The language of the application.
Data type: Text keyword
Value: Language according to the standard ISO 639
Default value: "EN" (English)
Access: No restrictions
The chosen language can be overridden by the MONn:BLA attribute and by the
SCIL function SET_LANGUAGE.
AC Alarm Count
The number of active alarms.
Data type: Vector
Value: Vector of 7 integers
Indexing: Indices 1 ... 7 refer to the alarm classes. Index 0 returns the total
number. An attribute notation without an index refers to the
whole vector.
Access: Read-only
AT Alarm Tag
A tag number that is updated each time the alarm queue is updated (a new alarm
occurs, an alarm is acknowledged, or an alarm is cleared).
Data type: Integer
Value: 0 … 65 535
Access: Read-only
The attribute can be used, for example, in the alarm list so that a change of the
attribute causes an updating of the display.
69
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
HT History Tag
A tag number that is updated each time the history buffer is updated.
Data type: Integer
Value: 0 … 65 535
Access: Read-only
The attribute can be used, for example, in the event list so that a change of the
attribute causes an updating of the display.
LT Blocking Tag
A tag number that is updated each time a blocking attribute (AB, HB, PB, UB or XB)
of a process object is set or cleared.
Data type: Integer
Value: 0 … 65 535
Access: Read-only
The attribute can be used, for example, in the blocking list so that a change of the
attribute causes an updating of the display.
70
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
RC Revision Compatibility
Allowing the application engineer to choose the behavior of SCIL language
elements when upgrading to a new SYS 600 version that works differently from the
version used during the application engineering. The mechanism may be useful, for
example, in the following cases:
• A bug has been corrected in the new revision, but an application has taken
advantage of the old bug and relies on it.
• Some limit or restriction of the program has been removed, but an application
may be coded to rely on the restriction.
The compatibility with the old revision is defined by compatibility issues. The
mechanism is handled by the RC attribute and a SCIL function. With the RC
attribute, all the SCIL programs executed within the application may be forced to
behave in the old way regarding one or more compatibility issues. The SCIL
function REVISION_COMPATIBILITY enables the programmer to temporarily
(in a picture, dialog system or command procedure) override the revision
compatibility defined by the RC attribute.
Data type: Text or a text vector
Value: The name(s) of the enabled compatibility issues. Enabling a
compatibility issue means that it behaves like in the previous
SYS 600 version. The following compatibility issues are available:
"ON_COMMAND_EXPANSION"
"FILE_FUNCTIONS_CREATE_DIRECTORIES"
"SETTING_LA_AND_AG_DOES_NOT_ALARM"
"NO_QUALITY_ATTRIBUTE_SEMANTICS"
"NO_ALIAS_CHECKING"
"NO_ALARM_BY_OR_AND_OF"
"DONT_RECALCULATE_AL_AFTER_ALARM_BLOCKING"
"CREATE_VERSION_1_FILES"
"KEEP_FILE_VERSION_1_DATABASE_FILES"
"DEFAULT_DAYLIGHT_POLICY_IS_CALENDAR"
"844_COMPATIBLE_MIRRORING"
71
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
"CREATE_VERSION_2_SCIL_DATABASES"
"DO_NOT_SYNCHRONIZE_PICTURE_UPDATE"
"COUPLE_AUDIO_ALARMS_AND_PRINTOUTS"
"ALLOW_CONFLICTING_F_ATTRIBUTE_NAMES"
"DONT_CAUSE_TAKEOVER_ON_FATAL_ERRORS"
Access: Read-only, configurable
Example:
The application APL1 uses the compatibility issue
ON_COMMAND_EXPANSION:
#CREATE APL1:B = LIST(...
RC = "ON_COMMAND_EXPANSION",-
...)
Compatibility issues:
ON_COMMAND_EXPANSION
In MicroSCADA revision 8.1 and older, the 'macros' of each SCIL command line
were expanded before the line was interpreted. This lead to an incorrect behavior in
case of a single line #ON command, for example:
@A = "XYZ"
#ON EVENT:E1 #EXEC 'A':E2
FILE_FUNCTIONS_CREATE_DIRECTORIES
If the file name argument of READ_TEXT or other file handling functions was
given in operating system dependent format, such as "\DIR\FILE.TXT", the
directory was created if it did not exist. This bug has been fixed.
FILE_DIRECTORY_DOES_NOT_EXIST status is now returned.
If the compatibility issue FILE_FUNCTIONS_CREATE_DIRECTORY is set (by
application attribute RC or SCIL function REVISION_COMPATIBILITY), the
following SCIL functions and commands create the directory, when needed,
instead of returning the error status:
WRITE_TEXT
WRITE_BYTES
WRITE_COLUMNS
#CREATE_FILE
Other file handling functions (e.g. READ_TEXT) never create the directory.
72
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
SETTING_LA_AND_AG_DOES_NOT_ALARM
In rev. 8.4.0 and earlier, setting AG or LA attribute of a process object did not affect
the alarm state of the object and no post-processing was done. In 8.4.1, the alarm
state is updated according to the new value and normal post-processing is done. Due
to the change, some old applications generate unwanted alarms and printouts when
run under 8.4.1. To prevent this, this revision compatibility value was implemented.
The value can be used only as the value of the application attribute RC. It cannot be
used as an argument of SCIL function REVISION_COMPATIBILITY, because
event handling is done by the process database.
NO_QUALITY_ATTRIBUTE_SEMANTICS
In MicroSCADA revision 8.4.2 and earlier, the quality attributes SB (Substituted),
BL (Blocked), OR (Out of Range) and OF (Overflow) have been information-only
attributes, i.e. they have been stored in the process object to be available for SCIL
but their values have not affected the behavior of the process object in any way.
In newer revisions the following rules apply:
• A change of a quality attribute generates an event if EE = 1
• A change of a quality attribute activates an event channel, a printout and/or
history logging if the activation is enabled (AE == 1, LD <> 0 or HE == 1) and
the activation criterion (AA, PA or HA) is "NEW VALUE" or "UPDATE".
• In such an activation, the changed attribute is reported as the value of CA pseudo-
attribute. If more than one attribute is changed at the same time, each change will
be reported separately in any order. For example, if OV changes from 0 to 1 and
SB from 1 to 0, two activations occur, one with CA == "BI", BI == 1 and SB ==
0, the other with CA == "SB", BI == 1 and SB == 0.
• When the switch state (SS) or the substitution state (SU) of the object is changed,
the quality attributes are set to 0.
When "NO_QUALITY_ATTRIBUTE_SEMANTICS" is specified, the quality
attributes behave as in MicroSCADA rev. 8.4.2 and earlier.
NO_ALIAS_CHECKING
Since revision 8.4.2 of MicroSCADA global variables are guarded against alias
references. The revision compatibility switch NO_ALIAS_CHECKING is
implemented for compatibility. Status SCIL_VARIABLE_ALIASING_ERROR is
generated when aliasing rules are violated.
If this switch is given (either by the RC attribute of the application or by
REVISION_COMPATIBILITY function), alias checking is not done. Turning on
the switch by the RC attribute disables the checking of alias referencing in the whole
application. To disable the alias reference checking locally in a program, use the
REVISION_COMPATIBILITY function. The REVISION_COMPATIBILITY
function is described in the Programming Language SCIL manual.
73
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
The arguments of method calls, as well as all the arguments of SCIL functions
except for the last one, are passed by copy instead of reference. This degrades
performance, when text, bit string, byte string, vector and list arguments are used.
See “Installation” manual, chapter “Upgrading from Previous revisions”.
If the MicroSCADA base system revision 8.4.2 will be used together with
applications created with earlier revisions of the base system, e.g. using LIB 4.0.1,
the revision compatibility switch NO_ALIAS_CHECKING should be turned on.
NO_ALARM_BY_OR_AND_OF
Since revision 8.4.4 of MicroSCADA, the protocol specific attribute OR (Out of
Range) and OF (Overflow) value 1 generate an alarm (c.f OS value 1 or FAULTY).
"NO_ALARM_BY_OR_AND_OF" may be set if the application, for a reason or
another, does not like this new behavior.
DONT_RECALCULATE_AL_AFTER_ALARM_BLOCKING
Since revision 8.4.4 of MicroSCADA, the alarm state is recalculated when AB is set
back to 0. However, no alarm printouts nor event channels are activated (they are not
activated when AB is set to 1, neither).
"DONT_RECALCULATE_AL_AFTER_ALARM_BLOCKING" may be set if the
application, for a reason or another, does not like this new behavior.
CREATE_VERSION_1_FILES
In revision 8.4.4 of MicroSCADA, the implementation of keyed files was enhanced
to give better performance and to support files of any size (earlier implementation
had the size limit of 32 MB). Process and report database files, pictures,
representation libraries and files created by SCIL using #CREATE_FILE command
are implemented as keyed files.
The files created by the new version 2 implementation cannot be read by earlier
MicroSCADA revisions. However, they can be converted to version 1 format by
SCIL function KEYED_FILE_MANAGER, see the Programming Language SCIL
manual.
When "CREATE_VERSION_1_FILES" is set, all the files are created in the old
version 1 format. The use of this value is not recommended, but it may be useful in
cases where pictures are engineered in 8.4.4 environment but used in 8.4.3 or earlier.
KEEP_FILE_VERSION_1_DATABASE_FILES
In revision 8.4.4 of MicroSCADA, the implementation of keyed files was enhanced
to give better performance and to support files of any size (earlier implementation
had the size limit of 32 MB).
When an application is started up the first time using MicroSCADA revision 8.4.4,
the process database file APL_PROCES.PRD and the report database files
APL_REPORT.nnn are automatically converted to the new version 2 format. The
74
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
old files are renamed by appending a postfix "_V1" to the name. If the conversion
fails, for example because of disk space shortage, the old file is used and the
conversion is tried again during the next start-up.
If, for some reason, the conversion is not wanted, compatibility issue
"KEEP_FILE_VERSION_1_DATABASE_FILES" may be set before starting up
the application. If it is later removed, the conversion takes place during the next
start-up.
DEFAULT_DAYLIGHT_POLICY_IS_CALENDAR
In revision 8.4.4 of MicroSCADA, the implementation of time handling was
comprehensively rewritten. Both local and UTC time as well as daylight saving time
are fully supported. There is a slight incompatibility between the new and old
implementation of the scheduling of time channels: The default behavior of time
channels at daylight saving time / standard time switches has been changed.
Prior to revision 8.4.4, the scheduling of time channels was synchronized to the local
time of the system. When the local time was moved backwards at daylight saving to
standard time switch, the time channels stopped for an hour. Correspondingly, at
standard to daylight saving time switch, the time channels were excessively
scheduled.
In revision 8.4.4, the default behavior is that the time channels are scheduled evenly
(synchronized to UTC time) when the local time changes due to daylight saving and
there is a new attribute DP (Daylight Switch Policy) to specify the behavior, see the
Application Objects manual.
When "DEFAULT_DAYLIGHT_POLICY_IS_CALENDAR" is set, the time
channels created with earlier program revisions keep behaving as before. Even
scheduling is the default behavior of new time channels, however.
844_COMPATIBLE_MIRRORING
Mirroring between MicroSCADA 8.4.4 and MicroSCADA 8.4.5 does not work
when default settings are used. When upgrading from 8.4.4 to 8.4.5, both systems
have to be upgraded to make mirroring work again.
If the SYS 600 mirroring network is large, upgrading may cause unacceptably long
breaks in the operation of the network. The compatibility issue,
"844_COMPATIBLE_MIRRORING", has been implemented to ease upgrading.
When "844_COMPATIBLE_MIRRORING" is set (in MicroSCADA 8.4.5, or
later), the mirroring works with an 8.4.4 application, and also with another 8.4.5
application with "844_COMPATIBLE_MIRRORING". However, it does not work
with an 8.4.5 application without "844_COMPATIBLE_MIRRORING".
It is recommended to build a new mirroring network without
"844_COMPATIBLE_MIRRORING". In addition, if an operation break is
acceptable, an upgrade to 8.4.5 should be done without
"844_COMPATIBLE_MIRRORING", because then it is easier to add new nodes in
the network afterwards.
75
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
CREATE_VERSION_2_SCIL_DATABASES
The internal implementation of SCIL databases (SDB) has been optimised for faster
access in SYS 600 9.0. An SDB created in the new (version 3) format cannot be read
by MicroSCADA 8.4.5, which uses version 2 format.
When "CREATE_VERSION_2_SCIL_DATABASES" is set (in SYS 600 9.0 or
later), SDB’s are created in the old version 2 format. This compatibility issue may
be used for convenience in cases where SDB files created in a 9.0 system are
frequently moved to an 8.4.5 system.
DO_NOT_SYNCHRONIZE_PICTURE_UPDATE
The timing of update programs of pictures is synchronized to the system clock (See
the Programming Language SCIL manual, command !UPDATE). In the revision 8.2
(or older), such a synchronization was not done. When an old application that relies
on the old behavior is upgraded, this setting may be used to avoid recoding of the
pictures.
When "DO_NOT_SYNCHRONIZE_PICTURE_UPDATE" is set, the executions
of update programs are not synchronized.
This setting does not affect the cyclic methods of Visual SCIL objects.
COUPLE_AUDIO_ALARMS_AND_PRINTOUTS
Generation of audio alarms has been changed in SYS 600 9.1 and in MicroSCADA
8.4.5 SP2. Audio alarms and alarm printouts are now generated independently of
each other. In earlier revisions, an audio alarm was generated only when an alarm
row was printed on the event printer.
When "COUPLE_AUDIO_ALARMS_AND_PRINTOUTS" is set, the audio
alarms of the application are generated as in earlier program revisions.
ALLOW_CONFLICTING_F_ATTRIBUTE_NAMES
When an old (Rev. 8.4.3 or older) application was upgraded to 8.4.5 or later, the
creation of F (Free Type) objects fails by
PROF_FREE_ATTRIBUTE_NAME_ALREADY_EXISTS (2212), if the F object
defines attribute names implemented as common process attributes in the base
system in MicroSCADA revisions up to 8.4.4.
Examples of such conflicting attributes are RB, TI, TY, OI, BL, RB, OR and CT.
76
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
DONT_CAUSE_TAKEOVER_ON_FATAL_ERRORS
Since Rev. 9.3, a deliberate HSB takeover is initiated in case of an occurrence of a
fatal error (such as global memory pool overflow or lack of operating system
resources), if the primary application of the system is ready for a takeover (its
shadowing phase is HOT_SD).
When "DONT_CAUSE_TAKEOVER_ON_FATAL_ERRORS" is set, the
system tries to continue, possibly resulting in a halt and/or takeover later on.
77
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
Default value: 0
Access: No restrictions
78
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
HE Host Enabled
Enables and disables mirroring communication with this (external) host application.
Data type: Integer
Value: 0 Disabled:
1 Enabled
Default value: 1
Access: No restrictions
The attribute is used in the image system to temporarily block the incoming events
from a host application. During the blocking, the host buffers the events and sends
them when the communication is re-enabled.
79
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
IE Image Enabled
Enables and disables mirroring communication with this (external) image
application.
Data type: Integer
Value: 0 Disabled:
1 Enabled
Default value: 1
Access: No restrictions
The attribute is used in the host system to temporarily block sending events to an
image application. During the blocking, the host buffers the events and sends them
when the communication is enabled again.
HD Host Diagnostics
Mirroring diagnostics for an external host application in the image system.
Data type: Vector of 10 integer elements
Value: Counters for the following:
Indexing: 1 Received events
2 Received event messages
3 Transmitted process object commands
4 Transmitted STA:S commands
5 Established connections
6 Connection breaks
7 Successful reconnections after a break
8 Stations currently mirrored
9 Addresses currently subscribed to
80
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
10 Missing addresses
Access: No restrictions
ID Image Diagnostics
Mirroring diagnostics for an external image application in a host system.
Data type: Vector of 10 integer elements
Value: Counters for the following:
1 Transmitted events
2 Transmitted event messages
3 Received process object commands
4 Not used, always 0
5 Established connections
6 Connection breaks
7 Successful reconnections after a break
8 Stations currently mirrored
9 Addresses currently subscribed to
10 Missing addresses
Access: No restrictions
AD Application Self-Diagnostics
Self-diagnostics to be displayed by various tools.
Data type: Vector
Value: A vector of list elements with the following attributes:
CATEGORY Text, the type or category of the diagnostic
message. The only value currently
implemented:
"LOAD" Load time diagnostics
AREA Text, the diagnostic area. The implemented
area:
"PROCESS DATABASE"
OTYPE Text, the object type concerned:
"P" Process objects
"" Not specific to any object type
SOURCE Text, additional info about the source of the
diagnostic message:
"UNIT" Process unit
"" No additional info
NUMBER Integer, the specific number of the source:
Unit number
0 (no specific source to be reported)
81
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
CX Comment Text
A freely chosen comment text.
Data type: Text
Value: Any text, up to 255 characters
Access: No restrictions
SV System Variables
The attribute can be used as global application related variables. It is reserved for
ABB and should not be used in application programs.
Data type: Vector
Value: Defined by ABB
Default value: Vector of 10 integer 0’s
Access: No restrictions
UV User Variables
The attribute can be used as global application related variables in application
programs.
Data type: Vector
Value: Defined by the application
Default value: Vector of 10 integer 0’s
Access: No restrictions
82
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
7.1.1. General
MON objects
The MON objects correspond to the SYS 600 monitors opened on screens by the
operator or automatically. A screen - the base system screen or a workstation - can
contain one or more SYS 600 monitors connected to the same or different
applications in the same or in different base systems. Semi-graphic workstation
correspond to one MON object.
Each SYS 600 monitor which will be used by the base system and its applications
must be defined as a MON object. The monitors are reserved by an application with
the monitor mapping attribute (APLn:BMO, Chapter 7.).
83
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
'n' The object number of the SYS 600 monitor in the other base
system
An alternative way of using freely chosen object names is described in Chapter 4.
DT Device Type
The type of the SYS 600 monitor given as a text. The type of monitor affects the user
interface.
Data type: Text keyword
Value: "VS" SYS 600 monitor supporting the display of Visual
SCIL dialogs. Motif widgets are not supported.
"X" Full graphics SYS 600 monitor using X and Motif
software. Visual SCIL is not supported
"MW" Semi-graphic workstation
"NONE" Monitor is not defined
Default value: "VS"
Suggested value: Use the "VS" type unless there is some reason for using another
type. The "X" type must be used for monitors that should be able
to display Motif widgets.
Access: Read, conditional write
TT Translation Type
Determines the operating state of the monitor. If TT = "LOCAL", it must not be set
to "NONE".
Data type: Text keyword
Value: "NONE" Off, out of operation
"LOCAL" Normal operating state
Default value: "NONE"
Access: Read, conditional write
84
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
AP Application Number
The number of the application that controls the monitor according to the monitor
mapping (the attribute APLn:BMO, Chapter 6).
Data type: Integer
Value: 0 ... 250
Access: Read-only
DC Device Connection
The type of the monitor connection. The attribute is mainly informative and need not
be set.
Data type: Text keyword
Value: "LINE" Serial port or LAN connection
"RAM" Direct connection to the base system computer
"NET" Connected to a NET unit
Default value: The default value depends on the device type (see the DT
attribute) as follows:
"MW" "NET"
"X" or "VS" "RAM"
Access: Read, conditional write
LI Logged In
Informs whether a user has logged in on the monitor. When a user logs in or out, an
event channel named MON_EVENT (if it exists) is started in the application. See
the Application Objects manual.
Data type: Integer
Value: 0 No login
1 Login
Access: Read-only
85
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
Default value: No
Access: Read-only
SG Semigraphic
The graphic mode identifier of the monitor. This attribute is automatically set to 1
by the base system software if the monitor is not capable of displaying primitive
graphics.
Data type: Integer
Value: 0 Full-graphic monitor
1 Semigraphic monitor
Access: Read-only
SZ Screen Size
The size of screen in pixels.
Data type: Vector
Value: Vector of two integers > 0: (x-size, y-size). The first element (‘x-
size’) is the horizontal size, the second element (‘y-size’) the
vertical size.
Access: Read-only
BP Blink Policy
Specifies how to handle the blink behavior in situations when the picture handler is
busy, for example with a demanding SCIL command. Blinking in pictures is realized
as a shift between background and foreground display.
Data type: Text keyword
Value: "NONE" No special actions taken (default)
"FOREGROUND" All blinking areas on screen are
displayed as non-blinking
"BACKGROUND" The blinking areas are displayed as in
blink-on state (in background color)
Access: No restrictions
86
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
DI Diagnostic Interval
Monitor diagnostic interval.
Data type: Integer
Value: 0 ... 65 535
0 = No diagnostics
Unit: Seconds
Default value: 10
Access: No restrictions
For X monitors the time for cyclical diagnostic commands to the X server and the
TCP/IP connection can be set. When the connection to a X monitor is lost the error
message "X Monitor n IO Error Event:" is printed. The communications with VS
remote monitors is diagnosed with the same attribute. The attribute is the time
between the diagnostic commands.
IL Input Locked
Prevents the input to a SYS 600 monitor from keyboard or mouse.
Data type: Integer
Value: 0 Input not locked (default)
1 Input locked: No digitizer, mouse nor keyboard input is
obeyed
87
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
Default value: 0
Access: No restrictions
LA Language
The default language used in dialogs and pictures.
Data type: Text keyword
Value: Language name according to the ISO standard 639
Default value: The value of APL:BLA
Access: No restrictions
The chosen language can be overridden by the SCIL function SET_LANGUAGE.
MS Monitor Stop
Terminates the SCIL program currently run by the SYS 600 monitor.
Data type: Integer
Value: 0 or 1
Access: No restrictions
PC Picture Containers
The maximum number of picture containers in a Visual SCIL monitor.
Data type: Integer
Value: 0 ... 10
Default: 1
Access: No restrictions
It is not recommended to have more than 1 picture container in a dialog, because the
SCIL programs of all the pictures within a dialog are executed sequentially.
Therefore, a picture doing a lengthy operation (such as !INPUT_VAR, #PAUSE
etc.) blocks all the other pictures in the dialog.
WC Window Color
The color of the background behind a window in a picture and behind the blinking
alarm signal.
Data type: Text or vector
Value: Color specification given in either of the four manners described
in the Programming Language SCIL manual.
Default value: None = Black color
Access: No restrictions
88
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
When a window is shown on a graphics screen, this color will be shown in the
window locations for a moment until the window is drawn. Likewise, when a
window is erased from screen, this color is shown until the background is redrawn.
Example:
#SET MON1:BWC = (“M”,1)
CX Comment Text
A freely chosen comment text.
Data type: Text
Value: Any text, up to 255 characters
Access: No restrictions
SV System Variables
The attribute can be used as global monitor related variables. The system variables
are reserved for ABB and should not be used in application programs.
Data type: Vector
Value: Defined by ABB
Default value: A vector of 10 integer 0’s
Access: No restrictions
UV User Variables
The attribute can be used as global variables in application programs.
Data type: Vector
Value: Defined by the application
Default value: A vector of 10 integer 0’s
Access: No restrictions
7.2.1. General
Each semi-graphic workstation, MicroWORKSTATION, to be used by the base
system and its applications must be defined as an IND object (’input device’). The
IND objects are connected to a MON object (the MON object corresponding to the
workstation) with the INDn:BMO attribute.
From SCIL the IND object attributes are accessed with the following object
notation:
INDn:Bat
89
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
where
'n' The object number of the input device. 'n' may not be omitted
from the object notation.
'at' The attribute name
The IND attributes of input devices defined in another base system are accessed
with the following object notation:
INDn:mBat
where
'm' The logical application number of an external application (see
the TT attribute, Chapter 6)
'n' The object number of the input device in the other base system
An alternative way of using freely chosen object names is described in Chapter 4.
CX Comment Text
A freely chosen comment text.
Data type: Text
Value: Any text, up to 255 characters
Access: No restrictions
DC Device Connection
The type of the device connection. The attribute is mainly informative and needs not
to be set.
Data type: Text keyword
Value: "LINE" LAN connection
"NET" Connected to a NET unit
Default value: "NET"
Access: Read, conditional write
DT Device Type
The type of the IND object.
Data type: Text keyword
Value: "NONE" Undefined
"MW" Semi-graphic workstation
Default value: "MW"
Access: Read, conditional write
90
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
MO Monitor Number
The object number of the connected monitor, that is the MON object corresponding
to the workstation.
Data type: Integer
Value: 0 ... 100, MONn:B object number. Value 0 means that the input
device is not connected to any SYS 600 monitor.
Default value: 0
Access: No restrictions
TT Translation Type
The operating state of the input device.
Data type: Text keyword
Value: "NONE" Off, out of use
"LOCAL" Normal operating state
Default value: "NONE"
Access: No restrictions
91
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
92
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
8.1. General
LIN objects
The LIN objects describe the links and connections to adjacent nodes - base systems
and communication units. All node connections must be defined as LIN objects, but
several nodes can be connected to the same link and use the same LIN object
definition. The object number 'n' of the LIN objects can be freely chosen in the range
1 ... 20.
A base system may use the following links:
• A LAN link to external base systems and communication frontends
• One or two RAM links to internal NET units
• One or more integrated links to PC-NET units
93
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
LT Link Type
The type of the link. This attribute must be given for all types of links.
Data type: Text keyword
Value: "NONE" Undefined
"RAM" Common RAM
"LAN" LAN (TCP/IP)
"INTEGRATED" A PC-NET unit
Default value: "NONE"
Access: Read, conditional write
When an INTEGRATED link is created, the integrated PC-NET program is started,
provided that the SC attribute has been given correctly, see below.
When an INTEGRATED link is deleted (by setting the LT attribute to "NONE"), the
PC-NET program is stopped and all the process objects located in the PC-NET are
marked old, i.e. their status is set to 2 (OBSOLETE_STATUS).
TR Transport
The type of LAN protocol. This attribute is defined only for LAN links (LT =
"LAN"). The only possibility is TCP/IP, which is also the default value.
Data type: Text keyword
Value: "TCPIP" or "NONE"
Default values: "TCPIP"
Access: Read, conditional write
SC Start Command
The location and name of the executable program of the PC-NET unit and the
location and name of the configuration file.
Data type: Text
Value: The name of the program including path if not in the
\sc\prog\exec directory and the name of the configuration file, if
not \sc\sys\active\sys_\pc_net.cf1. These two names are
separated with a blank space.
Default: "INTNET"
Access: Read, conditional write
94
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
Examples:
;both the program and configuration file given
#SET LIN3:BSC="\sc\prog\exec\pc_nets.exe
\sc\sys\active\sys_\pc_net_conf.txt"
#SET LIN3:BSC="\sms\prog\exec\pc_nets.exe \sms\sys\active\sys_\pc_net.cf1"
;default configuration file \sc\sys\active\sys_\pc_net.cf1 used
#SET LIN3:BSC="\sc\prog\exec\pc_nets.exe"
EN ENQ Limit
The maximum number of ENQs (response requests) that the base system will send.
If the base system does not receive response when this limit is reached, an error
status is produced.
Data type: Integer
Value: 0 ... 65 535
Default value: 3
Suggested value: 3
Access: No restrictions
NA NAK Limit
The maximum number of NAKs (negative acknowledgements) accepted by the base
system. When this number is reached, the base system regards the message
transmission as failed and an error status is produced (16105).
Data type: Integer
Value: 0 ... 65 535
Default value: 3
Suggested value: 3
Access: No restrictions
RE Redundancy
The type of checksum added to each message.
Data type: Text keyword
95
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
TI Timeout Length
The time limit applied when the nodes are waiting for response to a message or
polling packet.
Data type: Integer
Value: 0 ... 65 535
Unit: Seconds
Default value: 2
Suggested value: Depending on the Baud Rate
Access: No restrictions
DC Diagnostic Counters
A counter of all major events and error situations of the communication link.
Data type: Vector
Value: A vector of 16 non-negative integer values.
Indexing: Counter number
Access: No limitation
Each line has 16 diagnostic counters numbered 1 ... 16 and with the following
meanings:
1. TRANSMITTED MESSAGES
A counter that is incremented whenever a message is transmitted
successfully. A successful transmission includes the reception of a
positive acknowledgment (ACK).
2. FAILED TRANSMISSIONS
A counter that is incremented when a message transmission fails. The
transmission has failed if no positive acknowledgment (ACK) is
received in spite of retrials. The counter is also incremented if the states
of the modem signals CTS and DCD prevent transmission.
3. TRANSMIT TIMEOUTS
A counter that is incremented each time a time-out occurs during
response waiting. If for example 3 timeouts occur at the transmission
of a message (with retrials), the counter is incremented 3 times. When
the retry limit is reached, finally also the counter 2 is incremented once.
4. TRANSMITTED ACKS
A counter that is incremented each time when a positive
acknowledgment (ACK) is transmitted.
96
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
5. TRANSMITTED NAKS
A counter that is incremented each time when a negative
acknowledgment (NAK) is transmitted.
6. TRANSMITTED ENQS
A counter that is incremented on ANSI X3.28 lines each time an
enquiry (ENQ) is transmitted. Does not concern RAM links.
7. RECEIVED ACKS
A counter that is incremented each time a positive acknowledgment is
received from the line.
8. RECEIVED NAKS
A counter that is incremented each time a negative acknowledgment
(NAK) is received from the line.
9. RECEIVED ENQS
A counter that is incremented on ANSI X3.28 lines each time an
enquiry (ENQ) is received from the line. Does not concern RAM links.
10. Not in use.
11. RECEIVED MESSAGES
A counter that is incremented each time a message has been received
from the line without errors.
12. PARITY ERRORS
A counter that is incremented when a received message is rejected
because of a parity error.
13. OVERRUN ERRORS
A counter that is incremented when a received message is rejected
because of an overrun error.
14. CHECK SUM ERRORS
A counter that is incremented when a received message is rejected
because of a discrepancy in the checksum (BCC or CRC).
15. FRAMING ERRORS
A counter that is incremented when a received message is rejected
because of a framing error.
16. BUFFER OVERFLOW ERRORS
A counter that is incremented when a received message is longer than
259 bytes and therefore does not fit into the message buffer.
CX Comment Text
A freely chosen comment text.
Data type: Text
Value: Text, up to 255 characters
Access: No restrictions
97
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
98
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
9.1. General
NOD objects
The NOD objects represent nodes in the SYS 600 system. The following devices
and communication programs must be defined as NOD objects in a base system:
• Other base systems, which will communicate with the base system in question.
• NET units (PC-NET units and DCP-NET units) which will communicate with the
base system in question, directly or indirectly.
• Frontends (communication frontends) if their attributes (see Chapter 14) should
be accessed from the base system.
• Gateways (protocol converters) of various types.
• OPC Data Access Servers that are used as a data source for the process database.
• OPC Alarm and Event Servers that are used as a data source for the process
database.
The NOD object numbers are global and must coincide throughout the entire
network. They must also coincide with the system object node numbers (NET object
numbers) defined in the communication units (see Chapter 14).
99
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
'n' The object number of the node in the other base system. See the
TT attribute, Chapter 6.
An alternative way of using freely chosen object names is described in Chapter 4.
LI Link Number
The number of the LIN object that defines the link along which the node is reached.
See Chapter 8.
Data type: Integer
Value: 0 ... 20
Default value: None
Access: No restrictions
This attribute is irrelevant for OPC nodes. The OPC servers are addressed by OP and
RN attributes.
NT Node Type
The type of the node.
Data type: Text keyword
Value: "SYS" Base system
"NET" NET unit (PC-NET unit or DCP-NET unit)
"MFL" Communication frontend
"MW" Semi-graphic workstation
"GATEWAY" Gateway
"OPC_DA" OPC Data Access Server
"OPC_AE" OPC Alarm and Event Server
100
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
"UNKNOWN" Unknown
Default value: "UNKNOWN"
Access: No restrictions
For other than OPC server nodes, this attribute does not have to be set. If node
diagnostics is enabled, it will set the attribute according to the reply from the remote
node. The value of the attribute is purely informative.
For OPC server nodes, the attribute must be set to "OPC_DA" or "OPC_AE" to start
the communication with the server. The computer where the server is running is
specified by the RN attribute, see below. The communication may be stopped by
setting NT to "UNKNOWN", and restarted by setting it back to "OPC_DA" or
"OPC_AE".
RN Routing Node
Specifies another node as the router for this node.
Data type: Integer
Value: 0 ... 250. The node number (NOD object number) of the routing
node. 0 = No routing.
Default value: 0
Access: No restrictions
All the messages sent to this node are re-routed to the node specified by the RN
attribute. A routing node is useful when the node defined by the NOD object is not
directly connected to the base system.
When the node type is "OPC_DA" or "OPC_AE", the RN attribute specifies the
physical node where the OPC server is running (0 = the current SYS node).
For nodes of other types, the current SYS node cannot be specified as the routing
node.
Only one-step routing is allowed, the node specified by the RN attribute of another
node may not be re-routed. For example, if the RN attribute of node 1 is 2, the RN
attribute of node 2 must be 0.
Example:
Base system A is connected via LAN to another base system B (with nd = 1), which
contains an internal NET unit (with nd = 10). Use the following definition in the
base system A:
#SET NOD10:BRN = 1
Example:
In the case shown in the Fig. 9.2.1.-1, define the RN attribute of the base system
NOD as the node number of the frontend (MFL node) or NET unit. The messages to
the base system are addressed to the frontend or NET unit. The messages are then
forwarded to the base system.
101
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
LAN
Base system
NOD Illustration_of_RN.eps
SA Station Address
The station address of the node used by the SYS 600 internal protocol ACP.
Data type: Integer
Value: 0 ... 255
Default value: 0
Access: No restrictions
The station address is a number, which must be unique among all nodes (base
systems and communication units) in the entire SYS 600 system. When assigning
station addresses, also the station addresses of the stations using the ANSI protocol
must be regarded as these use the same numbering. For base systems, the station
address is the value of the SYS:BSA attribute. For communication units it is
NETn:SSA.
Nodes that do not communicate with the ACP protocol, such as OPC server nodes,
need no station address.
DI Diagnostic Interval
The time in seconds between diagnostic messages from the base system to the node.
Data type: Integer
Value: 0 ... 65 535
102
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
0 = No diagnostics
Unit: Seconds
Default value: 0
Access: No restrictions
DT Diagnostic Timeout
The timeout of diagnostic messages, that is, the time the base system waits for a
reply to a diagnostic message sent to the node.
Data type: Integer
Value: 0 ... 65 535
Unit: Seconds
Default value: 60 seconds
Access: No restrictions
When the node type is "OPC_DA" or "OPC_AE", this attribute has no meaning. The
diagnostics is enabled by the DI attribute alone.
LT Last Transaction
The transaction number of the last transaction (RP570 or SPA protocol) that the
NET unit has sent to the base system. The attribute is updated only in the stand-by
base system and applies to the NET nodes. See the LT attribute in Chapter 14.
Data type: Integer
Value: Integer
Access: Read-only
Example:
#SET NET1:SLT = NOD1:BLT
RT Registration Time
The moment of time when the node last sent a message to the base system.
Data type: Time
Value: Time of last received message
Access: Read-only
The attribute can be used for supervising NET units. Note that the time is not
updated with messages that are replies, for example to diagnostic messages.
103
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
CX Comment Text
A freely chosen comment text.
Data type: Text
Value: Any text, up to 255 characters
Access: No restrictions
OP OPC Server
OPC server configuration.
Data type: List
Value: Various attributes described below.
The following two attributes are meaningful for any node object
that describes a connection to a remote computer:
US Text, the user name (optional)
This attribute is used to connect an OPC client to the
server as a user other than MicroSCADA. The name may
be prefixed by the domain name, for example
"DOMAIN\USER"
PW Text, the password of the user specified by US (optional)
This attribute is hidden when evaluating the OP attribute
in SCIL.
The following three attributes are valid fo OPC_DA and
OPC_AE type nodes:
CI Text, the class id (CLSID) of the OPC server in the
standard Windows format, e.g.
"{CE0322A9-65A9-4268-84D5-DD7A17E94C56}"
SN Text, the name of the server (optional, for SCIL use only).
Used by the Namespace Browser of the Object Navigator,
as an example.
SK Text, the server kind. This value is used to take vendor
specific actions in the server - client communication.
If SK is not given (or is unknown to the base system), a
generic server with no vendor specific features is
assumed.
The currently recognized values are:
"AC 800" ABB AC 800 series
The A&E client performs an automatic
refresh when it receives the (vendor-
specific) NeedsRefresh event from the
server.
The following attribute is valid for OPC_DA type nodes:
104
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
105
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
106
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
10.1.1. General
STA objects
Each station which is communicating with the base system and is not of the default
STA type (the attribute SYS:BDS) or connected to a communication unit other than
the default NET unit (the attribute SYS:BDN) must be defined as a STA object.
Stations of the default STA type connected to the default NET unit need not be
individually defined. Devices that are not communicating with base system, such as
star couplers in LONWORKS®1 networks need not be defined as STA objects in the
base systems.
107
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
AP Application Number
The number of the application that is connected to the STA object.
Data type: Integer
Value: 0 ... 250
Default value: 0
Access: Read-only
CS Communication State
The state of communication between the station and the base system.
Data type: Text
Value: "NONE" No communication
"RUNNING" Communication established
"SUSPENDED" Communication lost
Default value: "NONE"
Access: Read-only
CX Comment Text
A freely chosen comment text.
Data type: Text
Value: Any text, up to 255 characters
Access: No restrictions
108
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
ND Node Number
The node number of the communication unit to which the station is connected.
Data type: Integer
Value: 0 ... 250
Default value: SYS:BDN
Access: No restrictions (see below)
The node number of the NET unit is the same as the NET system object number.
If the station type of the station is "OPC" or "OAE", the ND attribute is the node
number of the node object that specifies the OPC server of the station (see
Chapter 9).
For proxy stations (see Section 10.1.2.3), this is a read-only attribute that reflects the
ND attribute of the active station. When no connection to the process has been
established, its value is 0.
This attribute has no functional purpose for the base system if the station is an image
station (MR = "IMAGE"). However, it may be set for documentation or application
purposes.
109
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
110
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
If the value of the attribute is an empty list (the default value), the application default
specified by the similar SM attribute of the application object is applied, see Section
6.6.1.
ST Station Type
The type of the station. Some of the station types are predefined. Other types can be
defined with the STY objects described in the next section.
Data type: Text keyword
Value: Station type name:
"NONE" Undefined
"STA" Stations using the ANSI X3.28 protocol: Allen-
Bradley PLC, Westronic D20 and M4000,SRIO,
SELMA and SCPmicro
"SPA" SPACOM connected to a NET unit via the
SPAprotocol or via a LONWORKS line and an LSG
device
"REX" REx relays (REF, RED, REC, etc.) connected via a
LONWORKS line
"RTU" S.P.I.D.E.R. RTU
"PCL" Procontrol 214
"SIN" Sindac stations using the ADLP80 protocol
"SID" Sindac stations using the ADLP180 protocol
"PAC" PAC-5, LED & Keyboard interface
"SAT" SATTCON Central Station through the COMLI
Slave connection
"RCT" PROCOL Station Interface
"LCU" Local Control Unit (Load Management)
"IEC" International Electrotechnical Commission
standard protocol. IEC 60870-5-101 and IEC
60870-5-104 for upper level and process level
communication, IEC 60870-5-103 for process level
communication
"DNP" Distributed Network Protocol for upper level and
process level communication
"OPC" Any field device exposing its data via an OPC Data
Access Server
"OAE" Any field device exposing its data via an OPC
Alarm and Event Server
Additional station type names defined by STY objects, see
Section 10.2.
Default value: SYS:BDS
Access: No restrictions
111
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
TB Time Bias
Time bias, as minutes, between the local time of the base system and the local time
of the station. The local time of the station is calculated by adding TB to the local
time of the base system. This attribute has no meaning if the value of TR attribute is
not "STA".
Data type: Integer
Value: -1440 ... 1440 (minutes)
Default value: 0
Access: No restrictions
TR Time Reference
The time reference of the station. Specifies how the time stamps sent by the station
are to be interpreted.
Data type: Text keyword
Value: "LOCAL" Local time of the base system
"UTC" UTC time
"STA" Local time different from the base system
Default value: "LOCAL"
Access: No restrictions
If value "STA", i.e. local time different from the base system’s local time, is
specified, attribute TB must be set to tell the bias.
112
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
TT Translation Type
The operating state and location of the station.
Data type: Text keyword
Value: "NONE" Off, out of operation
"ALIAS" The STA object number refers to another
STA object
"EXTERNAL" Connected to a communication unit (the
normal case)
Default value: "NONE"
Access: No restrictions
UN Unit Number
The number of the unit (in the application specified by attribute AP) that is
connected to the STA object.
Data type: Integer
Value: 0 ... 50000
Default value: 0
Access: Read-only
AE Analog Events
The addresses of the analog input objects that are considered as event objects in
mirroring and redundant communication.
Data type: Integer or text vector of any length
Value: Each element defines an object address of an analog input object
that is to be considered as an event object. The object address is
given as a text (IN, Item Name) for "OPC" type stations, or as an
integer (OA, Object Address) for other stations.
Default value: Empty vector
Access: No restrictions
An ’event object’ here means that every update of the object value is significant and
may not be sacrificed for communication throughput.
Notes:
1. The value may be set only as a whole. Single vector elements may not be set.
2. In mirroring, the value of this attribute is in use only when the mirroring role
(MR) of the station is "HOST" or "BOTH".
3. In mirroring, he value of this attribute is checked only when a subscription of
process events is received from an image application. If, during the mirroring
113
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
HS Host Station
The location of the host station of this (image) station.
Data type: List
Value: Attributes of the list:
APL The number of the (external) host application
UN The unit number within the host application.
UN value 0 refers to the system messages of the host
application.
Default value: LIST(APL = 0, UN = 0)
Access: May be set only when MR is "IMAGE" or "BOTH", otherwise
no restrictions
This attribute is cleared (APL and UN set to 0) when attribute MR is set to "NONE"
or "HOST".
IS Image Stations
The locations of the image stations of this (host) station.
Data type: Vector of 10 list type elements
Value: Attributes of each element:
APL The number of an (external) image application
UN The unit number within the image application.
Default value: Each element defaults to LIST(APL = 0, UN = 0)
Access: May be set only when MR is "HOST" or "BOTH", otherwise no
restrictions
This attribute is cleared (APL and UN of each vector element set to 0) when attribute
MR is set to "NONE" or "IMAGE".
114
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
The value of this attribute is checked only when the process database
is set up. If an immediate effect after a change is required, the
mirroring of the station must be stopped and then restarted (for
example by setting MR to "NONE" and then back to "HOST").
MR Mirroring Role
The role of the station in the mirroring environment.
Data type: Text keyword
Value: "NONE" Not participating in mirroring
"HOST" Host station (sending process data to one or more
image stations in external applications)
"IMAGE" Image station (receiving process data from the host
station in an external application)
"BOTH" Acts both as an image and as a host station in a
hierarchical mirroring system
Default value: "NONE"
Access: No restrictions (see notes below)
Notes:
1. Setting MR to "NONE" clears HS and IS (APL and UN are set to 0).
2. Setting MR from "BOTH" to "HOST" clears HS.
3. Setting MR from "BOTH" to "IMAGE" clears IS.
10.1.2.3. Redundancy
Overview
A redundant station configuration consists of
• one IED with redundant communication with the base system, or
• two redundant IED’s and their independent communication with the base system.
In the first case, the events received by the base system via the two communication
links are identical. In the second case, time stamps of the events may differ slightly
and polled values (typically analog values) are received at mutually independent
intervals.
115
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
Redundancy roles
A redundant station is described by three interconnected STA objects:
1. The proxy STA object represents the redundant station for the application. It is
not directly connected to the IED.
2. The primary STA object represents the primary communication route between
the base system and the IED.
3. The secondary STA object represents the secondary communication route
between the base system and the IED.
The role of each STA object in the redundancy is defined by their RR (Redundancy
Role) attribute. Each proxy STA object contains references to its primary and
secondary STA object (attributes PS and SS), and each primary and secondary STA
object contains a reference to its proxy STA object (attribute RS).
116
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
Switch-over
When the connection to the IED via the currently active STA object has been lost,
the base system automatically switches to use the stand-by STA object, if it is in
RUNNING state. The buffered events of the stand-by STA are browsed and new
events (the events not received via the lost connection) are fed into the process
database. Communication between SYS 600 and the IED then continues normally
via the new route. No events are lost nor duplicated.
When both connections to the IED have been established (or re-established after a
connection break), the PR (Prefer Primary) attribute of the proxy STA object is
examined by the base system. If it is set to 1 and the secondary STA is currently
active, a switch-over to the primary takes place.
An application event (APL_EVENT) is generated for each change of active station,
see the Application Objects manual.
Buffering scheme
An event received via the stand-by route is buffered if
• it is newer than the value stored in the process database, or
• it is as old as the value in the database but the values are different.
Here, the event time stamps are considered equal if they differ less than 10
milliseconds. This allows for a small synchronization bias between redundant
IED’s.
Not all analog values are kept, they are buffered according to the scheme used in
mirroring. The policy is configured by the LP (Load Control Policy) and the AE
(Analog Events) attribute of the proxy STA object, see Section 10.1.2.2.
Up to 10 000 events per station are buffered.
HSB systems
When redundant (hot stand-by) SYS 600 systems are used, another type of
redundancy may be used: The IED (or a redundant IED pair) may send its events to
both HSB base systems, even if the target application is hot only in one of them.
The events sent to the cold application that is in HOT_RC shadowing phase are
buffered by the base system exactly like the events received via the stand-by route
in the redundant station scheme described above. The situation may be seen as an
analog of a redundant station, where the events received by shadowing come from
the ’active station’ and the events from the communication unit come from the
’stand-by station’.
When the receiving application becomes hot at HSB switch-over, the buffered new
events that have not been received via shadowing are fed into the process database.
Again, no events are lost nor duplicated.
The HSB functionality described here is totally automatic, no configuration is
needed.
Note that the behavior at HSB switch-over is independent of station redundancy. It
works in the same way for redundant and non-redundant stations. As a consequence,
External OPC DA Clients do not have to do their own buffering to cope with HSB
117
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
Attributes
The attributes related to redundant stations are described below. In addition,
attributes AE (Analog Events) and LP (Load Control Policy) are applied to
redundant stations, see Section 10.1.2.2.
AS Active Station
The active station of a proxy station.
Data type: Integer
Value: 0 No active station (or no redundancy)
1 Primary station
2 Secondary station
Default value: 0
Access: No restrictions
This attribute is relevant to PROXY objects only. In other STA objects, its value
must be 0.
When read, the attribute tells which one of the two routings currently feeds the
process database. By default, the routing is automatically selected by the base
system.
When set to 1 or 2 (or the STA object is created with AS value 1 or 2), the routing
is forced to the given value. Automatic routing is disabled.
When set back to 0, automatic routing is re-enabled.
PR Prefer Primary
Defines whether the base system should prefer the primary to the secondary station
in its automatic routing.
Data type: Integer
Value: 0 Do not prefer the primary station (or no redundancy)
1 Prefer the primary station
Default: 0
Access: No restrictions
This attribute is effective only when the secondary station is the active station and
the primary station becomes RUNNING. If PR is set to 1, the base system in this
situation switches to use the primary routing.
118
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
PS Primary Station
The station number of the primary station of a proxy station.
Data type: Integer
Value: 0 ... 50000
Default value: 0
Access: Settable only when TT = "NONE", otherwise no restrictions
This attribute is relevant to PROXY objects only. In other STA objects, its value
must be 0.
RR Redundancy Role
The redundancy role of the STA object.
Data type: Text keyword
Value: "NONE" No redundancy
"PROXY" The STA object defines a redundant (logical)
station.
"PRIMARY" The STA object defines the primary
connection to a redundant station.
"SECONDARY" The STA object defines the secondary
connection to a redundant station.
Default value: "NONE"
Access: Settable only when TT = "NONE", otherwise no restrictions
RS Proxy Station
The station number of the proxy station.
Data type: Integer
Value: 0 ... 50000
Default value: 0
Access: Settable only when TT = "NONE", otherwise no restrictions
This attribute is relevant to PRIMARY and SECONDARY objects only. In other
STA objects, its value must be 0.
SS Secondary Station
The station number of the secondary station of a proxy station.
Data type: Integer
Value: 0 ... 50000
Default value: 0
Access: Settable only when TT = "NONE", otherwise no restrictions
This attribute is relevant to PROXY objects only. In other STA objects, its value
must be 0.
119
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
Configuration example
The following piece of SCIL code configures a redundant station.
The primary and secondary STA object are first created but not started, because the
proxy STA does not yet exist. After the proxy has been created, the primary and the
secondary are ready to start.
#CREATE STA101:B = LIST(ST="SPA", ND=50, TN=1, TT="NONE",-
RR="PRIMARY", RS=100)
#CREATE STA102:B = LIST(ST="SPA", ND=51, TN=1, TT="NONE",-
RR="SECONDARY", RS=100)
#CREATE STA100:B = LIST(ST="SPA", ND=0, TN=0, TT="EXTERNAL",-
RR="PROXY", PS=101, SS=102, PR=1)
#SET STA101:BTT = "EXTERNAL"
#SET STA102:BTT = "EXTERNAL"
10.2.1. General
Station types
The predefined station types listed in the ST attribute description in Section 10.1.2.
are not enough for all possible station types. Using the STY object additional station
types can be defined provided that they can use an existing database interface (the
database interface of a predefined station type). Using the STY object also some
properties of the predefined station types can be accessed.
The station types are internally recognized by an integer 0 ... 33. The station types
with numbers 0 ... 21, 29 … 30 and 32 ... 33 are reserved for predefined types. Other
station types are reserved as follows:
• Type number 22 for the "SPI" type (stations connected via RP570 slave protocol).
• Type number 23 for "LMK" stations (stations on LONWORKS lines, other than
REx and SPA).
The station types can be given freely chosen names. However, it is recommended
that you use the names given in Table 10.2.1-1 because these are the names used on
NET unit. The table lists some station types and the corresponding database
interfaces.
Table 10.2.1-1 Station types and the corresponding database interface
Name Database
Station type
(recomm.) interface
120
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
where
'n' the internal station type number, 1 ... 33. The following station type
numbers are preset:
3 STA
4 RTU
5 SIN
6 PCL
7 SID
8 PAC
9 SAT
17 REX
20 LCU
21 SPA
22* SPI
23* LMK
24* ADE
25* PCO
26* WES
27* ATR
28* PLC
29 IEC
30 DNP
32 OPC
33 OAE
121
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
"UNKNOWN"
"SPONTANEOUS"
"INTERROGATED"
"HISTORY"
Indexing: 1 ... 255. The value of the process object attribute CT
Default value: The CT attributes of the STY objects are all initialized to
"UNKNOWN", except for the following REX device values:
STY17:BCT1 "SPONTANEOUS"
STY17:BCT2 "INTERROGATED"
STY17:BCT3 "HISTORY"
Access: No restrictions
Example:
If a device of type 17 (REX_DEVICE) updates a process object's CT attribute to
value 2, the attribute STY17:BCT2 defines the reason of that transmission
(“INTERROGATED by default).
CX Comment Text
A freely chosen comment text.
Data type: Text
Value: Any text, up to 255 characters
Access: No restrictions
DB Data Interface
Specifies the predefined station type whose data interface will be used. When a new
station type is defined, it must use the same data interface as a predefined station
type, see Table 10.2.1-1. The predefined interface is used when NET unit issues
commands to the stations of the new type.
Data type: Text keyword
Value: The three-letter station type name of a predefined station type,
see Table 10.2.1-1
Access: Read-only, configurable
Example:
Creating a station type "SPI" (type 22):
#CREATE STY22:B = LIST(NA = "SPI", DB = "STA")
122
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
The value of this attribute is checked only when the process database
is set up for mirroring. If an immediate effect after a change is
required, the mirroring of the stations of the type must be stopped
and then restarted (for example by setting MR to "NONE" and then
back to "HOST").
NA Type Name
The name of the station type.
Data type: Text
Value: Text of max. 10 characters
Access: Read-only, configurable
123
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
124
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
11.1. General
125
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
where
'm' The logical application number of an external application (see the TT
attribute in Chapter 6)
'n' The object number of the printer in the other base system
An alternative way of using freely chosen object names is described in Chapter 4.
DC Device Connection
The type of the printer connection. See examples considering DT attribute below to
see how to use the attribute for different connection and printer types.
Data type: Text
Value: "NONE" No printer
"LINE" Printer connected directly to the base system
computer or to a LAN via a printer server
"NET" Printer connected to a NET unit
"CONSOLE" Printer connected to LPT1
Default value: "NET"
Access: Read, conditional write
DT Device Type
The type of the printout - color, black-and-white or “transparent”.
Data type: Text keyword
Value: "NORMAL" Black and white printout. No color
information is sent to the printer and
graphical characters are replaced with
ASCII characters. If the printer is
connected to a NET unit, the printer must
be defined with PRIn:SPT = 1 in the
communication unit.
"COLOR" Color printout. Color information and all
graphic characters are sent to the printer.
The printer must be connected to a NET
unit where the printer must be defined
with PRIn:SPT = 3, 5, 6 or 7.
126
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
TT Translation Type
The operating state of the printer. See examples considering DT attribute above.
Data type: Text keyword
Value: "NONE" Off, out of use
"LOCAL" Normal operating state (independently of the type
of connection)
127
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
ND Node Number
The node number (NOD object number) of the NET unit to which the printer is
connected, if the printer is connected to a NET unit. See examples considering DT
attribute above.
Data type: Integer
Value: 1 ... 250, node number of NET unit
Default value: None
Access: Read-only, configurable when TT = "NONE"
128
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
Default value: No
Access: Read-only, configurable when TT = "NONE"
CS Control Sequences
Printer control sequences.
Data type: Text vector
Value: A text element containing the bytes to be sent to the printer, or a
printout vector as described for the PRINT_TRANSPARENT
function (the 'data' argument), see the Programming Language
SCIL manual. The printout vector may contain texts (control
codes), printer control commands and print processor commands
as described in the Programming Language SCIL manual, but
not vectors. The text values may be given as expressions.
Indexing: The indices are the printer control commands used by the
PRINT_TRANSPARENT function
Suggested values: Use the following conventions:
1 New Line Start a new line
2 New Page Start a new page
3 Reset Reset the printer settings.This command is
automatically executed between two print
jobs.
4 Init Initialise the printer.This command is
automatically executed when the printer is
started or reset by CL attribute.
Access: No restrictions
This attribute is a vector of printer control sequences (printer commands and control
codes) specifying the printer control commands used by the
PRINT_TRANSPARENT function, see the Programming Language SCIL manual.
Each element of the vector specifies a control sequence that can be defined as a text
value containing the bytes to be sent to the printer. It can also be a vector of text
values, printer control commands and print processing commands. A control
sequence is referred to by the index of the element. The control sequences are printer
interface dependent. However, by using the same conventions for all printers, the
PRINT_TRANSPARENT function can be used equally independent of printer type.
If track-keeping of page numbers and line numbers is in use (the LP attribute is set),
the print processor (PRNC) tries to count the lines of the through-passing output
flow. The New Line as well as New Page commands are accounted for. However,
there is no possibility for the print processor to know which control sequences move
the paper vertically. Therefore, use the print processor commands Increment LN and
Increment PN to notify about such moves (in the CS vector element or in the print
vector defined by the PRINT_TRANSPARENT function)
129
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
Example:
For example, if the printer is a simple ASCII printer, CS(1) (the control sequence for
New Line) should contain the two-byte text calculated as ASCII(13) + ASCII(10)
(CR / LF).
HF Header Format
The header text produced on each printed page when page numbering is in use (PN
> = 0). The text can contain constant as well as variable text.
Data type: Vector
Value: A vector with text elements
Indexing: If "COLOR" or "NORMAL" printout:
1 The header text. The variables included in the text are
indicated with number signs ### where each sign
represents a character. The variables are defined with the
subsequent elements in the vector.
2 The value of the first variable in the header text
3 ... The value of the second variable in the header text, etc.
If "TRANSPARENT" printout:
A vector of the same format as the CS attribute, see above. The
vector is sent to the printer as header text.
Access: No restrictions
Example:
Header for "COLOR" or "NORMAL" printout:
HF(1) == "EVENT LIST ######## PAGE ###"
HF(2) == "DATE"
HF(3) == "%PN"
LN Line Number
The line count of the printed text, starting from 1. Possible header lines are included
in the count.
Data type: Integer
Value: Positive integer
Access: Read-only
130
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
Default value: 72
Access: No restrictions
PN Page Number
The page numbering and the generation of headers for printouts. The feature applies
to the automatic process printout (event and alarm printout) and printout started by
the #LIST command and #PRINT commands if the FORM_FEED variable is = 0. It
does not apply to pages printed with !SEND_PIC or #PRINT with FORM_FEED <>
0, nor to pages produced by documentation tools. Such pages do not get any header
and are not included in the printout numbering.
If page numbering is in use, a variable %PN that contains the page number is
automatically generated and can be used in the header text, the HF attribute, see
above.
Data type: Integer
Value: 0 = The printer has page numbering and header text.
Negative values = The page numbering and the headers are not
in use.
Default value: 0
Access: No restrictions
131
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
period. See the LL attribute below. The name contains the following information
('nn' = PRI object number, 'yy' = year, 'ww' = week number, 'mm' = month, 'dd' =
day):
Storing printout in a printer log is possible even if the printer does not exist
physically. Hence, you can define virtual printers, that is, PRI objects without
corresponding physical printers, to get the printout exclusively to printer log files.
The maximum size of the files is determined by the computer resources and the
operating system.
If a printer has a printer log, everything sent to the printer is copied to the printer log,
independent of how the printout is activated (with #PRINT, #LIST or !SEND_PIC,
or automatically from the process database) or from which application the printout
is activated (several applications can use the same printer). As the printout can
contain picture elements, the printer log files contain the same characters as the
printout to a black and white ASCII printer.
LD Log Directory
The directory where the printer log is stored on disk. The directory is given including
complete path in the operating system format.
The attribute has no meaning if OD = "PRINTER". The PRI object attribute OD
defines the output destination of the log.
Data type: Text
Value: 0 … 255 characters, see the Programming Language SCIL
manual for the allowed characters.
Default value: "" (an empty text string) which means the directory /sc/sys/
active/sys_
Access: Read, conditional write
Define the path starting from the root if the attribute will be used
with the #PATH command.
132
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
LL Log Length
The period - day, week, month or year - during which the printer log is written to
one file. When a new period begins (always at midnight, 00:00:00), the log switches
to a new file.
The attribute has no meaning if OD = "PRINTER". The PRI object attribute OD
defines the output destination of the log. See below.
Data type: Text keyword
Value: "DAY", "WEEK", "MONTH", "YEAR"
Default value: "DAY"
Access: Read-only, configurable when TT = "NONE"
OD Output Destination
Defines if the printout to the printer will be copied to a printer log on disk or not.
Data type: Text keyword
Value: "PRINTER" Printer output only
"LOG" Log output only
"BOTH" Both printer and log output
Default value: "PRINTER"
Access: Read, conditional write
133
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
CL Printer Control
Enabling control of the printer and facilitating a redirection of the printout to another
printer, for example in error situations.
When redirecting the printout from one printer to another using this attribute, the
jobs in the input queue of the printer are moved to the input queue of the new printer.
Setting the attribute is meaningful only if the printer is in normal operating state
(TT = "LOCAL").
Data type: Text or integer
Value: "CANCEL" Cancels the current job (format, screen or
picture document) and starts the next
"REPRINT" Restarts the current print job
"RESET" Cancels the current job and all jobs queued
for the printer. The printer will continue with
the next new job.
"STOP" Cancels all jobs and stops the printer. The TT
attribute is set to NONE.
"PAUSE" Stalls the printer until a "GO" is issued
"GO" Continues after PAUSE
n Redirects the printouts to printer number 'n'
(integer). The current and queued jobs are
output to the log file of the present printer (if
any), but not to the printer. The TT attribute
of the printer is automatically set to
"ALIAS" and TN to 'n'.
Access: Write-only
Example:
#SET PRI5:BCL = "STOP"
134
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
ST Printer State
The present state of operation of the printer.
Data type: Text keyword
Value: "IDLE" No jobs to print
"BUSY" Printing a job
"WAITING" The system is waiting for the printer, for
example, when the printer buffer or NET
unit buffer is full.
"STALLED" Stalled due to a PAUSE command (#SET
PRIn:BCL = "PAUSE")
"STOPPING" Finishing before stopping (after a "STOP"
command)
Access: Read-only
CX Comment Text
A freely chosen comment text.
Data type: Text
Value: Any text, up to 255 characters
Access: No restrictions
SV System Variables
Global variables used in tools, etc. The attribute should not be used in application
programs.
Data type: Vector
Value: Defined by ABB
Default value: A vector of 10 integer 0’s
Access: No restrictions
UV User Variables
Global variables for use in application programs.
Data type: Vector
Value: Defined by the application
Default value: A vector of 10 integer 0’s
Access: No restrictions
135
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
136
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
12.1. General
The Base System Object Navigator tool is an on-line tool that provides the
following common functionality:
• Recognizing of the base system objects in SYS 600 system.
• Viewing of the base system related attributes and their values.
• Editing of the base system object related attribute values (see certain limitations
later on).
• Adding of base system objects.
Because the tool is an on-line tool, the modified attribute values or added base
system objects affect only the running system. If there is need to configure the
system permanently, the changes should be made to base system configuration files
(e.g. SYS_BASCON.COM).
137
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
138
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
(e.g. 10, or 1 - Enabled). If an attribute value has a certain unit for the values, the
unit information is included into the end of attribute description inside the brackets
(e.g. Shadowing Flush Time [ms].
When an attribute is selected in the tool, the help text of an attribute is displayed in
the information bar of the tool.
New Object dialog is displayed and an object number is requested from the user.
When adding a monitor object, a monitor type is asked from the user. Depending
from the base system object type to be added, different set of attributes need to be
specified by the user, before the base system object adding may proceed, e.g. for a
new application object, at least the following information needs to be specified:
• Application name or
• Operating state (Translation Type, TT) attribute.
If an error occurs during the creation of base system object, an appropriate message
box is shown to the user with additional status information.
139
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
Fig. 12.4.-1 Base System Object Navigator tool on the System Configuration page
of Tool Manager.
The Base System Object Navigator tool page includes a menu bar and a toolbar,
which can be selected from the Option > Toolbar Visible menu. Below the toolbar,
there is an object tree on the left, an attribute tree in the middle and an attribute
editing area on the right hand side. In addition, there is an information text bar at
the bottom of the page.
SCTPage1
Fig. 12.4.-2 The menu bar, tool bar, object tree and attribute tree in the Base
System Object Navigator tool.
140
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
SCTPage1
Fig. 12.4.-3 The attribute area and attribute edit area in the attribute tree of the
Base System Object Navigator tool.
141
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
SCTPage1
Fig. 12.4.-4 The attribute area and edit area for structured attributes in the
attribute tree of the Base System Object Navigator tool. By clicking
Notify button after editing saves the given value.
142
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
Fig. 12.5.-1 The Expand and collapse buttons and pop-up menu for the attribute
tree.
143
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
The Shadowing Applications page shows information from the local watchdog
application and shadowing applications (see Fig. 12.6.-2).
Fig. 12.6.-2 The Shadowing Applications page of the HSB Management tool.
Selecting a shadowing application and clicking the Edit button starts the edit dialog
of the application (see Fig. 12.6.-3).
144
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
13.1. General
Features
The communication system objects and their attributes specify the NET unit
configurations and handle the process communication. Each NET unit (NET) has
its own set-up of system objects. The communication system objects give the NET
unit an image of the communication lines and the connected "devices". The
connected “devices” may be:
• Other communication units
• Base systems
• Applications in the connected base systems
• Stations (RTUs, PLCs, protection equipment, central stations, etc.)
• Printers
During operation, the communication system objects are included in the
communication program running in the RAM memory of the NET unit (DCP NET
units) or host PC (PC NET units).
Function
Each "device" connected to the process communication system - base system,
application, communication unit, printer and station has a device image. The device
image is in form of a communication system object in the NET unit to which it is
directly connected. The communication system object attributes of the unit describe
the data communication with the devices.
The base systems and communication units are regarded as nodes. These devices are
defined by NET or NOD objects in each NET unit where they are to be recognized,
even if they are not directly connected to it (see Fig. 13.2.-1). As the node numbers
are recognized by each communication unit, a message can be routed to a device
connected to another node.
145
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
The application engineer can configure the communication network, define routes,
control I/O devices and RTUs, read diagnostic counters, handle system messages,
etc. using the communication system objects and their attributes.
146
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
Workstations
Operator
Console
Fig. 13.2.-1 The communication system objects defined in the shaded NET unit
that may be an internal DCPNET or a PCNET running in the base
system. The unbolded and unmarked devices require no object
definitions in the NET. (If the shaded NET is a PCNET, no printer can
be connected to it.)
147
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
APL objects
The APL communication system objects refer to applications in the connected base
systems. Each application known to the NET unit must be defined as an APL object.
A NET unit can recognise up to 250 APL objects (applications).
The attributes of the application objects are accessed using the NOD (NET) object
notation and giving the APL object number as the index.
STA objects
This system object type is used to supervise and control properties of connected
stations - RTUs, protective equipment, central stations, etc. Each station connected
to the NET unit must be defined as a STA object. The STA objects specify and
handle, e.g.:
• The data transfer to and from stations
• RTU diagnostics (type of diagnostic commands used, diagnostic counters)
• Response waiting timeout
• Operational status (in use or not in use)
The STA objects are defined in different ways and have different attributes
depending on the station type they represent. There are also separate series of object
numbers for the different station types.
One NET unit can be connected to up to about 200 stations (depending on the total
configuration of the unit). There can be 20 stations defined in the preconfiguration,
the rest must be defined with SCIL into a command procedure executed by APL-
INIT1 (DCP-NET unit) or into the PCNET unit.COM file (PC-NET unit) read on
execution command from APL-INIT1.
PRI objects
Each printer connected to the NET unit must be defined as a PRI object. The PRI
objects describe printer features, such as:
• Printer type (colour printer, black and white printer, etc.)
• Operational status (In use or not in use)
148
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
Principles
Connecting a new device to a NET unit requires that the corresponding system
object is defined in that unit. This is a condition for the physical connection to
work. Defining a new communication system object means that it is assigned a type
specific object number and a line number. The procedure is:
• Defining the line to be used by assigning it the desired protocol (the PO attribute,
see Chapter 15).
• Giving the line its communication properties using the line attributes (Chapter
15).
• Creating the object by giving it an object number and assigning it the line
number.
• Setting the attributes of the created object.
• Taking the line and the device into use.
The communication system objects of DCP-NETs can be defined in a
preconfiguration (see below). PC-NET units have no preconfiguration but an
initialization file that contains the most elementary object definitions. The
configuration of the NETs can be extended and modified on-line using SCIL or
tools.
In SCIL, the objects are defined using the #SET command. New communication
system objects are created with the device specific NETn:S attributes NE, SY, ST,
RT, PC, PR, etc. which are described in Chapter 14. The communication system
objects cannot be created, deleted nor modified with the SCIL commands
#CREATE, #DELETE and #MODIFY.
The preconfiguration of a DCP-NET unit is stored in the communication program
and is therefore not lost though the NET unit is stopped. The on-line and start-up
system object definitions are stored only as long as the NET unit is running. If it is
stopped or restarted, the on-line configurations are lost.
149
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
On-line configuration
In addition, the communication system objects can be written on-line with
application dependent command procedures and pictures, with SCIL or with tools.
For example, they can be written with command procedures started by the event
channels APL_INIT_1, APL_INIT_2, and APL_INIT_H, see the Application
Objects manual. It is also possible to build command procedures that are started at
each start-up of a NET unit.
For PC-NET units there is a configuration file, where the SCIL definitions are
written. It is named PCNET.COM. This file is a text file, which is read by the
command procedure executed by the APL_INIT event channel at start-up.
150
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
Table 13.3.-1 An overview of the communication system object definitions required for various
configuration projects
Configuration Basic Definition Other definitions and properties
Defining NET unit to itself Node number (NN) NETn:Sat The NET attributes in Chapter 14
Set in the preconfiguratIon of ‘n’ = node number
DCP-NET units and in the ‘at’ = attribute
configuration file of PC-NET
units
Defining NET lines PO attribute = protocol NETn:Satl Line attributes in Chapter 15.
‘l’ = line number
Defining connected NET External nodes in NETn:Satm NET attributes in Chapter 14.
units preconfiguration ‘m’ = node number of
NE attribute = object number NET unit
Defining connected base External nodes NETn:Satm NET attributes in Chapter 14.
systems NE attribute
Defining applications NET attribute SY NETn:Sata NET application attributes, Chapter
‘a’ = application number 14.
Defining connected stations NET attributes in Chapter 14. STAn:Sat STA object attributes in Chapter 16.
Defining connected printers NET attribute PR in Chapter PRIn:Sat Printer attributes in Chapter 17.
14.
Supervising and Controlling Not defined in NET unit. NETn:Sat Frontend NET attributes in Chapter
frontends 14.
13.4. Attributes
General
The system object attributes are of two types:
• Configuration attributes, which affect the system configuration of the NET unit
but do not cause any immediate data exchange with connected devices.
• Communication attributes, which cause data communication between different
devices but do not affect the system configuration.
Attribute access
The communication system object attributes are of the following main access
levels:
• Read-only: The attribute cannot be written either on-line or in the
preconfiguration. There are still a few exceptions in which the values can be
reset.
• Not preconfigurable, otherwise no restrictions: The attribute can be given
values on-line, but not in the preconfiguration. Otherwise the attribute can be
read and written without restrictions.
• Read, conditional write: The attribute can be given values with #SET, provided
that the object first is taken out of use (IU = 0).
• Write-only: The attribute cannot be read, only written with #SET command. It is
not stored in NET unit, but transmitted directly to a station.
151
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
• Write-only, not preconfigurable: The attribute cannot be read, only written with
#SET command. It is not stored in NET unit, but transmitted directly to a station.
The attribute can be given values on-line, but not in the preconfiguration.
• No restrictions: The attribute can be read and written without restrictions.
The terms above are used in the subsequent attribute descriptions. With
preconfiguration it is meant that a DCP-NET Unit is configured with Netconf or
NET Preconfiguration tool. PC-NET is configured with the System Configuration
tool or by using SCIL statements, so the limited access rights for preconfiguration
are not valid for PC-NET Unit.
152
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
14.1. General
Object Notation
From SCIL the NET attributes of the NET unit itself is accessed with the notation
(the NOD and NET names are equivalent):
NODn:Sat (or NETn:Sat)
where
'n' The object number (= node number) of the unit, 1 ... 250
153
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
NN Node Number
The NET object number. The number is defined when the NET object is created in
the preconfiguration or with the NET attribute NE (Section 14.3). As a rule the
attribute should be regarded as read-only.
Data type: Integer
Value: 1 ... 250
Access: Read-only, configurable
Example:
The NET number of an external NET (base system or communication unit) is
changed (not recommended):
#SET NET1:SNN2 = 3
SA Station Address
The ACP station address of the NET object (communication unit, base system or
communication frontend). The station address is used in all communication between
nodes. The address must be unique among all NETs and base systems in the entire
network. At on-line station address configuration the communication program
checks that this uniqueness is maintained.
Data type: Integer
Value: 1 ... 254
154
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
Indexing: If no index is used, the attribute means the station address of the
NET itself. If an index or index range is given, the attribute value
is the station addresses of the external NET node specified by the
index.
Access: No restrictions
Example:
Defines that the NET2 connection in NET1 will have the station address 27:
#SET NET1:SSA2 = 27
TL Translation Limit
The maximum number of logical destination translations accomplished on the same
message. The attribute concerns node data communication (NET-NET
communication), that is communication with other communication units and base
systems.
This attribute prevents messages from circulating eternally in a network composed
of several nodes (for example because of some configuration error).
Data type: Integer
Value: 1 ... 255
Default value: 10
Suggested value: 5 (normally there is no need to change the default value)
Access: No restrictions
155
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
KP Known Protocols
The protocols supported by the NET in question.
Data type: Vector
Value: Vector of integer elements representing the number codes of
known protocols, see the PO attribute in the Chapter 15.
Access: Read-only
Example:
The NET version NET_NC1_82 would return a vector with the following elements:
(1,2,3,4,7,15)
NT Node Type
The type of the node: NET, base system, communication frontend, workstation or
gateway.
Data type: Integer
Value: 0 ... 6:
0 Unknown
1 Base system
2 NET (communication unit)
3 Communication frontend (MFL)
4 Semi-graphic workstation (MicroWORKSTATION)
6 Gateway
Default value: 2
Access: Read-only
VE Program Version
The version number and generation date of the NET program, for example 8.2A, or
the version identification of the communication frontend program (MFL).
Data type: Vector
Value: Vector of three elements
Indexing: 1 Version number as a text
2 Generation date as a text
3 Program generation time as an integer counted
from the formula 10000 * hours + 100 * minutes +
seconds
No index Index 1 (only possibility for MFL nodes)
Access: Read-only
156
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
157
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
System Messages
APL
History Buffer
Process
Database
.
OS = 2 Alarm Handling
.
.
.
.
Object
Event Command
. Channel Procedures
.
. MI
Data Invalidation
MS
Configuration Control
PRINTER
RTU
Process Control Operator Messages
System_message_handling.eps
MI Message Identification
The object addresses (the OA process object attribute) of the process objects, which
will receive the system messages generated by the device. At the generation of a
system message, the status code of the message is updated in the OV attribute of
the process objects. The process objects are specified by the MI attribute in the
application specified by the MS attribute. The status code is not registered if there
are no fictitious process objects with the specified address. NET unit generates
three types of system messages, which are directed to process objects as follows:
General NET messages: MI
Messages related to application diagnostics: MI + 50
Messages related to redundant frontends: MI - 100
If the NET node attribute SE (System messages enabled) has a value 4, a binary
process object is updated at the same time as the analog process object mentioned
above. The binary process object must be of type ANSI Binary Input and its unit
158
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
159
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
MS Message Application
The communication system object number of the application, which receives the
system messages from the device. If the application is suspended, the message is
sent to the first application that is not suspended in number order.
The NET start-up system message code (10001) is sent to all known applications,
independently of the MS attribute.
Data type: Integer
Value: Integer in the range 1 ... 250. Application number as known to
the communication unit.
Access: No restrictions
Example:
If MS == 3, the system messages related to the NET unit are sent to the application
defined as number 3 in the NET unit
160
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
Note 3: The default station type defined with SYS:BDS may have an effect on
the default OB value of the created binary status point. If the created
point is not updating as expected, the OB attribute should be checked
and modified to 0 if non-zero.
LI Line Number
The number of the communication line, to which a node (another communication
unit or a base system) is connected. If the node is indirectly connected to the
communication unit, the attribute is the number of the line to the nearest node. The
line number is selected when the connected NET object is created.
Data type: Integer
Value: 1 ... 8
Indexing: The NET object number of the connected NET unit
Access: Read-only
Example:
!SHOW LINE NET3:SLI2
161
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
NE NET
Adding and removing the NET objects of connected nodes - communication units
and base systems.
When adding a node, the NE attribute is assigned the value of the connection line,
which must have been defined as an ACP, RAM or Integrated Link line (see Chapter
15). The line number for a node that is connected indirectly via other communication
units is the line number of the nearest communication unit. Internal communication
units are connected to the base system on line number 13. Likewise, the base
systems connected to a communication frontend via a LAN or a COM port is defined
on line number 13. When adding a node (that is a new NET object), an error code is
produced if the object already exists.
When removing a NET unit, the attribute is assigned a "D". Removing a node means
that the NET object, including all its attributes, is deleted.
A new NET object gets certain default attribute values listed in appendix A. If a NET
object is created in the preconfiguration, only those attributes that cannot be
preconfigured get default values. The other ones get the values given in the
preconfiguration.
Data type: Integer
Value: Adding an object: Integer, 1 ... 8. Line number. The line must be
a common RAM, ACP or Integrated Link line.
Removing an object: Text: "D".
Indexing: The object number, node number, of the NET object. The
number must be unique within the entire SYS 600 network.
Access: No restrictions
Example:
A NET3:S object is added to line 4 of NET2:
#SET NET2:SNE3 = 4
162
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
14.3.2. Applications
All applications that will communicate with a NET unit, that is, all applications that
will receive any type of messages from NET unit (spontaneous messages, data,
system messages, etc.), and all application that will write system configuration data
in NET unit must be defined as APL objects in the unit. An application is defined by
the node number of the base system, the APLn:B object number in the base system
in question and by an APLn:S system object number (device number). Up to 16
applications can be defined in the preconfiguration of DCP-NET units. Using SCIL,
applications are defined by means of the SY attribute described below.
SY Application
Adding, removing and redefining an APL object, that is an application, with SCIL.
Adding an application means that an APL object is created. Removing an
application means that the APL object, including all its attributes, is deleted. A
previously created APL can be redefined, for example, so that it refers to an
application in another base system.
Data type: Vector or integer
Value: When adding or redefining an application: Vector or two
integers (node, appl):
'node' The node number of the base system where the
application is found
'appl' The application number as known to the base
system in question
When removing an application: 0
When read: 10000*node + appl
Indexing: The communication system object number of the APL object,
1 ... 250
Access: No restrictions
Example:
The application 5 (APL5:B) in the base system with node number 9 is defined to
the NET unit NET1 as APL5:S:
#SET NET1:SSY5 = (9,5)
163
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
In the preconfiguration tools, and in this manual, the station types are denoted by a
three-letter abbreviation as follows:
STA Station using the ANSI X3.28 protocol
RTU S.P.I.D.E.R. RTUs or Collector
SIN SINDAC connected via the ADLP80 protocol
PCL P214 RTUs
SID SINDAC connected via the ADLP180 protocol
PAC PAC-5
SAT SATTCON/COMLI
REX REx relays - REF, REL, REC, RED, etc. - connected via LON
LCU Load Control Unit, LCU500
SPA SPA modules connected directly to a NET unit or to a LONWORKS line
via an LSG device (a LON/SPA gateway)
SPI Stations connected via the RP570 slave protocol
LMK LSG devices connected to LONWORKS lines and other LONWORKS
devices (for example a Weidmüller node), but not REX type stations.
Some other station types can be defined as exchangeable device types, see Section
14.3.4..
All types of stations, except REX and LMK, can be connected to the DCP-NET
units, while only the RTU, REX, SPA and LMK stations can be connected to the PC-
NET units.
The STA object numbers must be unique for a certain station type, but STA objects
of different types can use the same object number. Stations of the types SPA, RTU,
PCL and LCU use station number 0 for broadcast station. This station is
automatically created by the communication unit.
Instead of a complete device image, the STA (ANSI stations) and PRI type system
objects can contain a reference to another system object. The system object has to
be of same type in the same or in another communication unit. See Fig. 14.3.3.-1.
These system objects have no attributes. Each time the NET unit reads the name of
a system object, the object number is interpreted according to a translation table. The
translation of an object name gives a device image in the same communication unit,
or a reference to another system object name of the same type defined in the same
or in another unit. A NET unit can know one device image and one reference under
the same name (the same object number). If a system object has both a device image
and a reference to another object, the reference precedes the device image, and the
device image is searched according to the reference. Hence, a switch between the
devices is obtained by adding or deleting a reference object. Reference objects can
not be added in the preconfiguration.
A new STA object (if it is a real device image) is assigned certain default values,
which are given in the STA object descriptions in Chapter 16. If a STA object is
created in the preconfiguration, only those attributes, which cannot be preconfigured
get the default values, the other attributes get the values given in the
preconfiguration.
164
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
Basesystem
Application Software:
STA1:S..
Translation according to the
basesystem configuration
STA:S in node no 1.
Communication Communication
Unit, NET 1 Unit, NET 1
STA1:S STA2:S
Translation
Translation
ANSI_stations.eps
Fig. 14.3.3.-1 Provided that the stations are of type ANSI, the notation STA1:S in
an application program can refer to either station 1 or station 2. A
switch from station 1 to station 2 is obtained for example with the
statement: #SET NET1:SST1 = (2,2). PRI objects can be used in a
corresponding way.
LM LMK Stations
Creating STA objects corresponding to stations on LON: LSG devices and other
process devices connected to LON. However REF, RED and REC protective relays
are created with the RE attribute instead of LM attribute (see below).
165
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
The NET line number to which LMK is connected must be defined as a LONWORKS
line.
Data type: Integer
Value: Adding an object: Integer, 1 ... 8. Line number. The line must be
defined for the LonTalk protocol.
Removing an object: Text, "D"
Indexing: Integer, 1 ... 255. The STA object number of the station. The
number must be unique for STA objects of type LMK.
Access: No restrictions
Example:
Creating a LMK station (the STA attributes are described in Chapter 16.):
1. Creating a LonTalk protocol line:
#SET NET1:SPO1=27 ;LonTalk protocol on NET line 1
#SET NET1:SIU1=1 ;taking the line in use
PA PAC-5
Defining and removing STA objects corresponding to PAC - 5.
Data type: Integer or text
Value: Adding a device: Integer, 1 ... 8. Line number. The line must
have been defined for the PAC-5 protocol.
Removing a device: Text, "D"
Indexing: Integer 1 ... 255. The STA object number. The number must be
unique for STA objects of type PAC.
Access: No restrictions
PC Procontrol P214
Defining and removing STA objects corresponding to P214 RTUs.
Data type: Integer or text
Value: Adding a device: Integer, 1 ... 8. Line number. The line must
have been defined for the P214 protocol.
Removing a device: Text, "D"
Indexing: Integer 0 ... 255. The STA object number. The number must be
unique for STA objects of type P214. 0 = broadcast station
(created automatically).
Access: No restrictions
166
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
RT S.P.I.D.E.R. RTU
Defining and removing STA objects corresponding to S.P.I.D.E.R. RTUs or
Collector 100 and 300.
Data type: Integer or text
Value: Adding a device: Integer, 1 ... 8. Line number. Stations type
S.P.I.D.E.R. RTU require the RP570 protocol, and stations of
type. Collector the ADLP180 Master protocol.
Removing a device: Text, "D"
Indexing: Integer, 1 ... 512. The STA object number of the station. The
number must be unique for STA objects of type S.P.I.D.E.R.
RTU. 0 = broadcast station (created automatically).
Access: No restrictions
RX REX Stations
Creating STA objects of station type REX (REC, RED, REF, etc.)
Data type: Integer or text
Value: Adding a device: Integer, 1 ... 8. Line number. The line must
have been defined for the LonTalk protocol.
Removing a device: Text, "D"
Indexing: Integer 1 ... 255. The STA object number. The number must be
unique for STA objects of type REX.
Access: No restrictions
167
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
Indexing: Integer 1 ... 255. The STA object number. The number must be
unique for STA objects of type SPI.
Access: No restrictions
SP SPACOM
Creating STA objects corresponding to SPA units (SPACOM modules or other
stations) using the SPA or LonTalk protocol.
It is possible to configure about 200 SPA devices to one PC-NET. In one PC-NET,
there can be a maximum of 12 SPA lines created. The amount of SPA devices in one
SPA line could be about 30. Because SPA is a master/slave polled protocol, the
number of devices per lines affects directly the performance and response times of
the systems. Especially the analog value update times are sensitive to the system
configuration, because usually they have to be polled one by one. Therefore, the
more devices you have per line, and the more there are configured analog
measurements, the slower the response time in the system. In other words, if you
want the response times to be rather fast, spread the SPA devices to as many lines as
possible.
168
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
Connecting SPA units to a LONWORKS line requires LSG device, which must be
defined as an LMK type station with the LM attribute in the NET unit.
Data type: Integer or text
Value: Adding an object: Integer, 1 ... 8. The number of the NET line to
which the station is physically connected. If connected to LON,
the line is the number of the NET line to which the LSG device
is connected. The line must be defined for the SPA or LonTalk
protocol.
Removing an object: Text, "D"
Indexing: Integer, 0 ... 255. The STA object number of the station. The
number must be unique for STA objects of type SPACOM.
STA0 = broadcast station that is created automatically.
Access: No restrictions
ST Substation
Defining and removing STA objects corresponding to stations using the ANSI
X3.28 protocol. If ANSI half duplex is used, several stations can be situated on the
same line.
Data type: Integer, text or vector
Value: Adding a device image: Integer, 1 ... 8. Line number. The line
must be defined for the ANSI protocol.
Removing a device image: Text, "D"
Adding a referencce: A vector of two integers of the form
(NETnr, device nr) where 'NET nr' is the object number of the
NET where the STA object number is translated, and 'device nr'
is the translated object number.
Removing a reference: 0
Indexing: Integer, 1 ... 255. The STA object number of the station. The
number must be unique for stations using the ANSI x3.28
protocol
Access: No restrictions
Example:
STA number 5 is added to line 4 of NET1:
#SET NET1:SST5 = 4
Addition of the system object STA20 in NET1. STA20 refers to STA3 in NET1:
#SET NET1:SST20 = 10003
Addition of the system object STA4 in NET1. STA4 refers to STA2 in NET2:
#SET NET1:SST4 = 20002
Removal of the logical name STA20:
#SET NET1:SST20 = 0
169
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
DV Device
Adding and removing devices of exchangeable device types. The device type must
have been defined with the ED attribute. In PC_NET, this attribute can also be used
to create stations of fixed type numbers if the protocol is supported.
Data type: Vector
Value: Write: Vector of two elements:
Element 1: Communication system object number.
Limits:
For device type 4=RTU 1 ... 512
Element 2: Line number, when adding a device "D", when
removing a device
Read: The defined device numbers of the given device
type. 0 = undefined
Indexing: Write: One index, the device type code 24 ... 31 or fixed
device type codes 3 ... 23
Read: 1000 * type code + object no
Access: Not preconfigurable, otherwise no restrictions
Example:
A station of type number 24 (ADEMCO) is added on line 3 as STA2:
#SET NET1:SDV24 = (2,3)
The variable A will get the value 0 if no such object is defined, otherwise the value
5:
@A = NET1:SDV24005
170
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
PR Printer
Adding and removing a printer with SCIL, that is a PRI object, or a reference to
another PRI object.
Data type: Integer, text or vector
Value: Adding a device image: Integer, 1 ... 8. Line number.The line
must be defined as an ASCII line.
Removing a device image: Text, "D"
Adding a reference: A vector of two integers of the form
(NETnr, device nr) where 'NET nr' is the object number of the
NETwhere the PRI object number is translated, and 'device nr' is
the translated object number
Removing a reference: 0
Indexing: The object number (1 ... 8) of the new object as known by the
NET in question.
Access: No restrictions
171
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
Example:
Printer number 2 is removed:
#SET NET1:SPR2 = "D"
DS Diagnostic Status
The current status of the connection between the applications and the NET unit.
Data type: Vector
Value: Vector of integer values, 0, 1 or 255:
0 Suspended
172
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
1 OK
255 Undefined
Indexing: Application object number in NET unit (1 ... 250)
Access: Read-only
Example:
A is a vector with the status of all applications known to NET1:
@A = NET1:SDS(1 .. 250)
173
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
Example:
The suspension time for APL5 is set to 2 seconds:
#SET NET1:SSU5 = 2
CS Clock Status
The status of an internal or external PC31/PC32 clock in the communication
frontend.
Data type: Vector
Value: Vector with two elements:
Index 1: 0 = Clock time invalid (not synchronized), or no
C31/32 clock installed
1 = Clock time valid (synchronized)
Index 2: Last status byte value read from the PC31/PC32
clock (internal)
174
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
DC Diagnostic Counter
The values of the 16 diagnostic counters of the communication interfaces of the
communication frontend. The counters have the following meanings:
3. TRANSMITTED MESSAGES/TELEGRAM
4. FAILED TRANSMISSIONS
5. TRANSMITTED TIMEOUTS
6. TRANSMITTED ACKS
7. TRANSMITTED NAKS
8. TRANSMITTED ENQS
9. RECEIVED ACKS
10.RECEIVED NAKS
11.RECEIVED ENQS
12.RECEIVED EOTS
13.RECEIVED MESSAGES/TELEGRAMS
14.PARITY ERRORS
15.OVERRUN ERRORS
16.CHECK SUM ERRORS
17.FRAMING ERRORS
18.BUFFER OVERFLOW ERRORS
Data type: Integer
Value: 0 ... 30000
Indexing: 100 * interface nr + counter number
where 'interface nr' = board number 1 ... 4 for RAM interfaces
(see the System Configuration manual), 5 (=COM1) or 6
(=COM2) for RS232-C interfaces, and 7 ... 10 for LAN
interfaces (in the order defined in MFLCONF.DAT)
Access: Read-only, values can be reset
Example:
The value of counter number 1 on LAN interface 1:
@COUNTER = NET5:SDC701
DI Diagnostic Interval
The time between base system diagnostic commands sent by the communication
frontend. The attribute is the value of the DI parameter defined in MFLCONF.DAT.
Data type: Integer
Value: 0 = Diagnostic turned off
175
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
Unit: Seconds
Indexing: 1 ... 4, base system interface number
Default value: 15
Access: No restrictions
RS Running Status
Reloads and starts the communication units in the communication frontend.
Data type: Integer
Value: 3 = Reload and start all NET units of the communication
frontend
Access: Write-only
Example:
#SET NET5:SRS = 3
TM Time
Reading and writing the frontend time. When the frontend time is set with this
attribute, the time of all NET units is set as well.
Data type: Integer
Value: Vector with (year, month, day, hour, minute, second,
milliseconds)
Access: No restrictions
176
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
RM Running Mode
The redundancy mode of the NET unit. Using this attribute, the redundancy mode
can be changed during operation.
Data type: Integer
Value: 0 Single, no redundancy
1 Redundant Hot
2 Redundant stand-by
Default value: The initial mode is read from the common RAM of the
communication frontend, where it can be written by MFL (the
CMOD parameter in MFLCONF.DAT). If no initial mode is
found there, the default mode is SINGLE (RM = 0).
Access: Not preconfigurable, otherwise no restrictions
SH Shadowing State
The shadowing state of the NET unit - sending or receiving state. By setting the SH
attribute to 0 (= no shadowing), the shadowing is stopped and the data transfer from
the hot FE to the stand-by FE is disabled.
Data type: Integer
Value: 0 None. No shadowing
1 Sending
2 Receiving
Default: 0
Access: No restrictions
177
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
FM Free Memory
The amount of free memory in the NET unit.
Data type: Integer
Value: Integer
Unit: Bytes
Access: Read-only
LP Local Port
The LAN protocols created to NET nodes will reserve IP port numbers for their
interprocess communication. In case there are multiple NET nodes using the same
local IP address and same line numbers, there is a limitation of creating these lines.
This limitation is described in the protocol specific manuals in the description of the
line attribute LD. In large systems, where it necessary to create multiple NET nodes
and tens of LAN protocol lines using the same local IP-address, it may necessary to
override this limitation by setting a new base value for the reserved port number
range using the NET node attribute LP, local port. In practice, this means that a
unique value of LP for each NET node instance should be given.
The rules for setting LP:
basevalue: This could be the default 2502 or an unassigned value from the TCP/
UDP port number list maintained by IANA (Internet Assigned
Numbers Authority).
offset: This should be 12 or more (256 or more if IEC60870-5-104 redundancy
is used).
The assigned values should be:
NET'a':SLP = basevalue
NET'b':SLP = basevalue + offset
NET'c':SLP = basevalue + offset*2
178
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
The value of LP should be set before creating the NET lines using LAN protocols.
If the maximum amount of the communication lines (12) is created to the NET node,
the reserved port numbers are LP ... LP + 11 (or LP ... LP + 255 if IEC60870-5-104
redundancy is used). Each created line reserves one port from the mentioned range
(16 if IEC60870-5-104 redundancy is used). The port numbers are reserved from the
IP addresses defined by the line attribute LD.
Data type: Integer
Value: 1024 ... 65280
Default value: 2502
Access: No restrictions (see setting rules above)
Example:
#set NET1:SLP=2514 ;ports 2514 .. 2525 reserved
SYS 600 versions 9.2 and older have used a fixed basevalue of 2502 in each NET
node. The default value of LP will provide the same characteristics as the previous
versions.
The following port numbers are reserved by the listed protocols for
external communication. The port number range defined by LP should
not overlap these values:
2404 IEC60870-5-104 slave
12221 SYS 600 Remote VS Monitors
20000 DNP3.0 LAN/WAN slave
20000 DNP3.0 LAN/WAN master (in UDP mode only)
21845,
21846 SYS 600 LAN Link
All master protocols using TCP/IP (IEC60870-5-104 master, DNP3.0
TCP master, Modbus TCP, SPA-TCP) are operating as TCP clients.
Consequently, no protocol specific port numbers are reserved.
179
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
Example:
The transactions occurred after the last received transaction is transmitted to the
application that issues the command:
#SET NET1:SLT = NOD1:BLT
MA Mailbox
The content of a buffer, which can be freely used for transferring messages between
NET unit and the base system. When NET unit is started, all elements in the MA
attribute are set to zero. After that, the attribute can only be changed with SCIL. The
attribute can, for example, be used for checking that NET unit has started (provided
that the attribute has been set to another value than 0 previously).
Data type: Vector
Value: A vector of 250 real or integer elements
Indexing: 1 ... 250 real elements, 1001 ... 1250 integer elements
Access: No restrictions
TM Time
The time of the NET unit in SYS 600 time format (32 bits integer). Using this
attribute, the time can be written manually. The attribute is used for the
synchronization of NET from the base system (if the radio clock resides in the base
system), or for synchronization of the base system from NET unit. The base system
is synchronized from NET unit when the radio clock is connected to NET unit. If
there is a radio clock in the base system computer, the time of an internal NET unit
is automatically set according to the radio clock time.
Data type: Integer, vector
Value: Integer or vector of three integer elements
Indexing: No index or SYS 600 time data given as an integer (with a
index 1: resolution of one second). Index 1 cannot be given
time values older than 80-01-01 (63072000).
Index 2: The milliseconds of the SYS 600 time
Index 3: Increments the current NET time with the given
number of milliseconds
Index 3 is used for adjusting the NET time after a coarse time
setting using index 1. Index 3 can be given negative values,
which means a decrease of the NET time with the given number
of milliseconds.
180
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
The NET time is set in accordance with the base system time on millisecond level
and incremented with 50 milliseconds, which is an estimation of the time consumed
for transmission and execution of the command. An exact time setting, taking into
account the execution time, requires a more extensive procedure:
@A = HR_CLOCK
#SET NET1:STM(1..2) = (A:VCL,(A:VUS DIV 1000))
#SET NET1:STM3 = 50
181
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
182
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
15.1. General
183
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
PC-NETs support the following protocols on the COM lines (lines 1 - 4): ACP, SPA,
RP570/571 master. On the LONWORKS lines, only the LonTalk protocol is supported.
The PC-NET have the same attributes as the board based NETs, except for the line
protocols and the station types that are not supported.
The DCP board based NETs does not support the LonTalk protocol.
Autodialing
Autodialing can be used on all NET serial lines defined for the following protocols:
• ANSI X3.28 Half Duplex or Full Duplex
• ACP (MicroPROTOCOL)
• Modbus
• IEC 1107
• RP570 master protocol
• SPA
• Alpha
• IEC 60870-5-101 master and slave
• IEC 60870-5-103 master
• DNP3.0 master and slave.
Network protocols
Protocols which use the LAN connection are IEC60870-5-104 master and slave,
DNP V3.00/LAN master and slave, Modbus TCP and SPA-TCP. Protocols other
than SPA-TCP are described in the protocol specific manuals also.
For protocols DNP V3.00/LAN master and slave, Modbus TCP and SPA-TCP, the
operation mode which uses network is defined using the line attribute SD. In
general, the IP address of the remote end is defined with the IA station attribute and
the IP address which locally used by the line is defined with the line attribute LD.
Line definition
Using a NET line - serial line or common RAM - requires that it is defined in the
NET in question. A NET unit line is basically defined by assigning it a protocol. This
can be done in the preconfiguration (DCP-NETs) or on-line with the PO attribute
described in Section 15.2.
The line is further specified by a number of line attributes. Depending on the
protocol used on a line, some of the line attributes are applicable some are not. Table
15.1.-1 lists the line protocols and the applicable line attributes.
When a line is defined on-line, its attributes get the protocol specific default values
as given in the attribute descriptions. For preconfigured lines, only those attributes
that cannot be preconfigured get the default values.
Generally, the line attributes can be changed only while the line is out of use (the In
Use attribute, IU, is 0).
184
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
Object notation
The NET line attributes are accessed from SCIL with the notation:
NETn:Sati (or NODn:Sati)
where
'n' NET object number (node number)
'at' The attribute name
'i' An index (normally the line number)
If not otherwise mentioned in the attribute descriptions, all line attributes are
indexed with the NET line number (1...12 and 13).
185
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
ACP and
Protocol RAM Integrated SPA LONWORKS RP570/571 RP570 Slave
ANSI full
Attributes link Master
duplex
Basic attributes
- Basic definition PO PO PO PO PO PO PO
-In Use IU IU IU IU IU IU IU
-System Message MS, MI MS, MI MS, MI MS, MI MS, MI MS, MI
-Other PS LK, PS PS LK, PS PS, SD PM, PS PS
Data transmission RE BR, ER, RD BR, PY, RD BR, PY, RD BR, PY
RE, SB, TD SB, TD RE, SB, TD SB, TD
Communication EN, NA, TI EN, NA, SG, TI EN, NA, TI DE, HT, RL HT, PD, TI DE, EN, HT DE
Control RI, RK, SG
TI, TW
Polling PD, PP, PR AW, CP, PD
PT PP, RP
Autodialing AC, AS, CL AC, AS, CL AC, AS, CL
CN, CS, CT CN, CS, CT CN, CS, CT
DD, MC, PU DD, MC, PU DD, MC, PU
RC, RW, SR RC, RW, SR RC, RW, SR
Communication BO, BU, CF
Loops DR, LU, LS
MD, MT
LONWORKS Conf. NC, XA
Miscellaneous
-Diagnostics DC DC DC DC DC DC DC
-Clock Synchr. LK
IEC 60870-5
Protocol ANSI half ASCII printer General Modbus
(-101 and -
Attributes duplex ASCII
103)
Basic attributes
- Basic definition PO PO PO PO PO
-In Use IU IU IU IU IU
-System Message MS, MI MS, MI MS, MI MS, MI MS, MI
-Other LK, PS PS PM, PS PS LK, PS
Data transmission BR, ER, RD BR, PY, RD BR, PY, RD BR, PY, RD BR, PY, RD
RE, SB, TD SB, TD SB, TD SB, TD SB, TD
Communication DE, EN, HT OS, SG, TI SG, TI DE, EN, HT DE, TW, RK
Control RK, SG, TI SB, RI, TI RI, EN
TW
Polling AW, CP, PD PD PD, PP, PL
PP, RP RP
Autodialing AC, AS, CL AC, AS, CL AC, AS, CL
CN, CS, CT CN, CS, CT CN, CS, CT
DD, MC, PU DD, MC, PU DD, MC, PU
RC, RW, SR RC, RW, SR RC, RW, SR
Communication
Loops
LONWORKS Conf.
Miscellaneous
-Diagnostics DC DC DC DC DC
-Clock Synchr. SF, SS
186
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
PO Protocol
The data transfer protocol used on the line. The line is defined to the NET by setting
this attribute. By setting the attribute to 0 the line definition including all line
attributes are deleted.
When the line is defined, its line attributes get the protocol dependent default values
given in the attribute descriptions. If the line is defined in the preconfiguration
(DCP-NETs), only those attributes that cannot be preconfigured get the default
values.
The DCP-NET program supports the following protocols (plus some other
protocols):
• ACP, Application Communication Protocol. This protocol is used for the
communication between SYS 600 nodes (base systems and communication
units). It is a protocol for point-to-point lines, where both ends transmit
spontaneously. The ACP protocol is based on ANSI X3.28 Full Duplex but
additional features have been added to the upper protocol layers.
• ANSI X3.28 Full Duplex. This protocol is used for the communication with
stations of type Allen-Bradley, SPACOM via SRIO, Westronic D20 and M4000,
DTU1 and 2, SELMA II and SCP-micro. It is a protocol for point-to-point lines,
where both ends transmit spontaneously.
• ANSI X3.28 Half Duplex. This protocol is used for RTU communication on
multidrop lines. The stations are usually polled cyclically. The protocol is used by
the same stations as for ANSI X3.28 full duplex.
• PAC-5. Defined as one link type of ANSI X3.28.
• COMMON RAM protocol. This protocol is used for communication between an
internal NET unit and the base system. It is also used between each NET unit in a
communication frontend and the base systems connected to the communication
frontend, and between the communication units in a communication frontend. It
can be used only on line number 13.
• ASCII printer protocol. This protocol is used for printer communication.
• RP570/571 master protocol. The protocol is used for communication with
S.P.I.D.E.R. RTUs. NET is the master and the connected RTUs are slaves.
• RP570 slave protocol. When using this protocol on a NET line, NET is regarded
as the slave and the communicating device as the master. The master sees NET as
a S.P.I.D.E.R. RTU200.
• SPA protocol for direct communication with SPACOM modules. The protocol is
allowed on max. four lines per NET.
187
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
• The P214 protocol (Indactic 35). The protocol is used for communication with
P214 RTUs (Indactic 35).
• ADLP180 Slave for communication with Sindac and S.P.I.D.E.R. SCADA. The
protocol can be used only on one line per NET.
• ADLP180 Master for communication with Collector 100 and 200.
• COMLI Slave protocol for communication with SATTCON systems. One line
per NET can be used with this protocol.
• LCU500 for communication with LCU500 stations.
• General ASCII for communication with clock synchronization receivers, or
ADEMCO alarm receiver.
• RCOM (Procontic) for communication with Procontic PLCs.
• MODBUS RTU mode master for communication with PLCs, process automation
systems, etc.
• ABB Alpha for communication with Alpha meters.
• IEC 1107 for metering device communication.
• IEC 60870-5 for communication with external device which uses the IEC 60870-
5-103 or IEC 60870-5-101 protocol.
• DNP V3.00 slave and master protocols.
Of the above mentioned protocols, PC-NET supports the ACP, SPA, and RP570
master protocols on the NET line numbers 1 ... 8. When any of the NET lines 1 ... 8
are assigned any of these protocols, the PC-NET reserves the COM port with the
same number for the protocol. The line number cannot be used for the LONWORKS
output channels.
In addition to three mentioned protocols, PC-NET supports the following
protocols, which are not supported by DCP-NET:
• Integrated link for communication with base systems in the same PC. This
protocol can be used only on line 13.
• LonTalk protocol for communication with process units connected to the
LONWORKS network. Such process units are the REx protective relays, SPA relays
via LSG device, and Weidmüller process control devices.
Writing something else than 0 to the attribute is possible only if the line is undefined.
Changing protocol on a line requires that the line definition first is deleted (PO = 0).
Reading the PO attribute for undefined lines returns the value 0.
Data type: Integer
Value: 0 ... 43
0 None. The line is not defined
1 ANSI X3.28 Full Duplex or ACP
2 ANSI X3.28 Half Duplex (HF)
3 Common RAM protocol, allowed only on line 13(RM)
4 ASCII protocol for printer (or printer simulating device)
(AS)
6 COM-1
7 RP570 protocol (SR)
188
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
Defining line 1 of NET number 3 for the SPA protocol and taking the line into use:
#SET NET3:SIU1 = 1
189
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
190
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
The SCIL statement connects NET line number 2 of NET1 with the LONWORKS
device name LONP0 (channel A of PCLTA card 1 if installed according to the
advises in the Installation manual):
#SET NET1:SSD2 = "LONP0"
LD Local Address
The IP address which is locally used. The setting of this attribute is necessary when
the computer has multiple IP addresses and it is defined which address the line must
use. The setting of this attribute must be done before the line has been taken into use
for the first time. This attribute is supported in the IEC60870-5-104 protocols, DNP-
LAN protocols, Modbus TCP protocol and SPA protocol in TCP. For more
information on protocols other than SPA-TCP, read also the protocol specific
manual. This attribute is not available with serial protocols and the LonTalk
protocol.
Data type: Text
Values: String containing a valid IP address, max 29 characters
Access: Read, conditional write
This attribute accepts the IP address in form
#SET NET1:SLD1 = "10.0.0.10"
IU In Use
The state of the line – is it in use or not. When a line is not in use, no data can be
transmitted on it, and no data is received from it. The line attributes can be read as
usual. Generally, a line must be taken out of use by setting this attribute to 0 before
the line attributes can be written.
When a line is stopped by setting the IU attribute = 0, all data transmission on the
line ceases. However, before that, NET executes to the end all on-going data
transactions. E.g., the polling of the station in turn is completed.
191
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
If the line is a LonTalk protocol line, the station objects should be taken into use after
the line object of the stations is set to IU=1. Correspondingly, all station objects
connected to a LonTalk protocol line should be taken out of use before the line
object is set to IU=0.
Data type: Integer
Value: 0 Not in use, the line communication is stopped
1 In use
Indexing: Line number
Default value: 0
Access: No restrictions
LK Link Type
The type of data link connection used on the line. The attribute has no meaning for
the RAM interface and printer lines, nor for LONWORKS lines. (LonTalk protocol
lines do have a LK attribute but this has another meaning.)
Data type: Integer
Value: 0 Direct RS232C connection (used for direct lines, modem
lines and Data Highway)
1 Modem line. A normal RTS CTS modem signal
handshaking is applied
2 VY85 (a special type of radio telephone connection
(mobile telephone link)). Possible only on ANSI X3.28
half duplex lines.
3 Radio telephone. Possible only on ANSI X3.28 half
duplex lines.
4 Radio link. Possible only on ANSI X3.28 half duplex
lines.
6 Data Highway
7 PAC-5 lines
8 A special radio link possible on ANSI X3.28 half duplex
lines. NET checks DCD before trying to send anything. If
DCD is active, NET waits for passive DCD for the time
specified by the TI attribute, the number of times
specified by the EN attribute. Transmission starts when
DCD becomes passive. If DCD does not become passive
within the time EN*TI, the transmission is regarded as
failed and the station is suspended.
9 Modem signals disabled. CTS is not used, and the
transmission starts after a finite delay given by the DE
attribute.
10 RTS is set and transmission starts immediately. No other
modem signals are issued. NET does not wait for CTS
signal. Used on optical lines.
192
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
PM Protocol Mode
The mode of the protocol. The attribute applies to the general ASCII protocol
(PO = 15), RP570/571 master protocol (PO = 7), the RCOM protocol (PO = 17),
SPA protocol (PO = 14), LCO500 protocol (PO = 12) and the Modbus master
protocol (PO = 25).
Data type: Integer
Value: General ASCII:
4 Receive only. This mode is used for ADEMCO alarm
receiver.
5 Time Synchronization receive only. This mode is used for
all clock synchronization receivers, except TAIP.
6 Time synchronization receive/transmit with pulse
synchronization. When the NET line is take into use (IU
set to 1), NET sends configuration messages to the clock
device and continues until it receives a synchronization
message from the clock. Carrier detect signal (CD) is used
for sync pulse receiving. PM = 6 must be used if the sync
format is TAIP (SF attribute = 6). It cannot be used on
lines using other sync formats
RP570/571 master and slave:
0 RP570
1 RP571
RCOM:
0 Event polling disabled
1 Event polling enabled
Modbus master:
0 Modbus RTU mode
1 Modbus ASCII mode
SPA/SPA-TCP:
0 Time synchronization enabled
1 Time synchronization disabled
LCU500:
0 Low priority pulse counter polling
1 High priority pulsecounter polling
193
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
194
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
For more detailed information, the availability of individual buffers can be checked
using the following description. This method is used by various tools.
Data type: Integer vector
Value: 10×line number + 1 Buffer with defined index available
255 Buffer not available
Indexing: 100*line number + 'first' .. 100*line number + 'last'
minimum of 'first' is 1
maximum of 'last' is 99
Access: Read only
Example 1:
@NB = NET1:SNB2 ; the amount of available buffers in the normal
buffer pool of line 2 in NET1 is stored in variable NB
Example 2:
@NB = NET1:SNB(201..299) ; the availability of buffers 201..299 in the
normal buffer pool of line 2 in NET1 is stored in variable NB
195
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
Example 2:
@PB = NET1:SPB(201..299) ; the availability of buffers 201..299 in the
priority buffer pool of line 2 in NET1 is stored in variable PB
MI Message Identification
Object address of system messages. If the NET node attribute SE (System messages
enabled) has a value 4, a binary process object is updated at the same time as the
analog process object defined with MI.
See the MI attribute in Chapter 14 for more information.
Data type: Integer
Value: 1 ... 32760
Indexing: NET line number
Default value: When a line is defined on-line, the MI gets a default value
obtained from the expression:
6000 + (100 * NET number) + line number
This default value can be used as such (copied to the process
object address), or it can be changed.
Access: Read, conditional write
MS Message Application
The number of the application that is the receiver of the system messages generated
by the line.
Data type: Integer
Value: 1 ... 250. The APL object number as known to the
communication unit.
Indexing: NET line number
Default value: 1
Access: Read, conditional write
196
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
The AO attribute is used to define and enable/disable the interface for the analyzer.
When an analyzer is enabled, it can be used to view the transmitted and received
messages. The analyzer module prints out the bytes as they are passed to or returned
from the operating system calls which control the communication hardware. The
timestamp in the output is taken from the local clock of the computer. It defines the
time point of the Read/Write system call made.
The AU attribute is used to format the analyzer output.
AO Analyzer Output
The IP address which is locally used as an interface to the protocol analyzer.
The setting of this attribute is necessary, when there is a need to analyze the
incoming and outgoing messages of a communication line. This attribute is
supported with all protocols. The port number is optional and if used, it must be
separated with a colon.
When an empty string is written to the attribute, the analyzer interface is removed
from the system. When the attribute is read and an empty string is returned, no
interface for this line exists. The analyzer interface operates as a TCP server and any
TELNET program can be used as a user interface. For problem solving it is
necessary to have a possibility to record the analyzer output to a file.
Data type: Text
Value: String containing the IP address "127.0.0.1". The optional port
number is separated with a colon, see examples below.
Indexing: NET line number
Default value: Empty string
Access: Read, write
If the port number is not specified, port number 50 000 + line number is used. Only
the local IP address "127.0.0.1" is supported at the moment.
The analyzer interface reads the bytes sent by the client program, but does not use
them. In case the total amount of the received bytes is bigger than 1024, the TCP
session is closed by the analyzer interface.
Examples:
#SET NET1:SAO1="127.0.0.1:10001"
#SET NET1:SAO10="127.0.0.1"
#SET NET1:SAO1=""
197
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
Note: The given address and port number should not overlap with other TCP servers.
If this situation occurs and the creation of the server fails, no error code is returned,
but the AO attribute will return an empty string if read. Assigning a different port
number is needed in this situation. It is recommended to keep analyzer interface
disabled when not used.
AU Analyzer Usage
This attribute is a bit pattern, which defines the type of the output.
Bit 0: If this bit is 1, the contents of the data messages are printed out. This is the
default operation. If this bit is 0, the contents of the data messages are not printed
out.
Bit 1: If this bit is 1, the changes in the control signals (RTS, CTS, DCD, DTR) of
the RS232 lines and the changes in the TCP connection states with TCP protocols
are printed out. This is the default operation. If this bit is 0, the changes in control
signals are not printed out.
Bits 2..15: Not used, do not set.
Data type: Integer
Value: 0 ... 65535
Indexing: NET line number
Default value: 3
Access: Read, write
Examples:
#SET NET1:SAU1=0 ; printout is disabled
#SET NET1:SAU1=3 ; both data and control signals are printed out
BR Baud Rate
Transmission rate used on the line. The attribute is valid for all serial lines and all
types of protocols using serial lines.
Data type: Integer
Value: 1 ... 19200
Unit: Bits/s
Indexing: Line number
Suggested value: 300, 600, 1200, 2400, 4800, 9600 or 19200. NET allows any
value in the specified range to be used (e.g. 8965), but usually
the setting alternatives of the peer device are limited to the ones
in the list of recommended values.
For printer connections 2400 bits/s is recommended.
Default baud rate is 19200 for IEC 60870-5-103 and 2400 for
IEC 60870-5-101.
198
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
Example:
Example on configuration of Modbus Master line:
¦ PO Protocol 00025 ¦
¦ IU In Use 00000 ¦
¦ MS Message Application 00001 ¦
¦ MI Message Ident. 00000 ¦
¦ LT Link Type 00000 ¦
¦ BR Baud Rate 09600 ¦
¦ SB Stop Bits 00001 ¦
¦ PY Parity 00002 ¦
¦ RD Receiver Data Bits 00008 ¦
¦ TD Transm. Data Bits 00008 ¦
¦ OS Output Synchroniz. 00001 ¦
¦ RE Redundancy 00000 ¦
¦ TI Timeout Length 02000 ¦
¦ NA NAK Limit 00000 ¦
¦ EN ENQ Limit 00003 ¦
¦ DE CTS Delay Length 00050 ¦
¦ ER Embedded Response 00000 ¦
¦ RP Reply Poll Count 00000 ¦
¦ PD Poll Delay 00300 ¦
¦ PS Buffer Pool Size 00016 ¦
¦ PP Polling Period 00001 ¦
¦ CN Connection [Ign] ¦
ER Embedded Response
Indicates if NET transmits embedded responses (ACK, NAK) and ENQ:s within the
messages, see the illustration in Fig. 15.3.-1. The attribute applies to ANSI X3.28
Full Duplex and ACP lines (PO = 1).
The use of embedded responses increases the performance of a line especially when
there is heavy simultaneous communication in both directions. The ER attribute
affects only the transmitter of the communication unit. The NET unit is always able
to pick embedded responses and ENQs from received messages, independent of the
ER value. Some ANSI X3.28 station types may lack support for Embedded
Response.
Data type: Integer
Value: 0 No embedded responses transmitted
1 Embedded responses are transmitted
Indexing: Line number
Access: Read, conditional write
199
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
PY Parity
The parity check (if any) used for the characters transferred on the line. The attribute
is essential for all types of protocols, except common RAM.
Data type: Integer
Value: 0 No parity check
1 Odd parity
2 Even parity
Indexing: Line number
Suggested value: For ANSI X3.28 lines, even parity should be used if the
checksum used (the RE attribute) is BCC (Block Check
Character). If CRC-16 (Cyclic Redundancy Check) is used, no
parity check is needed.
RP570, ADLP80, and SPA lines use even parity.
On printer lines there is usually no parity check.
Default value for IEC 60870-5 is even.
Access: Read, conditional write
RE Redundancy
The type of checksum added to each message. NET knows two types of checksums:
CRC-16 and BCC.
200
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
The attribute applies to the ANSI X3.28 full and half duplex and common RAM
protocols. On ADLP80, P214 and RP570 lines, the checksum is always BCC.
Data type: Integer
Value: 0 No checksum
1 CRC-16 (Cyclic Redundancy Check). Possible only on
ANSI X3.28 lines.
2 BCC (Block Check Character)
Suggested value: On an ANSI X3.28, line one of the checksum types must always
be used. The RE value affects only the checksum type of
message packets. Thus, the checksum used in the polling packets
of the half duplex protocol is always a BCC character (even
though RE would be 1).
Indexing: Line number
Access: Read, conditional write
SB Stop Bits
The number of stop bits attached to each transmitted byte. The attribute applies to
all protocols, except common RAM.
Data type: Integer
Value: 1…3
Unit: Bits
Suggested value: On ANSI X3.28, IEC 60870-5 and RP570 lines: one stop bit is
used.
Indexing: Line number
Access: Read, conditional write
201
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
DE CTS Delay
Time delay between the activation of the RTS signal (Request to Send) and the start
of a new transmission, see Fig. 15.4.-1. The attribute has somewhat different
functions depending on the protocol used on the line.
On ANSI lines:
The half duplex communication is controlled by the RTS and CTS (Clear to Send)
signals of the V.24 interface. When the NET unit has something to transmit (ACK,
NAK, a polling packet or a message), it activates the RTS (Request to Send) signal.
The NET unit also waits for the CTS (Clear to Send) signal to become active. In
some cases, e.g. on some radio lines, the activation of CTS does not guarantee that
transmitted data will go through to the receiver. For example, switching on the
carrier may need extra time.
The DE attribute defines the delay (in milliseconds) from the activation of RTS until
the communication frontend starts transmitting. If DE = 0, the communication
frontend will transmit immediately, when CTS is activated. If DE is larger than 0,
the communication frontend waits the time indicated by DE. When this time has run
out, the communication frontend transmits under the condition that CTS is active.
On RP570 lines:
If the TW attribute (see below) is 0, the DE attribute controls both the CTS wait time
and the transmission delay. If the line does not get CTS (Clear To Send) after DE
milliseconds have elapsed, it will return the message including an error code to the
sender. If DE = 0 the line will start transmitting immediately after it has got the CTS.
However, it will wait for at most 500 ms. If the TW attribute has a value greater than
0, then the transmission delay is controlled by the TW attribute, and the DE attribute
controls only the CTS waiting time.
On P214 lines: Delay after receiving CTS before starting the telegram transmission.
Data type: Integer
Value: 0 ... 65535
Unit: Milliseconds
Suggested value: Up to 500 ms, depending on the link type used. When a fiber
optic modem is used, which is normally the case on SPA lines,
no CTS delay is required.
Default value: 50 ms for IEC 60870-5-101 and DNP V3.00 protocols
Indexing: Line number
Access: No restrictions
202
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
DE - CTS Delay
RTS
CTS
DE = 0: Data
DE > 0: DE
Data
Illustration_DE_attribute.eps
Fig. 15.4.-1 An illustration of the DEattribute on ANSI Half Duplex and RP570
lines
EN Enquiry Limit
The maximum number of times that a telegram is retransmitted after a timeout. The
attribute applies to the ANSI X3.28 full and half duplex and the RP570 protocols.
On RP570 lines a timeout occurs when an RTU fails to respond with a correct
response telegram within the time specified by the HT attribute. When the message
has been sent the number of times specified by the EN attribute, the transmission is
considered as failed and the RTU is suspended. The line returns a command
203
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
including an error code to its sender and the telegram transmission is no more
repeated. On RP570 lines NET starts to send SCIs (Status Check Instructions) to the
suspended RTU.
On ANSI full duplex lines time-out occurs when no ACK or NAK is received to a
transmitted message within the time defined by the TI attribute. The NET unit
transmits an enquiry (ENQ) at most the number of times stated by the EN value. If
no response is received, the NET unit refrains from further retries.
On ANSI half duplex lines time-out occurs when no ACK is received to a
transmitted message, or no response is received (EOT or message) to a polling
packet within the time defined by TI. If no ACK is received, the NET unit
retransmits the message until the EN limit is reached. After this the transmission has
failed and the communication frontend moves on to the following message to be
transmitted onto the line. If a station connected to a half duplex line does not respond
to a polling packet, it is polled at most the number of times stated by the EN value.
After that, the next station will be polled.
Data type: Integer
Value: 1 ... 10
Suggested value: 1 ... 4 (2 ... 3 on RP570 lines)
Default value: 2 for DNP V3.00 protocol
3 for IEC 60870-5-101
Indexing: Line number
Access: Read, conditional write
HT Header Timeout
The maximum waiting time in milliseconds within which the first byte of a response
from the RTU should have been received after the transmission of a message. If no
response has been received within this time, new attempts are performed the number
of times specified by the Enquiry limit. If still no response is obtained, the station is
suspended. Fig. 15.4.-2 illustrates the HT and the TI attributes.
On SPA lines: Max. transmission time of the complete message is calculated
automatically based on the message length and baud rate.
On RP570 lines: If TI = 0, the reception time is calculated automatically. If both HT
and TI are = 0, the program sets HT to 700 ms. If HT == 0 and TI > 0, there is no
separate header timeout supervision, but the entire message must be received within
TI seconds from the end of NET's transmission.
On ANSI Half Duplex lines: The TI attribute value is always used as a timeout for
the complete message, since the length of the received message cannot be
calculated.
Data type: Integer
Value: 0 ... 65535
Unit: Milliseconds
Indexing: Line Number
204
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
TI
HT
In to NET Response
HT_and_TI_attributes.eps
NA NAK Limit
The number of NAK responses that the communication frontend accepts at the
transmission of a message, without considering the transmission failed. The attribute
is essential only for ANSI X3.28 Full Duplex, ACP and RAM lines (PO = 1 or 3).
Data type: Integer
Value: 1 ... 255
Indexing: Line number
Suggested value: 3
Access: No restrictions
OS Output Synchronization
States the flow control principle used by the printer. Hence it states how the printer
informs NET that the reception buffer is full and the character transfer should
temporarily cease. It also states that there is enough free space in the buffer for the
data transfer to be restarted. The OS attribute applies to printer lines only.
The cable wiring of the printer connection differs depending on the OS attribute, see
the Installation Manual.
Data type: Integer
Value: 0 No synchronization (no flow control applied)
1 XON/XOFF synchronization (the printer transmits XON
when it is able to receive and XOFF when the buffer is
full)
2 CTS Synchronization with DCD monitoring. The printer
tells by activating and passivating the CTS signal, when
the buffer can be filled/is full
3 XON/XOFF with DCD supervision. A system message is
produced if NET looses contact with the printer.
205
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
206
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
give the modem enough time to transmit all characters belonging to the message.
The number of padding characters is given by the RK attribute. The extra delay
needed by the modem is about two bytes.
The attribute is valid for all ANSI Half Duplex, IEC 60870-5 and RP570 modem
lines.
Data type: Integer
Value: 0 ... 255. Number of padding characters
Unit: Padding characters
Indexing: Line number
Default value: 0
Access: Read, conditional write
RL Retry Limit
On P214 lines: Defines how many times in a sequence a telegram may be
transmitted to a station before giving up
On SPA lines: Number of telegram repetitions before moving the station into
the sub cycle (suspended). Telegrams to stations in the sub cycle
will not be repeated.
Data type: Integer
Value: 1 ... 255
Default value: 2 (SPA)
Indexing: Line number
Access: Not preconfigurable, otherwise no restrictions
SG Modem Signal
The direct supervision and control of the state of the modem signal. The attribute
applies to all protocols. It is used for diagnostics and testing.
Data type: Integer
Value: 0 Passive
1 Active
Read value: DCD and CTS signals
Write: DTR signals
Indexing: 100 * line nr + signal no. Signal no. 5 = CTS, 8 = DCD, 20 =
DTR
Access: Read-only
207
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
TI Timeout Length
The time limit applied when the NET unit is waiting for response to a message or
polling packet. The attribute applies to the ACP, RAM, ANSI and P214 protocols
and to General ASCII when TAIP sync format is used (PM = 6 and SF = 6).
The value of TI is the time in seconds, that NET waits for acknowledgements (ACK
or NAK on full duplex lines, ACK on half duplex lines). TI also states the maximum
time NET waits for response to a polling packet on half duplex lines (EOT or
message). The NET unit starts the response wait timer when the last byte of a
message or polling packet has been transmitted to the receiving station.
TI is used to specify maximum reception time, while the HT attribute should be used
to check whether a station is responding or not. The timeout on SPA and RP570 lines
are specified exclusively by the HT attribute (see above). See the illustration of the
HT and TI attributes in Fig. 15.4.-2.
On General ASCII lines with PM = 6, the TI attribute is the time NET waits for clock
synchronization messages. If NET receives no synchronization message within this
time, it starts to reconfigure the clock device with the time interval given with the
PD attribute above and sets the SS attribute to Time invalid.
LonTalk protocol lines have a TI attribute with another meaning, see below.
Data type: Integer
Value: 1 ... 255
Unit: Seconds
Suggested value: ANSI Full duplex: 1
ANSI Half duplex: Depending on the transmission rate used:
300 bits/s: 8
600 bits/s: 4
1200 bits/s: 2
2400 bits/s: 1
Anyhow, the TI value should be larger than
(11 * (byte count in longest message)) /
(transmission rate)
General ASCII: The timeout must be longer than the time
between sync messages (defined in the
clock). A suitable value could be 30 seconds.
Indexing: Line number
Access: No restrictions
208
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
209
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
4 64 ms
5 96 ms
6 128 ms
7 192 ms
8 256 ms
9 384 ms
10 512 ms
11 768 ms
12 1 024 ms
13 1 536 ms
14 2 048 ms
15 3 072 ms
Default: 2 (= 32 msecs)
Access: Read, conditional write
TB Transmit Bytes
It is possible to send control characters to serial communication line. The functional
purpose of these characters is to control the switches located in the line. The
functionality is common for all the communication protocols. When this attribute is
written, the given bytes are sent to the serial line.
Value : Vector of bytes, given as string or bytes separated with colons
Access: Write only
At the beginning of the vector, bytes 0 (NULL character) and 32 (Space character)
have a special meaning:
• each NULL character at the beginning of the message results in a 10-byte
preceeding delay in the transmission.
• each SPACE character at the beginning of the message results in a 1-byte
preceeding delay in the transmission.
The NULL character cannot be entered as string. See the examples below.
The length of the vector is limited by the lenght of the SCIL statement i.e. 255 bytes.
After the dial-up connection is established, the SCIL sequence could be the
following:
#PAUSE 1
#SET NETx:STB'line'=(64,49) ; send "@1" to switch to select COM1
#PAUSE 1
#SET STA'sta':siu=1 ; polling starts
210
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
If the message from the base system to STA4 is a command, the polling continues
as follows:
Table 15.5.-2 Polling of an ANSI station after a command to STA4 from the
base system:
NET STA1 STA2 STA3 STA4
211
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
DLE EOT
DLE ENQ 4 BCC
DLE EOT
etc.
PD Poll Delay
Delay between polling telegrams.
When the NET unit is polling stations, it inserts a delay between the response to a
poll and the transmission of the next polling packet. The length of this delay (in
milliseconds) is given by the PD attribute. The purpose of the poll delay is to prevent
the polling from overloading the communication unit.
A message sent from NET to a station during the poll delay time is serviced
immediately.
On general ASCII lines using TAIP clock sync format (PM = 6 and SF = 6), the PD
attribute determines the time between configuration messages to the clock. The time
is determined in situations when NET has not received clock synchronization
messages within the time specified by the TI attribute.
212
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
IEC 60870-5: The delay between polling messages. The purpose of this attribute
depends on the IEC protocol mode. The unbalanced slave uses this attribute only to
detect if the master is polling it. The unbalanced master sends the polling messages
(for class 1 or class 2) with interval of PD attribute. With balanced mode, the link
checks that communication is alive if the time between messages is more than PD
time.
Data type: Integer
Value: 0 ... 65535
Unit: Milliseconds (ms)
Indexing: Line number
Suggested value: Min. 100 (100 ms for RP570 and P214)
Default values: 50 for IEC 60870-5-101 master protocol (unbalanced mode)
500 ms for DNP V3.00 protocol
5000 for IEC 60870-5-101 slave and master protocols (balanced
30000 for IEC 60870-5-101 slave protocol (unbalanced mode)
mode)
Access: Read, conditional write
PL Polling Limit
Controlling the polling sequence of unbalanced master protocol. The purpose of PL
attribute is to limit the number of successive polls of same link address. Normally
the MicroNET polls the same link address until the all data from the same link
address is read. This attribute is used only for unbalanced IEC 60870-5-101 master
mode.
Data type: Integer
Value: 2 … 100
Indexing: Line number
Default: 10
Access: No restrictions
PP Polling Period
The polling frequency of suspended stations. The attribute specifies how often
suspended stations on the line are polled. Normally, the NET unit is continuously
polling the stations. Each station gets the permission to transmit, when its turn
comes. The polling of a station stops completely when it is taken out of use (the IU
attribute is set to 0).
On RP570 and P214 lines: A polling cycle is completed, when all stations have been
polled at least once (RTUs responding with priority 1 information are polled several
times in a row). When a polling cycle is completed, another one starts. A suspended
station is polled every PP:th beginning of a polling cycle.
On SPA lines: A polling cycle is completed, when the stations have been polled as
defined with attribute PT Polling Ratio. One suspended SPA station is polled at the
end of every PP:th polling cycle.
213
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
On ANSI Half Duplex lines: The station can respond to a polling packet with a
message, or if it has nothing to transmit, with an EOT. If the number of polls
specified by the EN attribute (see above) are transmitted to the station and no
response is received, the station is suspended (is classified as faulty). The suspended
stations are polled less often than other stations. The PP attribute specifies the
number of poll cycles completed between each poll to a suspended station. Only one
suspended station per PP number of poll cycles is polled. See also the PC attribute
above.
When a suspended station responds to a poll, the suspension is cancelled if the
suspension reason was that the station did not respond to polls (suspensions due to
other reasons are not affected). From that moment it will be polled in every polling
cycle.
The PP attribute is supported also by protocols IEC 60870-5-101 master
(unbalanced mode), IEC 60870-5-103 master, DNP3.0 Master and Modbus Master.
See protocol specific manuals for more information.
Data type: Integer
Value: 1 ... 255
Indexing: Line number
Suggested value: 2 ... 20 (with RP570, SPA, P214 and ANSI Half duplex)
Default value: 5 for RP570 master, 10 for SPA, 20 for ANSI Half duplex and
P214
Access: Read, conditional write
Example: Four ANSI stations, denoted 1, 2, 3 and 4, connected to a line,
are polled as follows:
1, 2, 3, 4, 1, 2, 3, 4
If a station does not respond to its poll, the communication
frontend will poll it again immediately. If it still does not
respond, it will be polled until the total number of polls is equal
to the EN attribute. If no response is received, the station is
suspended.
Suppose that a fault occurs on station 3, and it stops responding.
The following poll sequence will be transmitted by NET (EN =
3):
1, 2, 3, 3, 3, 4, 1, 2, 4
Those stations classified as suspended are polled less frequently
than those, which respond continuously. After the completion of
each polling round, at most one suspended station is polled. The
PP attribute gives the number of entire polling rounds to be
completed without polling any suspended station.
If the stations 2 and 3 are faulty and PP = 1, we get the sequence:
2, 1, 4, 3, 1, 4, 2, 1, 4, 3, 1, 4
For each polling round, one faulty station is polled. If PP = 2, the
polling sequence will be:
1, 4, 1, 4, 2, 1, 4, 1, 4, 3, 1, 4, 1, 4, 2
214
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
PT Polling Ratio
A poll ratio concept is used by NET when requesting data and events from
SPACOM units. This means that a certain pattern of poll messages is sent cyclically.
During one poll cycle NET polls a certain number of SPA units for data and events.
Each slave (station) has a certain event poll priority class, 1 or 2, which is defined
by the STAn:SEP attribute, see Chapter 16.
The PT attribute specifies how many stations of each event poll class NET polls
during a poll cycle and how many data polls NET performs during a poll cycle.
If suspended SPACOM units exist, such a unit may be interrogated when a certain
number of poll cycles have been completed. The PP attribute, see above, defines
how often this is done.
The PT attribute applies to SPA lines only.
Data type: Integer
Value: 0 ... 10
Unit: Polls per cycle
Indexing: (100 x line number) + poll type where 'poll type' = 1, 2 or 3:
1 Event buffer polls from priority class 1
2 Event buffer polls from priority class 2
3 Data polls
Default values: Poll type 1 4
Poll type 2 2
Poll type 3 1
Access: Not preconfigurable, otherwise no restrictions
Example:
Each poll cycle on line 3 will contain 2 data polls:
#SET NET1:SPT303 = 2
RP Reply Polling
The attribute applies to ANSI half duplex and RP570 lines.
On RP570 lines: Specifies the maximum number of consecutive polls sent to a
station while waiting for the process response to an object
command or an analog setpoint
On ANSI lines: Maximum number of consecutive polls sent to a station while the
NET unit is waiting for a reply
The value of the RP attribute sets a limit to the number of reply polls transmitted to
a station after a command has been transmitted to it. If e.g. RP = 3, the receiver
station will be polled 3 times for a reply, after a command message has been
transmitted to it. If no reply is received, the station is classified as faulty and the next
station will be polled.
215
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
Messages from the base systems and stations will always override the polling.
Therefore, if a message from the base system is to be transmitted to a station on a
half duplex link, NET transmits this message when the current polling packet gets a
response or a time-out occurs. After the message transmission, NET continues to
poll the station in turn. However, if the message from the base system (or a station)
was a command message, the receiving station will first be polled for a reply to the
command transmitted.
IEC 60870-5: This attribute is used only with unbalanced master protocol
mode IEC 60870-5-101
Data type: Integer
Value: 0 ... 255
Suggested value: 2 ... 8
Default value: 1 for IEC 60870-5-101
Access: No restrictions
AC ACE
States whether an autocaller is connected to the line or not. The autocaller must use
the AT (Hayes) command set.
Data type: Integer
Value: 0 No autocaller
1 Yes, autocaller is connected
Default value: 0
Access: Not preconfigurable, otherwise no restrictions
216
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
AS ACE State
The state of the autocaller.
Data type: Integer
Value: 0 IDLE, the ACE is ready to make a call
1 CONNECTED, transmission is activated
2 BUSY, the ACE is busy, e.g., dialling
3 INITIAL, the ACE is uninitialized
4 CONFIGURE, the IU attribute of the line is set to 0
Access: Read-only
CN Connection
Dialling devices from NET and for breaking telephone connections. Using CN
presupposes that there is an autocaller connected to the line (AC = 1).
A call to a station or workstation is initiated by writing the phone number to the CN
attribute. NET then commands the autodialing modem to dial the number. The
success of the dialling is reported as a system message. The connection is broken by
writing an empty string to CN.
When dialling a station, the station number should be given at the end of the phone
number string, preceded by the letter "S". This option is normally used to increase
the communication performance on multidrop lines.
Data type: Text
Values: Max. 25 characters:
Dialling: The telephone number, and possible the station number
preceded by an S. A leading zero and fill characters such as "/",
"-" and " " may be used. By inserting comma characters (","),
delays may be inserted into the dialling. In IEC 60870 master
protocols, the value that is given is the address of the station,
which the user wants to connect to.
217
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
CS Connected Station
Indicates which station NET is communicating with. The attribute is used on
incoming calls on ANSI X3.28 half duplex and RP570 lines. With IEC 60870 master
protocols, if the station is explicitly defined in writing to the CN attribute, the
returned value is the link address of the polled station.
Data type: Integer
Value: 0 ... 255. The STA object number
0 = No station
Access: Read-only
CT Connection Time
The maximum time that a connection is allowed to last (in seconds). The attribute is
significant only if time limiting is activated (CL = 1).
Data type: Integer
Value: 0 ... 600
Default: 120
Unit: Seconds
Access: No restrictions
MC Modem Command
Using this attribute, a modem can be controlled directly from SCIL with AT/Hayes
commands. When an AT command is written to the MC attribute it is transmitted to
the modem on the line. The response from the modem is read using the same
attribute.
Data type: Text
Value: Write: An AT/Hayes command
218
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
PU Pulse Dialing
The dialing principle used.
Data type: Integer
Value: 0 Tone dialling
1 Pulse dialling
Default value: 0
Access: No restrictions
219
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
SR ACE AT S Register
The S registers used by autocallers following the AT (Hayes) de facto standard.
All autocallers using the AT command set have a number of S registers. The number
of registers used and the meaning of the individual registers slightly varies from one
autocaller model to another. The contents of the S registers are therefore not
described in this document, refer to the modem manuals.
Using the SR attribute, the S registers number 2, 6, 7, 8, 9, 10, 11 and 12 are
accessed. By using the MC attribute (see above) also other S registers can be
accessed.
The S registers 11 and 12 cannot be set.
Values: See the autocaller manuals
Indexing: 100 * line number + register number
Example:
The S register number 6 of line 2 in NET1 is set = 4:
#SET NET1:SSR206 = 4
220
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
LAN
Base system
Front-end Front-end
NET NET
Loop
reversal
units RTU RTU RTU RTU
Communication_loop.eps
BO Break Down
Starting, stopping and reading the "break-down state" of the communication loop.
During the break-down state, NET polls through all RTUs in the communication
loop. If RTUs do not respond, system messages are sent to the application. The
system messages can be used in SCIL programs for deciding where to place the
breakpoint and for specifying a configuration table (the CF attribute). The
breakdown state is exited when the BO attribute is set to 0.
The loop configuration tables are loaded to NET using the CF attribute and the loop
configuration is taken into use by the BU attribute.
Data type: Integer
Value: 1 The break-down state is started (write) or it is going on
(read)
0 The break-down state is stopped (write) or it is not going
on (read)
Access: No restrictions
BU Build Up
Starting, stopping or reading the loop configuration build-up mode of the line. When
the build-up mode is started, the CF table (see below), which must have been set
before the BU attribute, is taken into use.
The loop configuration is realized so that the last RTU of each polling direction in
the loop is commanded to open the loop, while all other RTUs are commanded to
close the loop. Both NETs try to establish contact with their respective RTUs (all
RTUs that are in use) by sending SCI (Status Request) commands. If it succeeds, a
system message (Configuration_ready) is sent to the application. No response is
received from one or more RTUs within the time specified by the MT attribute as an
221
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
indication that the contact between NETs and their respective RTUs did not succeed.
If it did not succeed, the build-up mode is exited and a system message
(Configuration_Failure) is sent to the application.
Data type: Integer
Value: 1 Building up mode
0 Normal operation mode
Default value: 0
Access: No restrictions
DR Direction
The loop direction used on the line. The application engineer specifies two
directions, one called "A" and the other "B". One frontend line of the loop has
direction "A" and the other has direction "B".
Data type: Text
Value: "A" or "B"
Access: No restrictions
222
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
LS Loop Status
The polling state of a line in communication loop mode.
Data type: Integer
Value: 0 ... 3:
0 OK. Normal polling
1 BREAK DOWN. The line is in break-down mode. Each
RTU with the same polling direction as the NET line is
polled in its turn.
2 BUILD UP. The line is in build up mode. It tries to open
a connection to each RTU with the same polling direction
as the NET line.
3 POLLING DISABLED. The RTU order on the loop is
being configured. Polling is disabled, and will be started
by writing to attribute BU.
Access: Read-only
MD Modem Delay
The number of modem pairs between NET and the RTU.
On communication loop lines, time synchronization messages can not be sent as
broadcast, because the modems are connected in series. This fact causes a delay,
which is proportional to the number of modem pairs between the NET and the RTU.
The estimated mean delay caused by one pair of modems can be written to the MD
attribute, whereby it is automatically taken into account when time synchronization
commands are sent to the RTUs. The RP570 protocol code in NET calculates with
a modem delay, which is MD * the number of modem pairs between NET and the
RTU.
Data type: Integer
Value: 0 - 1000 ms
Unit: Milliseconds
Default value: 30 ms
Access: No restrictions
223
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
where
‘p’ Network variable priority, 1 bit
‘d’ Direction, 1 bit value 0 for IN and 1 for OUT
‘nv_selector_high’ Nv selector, 6 msb bits
‘nv_selector_low’ Nv selector, 8 lsb bits
‘t’ Turnaround, 1 bi
224
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
where
‘type’ Type of address entry or 80H + group size
Type of address:
225
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
226
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
DC Diagnostic Counters
The line protocols gather statistical information about the events on the lines by
incrementing a number of diagnostic counters. All major events and error situations
of the communication have their own counters.
Each line has a number of diagnostic counters numbered 1 ... 16 (or 32 if the line
contains autodialing). The meaning of the individual counters in number order is:
1 TRANSMITTED MESSAGES/TELEGRAMS
This counter is incremented whenever a message is transmitted successfully.
On ANSI X3.28 lines, a successful transmission includes the reception of a
positive acknowledgement (ACK). On Half Duplex lines, the counter is not
incremented by polling packets, only by messages (commands or replies).
2 FAILED TRANSMISSIONS
The counter is incremented when a message transmission fails. On an ANSI
line, the transmission has failed if no positive acknowledgement (ACK) is
received in spite of retrials. The counter is also incremented if the states of the
modem signals CTS and DCD prevent transmission. For the special DCD link
type LK = 8, the counter is updated after each retry while waiting for passive
DCD.
3 TRANSMITTED TIMEOUTS
The counter is incremented each time a timeout occurs during the waiting for
a response. If for example 3 time-outs occur at the transmission of a message
(with retrials), the counter is incremented 3 times. When the retry limit is
reached, finally also the counter 2 is incremented once.
4 TRANSMITTED ACKS/FETCH
Is incremented on ANSI X3.28 lines each time a positive acknowledgement
(ACK) is transmitted. Not used on RP570 lines.
5 TRANSMITTED NAKS/POLLS
Is incremented on ANSI X3.28 lines each time when a negative
acknowledgement (NAK) is transmitted. Not used on RP570 lines.
UNPROCESSED LON MESSAGES
The amount of messages read from the driver but not yet processed. Used in
LON line only.
6 TRANSMITTED ENQS/BROADCAST
Is incremented on ANSI X3.28 lines each time when an enquiry (ENQ) is
transmitted. Not used on RP570 lines.
7 RECEIVED ACKS
RECEIVED EVENT TELEGRAMS (SPA lines)
RECEIVED XONS (printer lines)
Is incremented on ANSI X3.28 lines each time a positive acknowledgement
is received from the line. Not used on RP570 and P214 lines.
8 RECEIVED NAKS
RECEIVED DATA TELEGRAMS (SPA lines)
RECEIVED XOFFS (printer lines)
227
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
228
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
22 ACE_FAILED_DIALINGS
TCP CLOSE COUNT (SPA-TCP, DNP V3.00/LAN master and slave,
Modbus TCP)
23 ACE_FAILED_CONNECTINGS_OF_REMOTE_CALLS
24 ACE_FAILED_DISCONNECTIONS
25 ACE_IGNORED_RINGS
26 ACE_RECEIVED_RINGS
None of the line protocols updates all of the counters. The following counters are
updated for the ANSI, RAM, SPA, LON, IEC 60870 and printer lines:
ANSI X3.28 Full Duplex: nr 1 - 9 and 11 -16
ANSI X3.28 Half Duplex: nr 1 - 5, 7 , 10 - 16
COMMON RAM protocol: nr 1, 2, 3, 4, 5, 7 and 8
ASCII printer protocol: nr 1 and 3
SPA protocol: 1, 2, 3, 11, 12, 13, 15 and 16
LON: 1, 2, 3, 11, 13, 14, 15
IEC 60870: 1, 2, 4, 5 and 11 - 16
Data type: Integer or vector
Value: 0 ... 30000 (modulo 30001)
When the value 30000 is reached, the following counter values
are 0, 1, 2, etc. When the IU attribute is changed from 0 to 1, the
NET program resets the counters of the line.
Indexing: When accessing diagnostic counters, the attribute is indexed
according to the formula.
100 * (line number) + (diagnostic counter number)
Access: Read-only, the values can be reset
Example:
The diagnostic counters 1 ... 16 of line 3 in NET1 are displayed in the window
COUNTER:
!SHOW COUNTER NET1:SDC(301..316)
LK Link Type
The clock synchronization of LONWORKS lines. The lowest 3 bits in the attribute
specifies clock synchronization functionality as follows. Note that time
synchronization cannot be used for several base systems, which are connected to the
same device. This creates erroneous time stamps.
0 No clock sync
1 Send LSG clock sync (for the relays that utilise nv warning and nv
clock telegrams)
229
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
2 Send minute pulse (for the relays that utilise nv time telegram)
3 Send LSG and minute pulse
4 Receive LSG clock sync
5 Receive the minute pulse. It is recommended to use minute only when
the other synchronization methods do not work, or when the exact time
is not needed because of the inaccuracy on high channel load on LON
line with minute pulse.
6 Send SLCM Reference Time
On an IEC 60870 line this attribute controls the behavior of RTS-control line:
12 RTS always on, full duplex (balanced slave default)
13 RTS / CTS controlling also with balanced mode
On DNP V3.00 protocol:
14 Collision detection in use, transmission when the Data Carrier, Detect
signal of the line is not set
15 No collision detection, Data Carrier Detect signal is handled as in other
protocols
Data type: Integer
Values: 0 ... 15
Default: 0 (3 recommended for LONWORKS lines)
15 for DNP V3.00 protocol
Indexing: NET line number
Access: Read, conditional write
SF Sync Format
Time sync message format for the clock synchronization reception. This attribute
has a meaning only on General ASCII lines with PM = 5 or 6.
Data type: Integer
Value: 1 ... 6:
1 COMPUTIME
2 RCC8000
3 Chinese TV clock, BLF format
4 MAC02
5 Meinberg GPS 166
6 TAIP (when TAIP format is used PM must be = 6)
Default value: 1
Access: Read, conditional write
230
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
SS Sync Status
The status of the clock synchronization on the line. This attribute has a meaning only
for General ASCII lines with PM = 5 or 6.
Data type: Integer
Value: Integer where the bits has the following meanings:
Bit Meaning if bit value = 1
0 Not used
1 Summer time (Valid only with GPS166 format
2 Not used
3 Summer Time Change (Valid only with GPS166 format)
4 Not used
5 Not used
6 Not used
7 Time invalid, synchronization not done
Access: Read-only
Example:
Checking if NET1 is synchronized via line 2 (Bit 7 of the SS attribute is checked):
#IF BIT(NET1:SSS2,7)==1 #THEN #BLOCK
........................;Clock not synchronized
#BLOCK_END
#ELSE #BLOCK
........................;Clock synchronized
#BLOCK_END
231
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
232
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
233
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
16.1. General
Station types
All the station types that can be connected to NET unit were listed in Chapter 14.
This chapter describes the attributes of the following station types:
• ANSI stations (STA): the process units that communicate with NET unit using
the ANSI protocol, for example, Allen-Bradley PLCs and SRIO. These types of
stations can only be connected to DCP-NET units.
• RTUs: S.P.I.D.E.R. RTUs and Collector 100 and 300.
• SPA stations: bay control units, mainly SPACOM relay units, connected via the
SPA protocol or via the LonTalk protocol and LSG devices. The SPA stations
connected via a LSG device are configured as SPA units connected via the SPA
protocol, except for two attributes. These attributes are UT attribute and the RL
attribute. There are also some differences in the SPA point definition attributes.
• REX stations: REx type relays (REF, REC, RED, REL, etc.) communicating with
the base system through a LONWORKS line and the PC-NET unit. The REX
stations can only be connected to PC-NET units.
• LMK stations: LSG devices and other devices connected to the LONWORKS
network through a standard LONWORKS interface (for example Weidmüller). The
LMK stations can only be connected to PC-NET units.
• SPI type stations: SCADA systems and other control systems, which
communicate with NET unit through the RP570 slave protocol in a master-slave
relation where NET unit is the slave.
• Modbus Slave station: SCADA systems and other control systems, which
communicate with CPI-NET unit through the Modbus Slave protocol in a master-
slave relation where the CPI-NET unit is the slave. Modbus Slave station can
only be connected to CPI-NET unit.
• IEC type stations: Relays and control devices, which communicate with the base
system through PC-NET unit by using the IEC Protocols. The IEC type stations
can only be connected to PC-NET units.
• PLC stations: Relays and control devices, which communicate with the base
system through DCP-NET unit by using Modbus Master protocol.
The attributes of other station types are described in separate documents.
Definition
Each station must be defined as a STA object in the NET unit to which it is directly
connected. The STA object can be defined in the preconfiguration of DCP-NET
units (up to 20 stations) or on-line with the NET station definition attributes
described in Chapter 14. ANSI stations are defined with the ST attribute, RTUs with
the RT attribute, SPA stations with the SP attribute, REX stations with the RX
attribute, and LMK stations with the LM attribute.
234
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
When the STA objects are defined on-line, the STA attributes get the default values
given in the attribute descriptions. When the objects are defined in the
preconfiguration, only the attributes that cannot be preconfigured get the default
values, the other attributes get the values given in the preconfiguration.
Broadcast stations
Each time a NET unit is started, it creates automatically four STA objects with
system object number 0. One STA object is of type RTU (S.P.I.D.E.R. RTUs and
Collector), one is of type SPA (SPACOM), one is of type LCU and one is of type
PLC. These STA objects are broadcast objects. For stations of type RTU, the
broadcast object means all stations of this type connected to the same NET unit. For
stations of type SPA, the broadcast object means all stations connected to chosen
NET lines (see the BL attribute in Section 16.5). Provided that the broadcast stations
have been mapped for the application, they can be accessed from SCIL.
Object notation
The STA attributes are accessed from SCIL with the object notation:
STAn:Sat
where
'n' The logical station number, 0 ... 5000, as known to the
application where the object notation is used. 'n' is translated to
the communication system object number (0 or 1 ... 255) as
described in Chapter 6. As mentioned above, NET unit knows
the broadcast stations as STA0.
'at' The attribute name
IU In Use
The operational status of the station - in use or out of use. Taking the station out of
use with this attribute stops all data communication with the station. All operations
that would result in a data exchange are disabled. The station itself is not affected by
the attribute, only NET unit’s image of the station.
The station causes no system messages as long as it is out of use, only at the moment
when it is taken out of use. Likewise, taking a station into use causes NET unit to
send a system message (see the SE attribute).
Setting IU to 1 is allowed only if the station address is legal (the SA attribute) and
the device is allocated by some application (the AL and AS attributes).
235
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
Regarding S.P.I.D.E.R. and Collector RTUs, NET unit sends an SCI (Status Check
Instruction) to the station when it is taken into use by setting the IU attribute to 1.
This is done unless the SC attribute has been set to 0 manually while the station was
not in use. In this case, the polling will proceed from the state where the station was
left when taken out of use.
Regarding REX and LMK type stations, the station objects should be taken into use
not until the line object of the stations has been set to IU=1. Correspondingly, all
station objects connected to a LonTalk protocol line should be taken out of use
before the line object is taken out of use.
Data type: Integer
Values: 0 Out of use
1 In use
Default value: 0
Access: No restrictions
LI Line Number
The number of the NET line, to which the station is connected.
By writing a new value to the LI attribute, the station can be switched from one line
to another. Both lines need to be defined with the same protocol and their original
and destination lines have to be taken out of use. Changing the LI attribute, that is
moving a station from one line to another, demands that the station as well as the old
and new lines have been taken out of use (IU = 0).
This attribute is also used for setting the number of the back-up line if redundant
lines are used. The indexes are used only when the redundant lines are used. Note
that the indexes 1 and 2, i.e. main and back-up line numbers, are switched when a
line switch operation is executed. The number of the back-up line is set to index 2
of the LI attribute.
Data type: Integer
Value: 1 ... 8
Default value: The line number given when creating the STA object, see
Chapter 14. For example, the default value is 1 for DNP V3.00.
Indexing: None if redundant lines are not used
Index 1 is for the number of the main line
Index 2 is for the number of the back-up line
Access: Read, conditional write
AL Allocation
Allocates the station to an application. When the AL attribute has the value 1, the
station is reserved by the application specified by the AS attribute. All spontaneous
messages from the station will be sent to this application.
236
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
The stations address all their messages to one single station address, which is the
address of the communication unit. The NET unit forwards the received messages
to the application, which has reserved the station (the AS attribute).
Although one application has reserved a station, other applications can send read
commands to the station. The station will not transmit spontaneous messages to
these other applications, unless the message split feature of NET unit is used. See
the SP attribute in Section 16.3.
Data type: Integer
Values: 0 or 1
Suggested value: The AL attribute must always be = 1 when the station is in use
Access: No restrictions
Example:
#SET STA1:SAL=1
AS Allocating Application
The allocating application of the station (see AL attribute). The allocating
application will get all the spontaneous process data from the station. This
application is also the only one that is allowed to set the device communication
attributes.
When AL is set to 1 on line, AS is automatically set to the number of the application
from which AL is set. When AL is set to 0, AS also is automatically assigned the
value 0. If AL is set to 1 in the preconfiguration, AS must also be set there.
The allocating application will receive all the spontaneous process data from the
station (if message split, section 16.3, is used, also other applications will receive the
messages).
Data type: Integer
Value: 0 ... 250. The application number as known to the
communication unit. 0 = No application.
Access: Read-only
237
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
automatically marks all process objects related to that station as not valid. The
marking is done by setting the OS attribute (Object Status) to 2
(OBSOLETE_STATUS). The process objects, whose UN attribute (Unit Number)
corresponds to the station in question, are to be marked. A system message from the
same station, which tells that the connection is OK again, does not lead to any
process object marking. The updated object values are subsequently marked valid
(OS = 0).
Refer to Chapter 14 and the System Configuration manual to learn more about the
system message handling.
The system message generation of the RTU type stations (S.P.I.D.E.R. RTU and
Collector) differs from the system message handling of other stations.
Stations of other types than RTU cause the generation of system messages on the
following events:
• The station is put into suspended state because it does not respond to poll packets
or messages, or because IU has been set to 0.
• The connection to a station has been lost or re-established.
• The station connection recovers after a disturbance.
The S.P.I.D.E.R. RTUs generate system messages in the following situations:
• When the station is suspended or recovers from suspension.
• The station is stopped/restarted.
• Terminal message received.
• Terminal status received.
• Terminal event received.
Due to the differences in the generation of system messages, the MI attribute of the
RTU type stations differs from the MI attribute of other stations. It is therefore
described separately below.
238
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
MS Message Application
Specification of the application or applications that will receive the system messages
caused by the station. Each station may have up to six applications that receive
system messages. The APL system object numbers as defined in NET unit specifies
the application.
Data type: Integer or vector
Value: 1 ... 250, or vector of six integers in the range 1 ... 250. APL
system object numbers as defined to NET unit.
Indexing: 1 ... 6
No index = Index 1
Access: No restrictions
239
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
It is possible to send system messages to more than one station with a STA object.
The System Configuration Tool does not support this, instead you have to create a
user defined program if you need to do it.
OS Object Status
Indicates the state of the station. Writing to the OS attribute (OS = 1) of a station
makes NET unit re-transmit the last system message caused by the station. Possible
"Stopped" and "Suspended" messages cause old marking of process objects. By
reading the OS attribute, the status code of the system message can be read. The
attribute is available for Master and Slave for IEC stations.
Data type: Integer
Value: When written:
1 Re-transmit system message
When read:
A status code, for example:
0 OK (communication works properly)
12337 ANSI station suspended
12339 ANSI station taken out of use
12602 RTU suspended
12604 RTU taken out of use
13251 SPA station suspended
13252 SPA station taken out of use
13801 PLC station suspended
13802 PLC station taken out of use
Etc., see the Status Codes manual
Default value: Suspended for IEC Stations
Access: No restrictions
240
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
PH Phone Number
The phone number of the station.
The PH attribute is not directly used for dialling, but it can function as a memory for
the phone number to be used when calling a station.
Data type: Text
Value: Text of max. 25 characters. The character string may contain a
leading 0, "-", "/" characters, etc. Usually a delay in the dialling
is marked by a comma (",").
Access: No restrictions
Example:
#SET NET1:SCN3 = STA4:SPH
SA Station Address
The station address of the ANSI station. The value of this attribute must be the same
as the corresponding station address value defined in the station.
Each station connected to a NET unit through the ANSI X3.28 protocol must have
a unique station address. This demand for uniqueness also comprises the NET unit
itself, see the SX attribute in Chapter 14. However, stations connected to separate
NET units may have the same station addresses. When the station address is written
on-line with SCIL, the communication program checks that the uniqueness is
maintained.
Data type: Integer
Value: 1...255
Access: Read, conditional write
Example:
STA1 is given the address 20:
#SET STA1:SSA = 20
241
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
ST Station Type
The type of the ANSI station: SLC-500 or other types. The type specification is
needed because the interpretation of object addresses in messages from SCL-500
differs from the other ANSI station types.
Data type: Integer
Value: 1 SRIO and other ANSI station types, except SLC-500
4 SLC-500
Default value: 1
Access: No restrictions
PA Polling Address
Using this attribute, a station can be polled by using another address than its own
station address (the SA attribute). The PA attribute makes it possible to connect
PLC-5 and stations using Data Highway to a multidrop line of NET unit. In all other
cases, the PA attribute should be equal with the SA attribute.
Data type: Integer
Value: 1 ... 63 or 72 ... 254
Default value: For stations defined off-line: the SA attribute
For stations defined on-line: no default value
Access: Not preconfigurable, otherwise no restrictions
242
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
243
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
RT Reply Time-out
The maximum time the NET unit will wait for a reply from the station.
Data type: Integer
Value: 0 ... 655
Unit: Seconds
Default value: 45
Suggested value: For point-to-point connected stations, the recommended time is
about 15 s. For multidrop connected stations the recommended
time is about 45 s. To prevent unnecessary timeouts caused by
data link layer re-transmissions, the value of RT should be
significantly greater than the product of the TI and EN line
attribute values (TI*EN) (Chapter 13).
Access: No restrictions
SU Suspension Time
The time between diagnostic commands to a suspended station.
Unlike the DI attribute (see Chapter 13), this attribute is used when the station is in
a suspended state. If DE = 0, SU has no meaning. If an acceptable reply is received
to the diagnostic command, the station returns to the normal state, otherwise it stays
in the suspended state for another SU period. If any other message is received from
the station without errors during the period, the station enters the normal state.
Data type: Integer
Value: 0 ... 655
Unit: Seconds
Default value: 60
Suggested value: 60 ... 600 (the same as for the DI attribute)
Access: No restrictions
244
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
DC Diagnostic Counters
The values of the diagnostic counters which NET unit keeps for the station.
To make the supervision and testing of the station communication easier, each
communication frontend holds five diagnostic counters (numbered 1 ... 5) for each
station. Each counter monitors a certain kind of events, according to the following
list:
1. STATION SUSPENSION
The counter is incremented each time the station is suspended. Depending on
the reason for the suspension, one of the other counters is also incremented at
the same time.
2. DEV STATUS RECEIVED
The counter is incremented when a DEV STATUS IN signal is received from
the ANSI X3.28 Half Duplex protocol data link layer. This signal indicates
either that a station has ceased to respond to polling packets, or that it has started
to respond again after a disturbance. The first situation will lead to a suspension
of the station and increment counter 1 as well. From the function of this counter
follows that generally an odd value indicates that the station does not respond to
polling packets at present.
3. REPLY TIMEOUTS
This counter is incremented when a command has been transmitted to a station
and no reply arrives from the station within the time limit specified by the value
of the RT attribute. The station is suspended.
245
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
DE Diagnostics Enable
Indicates whether the communication frontend will transmit diagnostic commands
to the station cyclically, and what type of diagnostic commands that will be used.
The time cycle always starts from zero when a message (command or reply) is
received from the station. The length of the time cycle (in seconds) is normally the
value of the DI attribute. When the station is suspended, the cycle length is obtained
from the SU attribute.
The diagnostic commands used are Diagnostic Status and Diagnostic Loop. The
Diagnostic Status command reads status information (see the DS attribute below)
from the NET unit of the station. The status information received tells among others
the type and operating mode of the station, and also gives an indication of possible
errors. Diagnostic Loop transmits a byte sequence to the station, and only checks
that the same byte sequence is received in the reply message.
If both commands are implemented into the station, Diagnostic Status is normally
the command to use, but some station types have only the Diagnostic Loop.
If an RTU does not transmit messages spontaneously, it might stay in the suspended
state although it answers to the polling packets. This situation can occur if the
polling packets and their end-of-transmission responses are transmitted correctly,
but line disturbances prevent the correct transmission of a whole message. After
such a disturbance the station can return to the normal state if:
a) It transmits a command message as response to a polling packet
b) A diagnostic command is transmitted to the station
246
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
c) The value of the FS attribute is non zero, so that the commands from the
application system are forwarded to the suspended station.
Data type: Integer
Value: 0 No diagnostic commands transmitted cyclically
1 Diagnostic Status
2 Diagnostic Loop
Default value: 0
Suggested value: On point-to-point lines, diagnostic commands should always be
used. On multidrop lines, the use of Diagnostic Status can
always be recommended if the extra load on the communication
line is not a problem. The Diagnostic Loop command is not
always to be recommended, because the station connection is
usually tested anyway by the polling packets, and Diagnostic
Loop gives no additional information. If the stations of a line are
not polled cyclically, Diagnostic Loop can also be
recommended.
Access: No restrictions
DI Diagnostic Interval
The time between diagnostic commands to a station, which is not in suspended state
(cp. the SU attribute, Chapter 13).
The DI attribute is meaningful only if DE has a non-zero value. Then DI gives the
time in seconds from the last message (command or reply) reception from the station
until the next diagnostic command will be sent. If some other message is received
from the station during that time, the timer restarts from zero.
Data type: Integer
Value: 0 ... 655
Unit: Seconds
Default value: 60
Suggested value: A typical value for a point-to-point connected station is 60 s. If
the diagnostic commands are used on a multidrop line, the
interval will normally be longer because of the low transmission
rate.
For the stations on the same multidrop line the DI values should
slightly differ from each other to smooth the load on the line
especially after the communication program has been restarted.
Access: No restrictions
247
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
DS Diagnostic Status
The status code of 10 bytes. A read command using the DS attribute returns 10 bytes
of status information from the station or its communication unit. The format and
exactitude of the status information depend on the station type. Usually information
about station type, NET unit type, operating mode, error bits, counter and timer start
address and station program version is included.
Data type: Vector
Value: Vector of 10 integer elements
Indexing: 1 ... 10, that is all information is always read with the same object
notation. The start address needed to use the CT attribute is
found in bytes 7 and 8. The exact meaning of each byte in the DS
vector is described in the station manual.
Access: Read-only
EN Number of Enquiries
Maximum number of ENQs (response requests) per message from the station
communication unit. The station will send ENQs in full duplex communication if it
does not receive a response (ACK / NAK) to a command within its time limit (see
the TI attribute below).
Data type: Integer
Value: 0 ... 255
Suggested value: Larger than 2
Access: Write-only, not preconfigurable
248
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
NA Number of NAKs
Maximum number of NAKs (negative acknowledgement) the NET unit of the
station accepts at the transmission of a message in full duplex communication. When
this limit is reached, the message transmission has failed.
Value: Integer, 0 ... 255
Suggested value: 3
Access: Write-only, not preconfigurable
TI Length of Time-out
Time limit used by the station when it is waiting for a response to a message
transmitted.
Data type: Integer
Values: 0 ... 255, 255 = Infinite
Unit: 1/38 s in PLC-2 and SPSC500M
Access: Write-only, not preconfigurable
249
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
AD Start Address
The word address of the first word of the memory area.
Data type: Integer
Value: The NET unit allows values from 0 to 32767, the size of the
station memory may set a lower maximum value.
Indexing: Memory area number. Only one index is allowed.
Access: Read, conditional write
AT Access Type
Defines if write commands directed to this memory area are protected or
unprotected. The attribute is relevant only to Allen-Bradley stations.
With unprotected commands, any station can write anywhere in the data table of a
PLC, if the unprotected commands are not disabled with a dipswitch. Concerning
protected commands, the PLC program contains definitions stating which station is
allowed to write in the memory locations. Write commands from undefined stations
or to undefined areas not accepted.
Data type: Integer
Value: 0 Unprotected
1 Protected
Suggested value: For AO and BO memory areas of Allen-Bradley PLC stations,
recommended value is AT = 1.
Indexing: Memory area number. Only one index is allowed.
Access: Read, conditional write
BF Block Format
States if the spontaneous command messages from the station use the basic format
of the protocol or if an additional address field is utilized.
The need for special formats is due to the implementation of spontaneous
transmission into Allen-Bradley PLC-2 programs. In this programmable logic, a
sent command includes a command line that contains a constant memory address.
At transmission, the PLC adds this constant address to the word address field.
However, sending data from several memory addresses may lead to a great number
of command lines, which consume a lot of memory and programmer time. By
adding an additional address into the data part of each message, the sending of
commands requires only one or a few command lines. The additional address
identifies the data elements the values of which are transmitted.
250
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
The constant address of the command line is chosen as the start address of a memory
area with the BF value 2 or 3, depending on the coding of the second address. The
additional address is defined in a memory area with BF = 1.
Data type: Integer
Value: 1 Allen-Bradley basic format
2 Special format 1, the message contains a second word
address, which is a BCD coded octal number
3 Special format 2, the message contains a second, binary
word address
4 Multi-event format transmission for spontaneous event
messages. This format allows transmission of many
events with non-continuous addresses in the same
telegram.
Suggested value: The use of value 4 is suggested if it is supported by the station
Indexing: Memory area number. Only one index is allowed.
Access: Read, conditional write
CO Coding
Coding of the data elements in the address interval defined by the memory area. The
value of CO tells the communication program how to interpret the data of the
memory area.
Data type: Integer
Value: 1 ... 12:
1 8 bit binary value
2 12 bit binary value
3 16 bit binary value
4 32 bit binary value
5 3 digit BCD value
6 4 digit BCD value
7, 8 Not in use
9 32 bit floating point value
10 ASCII data
11 16 bit integer
12 32 bit integer
In a message, data elements of type 1 and 10 reserve 1 byte each.
Elements of types 1, 2, 5 and 6 reserve 2 bytes and elements of
types 4 and 9 reserve 4 bytes each.
Indexing: Memory area number. Only one index is allowed.
Access: Read, conditional write
251
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
DT Data Type
The data type of the memory area. There are five types of memory areas BI, BO, AI,
AO and TD. Memory areas of the types BO and AO can be used for both reading
and writing data. There is also a certain memory area for the time synchronization
area.
Data type: Integer
Values: 1 ... 6:
1 BI, binary input
2 BO, binary output
3 AI, analog input
4 AO, analog output
5 TD, transparent
6 Time sync data
Indexing: Memory area number. Only one index is allowed.
Access: Read, conditional write
Example:
The type of the memory area number 1 of station 2 is set to binary input:
#SET STA2:SDT1=1
LE Length
Number of words in the memory area.
Data type: Integer
Value: 0 ... 32767. In practice the station memory size and other
memory areas that are used set the upper limit.
Indexing: Memory area number. Only one index is allowed.
Access: Read, conditional write
MC Memory Configuration
States the number of the station from which the configuration is copied. Using this
attribute the whole memory area configuration of a station can be copied from
another station.
When the configuration of station A is copied from station B, any old memory area
definitions of station A will be overwritten. If an area nr x is defined for station A
but not for station B, it will be removed.
Data type: Integer
Value: Station number
Indexing: Memory area number. Only one index is allowed.
Access: Read, conditional write
252
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
Example:
All memory area definitions of STA5 are copied (using the same memory area
numbers) to STA1:
#SET STA1:SMC = 5
MR Memory Rung
Addition and removal of memory area definitions in a station data structure. Giving
the MR attribute a string value with "C" as the first character creates a memory area.
The NET unit then assigns default values to the memory area attributes. After the
"C" may follow the two-character abbreviation of the data type wanted (AI, BI, AO,
BO, and TD). By specifying the data type in the creation command, the application
programmer can help the communication program to choose appropriate default
values. Fewer SCIL commands are needed for completing the definition of the
memory area. For example "CBI" means that a binary input memory area is created.
If no other characters follow the "C" in the creation command, the communication
frontend will create a memory area of the type TD (Transparent Data). A memory
area definition is removed by giving the value "D" to the MR attribute.
When a new memory area is added, the communication unit uses the following
default values:
253
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
BF 1 Basic Allen-Bradley
format
TS 0 No time stamp
SL 0 All five elements
254
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
BF 1 Basic Allen-Bradley
format
TS 0 No time stamp
SL 0 All five elements
In any case, appropriate values must be assigned separately to the attributes AD and
LE, before the new memory area is ready to be used.
At the creation of a new memory area, the attribute values can be copied from
another memory area, within the same station or in another one. In this case, the
attribute is assigned a coded integer value.
Data type: Text, integer
Value: Creating a memory area: Text of three characters. The first
character is a C and the next two characters are the data types
(AI, BI, BO, AO, and TD).
Copying a memory area: Integer formed in the following way:
100 x STA number + area number
Removing a memory area: Text of one character: "D".
Indexing: Memory area number, 1 ... 30. Only one index is allowed.
Access: Read, conditional write
Example:
Area number 17 of station number 4 is copied to area number 5 of station number
1:
#SET STA1:SMR5 = 417
TS Time Stamp
States whether time tagged information is included in spontaneous commands from
the station.
For the registration of signal sequences it is often desirable to "stamp" some data
with the actual time already in the station. The time stamp is made by copying the
minute, second and millisecond values from the station clock. If present in a
message, a time stamp occupies 4 bytes, one for minute, one for second and two for
milliseconds.
Data type: Integer
Value: 0 No time stamp
1 Time stamp
Suggested value: Most commonly, time tagging is used for binary input data and
two bits ("double") indications (defined as AI areas in the
communication unit).
If the station sends time tagged messages, the TS attribute must
be 1, else TS = 0.
Indexing: Memory area number, only one index is allowed.
Access: Read, conditional write
255
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
Message Split
APL1 APL2 APL3
NET1
STA1:S AS = 1
SP = 1 NET2
SL = (2050, 2051)
STA1 Message_spit.eps
256
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
SP Message Split
Specifies if message split is used or not. It also specifies the error handling in those
cases where one or several receiving applications do not reply.
The copy destination applications for different memory areas are the ones defined
by the SL attribute.
Data type: Integer
Values: 0 No message split (copying)
1 Message split activated. Non zero status code in reply
message if one of the applications does not reply.
2 Message split activated. Non zero status code in reply
message if no application replies
3 Message split activated. Non zero status code in reply
message if the destination application defined in the
message does not reply.
Default value: 0
Access: No restrictions
257
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
ME Memory
The data element(s) in the memory area(s). This attribute is used for reading from
and writing data to the memory area of a station. The attribute is indexed with the
station memory addresses (word addresses). For access to binary inputs or binary
outputs, bit numbers may also be used.
Data type: Integer
Value: Binary inputs and outputs: 0 or 1
Analog values: Depends on the data coding (the CO attribute,
see Section 16.3.6)
Indexing: Word address and possibly bit address. If bit address is used, the
word address must be given as an octal number. Word addresses
can be given as an address range, but not if bit addresses are
used.
Access: Not preconfigurable, otherwise, no restrictions
Example:
Memory address 1003 in STA1:
STA1:SME1003
SY Clock Synchronization
Synchronising the station time with the NET time. The time in the message is the
NET time at transmission of the last bit of the first byte (DLE) in the message. Each
station must be synchronized separately, broadcast is not supported. For stations that
do not compensate for transmission time, the accuracy is not better than 50 ... 300
ms.
Using the SY attribute for synchronising a station requires that a memory area with
DT = 6 and LE = 9 has been defined, see Section 16.3.6. The address of the memory
area is not significant to NET unit, but the station may require a specific address.
Data type: Integer
Value: 1
Access: Write-only
258
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
HR Host RTU
If the station is a sub-RTU, the HR attribute tells the station address of the host RTU
one level up in the RTU hierarchy. For the uppermost RTU level, the HR attribute
value is the same as the station address (the SA attribute). See Figure 16.4.1.-1.
Data type: Integer
Values: 1 ... 255
Default value: The station address of the RTU. When the station address of the
RTU is set, HR is automatically set to the same value.
Access: No restrictions
SA Station Address
The station address of the RTU. The address must be unique among all S.P.I.D.E.R.
RTUs, Collector and P214 RTUs connected to the same NET unit. The address must
coincide with the corresponding address in the RTU itself.
259
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
For S.P.I.D.E.R. RTUs legal addresses are 1 ... 255, except for the broadcast STA
object, which has the address 0. The RTU can not be taken in use (see the IU
attribute) unless it has a legal address.
Data type: Integer
Value: 0 ... 255
0 = Broadcast address
Access: Read, conditional write
SO Synchronization Offset
This attribute is used to define a station specific time compensation to the
synchronization message initiated with SY attribute. If the used hardware delays the
transmission of the message to the RTUs, a value close to this delay should be
assigned to this attribute. Some tuning work or a good knowledge of the used
hardware is needed when this attribute is used.
Data type: Integer
Value: -32768 ... 32767
Access: No restrictions
Default: 0
Unit: 10'th of milliseconds
Example:
If the average transmission delay to the station STA1 is known to be 60
milliseconds, the station object should be configured with the following SCIL
command:
#SET STA1:SSO=600
The attribute can be modified while the system is running. It is possible for the SCIL
application to retune, if the feedback of the synchronization accuracy is available.
Negative values will cause the RTU time to be behind the actual time. Also, a too
big value, compared to the actual transmission delay, will cause the RTU time to be
ahead of the actual time.
DC Diagnostic Counters
The diagnostic counters for an RTU device monitors the telegram exchange to the
specific RTU. The counters are:
1. SUSPENSIONS
A S.P.I.D.E.R. RTU is suspended when the RTU line has got erroneous replies
or no reply after the number of trials determined by the EN attribute of the line
2. TERMINAL STATUS RECEIVED
3. TERMINAL EVENTS RECEIVED
4. TERMINAL MESSAGES RECEIVED
System messages from the RTU
260
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
FC Function Command
Enabling transmittance of function commands to the RTU. The number of the
function command is given as index and additional information is given as the value
of the attribute.
All function commands listed in the S.P.I.D.E.R. RTU manuals and in the RP570
protocol descriptions can be used, except the commands number 14, 15 and 16.
Example:
1 Cold start -
2 Activate RTU after FTAB's -
3 End of period/intermediate reading of PC's 1 = Intermediate
2 = End of period
4 Generate event with PROM version -
5 Activate/deactivate local printer 1 = Activate
2 = Deactivate
9 Send system message queue -
18 Deactivate RTU, accept complete set of FTAB's -
19 Database time tag (configuration time) Time, generated by the
SCIL function
RTU_ATIME
261
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
Example:
To cause a cold start of an RTU, give the command:
#SET STA1:SFC1
To tag the database version with the current time, give the command:
#SET STA1:SFC19=RTU_ATIME
FT Function Table
Sending of a single function table to the RTU. The value written to the FT attribute
should be the context of the function table that is stated in a text string. Note that
sending function tables also demands sending the corresponding function
commands depending on whether you are sending the complete set of function
tables or just some alternating function table. The FT attribute is always set from a
tool.
Data type: Text
Value: Text
Access: Write-only
SY Synchronize
Makes an accurate time synchronization of the RTU(s). No value is necessary for
this attribute because the time sent to the RTU(s) is taken from the internal clock in
the communication frontend.
When writing to the SY attribute of the broadcast object, all RTUs connected to the
same NET unit are synchronized, one line at a time. The synchronization telegram
is sent out as a broadcast telegram on each line with the RP570 protocol. Note!
RTU200 and RTU210 substations do not support broadcast time synchronization
commands, therefore each RTU200/210 station must be synchronized separately.
Data type: Any
Value: Any or no value
Access: Write-only
Example:
STA2 is synchronized:
#SET STA2:SSY
DA Process Data
Object and regulation commands, digital and analog setpoints and general outputs.
262
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
The DA attribute is automatically set by the base system when the output values in
the process database are set. It is therefore not recommended to set the DA attribute
directly from SCIL.
When receiving a write command of the DA attribute the communication frontend
will generate the corresponding RP570 telegram and send it down to the RTU.
Unless the command is a regulation command, the communication frontend will
wait for a response from the RTU. If there is no response within a certain time
(configurable, see the RT attribute), the communication frontend will respond by an
error code to the base system. Otherwise, the communication frontend will check the
response telegram and respond with an error code to the base system if it differs from
what is expected as a positive acknowledgement to the command.
When this attribute is set, the communication frontend sends an RP570 telegram to
the RTU and, unless the telegram is in monologue mode (no response expected),
wait for the response from the RTU. If the response is not a positive
acknowledgement, the communication frontend responds with an error code.
Data type: Integer
Value: Depends on the object type
Index: One index that expresses the RTU object number and type in a
packed format (see the SCIL function RTU_OA)
Access: Write-only
RT Reply Timeout
Determines the maximal time that the NET unit will wait for a telegram response
from the RTU.
Data type: Integer
Value: 0 ... 655
Unit: Seconds
Default value: 20
263
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
Recommended This time should be at least as long as the timeout for the
value: corresponding communication line multiplied by the number of
retries on that line. Note that when sending some function
commands the response time from the RTU is longer than during
normal communication.
Access: No restrictions
SM Sync Mode
Selecting the time synchronization mode, monologue or a dialog.
Data type: Integer
Value: 0 Monologue
1 Dialog
Default value: 0
Access: No restrictions
TA Transfer Address
Enables the registration of RP570 telegrams - transparent data telegrams (TDR),
SYSM (terminal messages), terminal status (TSTA), ERMFD messages and
ERMIR messages - in bit stream process objects. The TA attribute specifies the
addresses of the receiving process objects when the telegram type is given as the
index. Transfer address 0 for an index means that the telegram type is not updated
as a bit stream.
Giving an address to transparent data (index 1) means that the whole transparent data
telegram is updated in the bit stream object with the given transfer address, and no
system message is generated. TA(1) = 0 means that a system message is generated
but the telegram is not updated in a process object.
264
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
Giving an address to terminal messages (index 2) means that the whole terminal
message content is sent into a bit stream object with the given transfer address, and
additionally a system message is generated. TA(2) = 0 means that a system message
is generated, but the message is not updated in a process object.
Giving an address to the terminal status messages (index 3), the messages are
updated as a bit stream message in the process object with the given address. The
messages are updated each time NET unit receives a TSTA message, which
indicates the change of RTU terminal status. If TA(3) == 0 (default), NET unit uses
the old transfer method, which means that NET unit sends a system message when
a terminal status change has occurred. In that case, each bit change in the terminal
status causes a system message, that is, one TSTA message may cause 16 system
messages.
To make the bit stream messages readable, the SYS 600 application must contain a
command procedure that translates the messages to terminal status information.
The TSTA bit stream contains 40 bits as follows:
IDENT Bits 1 ... 8. Terminal status identity.
FLAGS Bits 9 ... 24. Flags for changed bits of TSTA status. True bit
indicates which bits are changed in terminal status.
STATUS Bits 25 ... 40. Current terminal status.
Giving an address to the ERMFD messages (index 4) means that the messages are
updated as bit streams in process objects. If TA(4) = 0, the ERMFD messages are
updated in analog process objects (RTU object type 11, RTU analog event recording
object).
Giving an address to the ERMIR messages (index 4) means that the messages are
updated as bit streams in process objects. If TA(4) = 0, the ERMIR messages are
updated in analog process objects (RTU object type 10, RTU indication event
recording).
Data type: Vector
Value: Vector or 5 integers in the range 0 ... 4095
0 = the telegram is not updated in a bit stream process object
Indexing: One index, 1 ... 5. Omitting the index correspond to index 1.
1 Transfer address for transparent data
2 Transfer address for terminal messages (SYSM)
3 Transfer address for terminal status (TSTA) messages
4 First process database address for ERMFD messages.
Allowed address: 2304. When using TA(4) = 2304, the
addresses 2304 ... 2559 are reserved for ERMFD data.
5 First process database address for ERMIR messages.
Allowed address: 1792. When using TA(5) = 1792, the
addresses 1792 ... 2047 are reserved for ERMIR data.
Recomm. values: Recommended value for TA(3) = 512
Default values: 0 for indices 1 ... 3
TA(4) = 2304
265
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
TA(5) = 1792
Access: No restrictions
TD Transparent Data
Writing transparent data (TDC) to the RTU. The RP570 protocol conveys the data
directly. The interpretation and handling of transparent data are defined in the RTU.
The response (TDR) can be read with the RD attribute a few seconds after the
transparent data has been sent, or it can be updated in a process object specified by
the TA attribute. When an answer arrives, the system message 12683
RTU_TRANSPARENT_DATA_PENDING) is generated.
Data type: Text
Value: Text of max. 224 bytes
Access: Write-only
Example:
#SET STA1:STD = "ABCDEF"
#ON RTU1:E1 #IF RTU1:P1 = 12683 #THEN –
@RESPONSE = STA1:SRD
TE Terminal Event
Reading of the terminal events stored in NET unit. There is a ring buffer storage of
10 events for each RTU in the NET unit. Each time NET unit receives a terminal
event it will send a tag number (1...999) as a system message (see the MI attribute).
The corresponding event can be fetched from NET unit by reading the TE attribute
indexed with the tag number.
If the event with the desired tag number is no longer found (due to buffer overflow),
NET unit responds with the error code RTUC_EVENT_NOT_FOUND.
Data type: Text
Value A text of 7 bytes. The first byte is the event number and the rest
of the bytes informational.
Indexing: One index. The event tag number.
Access: Read-only
TM Terminal Message
Reading of the terminal message (system message in the RTU) stored in the
communication frontend. There is a ring buffer storage of 3 messages for each RTU
in the communication frontend. Each time the communication frontend receives a
terminal message it will send a tag number (1 ... 999) as a system message (see the
MI attribute). The corresponding message can be fetched from the communication
frontend by reading the TM attribute indexed with the tag number.
If the event with the desired tag number is no longer found (due to buffer overflow),
the communication frontend responds with the error code
RTUC_MESSAGE_NOT_FOUND.
266
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
Reading the TM attribute results in a 30 byte long text string. The text is used for
system analysis of the RTU. Note that terminal messages are sent only by a function
command request.
Data type: Text
Value: Text of 30 bytes
Indexing: One index. The event tag number.
Access: Read-only
TS Terminal Status
Reading the current (= last reported) terminal status stored in the communication
frontend as two 16 bit words. The terminal status is sent by the RTU after a status
check (start-up) (see SC attribute) or at changes in the status during operation.
Data type: Text
Value: Two integers of 16 bits. The individual bits in the status words
indicate different faults in the RTU, for example indication
faults.
Indexing: Index 1: word 1
Index 2: word 2
Only one index is allowed
Access: Read-only
DR Direction
The polling direction of the RTU. The direction is specified by the loop line
configuration (the NET line attributes DR and CF).
Data type: Text
Value: "A" or "B"
Access: Read-only
267
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
LW Loop Switch
The state of the Loop Reversal Unit of the RTU. The state can be changed with the
line attribute CF and automatically.
Data type: Integer
Value: 0 Open
1 Closed
Access: Read-only
268
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
BL Broadcast Lines
Choosing to which NET lines the broadcast messages, that is messages to station
STA0, will be transmitted. SPA stations on LonTalk protocol lines (communicating
via LSG device) must not be included in a broadcast. The attribute can only be used
with STA0W
Data type: Vector
Value: Vector
The elements of the vector determines which lines to be included
in broadcast. A zero is always added first in the vector.
Default value: 0 = Broadcast messages are not sent to any NET line
Access: No restrictions
Example:
Broadcasting a messages to line 4 and 7, sta0 is defined as station 0 to the NET:
#set STA0:SBL=(0,0,0,0,1,0,0,1,0)
Now it should be possible to read the message with STA0:SBL. The answer should
be the line number if only one line is specified. Otherwise it should be a vector
containing the line numbers.
SA Station Address
The station address of the SPACOM unit used in the communication with NET unit.
The station address must be unique among all SPA modules connected to the same
NET line. Modules connected to different lines may be given the same station
address. The station address of a STA object must coincide with the station address
(slave number) defined in the corresponding SPACOM unit.
The broadcast telegrams always use the address 900 and need not be specified by
this attribute.
Data type: Integer
Value: 1 ... 255 if set in the preconfiguration, 1 ... 899 on-line.
Access: No restrictions
269
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
UN Unit Number
Unit number of the SPA. Corresponds to the SPA station address (slave number).
Data type: Integer
Value: 0 ... 65535
Access: No restrictions
UT Unit Type
The type of the relay module: relay unit, alarm unit or SPA unit connected to LSG
device.
Data type: Integer
Value: 0 Relay Unit
1 Alarm Unit
3 SPA unit connected to LSG device
Default value: 0
Access: No restrictions
RL Router LMK
The RL attribute defines the object number (STA object number) of the LSG device
to which the SPA station is physically connected and which acts as a router for the
SPA station.
The attribute applies only for SPA units that are connected to the LONWORKS
network via LSG devices (UT = 3). It has no meaning for the SPA units connected
directly to the NET unit.
Data type: Integer
Value: 1 ... 512
Access: No restrictions
270
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
DC Diagnostic Counters
Diagnostic counters keep count of various situations that can occur in the STA
device. Each counter is associated with a descriptive name, but when it is accessed
from SCIL the corresponding counter number (integer constant) must be used.
The diagnostic counters have the following meanings:
1. PROCESS DATA TELEGRAM RECEIVED
2. EVENT TELEGRAM RECEIVED
3. SUSPENSIONS
4. REPLY TIMEOUTS
5. BUFFER ALLOC FAILURES
6. PROCESS MESSAGES RECEIVED
7. ERROR IN E50 E51 RECOVERY
8. EVENT TO DATA DISCREAPANCY
9. UNEXPECTED SCM REPLY
10.ED REP FAIL NO BUFFS AVAIL
Data type: Integer
Value: 0 ... 30000
Index: Diagnostic Counter number, 1 ... 16
Access: Read-only, the values can be reset
271
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
RT Reply Time-out
Maximum time in seconds to wait for reply from a SPACOM unit. If the station does
not answer within RT seconds, it will be suspended.
Data type: Integer
Value: 0 ... 65535
Unit: Seconds
Default value: 60 seconds
Recomm. value: Do not use RT = 0
Access: No restrictions
ED Event to Data
Defines SPA points that are updated by events. The attribute specifies which events
that may update each SPA point, and how the event codes shall be interpreted.
Data type: Vector
Value: Vector of 7 ... 13 elements.
See the explanations of the parameters in Table 16.5.5-1.
1 Object type
2 Channel 1
3 Channel 2
4 Bits per channel
5 Significant bits
6 Event number
7 Event value
8 ... Event number for odd elements and event value for even
13 elements (optional)
Indexing: SPA point number. See the SP attribute.
Access: No restrictions
Example:
In a SPOC 110C unit, channels 1 ... 8 are defined as double indications, channels 9
... 16 as single indications. Both are event updated. The double indications use the
following event codes:
E1 = 01 (closed)
E2 = 10 (opened)
E3 = 11 (error)
E4 = 00 (error)
272
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
bit transpose mask Integer, 0 ... 65535. The bits in the bit mask of the integer
specify in pairs a possible change of bit order in double
indications. ''00” = no change of order. "11" = change of order.
In SYS 600 the first bit in a double indication is supposed to
be "closed" and the second bit "open". If the SPACOM unit
uses another order, the bits must change order.
bit type mask Integer, 0 ... 65535. The bits in the bit mask of the integer
specify in pairs the type of indication: "11" = double indication,
"0" = single indication.
channel 1 Integer, 0 ... 999. The lowest channel which updates the point.
channel 2 Integer, 0 ... 999. The highest channel which updates the
point.
data format 1 = bits
2 = hexadecimal
3 = real
4 = long integer
data category The data category as defined in the SPA protocol (v.2.4) given
as a text: "I", "O", "S", "V", "M", "C", "F', "T", "D", "L", “B”.
data nr 1 Integer, 0 ... 65535
data nr 2 Integer, 0 ... 65535
event number An event number that updates the point.
event value The value that the point is updated to when the event
specified by ‘event number’ occurs.
filter (deadband) Real positive decimal value 0 ... 0.999 (less than 1). The
smallest change in input value that is reported to the process
database.
object type Integer 0 ... 7. 0 = indication, 1 = digital input, 2 = analog input,
3 = digital setpoint, 4 = analog setpoint, 5 = object command,
6 = pulse counter, 7 = event code parsing (for internal use
only)
process object address Integer, 1 ... 255. The block address of the process object
corresponding to the SPA point (as defined in the process
object definition.
273
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
Parameter Explanation
bits per channel Integer, 0 ... 15. The number of bits per channel.
significant bits An integer, whose bit mask specifies the bits that are affected
by the event to data conversion. 1 - single indication, 3 =
double indication.
updating method 1 = cyclical polling
2 = event update
3 = event consume. Events are used for the updating of the
corresponding process object, but not for updating of the
event handling object.
SP SPA Point
Defines the SPA points to NET unit. It ties together the SPA identifications and the
corresponding process objects. Each SPA point, independent of updating method,
must be defined by this attribute. A SPA point number identifies each SPA point,
which must be unique among all SPA points within the SPA module.
If the object type is analog input or pulse counter and the amount of the configured
data points is greater than 1 (data2 - data1 > 1), the entered SYS 600 process object
address is understood as a starting address and is updated with value 'data 1'. The
deadband value given as element 9 is meaningless in this configuration. The
maximum amount of values in one definition is 15. See the example at the end of
this description for more information.
When writing to this attribute, all parameters must be present. See the parameter
explanations in Table 16.5.5-1. The SPA points in SPA units connected via LSG
device are defined mainly in the same way as SPA points connected via the SPA
protocol. However, there are some differences in the analog point definition.
Data type: Vector
Value: Vector of 7 ... 11 elements. The meaning of the elements
depends on the type of the SPA point as described below. For an
explanation of the parameters, see Table 16.5.5-1.
Indications:
Element 1: Object type
2: Channel 1
3: Channel 2
4: Data category
5: Data 1
6: Data 2
7: SPA data format
8: SYS 600 process object address
9: Bit type mask
10: Bit transpose mask
11: Updating method
274
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
Command point:
Element 1: Object type
2: Channel 1
275
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
3: Channel 2
4: Data category
5: Data 1
6: Data 2
7: SPA data format
8: Process object address
9: Updating method
Defining three pulse counter points of active energy in the SPAC 330C unit (SPA
item: channel 0, "V", data 8 ... 10). The delta value 0 is meaningless in this situation.
The updated SYS 600 process objects are 100 .. 102:
#SET STA1:SSP2 = (6,0,0,"V",8,10,4,100,0,1)
DA Data
This attribute is used for process database communication. It may not be used in
SCIL programs.
PR Parameter Reservation
By writing to this attribute (value 1), the writing application reserves the right to read
and write the SPA parameters using the STAn:SSM attribute of the station. By
writing a zero (0) to the PR attribute, the reservation is released. Only the reserving
application, or the AS application can release the reservation. By reading the
attribute you get information of the reserving application.
When no reservation is active, only the AS application is allowed to access the SM
attribute.
Spontaneous data (events etc.) is always sent to the application defined by the AS
attribute.
Data type: Integer, vector
Value: Write value, 0 or 1:
0 Release. Allowed always for the AS application. Allowed
always if no reservation is active. Allowed for the
application holding the reservation. Not allowed in other
cases.
276
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
SM SPA Message
Makes it possible to communicate with a SPACOM unit by sending any SPA
message and reading the reply as a text. No check of the message is performed in
SCIL, or in NET unit, that is, even faulty messages are sent to the SPACOM unit.
When a SPA message has been sent from an application, the reply to the message
can only be read once from the same application.
Unless a reservation has been made with the PR attribute, only the application
specified by the AS attribute has access to the SM attribute.
Data type: Text
Value: The contents of a valid SPA-message, not including the message
frame (start character, unit address, checksum, and message
trailer), ending with a : character
Access: No restrictions
Example:
Requesting SPACOM unit identification using data category "F", from a 16D alarm
unit:
#SET STA1:SSM = ("RF:")
ST State
The status of the station: OK (answering to poll messages) or suspended.
Data type: Integer
Value: 0 Suspended
277
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
1 OK
Indexing: None
Access: Read-only
UP Update Points
Starts an updating of all SPA points. When the attribute is set to 1, NET unit starts
to poll all defined SPA points once (including event updated points) and sends the
data to the application, whether the data had changed or not. Filter values for analog
points are ignored. When all points have been polled once, NET unit resets the UP
attribute to 0 and sends a system message
(SPAP_DATABASE_UPDATE_COMPLETE).
When reading the attribute, it tells the on-going operation.
Data type: Integer
Value: 0 No on-going updating (read)
1 Start updating (write), on-going updating (read)
Index: None
Access: No restrictions
CT Connecting Timeout
The maximum time of the TCP ‘connect’ operation. The value of this attribute
depends on the speed of LAN, remote station and the possible routers between
SYS 600 and the substation. It should be smaller than the HT attribute of the line but
it should be big enough to enable reliable reconnecting of the substation. In a
multidrop configuration, too big a value may cause communication disturbances if
some of the stations is not available.
Data type: Integer
Value: 0 ... 60000
Unit: Milliseconds
Default: 500 ms
Access: No restrictions
278
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
ET Reconnecting Timeout
The interval of reconnecting attempt while communication is not established.
Data type: Integer
Value: 1 ... 255
Unit: Seconds
Default: 30 s
Access: No restrictions
IA Internet Address
The IP address or the host name of the remote host. The connection is established
with a device in this address using port number 7001 (defined in [2]). The line must
be taken into use at least once before the writing to this attribute.
Data type: Text
Value: Any string, max 29 characters
Access: No restrictions
This attribute accepts the IP address in form
#SET STA1:SIA = "10.0.0.51"
or as an alias name
#SET STA1:SIA = "rtu51"
When an alias name is used, it must be defined in the TCP host file
%windir\system32\drivers\etc\hosts
279
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
where
'n' is the station number, 0 ... 1000, as known to the application by
the station mapping, see section 12.3.4. The number is translated
to system object number, 0 ... 100, as illustrated in figure 12-5.
'at 'is attribute name.
Attributes
The STA attributes in this section are valid only for stations of type P214. The
attributes are described in the following subsections:
16.6.1 Basic Attributes: IU, LI, SA
16.6.2 Device Reservation: AL, AS
16.6.3. Suspension and Diagnostics: DC, RT
16.6.4. System Message Handling: MI, MS, OS
16.6.5. Data Communication: DA, EC, FC, FE, GP, NR, TV
16.6.6. Priority Control: PC, PM
IU In Use
This attribute states whether the station connection is in use or not. The attribute tells
the state of use as known to the communication unit. It does not affect the station
itself, only its image in the communication unit.
The station sends no system messages as long as it is out of use. At the moment when
the station is taken out of use a system message is sent.
Values: 0 Not in use
1 In use
Default value: 0
Access: No restrictions
LI Line Number
The number of the NET line, to which the RTU is connected. The station is switched
from one line to another by writing a new value to the LI attribute. Change of line in
this way is possible only if both the previous and the new lines are defined with the
same protocol and have been taken out of use.
Value: Integer 1 ... 12
Default value: The NETn:SPC attribute
280
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
SA Station Address
The station address of the RTU. The address must be unique among all S.P.I.D.E.R.
RTUs and P214 RTUs connected to the same NET. The attribute must have the same
value as the station address in the corresponding RTU.
Value: Integer, 0 ... 255. 0 = Broadcast address
Access: Read, conditional write
AL Allocation
The attribute tells whether or not the RTU is reserved by a certain application (see
the AS attribute).
Rec. value: For P214 connections AL should always be 1, i.e. the allocation
is always active (AL = 1).
AS Allocating Application
The number of the application which has reserved the RTU. The spontaneous
messages from the station are sent to this application. Other applications can send
read commands to the station but do not get any spontaneous messages.
Value: Integer, 0 ... 250. The application number as known to the
communication unit. 0 = no application.
Access: No restrictions
DC Diagnostic Counters
P214 type stations have the following diagnostic counters:
1. STATION_SUSPENSIONS COUNTER
2. DEV_STATUS_RECEIVED COUNTER
3. REPLY_STATUS COUNTER
4. STS_NOT_OK_FROM_PCL COUNTER
Value: Vector of four integers in the range 0 ... 30000. Each element is
a counter value.
Indexing: Counter number.
Access: Not preconfigurable, otherwise no restrictions.
281
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
RT Reply Time-out
The maximum time (number of seconds) that the communication unit will wait for
a reply from the station.
Value: Integer, 0 ... 655. Number of seconds.
Default value: 45
Rec. value: For point-to-point connected stations, the recommended value is
approximately 15 s, and for multidrop connected stations
approximately 45 s. To prevent unnecessary time-outs caused by
data link layer retransmissions, the value of RT should be
significantly greater than the product of the TI and EN line
attribute values (TI*EN).
Access: No restrictions.
MI Message Identification
The object address (the POA attribute) to which the system messages from the
device are sent. See the MI attribute in Section 11.2.6.
The P214 system messages are of two types:
1: Codes generated in NET
2: Terminal status codes
Value: Vector of two integers, 1 ... 16380
Indexing: Message type number, 1 or 2
Default value: Index 1: 1000 + station number (NET messages)
Index 2: 1500 + station number (terminal status codes)
These default values can be used as such (copied to the process
object address), or they can be changed.
Example: See the MI attribute in Section 11.2.6
282
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
MS Message Application
The MS attribute is the system object number of the application which will receive
the system messages from the station.
Value: Integer, 1 ... 250. The APL object number as known to the
communication unit.
Default value: 1
Access: No restrictions
OS Object Status
Writing to the OS attribute (OS = 1) of a station makes NET retransmit the last
system message caused by the station. Possible "Stopped" and "Suspended"
messages cause old-marking of process objects. By reading the OS attribute, the
status code of the system message can be read.
Value: Integer
When written: 1 = retransmit system message
When read: a status code:
0 OK
12803 Station not in use
12801 Station suspended
DA Data Value
The data of the group.
This attribute is used for reading and writing group data.
Value: Depending on the group datatype:
Command output: 1 or 0
Set point: 16 bit integer
Counter and simple data:16 bit word/cardinal
Measurand: 16 bit integer
Indexing: Depending on the group datatype:
Command output: group and bit address in the form:
group^bit_no
where
'group' = group number + 2000H
'bit_no' = bit number 0 ... 15
Set point: Group number + 5000H
Counter and simple data: Group number
Measurand: Group number
Access: Depending on the group datatype:
283
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
EC Event Control
The event generation in the RTU can be enabled or disabled for one class at a time
using the EC attribute. When the EC attribute is read, NET returns a 16 bit mask, but
the attribute is written one bit at a time by indexing the attribute.
Value: When read: Integer of 16 bits
When written: Vector of 16 integers, 0 or 1
Indexing: When read: No
When written: Bit number
Access: No restrictions
Example:
#SET STA2:SEC5 = 1 ;Bit number 5 is set on.
FC Freeze Counters
Freezes the counters of all P214 RTUs connected to NET. NET will send one freeze
counter command per P214 line.
Value: 1
Access: Write-only, only for broadcast station
Example:
#SET STA0:SFC = 1
FE Flush Events
Setting this attributes clears all the event buffers of the station.
Value: 1
Access: Write-only
Example:
#SET STA1:SFE = 1
284
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
GP Group Parameters
Group parameters (at present, only deadband) can be read and written with this
attribute. Because the number of parameters varies from group to group, the
parameters should always be read first, then edited and written. When reading the
GP attribute, NET returns a vector. When writing, a string variable should be used.
Value: When read: vector of integers
When written: text string
Indexing: Group number
Access: No restrictions
Example:
@V = STA2:SGP200
... editing ...
#SET STA2:SGP200 = string
NR Normalize
After start-up the RTU is normalized by writing to this attribute.
Value: 1
Access: Write-only
Example:
#SET STAn:SNR = 1
ST Set Time
Synchronizes the clocks of all P214 RTUs to the NET clock using one broadcast
command to each P214 line.
Value: 1
Access: Write-only, only for broadcast station
Example:
#SET STAn:SST = 1
TV Type Value
Writing of group type code to the attribute TV means a request for updating objects
of that type in the process database.
Value: Integer, 1, 2 or 5, the datatype
1 Simple data
2 Counters
285
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
5 Measurands
Access: Write-only
Example:
#SET STAn:STV=5
PM Priority Mask
With this mask the event classes of the RTU can be grouped into two priority levels.
The mask is a 16 bit word. Each bit in the mask controls the corresponding event
class. The ones in the mask tell which classes will be polled with a higher priority.
The internal event classes (13, 1 and 15) are, however, always polled with high
priority, and will always be returned as ones from NET when PM is read. When
writing the PM attribute, NET ignores the contents of bits 13 ... 15.
Value: Integer of 16 bits
Access: No restrictions
NN Node Number
The LONWORKS node number of the station.
Data type: Integer
Value: 1 ... 127
Access: No restrictions
286
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
SN Subnet Number
The subnet number of the station.
Data type: Integer
Value: 1 ... 127
Access: No restrictions
UN Unit Number
Unit number used in transparent SPA messages (both messages resulting from
commands and messages generated with the SM attribute.
Data type: Integer
Value: 0 ... 65535
Access: No restrictions
UT Unit Type
This attribute is obsolete, it has no functional meaning. For compatibility reasons, it
has not been removed.
Data type: Integer
Value: 0 = REx device
1 = REC 561
Index: None
Default value: 0
Access: No restrictions
287
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
288
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
DA Data
This attribute is used for process database communication. It is not used from SCIL
programs.
RQ Receive Quota
Receive quota for the station. This attribute defines the maximum amount of
incoming data messages received from the device but not yet acknowledged and
transmitted to the SYS 600 process database. This value is not used in the
transparent SPA communication. Generally, the default value is suitable; a bigger
value increases the buffer consumption from the pool defined with the line attribute
PS.
Data type: Integer
Values: 1 ... 10
Default value: 10
289
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
Indexing: None
Access: No restrictions
SM SPA Message
Sending of any SPA message to the REX station. The reply that is received can be
read as a character string using the SM attribute and processed in SCIL. When
sending a SPA message, SYS 600 does not check the correctness of the message
syntax.
TC Transaction Check
This attribute can be used to report for too high speed of issuing the SPA messages
using attribute SM. If the value of TC is 1, STA object may return an error code
13356 REXC_SM_WRITE_BUSY indicating that the amount SPA messages is too
big for the device. With most devices, this transaction check is not needed.
TQ Transmit Quota
Transmit quota for this device. This attribute defines the maximum amount of
outgoing data messages transmitted to the device but not yet acknowledged by the
device. This value is not used in the transparent SPA communication. Generally, the
default value is suitable.
Data type: Integer
Values: 1 ... 10
Indexing: None
Default value: 10
Access: No restrictions
290
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
GI General Interrogation
An application may at any time force a complete update of point data by mean of
this attribute. Setting this attribute to 1 makes the NET unit send a general
interrogation command to the REX unit that then reads its process connections and
sends the data to NET unit. NET unit resets the GI attribute to 0 when the general
interrogation termination message is received from the unit.
Data type: Integer
Value: 0 or 1
Index: None
Access: No restrictions
Example:
The command activates an updating of the process objects:
#SET STA4:SGI = 1
291
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
1 Desubstitute
2 Block
3 Deblock
4 Substitute & block
5 Desubstitute & deblock
6 Set (parameter)
7 ... 255 Reserved for future use
TOV
Value: Description:
0 Value not present
1 SPI Single Point Information
2 DPI Double Point Information
3 SVAF Short Floating Point Number
4 BSI Binary State Information
5 BCR Binary Counter Reading
6 VAI Signed Integer Information (16 bit)
7 VAI32 Signed Integer Information (32 bit)
8 VTI Value with Transient State Indication
9 CP16 Two Octet Binary Time
10 Time Tag Information
LOV Length of attribute value (AVA) in bytes
AVA Array of bytes according to TOV as defined in LAG
IL Interlocking Data
Downloading the interlocking data to a bay unit when substitution concept is used.
Data type: Vector
Value: An array with five elements:
1 Object Address
2…5 4 bytes of data holding the value
Indexing: No indexes
Access: Write only
Example:
Send interlocking data 8,1,3,6 to object address 1342 in REX device 4:
#SET STA4:SIL = (1342,8,1,3,6)
292
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
HI Historical Events
Specifies whether history events are requested at event session start-up or not.
History events are events collected before event session start-up time.
If this attribute is set to 1, all history events registered in the station since the time
specified by the HS attribute (see below) are reported at the beginning of an event
session.
Data type: Integer
Value: 0 History events are not updated
1 History events are updated
Access: No restrictions
293
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
Example:
Assuming NEWEST_EV is a process object whose time is used to specify the start
time of history events:
#SET STA1:SHS=(NEWEST_EV:PRT1, NEWEST_EV:PRM1)
RM Running Mode
Determines if an event session is opened when the IU attribute is set to 1.
Data type: Integer
Values: 2 or 7:
2 No event session. Transparent SPA messages are possible
but not as commands.
7 Event session opened, transparent SPA messages and
commands possible.
Indexing: None
Access: No restrictions
RT Reply Timeout
The maximum time in seconds that NET unit waits for reply from the REX unit
when sending commands and transparent SPA messages.
Data type: Integer
Value: 0 ... 655
Unit: Seconds
Default: 20 seconds
Access: No restrictions
SP SPA Point
The binary output objects (SPA commands) as SPA points to NET unit. It ties
together the SPA command identifications and the corresponding process objects. A
SPA point number identifies each SPA point, which must be unique among all SPA
points within the same REX module.
Data type: Vector
Value: Vector of 8 integer and text elements. When writing to the
attribute, all elements must be present.
1 10
2 Channel 1, integer 0 ... 999
3 Channel 2, integer 0 ... 999
294
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
4: Data category
When writing:
Text: "I", "O", "S", "V", "M", "C",“F","T","D","L" or "B"
When reading:
ASCII code of the character above
5 Data nr 1, integer 0 ... 999999
6 Data nr 2, integer 0 ... 999999
7 Data format, integer 1 ... 4. 1 = bits, 2 = hexadecimal, 3 =
real, 4 = longint
8 Process object address, integer 0 ... 65535
Indexing: 1 ... max point def
Access: No restrictions
Example:
Defining a binary output at channel 1 in a SACO16D unit (SPA items: 1O1) at OA
666:
#SET STA1:SSP1 = (10, 1,1,"O",1,1,1, 666)
295
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
NN Node Number
The LONWORKS node number of the station.
Data type: Integer
Values: 1 ... 127
Indexing: None
Access: No restrictions
SN Subnet Number
The subnet number of the station.
Data type: Integer
Values: 1 ... 127
Indexing: None
Access: No restrictions
UT Unit Type
The type of the LMK station:
• LSG device.
• Multiple LONMARK devices (devices which take input from many physical
devices).
• Other devices using the standard LONWORKS interface (for example Weidmüller).
Data type: Integer
Value: 1 LONMARK device (not multiple and not LSG device)
2 Multiple LONMARK device (this device takes input from
many physical devices)
3 LSG device
Default value: 1
Access: No restrictions
296
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
DA Data
The attribute for process communication database. It is not used from SCIL
programs.
GI General Interrogation
An application may at any time force a complete update of point data by mean of
this attribute. Setting this attribute to 1 makes the NET unit send a general
interrogation command to the LMK unit, which then reads its process connections
and sends the data to NET unit. NET unit resets the GI attribute to 0 when the general
interrogation termination message is received from the unit.
Data type: Integer
Value: 0 or 1
Index: None
Access: No restrictions
Example:
This command activates an updating of the process objects:
#SET STA4:SGI = 1
LM LON Message
Sending any LonTalk message to the LMK station. The reply that is received can be
read back from the LM attribute (as a character string) and processed in SCIL.
Data type: Text
Value: Write value: LON message
297
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
RT Reply Timeout
Maximum time in milliseconds to wait for reply from a LONWORKS node when
sending commands and transparent SPA messages.
Data type: Integer
Value: 0 ... 65535
Unit: Milliseconds
Indexing: None
Default value: 5000 milliseconds
Access: No restrictions
DC Diagnostic Counters
Keeping count of various situations that can occur in the STA device. Each counter
is associated with a descriptive name, but when it is accessed from SCIL the
corresponding counter number (integer constant) must be used. LMK stations have
8 diagnostic counters.
The diagnostic counters have the following meanings:
1. LKM_PROCESS_DATA_TLG_RECEIVED
2. LMK_SENT_SPA_MESSAGES
3. LMK_SUSPENSIONS
4. LMK_REPLY_TIMEOUTS
5. LMK_BUFFER_ALLOC_FAILURES
6. LMK_TRANSPARENT_SPA_TIMEOUTS
7. LMK_UNEXPECTED_REPLY_RECEIVED
8. LMK_REPLIES_RECEIVED
Data type: Vector
Value: Vector of 10 integers in the range 0 ... 30000
Index: 1 ... 8, counter number
Access: Read-only, the values can be reset
DI Diagnostic Interval
Defines the period of time that the LMK device polls node status from the physical
device (each DI seconds) to make sure that the connection is alive. A failed status
poll suspends the device. The diagnostic message is initiated from PC_NET to the
LSG device and it uses REQUEST/RESPONSE service provided by LON.
Data type: Integer
Values: 0 ... 65535
298
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
LP LON Point
Ties together the LONWORKS Network Variable indices with process objects in
the process database. A LON point number identifies each LONWORKS point in
NET unit, which must be unique among all LON points referring to the same
LONWORKS module.
Data type: Vector
Value: Vector of 6...7 elements depending on the LONWORKS point type.
When writing to this attribute, all parameters must be present
Analog input definition:
Element 1: 2
Element 2: Network variable index. Integer, 0 ... 4095.
Element 3: LON base type, see Table 16.8.5-1.
Element 4: Self-documentation text. Text of max 30
Element 5: SNVT type. According to LonMarc spec. (The
SNVT Master List ... 1995).
Element 6: Process object address. Integer, 0 ... 65535.
Element 7: Deadband. Real, 0 ... 0.9999.
299
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
300
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
1 LBT_UNSIGNED_16
2 LBT_SIGNED_16
3 LBT_UNSIGNED_8
4 LBT_SIGNED_8
5 LBT_SIGNED_32
7 LBT_FLOAT_IEE754
8 LBT_STRUCTURE
9 LBT_LSG_CONTROL
10 LBT_LSG_BIT_WRITE
SA Station Address
The station address of the master station. The address must be unique among all SPI
type stations connected to the same NET unit. The address must coincide with the
corresponding address in the master station.
Data type: Integer
Value: 1 ... 255
Access: Read, conditional write
301
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
The FT attribute accepts FTABs in the same format as the RTU 200 devices (RTU
type STA objects) in NET unit. This format is a character string whose ASCII value
represents the corresponding FTAB byte in a certain FTAB. Use the SCIL function
RTU_BIN to convert hex values to ASCII. Refer to the RP-570 protocol manual to
find details about the FTAB contents. The document "Functional specification for
RP-570 Slave protocol in NET" lists supported FTAB fields. Unsupported fields are
ignored.
When all FTABs have been loaded, bit 8 (RTU active) in the ST1 attribute must be
set to “1”. This has the same effect as “FCOM ACTIVATE” from the master.
Data type: Text
Value: Text
Index: None
Access: Write-only
Example:
Writing a simple AMV FTAB for block number 100 with priority 1 and deadband
10:
#SET STA1:SFT=RTU_BIN("0A640000000000010000000A00"); WRITE FTAB(s)
#SET STA1:SST1=(8,1). ; ACTIVATE WHEN ALL FTABS ARE WRITTEN
302
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
OL Overflow Limit
This attribute defines the low and high limits for valid analog input values. If the
value is outside the range defined by this attribute, the data is sent with faulty status.
Value: Integer, -2047 ... 2047
Indexing: 1 Lowest valid value
2 Highest valid value
Default: 1 -2000
2 2000
Access: Read/write
AV Analog Value
Update of changes in analog measured values in the master station. The values
assigned to this attribute are transferred to the master station as AVM/AVS
telegrams. The AV attribute is assigned a vector consisting of a time stamp, the
analog value and a status indicator. The current value of the AV attribute can be read
back, but a read operation only returns the analog value (not a vector).
The attribute is indexed by the block address of the value as defined in the master
station and in NET unit.
Data type: Vector
Value: A vector of three elements:
(time, value, status)
303
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
where
‘time’ Is the time stamp of the data given in RP570 format as
a text. The SYS 600 time can be transformed to RP570
format using the SCIL function RTU_ATIME
‘value’ Is the analog value given as an integer number scaled
to the range -2000 ...+2000. If a value outside this
range is given, the value is sent to the master station
with faulty status according to the RP570 protocol.
This behavior can be modified with the configuration
attribute OL. If the value is outside -2047 ...+2047, it
is truncated to lie within this limit.
‘status’ Is a status indicator given as an integer in the range 0
... 15. When status is changed using this attribute, NET
unit reports it automatically as AVS to the master. The
value of status has the following meaning:
Bit nr in status Meaning
B3 ...... B0
* 0 0 0 Normal
* 0 0 1 Low alarm zone
* 0 1 0 High alarm zone
* 0 1 1 Low warning zone
* 1 0 0 High warning zone
* 1 0 1 Spare
* 1 1 0 Spare
* 1 1 1 Faulty value
Bit B3 = 0 means “Normal trend”
Bit B3 = 1 means “High trend”
B3 is combined with B2 ... B0 to form the status word.
For example ‘status’ = 0 means “normal trend, normal
value”. STATUS = 7 means “normal trend, faulty
value”. STATUS = 15 means “faulty value, high
trend”.
304
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
DD Double Indication
Send of changes in double indications to the master station. The values assigned to
this attribute are transferred to the master station as IDS/IDM telegrams. The
attribute is assigned a vector containing a time stamp, bit number, double indication
value, and status indicator.
The contents of the attribute can be read back to a SCIL variable, but the result of a
read operation is a single integer rather than a vector. The integer variable is a 16-
bit bitmask that represents the state of all bits in this block.
The attribute is indexed by the block address of the indication.
Data type: Vector
Value: A vector with 4 ... 6 elements given as follows:
(time, bit_nr, value, status [,ermi_enabled [,time_quality]] )
where
‘time’ Is a time stamp given in the format returned
by the SCIL function RTU_ATIME
‘bit_nr’ Is the bit address, 0, 2, 4, 6, 8, 10, 12 or 15,
of the double indication
‘value’ Is the value of the double indication, 0, 1,
2,or 3
‘status’ Is the status reported to the master system in
IDS telegrams. See the ‘status’ parameter for
the ID attribute.
The rest of the parameters are optional. If they are omitted then
default values will be used.
‘ermi_enabled’ See the ‘ermi_enabled’ parameter for the ID
attribute
‘time_quality’ See the ‘time’_quality’ parameter for the ID
attribute
Indexing: 0...255, block address
Access: No restrictions
305
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
‘bit_nr’ Is the bit number, 0 ... 15, of the changed bit.If the
object is a double indication, only the bit
specified by the ‘bit_nr’ parameter is considered
to have changed, and is affected by the FTAB
setup of the bit in question.
‘value’ Single indications:
0 Bit changed state to off
1 Bit changed state to on
ERMI is generated according to the FTAB
configuration for this indication block and bit
number.
Double indications:
In the case of double indications, the value of
both bits must be sent to NET unit, since both bits
must be reported in the ermi message. It is not
possible to read values from the internal database
in NET unit, because the indication block may
have been updated several times before the EI
attribute is written.
Value range: integer 0...3
0 Bit values 00
1 Bit values 01
2 Bit values 10
3 Bit values 11
Only the bit specified by ‘bit_nr’ is considered to
have changed.
‘time_quality’ See the ‘time_quality’ parameter of the ID
attribute below
Indexing: 0 ... 255, block address of the indication
Access: Write-only
Example:
Single indication handling. Assume that we have a single indication at block 55 bit
8, a time stamp in the variable %TIME, and time_quality = 5. To send an ERMI
message to the master station when bit 8 changes state to 0, execute the following
SCIL statement:
#SET STA1:SEI55 = (%TIME, 8, 0, 5)
To send an ERMI message when bit 8 changes state to 1, execute the following
SCIL statement:
#SET STA1:SEI55 = (%TIME, 8, 1, 5)
Example:
Double indication handling. Assume that we have a double indication at block 55,
bits 2 and 3, a time stamp stored in the TIME variable, time_quality = 5, bit 2 = 1
and bit 3 = 0 (the double indication bits are thus 01).
306
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
To send an ERMI message when bit 2 changes state to 0 (switch opens, but has not
reached end position yet), that is, the double indication bits are 00, execute the
following SCIL statement:
#SET STA1:SEI55 = ( TIME, 2, 0, 5)
To send an ERMI message when bit 3 changes state to 1 (switch is open and has
reached end position), i.e., the double indication bits are 10, execute the following
SCIL statement:
#SET STA1:SEI55=( TIME, 3, 2, 5)
To send an ERMI message when the switch is closed again but a fault keeps bit 3
activated, while bit 2 changes state to 1, i.e. the double indication bits are 11,
execute the following SCIL statement:
#SET STA1:SEI55 = ( TIME, 2, 3, 5)
Vector
ERMI ERMIR ERMA ERMD ERMFD
element
1 32 41 33 34 43
2...7 Time Time Time Time Time
8 Time quality Time quality Time quality Time quality Time quality
9 Bit number Bit number Limit info Limit info Format
10 Bit value Bit value Value msb
11 Rel.time msb Value
12 lsb Value
13 Number msb Value lsb
14 lsb Rel.time msb
15 Cause of lsb
transmission
307
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
16 Number msb
17 lsb
18 Cause of
transmission
ID Indications
Updating changes in indications (binary input data) in the master station. The values
assigned to this attribute are transferred to the master station as IDS/IDM telegrams.
The attribute is assigned a vector containing a time stamp, bit number, bit value, and
status indicator.
The contents of the attribute can be read back to a SCIL variable, but the result of a
read operation is a single integer rather than a vector. The integer variable is a 16-
bit bitmask that represents the state of all bits in this block.
The attribute is indexed by the block address of the indication.
Data type: Vector
Value: A vector with 4 ... 6 elements given as follows:
(time, bit_nr, value, status [,ermi_enabled [,time_quality]] )
where
308
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
309
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
Setting double indication bits 2 and 3 at block 5 to 10 (= OFF), assuming that status
is OK:
#SET STA99:SID(25)=(RTU_ATIME(%RT,%RM),2,0,0)
#SET STA99:SID(25)=(RTU_ATIME(%RT,%RM),3,1,0)
Setting bit 8 in block 55 to 1 and generating ermi, status set to 1, time quality = 5:
#SET STA1:SID55 = (TIME, 8, 1, 1, 1, 5)
PC Pulse Counter
Updating changes in pulse counters in the master station. The values assigned to this
attribute are transferred to the master station as PCM telegrams. The PC attribute is
assigned a vector consisting of time stamp, end of period flag and pulse counter
value.
The content of the attribute can be read back to a SCIL variable, but the result of a
read operation is a single integer rather than a vector. The integer variable contains
the last PC-value that was written to this block.
A previous value that has not yet been sent to the master station cannot be
overwritten by a new value. If an attempt is made to write such a value, the SCIL
STATUS SPIC_PREV_PC_VALUE_NOT_YET_REPORTED is generated. The
pulse counter value may be saved and sent later.
Data type: Vector
Value: A vector of three elements, given as:
(time, status, value)
where
‘time’ Is a time stamp given in the format returned by the
SCIL function RTU_ATIME
‘status’ Is the status byte reported in RP-570 telegrams. The
status bits have the following meanings:
Bin number Meaning
B0 Spare (not used)
B1 EPR, 1 = end of period reading
B2 IR, 1 = intermediate reading
B3 LS, 1 = Local storage implemented
B4 IT, 1 = Invalid Time
B5 CT, 1 = Changed Time
310
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
311
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
CT CBXC Timeout
Time limit in minutes between CBXC and EXC telegrams. If this time limit is
exceeded, the command selection is aborted.
Data type: Integer
Value: Integer
Unit: Minutes
Indexing: None
Default value: 1 minute
Access: No restrictions
312
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
DC Diagnostic Counters
Keeping count of various situations that can occur in the STA device. Each counter
is associated with a descriptive name, but when it is accessed from SCIL the
corresponding counter number (integer constant) must be used. The following
counters are updated:
1. ERMI_BUFFER_OVERFLOW
2. SCI_RECEIVED
3. CBXC_TIMEOUT
4. EXC_FAILED
5. IHC_FAILED
6. IHC_RECEIVED
7. SCS_REPLY_TIMEOUT
8. STATUS_NOT_OK_FROM_NET
9. TEV_BUFFER_OVERFLOW
10.TR_BUFFER_OVERFLOW
11.BLOCKED_COMMANDS
12.EXCLUSIVE_COMMAND_TIMEOUT
Data type: Integer
Value: Integer
Indexing: Counter number. One index or an index range.
Access: Read-only, the values can be reset
DI Database Initialized
Indicating whether or not the database in NET unit has been initialized and can be
polled from the master station. At NET unit start-up, the DI attribute has the value
0. When all values in the NET database have been initialized (either given a value
or a faulty status), this attribute must be set to 1. NET unit does not answer to polls
from the master station until DI = 1.
Data type: Integer
Value: 0 or 1
Indexing: None
Access: No restrictions
313
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
Indexing: None
Default: 0
Access: No restrictions
TI Time Initialized
When all relevant parts of the SYS 600 system have received time synchronization
as a result of a TSI telegram (Time Sync Instruction) from the master station, NET
unit should be notified by setting this attribute to 1. As long as TI is 0 (default), the
bit with the information "RTU is synchronized" is 0 in all applicable RP-570
messages.
Data type: Integer
Value: 0 or 1
Indexing: None
Access: No restrictions
314
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
ST Terminal Status
Corresponds to terminal status messages (TSTA) generated by the RP-570 interface.
Each time the ST attribute is set, a new terminal status message is sent to the master
station (if new status <> old status).
The attribute is used indexed. Index 1 of the ST attribute corresponds to TSTA, ID=1
messages, and index 2 to TSTA ID=2. Each index is assigned a vector value where
the first element indicates the number of the bit to be operated (set or cleared). The
second element determines the operation (set or clear) to be performed on the bit.
The lists below shows the status information that the master station associates with
the different bits.
ST attribute, index 1, (TSTA ID=1):
Bit number Meaning if the bit is set (=1)
0 At least one indication faulty
1 At least one analog input faulty
2 At least one digital measured value faulty
3 At least one pulse counter faulty
4 At least one object or reg. command output is faulty
5 At least one setpoint faulty
6 At least one general output. Faulty
7 RTU is faulty
8 RTU is active
9 RTU is synchronized
10 * spare *
11 Local printer is off-line
12 Command outputs are blocked due to config. Error
13 * spare *
14 * spare *
15 Local printer is out of service
ST attribute, index 2, (TSTA ID=2):
Bit number Meaning if the bit is set (=1)
0 * spare *
1 Plain texts are loaded
2 Backup medium for plain texts faulty
2-15 * spare *
Data type: Vector
Value: Write: Each index is a vector of two integers, where
Element 1 = Bit number to set or clear, 0 ... 15
Element 2 = Operation, 1 = on, 0 = off
Read: Each index is a 16 bit word
315
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
LC Loop Control
Activating and de-activating the loop control. Set the IU attribute of both the line and
the STA object to 0 before changing this attribute.
Data type: Integer
Value: 0 No loop control
1 Loop control activated
Indexing: None
Access: Read, conditional write
LT Loop Timeout
The maximum time for NET unit to wait for reply from the master station before
sending the system message to the base system. Loop switching is done if no RA or
RB polls are received within LT number of seconds.
316
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
When the DI attribute is set to 1, that is, NET unit starts to wait for messages from
the master station, it waits LT number of seconds. If no valid RP-570 message is
received within this period, the system message
SPIP_COMMUNICATION_WITH_CS_LOST is sent to the SYS 600 base system.
If loop control is used, the loop direction is toggled.
After each valid RP-570 message, NET unit waits LT + 30 second before
SPIP_COMMUNICATION_WITH_CS_LOST is sent.
When communication has been down, and a valid RP-570 message is received, the
system message SPIP_COMMUNICATION_WITH_CS_ESTABLISHED is sent
to the SYS 600 base system.
Data type: Integer
Value: Integer
Unit: Seconds
Indexing: None
Default value: 20 seconds
Access: No restrictions
LI Line Number
The number of the back-up line is set to index 2 of the LI attribute. More about LI
attribute can be found in 16.2.2..
Example:
#SET STA1:SLI(2) = 5
317
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
With setting RM bit 0 = 0, all command messages (CBXC, EXC, IXC and IHC) are
always responded by PC_NET with CBR/EXR, meaning OK. This is the default
behavior and if it is used the information of this chapter is not needed.
With setting RM bit 0 = 1, PC_NET is configured to use the enhanced mode and it
waits until the SCIL application has written to the CS attribute. No automatic
responses are sent in this mode.
When a control command is received by the SPI station object, it updates a process
object with the same address as the object number in the incoming command
message. The updated process object is of type ANSI/Digital Input.
With setting RM bit 0 = 1, the incoming command updates the attribute RA of the
mentioned process object as follows:
1 check back before execute (= select)
2 execute
3 cancel
4 immediate execute
With setting RM bit 0 = 0, RA is updated with value 0 and the application need not
write to the CS attribute. When a control command is received, the operation of the
COM500i signal routing procedure COM_DSBO is based on the value of the RA
attribute of the updated process object.
The actual communication will be as in the following table:
The application should write to the CS attribute within the time specified by the SPI
station attribute AT.
318
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
CS Command Confirmation
Manual confirmation of the received messages. In RP570, the commands received
by the slave station are confirmed by using specific response messages and the
response message is selected using the status value given as the first parameter.
This attribute should be used only when the bit 0 of attribute RM is 1.
Data type: Integer
Value: 0 Previous command should be responded with
status "OK".
non-zero Previous command should be responded with
status "not OK".
Access: Write only
RM Running Mode
Consists of a set of flags that control the behavior and functionality of the SPI
station. Each flag is represented by one bit of this attribute.
Data type: Integer
Value: 0 ... 65535, consisting of bits as follows:
Bit 0 Application controlled commands
0 The slave device always responds to
incoming commands with OK status and
the CS attribute is meaningless. This is the
default behavior.
1 The slave device expects that the response
status is returned by the application using
the attribute CS. The timeout for writing
CS is defined by the attribute AT.
Default value: 0
Access: Read, conditional write
319
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
320
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
17.1. General
Definition
Each printer connected to the process communication system must be defined as a
PRI object in the NET unit to which it is directly connected. PRI objects are defined
with the NET object attribute PR (Chapter 14), either in the preconfiguration or with
SCIL. Defining a PRI object requires that the line has been defined as a printer line
(Chapter 15). The printers must also be defined as PRI base system objects in the
base systems that will use the printers.
When the PRI objects are defined with SCIL (with the PR attribute), the PRI
attributes get the default values given in the attribute descriptions. When the objects
are defined in the preconfiguration, only the attributes that cannot be preconfigured
get the default values. The other attributes get the values given in the
preconfiguration.
Object notation
From SCIL, the PRI attributes are accessed with the notation:
PRIn:Sat
where
'n' The logical printer number, 0 ... 20, as known to the application
according to the printer mapping (see the mapping attributes in Chapter
6). The number is translated in the base system (through the application
mapping and the corresponding PRIn:B object) to system object
number, 1 ... 8.
'at' An attribute name
IU In Use
Specifies whether the printer connection is in use or not. The attribute determines
the state of use as known to the communication unit. It does not affect the printer
itself, only its image in the communication unit.
321
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
If the printer is off-line or its IU = 0 when a printout message is sent to the printer,
the message is saved in the spool queue of the base system. The message is stored
until IU is set to 1.
The printer sends no system messages as long as it is out of use, only at the moment
when it is taken out of use.
Data type: Integer
Values: 0 Not in use
1 In use
Default value: 0
Access: No restrictions
LI Line Number
The number of the NET line to which the printer is connected. The line is determined
when the printer is created - in the preconfiguration or with the NETn:SPR attribute.
Data type: Integer
Value: 1 ... 8, 13
Access: Read-only
PT Printer Type
The type of the printer as defined to NET unit. There are six types of printers which
product different type or printout:
• Character based black-and-white printout (ASCII). The base system sends CR
and LF characters within the print messages.
• "Transparent printout". Printers defined as “transparent” can print the printout
commanded by the SCIL function PRINT_TRANSPARENT.
• Pixel based, black and white printout. All EPSON FX compatible printers can be
used for this type of printout.
• Character based "black and white" printout (ASCII). The base system does not
send CR and LF characters, but it sends colour information, which is not printed.
Graphical characters can be replaced by printer characters using the CT attribute
(section 17.2.6.).
• Character based colour printout. This type is used on FACIT 4544 printers. The
characters CR and LF are generated by the communication unit.
• Pixel based colour printout. All EPSON JX compatible printers can be used for
this type of printout.
322
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
The corresponding PRI base system objects must be defined as the same printer type
in the base systems.
Data type: Integer
Value: 1, 2, 3, 5, 6, 7:
1 Character based black-and-white printer (ASCII)
2 "Transparent printer". Printer for the full-graphic printout.
3 Pixel based, black and white printer. All EPSON FX
compatible printers can be used
5 Character based "black and white" printer (ASCII)
6 Character based colour printer of type FACIT 4544
7 Pixel based colour printer. All EPSON JX compatible
printers can be used.
Access: Read, conditional write
NET uses the control sequence <esc> ? K for setting printers of type
3 and 7 in graphical mode. This sequence is not supported by all
EPSON FX-80 and EPSON JX-80 printers.
AL Allocation
Specifies whether the printer is allocated to a certain application or not.
Reservation of a printer is needed to prevent mixing of printer outputs from different
program processes (in the same or in separate base systems). Therefore, the main
program always reserves a printer before sending print messages (if all the data to
be printed does not fit into one message). After sending the print messages, the main
program releases the printer (AL = 0) automatically.
Normally, there is no need to write the AL attribute from application programs.
Manual printer reservation with SCIL is needed only when using DA and CD
attributes (see section 17.2.5).
If the printer has been reserved by setting the AL attribute or it is reserved for some
other reason, it must be released by a program in the same application as reserved
the printer. When releasing a printer, the printer must first be taken out of use with
the IU attribute (see below) before the AL attribute can be reset.
Data type: Integer
Values: 0 Free, not allocated
1 Reserved, allocated
A reservation (AL = 1) means that the printer is logically
connected to one application, and that other applications have no
or limited access to it.
Default value: 0
Suggested value: 0
Access: Read, conditional write
323
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
AS Allocating Application
The number of the application that reserved the printer. NET unit automatically
updates the AS attribute by the number of the writing application when the AL
attribute is set to 1 on-line. When the AL attribute is set to 0 on-line, the AS attribute
is set to 0 as well.
Data type: Integer
Value: 0 ... 250. The application number as known to the
communication unit. 0 = No allocating application.
Default value: 0
Access: Read-only
MI Message Identification
The process object address (the OA attribute of the process object) to which the
system messages from the device are sent.
Data type: Integer
Value: 1 ... 16380, receiving object address
Default value: 3000 + printer number
This default value can be used as such (copied to the process
object address), or it can be changed.
Example: See the MI attribute in Chapter 13
324
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
MS Message Application
Specifies the application that will receive the system messages caused by the PRI
object. Its value is the system object number of the application as known to NET
unit.
Data type: Integer
Value: 1 ... 250. The APL object number as known to the NET unit
(defined by the NETn:SSY attribute).
Access: No restrictions
OS Object Status
When written the attribute causes a re-transmission of the latest system message
(write value 1), or cancels a possible OFF_LINE state (write value 0). When read,
the attribute returns the current printer status.
If the printer does not send XON after it has been turned on, NET unit will regard it
as off-line. Writing to the OS attribute cancels the off state, provided that the printer
is on.
After an application has been started, the process object that receives the system
messages caused by the printer (the MI attribute) has no value (OS = 10, not
sampled). An updating of the process object is achieved by writing to this attribute,
for example in the command procedure started by APL_INIT_1.
Data type: Integer
Value: Read:
Printer status
(for example 0 = ON_LINE, 13103 = OFF_LINE, 13120 =
OFF_LINE_AND_NO_CONNECTION)
Write:
1 Re-transmission of latest system message
0 If printer is off, writing value 0 does nothing. If printer is
on, writing value 0 cancels the OFF_LINE (XOFF) state.
This causes a system message with the status code 13126
PRIC_PRINTER_OFF_LINE_STATE_CANCELLED.
Example:
The latest system message is retranslated and updated in the process object defined
by the MI attribute of the PRI object:
#SET PRI3:SOS = 1
DC Diagnostic Counter
Contains a diagnostic counter value that counts the occurrences of certain events
related to the PRI objects. The counter is updated by the NET unit.
325
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
CD Control Data
An application program transmitting control sequences to the printer as character
strings. Any 8-bit character value can be used. For example, CD can be used to
choose a new font, initiate form feeds, choose a national character set or change
horizontal or vertical spacing. Unlike the DA attribute (described later), CD makes
it possible to send "non-printable" characters to the printer. Control sequences may
be sent to the printer, for example when the base system is started up, or from the
start programs of format pictures.
Data type: Text
Value: Maximum 228 characters. Any bit combinations are allowed in
the characters.
Access: Write-only
326
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
DA Data
Transmitting data to the printer without using a format picture (for example for test
purposes). (NET unit uses the DA attribute also for other purposes). By writing a
character string to the DA attribute, the application program can transmit the string
to the printer. In more extensive use of the DA attribute, the application programmer
must provide for the printer allocation using the AL attribute described earlier. To
type short printouts that go into one message, the AL attribute need not be set.
Data type: Text
Value: Text
Access: Write-only
Example:
Transmitting a line with the text HI PRINTER to printer 1:
#SET PRI1:SDA = "HI PRINTER" + ASCII(13) + ASCII(10)
PE Print Enable
In some special application cases there is need to stop a printer temporarily. The
stopping is done so that the messages meant for the printer are not stored in the spool
queue of the base system (what is the case if IU is set to 0). This is possible by setting
the PE attribute to 0.
Data type: Integer
Value: 0 NET unit destroys the printer messages when they arrive.
1 NET unit transmits the printer messages to the printer
when they arrive (normal operation state).
Default value: 1
Access: Read, conditional write
CC Color Conversion
Enables an automatic color conversion for color pixel based printers (PT = 7). The
attribute contains a programmable color transformation table that translates the
video monitor colors to printer colors.
Data type: Vector
Value: Vector of 64 integer elements. Each element is calculated
according to the formula:
16 * (BG printer color) + (FG printer color)
Indexing: 0 ... 63 calculated according to the formula:
8 * (BG video color) + (FG video color)
BG = background and FG = foreground
The video colors (background and foreground) are numbered as
follows:
0 Black
327
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
1 Magenta
2 Blue
3 Cyan
4 Red
5 Amber
6 Violet
7 White
The printer colors are numbered as follows:
0 Black
1 Magenta
2 Cyan
3 Violet
4 Yellow
5 Orange
6 Green
7 White
Access: No restrictions
PX Pixel Characters
The attribute applies to pixel printers (PT = 3 or 7).
328
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
The printed bit pattern for each character code can be decided by the application.
There is only one pixel printer character set in each communication unit. Therefore,
all printers connected to the same NET unit use the same character set and a change
in the set will appear in all printers.
Data type: Vector
Value: Vector of 8 elements. Bit patterns for each column of the
character
Indexing: 0 ... 255. ASCII character code (the code received from a the
application)
Access: No restrictions
Example:
Exchange of the Swedish Å to the German Ü for character code 93 (dec):
#SET PRI1:SPX93 = (0,30,65,1,1,65,30,0)
329
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
330
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
18. Index
Numerics
844_COMPATIBLE_MIRRORING ........................................................ 75
A
AA
APL-APL Server Count (APL) .......................................................... 58
Audio Alarm Address (SYS) .............................................................. 36
ABB Alpha ............................................................................................. 188
AC
ACE (NET line) ................................................................................ 216
Alarm Count (APL) ............................................................................ 69
Access Type (ANSI) ............................................................................... 250
ACE (NET line) ...................................................................................... 216
ACE AT S Register (NET line) .............................................................. 220
ACE State (NET line) ............................................................................. 217
Acknowledge Timeout of Transparent SPA Messages (NET line) ........ 209
ACP .......................................................................................... 22, 154, 187
ACTION_WHEN_SET (Post-processing Policy for Object Status 2) ..... 66
Active station .......................................................................................... 116
Active Station (STA(B)) ......................................................................... 118
AD
Application Self-Diagnostics (APL) .................................................. 81
Audio Alarm Device (SYS) ................................................................ 36
Start Address (ANSI) ....................................................................... 250
Station Address Table (NET) ........................................................... 161
ADLP180 Master .................................................................................... 188
ADLP180 Slave ...................................................................................... 188
ADVANTECH PCI-1760 ......................................................................... 36
AE Analog Events (STA(B)) .................................................................. 113
AL ........................................................................................................... 236
Allocation (P214) ............................................................................. 281
Allocation (PRI(S)) .......................................................................... 323
Allocation (STA(S)) ......................................................................... 236
Alarm Count (APL) .................................................................................. 69
Alarm Picture Queue Handling (APL) ..................................................... 64
Alarm Tag (APL) ..................................................................................... 69
ALIAS (PRI Translation Type) .............................................................. 128
Allocating Application
P214 .................................................................................................. 281
PRI(S) ............................................................................................... 324
STA(S) .............................................................................................. 237
Allocation ............................................................................................... 236
P214 .................................................................................................. 281
PRI(S) ............................................................................................... 323
STA(S) .............................................................................................. 236
331
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
ALLOW_CONFLICTING_F_ATTRIBUTE_NAMES .......................... 76
ALWAYS (File Sync Criterion) .............................................................. 30
ALWAYS (Post-processing Policy for Object Status 2) ......................... 66
AN
Application Monitor Number (MON) ................................................ 84
Application Number (APL) ................................................................ 44
Analog Events (STA(B)) ........................................................................ 113
Analog Value (SPI) ................................................................................ 303
Analyzer Output (NET line) ................................................................... 197
Analyzer Usage (NET line) .................................................................... 198
ANSI Stations ......................................................................................... 241
ANSI X3.28 ............................................................................................ 249
ANSI X3.28 Full Duplex ....................................................................... 187
ANSI X3.28 Half Duplex ....................................................................... 187
ANSI X3.28 protocol ..................................................................... 164, 169
Ansi X3.28 Station address .................................................................... 155
AO Analyzer Output (NET line) ............................................................ 197
AP
Application Mapping (APL) .............................................................. 49
Application Number (MON) .............................................................. 85
Application Number (STA(B)) ........................................................ 108
APL .............................................................................. 15, 16, 43, 146, 148
APL objects .............................................................................................. 43
APL_EVENT ........................................................................................... 77
APL_INIT_1 .......................................................................................... 150
APL_INIT_2 .......................................................................................... 150
APL_INIT_H ......................................................................................... 150
APL-APL diagnostics .............................................................................. 77
APL-APL Server Count (APL) ................................................................ 58
APL-APL Server Queue Used (APL) ...................................................... 59
Application ................................................................................. 13, 43, 146
Application (NET) .................................................................................. 163
Application Diagnostic Interval (APL) .................................................... 77
Application Diagnostic Status (APL) ....................................................... 78
Application Diagnostic Timeout (APL) ................................................... 78
Application diagnostics ............................................................................ 77
Application Mapping (APL) .................................................................... 49
Application Monitor Number (APL) ........................................................ 84
Application Number
APL .................................................................................................... 44
MON .................................................................................................. 85
STA(B) ............................................................................................. 108
Application Reply Wait Time (NET) ..................................................... 174
Application Self-Diagnostics (APL) ........................................................ 81
Application State (APL) ........................................................................... 44
Application Status Timeout (SPI) .......................................................... 318
Application Suspension Time (NET) ..................................................... 173
332
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
333
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
334
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
335
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
336
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
337
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
MON .................................................................................................. 85
PRI(B) .............................................................................................. 126
Device image .......................................................................................... 145
Device mapping ........................................................................................ 50
Device names ......................................................................................... 190
Device number ....................................................................................... 146
Device Reservation ................................................................................ 236
Device Type
IND ..................................................................................................... 90
MON .................................................................................................. 84
PRI(B) .............................................................................................. 126
DF Diagnostic Event from First Found (NOD) ..................................... 102
DI
Application Diagnostic Interval (APL) .............................................. 77
Database Initialized (SPI) ................................................................. 313
Diagnostic Interval (ANSI) .............................................................. 247
Diagnostic Interval (LMK) ............................................................... 298
Diagnostic Interval (MON) ................................................................ 87
Diagnostic Interval (NET) ................................................................ 175
Diagnostic Interval (NOD) ............................................................... 102
Diagnostic Counter
NET .................................................................................................. 175
PRI(S) ............................................................................................... 325
Diagnostic Counters
ANSI ................................................................................................ 245
APL .................................................................................................... 54
LIN ..................................................................................................... 96
LMK ................................................................................................. 298
NET line ........................................................................................... 227
P214 .................................................................................................. 281
RTU .................................................................................................. 260
SPA .................................................................................................. 271
SPI .................................................................................................... 313
Diagnostic Counters for APL connections (NET) ................................. 172
Diagnostic Event from First Found (NOD) ............................................ 102
Diagnostic Interval
ANSI ................................................................................................ 247
LMK ................................................................................................. 298
MON .................................................................................................. 87
NET .................................................................................................. 175
NOD ................................................................................................. 102
Diagnostic Status
ANSI ................................................................................................ 248
NET .................................................................................................. 172
Diagnostic Timeout (NOD) .................................................................... 103
Diagnostics Enable (ANSI) .................................................................... 246
Direction
338
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
339
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
340
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
341
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
342
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
343
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
344
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
345
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
346
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
MO
Monitor Mapping (APL) .................................................................... 51
Monitor Number (IND) ...................................................................... 91
MODBUS ............................................................................................... 188
Modem Command (NET line) ................................................................ 218
Modem Delay (NET line) ....................................................................... 223
Modem Signal (NET line) ...................................................................... 207
MON ............................................................................................. 15, 17, 83
MON_EVENT .......................................................................................... 85
Monitor Alarm Signal Size (APL) ........................................................... 69
Monitor Mapping (APL) .......................................................................... 51
Monitor Number (IND) ............................................................................ 91
Monitor Stop (MON) ................................................................................ 88
Monitors ................................................................................................... 83
MONTH (Log Length) ........................................................................... 133
MP Memory Pool Sizes (SYS) ................................................................. 31
MR
Memory Rung (ANSI ) ..................................................................... 253
Mirroring Role (STA(B)) ................................................................. 115
MS
Memory Block Size (SYS) ................................................................. 31
Message Application (NET line) ...................................................... 196
Message Application (NET) ............................................................. 160
Message Application (P214) ............................................................ 283
Message Application (PRI(S)) ......................................................... 325
Message Application (STA(S)) ........................................................ 239
Monitor Alarm Signal Size (APL) ..................................................... 69
Monitor Stop (MON) .......................................................................... 88
MT Maximum Scan Time (NET line) .................................................... 224
MU
Mail Update Identification (NET) .................................................... 180
Memory Blocks Used (SYS) .............................................................. 31
MW (IND Device Type) .......................................................................... 90
MW (MON Device Type) ........................................................................ 84
MW (Node Type) ................................................................................... 100
N
NA
NAK Limit (LIN) ............................................................................... 95
NAK Limit (NET line) ..................................................................... 205
Name (APL) ....................................................................................... 45
Number of NAKs (ANSI) ................................................................ 249
Type Name (STY) ............................................................................ 123
NAK ....................................................................................................... 205
NAK Limit
LIN ..................................................................................................... 95
NET line ........................................................................................... 205
347
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
348
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
349
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
350
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
PF
Post-processing Policy for Object Status 1 (APL ) ............................ 66
Post-processing Policy for Object Status 1 (STA(B)) ...................... 109
PH
Global Paths (SYS) ............................................................................. 33
Paths (APL) ........................................................................................ 46
Phone Number (ANSI) ..................................................................... 241
Phone Number (ANSI) ........................................................................... 241
Physical application number ..................................................................... 49
Physical device number ............................................................................ 50
Picture Cache Size (SYS) ......................................................................... 32
Picture Cache Used (SYS) ........................................................................ 32
Picture Containers (MON) ....................................................................... 88
Pixel Characters (PRI(S)) ....................................................................... 328
PL Polling Limit (NET line) ................................................................... 213
PM
Printer Spooler Queue Length Maximum (APL) ............................... 60
Priority Mask (P214) ........................................................................ 286
Protocol Mode (NET line) ................................................................ 193
PN
Page Number (PRI(B)) ..................................................................... 131
Peer Node Number (NET) ................................................................ 176
PO Protocol (NET line) .......................................................................... 187
Poll Delay (NET line) ............................................................................. 212
Polling ..................................................................................................... 211
Polling Address ...................................................................................... 242
Polling Delay .......................................................................................... 212
Polling Limit (NET line) ........................................................................ 213
Polling Period (NET line) ....................................................................... 213
Polling Ratio (NET line) ........................................................................ 215
Post-processing Policy for Object Status 1
APL ..................................................................................................... 66
STA(B) ............................................................................................. 109
Post-processing Policy for Object Status 2
(STA(B)) ........................................................................................... 109
APL ..................................................................................................... 66
PP
Polling Period (NET line) ................................................................. 213
Post-processing Policy for Object Status 2 (APL) ............................. 66
Post-processing Policy for Object Status 2 (STA(B)) ...................... 109
PQ Parallel Queues (APL) ........................................................................ 60
PR
Parameter Reservation (SPA) ........................................................... 276
Prefer Primary (APL(B)) .................................................................. 118
Printer (NET) .................................................................................... 171
Printer Mapping (APL) ....................................................................... 52
Product Name (SYS) .......................................................................... 24
351
Preconfiguration ..................................................................................... 149
Prefer Primary (APL(B)) ........................................................................ 118
PRI ...................................................... 15, 17, 125, 146, 148, 164, 171, 321
PRIMARY (Redundancy Role) ............................................................. 119
Primary Application (SYS) ...................................................................... 36
Primary station ....................................................................................... 116
Primary Station (STA(B)) ...................................................................... 119
Print Enable (PRI(S)) ............................................................................. 327
PRINT_TRANSPARENT ...................................................................... 129
Printer ............................................................. 125, 128, 146, 148, 171, 321
Printer (NET) .......................................................................................... 171
PRINTER (Output Destination) ............................................................. 133
Printer control ......................................................................................... 326
Printer Control (PRI(B)) ........................................................................ 134
Printer Log ............................................................................................. 131
Printer Mapping (APL) ............................................................................ 52
Printer Queue .......................................................................................... 131
Printer Spool Stop (APL) ......................................................................... 70
Printer Spooler Queue Length Maximum (APL) ..................................... 60
Printer Spooler Queue Length Used (APL) ............................................. 60
Printer State (PRI(B)) ............................................................................. 135
Printer status ........................................................................................... 325
Printer Type (PRI(S)) ............................................................................. 322
Priority Buffer Pool (NET line) ............................................................. 195
Priority Control Counter (P214) ............................................................. 286
Priority Mask (P214) .............................................................................. 286
Process communication .......................................................................... 145
Process Data (RTU) ............................................................................... 262
Process Query Length (APL) ................................................................... 62
Procontrol P214 (NET) .......................................................................... 166
PROD_QUERY ....................................................................................... 62
Product Name (SYS) ................................................................................ 24
Program Revision (SYS) .......................................................................... 25
Program Version (NET) ......................................................................... 156
Protocol .......................................................................................... 156, 187
Protocol (NET line) ................................................................................ 187
Protocol Mode (NET line) ...................................................................... 193
PROXY (Redundancy Role) .................................................................. 119
Proxy station ........................................................................................... 116
Proxy Station (STA(B)) ......................................................................... 119
PS
Buffer Pool Size (NET line) ............................................................. 194
Primary Station (STA(B)) ................................................................ 119
Printer Spool Stop (APL) ................................................................... 70
PT
Polling Ratio (NET line) .................................................................. 215
Printer Type (PRI(S)) ....................................................................... 322
PU
Printer Spooler Queue Length Used (APL) ....................................... 60
Pulse Dialing (NET line) .................................................................. 219
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
353
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
354
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
355
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
356
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
357
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
358
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
359
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
360
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
361
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
362
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
APL ..................................................................................................... 45
IND ..................................................................................................... 91
MON ................................................................................................... 84
PRI(B) ............................................................................................... 127
STA(B) ............................................................................................. 113
Transmission rate .................................................................................... 198
Transmission Wait Delay (NET line) ..................................................... 209
Transmit Bytes (NET line) ..................................................................... 210
Transmit Quota (REX) ........................................................................... 290
Transmitter Data Bit Count (NET line) .................................................. 201
TRANSPARENT (PRI Device Type) .................................................... 127
Transparent data ..................................................................................... 263
Transparent Data (RTU) ......................................................................... 266
Transparent Data Address (SPI) ............................................................. 311
Transparent Data Response (SPI) ........................................................... 312
Transport (LIN) ........................................................................................ 94
TS
Terminal Status (RTU) ..................................................................... 267
Time Season (SYS) ............................................................................ 29
Time Stamp (ANSI) ......................................................................... 255
TT
Translation Type (APL) ..................................................................... 45
Translation Type (IND) ...................................................................... 91
Translation Type (MON) .................................................................... 84
Translation Type (PRI(B)) ............................................................... 127
Translation Type (STA(B)) .............................................................. 113
TV
Terminal Event Message (SPI) ......................................................... 316
Type Value (P214) ........................................................................... 285
TW
Acknowledge Timeout of Transparent SPA Messages (NET line) .. 209
Transmission Wait Delay (NET line) ............................................... 209
Type .......................................................................................................... 14
Type Name (STY) .................................................................................. 123
Type Value (P214) ................................................................................. 285
TZ
Time Zone (SYS) ............................................................................... 29
Time Zone Correction (NET) ........................................................... 181
U
UC Unacknowledged Alarm Count (APL) .............................................. 70
UN
Unit Number (SPA) .......................................................................... 270
Unit Number (STA(B)) .................................................................... 113
Unacknowledged Alarm Count (APL) ..................................................... 70
Unit Number
SPA ................................................................................................... 270
363
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
364
1MRS756662 MicroSCADA Pro SYS 600 9.3
System Objects
Technical Description
365
SYS 600 9.3 MicroSCADA Pro 1MRS756662
System Objects
Technical Description
366
Contact us
www.abb.com/substationautomation
1MRS756662 B/31.12.2010