Item Names
71
MBTCP DAServer User’s Guide
C H A P T E R   3
Item Names
The Wonderware MBTCP DAServer supports a variety of data types for the 
Modicon controllers. It also supports item names that follow the conventions 
described for the following Modicon PLCs:
• 
TSX Quantum (6-Digit)
• 
TSX Momentum (6-Digit)
• 
TSX Premium (6-Digit)
• 
Generic Modbus (4-Digit, 5-Digit, 6-Digit)
• 
Compact 984 (RS232, 5-digit and 6-Digit)
• 
Modicon Micro (RS232, 5-digit)
• 
TSX Momentum (RS232/RS485, 6-Digit)
• 
Generic Modbus (RS232/RS485, 4-Digit, 5-Digit, and 6-Digit)
Contents
• 
Data and Register Types
• 
Modbus Item Naming
• 
DAServer Standard System Items
• 
Generic OPC Syntax
Data and Register Types
When a client sends a read/write request to the MBTCP DAServer, the 
DAServer needs to know its data type and size. In order to determine this 
information, the MBTCP DAServer parses the item name to get the register 
number, data type, and size. The DAServer builds messages with items sorted 
by PLC, register type, register number, and topic name, allowing the DAServer 
to optimize the number of registers that can be read in one scan command.
The following table contains the types of data for the Modicon controllers, 
TSX Quantum, TSX Momentum, TSX Premium, Generic Modbus (4-Digit, 5-
Digit, and 6-Digit), Compact 984, and Modicon Micro, supported by the 
MBTCP DAServer.
Convert pdf to text doc - software control cloud:C# PDF Convert to Text SDK: Convert PDF to txt files in C#.net, ASP.NET MVC, WinForms, WPF application
C# PDF to Text (TXT) Converting Library to Convert PDF to Text
www.rasteredge.com
Convert pdf to text doc - software control cloud:VB.NET PDF Convert to Text SDK: Convert PDF to txt files in vb.net, ASP.NET MVC, WinForms, WPF application
VB.NET Guide and Sample Codes to Convert PDF to Text in .NET Project
www.rasteredge.com
72
Chapter 3
MBTCP DAServer User’s Guide
Note  The unsigned integer data type "U" has a valid range of 0 (zero) to 
2147483647 when accessed through DDE/SL client; for OPC clients the valid 
range is from 0 to 4294967295.
Note  System-defined types will not be supported as block reads. A read on 
any of these data types will return only the first element.
The following table lists the PLC register types, the data types contained in the 
registers, and what each is processed as.
Modbus Item Naming
The Modbus-family controllers store data in the Registers. The MBTCP 
DAServer supports item names that are consistent with the point naming 
conventions used by the Modicon PLCs.
The following item naming conventions are described in this section:
TSX Quantum/TSX Momentum/TSX 
Premium/Generic Modbus/Compact 
984/Modicon Micro Data Type
Range
Discrete (bit/Boolean)
0 (zero), 1 (one)
Signed Short Integer (signed 16-bit integer)
0 (zero) to 65535
Unsigned Short Integer (unsigned 16-bit 
integer)
-32768 to 32767
Signed Long Integer (signed 32-bit integer)
-2147483648 to 2147483647
Unsigned Long Integer (unsigned 32-bit 
integer)
0 (zero) to 4294967295
REAL (32-bit float)
32-bit IEEE
String (ASCII)
246 characters (Read)
200 characters (Write)
PLC Register Type
Data Type Contained in 
the Register
Processed As
Discrete Output (Coil)
Discrete
Real Time Data
Discrete Input
Discrete
Real Time Data
Holding Register
Discrete, Integer, Float, and 
String
Real Time Data
Input Register
Discrete, Integer, Float, and 
String
Real Time Data
Extended Register
Discrete, Integer, Float, and 
String
Real Time Data
software control cloud:C# PDF Text Extract Library: extract text content from PDF file in
Please have a quick test by using the following C# example code for text extraction from PDF page. // Open a document. PDFDocument doc = new PDFDocument
www.rasteredge.com
software control cloud:VB.NET Create PDF from Word Library to convert docx, doc to PDF in
Export all Word text and image content into high quality PDF without losing formatting. Create PDF files from both DOC and DOCX formats. Convert multiple pages
www.rasteredge.com
Item Names
73
MBTCP DAServer User’s Guide
• 
Register-Number Item Names
• 
Item Names Using the Modicon PLC Register Addresses
• 
Item Names Using the Absolute Naming Convention
• 
Item Names Using the Modulo-10000 Naming Convention
• 
Modulo-10000 Items, BCD Register Type, and Concept Data Structures
Note  The tag-name length with SuiteLink is limited to 32 characters.
Register-Number Item Names
The register number, which is consistent with the point naming convention 
used by Modicon PLCs, is used as the item name. The Modbus-family PLC 
address ranges, supported by the DAServer, for the TSX Quantum, TSX 
Momentum, TSX Premium, Generic Modbus (4-Digit, 5-Digit, and 6-Digit), 
Compact 984, and Modicon Micro PLCs are shown in the following tables. 
The MBTCP DAServer will adhere to this address range for native mode.
Register 
Type
TSX Quantum/ 
TSX 
Momentum
Modicon 
Micro
Compact  
984-265
Compact 
984-145
Tag 
Type
Access
Output Coils 1-65536
1-9999
1-65536
1-9999
Discrete Read/Write
Contacts
100001-165536
10001-19999 100001-165536 10001-19999 Discrete Read-Only
Input
300001-365536
30001-39999 300001-365536 30001-39999 Analog
Read-Only
Holding
400001-465536
40001-49999 400001-465536 40001-49999 Analog
Read/Write
Extended
6x0000-6x9999
6x000-6x999 Analog
Read/Write
Register 
Type
TSX Premium
Tag Type
Access
Output Coils 1-65536
Discrete
Read/Write. Mapped to %M PLC object; that is, Output 
Coils and Contacts Registers are the same.
Contacts
100001-165536
Discrete
Read-Only. Mapped to %M PLC object; that is, Output 
Coils and Contacts Registers are the same.
Input
300001-365536
Analog
Read-Only. Mapped to %MW PLC object; that is, Input 
Registers and Holding Registers are the same.
Holding
400001-465536
Analog
Read/Write. Mapped to %MW PLC object; that is, Input 
Registers and Holding Registers are the same.
Poking a value to a particular bit in the Holding register 
in this TSX Premium PLC is not supported.
software control cloud:C# PDF Convert to Jpeg SDK: Convert PDF to JPEG images in C#.net
String inputFilePath = Program.RootPath + "\\" 1.pdf"; PDFDocument doc = new PDFDocument(inputFilePath); //Convert all pdf pages to jpeg images.
www.rasteredge.com
software control cloud:VB.NET PDF Convert to Word SDK: Convert PDF to Word library in vb.
Convert PDF document to DOC and DOCX formats in Visual Basic .NET project. Professional .NET library supports batch conversion in VB.NET.
www.rasteredge.com
74
Chapter 3
MBTCP DAServer User’s Guide
Note  The x in the Extended register number indicates the file number, where 
x = 0 implies file number 1, x = 1 implies file number 2, up to x = 9 implies file 
number 10. The extended memory size in the PLC determines how many 
extended memory files exist. Each file contains up to 10000 registers. The last 
file in the PLC will always contain less than 10000 registers.
For example:
A 24K-extended-memory-size PLC contains three (3) files, where the last 
file contains 4576 registers.
A 72K-extended-memory-size PLC contains eight (8) files, where the last 
file contains 3728 registers.
A 96K-extended-memory-size PLC contains 10 files, where the last file 
contains 8304 registers.
1K is 1024 registers.
Item Names Using the Modicon PLC Register 
Addresses
The following table lists other item name formats that are consistent with the 
point naming convention with the MBTCP DAServer sufix.
Register 
Type
Generic Modbus 
(6-Digit)
Generic Modbus 
(5-Digit)
Generic Modbus 
(4-Digit)
Tag 
Type
Access
Output Coils 1-65536
1-9999
1-999
Discrete Read/Write
Contacts
100001-165536
10001-19999
1001-1999
Discrete Read-Only
Input
300001-365536
30001-39999
3001-3999
Analog
Read-Only
Holding
400001-465536
40001-49999
4001-4999
Analog
Read/Write
Extended
6x0000-6x9999
6x000-6x999
Analog
Read/Write
Item Name
Description
400001
When no spaces and no letters follow the register 
number, the register contents are treated as a 16-bit 
unsigned quantity.
400001 S
When a space and the letter "S" follow the register 
number, the register contents are treated as a 16-bit 
signed quantity.
400001 I
When a space and the letter "I" follow the register 
number, the register contents are treated as a 32-bit 
signed quantity. 
This takes up two consecutive registers.
software control cloud:C# PDF Convert to Word SDK: Convert PDF to Word library in C#.net
Quick to remove watermark and save PDF text, image, table, hyperlink and bookmark to Convert PDF to multiple MS Word formats such as .doc and .docx.
www.rasteredge.com
software control cloud:C# PDF insert text Library: insert text into PDF content in C#.net
Program.RootPath + "\\" 1.pdf"; PDFDocument doc inputFilePath); // get a text manager from textMgr = PDFTextHandler.ExportPDFTextManager(doc); // Set char
www.rasteredge.com
Item Names
75
MBTCP DAServer User’s Guide
Absolute Notation Item Names
The MBTCP DAServer also uses another naming convention called the 
Absolute Notation. This naming convention is independent of the PLC model 
numbers.
The Absolute naming convention allows access to the four Modbus data types, 
each with an address from 0 to 65535. The data types are indicated by the item 
name suffix characters.
400001 L
When a space and the letter "L" follow the register 
number, the register contents are treated as a 32-bit 
signed quantity. 
400001 F
When a space and the letter "F" follow the register 
number, the register contents are treated as a floating-
point quantity. 
This takes up two consecutive registers.
400001 U
When a space and the letter "U" follow the register 
number, the register contents are treated as a 32-bit 
unsigned quantity.
400001-400003 M
When a space and the letter "M" follow the register 
number or register number pair separated by a dash, the 
register contents are treated as ASCII data. 
Each register contains up to two (2) ASCII characters. 
This example represents six (6) ASCII characters.
300001:10
When a colon and a number from 1 (one) to 16 follow 
the register number, the register contents are treated as 
discrete data. 
This example represents bit 10 of the input register 
300001.
Item Name
Description
nnnnn DO
Discrete Output
Refers to the same data Modbus calls "coils." 
Valid range is 0 (zero) DO through 65535 DO.
nnnnn DI
Discrete Input
Refers to the same data called "contacts" by Modbus. 
Valid range is 0 (zero) DI through 65535 DI.
nnnnn IR
Input Register
Refers to the same data called "input register." 
Valid range is 0 (zero) IR through 65535 IR.
Item Name
Description
software control cloud:C# Create PDF from Word Library to convert docx, doc to PDF in C#.
NET control able to turn all Word text and image multiple pages Word to fillable and editable PDF documents in Convert both DOC and DOCX formats to PDF files.
www.rasteredge.com
software control cloud:VB.NET PDF replace text library: replace text in PDF content in vb
VB.NET demo code below will guide you how to replace text in specified PDF page. 'Open a document Dim doc As PDFDocument = New PDFDocument(inputFilePath) 'Set
www.rasteredge.com
76
Chapter 3
MBTCP DAServer User’s Guide
The IR and HR absolute notation can also be combined with the following 
conversions: L (long), F (floating), S (signed), or U (unsigned).
For example: 
• 
219 HRS  16-bit signed integer
• 
000 HRL
32-bit signed integer
• 
100 HRF
32-bit floating point
• 
000 HRU
32-bit unsigned integer
Modulo-10000 Point Item Names
The MBTCP DAServer uses the Modulo-10000 Points naming convention, 
where the item name is two registers separated by a dash, with no spaces and 
no letters following the registers.
Two or three consecutive registers may be interpreted as a single numeric 
quantity, and each of the component registers must be in the range of 0-9999.
• 
When grouping three consecutive registers for interpretation as a single 
numeric quantity, overflow becomes a possibility.
• 
The largest number that may be represented in the PLC with three 
consecutive Modulo-10000 registers is 999,999,999,999; however, the 
largest number that can be contained in an integer-type variable is 
2,147,483,647. The latter number is used by the DAServer to represent an 
overflow condition.
• 
Therefore, the maximum usable value represented in three Modulo-10000 
registers is 2,147,483,646 or (<21><4748><3646>). Any number larger 
than this will be clamped at 2,147,483,647.
nnnnn HR
Holding Register
Refers to the same data Modbus calls "holding register." 
Valid range is 0 (zero) HR through 65535 HR.
nnnnn PV
Process Variable
Refers to holding register, but treated as floating points 
and assumes two (2) registers per floating-point number. 
Valid range is 0 (zero) PV through 65535 PV.
Item Name
Description
400001-400002
Can represent numbers between 0 and 99,999,999.
Register 400001 = <9999> and Register 400002 = 
<9999>.
400005-400007
Can represent numbers between 0 and 2,147,483,646.
Register 400005 = <21>, Register 400006 = <4748>, and 
Register 400007 = <3646>.
Item Name
Description
software control cloud:C# PDF delete text Library: delete, remove text from PDF file in
String inputFilePath = Program.RootPath + "\\" 1.pdf"; PDFDocument doc = new PDFDocument(inputFilePath); // Get a text manager from the document object.
www.rasteredge.com
software control cloud:C# PDF replace text Library: replace text in PDF content in C#.net
The following demo code will show how to replace text in specified PDF page. // Open a document. PDFDocument doc = new PDFDocument(inputFilePath); // Set the
www.rasteredge.com
Item Names
77
MBTCP DAServer User’s Guide
Modulo-10000 Items, BCD Register Type, and 
Concept Data Structures
All the integer holding registers, 16- and 32-bit, signed and unsigned, and 
Modulo-10000 item types honor the configuration parameters Register type 
and Concept data structures.
When the Register type parameter is BCD and the Use Concept data structures 
(Longs) parameter is selected, the data is displayed in BCD and written to the 
PLC in the BCD format. In addition, data that takes up two registers (Longs), 
except Reals, is displayed and written in the Concept-data-structure format.
The same applies when the Register type parameter is Binary and the Use 
Concept data structures (Longs) parameter is selected; the data is displayed in 
Binary and written to the PLC in the Binary format. In addition, data that takes 
up two registers (Longs), except Reals, are displayed and written in the 
Concept-data-structure format.
When the Register type parameter is BCD and the Use Concept data structures 
(Longs) parameter is not selected, the data is displayed in BCD and written to 
the PLC in the BCD format. In addition, data that takes up two registers 
(Longs), except Reals, is displayed and written in the non-Concept-data-
structure format.
The same applies when the Register type parameter is Binary and the Use 
Concept data structures (Longs) parameter is not selected; the data is displayed 
in Binary and written to the PLC in the Binary format. In addition, data that 
takes up two registers (Longs), except Reals, is displayed and written in the 
non-Concept-data-structure format.
The Concept-data-structure format implies that data is displayed and written 
the same way that the Concept program from Schneider Automation handles 
data.
Concept-data-structure format is where the data is displayed and written in the 
last-register-to-first-register order.
For example:
When writing the value 2147483646 to the Modulo-10000 item 400001-
400003, the value 21 is written first to register 400003, then the value 4748 is 
written to register 400002, and then the value 3646 is written to register 
400001.
The non-Concept-data-structure format is the opposite of the Concept-data-
structure format.
The value 21 is written first to register 400001, then the value 4748 is written 
to register 400002, and then the value 3646 is written to register 400003.
Modulo-10000 items can be displayed and written in the BCD and Binary 
formats. When the Modulo-10000 item occupies two registers, the maximum 
value that can be displayed and written is 99999999. When the Modulo-10000 
item occupies three registers, the maximum value that can be displayed and 
written is 2147483646.
Warning messages are logged and the client value status is updated when data 
is clamped high when reading or writing data. Warning messages will also be 
displayed when the PLC data does not convert to BCD correctly.
78
Chapter 3
MBTCP DAServer User’s Guide
DAServer Standard System Items
System items provide you with easy access to the DAServer status and 
diagnostics information. They are treated just like ordinary items with respect 
to the client. However, in most cases these items are not directly acquired via 
the communications layer. System item values are usually generated through 
internal calculations, measurements, and the tracking of the DAS Engine.
System items, like ordinary items, are defined by the following properties:
• 
Group (client group/OPC group): The arbitrary collection of items, not 
correlated.
• 
Hierarchical location (link name/OPC path. The hierarchical node 
section of the fully qualified OPC Item ID.): The device the item is 
attached to.
• 
Device group (OPC access path/topic, or a Scan Group on a hierarchical 
branch.): A collection of items on the same physical location with the 
same protocol update rate.
Example:
To check the status of an external device, the reference might be:
AREA10.VESSEL1.TIC1.PLC.$SYS$Status
Note  This syntax does not refer to the access path/device group. As long as 
the data requested is from the same external device, the value will always be 
the same.
Note  For DDE/SuiteLink clients, $SYS$Status always comes from the leaf 
level of a DAServer hierarchy branch, which is the destination PLC node. For 
OPC clients, $SYS$Status can be accessed at all hierarchy levels. $SYS$Status 
at the root level of the whole hierarchy tree is always good, as it represents the 
quality status of the local computer itself. Hence, for practical application, 
OPC clients should reference $SYS$Status at any hierarchy levels other than 
the root.
All system items follow the same naming convention:
• 
All system items start with $SYS$. 
• 
System item name is not case-sensitive.
All system items can be accessed through subscriptions to a device group. 
However, while some system items return data for that device group, others are 
server-wide.
DAServer Global System Item
The following system item refers to specific information regarding a global 
condition of the DAServer.
Item Names
79
MBTCP DAServer User’s Guide
DAServer Device-Specific System Items
The following system items refer to specific information regarding the 
device(s) the DAServer is connected to.
System Item 
Name
Type/
Access 
Rights
Description
Values
$SYS$Licensed
Boolean/
Read
Binary status indication of the existence 
of a valid license for the DAServer. 
If FALSE, this item causes the DAServer 
to stop updating existing tags, to refuse 
activation of new tags, and to reject write 
requests in addition to setting quality for 
all items to BAD. If TRUE, the 
DAServer functions as configured. 
All instances have the same value.
RANGE: 0, 1
1: Valid license 
exists.
0: No valid license 
exists.
System Item Name 
(Type)
Type/
Access 
Rights
Description
Values
$SYS$Status
Boolean/
Read
Binary status indication of the 
connection state to the device (hierarchy 
level) the item is attached to. The device 
group (OPC access path/topic) does not 
affect the value.
The status can be good even if individual 
items have errors.
For DDE/SuiteLink clients, $SYS$Status 
always comes from the leaf level of a 
DAServer hierarchy branch, which is the 
destination PLC node. 
For OPC clients, $SYS$Status can be 
accessed at all hierarchy levels. 
$SYS$Status at the root level of the 
whole hierarchy tree is always good, as it 
represents the quality status of the local 
computer itself. Hence, for practical 
application, OPC clients should 
reference $SYS$Status at any hierarchy 
levels other than the root.
RANGE: 0, 1
1: DAServer 
connection to the 
device is intact.
0: Error 
communicating with 
the device.
80
Chapter 3
MBTCP DAServer User’s Guide
$SYS$ErrorCode
Longint/
Read
Detailed error code of the 
communications state to the device.
The device group (OPC access 
path/topic) does not affect the value.
>= 0: Good status (0 
is the default state – 
connected. 
>0: is some device 
state like: 
connecting, 
initializing, and so 
on.
<0: Error status 
(value indicates the 
error).
$SYS$ErrorText
String/
Read
Detailed error string of the 
communications state of the device.
The device group (OPC access 
path/topic) does not affect the value.
Descriptive text for 
the communications 
state corresponding 
to the error code.
$SYS$StoreSettings
Integer/
ReadWrite
Used to make the temporary update 
interval changes via the 
$SYS$UpdateInterval item permanent. If 
the client pokes a value of 1 into this 
system item, the currently set update 
interval is written to the server’s 
configuration file. 
The value of this system item clears to 0 
after being set, if the configuration file 
write is successful. If the write fails, then 
the value is set to -1.
If the update interval has been changed 
via the $SYS$UpdateInterval item and 
this item is not poked to 1, the DAServer 
uses the original update interval for that 
topic the next time it is started.
Reading the item always provides 0. 
Read/Write values are persisted only if 
the user sets this system item. The values 
other than this persist only for the life of 
the DAServer.
RANGE: -1, 0, 1
-1: Error occurred 
during saving the 
configuration file.
0: Read value 
always if status is 
OK.
1: Persist settings 
(cleared 
immediately).
System Item Name 
(Type)
Type/
Access 
Rights
Description
Values
Documents you may be interested
Documents you may be interested