Professional Documents
Culture Documents
Cite Cts Cada
Cite Cts Cada
Citect Pty. Limited 3 Fitzsimons Lane PO Box 174 Pymble NSW 2073 Australia Telephone: 61 2 9496 7300 Fax: 61 2 9496 7399
DISCLAIMER Citect Corporation makes no representations or warranties with respect to this manual and, to the maximum extent permitted by law, expressly limits its liability for breach of any warranty that may be implied to the replacement of this manual with another. Further, Citect Corporation reserves the right to revise this publication at any time without incurring an obligation to notify any person of the revision. COPYRIGHT Copyright 2004 Citect Corporation. All rights reserved. TRADEMARKS Citect Pty. Limited has made every effort to supply trademark information about company names, products and services mentioned in this manual. Trademarks shown below were derived from various sources. Citect, CitectHMI, and CitectSCADA are registered trademarks of Citect Corporation. IBM, IBM PC and IBM PC AT are registered trademarks of International Business Machines Corporation. MS-DOS, Windows, Windows 95, Windows NT, Windows 98, Windows 2000, Windows for Workgroups, LAN Manager, Microsoft Windows XP, Excel and MSMAIL are trademarks of Microsoft Corporation. DigiBoard, PC/Xi and Com/Xi are trademarks of DigiBoard. Novell, Netware and Netware Lite are registered trademarks of Novell Inc. dBASE is a trademark of Borland Inc. GENERAL NOTICE Some product names used in this manual are used for identification purposes only and may be trademarks of their respective companies. <insert month and year> edition for CitectSCADA Version 6.0 Manual Revision Version 6.0. Printed in Australia.
Contents
Introducing CitectSCADA
Using CitectSCADA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Configuring CitectSCADA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 The CitectSCADA Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 Configuration environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 Runtime system. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Chapter 1
Chapter 2
iv
Contents Using the Backup Utility from the Command Line . . . . . . . . . . . . . . . . . . . . . . . . . . 29 CtBackup and CtBackup32 utility command line options . . . . . . . . . . . . . . . 30 Copying Projects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 Copy Project dialog properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 Printing Project Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33 Print (project details) dialog properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34 Project Editor Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 Project Editor Options Dialog Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 Insert Tag dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 Insert Function dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 Find User Function dialog properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Chapter 3
Chapter 4
Contents Ellipse Properties - Appearance (General) . . . . . . . . . . . . . . . . . . . . . . . . . 103 Using Polygon Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106 Polygon Properties - Appearance (General) . . . . . . . . . . . . . . . . . . . . . . . . 107 Using Pipe Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109 Pipe Properties - Appearance (General) . . . . . . . . . . . . . . . . . . . . . . . . . . . 110 Using Text Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 Text Properties - Appearance (General) . . . . . . . . . . . . . . . . . . . . . . . . . . . 112 Text Properties - Appearance Display Value (On/Off). . . . . . . . . . . . . . . . . 113 Text Properties - Appearance Display Value (Multi-state). . . . . . . . . . . . . . 114 Text Properties - Appearance Display Value (Array). . . . . . . . . . . . . . . . . . 116 Text Properties - Appearance Display Value (Numeric) . . . . . . . . . . . . . . . 118 Text Properties - Appearance Display Value (String) . . . . . . . . . . . . . . . . . 119 Using Button Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120 Button Properties - Appearance (General) . . . . . . . . . . . . . . . . . . . . . . . . . 121 Using Symbol Set Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122 Symbol Set Properties - Appearance General (On/Off) . . . . . . . . . . . . . . . 123 Symbol Set Properties - Appearance General (Multi-state) . . . . . . . . . . . . 124 Symbol Set Properties - Appearance General (Array) . . . . . . . . . . . . . . . . 126 Symbol Set Properties - Appearance General (Animated) . . . . . . . . . . . . . 128 Using Trend Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129 Trend properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130 Insert Trend dialog box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132 Using Cicode Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132 Cicode Object Properties - Cicode (General) . . . . . . . . . . . . . . . . . . . . . . . 133 Using animation points . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134 Using Pasted Symbol Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134 Paste Symbol dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135 Symbol Properties - Appearance (General) . . . . . . . . . . . . . . . . . . . . . . . . 136 Using Pasted Genie Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136 Using ActiveX Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137 ActiveX Object Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137 Tag Association . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138 ActiveX Object Properties - Appearance (Tag Association) . . . . . . . . . . . . 138 Object Identification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141 Object Properties - Access (Identification) . . . . . . . . . . . . . . . . . . . . . . . . . 141
Chapter 5
vi
Contents Object Properties - Movement (Rotational) . . . . . . . . . . . . . . . . . . . . . . . . . 152 Group and object movement - examples. . . . . . . . . . . . . . . . . . . . . . . . . . . 154 Scaling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156 Object Properties - Scaling (Horizontal) . . . . . . . . . . . . . . . . . . . . . . . . . . . 157 Object Properties - Scaling (Vertical) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160 Fill Color . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163 Object Properties - Fill Color (On/Off) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164 Object Properties - Fill Color (Multi-state) . . . . . . . . . . . . . . . . . . . . . . . . . . 166 Object Properties - Fill Color (Array) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167 Object Properties - Fill Color (Threshold) . . . . . . . . . . . . . . . . . . . . . . . . . . 169 Object Properties - Fill Color (Gradient) . . . . . . . . . . . . . . . . . . . . . . . . . . . 171 Fill Level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173 Object Properties - Fill (Level) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174 Touch Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177 Object Properties - Input (Touch) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178 Keyboard Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180 Object Properties - Input (Keyboard Commands) . . . . . . . . . . . . . . . . . . . . 181 Sliders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183 Object Properties - Slider (Horizontal). . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184 Object Properties - Slider (Vertical) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185 Object Properties - Slider (Rotational). . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186 Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188 General Access to Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188 Object Properties - Access (General) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189 Disable Access to Objects. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191 Object Properties - Access (Disable). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
Chapter 6
Chapter 7
Contents Using custom alarm filters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204 Alarm Categories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207 Alarm Category Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208 Digital Alarms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212 Digital Alarm Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212 Multi-digital Alarms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215 Multi-digital Alarm Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216 Time-stamped Alarms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220 Time-stamped Alarm Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221 Analog Alarms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224 Analog Alarm Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224 Advanced Alarms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229 Advanced Alarm Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229 Time-stamped Digital Alarms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231 Time-stamped Digital Alarm Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . 231 Time-stamped Analog Alarms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234 Time-stamped Analog Alarm Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . 235 Formatting an Alarm Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239 Including CitectSCADA data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239 Including fixed text. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240 Displaying lists and tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240 Variable data in alarm messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240 Alarm display fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241 Alarm summary fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243 Changing the Order of the Alarm Summary Display . . . . . . . . . . . . . . . . . . 245 Using Alarm Properties as Tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245 Supported alarm properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245 Writing to alarm properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247 Setting up alarms. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248 Handling Alarms at Runtime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248 Using CitectSCADA Fonts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250 Fonts properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
vii
Chapter 8
Configuring Events
Events Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255 Running Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257 Specifying times and periods. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257 Using triggers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258
Chapter 9
Using Accumulators
Accumulator Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260
viii
Contents
Chapter 10
Chapter 11
Using Objects
Using groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280 Reshaping objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280 Using bitmaps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281 Importing graphics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281 Object Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281 Appearance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282 Movement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283 Scaling. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284 Fill . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285 Input. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286 Slider . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287 Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288 Manipulating Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289 Selecting objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290 Moving objects. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291 Resizing objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291 Deleting objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292 Locking/unlocking objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293 Grouping objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293 Copying and pasting objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294 Send to Back and Send Backwards . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294 Bring to Front and Bring Forwards . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295 Aligning objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296 Align dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296 Rotating objects. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297 Rotate dialog box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298
Contents Mirroring objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Mirror dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Locate an object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Goto Object dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298 298 298 299
ix
Chapter 12
Chapter 13
Contents Defining Page Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333 Page Properties - General. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334 Page Properties - Appearance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336 Page properties - Keyboard Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . 337 Page Properties - Events. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339 Page Properties - Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340 Setting Default Page Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341 Page defaults. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341 Understanding the Drawing Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342 Grids . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342 Grid Setup dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343 Guidelines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343 Guidelines Setup dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345 Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345 Options dialog box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346 Colors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348 Edit Favorite Colors dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349 Swap Color dialog box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352 Adjust colors dialog box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353 Zooming. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355 Using libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356 Using symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357 Bitmaps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358 Import dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360
Chapter 14
Reporting Information
Configuring reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363 Reports dialog box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364 Running Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366 Running a report on startup. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366 Specifying times and periods. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366 Using triggers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367 Using commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367 Report Format File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368 Report example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370 Handling Communication Errors in Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371 Reporting errors in I/O device data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371 Suppressing reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372
Chapter 15
Using Security
Maintaining user records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373 Adding user records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374 User properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374
Contents Defining User Privileges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376 Using hierarchical privilege . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378 Defining Areas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378 Using areas for security. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380 Using labels to name areas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380 Using groups of areas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 381 Groups properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382 Using areas with privileges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383 Specifying security requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383 Viewing areas of the plant . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 384
xi
Chapter 16
Using Labels
Using Arguments in Labels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Converting Values into Strings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Substituting Strings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Defining Labels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389 389 390 390
Chapter 17
Using Devices
Using groups of devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using devices to read data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Configuring Devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Devices Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Formatting Data in the Device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Printer and ASCII devices format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . dBASE and SQL database devices format . . . . . . . . . . . . . . . . . . . . . . . . . Using a database device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using Device History Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using Command Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . About Print Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395 396 396 397 400 401 402 403 406 409 409
Chapter 18
xii
Contents Setting up network DDE shares . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422 DDE Shares . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424 Using DDE Trusted Shares . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425 Using network DDE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 426 Connecting to a network DDE shared application . . . . . . . . . . . . . . . . . . . . 426 Using the Citect Tags Excel macros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 427 Using External Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429 dBASE databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429 SQL databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429 Using Structured Query Language . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430 Connecting to an SQL database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430 Executing SQL commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 431 Using a transaction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432 Expressing dates and times in SQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432 Using ODBC drivers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433 Installing the ODBC driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 434 About the ODBC driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435 Setting up ODBC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435 Getting the correct syntax with ODBC. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 436 Programming style with ODBC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 436 Comparing DDE with ODBC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437 ODBC compatibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 438 Using CitectSCADA as an ODBC server. . . . . . . . . . . . . . . . . . . . . . . . . . . 439 Reading data from an access table with ODBC . . . . . . . . . . . . . . . . . . . . . 441 Appending data with ODBC. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 442 Editing data with ODBC. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 442 Deleting rows from an Access table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443 Calling action queries with ODBC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443 Parameter queries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 444 Access and Cicode date/time conversions . . . . . . . . . . . . . . . . . . . . . . . . . 445
Chapter 19
Contents Using Constants and Arrays with Super Genies . . . . . . . . . . . . . . . . . . . . . 459 Creating a Genie controller . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461 Attach Super Genie dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461 Select Super Genie dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462 Nesting Super Genies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462 Super Genie areas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462 Super Genie environment variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462 Using Structured Tag Names with Genies and Super Genies . . . . . . . . . . . . . . . . 463 Using structured tags with Genies. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463 Using structured tags with Super Genies . . . . . . . . . . . . . . . . . . . . . . . . . . 464 Hiding Graphics Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465 IFDEF format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465
xiii
Chapter 20
Chapter 21
xiv
Contents Computer Setup Wizard - Miscellaneous security. . . . . . . . . . . . . . . . . . . . 481 Compueter Setup Wizard - General options setup . . . . . . . . . . . . . . . . . . . 481 Computer Setup Wizard Finish . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482
Chapter 22
Contents Specifying a schedule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Writing to the scheduled I/O device. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Reading from the scheduled I/O device . . . . . . . . . . . . . . . . . . . . . . . . . . . Communicating with Diallable Remote I/O Devices (Windows NT/2000 Only) . . . Modems at the I/O server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Modems at the I/O device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Example configurations for modems at the I/O Server . . . . . . . . . . . . . . . . I/O device constraints for multi-dropping . . . . . . . . . . . . . . . . . . . . . . . . . . . Configuring multidrop remote I/O devices . . . . . . . . . . . . . . . . . . . . . . . . . . Modems Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . I/O server redundancy for diallable remote I/O devices . . . . . . . . . . . . . . . Trouble-shooting diallable remote I/O device communications . . . . . . . . . . Alternative (backward compatibility) method of permanent connection . . . 526 527 527 529 530 531 531 535 536 540 540 541 542
xv
Chapter 23
Chapter 24
Chapter 25
xvi
Contents Running Your System Over the Internet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 569 CitectSCADA Internet Display Client. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 569 CitectSCADA Internet server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 570 Startup and runtime configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 570 Server - client file updates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 570 Citect Internet Client setup properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 572 Providing Runtime Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 573 Running CitectSCADA as a service under NT . . . . . . . . . . . . . . . . . . . . . . 573 Running CitectSCADA as the shell under NT . . . . . . . . . . . . . . . . . . . . . . . 573 Disabling Windows keyboard commands . . . . . . . . . . . . . . . . . . . . . . . . . . 573 Disabling control menu commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 574 Removing the Cancel button . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 574 Using an Alternative INI File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 574 Debugging the Runtime System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 575 Hardware alarms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 575 SysLog.DAT file. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 575 Debugging I/O Devices and Protocols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 576 Creating a communications test project . . . . . . . . . . . . . . . . . . . . . . . . . . . 576 Debugging a COMx driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 578 Debugging a TCP/IP driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 581 Debugging a protocol driver using serial communications . . . . . . . . . . . . . 582 Debugging proprietary board drivers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 584 Contacting Citect support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 584 Restarting the System Online . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 584 Restarting a networked system online. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 585 CitectSCADA Software Protection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 588 Updating your hardware key . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 588 CiUSAFE dialog properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 589 Citect license point count. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 590 Demo mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 590 Using the CitectSCADA Kernel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 591 Displaying the kernel window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 591 Inside the kernel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 592 Using Kernel Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 596 Kernel commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597 Gathering Runtime Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597 System tuning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 598
Chapter 26
Contents Switching between clusters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 612 Configuring projects for distributed servers . . . . . . . . . . . . . . . . . . . . . . . . . 612 Configuring CitectSCADA to communicate over a WAN. . . . . . . . . . . . . . . 613 Building Redundancy into Your System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 615 I/O server redundancy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 615 Redundancy and persistence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 617 Data path redundancy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 618 Alarms, reports, and trends server redundancy . . . . . . . . . . . . . . . . . . . . . 621 How CitectSCADA handles alarms server redundancy. . . . . . . . . . . . . . . . 622 How CitectSCADA handles reports server redundancy . . . . . . . . . . . . . . . 622 How CitectSCADA handles trends server redundancy . . . . . . . . . . . . . . . . 623 How CitectSCADA handles file server redundancy. . . . . . . . . . . . . . . . . . . 623 How CitectSCADA handles FTP server redundancy. . . . . . . . . . . . . . . . . . 624 LAN redundancy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 625 NetBIOS Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 626 CiNet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 628
xvii
Appendix A
Parameters
Using Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Rules for using parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using parameters on a network. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Parameters Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Parameter Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 629 629 630 631 631
Appendix B
xvii
Contents Command Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 663 Error Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 663 Protocol Generic Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 664 Protocol-Specific Errors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 668 NetBIOS Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 671
Glossary Index
673 689
Introducing CitectSCADA
CitectSCADA systems are used in various applications in many different industries. Whatever your application, CitectSCADA will help you deliver an effective plant monitoring and control system. CitectSCADA's client-server architecture provides many benefits. For big and small applications alike, you have the flexibility to choose your own system design, confident that your system will be fast, efficient, and completely scalable. When it comes time to resize your system, you can do so without wasting any of your initial investment. CitectSCADA provides complete redundancy, tolerating failure anywhere in your system, with no loss of functionality or performance. See Also Using CitectSCADA Configuring CitectSCADA The CitectSCADA Environment
Using CitectSCADA
With CitectSCADA you can: