Sunteți pe pagina 1din 223

Symphony Plus - Harmony

S+ Engineering: Composer Harmony (Version 5.1)


Primary Interface Manual

Symphony Plus

NOTICE
This document contains information about one or more ABB products and may include a
description of or a reference to one or more standards that may be generally relevant to
the ABB products. The presence of any such description of a standard or reference to a
standard is not a representation that all of the ABB products referenced in this document
support all of the features of the described or referenced standard. In order to determine
the specific features supported by a particular ABB product, the reader should consult the
product specifications for the particular ABB product.
ABB may have one or more patents or pending patent applications protecting the intellectual
property in the ABB products described in this document.
The information in this document is subject to change without notice and should not be
construed as a commitment by ABB. ABB assumes no responsibility for any errors that
may appear in this document.
In no event shall ABB 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 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, 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. This
product meets the requirements specified in EMC Directive 2004/108/EEC and in Low
Voltage Directive 2006/95/EEC.

TRADEMARKS
All rights to copyrights, registered trademarks, and trademarks reside with their respective
owners.
Copyright 2011 ABB.
All rights reserved.

Release:
Document number:

April 2011
2VAA000812R0001

TABLE OF CONTENTS - i

TABLE OF CONTENTS
About This Book ......................................................................................................1
General ..................................................................................................................1
Document Conventions .......................................................................................1
Information and Tip Icons....................................................................................1
1. Introduction.................................................................................................... 1-1
1.1
1.2

Intended User ......................................................................................................1-1


Glossary of Terms and Abbreviations...............................................................1-1

2. Description ..................................................................................................... 2-3


2.1 Composer Environment......................................................................................2-3
2.1.1 Exchange Window ...........................................................................................2-3
2.1.2 System Architecture Window ...........................................................................2-3
2.1.3 Output Window ................................................................................................2-3
2.2 Projects ................................................................................................................2-3
2.3 Control Networks ................................................................................................2-3
2.4 Harmony Control Units .......................................................................................2-4
2.5 Controllers ...........................................................................................................2-4
2.6 Control Logic Templates.....................................................................................2-4
2.7 Control Logic Documents...................................................................................2-4
2.8 Tag Database .......................................................................................................2-4
2.9 Configuration File................................................................................................2-4
2.10 Human System Interfaces ..................................................................................2-4
2.11 Display Groups ....................................................................................................2-4
2.12 Displays................................................................................................................2-4
2.13 Logs......................................................................................................................2-4
2.14 Lists ......................................................................................................................2-4
2.15 Configuration Server...........................................................................................2-5
2.16 Project Development...........................................................................................2-5

3. Project Architecture ...................................................................................... 3-1


3.1 Projects ................................................................................................................3-1
3.1.1 Auto Open........................................................................................................3-1
3.1.2 Binding References Across Multiple Projects ..................................................3-1
3.1.3 Compact...........................................................................................................3-2
3.1.4 Convert ............................................................................................................3-2
3.1.5 Create ..............................................................................................................3-3
3.1.6 Open ................................................................................................................3-3
3.1.7 Properties.........................................................................................................3-4
3.1.8 Refresh ............................................................................................................3-4

TABLE OF CONTENTS - ii

3.1.9 Repair ..............................................................................................................3-4


3.1.10 Run Time .........................................................................................................3-4
3.1.11 Save As............................................................................................................3-5
3.2 Exchange .............................................................................................................3-5
3.2.1 Create ..............................................................................................................3-5
3.2.2 Open ................................................................................................................3-5
3.2.3 Properties.........................................................................................................3-6
3.2.4 Shortcuts..........................................................................................................3-6
3.3 Control Networks ................................................................................................3-6
3.3.1 Create ..............................................................................................................3-6
3.3.2 Properties.........................................................................................................3-6
3.4 Harmony Control Units .......................................................................................3-6
3.4.1 Create ..............................................................................................................3-7
3.4.2 Properties.........................................................................................................3-7
3.4.3 View Reports....................................................................................................3-7
3.5 Controllers ...........................................................................................................3-7
3.5.1 Assigned Controllers........................................................................................3-8
3.5.2 Binding Report .................................................................................................3-8
3.5.3 Change Operating Mode..................................................................................3-9
3.5.4 Compile............................................................................................................3-9
3.5.5 Copy Firmware...............................................................................................3-10
3.5.6 Create ............................................................................................................3-10
3.5.7 Delete Firmware............................................................................................. 3-11
3.5.8 Edit CSP File.................................................................................................. 3-11
3.5.9 Format Memory..............................................................................................3-12
3.5.10 Import Firmware.............................................................................................3-12
3.5.11 Inspect ...........................................................................................................3-12
3.5.12 Label Device ..................................................................................................3-12
3.5.13 Load Data and C Files ...................................................................................3-13
3.5.14 Load Firmware ...............................................................................................3-13
3.5.15 Online Configuration ......................................................................................3-14
3.5.16 Print................................................................................................................3-16
3.5.17 Properties.......................................................................................................3-17
3.5.18 Reorder CLDs ................................................................................................3-17
3.5.19 View Files.......................................................................................................3-18
3.5.20 View Reports..................................................................................................3-18
3.5.21 C Utility Program (CUP) Support in Composer..............................................3-18
3.5.22 Miscellaneous Communication Issues...........................................................3-20
3.6 Control Logic Templates...................................................................................3-20
3.6.1 Configure Settings .........................................................................................3-20
3.6.2 Create ............................................................................................................3-21
3.6.3 Edit.................................................................................................................3-21

TABLE OF CONTENTS - iii

3.6.4 Primary Versus Local .....................................................................................3-21


3.6.5 Properties.......................................................................................................3-21
3.6.6 Restore ..........................................................................................................3-22
3.6.7 Update ...........................................................................................................3-22
3.7 Control Logic Documents.................................................................................3-22
3.7.1 Automatic Function Block Addressing ...........................................................3-22
3.7.2 Check Signal Connections.............................................................................3-26
3.7.3 Create ............................................................................................................3-27
3.7.4 Edit.................................................................................................................3-27
3.7.5 Export.............................................................................................................3-27
3.7.6 Import.............................................................................................................3-31
3.7.7 Print................................................................................................................3-33
3.7.8 Properties.......................................................................................................3-34
3.7.9 Review History ...............................................................................................3-34
3.7.10 Status .............................................................................................................3-34
3.8 Configuration File..............................................................................................3-35
3.8.1 Load to Controller ..........................................................................................3-35
3.8.2 Properties.......................................................................................................3-35
3.8.3 Review History ...............................................................................................3-35
3.8.4 Save from Controller ......................................................................................3-35
3.8.5 Global Save/Load/Verify ................................................................................3-36
3.9 Human System Interfaces ................................................................................3-39
3.9.1 Create ............................................................................................................3-39
3.9.2 Properties.......................................................................................................3-39
3.10 Display Groups ..................................................................................................3-40
3.10.1 Create ............................................................................................................3-40
3.10.2 Export.............................................................................................................3-40
3.10.3 Print................................................................................................................3-40
3.10.4 Properties.......................................................................................................3-41
3.11 Displays..............................................................................................................3-41
3.11.1 Create ............................................................................................................3-41
3.11.2 Edit.................................................................................................................3-41
3.11.3 Export.............................................................................................................3-41
3.11.4 Open ..............................................................................................................3-42
3.11.5 Print................................................................................................................3-42
3.11.6 Properties.......................................................................................................3-42
3.11.7 References.....................................................................................................3-43
3.11.8 Synchronize with Tags ...................................................................................3-43
3.12 Lists ....................................................................................................................3-43
3.12.1 Assign ............................................................................................................3-44
3.12.2 Create ............................................................................................................3-44
3.12.3 Edit.................................................................................................................3-44

TABLE OF CONTENTS - iv

3.12.4 Export.............................................................................................................3-48
3.12.5 Import.............................................................................................................3-48
3.12.6 Tag List Import Compatibility Issues ..............................................................3-53
3.12.7 Print................................................................................................................3-54
3.12.8 Properties.......................................................................................................3-54
3.13 Configuration Server.........................................................................................3-54
3.13.1 Create ............................................................................................................3-55
3.13.2 Properties.......................................................................................................3-55
3.14 Common Editing Functions .............................................................................3-55
3.14.1 Change Address ............................................................................................3-55
3.14.2 Create an Entity .............................................................................................3-55
3.14.3 Copy...............................................................................................................3-56
3.14.4 Delete.............................................................................................................3-56
3.14.5 Double-Click...................................................................................................3-56
3.14.6 Import a Document ........................................................................................3-56
3.14.7 Move ..............................................................................................................3-57
3.14.8 Rename .........................................................................................................3-57
3.14.9 Tag Synchronize ............................................................................................3-57
3.14.10Transfer Tags and Specifications..................................................................3-57
3.14.11View Configuration........................................................................................3-61
3.14.12View Properties.............................................................................................3-63
3.14.13Verify.............................................................................................................3-64

4. Tag Configuration .......................................................................................... 4-1


4.1 Tag Categories.....................................................................................................4-1
4.2 Descriptor Fields .................................................................................................4-1
4.3 Field Data and Format.........................................................................................4-2
4.4 Field Location ......................................................................................................4-2
4.5 Field Sources.......................................................................................................4-2
4.6 Engineering Unit Descriptor List .......................................................................4-2
4.7 Logic State Descriptor List.................................................................................4-2
4.8 Alarm Comments List .........................................................................................4-2
4.9 Tag Lists ...............................................................................................................4-3
4.10 Configuration Server Lists .................................................................................4-3
4.11 Views ....................................................................................................................4-3
4.11.1 Create ..............................................................................................................4-3
4.11.2 Copy.................................................................................................................4-4
4.11.3 View List...........................................................................................................4-4
4.11.4 Modify ..............................................................................................................4-4
4.11.5 Save.................................................................................................................4-8
4.11.6 Select ...............................................................................................................4-8
4.12 Tag Information....................................................................................................4-8

TABLE OF CONTENTS - v

4.13
4.14
4.15
4.16
4.17
4.18
4.19
4.20
4.21
4.22
4.23
4.24
4.25
4.26
4.27
4.28
4.29

Add Records ........................................................................................................4-8


Copy Records ......................................................................................................4-9
Delete Records ....................................................................................................4-9
Edit Records ........................................................................................................4-9
Field Vocabularies ...............................................................................................4-9
Find Records .....................................................................................................4-10
Go to Record...................................................................................................... 4-11
Refresh Records................................................................................................ 4-11
Reorder Columns .............................................................................................. 4-11
Replace Records ............................................................................................... 4-11
Select Columns .................................................................................................4-15
Select Font .........................................................................................................4-15
Select Records ..................................................................................................4-16
Sort Records......................................................................................................4-16
Control Logic Documents.................................................................................4-16
Tag Properties....................................................................................................4-16
Field Information Tables ...................................................................................4-17

5. Local Monitoring and Trending .................................................................... 5-1


5.1 Create Trend Document......................................................................................5-1
5.2 Open Trend Document........................................................................................5-1
5.3 Configure Trends.................................................................................................5-1
5.3.1 Color ................................................................................................................5-1
5.3.2 Name ...............................................................................................................5-1
5.3.3 Function Block Information ..............................................................................5-1
5.3.4 Type .................................................................................................................5-2
5.3.5 Activation .........................................................................................................5-2
5.4 Editing Trends .....................................................................................................5-2
5.5 Trend Window Operation ....................................................................................5-2
5.5.1 Start..................................................................................................................5-2
5.5.2 Stop..................................................................................................................5-2
5.5.3 Pause...............................................................................................................5-2
5.5.4 Record .............................................................................................................5-2
5.5.5 Pan ..................................................................................................................5-3
5.5.6 Zoom................................................................................................................5-3
5.5.7 Line Cursor ......................................................................................................5-3
5.5.8 Properties.........................................................................................................5-3
5.5.9 Print..................................................................................................................5-3

6. Logs ................................................................................................................ 6-1


6.1 Composer Event..................................................................................................6-1
6.1.1 Enable..............................................................................................................6-1

TABLE OF CONTENTS - vi

6.1.2 View .................................................................................................................6-1


6.1.3 Configure .........................................................................................................6-2
6.1.4 Archive .............................................................................................................6-2
6.2 Conductor VMS Custom .....................................................................................6-3
6.3 Log Configuration Utility ....................................................................................6-3
6.4 Creating New Logs..............................................................................................6-3
6.5 Editing Existing Logs..........................................................................................6-3
6.5.1 Cell Types ........................................................................................................6-7
6.5.2 Repeat Collection Cycle.................................................................................6-10
6.5.3 Analog Collection Trigger Conditions.............................................................6-10
6.5.4 Analog Print Trigger Conditions .....................................................................6-10
6.6 Compressing ASCII Space ............................................................................... 6-11
6.7 Saving Logs ....................................................................................................... 6-11
6.8 Editing Functions .............................................................................................. 6-11
6.9 Exporting Logs .................................................................................................. 6-11

7. Example Configuration ................................................................................. 7-1


7.1 Introduction .........................................................................................................7-1
7.2 Example Project Data..........................................................................................7-1
7.3 Configuration Procedure ....................................................................................7-1
7.3.1 Project PLANT_ONE .......................................................................................7-1
7.3.2 Harmony Control Unit HCU_ONE....................................................................7-2
7.3.3 Harmony Control Unit HCU_TWO ...................................................................7-2
7.3.4 Human System Interface HSI_ONE.................................................................7-3
7.3.5 Human System Interface HSI_TWO ................................................................7-5

8. Miscellaneous Procedures ........................................................................... 8-1


8.1 Utility to Copy User Views, Filters, and Replace Specifiers............................8-1
8.2 Procedure for Converting DOS Tools Projects.................................................8-1
8.2.1 Procedure Requirements .................................................................................8-1
8.2.2 Procedure ........................................................................................................8-2
8.3 Connecting to ICI on a Remote Server ..............................................................8-3
8.4 Pack and Go Functionality .................................................................................8-4
8.4.1 Pack .................................................................................................................8-4
8.4.2 Unpack.............................................................................................................8-4

9. Standalone Configuration Viewer ................................................................ 9-1


9.1 Configuration Files..............................................................................................9-1
9.1.1 Close................................................................................................................9-1
9.1.2 Download .........................................................................................................9-1
9.1.3 Open ................................................................................................................9-1
9.1.4 Print, Save, and Save As .................................................................................9-1
9.1.5 Upload..............................................................................................................9-1

TABLE OF CONTENTS - vii

9.1.6 Verify ................................................................................................................9-1


9.2 Function Blocks and Codes ...............................................................................9-2
9.2.1 Add ..................................................................................................................9-2
9.2.2 Delete...............................................................................................................9-2
9.2.3 Read ................................................................................................................9-2
9.2.4 Modify ..............................................................................................................9-2
9.2.5 Tune.................................................................................................................9-3
9.3 Computer Interface Modules ..............................................................................9-3
9.3.1 Connect............................................................................................................9-3
9.3.2 Configure .........................................................................................................9-3
9.3.3 Disconnect .......................................................................................................9-4
9.3.4 Restart .............................................................................................................9-4
9.3.5 Change Operating Mode..................................................................................9-4
9.3.6 Current Operating Mode ..................................................................................9-4

10. Composer Prelaunch Service ..................................................................... 10-1


10.1 Configuration.....................................................................................................10-1
10.2 Composer Prelaunch Logon Agent .................................................................10-2
10.3 Change Service Administrator.........................................................................10-2

11. Tag List Structures .......................................................................................11-1


12. Composer Power Tools ............................................................................... 12-1
12.1 Control Logic Editor..........................................................................................12-1
12.1.1 Manipulate CLs Tool ......................................................................................12-1
12.1.2 Text/Xref Editor ..............................................................................................12-3
12.1.3 Function Code Editor ...................................................................................12-13
12.1.4 Database Utilities .........................................................................................12-14
12.1.5 Miscellaneous Topics ...................................................................................12-15
12.2 Revision Manager............................................................................................12-22
12.2.1 Create New Revision ...................................................................................12-22
12.2.2 Delete Revision History................................................................................12-23
12.2.3 Delete Revisions ..........................................................................................12-23
12.2.4 Edit Pick List ................................................................................................12-23
12.2.5 Edit Working Version Comment ...................................................................12-23
12.2.6 Filter Revision Listing...................................................................................12-23
12.2.7 Make Working Version Equal to Selected Revision .....................................12-24
12.2.8 Print Revisions .............................................................................................12-24
12.2.9 Select/Deselect Revisions ...........................................................................12-25
12.2.10Set Review Status.......................................................................................12-25
12.2.11Swap Control Logic Document Borders......................................................12-25
12.2.12Swap Control Logic Template Borders .......................................................12-26
12.2.13Transfer Revisions Between Projects .........................................................12-26

TABLE OF CONTENTS - viii

12.2.14View Revisions ...........................................................................................12-27


12.3 Automatic Drawing Generator .......................................................................12-27
12.3.1 Create Control Logic Documents.................................................................12-27
12.3.2 Event Handling Procedures .........................................................................12-31
12.3.3 Modify Database Assignments of a CLD .....................................................12-31
12.3.4 Miscellaneous Topics ...................................................................................12-32
12.4 Advanced Trend ..............................................................................................12-41
12.4.1 Common Trend Document Operations ........................................................12-42
12.4.2 Configure Default and Document Options ...................................................12-42
12.4.3 Configure Outputs........................................................................................12-43
12.4.4 Configure Recording Options.......................................................................12-43
12.4.5 Configure Tunable Specifications ................................................................12-43
12.4.6 Convert Trend Files .....................................................................................12-44
12.4.7 Pan ..............................................................................................................12-44
12.4.8 Scan Loop....................................................................................................12-44
12.4.9 Scanning and Recording Values..................................................................12-44
12.4.10Tune or Edit Function Block Data ...............................................................12-44
12.4.11Zoom...........................................................................................................12-45

13. ICI to Computer Interface Setup ................................................................. 13-1


13.1 Introduction .......................................................................................................13-1
13.2 Harmony System Configuration ......................................................................13-1
13.2.1 Logical to Physical Connection Frame...........................................................13-2
13.2.2 Command Buttons .........................................................................................13-3
13.2.3 Connection Type Definition Frame.................................................................13-3
13.2.4 Harmony API Server Setup as Windows 7 Service .......................................13-7
13.3 Setting the IET800's IP Address via the diagnostic port ...............................13-9

TABLE OF CONTENTS - i

LIST OF TABLES
Table 1-1
Table 3-1
Table 3-2
Table 3-3
Table 3-4
Table 3-5
Table 3-6
Table 3-7
Table 3-8
Table 3-9
Table 3-10
Table 3-11
Table 3-12
Table 3-13
Table 3-14
Table 3-15
Table 3-16
Table 3-17
Table 3-18
Table 3-19
Table 3-20
Table 4-1
Table 4-2
Table 4-3
Table 4-4
Table 4-5
Table 4-6
Table 4-7
Table 4-8
Table 4-9
Table 4-10
Table 4-11
Table 4-12
Table 4-13
Table 6-1
Table 6-2
Table 6-3
Table 6-4
Table 6-5

Glossary of Terms and Abbreviations .........................................................1-1


Cross Project Scan Results Window Columns ............................................3-1
CSP File Editable Fields ............................................................................ 3-11
Exception Report Function Codes ............................................................3-25
Exportable Function Code Properties .......................................................3-27
Exportable Constant Block Properties .......................................................3-28
Exportable Text Properties ........................................................................3-28
Exportable Input Reference Properties .....................................................3-29
Exportable Output Reference Properties ..................................................3-29
Exportable Tag and Function Code Properties ..........................................3-30
Importable Function Code Properties ........................................................3-31
Importable Constant Block Properties .......................................................3-32
Importable Text Properties ........................................................................3-32
Importable Input Reference Properties .....................................................3-33
Importable Output Reference Properties ...................................................3-33
Trend List Fields ........................................................................................3-44
Report Point List Fields .............................................................................3-47
Tag, Trend, and Report Point List Revisions .............................................3-50
Import File Options ....................................................................................3-52
Specification Data Transferable to Composer Database ..........................3-57
Specification Data Transferable to Control Logic Documents ...................3-59
Special Search Characters (Filter & Find) ...................................................4-5
String Functions ..........................................................................................4-5
Math Functions ............................................................................................4-7
Special Search Characters (Replace) .......................................................4-12
Special Replace Characters ......................................................................4-15
Tag Types ..................................................................................................4-17
Required Fields .........................................................................................4-19
Tag Database Fields ..................................................................................4-20
Field Descriptions ......................................................................................4-27
Choices for AlmType Field ........................................................................4-33
Choices for AlmInhStat Field .....................................................................4-33
N90STA Tag ModNodeTypeAndRev Field Choices ..................................4-33
Choices for ConsDevType, ConsDevNum, and ConsDevSubType Fields 4-34
Log Definition Fields ....................................................................................6-4
Printer Escape Sequences ..........................................................................6-7
Color Escape Sequences ............................................................................6-7
Trend Value Cell Fields ...............................................................................6-8
Time and Date Formats ...............................................................................6-9

TABLE OF CONTENTS - ii

Table 6-6
Table 10-1
Table 11-1
Table 12-1
Table 12-2
Table 12-3
Table 12-4
Table 12-5
Table 12-6
Table 12-7
Table 12-8
Table 12-9

Offset Time Formats ....................................................................................6-9


Prelaunch Process History Columns .........................................................10-2
Taglist Structures (R1, S1, T1, V1, X1, S1U, X1U, and X2U) ................... 11-1
Color Condition Summary .........................................................................12-6
Available Special Search Characters (Filter and Find) ............................12-16
Available Special Search Characters (Replace) ......................................12-16
Available Special Replace Characters ....................................................12-20
Available String Functions .......................................................................12-20
Available Math Functions ........................................................................12-21
Attribute Types ........................................................................................12-34
Tunable Specifications Area Information .................................................12-41
Outputs Area Information ........................................................................12-42

Preface

This instruction provides information about how to set up a project through the Composer window of the
Composer software package.
A step-by-step example project configuration is also provided.
This instruction reflects the 5.1 software system.

2VAA000812R0001

ii

2VAA000812R0001

Support Services

ABB will provide assistance in the operation and repair of its products. Requests for sales or application services
should be made to your nearest sales or service office. ABB can also provide installation,
repair and maintenance contract services.
When ordering parts, use nomenclature or part numbers and part descriptions from equipment manuals.
Parts without a description must be ordered from the nearest sales or service office. Recommended spare parts lists,
including prices are available through the nearest sales or service office.
ABB has modern training facilities available for training your personnel. On-site training is also available.
Contact your nearest ABB sales office for specific information and scheduling.
Additional copies of this instruction, or other instructions, can be obtained from the nearest ABB
sales office at a reasonable charge.

2VAA000812R0001

1-i

1-ii

2VAA000812R0001

About This Book

About This Book


General
This documentation provides the necessary information to use the Composer software to create and configure a project
within the Composer window. It is not a tutorial for process control and assumes the reader has knowledge of graphicsbased process control systems. It is intended for personnel with human system interface and controller configuration
experience. This instruction further assumes the reader is familiar with the Windows operating system.

Document Conventions
Microsoft Windows conventions are normally used for the standard presentation of material when entering text, key
sequences, prompts, messages, menu items, screen elements, etc.

Information and Tip Icons


This publication includes Information and Tip where appropriate to point out important information or useful hints to the
reader. The corresponding symbols should be interpreted as follows:
Information icon alerts the reader to pertinent facts and conditions.

Tip icon indicates advice on, for example, how to design your project or how to use a certain function

Warning icon indicates the presence of a hazard which could result in a plant shutdown.

2VAA000812R0001

About This Book

2VAA000812R0001

1. Introduction

Intended User

1. Introduction
The Composer window of the Composer software application provides an interactive tool for creating, managing, and
implementing project configurations. All the components of a project are created within the Composer window. Projects are
organized into a structure that directly correlates to the actual control system.

1.1

Intended User
This documentation provides the necessary information to use the Composer software to create and configure a project
within the Composer window. It is not a tutorial for process control and assumes the reader has knowledge of graphicsbased process control systems. It is intended for personnel with human system interface and controller configuration
experience. This instruction further assumes the reader is familiar with the Windows operating system.

1.2

Glossary of Terms and Abbreviations


The following table is a glossary of terms and abbreviations used in this instruction. It contains those terms and
abbreviations that are unique to ABB or have a definition that is different from standard industry usage.

Table 1-1 Glossary of Terms and Abbreviations


Term

Definition

C specification Computer resident file (.CSP extension) containing information about


(CSP)
the C environment in a controller module. This information consists of
module format information, C memory usage information, and a list of
object files that make up the C program. There is one .csp file for each
target controller module.

2VAA000812R0001

Control logic
document
(CLD)

A grouping of sheets containing control logic (usually with a similar


purpose). A controller configuration frequently contains multiple control
logic documents.

Control logic
template

Preconfigured configuration documents used to simplify the creation of


a new control logic document. A control logic template, when dragged
into a controller, becomes a control logic document.

Exchange

Project-wide repository of system and user-defined reusable


components (symbols, shapes, macros, and documents). These
components are organized into folders.

Harmony
control unit

A control network node that contains controllers.

Human
systems
interface

Combined hardware and software entity (sometimes just a software


application) used by operators to monitor and control the process
control system.

Project

The largest grouping of configuration information (displays, control logic


documents, etc.) for a process.

Sheet

The actual pages of a control logic document on which control logic is


inserted.

1-1

Glossary of Terms and Abbreviations

1-2

1. Introduction

2VAA000812R0001

2. Description

Composer Environment

2. Description
The Composer product provides an integrated visual development environment for Symphony system configurations. The
Composer environment greatly simplifies the configuration and maintenance of Symphony systems. The following topics
describe the Composer environment, project components, and recommended procedure for developing projects.

2.1

Composer Environment
The base Composer product provides all the functionality necessary to develop and maintain control system configurations.
Contained within the Composer window are the exchange, system architecture, and output windows. Help is provided to
ensure that explanatory information is readily available.

2.1.1 Exchange Window


The exchange is a project-wide repository for control logic document and display configuration information. This window
lists the folders that contain the component parts (control logic templates, function codes, macros, shapes, and borders)
used to create controller configurations (control logic documents). Also listed are the folders containing the component parts
(symbols) used to create human system interface displays. There are two types of folders on the exchange. System folders
contain ABB-provided standard components. User folders contain components (standard or custom) stored by the user.
This allows for flexibility in organizing reusable components on the exchange.
All the appropriate objects in exchange folders can be copied into control logic documents using the drag and drop method.
It is also possible to cut, copy, and paste objects between different folders or projects. Control logic templates copied to a
controller using either method become control logic documents.

2.1.2 System Architecture Window


This window functions similar to the Microsoft Explorer. The left side of the window displays a tree structure representing
the Symphony system architecture. This tree structure directly correlates to the actual control system. The right side of the
window displays that portion of the architecture that is contained by the selected object and any documents attached to the
selected object. These documents can be opened by double clicking the document. The appropriate software will be
launched automatically. The right side of the window also supports the standard Windows ability to select multiple items.
The functions that can be performed on these selections are:

Cut.

Copy.

Paste.

Delete.

View configuration (if control logic documents are selected).

Verify (if control logic documents are selected).

Export (If displays are selected).

2.1.3 Output Window


This window provides a textual feedback of all operations performed in the Composer application. This window is located
across the bottom of the Composer window by default but it can be docked anywhere within the Composer window. There
are five tabs in the output window. These tabs organize the text messages into groups which makes searching for a
particular message easier. The contents of the active tab in the output window can be deleted, printed, or saved by right
clicking the text and selecting Clear Window, Print, or Save.

2.2

Projects
Projects are the largest structure in a Composer control strategy architecture and typically control a whole process or at
least the major part of one. The structure of a project duplicates the actual control system architecture which greatly
simplifies control system configuration. Contained within a project is all the information needed to support the control
system. Refer to for more detailed information.

2.3

Control Networks
Control networks are communication highways by which information is passed. These networks can be used to subdivide
complex processes into smaller, more manageable groupings. Control networks are the structures that contain all the
human system interfaces, Harmony control units, and controllers. Control networks reside one level below the project in the
project architecture. Refer to Project Architecture for more detailed information.

2VAA000812R0001

2-3

Harmony Control Units

2.4

2. Description

Harmony Control Units


Harmony control units are control network nodes that contain controllers and all the associated hardware (I/O blocks, power
supplies, etc.). They reside one level below the control network to which they belong. Refer to Project Architecture for
more detailed information.

2.5

Controllers
Controllers perform the actual control functions. They are configured using control logic documents. Controllers reside one
level below the node to which they belong. Refer to Project Architecture for more detailed information.

2.6

Control Logic Templates


Control logic templates are reusable templates that can contain control logic, document settings, etc. and are used to create
control logic documents. Links between the template and the documents created from it can be maintained (whole
document or just selected parts). Refer to Project Architecture for more information.

2.7

Control Logic Documents


Control logic documents form the basis of a process control strategy. These documents contain function code logic the
controller uses to control the process. Control logic documents reside in the right side of the system architecture window.
Refer to Project Architecture for more detailed information.

2.8

Tag Database
During the configuration of control logic documents, tag links (connections) to various exception reporting function codes
will need to be established and tracked. These tags are entered into a system-wide database (directly or while saving
configurations and displays) which is available through the data browser. Refer to for more detailed information.

2.9

Configuration File
A configuration file is the result of compiling a controller. All the control logic documents for the controller are processed into
one file whose format is understood by the controller. This file is then downloaded to the controller for execution. Refer to
Project Architecture for more detailed information.

2.10 Human System Interfaces


Human system interfaces provide a human interface to the entire control system. They can be configured to display any
control system information an operator needs. It can also be used to monitor system information, modify (tune) certain
configuration information, and control plant equipment. Human system interfaces reside one level below the control network
in the project architecture. Refer to Project Architecture for more detailed information.

2.11 Display Groups


Groupings of Conductor VMS human system interface displays are called display groups. These groups provide a
convenient way of handling the unique displays for a specific human system interface. Display groups reside one level
below the human system interface to which they belong. Refer to Project Architecture for more detailed information.

2.12 Displays
Displays are the configurations that control what information is presented and how it is presented by the human system
interface. Conductor VMS displays unique to a human system interface reside one level below the display group to which
they belong. Displays used throughout the whole project reside in a folder in the exchange. These displays are copied to
human system interface display groups using drag and drop or copy and paste functionality. These displays remain linked
to the original display until they are edited. Changes made to the original display are reflected in all unedited copies.
Displays reside in the right side of the system architecture window after selecting the display group to which it belongs.
Refer to Project Architecture for more detailed information.

2.13 Logs
Composer can manipulate two types of logs. A Composer event log records actions (configurable) that take place within
Composer. Conductor VMS custom logs are used by Conductor VMS human system interfaces to collect data.
The event log maintains a record of the actions that take place in Composer. The types of actions that are recorded is
configurable on an individual object basis. This log or a subset of it can be archived. A detailed filtering mechanism is
available to permit the archiving of just the required information.
Custom logs can be configured for human system interfaces to collect data. Either time or event triggering can be used for
data collection. The printing of a log can be triggered by time, event, or data collection. Custom logs reside in the right side
of the system architecture window after selecting the human system interface to which it belongs.
Refer to Logsfor more detailed information about logs.

2.14 Lists
There are six types of lists available to a project. They are:
2-4

2VAA000812R0001

2. Description

Configuration Server

Engineering unit descriptor.

Logic state descriptor.

Alarm comment.

Tag.

Trend.

Report point.

The engineering unit descriptor list contains a text descriptor for all the normal engineering units. The logic state descriptor
list contains a text descriptor for all the normal logic states. The alarm comments list contains a text descriptor for all the
normal alarm comments. The engineering unit descriptor, logic state descriptor, and alarm comments lists are used by tags
to describe the indicated property. If a display is configured to display the logic state of a tag, the display is referred to the
logic state descriptor list by the tag to get the actual text to display.
The tag, trend, and report point lists contain a group of tags, trends, and report points. These lists are subsets of the total
tag database that are downloaded to human system interfaces. These lists are required because a whole project may
contain more tags than one human system interface can hold. The information in these lists is used by human system
interfaces to support controller and display configurations. Tags entered into these lists receive additional properties specific
to the human system interface. Lists reside one level below the project in the project architecture. Refer to Tag
Configuration for more detailed information.

2.15 Configuration Server


Configuration servers are used in Operate IT Process Portal systems. One configuration server can be added to a project
and pointed to the workstation in which it resides (refer to Project Architecture). Refer to the Operate IT Process Portal
software documentation for information about these systems.
The configuration server contains the following nine lists.

Areas.

Equipments.

Units.

Security groups.

Graphic displays.

Trend displays.

Group displays.

Historian servers.

Historian atom groups.

These lists contain all the defined items of the type indicated by the name. Operate IT Process Portal tags can be
configured (through property pages) to use the items in these lists. These lists can be edited at any time. Refer to Project
Architecture for more information about these lists.

2.16 Project Development


Projects are developed easily in the Composer environment as long as a step-by-step approach is used. Extensive initial
planning and forethought are required before actually beginning to create a project. The general steps for actually creating
a project configuration with the Composer window are:

1.

Create the project.

2.

Create the Harmony control networks.

3.

Create the controllers.

4.

Create the control logic documents.

5.

Start editing the control logic documents.

6.

Create the human system interfaces.

7.

Create the display groups (Conductor VMS only).

8.

Start editing the displays.

9.

Edit the tag database as needed.

10. Complete the editing of control logic documents, displays, and tag database.
2VAA000812R0001

2-5

Project Development

2. Description

11. Create the required tag, trend, and report point lists.
12. Compile each controller (creates one configuration file from the control logic documents in the
controller).
13. Download each controller. This sends the configuration file to the actual controller.
14. Export each display. This translates and transfers the display to the human system interface.
15. Execute the new configurations downloaded to the controller.
16. Test the displays as the new configuration is executed.
17. Edit the control logic documents to correct any errors found during execution.
18. Recompile the controller and download the new configuration file.
19. Edit the displays to correct any errors found during testing.
20. Export the corrected displays.
21. Execute the new configuration.
22. Monitor and tune the controller configuration to finalize the configuration.
23. Test the displays to finalize their configurations.
The project is now correct and should be saved.

2-6

2VAA000812R0001

3. Project Architecture

Projects

3. Project Architecture
The following topics describe the project structure and how to create and edit all the parts of a project.

3.1

Projects
A project is the largest grouping of information concerning the control system. The project contains a complete description
of the control system. The structure of the project is identical to that of the actual control system. Instructions on how to
create and open a project follow. The properties of a project and how to refresh the system architecture window, convert an
older project (WinTools 2.0 or previous Composer version) to a usable project, save, rename a project, and binding input
and output references to other projects (so that the project will compile without error) are also explained. How to connect the
Composer software to the run-time system, compact a project, and repair a project are detailed as well. Refer to Common
Editing Functions for information about copying, viewing the properties of, and importing a document into a project.

3.1.1 Auto Open


To automatically open (during startup) the last project opened before the last Composer window was closed, select Project
> Auto Open. A check mark next to this menu option indicates it is enabled.

3.1.2 Binding References Across Multiple Projects


Large and complex control projects can be made easier to handle by breaking them into multiple Composer projects. This
breaking into multiple projects usually reduces the number of cross references in each project which may result in improved
performance when opening projects and control logic documents.
Use the Cross Project Binder Tool to confirm that input reference to output reference connections that span multiple projects
are properly configured.
To bind (resolve) input references from the opened project to output references in up to ten other projects:

1.

Right click the project or part of the project containing the control logic documents that
contain input references to output references in other control logic documents in other
projects and select Run Cross Project Binder.

2.

Select the projects to bind to in the Cross Project Binder window and click Scan For Possible
Bindings.

The cross project binder tool searches the specified projects for the output references that correspond to the input
references configured in the control logic documents within the selected part of the project. Successfully matched input and
output references are listed in the Cross Project Scan Results window.
The following table lists the information presented for each successful input (open project) to output (other projects)
reference match.

Table 3-1 Cross Project Scan Results Window Columns


Column

2VAA000812R0001

Description

Descriptor

Name of the input reference.

IRef CLD/Sheet

Control logic document name and sheet


number (in the format cld_nameSsheet_number) containing the input
reference.

IRef Addr

Address of the input reference (in the format


loop-PCU-module-block).

IRef FC Num

Input reference function code number.

Specs

The current address specified by the input


reference (in the format loop-PCU-moduleblock).

New Specs

The address that should be specified by the


input reference (in the format loop-PCUmodule-block).

ORef FC Num

Number of the function code connected to the


output reference.

3-1

Compact

3. Project Architecture

Table 3-1 Cross Project Scan Results Window Columns (Continued)


Column

Description

ORef Project Path Path of the project containing the output


reference.
ORef CLD/Sheet

Control logic document name and sheet


number (in the format cld_nameSsheet_number) containing the output
reference.

Unsuccessful reference matches (input with no output) are listed in the output window.

3.

Select the input references to be updated.

NOTE: Selecting (or deselecting) an input reference of a function code that contains multiple input references causes
all the input references to be selected (or deselected). The input references are handled as a group.
4.

If desired, choose to make a new revision of all control logic documents that will be changed before
they are changed by this tool by allowing the Save All Changes to New Revision option to remain
enabled (the default condition).

5.

If desired, copy the information in this window to the output window (click Output Summary) or to a
comma-separated, value formatted file viewable in Excel (click Export to .CSV).

6.

Click Perform Changes. The control logic documents containing the input references will be opened,
the input reference spec values will be changed, and the control logic document will be saved and
closed. After all input references are bound to the appropriate external output references, this project
will compile successfully.

NOTE: Cross reference reports and binding logs will always report internal input reference to external output reference bindings unconnected. This compiler will also generate XRef Unconnected warnings for bindings updated by
this tool. It is up to the user to confirm that these bindings are actually connected.

3.1.3 Compact
NOTE: If projects are prelaunched on one or more client computers, these must be shut down before the Compact
function can get exclusive access to the database (and perform its function). To shut down a prelaunched project,
select the objects for the project on the History tab of the Prelaunch Configuration Utility and click Shutdown Selected
Object. After the compact is complete, go to the Project tab and click Launch Objects Now, or reboot the computer.
To reduce the amount of memory space a project requires:

1.

Open the project.

2.

Select Tools > Project Maintenance > Compact.

3.

Click Yes in the dialog box to confirm that the current project is to be closed.

When the compact operation is complete, the project is reopened.

3.1.4 Convert
To convert a WinTools 2.0 or previous Composer version project file into a Composer 5.1 project:

3-2

1.

Select Project > Convert....

2.

If a project is currently opened, select Yes in the dialog box to confirm the closing of the currently
opened project.

3.

Enter the project file name and location. Wintools project files have a .PRJ extension while
Composer project files have a .EBP extension.

4.

Enter the location for the converted project.

5.

Enter the name of the converted project.

2VAA000812R0001

3. Project Architecture

6.

Create

Select the project parts (tags, configuration logic, HSI displays) that are to be converted in the project
convert dialog box.

NOTE: All the parts of a previous version Composer project are converted no matter what project parts are selected
for conversion.
7.

If converting a Wintools project, select the traits (limits, attributes, etc.) that the converted project
should have by selecting the type of workstation (console) that has the desired traits in the Context
(Wintools Source Only) field.

8.

If the default regional setting of the workstation is set to one of the English options, proceed to Step
Step 14.

9.

Click Advanced<<<.

10. Verify the original project language and operating system are configured correctly. If not, select the
appropriate language and operating system from the list provided.
11. Set the log operating parameters to the desired condition (enabled or disabled).
12. If the log operating parameters are enabled, verify the current maximum log size and log space
usage warning level are correct. If necessary, edit the values.
13. Verify the current log administrator is correct or specify a new one.
14. Click OK.
15. Monitor progress of the conversion by viewing the messages being logged to the Convert tab of the
output window.
16. Execute the CLD Connection Check function on all control logic documents in the project to ensure
that there are no unrecognized signal to function code connector conditions. Refer to Check Signal
Connections for more information.
When the conversion is complete, the converted project is opened automatically. It may take significantly longer to convert
Wintools projects compared to Composer projects.

3.1.5 Create
To create a project:

1.

Select Project > New.

2.

Select the storage location (destination drive and directory).

3.

Enter the new project name in the dialog box.

4.

Select the traits (limits, attributes, etc.) that the project should have by selecting the type of
workstation (console) that has the desired traits in the Context (Wintools Source Only) field.

5.

Click Advanced.

6.

Enable or disable the logging of project messages.

7.

If the logging if project messages was enabled, enter the maximum size (in megabytes) of the log
and the amount of memory space used by the log (in percent) before a warning message is
generated.

8.

Click OK.

9.

If the destination does not exist, select OK when prompted to create the specified directory.

3.1.6 Open
To open a project:

1.

Select Project > Open....

2.

Specify the project name in the standard Windows open dialog box.

3.

If another project is currently opened, select Yes in the dialog box to confirm the closing of the
currently opened project.

NOTE: Each Composer application can have only one project open at a time.
4.
2VAA000812R0001

Click OK.
3-3

Properties

3. Project Architecture

3.1.7 Properties
The properties of a project include:

Name.

Location.

Size (total).

Status.

Date created.

Date last modified.

Date last opened.

Project language.

Custom properties (customer name, contractor, etc.) used.

To view or edit the properties of a project, refer to Common Editing Functions for more information.

3.1.8 Refresh
The system architecture of a project shown in a Composer window is automatically kept up to date with all changes made in
that window. However, changes made to the same project in another Composer window (multiple users) are not
automatically sent to other windows having this project opened. In this case, manually refresh the project to ensure it
accurately reflects the current condition of the project. To refresh the system architecture listing:

1.

Select View > Refresh.


- or -

1.

In the system architecture window, right click the project, control network, list, human
system interface, display group, display, Harmony control unit, or controller.

2.

Select Refresh.

3.1.9 Repair
In some cases (a power outage occurs while the project is open for example), a project may become unusable or the data
may be corrupted. Use the repair function to repair the integrity of the project database.

NOTE: If projects are prelaunched on one or more client computers, these must be shut down before the Repair
function can get exclusive access to the database (and perform its function). To shut down a prelaunched project,
select the objects for the project on the History tab of the Prelaunch Configuration Utility and click Shutdown Selected
Object. After the repair is complete, go to the Project tab and click Launch Objects Now, or reboot the computer.
To repair a possibly corrupt project:

1.

Open the project.

2.

Select Tools > Project Maintenance > Repair.

3.

Click Yes in the dialog box to confirm that the current project is to be closed.

When the repair operation is complete, the project is reopened.

3.1.10 Run Time


The run-time menu provides five options which are:

Connect.

Disconnect.

Configure.

Restart.

Prompt on connect.

NOTE: The connect, disconnect, restart, and configure run-time functions are also available from within the Configuration Viewer window.

3-4

2VAA000812R0001

3. Project Architecture

Save As

3.1.10.1 Connect
To connect the Composer window to the run-time system (through the Composer server):

1.

Select Run-Time > Connect....

2.

Select the logical computer interface module to be used from the list provided in the select logical ICI
dialog box.

3.

Click OK.

The status shown in the lower right corner of the window will change from Not Connected to Connected when a complete
connection to the run-time system has been made. The information transferred across this connection is module status,
module state, etc.

3.1.10.2 Disconnect
To disconnect the Composer window from the Composer server (and the run-time system), select Run-Time > Disconnect.
The connection status in the lower right corner of the window will change to Not Connected when this operation is complete.

3.1.10.3 Configure
The first run-time task that must be done is telling the client Composer window which path to use when connecting to the
Composer server application. This server is in turn connected to the run-time system through a computer interface module.
To configure a Composer client for run-time operation select Run-Time > Configure. This will launch the Harmony System
Configuration tool, hSysCfg. See Section 13, ICI to Computer Interface Setup for information on configuring the connection
to an ICI module (ICI, IET, NCC).

3.1.10.4 Restart
To restart the computer interface module used by the Composer server in the path (logical ICI) selected during the
connection process, select Run-Time > Restart.

3.1.10.5 Prompt on Connect


Selecting Prompt on Connect causes the select logical ICI dialog box to appear every time Composer needs to connect to
an ICI interface module in order to send or retrieve information. Select the default or another ICI interface module from the
list provided. Deselecting Prompt on Connect causes the default ICI interface module to be used when Composer needs to
connect to an ICI interface module.

3.1.11 Save As
To save a copy of the opened project with a new name:

3.2

1.

Select Project > Save As....

2.

Select the location and name for the new project and click Save.

Exchange
The exchange contains folders that contain function codes, human system interface displays, symbols, shapes, borders,
macros, and control logic templates that are used to create control logic documents and human system interface displays.
These items can be copied to a control logic document or display by dragging and dropping the item. There are two types of
folders on the exchange. System folders contain ABB-provided items. User folders contain items stored by the user. These
items can be user-created shapes, macros, control logic templates, etc. as well as shortcuts. Shortcuts are links to items
residing in other folders. Explanations on how to open, create, and put shortcuts into an exchange folder follow. The
properties an exchange folder has are also described. Refer to Common Editing Functions for information about copying,
deleting, moving, viewing properties of, and renaming exchange folders.

3.2.1 Create
To add a new user exchange folder to the exchange or another user exchange folder:

1.

Select the root exchange folder or open the folder that will contain the new folder.

2.

Right click the empty space in the exchange window and select New > Folder.

The new folder will be named New Folder. Rename it as desired.

3.2.2 Open
To open an exchange folder:

1.
2VAA000812R0001

Select the exchange folder to be opened in the field above the exchange contents listing
area.
3-5

Properties

3. Project Architecture

- or 1.

Right click the folder to be opened and select Explore.

3.2.3 Properties
The properties of an exchange folder are:

Name.

Type.

Location.

Project name.

Status.

To view or edit the properties of an exchange folder, refer to Common Editing Functions for more information.

3.2.4 Shortcuts
A link to an item located in another folder can be added to an exchange folder using the shortcut functionality. Renaming a
shortcut will rename the source document residing on the exchange which causes all other shortcuts to the same document
to change to the new name.
To add a shortcut to a folder:

3.3

1.

Open the folder that will contain the shortcut.

2.

Right click in the folder and select New > Shortcut. The select objects for shortcut dialog box
appears.

3.

Select the exchange folder containing the original item sourcing the shortcut.

4.

Select the original item to which the shortcut is linked.

5.

Click OK.

Control Networks
Control networks are the parts of a project that contain human system interfaces, Harmony control units, and all their
component parts. Instructions on how to create and view properties of a control network follow. Refer to Common Editing
Functions for information about synchronizing the tags used by the control network components with those actually in the
tag database and how to change the address of, move, copy, delete, and rename a control network.

3.3.1 Create
To add a new control network to a project:

1.

Right click the project name and select New > Control Network....

2.

Enter the control network name (64 characters maximum) and address (numbers 1 through 250) in
the dialog box and click OK.

3.3.2 Properties
The properties of a control network include:

Name.

Type.

Location.

Project name.

Status.

Control network address.

To view or edit the properties of a control network, refer to Common Editing Functions for more information.

3.4

Harmony Control Units


Harmony control units are the parts of a control network that contain controllers and their configurations. Instructions on how
to create and view the status or problem report of a Harmony control unit follow. The properties of a Harmony control unit

3-6

2VAA000812R0001

3. Project Architecture

Create

are also described. Refer to Common Editing Functions for information about copying, deleting, importing a document
into, viewing the properties of, changing the address, inspecting, synchronizing the tags of, and renaming a Harmony
control unit.

3.4.1 Create
To add a new Harmony control unit to the control network:

1.

Right click the control network and select New > Control Unit....

2.

Enter the Harmony control unit name (64 characters maximum) and address (numbers 1 through 31)
in the dialog box and click OK.

3.4.2 Properties
The properties of a Harmony control unit include:

Name.

Type.

Location.

Project name.

Status.

Control network number.

Harmony control unit number (node address).

To view or edit the properties of a Harmony control unit, refer to Common Editing Functions for more information.

3.4.3 View Reports


To view a status or problem report from a Harmony control unit, right click the Harmony control unit and select Report >
Status or Report > Problem.
The requested information will appear in the general tab of the output window.

3.5

Controllers
Controllers are the parts of a Harmony control unit that contain control logic. Instructions on how to create, compile, change
the operating mode of, and print a controller follow. Also explained is how to online configure, import a firmware file,
download a firmware file, delete a firmware file, inspect the controller, edit the C specification (CSP) file of, view a status or
problem report from the controller, and reorder the control logic documents assigned to the controller. The properties used
by a controller are also explained. Refer to Common Editing Functions for information about copying, deleting, importing
a document into, moving, viewing the properties of, changing address, verifying, viewing the function code configuration of,
synchronizing the tags of, transferring tag and specification data in or out of, and renaming a controller.

Harmony Area Controllers


This type of controller, when created, adds a specialized Harmony control unit and Harmony area controller to the control
network. Primary Harmony area controllers perform all the functions previously mentioned except for cut, copy, paste, and
delete. Secondary area controllers only perform the compile, load to controller, view configuration, rename, and properties
functions. The associated Harmony control unit performs the cut, copy, and delete functions, and provides redundant
access to the following functions:

Load firmware.

Reports (status and problem).

Print.

Import document.

Refresh.

Rename.

Properties.

Foundation fieldbus-capable I/O devices can be used with the BRC controller. However, the fieldbus configuration of the I/O
device must be accomplished through third-party software (not supplied). The control logic configuration of the I/O device
follows the same procedures as any other Harmony I/O device.

2VAA000812R0001

3-7

Assigned Controllers

3. Project Architecture

Sequence of Events (SEM) Controller


This type of controller adds a specialized Harmony control unit and sequence of events controller to the control network.
This controller performs the following functions:

Assigned controllers.

Edit executive block.

Compile.

Rename.

Properties.

The associated Harmony control unit performs the following functions:

Import document.

Tag synchronize.

Inspect.

Reports (status and problem).

Refresh.

Cut.

Copy.

Delete.

Rename.

Properties.

3.5.1 Assigned Controllers


To show a list of the controllers utilized by a sequence of events controller, right click the sequence of events controller and
select Assigned Controllers.

3.5.2 Binding Report


The binding log feature generates a report that lists the input references and controllers (within the selected Composer
item) that are connected to modified OREF and IREFO output references. The output references used in the report are
selectable. Using the appropriate option, it is possible to generate a report that lists the controllers and input references
connected to the output references modified since a certain date. A report listing all of the controllers and input references
connected to all the output references within the selected Composer item can also be generated. These reports are useful
in determining which controllers need to be changed or recompiled after output references are modified.

NOTE: This feature is similar to the Module Binding Log feature of WinTools.

3.5.2.1 Generate Report


To generate a binding log report:

1.

Open a Composer project.

2.

Select the Composer item (project, control network, control unit, controller, or control logic document)
containing the desired output references.

NOTE: Selecting a control logic document or the controller containing the control logic document will generate the
same binding log report.

3-8

3.

Select Tools > Binding Log....

4.

Select a reference timestamp in the Reference Timestamp for Last Change area of the Module
Binding Log Options window. Refer to Timestamp Options for more information.

5.

Specify the name of the output file in the Output File Name field.

6.

Enable the Send Details to Output Window option to display all the information in the output file in the
output window. If this option is disabled, only one line containing module current time and last
compile time will be displayed for each module being processed. Summary information containing a
list of all modules processed and all modules affected by cross references is also displayed.
2VAA000812R0001

3. Project Architecture

Change Operating Mode

7.

Enable the Check for Unconnected IREFs in Project option to list any IREFs that do not have a
corresponding OREF defined and the source CLD sheet. If this option is disabled, only a single
warning message is displayed if one or more unconnected IREFs have been found.

8.

Click Generate Log.

3.5.2.2 Timestamp Options


The timestamp options control which output references are included in the binding report. The available timestamp options
are:

Use custom timestamp.

Use each modules last compilation date.

Report all references.

Use Custom Timestamp


Selecting this option causes the binding log report to list the output references (and associated input references) that:

have been modified after the specified date and time


- and have associated input references that are located in controllers that were last compiled before the
output references were modified.
The report generated using this option can be used to determine which controllers need to be recompiled as a result of
modifying output references. It could also be used to determine which output references were changed before the controller
was last compiled. Determining the output reference changes that have taken place since a previous revision of
configuration file could also be done using this report.
The last compilation date is determined by the timestamp of the current CFG file for the controller. If the controller has not
yet been compiled, the effective last compilation date is earlier than any timestamp to which it is compared.
Use Each Modules Last Compilation Date
Selecting this option causes the binding log report to list the output references (and associated input references) that:

have been modified since the controllers (within the selected item) containing the output references
were last compiled
- and have associated input references that are located in controllers that were last compiled before the
output references were modified.
The report generated using this option can be used to determine which controllers need to be recompiled as a result of
modifying the output reference.
The last compilation date is determined by the timestamp of the current CFG file for the controller. If the controller has not
yet been compiled, the effective last compilation date is earlier than any timestamp to which it is compared.
Report All References
Selecting this option causes the binding log report to list all output references in the controllers within the selected item and
their associated input references.

3.5.3 Change Operating Mode


To change the operating mode of a controller:

1.

Right click the controller.

2.

Select Run Time > Mode and the desired mode (Configure, Execute, Restart, and Initialize).

3.5.4 Compile
To compile the configuration file for a controller:

1.

Right click the controller and select Compile....

2.

If this is the first time the controller has been compiled, enter the desired configuration file name in
the dialog box and proceed to Step Step 5.

3.

Choose to overwrite the existing configuration file or create a new one in the dialog box.

2VAA000812R0001

3-9

Copy Firmware

3. Project Architecture

4.

If a new configuration file is to be created, enter the new file name.

5.

Click OK.

Text on the Compile tab in the output window will detail if the controller compiled or why it did not compile. Double-clicking
an error message opens the control logic document containing the source of the error message. This output window can be
disabled through the view menu.

3.5.5 Copy Firmware


To copy the firmware from one Harmony I/O device to another (within the same Harmony controller):

1.

Right click the Harmony controller containing the firmware to be copied and select Run Time
> Harmony I/O > Copy Firmware....

2.

Enter the ID of the Harmony I/O device containing the firmware to be copied.

- or a.

Click Get Source.

b.

Click OK in the dialog box to reset the source Harmony I/O device.

c.

Visually confirm that all the source Harmony device status LEDs are flashing.

d.

Click Yes when prompted to confirm the source Harmony I/O device status LEDs are flashing.
3.

Enter the ID of the Harmony I/O device receiving the firmware.

- or a.

Click Get Destination.

b.

Click OK in the dialog box to reset the source Harmony I/O device.

c.

Visually confirm that all the source Harmony device status LEDs are flashing.

d.

Click Yes when prompted to confirm the source Harmony I/O device status LEDs are flashing.
4.

Click Copy.

5.

If the Harmony device controlling the Harmony I/O device receiving the firmware is in execute mode,
select Yes in the dialog box to place it in configure mode.

6.

Click OK when the copy operation is complete.

After a firmware copy to Harmony I/O blocks, the following message may appear:

The destination block label xxxxxx has been deleted by the copy firmware operation. Would you like
to reapply the label?
It is advisable to wait five to ten seconds before confirming the reapply label dialog. If this time is not taken, in some cases
the blocks will get locked in firmware download mode, and the following message will be displayed:

Unable to verify label was applied before reasonable time-out period.


If this occurs, the firmware download must be performed again. However, if the blocks are running firmware revision C2 or
earlier, the only recovery mechanism is for ABB to reset the block.

3.5.6 Create
Controllers can be utilized in three ways: individually, as a part of a primary-redundant pair, and as part of a primary-backup
pair. When used individually, the role of a controller is set to Primary. A primary-redundant pair of controllers utilizes only
one HCU address and, therefore, needs only one controller defined whose role is set to Primary\Redundant. A primarybackup pair of controllers utilizes two HCU addresses and therefore needs two controllers defined. The primary controller
role is set to Primary and the backup controller role is set to Backup\Online. The HCU address of the backup controller must
be one greater than that of the primary controller.

NOTE: The primary-backup controller pair is required when the ability to perform online configuration is desired.
To add a new controller to a Harmony control unit:

3-10

1.

Right click the Harmony control unit and select New > Controller....

2.

Enter the new controller name (64 characters maximum), address (numbers 1 through 31), type, role,
firmware revision and identifier. Also specify any custom properties used by the controller.
2VAA000812R0001

3. Project Architecture

3.

Delete Firmware

Click OK.

To add a new Harmony area controller to a control network:

1.

Right click the control network and select New > HAC....

2.

Enter the new controller name (64 characters maximum), control unit address (numbers 1 through
31), and role.

3.

Click OK.

A new Harmony control unit and area controller are created.


To add a new sequence of events controller to a control network:

1.

Right click the control network and select New > SEM....

2.

Enter the new controller name (64 characters maximum) and control unit address (numbers 1
through 31).

3.

Click OK.

A new Harmony control unit and sequence of events controller are created.

3.5.7 Delete Firmware


To delete Harmony firmware files from the Composer project:

1.

Select Tools > Firmware Maintenance.

2.

Select the firmware file to be deleted and click Delete in the dialog box.

3.5.8 Edit CSP File


To create or edit the file that sets up the controller for C program usage:

1.

Right click the controller and select Edit CSP File.

2.

Enter, edit, or verify the information in the fields described in the following table.

Table 3-2 CSP File Editable Fields


Name

2VAA000812R0001

Description

Contract #

Informational data only (does not affect program execution).

Entry point name

Name of the executable C program in each segment that


contains an invoke C function code (FC 143).

Formatted for C

Amount (in bytes) of the RAM and NVRAM memory allocated


for C programs.

Linked files

Name (with file extension) of the object (.obj) and user


supplied library files to be linked to the C program.

Max # of data files

Maximum number of data files allowed in the controller


directory.

Max size of C code


section

Maximum size (in bytes) of the C program. This value should


be slightly greater than the program size to allow for small
changes.

Max size of C idata


section

Maximum size (in bytes) of the initialized data section of


memory.

Max size of C udata


section

Maximum size (in bytes) of the uninitialized data section of


memory.

Min size of dynamic


memory pool

Minimum size (in bytes) of the memory section reserved for


dynamic memory functions.

Name (contract data)

Informational data only (does not affect program execution).

Name (file)

Name of the CSP file.

3-11

Format Memory

3. Project Architecture

Table 3-2 CSP File Editable Fields (Continued)


Name

Description

Number of checkpoint
buffers

Number of buffers used when sending file information to


redundant controllers. Set this value to zero when no
redundant controller is used.

Number of module I/O


buffers

Number of buffers that provide temporary storage of file data


while accessing a file.

Plant site

Informational data only (does not affect program execution).

Program description

Informational data only (does not affect program execution).

Size of checkpoint buffer Size (in bytes) of each checkpoint buffer. Set this value
greater than that of the largest file to be sent to a redundant
controller. Set this value to zero when no redundant controller
is used.
Size of module I/O buffer Size (in bytes) of each I/O buffer. Set the value greater than
that of the largest file accessed during file transfers.
Stack size

Size (in bytes) of the entry point stack.

3.

Click Link to link the specified files to the C program.

4.

Click Save.

3.5.9 Format Memory


To format a controller with memory space for C program usage:

1.

Right click the controller and select Run Time > Properties.

2.

Select the specifications source (default, manual, or CSP file) on the format tab in the properties
dialog box.

3.

Edit the format specifications (number of files, NVRAM for C, and RAM for C) if the manual
specification source was selected.

4.

Click Format.

3.5.10 Import Firmware


To import Harmony controller firmware files into a Composer project:

1.

Select Tools > Import Firmware....

2.

Enter or select the firmware file name to import and click Next in the dialog box.

3.

Verify the name, location, type, and revision of the selected firmware is correct. If necessary, click
Back and select the correct firmware.

4.

Click Finish.

3.5.11 Inspect
To view the address, type, firmware revision, function (text descriptor), mode, and status of controllers; right click the
Harmony control unit containing the controllers and select Inspect....

NOTE: Inspecting a Harmony control unit will show the information from all the controllers in the Harmony control
unit.
The output window will display the information about all the controllers in the Harmony control unit.

3.5.12 Label Device


To label a Harmony I/O device:

1.
3-12

Right click the controller and select Run Time > Harmony I/O > Label....
2VAA000812R0001

3. Project Architecture

2.

Load Data and C Files

Enter the ID of the Harmony I/O device being labeled.

- or a.

Click ID.

b.

Click OK in the dialog box to reset the Harmony I/O device.

c.

Visually confirm that all the source Harmony I/O device status LEDs are flashing.

d.

Click Yes when prompted to confirm the source Harmony I/O device status LEDs are flashing.
3.

Enter the desired label in the set harmony device label dialog box. It is also possible to select a label
used in the configuration file, control logic, or controller.

4.

Click Label Device.

5.

Click OK when asked to reset the target Harmony I/O device.

NOTE: If a block has a software error (error code indicated by LEDs # 2 and #4 being lit), Composer operations to the
block (such as labeling it) may cause Composer to go into a busy state. If this happens, Composer must be terminated via task manager, the software error on the block must be corrected, Composer must be restarted, and then
the operation must be performed again.

3.5.13 Load Data and C Files


To load data and C files into a controller:

1.

Right click the controller and select Runtime > View Files.

2.

Right click in the View Files window and select Load C or Load Data.

3.

Select the file and click OK.

3.5.14 Load Firmware


To load a Harmony firmware file from the Composer project to a Harmony I/O device:

1.

Right click the device and select Run Time > Harmony I/O > Load Firmware....

2.

Enter the Harmony ID of the device.

- or a.

Click ID.

b.

Click OK in the dialog box to reset the target Harmony I/O device.

c.

Visually confirm that all the target Harmony device status LEDs are flashing.

d.

Click Yes when prompted to confirm the target Harmony device status LEDs are flashing.
3.

Select the desired firmware file from the list of imported firmware files in the dialog box.

4.

Click Download.

NOTE: Do not abort or cancel the download operation after the Download button is selected.
5.

If the Harmony device controlling the Harmony I/O device was in execute mode, select Yes in the
dialog box to place it in configure mode.

6.

Click OK when the import operation is complete.

To load a controller firmware file from the Composer project to a Harmony controller:

1.

Right click the controller and select Run Time > Load Firmware....

2.

Select the desired firmware file from the list of imported firmware files and click Download in the
dialog box.

It is not possible to download firmware to a module via a CPM02 or an IPT01 due to limitations in those modules.
After completing a controller firmware download, it may be necessary to close and reopen Composer to perform additional
controller firmware downloads.

2VAA000812R0001

3-13

Online Configuration

3. Project Architecture

3.5.15 Online Configuration


Online configuration allows configuration changes to be made within the following context: 1) the process remains under
control of the process control system and 2) the original configuration is preserved until the new configuration is tested and
accepted. It requires the control system to have a primary- backup controller pair and for the controllers to be configured
appropriately for online configuration operation. The controllers being configured must be put into the proper role before
initiating the online configuration process. During online configuration, the backup controller is taken offline and
configuration changes made. The primary controller remains in control of the process. After configuration changes have
been made, the functional role of the physical controllers can be switched and the changed configuration put in control of
the process. Options allow for testing of the changed configuration and reversion to the original configuration.

NOTES:
1. The term primary-backup controller pair specifically refers to controller modules having addresses n and n+1
and having the ability to be configured online. Refer to the specific controller module instruction for more information.
2. During online configuration, the primary-backup controller pair may contain two configurations: the original configuration refers to the configuration residing in the primary-backup controller pair before entering online configuration; the new or test configuration refers to any modifications to the original or any other configuration downloaded
to the primary-backup controller pair.
3. During online configuration, the functional role of the physical controllers comprising the primary-backup pair may
switch. The controller at address n is always controlling the process. Upon exiting from online configuration, the roles
and addresses of the physical controllers may be reversed from that when online configuration was entered. This
depends on the actual steps performed during online configuration.
4. Throughout the online configuration process it is the responsibility of the user to correctly make the online configuration changes and wait for the proper controller conditions to be established before each mode change. Incorrect
use can still result in an error in the primary controller that is in control of the process. Refer to the controller module
instruction for detailed sequencing and status information.
5. Online configuration restrictions do not allow the following:
a. Deleting existing function codes. (Permitted in HAC controllers.)
b. Modifying specifications that would increase a function code block memory
utilization.
c. Adding function code blocks within already used block space within the control segments of the controller. Blocks
can only be added following the last block used within a segment. (Permitted in HAC controllers.).
6. If a backup controller fails (halts, losses communication, etc.) during an online configuration operation, the online
configuration operation halts and displays a message stating that online configuration cannot continue until the hardware problem is corrected.
Controllers with Enhanced Status Reporting
Controllers with enhanced status reporting capability can report their configuration complete (CFC) and checkpointing done
(CHK) status when operating on a Cnet or INFI-NET control network. These controllers can also report their function role:
primary/redundant or backup/online.
MFC controllers, pre-F.2 MFP controllers, and any controller operating on a Plant Loop control network must be physically
checked to verify these states. There are two procedures given for online configuration:
Procedure A is used for controllers having enhanced status reporting capability operating on the Cnet or INFI-NET control
network.
Procedure B is used for MFC controllers and pre-F.2 MFP controllers or any controllers operating on a Plant Loop control
network.

3.5.15.1 Procedure A
To online configure a primary-redundant controller pair having enhanced status reporting capability:

1.

Insure the primary and backup controllers have consecutive addresses (primary = n, backup
= n + 1) and both are in execute mode.

2.

Right click the primary controller and select Run Time > Online Configuration....

A dialog box appears asking for confirmation that online configuration should continue. The type, revision, mode, and
address of the primary and backup controllers are also displayed. A message states that the backup controller will be put
into configure mode if online configuration is continued.

3-14

3.

Click OK.

4.

After a short wait, the backup controller goes into configure mode.
2VAA000812R0001

3. Project Architecture

Online Configuration

A new set of buttons appears in the dialog box. These are described in the following paragraphs. The buttons are enabled
and disabled depending on valid operations at each step. Initially, only Go Back is enabled.

5.

Download the new configuration to the backup controller.

6.

Perform one of the following:

Go back to original configuration (Go Back).


Test new configuration (Test).
If no configuration changes are made, the only valid operation is Go Back.
The following paragraphs describe the operations that can be performed during online configuration. The buttons are
enabled and disabled depending on valid operations at each step. Informational messages appear beneath the online
configuration buttons indicating the state of the requested operation.
Test New Configuration
Clicking Test puts the backup controller into execute mode which places the new configuration in control of the process; the
original configuration is preserved within the primary-backup controller pair.
After testing the configuration, perform one of the following operations:

Accept new configuration (Accept).


Go back to original configuration (Go Back).
Make additional configuration changes (Additional).
NOTE: If there is an illegal new configuration, the original configuration will remain in control and the backup controller will go into error mode. Click Go Back to return the controller to configure mode.
Accept New Configuration
Clicking Accept exits online configuration mode with the new configuration in control of the process. The original
configuration in the other controller is replaced with the new configuration and the controller is put into execute mode.
Go Back to Original Configuration
Clicking Go Back returns the original configuration to the backup controller, puts the controller into execute mode, and exits
online configuration.
Make Additional Configuration Changes
Clicking Additional permits making configuration changes after testing a new configuration. The original configuration
(primary controller) is put back into control of the process and the test configuration (backup controller) is returned to the
configure mode.
Edit and download the test configuration and perform one of the following operations:

Test new configuration (Test).


Go back to original configuration (Go Back).

3.5.15.2 Procedure B
This procedure describes the steps required for performing online configuration of a primary-backup controller pair lacking
enhanced status reporting capability or any primary-backup controller pair operating on a Plant Loop control network.
To perform online configuration:

1.

Insure the primary and backup controllers have consecutive addresses (primary = n, backup
= n + 1) and both are in execute mode.

2.

Right click the primary controller and select Run Time > Online Configuration....

A dialog box appears asking for confirmation that online configuration should continue. The type, revision, mode, and
address of the primary and backup controllers are also displayed. A message states that the backup controller will be put
into configure mode if online configuration is continued.

3.

Click OK.

4.

After a short wait, the backup controller goes into configure mode.

A new set of buttons appears in the dialog box. These are described in the following paragraphs. The buttons are enabled
and disabled depending on valid operations at each step. Initially, only Go Back is enabled.

5.

Download the new configuration to the backup controller.

6.

Perform one of the following:

2VAA000812R0001

3-15

Print

3. Project Architecture

Go back to original configuration (Go Back).


Test new configuration (Test).
If no configuration changes are made, the only valid operation is Go Back.
The following paragraphs describe the operations that can be performed during online configuration. The buttons are
enabled and disabled depending on valid operations at each step. Informational messages appear beneath the online
configuration buttons indicating the state of the requested operation.
Test New Configuration
Clicking Test puts the backup controller into execute mode which places the new configuration in control of the process; the
original configuration is preserved within the primary-backup controller pair.
After testing the configuration, perform one of the following operations:

Accept new configuration (Accept).


Go back to original configuration (Go Back).
Make additional configuration changes (Additional).
NOTE: If there is an illegal new configuration, the original configuration will remain in control and the backup controller will go into error mode. Click Go Back to return the controller to configure mode.
Accept New Configuration
Clicking Accept exits online configuration mode with the new configuration in control of the process. The original
configuration in the other controller is replaced with the new configuration and the controller is put into execute mode.
Go Back to Original Configuration
Clicking Go Back returns the original configuration to the backup controller, puts the controller into execute mode, and exits
online configuration.
Make Additional Configuration Changes
Clicking Additional permits making configuration changes after testing a new configuration. The original configuration
(primary controller) is put back into control of the process and the test configuration (backup controller) is returned to the
configure mode.
Edit and download the test configuration and perform one of the following operations:

Test new configuration (Test).


Go back to original configuration (Go Back).
A message appears stating that because of the firmware revision, it is impossible to detect when the online configuration is
complete. Periodically examine the properties of the controllers to determine when they are returned to execute mode.

3.5.15.3 Miscellaneous Online Configuration Issues


When performing Online Configuration with BRC-300s and sending the reset command to the backup (by clicking Accept
the change), it may take up to a minute for the backup controller to reset.
If the backup HAC01 goes offline or fails during an online configuration of the HAC01, Composer hangs up waiting
indefinitely for the backup to come back online.
When online configuration is performed on an MFC04 and MFC05, the inspect window gives the type as MFC?, and the
online configuration utility shows an incorrect status (e.g., MFC03 rev L.). The net result is that the status will not be
received back from the module to help coordinate the online configuration process. Therefore, procedure B described in the
Online Configuration section of the Primary Interface manual (3BUA000272Rxxxx) must be used when performing online
configuration.
When using the automated online configuration function in Composer, the Test button gets highlighted as soon as the user
starts the download of the new configuration to the backup (i.e., as opposed to after it has completed the download).
Clicking Test before the download has completed can result in only part of the configuration being downloaded. In most
cases, this results in a module error condition. However, if only part of the newly added logic is downloaded and all of the
signal connection references used by the downloaded logic can be resolved, no error condition will exist. It will then be up to
the user during the test phase to verify that all of the newly added logic was loaded.

NOTE: To avoid this issue, the user should not select the test button until the download has completed.

3.5.16 Print
To print a copy of all the control logic documents located in a controller:

1.

3-16

Right click the controller and select Print.

2VAA000812R0001

3. Project Architecture

Properties

2.

Select the sheets to be printed (All, Range, or None (Cross-Reference Report Only)). The default To
field value is 99 when multiple CLDs are being printed. If this field is set to a value greater than the
number of sheets in a CLD being printed, all the sheets will be printed.

3.

Select the print quality, number of copies, destination (printer or file), number of copies, and if the
copies are to be collated.

4.

Select what is to be done with the cross reference report generated by the print operation. Exporting
it to a text file or printing it along with the control logic documents are the available options.

5.

Click Setup... to get to a standard Windows print setup dialog box. Configure the options as
necessary.

6.

Click Style... to configure how the control logic document is to be printed. The style setup dialog box
appears.

7.

On the entries tab of the style setup dialog box, select the specifications, tags, symbols, and cross
references to be printed.

8.

On the Layers tab, set the layers to be printed.

9.

On the Layout tab, set the margins, alignment, and scale of the control logic document.

10. On the Header/Footer tab, configure the header and footer using the codes provided.
11. Click OK.

3.5.17 Properties
The properties of a controller include:

Name.

Type.

Location.

Project name.

Configuration status.

Control network number.

Harmony control unit number.

Controller number.

Defined controller type, firmware level and status (only if connected to a run-time system).

Actual controller type, firmware level and status (only if connected to a run-time system).

Custom properties (job information) used.

Format.
To view or edit the properties of a controller, refer to Common Editing Functions for more information.

3.5.18 Reorder CLDs


The CLD arranger window displays the name and document number of all the control logic documents assigned to the
controller. Control logic documents are put at the end of the list as they are assigned to a controller. This utility allows control
logic documents to selected using standard Windows techniques and moved to a specific position in the list. Click OK to
make the current order of the selected controller permanent. To reorder the control logic documents within a controller:

1.

Select the controller containing the control logic documents being reordered.

2.

Select the control logic documents being moved.

3.

Drag one of the selected control logic documents until the cursor is on the control logic document just
below the new location and release the mouse button.

Select control logic documents that are not consecutive are extracted, placed in a sequential order, and inserted at the
specified location.

2VAA000812R0001

3-17

View Files

3. Project Architecture

3.5.19 View Files


To view a listing of the C program and data files residing in a controller, right click the controller and select Run Time > View
Files.
The ID, size, level of file protection, checkpoint status, error status, and checksum status of the C program and data files
located in the controller are displayed.

3.5.20 View Reports


To view a status or problem report from a controller (except for sequence of events controllers), right click the controller and
select Run Time > Reports > Status or Run Time > Reports > Problem.
To view a status or problem report from a sequence of events controller, right click the associated Harmony control unit and
select Reports > Status or Reports > Problem.
The requested information appears in the General tab of the output window. This output window can be disabled through
the view menu.

3.5.21 C Utility Program (CUP) Support in Composer


Since the 2.0 release of Composer, the CUP product is no longer necessary to maintain C program applications in a
Symphony system controller. Composer has the functionality required to prepare the C program to be loaded to the
controller as well as the functionality required to prepare the Controller to run and load C. Every effort was made to ensure
backward compatibility with pre-existing C programs. All programs and data files should migrate into Composer with
minimal effort.

NOTE: Most C programs developed for MFC and MFP controllers utilized version 4.5 or earlier of the Microtec compiler. Compiler version 5.0 and later treat the physical layout of structures (struct keyword) differently than the earlier
versions. C structures that define external interfaces (communication programs for example) that implement fixed
mapping to external devices must be reverified. Use the packed keyword and pad bytes within the structure to return
the original interface mapping. The n90.h file is an example of this.
The following CUP features are not supported:

The recompiling and relinking of C programs using the Lattice ES68 Development Systems. However, existing Lattice Program
LMS object files and NBS binary files can be loaded/reloaded into IMMFPxx controllers by Composer.

Support for IMMPI02 modules.

The File System Check Command utility (FSCK).

Cdebug support for BRC-300 controllers.

3.5.21.1 Steps Required to use C Programming in a Controller


1.

Separately purchase and install the appropriate Microtec C compiler (from Mentor
Graphics).

NOTE: Composer has been updated to support the BRC-300 controller which has the Coldfire processor. Previous
controllers utilized 68000-based processors. Use version 5.3 of the Coldfire compiler when BRC-300 controllers are
being utilized. Use version 5.1 of the 68000 compiler when previous controllers are being utilized.
When the compiler is installed, it sets up several environment variables and modifies the system path. This can be verified
from a DOS prompt using the SET command.
The following is a sample of what will typically be seen. If a different installation location is selected, the output will be
different from this sample. The important part is to verify that the entries exist and then match the installation choice.
LM_LICENSE_FILE=d:\mgc\embedded\license\license.dat
MRI_68K_BIN=d:\microtec\tools\bin
MRI_68K_INC=d:\Progra~1\ABB\Composer\Bin\Cup\include\
MRI_68K_LIB=d:\microtec\tools\lib\nze
MRI_CF_BIN=d:\mgc:\embedded\bin\
MRI_CF_INC=d:\Progra~1\ABB\Composer\Bin\Cup\include\
Path=C:\WINNT\system32;C:\WINNT;c:\ORANT\BIN;;
C:\EWS;d:\microtec\tools\bin;

NOTE: Environment variable MRI_68K_LIB is only required for IMMFC03 controllers. MRI_CF_BIN and
MRI_CF_INC are only required for BRC-300 controllers. MRI_CF_LIB is not required and should be left undefined.

3-18

2VAA000812R0001

3. Project Architecture

C Utility Program (CUP) Support in Composer

2.

Write the C program outside of Composer. To compile, use MCC.BAT (for all controllers prior to BRC300) or MCC_CF.BAT (for BRC-300 controllers) from a command prompt. These files invoke the
appropriate compiler with the correct option settings.

3.

Within the system architecture window of Composers primary interface, right click on the target
controller to display the controller pop-up menu and select Edit CSP file.

4.

Enter the CSP file data and save the .CSP file to disk. Each controller running C should have its own
.CSP associated with it. Composer does not manage .CSP files. It merely maintains a link to the
.CSP file associated with each controller.

5.

Stay in the .CSP file editor. After saving the .CSP file, link the .CSP file to produce the .LMS and
.MAP files that will eventually be loaded to the controller.

NOTE: Always verify (in the Edit CSP view) that the list of files to be linked is correct BEFORE linking. Delete any
incorrect or unrelated entries.
6.

Close the .CSP file editor. This associates the .CSP file name with the controller.

7.

From the controllers pop-up menu, select Properties > Format > Specification Source > CSP File

8.

The .CSP file name previously associated with the controller should already be in the edit control. If it
isn't, browse to the .CSP file and click OK.

9.

Click Format.

NOTE: The controller must be in CONFIGURE mode before its memory can be formatted. If the controller is in EXECUTE mode when Format is selected, confirm the mode change to CONFIGURE prior to the format operation. Be
certain that the process is in a safe state that will allow the controller to be taken offline.
10. A confirmation dialog will appear indicating that the controller was successfully formatted. Close the
property sheet.
11. From the controllers pop-up menu, select Run Time-View Files.
12. A new window containing all the files loaded in the controller will appear. An empty list view indicates
that no files have been loaded to the controller. In either case, right click on the background of the list
view and select the Load C menu item.
13. A file selection dialog will appear. Browse to the directory containing the .CSP file associated with the
controller.
14. Select the .MAP, .LMS, and .CSP files when prompted for each file.
15. Load any data files needed using the Load Data File menu item within the file directory view.
16. At this point, the controller has been formatted to run C, and all the necessary files have been loaded.
All that remains is to load the controllers function block configuration (.CFG file) and put the
controller into execute mode.

3.5.21.2 CUP File Locations


The CUP files are installed under the Composer Bin subdirectory. The Cup directory contains the batch files necessary to
use CUP. The Lib subdirectory includes the required libraries, and the Include subdirectory has the required header files.
Examples are located in the Examples subdirectory.

NOTE: The default Composer installation will install into C: drive, not the D: drive. If the drive or directory is changed
from the default values, modifications will have to be made to the MCC.BAT and MCL.BAT files used to invoke the
compiler and linker respectively.

3.5.21.3 MCL.BAT
LNK68K.EXE is assumed to be on the system path. If it isnt, hard code the path to the executable in the MCL.BAT file.

3.5.21.4 MCC.BAT and MCC_CF.BAT


If Composer has been installed into a drive or directory other than the default, locate the MCC.BAT or MCC_CF.BAT file on
the hard disk, remove the read-only attribute, edit the file in a text editor such as notepad.exe, and modify the highlighted
section to reflect the installation choice. The MCC.BAT file is used for controllers released prior to the BRC-300. The
MCC_CF.BAT file is used for BRC-300 controllers.

2VAA000812R0001

3-19

Miscellaneous Communication Issues

3. Project Architecture

3.5.21.5 CSP File Editor


When browsing for a .CSP file, the universal naming convention (UNC) syntax path to the file should normally be used. This
will allow multiple users from different computers to edit the .CSP file. Navigator saves the .CSP filename associated with
the Controller into the project when the editor is closed. If mapped drive letters are used, the path stored in the project may
not be usable at another computer because different computers can use different drive letters.
The standard library files required for controller specific functions are not required to be listed by the user. These libraries
are automatically added into the linker command file based on the module type entered in the CSP editor. These library files
are MFCLIB.OBJ, HACLIB.OBJ, or MFPLIB.OBJ depending on the controller type and BAILEY.LIB and MATHF.LIB or
BRLIB_CF.LIB (BRC-300).

NOTE: Fully qualified paths must be specified to the user-created object files.
The supplied files mfcmathf_fix.obj and mfpmathf_fix.obj are only required to resolve link issues when using the single
precision functions in MATHF.LIB.
When utilizing IMMFC03 controllers, use the nonexception (nze) version of the mcc68KAB.LIB file to resolve links. The
location of this library is specified by the MRI_68K_LIB environment variable.
The calculated values in the System RAM group do not automatically update when the underlying values are changed for
the calculation. To get the values to recalculate, click Apply. The calculated values will then be properly displayed.

3.5.22 Miscellaneous Communication Issues


When communicating to remote modules (via IPT02) with long communication delays, it may be necessary to set the
"Default" timeout value to a larger value. Composer first tries to check the module type when starting communication, in
order to determine which communication timeout values to use. If it times out when checking the module type (on extremely
slow connections) it will use the default timeout value of 8 seconds. We've added a "Default" timeout entry to the module
type list in the Tools > Options > Communications Timeouts dialog. Change this value to affect the timeout Composer uses
when trying to establish the module type. Note that this will not help if the ICI is timing out waiting for communication from
the remote controller (when "Timeout of Plant Loop Response" errors occur).
Composer may not complete the AMM03 calibration sequence successfully. The point being calibrated can be disabled, but
the calibration sequence cannot be completed. The workaround is to use existing tools (CTT02, WCAD, SCAD) to complete
an RTD input internal or external calibration.
The default communications time-out when using the GET ID option of the IOR-800 firmware download function may be too
short. If the IOR-800 had not fully reset yet, the BRC-100 will report that it could not find the device. Setting the
communications time-out for BRC-100 to a longer time-out can correct this.

3.6

Control Logic Templates


Control logic documents can be created one of two ways. They can be created with nothing in them or they can be created
from a control logic template which can contain control logic, specific document settings, template-to-document linking
settings, etc. Instructions on how to create and edit a control logic template, upgrade control logic documents created from
the template to match it, restore an edited control logic document to match the template used to create it, and edit
configuration settings of the template follow. The properties of a control logic template are also described. Refer to the
Automation Architect instruction for more detailed information about linking.

NOTES:
1. Basic control logic documents (not created from a control logic template) use an icon with a white background.
2. Basic control logic documents that are CLD-locked use a key icon with a white background.
3. Control logic documents created from a template but are not linked use an icon with a blue background.
4. Control logic documents created from and linked to a template use a chain links icon with a blue background.
5. Control logic documents that are created from a template and are CLD-locked use a key icon with a blue background.

3.6.1 Configure Settings


To configure settings in the control logic template and perform certain actions to the unlocked control logic documents linked
to it:

3-20

1.

Right click the control logic template and select Actions... from the pop-up menu.

2.

Select the desired view mode and establish any document filters in the control logic template actions
dialog box. The listing of control logic documents can be sorted by name, address, order number,
linked status, revision level, date last updated, and date last modified by selecting the column
heading.

2VAA000812R0001

3. Project Architecture

Create

3.

If desired, select one or more of the listed control logic documents (created from the template) and
use the link, unlink, upgrade, or branch functionality.

4.

If necessary, click Cancel to exit the dialog box.

To change the default link setting (in control logic template) for all subsequently created control logic documents:

1.

Right click the control logic template and select Properties from the pop-up menu.

2.

Enable or disable the link new CLDs on instantiation setting in the properties dialog box.

3.

Click OK.

3.6.2 Create
To create a new control logic template:

1.

Open the exchange folder that will contain the new template.

2.

Right click empty space in the exchange window and select New > Control Logic Template.

3.

Enter the control logic template name.

4.

Specify the type (and firmware revision) of controllers that will use the control logic documents
created with this template.

5.

Set the default link status for all control logic documents created from this template.

6.

Click OK.

3.6.3 Edit
Control logic templates are created from within the Composer window but they are edited within the automation architect
window. To edit a control logic template, right click the document and select Open. The automation architect window is
opened with control logic template in a document window.

3.6.4 Primary Versus Local


A control logic template that is created in a project is considered a primary control logic template within that project. A
control logic template that is copied into a project is considered a local control logic template within that project. Local
control logic templates maintain a link (knowledge of the template from which it was copied) to the primary control logic
template from which it originated. Control logic documents created from a primary control logic template are directly linked
to that template. Control logic documents created from a local control logic template are indirectly linked (through the local
control logic template) to the primary control logic template.
Changes made to a primary control logic template are propagated to local copies of the control logic template by copying
the primary control logic template into the local copies of the control logic template. Use the standard linking functions to
further propagate the changes to any control logic documents created from the local control logic template.
It is possible to move (ALT-drag and drop) primary control logic templates from one project to another and not lose any links
to local control logic templates or control logic documents created from it. When a primary control logic template is moved to
another project, the primary control logic template in the source project becomes a local copy that is linked to the primary
now residing in the destination project. All control logic documents that were linked to the primary control logic template are
now linked to the local copy. If a local copy of the template already exists in the destination project prior to the move, it is
updated and becomes the primary control logic template. All control logic documents that were linked to the local control
logic template in the destination project are now linked directly to the primary control logic template.

3.6.5 Properties
The properties of a control logic template include:

Name.

Type.

Location.

Project name.

Status.

Revision.

System (if supplied with Composer).

Target controller type and firmware revision.

2VAA000812R0001

3-21

Restore

3. Project Architecture

To view or edit the properties of a control logic template, refer to Common Editing Functions for more information.

3.6.6 Restore
To restore an unlocked control logic document to a condition identical to that of the template used to create it:

1.

Right click the control logic document and select Template Linking from the pop-up menu.

2.

Click Restore in the CLD template linking status dialog box.

3.

Enable the appropriate conflict resolution and log options in the restore dialog box.

4.

Click Start.

3.6.7 Update
To upgrade all the unlocked control logic documents in a controller with information from the control logic template used to
create it:

1.

Right click the controller and select Upgrade All CLDs... from the pop-up menu.

2.

Enable the appropriate conflict resolution and log options in the upgrade dialog box.

3.

Click Start.

To upgrade an unlocked control logic document with information from the control logic template used to create it:

3.7

1.

Right click the control logic document and select Template Linking from the pop-up menu.

2.

Click Upgrade in the CLD template linking status dialog box.

3.

Enable the appropriate upgrade options in the upgrade dialog box.

4.

Click Start.

Control Logic Documents


A controller configuration (configuration file) is derived from control logic documents. These control logic documents form
the basis of a process control system. Instructions on how to check signal connections to, create, edit, review the revision
history of, print, view the status of, and automatically address the function blocks contained within a control logic document
follow. The properties of a control logic document are also described. Refer to Common Editing Functions for information
about copying, deleting, moving, viewing the properties of, verifying, viewing the function code configuration of,
synchronizing the tags of, transferring tag and specification data in or out of, and renaming a control logic document.

NOTES:
1. Basic control logic documents (not created from a control logic template) use an icon with a white background.
2. Basic control logic documents that are CLD-locked use a key icon with a white background.
3. Control logic documents created from a template but are not linked use an icon with a blue background.
4. Control logic documents created from and linked to a template use a chain links icon with a blue background.
5. Control logic documents that are created from a template and are CLD-locked use a key icon with a blue background.

3.7.1 Automatic Function Block Addressing


The block address manager utility provides the ability to automatically give new function block addresses to the function
codes contained in the selected control logic documents. Block number related specifications (for example, specification
two of the adapt function code) are updated at the same time.
This utility can operate on all the control logic documents within a controller, multiple control logic documents within the
same controller, or a single control logic document. All function codes within the selected control logic documents that have
function block addresses are shown in a block map table. Use the legend provided to determine how the function codes are
addressed. The block addresses associated with each function code are color-coded to show if the function code was:

Manually assigned an address that is to be retained on a sheet designated as user assigned.

Assigned an address manually or automatically according to a predefined relative order on a sheet designated as relative.

Assigned an address manually or automatically that is subject to re-assignment according to position within the control logic document.

3-22

2VAA000812R0001

3. Project Architecture

Automatic Function Block Addressing

If a function code spans multiple block addresses, the second through last block addresses are displayed in a lighter color.
This aids in determining which blocks are associated with a function code.
Three tabs are provided in the output area at the bottom of the dialog box. The operation tab lists errors, warnings, and
information messages regarding the processing of block management functions. The context tab displays the project,
control network, Harmony control unit, and controller names. Also displayed is the mapping between control logic document
name and the number displayed on the block map. The block map tab lists information related to creating the block map
table. Duplicate addresses are detected and displayed in this tab when the block map table is initially created and whenever
it is refreshed (for example, when executing a menu option).
If properly configured, changes to function block addresses are propagated back to any other function codes in any control
logic documents within the controller that references that address.
When using one of the automatic numbering functions (while preserving the relative order), function codes without function
block addresses are assigned addresses according to the following rules:

Unaddressed function codes located between (as defined by top to bottom, left to right positioning) addressed function codes are
given the next available addresses (based on their positional order) that are greater than that of the preceding function code.

Unaddressed function codes located at the beginning of a sheet (as defined by top to bottom, left to right positioning) are given the
lowest block address (based on their positional order) on the sheet.

Unaddressed function codes located at the end of a sheet (as defined by top to bottom, left to right positioning) are given the next
available addresses (based on their positional order) that are greater than that of the preceding function code.

Example:
A sheet contains nine single block output function codes. These function codes have block addresses of (listed by top to
bottom, left to right position) unassigned, 105, 100, unassigned, 120, 125, unassigned, 104, and unassigned. The automatic
renumbering of all block addresses function and a starting address of 100 are set. The resulting block addresses are 100,
105, 101, 102, 106, 107, 108, 103, and 104.

NOTES:
1. Function codes 81 (executive) and 90 (extended executive) are not affected by this utility.
2. Sheets containing the text BLK.ORDER=USER-ASSIGNED are not affected by the automatic addressing, offsetting, or clearing functions of this utility.
3. Sheets containing the text BLK.ORDER=RELATIVE are automatically addressed according to the current relative
order regardless of the order type selected.
4. Sheets containing the text BLK.ORDER=POSITION are automatically addressed according to the position
regardless of the order type selected.
5. Sheets without any BLK.ORDER= specification text are shown on the block map using the same color code as
sheets containing the text BLK.ORDER=POSITION.

3.7.1.1 Address All Function Codes Not Already Addressed


This automatic numbering function applies only to function codes that do not have function block addresses assigned to
them. Previously addressed function codes have no effect on this function.
Example:
A control logic document contains five function codes (FC 66, FC 33, FC 66, FC 33, and FC 66) with block addresses of
unassigned, 500, unassigned, 510, and unassigned respectively. A starting block address of 2000 is set. The resulting block
addresses would be 2000, 500, 2001, 510, and 2002 respectively.
To assign function block addresses:

1.

Select Operations > Auto Block > All except FCs with valid Block Addresses.

2.

In the Starting Block Address field, enter the desired target address for the first (lowest) readdressed
function block from the selected control logic documents.

3.

The top to bottom, left to right order option is preselected because unassigned blocks have no
previous relative order.

4.

Verify the auto blocking options are correctly set. If they are correct, proceed to Step Step 8. If not
correct, proceed to the next step.

5.

Click Change Options....

2VAA000812R0001

3-23

Automatic Function Block Addressing

3. Project Architecture

6.

In the spares dialog box, set the location of spares (empty function blocks) and any special
addressing conditions (multipliers) for the first function block of each sheet and control logic
document.

7.

Click OK.

8.

Enable the using text to indicate adapted spec # option if it is desirable to automatically set
specification three of the adapt function code to the specification number indicated in a text string
within the adapt function block or at the end of the tuning line. Only use this option if this convention
is being used because it increases the time required to process the function blocks.

9.

Click OK.

3.7.1.2 Print Function Block List


This function makes it possible to print a complete or partial listing of the function blocks used in the selected control logic
document.
To print a complete listing:

1.

Select File > Print.

2.

Verify the information in the standard Windows print dialog box is correct and click OK.

To print a partial listing:

1.

Select the portion of the block map table containing the desired function blocks.

2.

Select File > Print.

3.

Verify the information in the standard Windows print dialog box is correct and click OK.

3.7.1.3 Readdress All Function Codes


To give all function codes in the selected control logic document new function block addresses:

3-24

1.

Select Operations > Auto Block > All Address.

2.

In the Starting Block Address field, enter the desired target address of the first (lowest) re-addressed
function block from the selected control logic documents.

3.

Enter the type of order to be used when giving new addresses. The top to bottom, left to right option
is a positional order in which the top left most function code will receive the lowest function block
address and (working down and to the left) the bottom right most function code will receive the
highest block number. The follow existing relative order on drawings option maintains the existing
relative order between function codes while readdressing.

4.

Verify the auto blocking options are correctly set. If they are correct, proceed to Step Step 9. If not
correct, proceed to the next step.

5.

Click Change Options....

6.

In the spares dialog box, set the location of spares (empty function blocks) and any special
addressing conditions (multipliers) for the first function block of each sheet and control logic
document.

7.

Click OK.

8.

Enable the using text to indicate adapted spec # option if it is desirable to automatically set
specification three of the adapt function code to the specification number indicated in a text string
within the adapt function block or at the end of the tuning line. Only use this option if this convention
is being used because it increases the time required to process the function blocks.

9.

Click OK.

2VAA000812R0001

3. Project Architecture

Automatic Function Block Addressing

3.7.1.4 Readdress All Non-Exception Report Function Codes


This automatic numbering function applies to all function codes (excluding exception report function codes with assigned
block addresses). The following table lists the exception report function codes.

Table 3-3 Exception Report Function Codes


Number

Description

30

Analog exception report (AO/L)

45

Digital exception report (DO/L)

48

Analog Exception Report with High/Low Alarm Deadband (AOLDB)

62

Remote control memory (RCM)

67

Digital Exception Report with Alarm Deadband (DOLDB)

68

Remote manual set constant (RMSC)

80

Control Station (M/A MFC/P)

123

Device driver (DD)

129

Multistate device driver (MSDD)

136

Remote motor control (RMC)

151

Text selector (TEXT)

177

Data acquisition analog (DAANG)

179

Enhanced trend (ETREND)

194

User defined data export (DATA EXPT)

211

Data acquisition digital (DADIG)

218

Phase execution (PHASEX)

222

Analog in/channel (IOC/AIN)

223

Analog out/channel (IOC/AOUT)

224

Digital in/channel (IOC/DIN)

225

Digital out/channel (IOC/DOUT)

229

Pulse/in channel

Example:
A selected control logic document contains five function codes (FC 35, FC 45, FC 39, FC 38, and FC 39) with block
addresses of 500, 200, unassigned, 510, and 508 respectively. A starting block address of 300 and the relative order option
are set. The resulting block addresses would be 300, 200, 301, 303, and 302 respectively.
To give all function codes new function block addresses:

1.

Select Operations > Auto Block > All except existing Exception Report Blocks.

2.

In the Starting Block Address field, enter the desired target address of the first (lowest) readdressed
function block from the selected control logic documents.

3.

Enter the type of order to be used when giving new addresses. The top to bottom, left to right option
is a positional order in which the top left-most function code will receive the lowest function block
address and (working down and to the left) the bottom right-most function code will receive the
highest block number. The follow existing relative order on drawings option maintains the existing
relative order between function codes while readdressing.

4.

Verify the auto blocking options are correctly set. If they are correct, proceed to Step Step 9. If not
correct, proceed to the next step.

5.

Click Change Options....

2VAA000812R0001

3-25

Check Signal Connections

3. Project Architecture

6.

In the spares dialog box, set the location of spares (empty function blocks) and any special
addressing conditions (multipliers) for the first function block of each sheet and control logic
document.

7.

Click OK.

8.

Enable the using text to indicate adapted spec # option if it is desirable to automatically set
specification three of the adapt function code to the specification number indicated in a text string
within the adapt function block or at the end of the tuning line. Only use this option if this convention
is being used because it increases the time required to process the function blocks.

9.

Click OK.

3.7.1.5 Readdress Function Codes Using An Offset


This function makes it possible to give function codes new function block addresses based on an offset value or a new
starting block address.
To give function codes new function block addresses:

1.

Select Operations > Offset.

2.

In the offset options dialog box, enter the function block address from which the offset function will
start in the Start Offset at Block Address field. This field is defaulted to the lowest block address found
in the selected control logic documents.

3.

Choose to offset the block addresses by adding a certain number of block addresses or by specifying
the address of the new first function block. All subsequent function block addresses are changed by
the same value as that used when offsetting the first function block.

4.

Click OK.

3.7.1.6 Remove Address From All Function Codes


This function removes the function block addresses of all function codes in the selected control logic documents.
To remove function block addresses:

1.

Select Operations > Clear.

2.

Confirm if sheets containing the text BLK.ORDER=RELATIVE are to be cleared and click OK in the
dialog box.

NOTES:
1. This function will remove all concepts of relative order from the control logic document.
2. The specifications of other function codes that refer to a cleared function block number are set to their default
value.

3.7.1.7 Synchronize Addresses And Specifications


Using this function, each function code in the selected control logic documents having references to block addresses (even
those not contained in the selected control logic documents) will have their specifications tuned to the appropriate address
as long as the tuning lines are properly configured. Specification three of each adapt function block in the selected control
logic documents will be tuned to the specification number indicated in a text string within the adapt block or at the end of the
tuning line.
To update function code specifications, select Operations > Synchronize Specs.

3.7.2 Check Signal Connections


This function checks for unrecognized signal to function code connector conditions (the connector appears to have a signal
attached to it but Composer does not think they are connected). This can happen when upgrading control logic documents
from older versions of Composer (Wintools).
To check the signal connections to and from connectors on a control logic document, right click the control logic document
or any project structure object that contains the control logic document and select CLD Connection Check.
The output window shows the results of the check. A warning is generated for every unrecognized signal to connector
condition.
To correct a warning:

3-26

1.

Double click the warning. This opens the control logic document and properly interconnects
the signal and connector.

2.

Verify the connections are correct and save the control logic document.
2VAA000812R0001

3. Project Architecture

Create

It is recommended to perform this function on individual or small groups of control logic documents because checking for
these conditions make take a long period of time.

3.7.3 Create
To create a new (empty or base) control logic document that can not be associated with a control logic template:

1.

Right click the controller and select New > Logic Document....

2.

Enter the new control logic document name in the dialog box and click OK.

NOTE: Using the following special characters in CLD names may cause errors (pack and/or unpack) when publishing
them for View and Monitor sites:
/ (forward slash)
\ (back slash)
(double quotes)
* (asterisk)
@ (at sign)
- (hyphen)
| (pipe)
: (colon)
< (less than)
> (greater than)
? (question mark)
To create a new control logic document using a control logic template:

1.

Open the exchange folder containing the control logic template.

2.

Drag the control logic template from the exchange window and drop it on the controller that will
contain the new control logic document.

A control logic document with the same name as the control logic template appears in the right side of the system
architecture window.

3.7.4 Edit
Control logic documents are created from within the Composer window but they are edited within the automation architect
window. To edit a control logic document, right click the document and select Open. The automation architect window is
opened with control logic document in a document window.

3.7.5 Export
Logic entity information from control logic documents within the selected Composer entity (project, control network,
Harmony control unit, controller, or control logic document) can be exported to a database outside of the Composer project.
The types of logic entities that can be exported are function codes, constant blocks, text, input references, and output
references. Tag and function code information can also be exported in a comma separated value text format.

Table 3-4 Exportable Function Code Properties


Property

2VAA000812R0001

Type

Description

BlkNum

Number Function code block address.

CLDguid

Text

Unique identifier of the CLD within the project.

CLDname

Text

Name of the CLD containing the entity.

FCDesc

Text

Function code description.

FCName

Text

Entity name.

FCNum

Number Function code number.

Layer

Number Number of the layer containing the entity.

ObjID

Number Unique identifier of the entity within the CLD.

SheetNum

Number Unique identifier of the sheet within the CLD.


3-27

Export

3. Project Architecture

Table 3-4 Exportable Function Code Properties (Continued)


Property

Type

Description

Spec 1 through
60

Number Specification 1 through specification 60 as defined in the


function code manual. Specifications that contain strings are
null. The StringSpec1 and StringSpec2 fields should be
accessed for these values.

StringSpec1 &
StringSpec2

Text

Text for function code specifications that are of the type


string. StringSpec1 is the first string specification for a
function code and StringSpec2 is the second string
specification.

TagGuid

Text

GUID of the tag associated with this entity.

TagName

Text

Name of the tag associated with this entity.

Xcoord

Number Absolute (not relative to the border) X coordinates of the


entity insertion point (origin).

Ycoord

Number Absolute (not relative to the border) Y coordinates of the


entity insertion point (origin).

Table 3-5 Exportable Constant Block Properties


Property

Type

Description

BlkNum

Number Function code block address.

CLDguid

Text

Unique identifier of the CLD within the project.

CLDname

Text

Name of the CLD containing the entity.

Layer

Number Number of the layer containing the entity.

Name

Text

ObjID

Number Unique identifier of the entity within the CLD.

SheetNum

Number Unique identifier of the sheet within the CLD.

Xcoord

Number Absolute (not relative to the border) X coordinates of the


entity insertion point (origin).

Ycoord

Number Absolute (not relative to the border) Y coordinates of the


entity insertion point (origin).

Entity name.

Table 3-6 Exportable Text Properties


Property

3-28

Type

Description

CharSize

Number Character size in Automation Architect units.

CLDguid

Text

Unique identifier of the CLD within the project.

CLDname

Text

Name of the CLD containing the entity.

Layer

Number Number of the layer containing the entity.

ObjID

Number Unique identifier of the entity within the CLD.

Orientation

Number Orientation in 90 degree increments.

SheetNum

Number Unique identifier of the sheet within the CLD.

TextName

Text

Entity name.

TextValue

Text

Text value.
2VAA000812R0001

3. Project Architecture

Export

Table 3-6 Exportable Text Properties (Continued)


Property

Type

Description

Xcoord

Number Absolute (not relative to the border) X coordinates of the


entity insertion point (origin).

Ycoord

Number Absolute (not relative to the border) Y coordinates of the


entity insertion point (origin).

Table 3-7 Exportable Input Reference Properties


Property

Type

Description

CLDguid

Text

Unique identifier of the CLD within the project.

CLDname

Text

Name of the CLD containing the entity.

FCNum

Number Function code number.

I/Onum

Number Identifier of which input of the function code containing one


or more IRefs is associated with this IRef. This information is
useful when working with function code 64 (digital input list).

Layer

Number Number of the layer containing the entity.

Name

Text

ObjID

Number Unique identifier of the entity within the CLD.

RefEntity

Number Address value referencing the logic entity receiving the


output of this entity.

SheetNum

Number Unique identifier of the sheet within the CLD.

XRefGuid

Text

Xcoord

Number Absolute (not relative to the border) X coordinates of the IRef


entity insertion point (origin).

XRefDesc

Text

Ycoord

Number Absolute (not relative to the border) Y coordinates of the IRef


entity insertion point (origin).

Entity name.

Unique identifier for this cross-reference within the project.

Cross-reference description.

Table 3-8 Exportable Output Reference Properties


Property

2VAA000812R0001

Type

Description

CLDguid

Text

Unique identifier of the CLD within the project.

CLDname

Text

Name of the CLD containing the entity.

Layer

Number Number of the layer containing the entity.

Name

Text

ObjID

Number Unique identifier of the entity within the CLD.

RefEntity

Number Address value referencing the logic entity sourcing the input
to this entity.

SheetNum

Number Unique identifier of the sheet within the CLD.

XRefDesc

Text

Cross-reference description.

XRefGuid

Text

Unique identifier for this cross-reference within the project.

Entity name.

3-29

Export

3. Project Architecture

Table 3-8 Exportable Output Reference Properties (Continued)


Property

Type

Description

Xcoord

Number Absolute (not relative to the border) X coordinates of the


ORef entity insertion point (origin).

Ycoord

Number Absolute (not relative to the border) Y coordinates of the


ORef entity insertion point (origin).

Table 3-9 Exportable Tag and Function Code Properties


Property

Type

Description

Block

Number Function code address.

CLDFilename

Text

File system name of the CLD.

CLDname

Text

Name of the CLD containing the entity.

FCName

Text

Name of the function code.

FCNum

Number Number of the function code.

Loop

Number Loop number.

Module

Number Module number.

PCU

Number PCU number.

SheetNum

Number Unique identifier of the sheet within the CLD.

Spec 1 through
60

Text

Specification 1 through specification 60 as defined in the


function code manual.

TagDesc

Text

Description of the tag associated with this entity.

TagName

Text

Name of the tag associated with this entity.

To export logic entity information:

1.

Select the Composer entity containing the control logic document (or control logic template)
that contains the logic entity information in the Composer window.

2.

Select Tools > CLD Export....

3.

Select the type of database that will receive the exported information in the DB Type field.

4.

Accept the displayed database or file (Text (CSV) database type selected) name and path or enter a
new name and path in the DB Full Name field. Appropriate extensions (.mdb, .xls, or .csv) are
automatically added to database and file names not containing one. If the specified database or file
does not exist, it will be created.

NOTE: The .TXT file name extension can be used when the Text (CSV) database type is chosen.
5.

Select the type of entity supplying the information being exported in the Table Names area. The
names of the created tables are shown in parentheses.

6.

Enable the Clear Existing Tables option to delete the contents of existing tables prior to the export
operation. Disabling this option causes the exported information to be appended to the information
present in existing tables.

7.

Click OK. The export status is displayed in the CLD Export window.

CLD Export may fail to start if the user workstation is set to a locale that uses the comma (,) instead of a decimal point (.) as
the decimal number separator character.
One possible workaround is to modify the specific Schema.ini file of the output file.
Each file output by Composer in the CSV format goes through the Microsoft Text driver. That driver creates a file called
schema.ini in the same directory as the output file. In the schema.ini file is a section heading for the file, e.g.:

[cldexport.txt]
3-30

2VAA000812R0001

3. Project Architecture

Import

And there are settings specific to that file in that section. The one of interest is the format setting:

Format=CSVDelimited
Change this to:

Format=Delimited(;)
to use semicolons as the separators.
Changing the schema.ini file is not enough, however. The Clear Existing Tables option in the CLD Export window must also
be disabled, otherwise the schema.ini settings are lost and/or overwritten.
The process would be:

a. Copy an exported file from one machine which is configured for a locale that uses the decimal point as decimal separator to
the machine using the desired locale setting
b.

Edit the file:

1) Remove all previous output data, leaving just the


first line which contains the field headers.
2) Changing the commas to semicolons in the header
line.
c. Modify the schema.ini file (either change the section for that file name, copy the schema.ini along with the exported file to
the target machine, or create the file from scratch). Change the line Format=CSVDelimited to Format=Delimited(;) or other separator if desired.
d.

When running the CLD Export tool in Composer, disable the Clear Existing Tables option before exporting.
This should use the semicolons as field separators and allow the tool to run on the target machine. Some issues with this
approach:

a. It must be followed for each output file name used. If you only output to CLDEXPORT1.TXT, then it should be fine, but if
different file names are desired, it could become inefficient.
b. It results in a file that is not in the same exact format as those generated by the tool on machines using the decimal point as
decimal separator. If these output files are to be exchanged with people not expecting semicolons, the output may need to be
edited.
When exporting CLDs containing function code 78 which is only used by the AMM03 modules, error message 3265 ADO
could not find the object in the collection corresponding to the name or ordinal reference requested by the application. (Error
occurred attempting to update field Spec61) is displayed. CLDs containing this particular function code can not be exported.
They must be edited in the Automation Architect.
When exporting CLDs with a target database of Excel, an ADO error stating ADO could not find the specified provider may
be displayed. If this occurs, reload MDAC 2.1 and try again. MDAC 2.1 can be found on the Composer CD disk in the
MDAC 2.1 directory.

3.7.6 Import
Logic entity information can be imported from a database outside of the Composer project to control logic documents within
the selected Composer entity (project, control network, Harmony control unit, controller, or control logic document). The
types of logic entities that can be imported are function codes, constant blocks, text, input references, and output
references. All errors generated during the import operation are displayed in an error window. If errors do exist, it is possible
to import the correct data only or exit this utility. In either case, correcting the database and trying the import utility again are
suggested.

Table 3-10 Importable Function Code Properties


Property

2VAA000812R0001

Type

Description

FCName

Text

Entity name.

Layer

Number Number of the layer containing the entity.

3-31

Import

3. Project Architecture

Table 3-10 Importable Function Code Properties (Continued)


Property

Type

Description

Spec 1 through
60

Number Specification 1 through specification 60 as defined in the


function code manual. Only changes to specifications that
are not driven by a signal line will be imported (for example,
a change to S1 of FC30 will be ignored during import).
Specifications that contain strings are null. The StringSpec1
and StringSpec2 fields should be accessed for these values.

StringSpec1 &
StringSpec2

Text

Text for function code specifications that are of the type


string. StringSpec1 is the first string specification for a
function code and StringSpec2 is the second string
specification.

TagName

Text

Name of the tag associated with this entity. An existing tag


name can not be changed but one can be added if it did not
already exist. If the added tag name is already defined in the
Composer database, the function code is automatically
linked to the Composer database.

Xcoord

Number Absolute (not relative to the border) X coordinates of the


entity insertion point (origin).

Ycoord

Number Absolute (not relative to the border) Y coordinates of the


entity insertion point (origin).

Table 3-11 Importable Constant Block Properties


Property

Type

Description

Layer

Number Number of the layer containing the entity.

Name

Text

Xcoord

Number Absolute (not relative to the border) X coordinates of the


entity insertion point (origin).

Ycoord

Number Absolute (not relative to the border) Y coordinates of the


entity insertion point (origin).

Entity name.

Table 3-12 Importable Text Properties


Property

3-32

Type

Description

CharSize

Number Character size in Automation Architect units.

Layer

Number Number of the layer containing the entity.

Orientation

Number Orientation in 90 degree increments.

TextName

Text

Entity name.

TextValue

Text

Text value.

Xcoord

Number Absolute (not relative to the border) X coordinates of the


entity insertion point (origin).

Ycoord

Number Absolute (not relative to the border) Y coordinates of the


entity insertion point (origin).

2VAA000812R0001

3. Project Architecture

Print

Table 3-13 Importable Input Reference Properties


Property

Type

Description

Layer

Number Number of the layer containing the entity.

Name

Text

Xcoord

Number Absolute (not relative to the border) X coordinates of the IRef


entity insertion point (origin).

XRefDesc

Text

Ycoord

Number Absolute (not relative to the border) Y coordinates of the IRef


entity insertion point (origin).

Entity name.

Cross-reference description.

Table 3-14 Importable Output Reference Properties


Property

Type

Description

Layer

Number Number of the layer containing the entity.

Name

Text

Xcoord

Number Absolute (not relative to the border) X coordinates of the


ORef entity insertion point (origin).

XRefDesc

Text

Ycoord

Number Absolute (not relative to the border) Y coordinates of the


ORef entity insertion point (origin).

Entity name.

Cross-reference description.

To import logic entity information:

1.

Select the Composer entity containing the control logic document (or control logic template)
that will receive the imported logic entity information in the Composer window.

2.

Select Tools > CLD Import....

3.

Select the type of database that is the source of the imported information in the DB Type field.

4.

Accept the displayed database or file (Text (CSV) database type selected) name and path or enter a
new name and path in the DB Full Name field. Appropriate extensions (.mdb, .xls, or .csv) are
automatically added to database and file names not containing one. If the specified database or file
does not exist, it will be created.

NOTE: The .TXT file name extension can be used when the Text (CSV) database type is chosen.
5.

Select the type entity supplying the information being exported in the Table Names area. The names
of the created tables are shown in parentheses.

6.

Click OK. The export status is displayed in the CLD Export window.

3.7.7 Print
To print a control logic diagram:

1.

Right click the control logic document and select Print.

2.

Select the print range in the print dialog box.

3.

Select the print quality, number of prints, if they are to be collated, and if they are printed to a file.

4.

Select what is to be done with the cross reference report generated by the print operation. Exporting
it to a text file or printing it along with the control logic document are the available options.

5.

Click Setup... to get to a standard Windows print setup dialog box. Configure the options as
necessary.

2VAA000812R0001

3-33

Properties

3. Project Architecture

6.

Click Style... to configure how the control logic document is to be printed. The style setup dialog box
appears.

7.

On the entries tab of the style setup dialog box, select the specifications, tags, symbols, and cross
references to be printed.

8.

On the layers tab, set the layers to be printed.

9.

On the layout tab, set the margins, alignment, and scale of the control logic document.

10. On the header/footer tab, configure the header and footer using the codes provided.
11. Click OK.

3.7.8 Properties
The properties of a control logic document include:

Name.

Type.

Location.

Project name.

Status.

Control network address.

Harmony control unit address.

Controller address.

To view or edit the properties of a control logic document, refer to Common Editing Functions for more information.

3.7.9 Review History


Composer keeps a history of all the revisions (snapshots) made to a control logic document. A listing of all revisions is
displayed by right clicking the control logic document and selecting Show History. The listing is also available by selecting
File > Show History from any Automation Architect window containing the opened control logic document. The control logic
document revisions window appears. From this window, it is possible to make the present document identical to, create, or
to delete a revision.

3.7.9.1 Change Revision


To make the current control logic document identical to a past revision, select a revision from the list provided in the control
logic document history window and click Rollback.

3.7.9.2 Create Revision


To save a copy (snapshot) of the latest saved version of the current revision (the working copy) of a control logic document:

1.

Click Generate Revision.

2.

Enter a comment that will uniquely identify this revision (snapshot) from other revisions and click OK.

At the moment a revision is generated, the date and comment of the current revision (the working copy) and newly
generated revision are exactly the same. The date and comment of the current revision will not change until the comment is
changed manually (click Edit Current Desc). It is recommended that the comment of the current revision be changed to help
distinguish it from the last revision created from it.

3.7.9.3 Delete Revision


To delete a revision from the history of a control logic document, select the revision to be deleted from the list provided in
the control logic document history window and click Delete.

3.7.10 Status
To view the status of a control logic document:

3-34

1.

Right click the control logic document and select Template Linking > Status... from the popup menu.

2.

View the control logic document and template revision, notification if upgrading is required (the
template it is linked to has changed), linked status, and locked status in the dialog box.
2VAA000812R0001

3. Project Architecture

3.

3.8

Configuration File

Click OK.

Configuration File
Compiling a controller processes control logic documents into a file (filename.cfg) the controller can understand and
execute. Instructions follow on how to load a configuration (and/or program files) from the Composer project to the controller
and how to save the configuration file and/or program files from a controller. Program files are C, BASIC, or batch programs
used in the configuration. The properties of a configuration file are also described. Refer to Common Editing Functions for
information about deleting, viewing the properties of, verifying, and viewing the function codes used by a configuration file.

3.8.1 Load to Controller


To download the current controller configuration file (and/or program files) to a controller:

1.

Right click the controller or click directly on the configuration file and select Run Time >
Load To Controller....

2.

Select the type of information to download (Configuration, Program Files, or Both) and click OK.

3.8.2 Properties
The properties of a control logic document include:

Name.

Type.

Location.

Project name.

Status.

Control network address.

Harmony control unit address.

Controller address.

To view or edit the properties of a configuration file, refer to Common Editing Functions for more information.

3.8.3 Review History


Composer keeps a history of all the revisions (snapshots) made to a configuration file. A listing of the previous revisions is
displayed by right clicking the configuration file and selecting Show History.... The configuration file revisions window
appears. From this window, it is possible to make the present file identical to, or to delete, a revision. This same functionality
is provided for program files, which are closely associated with configuration files.

3.8.3.1 Change Revision


To make the current configuration or program file identical to a past revision select a revision from the list provided in the
revisions window and click Rollback.

3.8.3.2 Delete Revision


To delete a revision from the history of a configuration or program file, select the revision to be deleted from the list provided
in the revisions window and click Delete.

3.8.4 Save from Controller


To save the configuration file and/or program files currently executing in the controller:

1.

Right click the controller and select Run Time > Save From Controller....

2.

Select the type of information to save (Configuration, Program/File System Blocks, or Both) in the
save controller configuration dialog box.

3.

If the configuration file is to be saved, choose to overwrite the current or create a new configuration
file within Composer. Enter the current or new configuration file name (as applicable).

4.

If the program files are to be saved (to a single file), choose to overwrite the current or create a new
program file within Composer. Enter the current or new program file name (as applicable).

5.

Click OK.

2VAA000812R0001

3-35

Global Save/Load/Verify

3. Project Architecture

3.8.5 Global Save/Load/Verify


The Global Save/Load/Verify (GSLV) feature allows scripts of instructions to be created to perform save, load, and verify
operations on controller configurations. The scripts are text files that contain the commands listed in GSLV Script
Commands. Scripts can be run from within Composer or scheduled to run automatically via the Windows scheduling
mechanisms.
The GSLV application shares the common ICI configuration information on the client machine. The information can be
edited through the Navigators existing Runtime|Configure menu or through the Runtime|Configuration menu available in
the GSLV application. When running, GSLV manages its own connection to the communications server and is not
dependent on a running instance of Composer. This allows it to be operated in a stand-alone fashion via the Windows
scheduler.
Scheduling the execution of GSLV scripts can be accomplished with the Windows 2000 Scheduled Tasks or the Windows
NT AT command. Refer to the operating system documentation for more information about these scheduling features. The
program to run is GSLV.EXE in the Composer\bin directory, and the /exec parameter must be included to execute the
specified script.
The commands to run a GSLV script are as follows:

path-to-Composer\bin\GSLV.EXE /exec pathname


- or -

path-to-Composer\bin\GSLV.EXE /execexit pathname


where
path-toComposer
pathname

Drive and path of the Composer


directory.
Path and filename of the GSLV script to
execute.
Using /exec will execute the script and leave GSLV open so the output window contents are available for review. Using
/execexit can be used when running the script via the Windows scheduler. It will run the script and then close GSLV. The
output window contents can be saved to a file with the
SaveOutputWindow command.

NOTE: Simultaneous execution of multiple GSLV scripts may cause conflicting access to the same controller. The
GSLV utility does not attempt to prevent this condition on the client node where the script is being executed or
between multiple clients. It is the responsibility of the user to ensure that conflicting controller access does not occur.

3.8.5.1 Creating a GSLV Script


1.

In an open Composer project, select a node in the system architecture tree. This is either
the project node (the top-most node) or a hardware-related node (a control network, control
unit, controller, or workstation).

2.

Right click on the node and select New > GSLV Document.

A new GSLV document is added to the list of items in the right-hand pane.

3.

To change the name of the document, right click on the new document, select Rename, and change
the name.

4.

Double-click on the GSLV document to open the GSLV application.

5.

Enter the script commands in the main GSLV window, which is a normal text editor. Cut, copy, paste,
find, and replace operations are available.

6.

Comments can be entered in a script by using an apostrophe at the start of a line. For example:

This is a commented-out line.

7.

When done, select File > Save. The file is stored in the main project directory, and the filename must
be unique in the project. For example, two scripts can not be named SCRIPT1 in two different nodes
in the Composer project.

3.8.5.2 Manually Executing a GSLV Script


1.

In an open Composer project, select a node in the system architecture tree. This is either
the project node (the top-most node) or a hardware-related node (a control network, control
unit, controller, or workstation).

2.

Right click on the node and select New > GSLV Document.

A new GSLV document is added to the list of items in the left-hand pane.
3-36

2VAA000812R0001

3. Project Architecture

Global Save/Load/Verify

3.

Double-click on the GSLV document to open the GSLV application.

4.

Select Script > Run from the menu or click on the black triangle button (Play) on the toolbar.

5.

While a script is running, Script > Stop or the square on the toolbar can be selected.

3.8.5.3 GSLV Script Commands


The following commands are available for use in GSLV scripts:
OutputMessage messagetext
Output the message text to the output window in the lower half of the GSLV window.
ClearOutputWindow
Clear the text of the output window in the lower half of the GSLV window.
PrintOutputWindow
Print the contents of the output window to the default printer.
SaveOutputWindow pathname
Save the contents of the output window to a disk file.
ProjectPath pathname
Selects and opens the indicated Composer project. This is required in a script before any calls to Connect, Load, or Save.
Connect ICI number,ICI number

where: ICI number is an integer value from 1 to 9. Multiple entries for ICI number are separated
by a comma.
Connect to the indicated logical ICIs. For example, the command Connect 1,3,7,9 will attempt to connect to logical ICI 1,
then 3, then 7 and finally 9. The connections will be tried in the order specified until a successful connection is made.
Load L, P, M, cfg description[, nbs description]
Load a configuration to a controller. The cfg description and the nbs description can be replaced by the CFG or NBS
keyword to indicate the tip revision.

NOTES:
1. CFG files are configurations compiled from the control logic documents (CLD).
2. NBS files are binary images of the files system saved from the controller.
Save L, P, M, cfg description[, nbs description]
Save the controllers configuration to disk file.
Verify L, P, M, ref description, src description[, UPDATE_SPECS]
Compare the src configuration to the ref configuration, optionally updating the specification values of the src configuration if
the source specified CLD. The src description and the ref description can be replaced by the CFG keyword to indicate the
tip revision. The ref description can be replaced by the HW keyword to indicate the reference configuration is to be read up
from the controller. The src description can be replaced by CLD to verify and optionally update the specs of the modules
CLDs.
ChangeControllerMode ALWAYS | NEVER | PROMPT
Indicate the action that should be taken when Load encounters a module that is not in CONFIG. Always change the
controllers mode without any prompt. Never change the controllers mode or prompt the user if the controllers mode should
be changed.
InitializeController ALWAYS | PROMPT
Indicate if the controller should be initialized before the configuration is downloaded.
ControllerTypeMismatch PROMPT | IGNORE
Indicate the action that should be taken if Load encounters a controller which differs in type from what is indicated in the
Composer Project.

NOTE: If a controller mismatch occurs when the command is set to IGNORE, the script will abort. This is to prevent
configurations being downloaded to incorrect controllers.

3.8.5.4 GSLV Miscellaneous Issues


If GSLV Verify results differ from manual verify results, the problem may be due to the parameters specified in the VERIFY
command in the GSLV script.
For example, if you use this command to verify a configuration against a CLD:

VERIFY 3, 4, 5, 30405MOD
then GSLV looks through the revision list starting at the end (oldest revision first) for a configuration named 30405MOD. If
there are multiple revisions with the same name as the current revision, then the comparison is not being done against the
expected CFG revision but an older one. The best solution is to give the different revisions different names. If that has not
been done, then use the CFG label instead of the revision name VERIFY 3, 1, 2, CFG CLD (do not use quotations marks).
This will make GSLV automatically use the latest revision regardless of what its name is.

2VAA000812R0001

3-37

Global Save/Load/Verify

3. Project Architecture

3.8.5.5 GSLV Script Example


Figure 3-1 provides an illustration of how to write a GSLV script. This script performs three operations: load, save, and
verify. These three operations are not all required for all scripts and are presented here only to illustrate how they may be
used. Refer to GSLV Script Commands for detailed descriptions of the individual commands.
The parameters used in the script commands can not be changed while the script is running (i.e. they are not variables), so
different scripts should be used for different controllers and different operations (e.g. nightly verify or weekly save tasks).

Figure 3-1 GSLV Scripting Example


NOTE: Lines beginning with an apostrophe as the first character are comments.

3-38

2VAA000812R0001

3. Project Architecture

3.9

Human System Interfaces

Human System Interfaces


Human system interfaces (HSI) are the parts of a control network that utilize displays, display groups, logs, tag lists, trend
lists, etc. Instructions on how to create a human system interface follow. The properties a human system interface has are
also described. Refer to Common Editing Functions for information about copying, deleting, importing a document into,
moving, viewing the properties of, and renaming a human system interface.
Many types and revisions of HSI consoles are supported. Each version for each type of console has a corresponding
console context used by Composer. This console context contains rules that control how data is handled by that console
type and revision. Each field for any data type that can be edited by Composer can have different limits, ranges, exceptions,
etc. that are dependent on the console type and revision. Some of the fields that can edited are tag names, descriptions,
alarm comments, logic states, alarm priorities, etc. For example, Conductor VMS consoles only support tag names 14 or
less characters in length while Conductor NT consoles allow tag names to be up to 16 characters in length.
Selecting a console (in the system architecture) actives the corresponding console context. This console context is used
when editing tags in the Data Browser, when exporting an assigned taglist using the Export function, etc. Composer uses a
default console context when no console is selected in the system architecture. This default context is set using the Tools >
Options > Console Text menu option. New projects have a default console context of 800xA for Harmony SV 4.1/5.0 while
upgraded projects retain their previous console text.
When moving data between Composer projects, ensure that the both the source and destination consoles are set to the
same default console context or an error will be logged to the destination console. For example, trying to copy and paste a
tag with a 24 character name or a CLD containing it from one project (with 800xA Harmony SV4.1/5.0 default context) to
another (with Conductor VMS 4.0/5.0/6.0 default context) will fail because the name is too long for specified Conductor
VMS consoles to handle.

3.9.1 Create
To add a new human system interface to a control network:

1.

Right click the control network and select New > Console....

2.

Enter the human system interface name, number, and type in the dialog box. Some types of human
system interface may require additional information such as revision level, associated lists (tag,
trend. or both), server group number, etc.

NOTES: Use only alphanumeric and hyphen characters in human system interface names.
3.

Click OK.

3.9.2 Properties
The properties of most human system interfaces include:

Name.

Type.

Location.

Project name.

Status.

Control network number.

Human system interface number.

Human system interface type and revision level.

Tag list used.

Trend list used.

Choice of deleting .DT files after use by export function (Conductor VMS and 40 series HSIs only).

Name, description, etc. of any associated FTP sites.

2VAA000812R0001

3-39

Display Groups

3. Project Architecture

To view or edit the properties of a human system interface, refer to Common Editing Functions for more information.

3.10 Display Groups


NOTE: Display groups are utilized in Conductor VMS, PCV, MCS series, and OIS series human system interfaces.
Display groups are the parts of a Conductor VMS human system interface that contain displays unique to that human
system interface. Instructions on how to create, export, and print a display group follow. The properties a display group has
are also described. Refer to Common Editing Functions for information about copying, deleting, importing a document
into, moving, renaming, and viewing the properties of a display group.

3.10.1 Create
To add a new display group to a human system interface:

1.

Right click the human system interface and select New > Display Group....

2.

Enter the display group name in the dialog box and click OK.

3.10.2 Export
To translate and transfer all the displays in a human system interface (that supports display groups) or just a display group:

1.

Right click the human system interface (all displays, all groups) or display group (all
displays, this group only).

2.

Select Export > Displays... (human system interface) or Export... (display group).

3.

Enter the location to receive the exported displays in the dialog box.

4.

Select what is to be exported (all the displays and all the symbols used in the displays, just the
displays, or just the symbols).

5.

If FTP sites are associated with this human system interface and the symbol or display files are to be
exported all the way to the human system interface, proceed to the next step. If FTP sites are not
involved or the files are to be exported to a directory, proceed to Step Step 10.

6.

Enable FTP files to consoles. The files will be exported to the directory and copied to the human
system interface.

7.

If the files have already been satisfactorily exported to the directory, enable FTP existing data files.
The previously exported files will be copied to the human system interface.

8.

Select the FTP sites that will receive the symbol or display files.

NOTE: At least one FTP site must be selected.


9.

If exporting a display or tag list using FTP, verify the FTP site directory is set to allow write access.
Use the following procedure to set Windows workstations serving as a FTP host to allow write
access:

a.

Select Administrative Tools > Internet Services Manager and select the Default FTP site.

b.

Open the Properties page and select the Home Directory tab.

c.

Enable the option for allowing write access (under the FTP Site Directory section) and click OK.
10. Click OK.
During the export operation, a command (.CMD) file is created. This file contains the ordered and processed .DT file for use
by the human system interface. The .CMD file is automatically transferred when the FTP protocol is used but must be
manually transferred otherwise.

3.10.3 Print
To print a copy of all the displays in the display group:

3-40

1.

Right click the display group and select Print.

2.

Specify the printer, print range, and copies settings in the standard Windows print dialog box and
click OK.

2VAA000812R0001

3. Project Architecture

Properties

3.10.4 Properties
The properties of a display group include:

Name.

Type.

Location.

Project name.

Status.

Control network number.

Human system interface number.

To view or edit the properties of a display group, refer to Common Editing Functions for more information.

3.11 Displays
NOTE: Composer utilizes Conductor VMS, PCV, MCS series, and OIS series displays in the same manner.
Conductor VMS human system interface displays are used to monitor process operation and results of control actions.
Displays can be assigned to tags, keyboard keys, and ADP pushbuttons for data input. Display types include alarm
summaries, graphic overviews, graphic details, groups, trends, and XY plots. Symbols are complex entities composed of
primitive entities, escapes, and other symbols that can be referenced in displays and other symbols. Instructions on how to
create, open, export, print, edit, create references to displays, and synchronize the tags used in the display with those in the
database follow. The properties a display or symbol has are also described. Refer to Common Editing Functions for
information about copying, deleting, moving, renaming, and viewing the properties of a display.

3.11.1 Create
To add a new display to a display group:

1.

Right click the display group and select New > Display....

2.

Enter the display name in the dialog box and click OK.

To add a new document shape. macro, HSI symbol, display, pop-up display, or custom border to an exchange folder:

1.

Open the exchange folder.

2.

Right click empty space in the exchange window and select New and Document Shape, Macro,
Console Symbol, Display, or Custom Border.

3.

Enter the display or symbol name in the dialog box and click OK.

3.11.2 Edit
Conductor VMS displays are created from within the Composer window but they are edited from within the graphical display
configuration window. To edit a display or symbol, right click the display and select Open. To edit a Conductor NT or
Operate IT Process Portal model, right click the human system interface or configuration server and select Open. The
appropriate display configuration window is opened with the display in a window.

3.11.3 Export
To translate and transfer a display or symbol:

1.

Right click the display in the system architecture window and select Export....

2.

Enter the location to receive the exported display.

3.

Select if the symbols used in the display are to be exported along with the display.

4.

If FTP sites are associated with the human system interface containing the file and the symbol or
display file is to be exported all the way to the human system interface, proceed to the next step. If
FTP sites are not involved or the file is to be exported to a directory, proceed to Step Step 8.

5.

Enable FTP files to consoles. The file will be exported to the directory and copied to the human
system interface.

6.

If the file has already been satisfactorily exported to the directory, enable FTP existing data files. The
previously exported file will be copied to the human system interface.

2VAA000812R0001

3-41

Open

3. Project Architecture

7.

Select the FTP sites that will receive the symbol or display file.

NOTE: At least one FTP site must be selected.


8.

Click OK.

To translate and transfer all the displays or symbols used by a human system interface (that supports display groups):

1.

Right click the human system interface and select Export > Displays....

2.

Enter the location to receive the exported displays.

3.

Select what is to be exported (all the displays and all the symbols used in the display, just the
displays, or just the symbols).

4.

If FTP sites are associated with this human system interface and the symbol or display files are to be
exported all the way to the human system interface, proceed to the next step. If FTP sites are not
involved or the files are to be exported to a directory, proceed to Step Step 8.

5.

Enable FTP files to consoles. The files will be exported to the directory and copied to the human
system interface.

6.

If the files have already been satisfactorily exported to the directory, enable FTP existing data files.
The previously exported files will be copied to the human system interface.

7.

Select the FTP sites that will receive the symbol or display files.

8.

Click OK.

During the export operation, a command (.CMD) file is created. This file contains the ordered and processed .DT file for use
by the human system interface. The .CMD file is automatically transferred when the FTP protocol is used but must be
manually transferred otherwise.

3.11.4 Open
To view a display or symbol (located in an exchange folder), right click the display or symbol and select Open.
The opened display or symbol will appear in a window inside the appropriate display configuration window.

3.11.5 Print
To print a copy of a display:

1.

Right click the display in the system architecture window and select Print. The print
Composer displays dialog box appears.

2.

Specify what additional information (None, Tag Indexes, Tag Names, or Display Selects) is to be
printed.

3.

Select Printer Setup to access a standard Windows printer setup dialog box.

4.

Click OK.

It is also possible to print a copy of opened display and symbol files by selecting File > Print... from the display configuration
window.

3.11.6 Properties
The properties of a display include:

Name.

Type.

Location.

Project name.

Status.

Export file name.

Control network number.

Human system interface number.

The properties of a symbol include:

3-42

Name.
2VAA000812R0001

3. Project Architecture

Location.

Project name.

System file designator.

Export file name.

References

To view or edit the properties of a display or symbol, refer to Common Editing Functions for more information.

3.11.7 References
It is possible to use references to displays instead of actual displays. These references are created by dragging a display
from an exchange folder to a display group. The display reference acts like a linked copy of the original display. When
saving an edited (in the same manner as a normal display) display reference, a prompt will explain the available save
options. The display reference can also be used to update the original display.

3.11.8 Synchronize with Tags


This function checks the references to tags found in displays against the tag database. Three pieces of information (GUID,
name and index number) are used to find the tag in the database. All three of these pieces of information are used but only
one or two of them are required to verify the reference and update the reference information with all three pieces of
information. However, if only the index number is found to match, a warning is generated because an index number only is
not enough information to verify the reference. Each reference generating a warning must be manually checked to ensure it
is correct. This function should be performed after tags referenced in displays are added, removed, edited, or changed in
any way.
Displays are synchronized with tags when the displays are opened. If changes are made to tags, displays not open at the
time are now out of sync. One way to synchronize the displays is to open and save all of them. Another way is to use the
Synchronize with Tag List or Console Display Tag Synchronize functions.
To synchronize display tag references with the tag database, right click the display or any project structure object that
contains the display and select Synchronize with Tag List or Console Display Tag Synchronize.
The output window shows the results of the check. A warning is generated for every tag reference that cannot be resolved
or does not contain enough information (index number only).
It is recommended to perform this function on individual or small groups of displays because checking for these conditions
make take a long period of time.

3.12 Lists
Six types of lists available in the Composer application are:

Engineering Unit Descriptor (EUD).

Logic State Descriptor (LSD).

Alarm comments.

Tag.

Trend.

Report point.

NOTE: The configuration server (required by Operate IT Process Portal clients) provides nine lists. Refer to Configuration Server for more information.
NOTE: Composer supports one Return to Normal tag property (BAD/COM0) for Conductor VMS, Conductor NT and
similar consoles. For Process Portal B and 800xA for Harmony consoles, Composer does not support multiple return
to normal alarm comments. Users of those consoles will need to configure those fields on the console or with the Bulk
Configuration Manager.
The engineering unit descriptor list contains a text descriptor for all the normal engineering units. The logic state descriptor
list contains a text descriptor for all the normal logic states. The alarm comments list contains a text descriptor for all the
normal alarm comments.
Every project contains one and only one engineering unit descriptor, logic state descriptor, and alarm comments list. The
tag, trend, and report point lists contain a group of tags, trends, or report points. There is no limit on the number of these
types of lists. Any or all the human system interfaces in the project can use these lists.
Instructions on how to create, assign, export, edit, and print lists follow. Also provided are instructions of how to edit the
provided engineering unit descriptor, logic state descriptor, and alarm comment lists. The properties a list has are also
described. Refer to Common Editing Functions for information about copying, deleting, moving, renaming, and viewing
the properties of a list.

2VAA000812R0001

3-43

Assign

3. Project Architecture

3.12.1 Assign
To assign a tag, trend, or report point list to a human system interface, drag and drop the list onto the human system
interface. Another method is to specify the list on the human system interface property pages.

3.12.2 Create
To add a new tag, trend, or report point list to a project:

1.

Right click the lists symbol and select New > Tag List..., New > Trend List..., or New >
Report Point....

2.

Enter the list name in the dialog box and click OK.

3.12.3 Edit
To edit a list:

1.

Select the list and then select View > Data Browser.

The right side of the system architecture window changes to a database table showing the items in the list and the specific
data that pertains to each item.

2.

Edit the unshaded fields in the list (as appropriate) by clicking in the field and entering the desired
information. Shaded fields are read-only. Blacked out fields do not apply. In some fields, a pull-down
list will present the allowable information. In these fields, select the appropriate information from the
pull-down list.

NOTE: Moving the cursor to a new row enters (or updates) the data edited in the previous row into the database.
Lists can be sorted by any column using the two toolbar sort buttons. Select the column heading, select one of the sort
buttons, and the list is sorted in increasing or decreasing order (depending on which button is used).
More detailed information about how to edit each type of list follows.

3.12.3.1 Tag Lists


The tag database holds all the tags defined for the whole project. The number of tags is often so large that a human system
interface can not hold them all. For this reason, place only the tags used by a particular human system interface into a tag
list. This tag list will be downloaded to the human system interface.
When editing or viewing the tag lists, the data browser window within the Composer window displays many columns which
contain both global and human system interface specific information or just the human system interface specific
information. Each type of tag utilizes a unique subset of the fields to define itself.

3.12.3.2 Trend Lists


Trend lists contain tags (tied to trending function codes) from which their values are to be collected at specified intervals for
some period of time. The trend data is used to plot trend graphs on the human system interface.
Trend tag information can be found in displays, controller configurations, and in the tag database. However, trend tag linking
is not supported and the aforementioned applications do not share trend tag definitions between each other. There is no
global trend tag list (as with regular tags) and all information about the trend tags resides in each individual human system
interface trend tag list.
The trend list structure is in the form of a table with trend records forming rows and fields. Each trend tag is a record in the
list and each field is available for viewing in the data browser.
The following table describes the fields that can be shown when editing a trend list.

NOTE: Not all trend types and fields described in the table are valid for all human system interface types and revisions.

Table 3-15 Trend List Fields


Field

3-44

Format1 Source2

Description

Creation timestamp

Date the trend tag was created.

FC name

8C

Function code symbol name.

FC number

Function code number.

2VAA000812R0001

3. Project Architecture

Edit

Table 3-15 Trend List Fields (Continued)


Field

Format1 Source2

Fill type

PCV information.

ID of the last person to edit the trend tag.

Life cycle

16C

What stage (in the life cycle of a tag) this tag is


in presently.

Loop

3N

Node

Symphony block address of the exception


report block from which to collect the trend data.

3N

Module

2N

Block

4N

Number of events

6N

Number of
retentions

Tag name

14C

Name of the tag that creates the exception


report for the trend tag as defined in the tag list.
Upon entering either the tag index or the tag
name, the other is filled in automatically.

Trend collection
method

Trend collection method.

Trend collection
resolution

Trend collection resolution (for enhanced trends


only).

Trend GUID

Unique identifier for trend tag.

Trend index

4N

Number of the trend tag. Valid input is 1 to the


number of trends configured for the human
system interface.

Trend mode

3C

Trend mode as defined in the block. Valid


entries are AVG (average), SMP (sample), MIN
(minimum), MAX (maximum), and SUM. If the
trend type is ENHANCED, RNG (range) is also
valid.

Trend resolution
number

Trend resolution number.

Trend resolution
unit

Trend resolution units (S,M,H,D).

Trend source

6C

Source of the trend data to be displayed. Valid


input is LOCAL. If TRUSAGE is set to
EXTERNAL SRC and the human system
interface is a 40 series E or later, this field must
be filled in. Valid for 40 series E human system
interface and later only.

Trend span
number

2N

Maximum time (number of units) to collect trend


data.

Trend span unit

Units the trend span is measured in.

Last user ID

2VAA000812R0001

Description

Displayed if the trend type is ENHANCED. It


defines the total number of events to be saved
to disk before the data is overwritten. Valid
inputs are 1 through 999999.
PCV information.

3-45

Edit

3. Project Architecture

Table 3-15 Trend List Fields (Continued)


Field

Format1 Source2

Description

Trend subtype

2C

Only valid for the STATION tag type. Valid input


is PV, SP, CO, and RI.

Trend type

8C

Trend type that is being used in the controller.


Valid input is FAST, NORMAL, and
ENHANCED. FAST and NORMAL are valid
only if 1) the block address is that of an FC 66
(analog trend) or 2) the block address is that of
an FC 70 or FC 158 (analog point
definition/enhanced analog point definition).
ENHANCED is only valid if the block address is
that of an FC 179.

Trend usage

12C

Determines what the target of the trend data is


going to be. Valid input is DISPLAY ONLY,
SAVE TO DISK, or ARCHIVE. Any of the
previous selections imply that the trend data is
displayable. Valid input:
DISPLAY ONLY = no trend data is saved to
disk.
SAVE TO DISK = trend data is saved to disk.
ARCHIVE = trend data is saved to disk and also
archived. ARCHIVE is not supported for an
ENHANCED trend on previous human system
interfaces.

Update timestamp

Date the trend tag was last edited.

NOTES:
1. N (numeric) = Numbers 0 through 9 only.
C (character) = Alphabetic characters, numbers 0 through 9, and special characters used as
descriptors.
D = Date.
2. C = Customer supplied.
A = ABB supplied.

By default, LAN-90 PCV uses the trnd_dat.fmt trend format file for compatibility with SLDG 5.6.1. A native trend format file
(trnd-pcv.fmt) is provided for compatibility with LAN-90 PCV version 4.3A, 4.3B, and 5.0A. This native trend format contains
additional information to more precisely define LAN-90 PCV trend configurations. To accept trend configurations defined for
the MCS revision S.1 and OIS 40 series revision E.1 consoles, use the LAN-90 PCV provided trnd-S1.fmt trend format file
which assigns:

Tags for NORMAL trends to the 1 minute collection class.

Tags for FAST trends to the 15 second collection class.

Tags for ENHANCED trends to the 2 second collection class.


SLDG 5.6.1 translates trend configuration information into an ASCII file with the .TTR extension (TRENDS.TTR for
example)

3.12.3.3 Report Point Lists


Report point lists contain points in the human system interface that simulate analog exception reports, digital exception
reports, and segment control function codes that output values to controllers. The report point list structure is in the form of
a table with report points forming rows and tables. Each report point is a record in the list and each field is available for
viewing in the data browser. The following table describes the fields that can be shown when editing a report point list.

NOTE: Not all fields described in the table are valid for all human system interface types and revisions.

3-46

2VAA000812R0001

3. Project Architecture

Edit

Table 3-16 Report Point List Fields


Field

Format1 Source2

Description

Alarm deadband

Alarm deadband specification for FC 82.

Alarm state

Alarm state descriptor.

Alarm state index

Alarm state descriptor index.

Block

4N

Any valid function block address.

Creation timestamp

Date the report point was created.

EU description

6C

Engineering unit descriptor for FC 30.

EU index

Engineering unit index for FC 30.

FC name

8C

Name of the simulated function code.

FC number

Function code simulated: AO/L (FC 30), DO/L


(FC 45), SEGCRM (FC 82).

Global time-stamp

Date the report point was last edited.

High alarm

High alarm point limit value specification for FC


30.

Last user ID

ID of the last person to edit the report point.

Life cycle

16C

What stage (in the life cycle of the a tag) this tag
is in presently.

Low alarm

Low alarm point limit value specification for FC


30.

Max rpt time

Maximum report time specification for FC 82.

Min rpt time

Minimum report time specification for FC 82.

Rptpt GUID

GUID of the report point.

Rptpt name

Name of the report point.

Segment attrib

Segment attribute specification for FC 82.

Segment prty

Segment priority specification for FC 82.

Segmntcycletime

Segment cycle time alarm limit specification for


FC 82.

Significant change

Significant change specification for FC 30 and


FC 82.

Span

Target period
Value zero

Span of the input specification for FC 30.


Target period specification for FC 82.

Zero of the input specification for FC 30.

NOTES:
1. N (numeric) = Numbers 0 through 9 only.
C (character) = Alphabetic characters, numbers 0 through 9, and special characters used as
descriptors.
D = Date.
2. C = Customer supplied.
A = ABB supplied.

2VAA000812R0001

3-47

Export

3. Project Architecture

3.12.4 Export
To export a tag, trend, report point, or configuration server list:

1.

Right click the list, List symbol, or human system interface containing the list and select
Export (from list) or Export > list_name List... (from List symbol or human system interface).

2.

Enter the location to receive the list in the dialog box.

3.

Enter the name of the file.

NOTE: It is highly recommended that the default file name be used.


4.

Enter the revision number of the list.

5.

When exporting a tag list, select any other lists (engineering unit descriptor, logic state descriptor,
alarm comment, Operate IT Process Portal) to be exported at the same time.

NOTE: At least one engineering unit descriptor, logic state descriptor, alarm comment, or Operate IT Process Portal
list must be selected when exporting to a .MDB file using FTP protocol.
NOTE: Negative engineering unit and logic state descriptor indices are not supported (will not export) in projects containing both OIS and Process Portal B workstations.
6.

Select the format in which the list will be exported.

7.

If exporting to an ASCII file, select the type of processing (compress or split) done to the lists before
exporting. Compress condenses the list files and adds a .CP file extension. Split divides the list files
into sizes that will fit on floppy disks.

8.

If exporting to a .MDB file, select if Operate IT Process Portal field names should be used and the
view to be used during the export operation. Use Operate IT Process Portal field names if the
exported lists are to be imported into a Operate IT Process Portal human system interface.

9.

If exporting a list from a human system interface using the FTP protocol, proceed to the next step. If
the FTP protocol is not being used, proceed to Step Step 12.

10. Enable the FTP files to Console option.


11. Select, from the list provided, the FTP-configured human system interface that will receive the list.
12. Click OK.
To export only an engineering unit descriptor, alarm comment, or logic state descriptor list:

1.

Right click the list or List symbol containing the list and select Export (from list) or Export >
list_name List... (from List symbol or human system interface).

2.

Enter the location to receive the list in the dialog box.

3.

Select the format in which the list will be exported.

4.

If exporting to an ASCII file, select the type of processing (compress or split) done to the lists before
exporting. Compress condenses the list files and adds a .CP file extension. Split divides the list files
into sizes that will fit on floppy disks.

5.

If exporting to a .MDB file, enter a name for the file and the view to be used during the export
operation.

NOTE: It is highly recommended that the default file name be used.


6.

Click OK.

Versions of LAN-90 PCV prior to 5.4 do not maintain a synchronized alarm comments file between itself and Composer if
there are multiple workstation servers.
When exporting the tag database and alarm comment file from PCV version 5.4 and later, the indices (sp) of alarm
comments existing in the alarm comments file are placed in the .TTG file (for formats >= S1) and any new comments
configured are appended to the alarm comments file (alrmcmnt.tac).
When importing alarm comments into PCV version 5.4 and later, the imported alrmcmnt.tac file overwrites the existing file
in the PCV system (and is mirrored on all networked PCV consoles).

3.12.5 Import
To import a tag, trend, report point, or configuration server list into a project, human system interface, or configuration
server:
3-48

2VAA000812R0001

3. Project Architecture

Import

1.

Right click the list, List symbol, human system interface, or configuration server and select
Import (from list) or Import > list_name List... (from List symbol, human system interface, or
configuration server).

2.

Enter the name and full path of the list file being imported or select one from the list provided in the
File field. Tag lists are named TAGLST1n.CP or use a .TTG file extension. Trend lists are named
TRNLST1n.CP or use a .TTR file extension. Report point lists are named RPTLST1n.CP or use a
.TRP file extension. Lists can also be imported from .MDB files.

2VAA000812R0001

3-49

Import

3. Project Architecture

3.

If the Type/Rev field is set to undetermined, select the type and revision of the list used by the human
system interface sourcing the list. Refer to the following table for more information.

Table 3-17 Tag, Trend, and Report Point List Revisions


HSI Type / Revision

3-50

Tag List
Revision

Trend List
Revision

Report Point
List Revision

PCV / 4.3
PCV / 5.0
PCV / 5.1
PCV / 5.2
PCV / 5.3
PCV / 5.4
PCV / 5.5

Tag L3/M1
Tag L3/M1
Tag S1U
Tag S1U
Tag S1U
Tag S1U
Tag X2U

Trend PCV 4x Not applicable


Trend PCV 4x
Trend Pre R1
Trend Pre R1
Trend Pre R1
Trend Pre R1
Trend Pre R1

OIS20 / E.2

Tag S1

Trend S1

MCS / S.3

Tag S1

Trend S1

OIS40 / E.1

Tag S1

Trend S1

MCS PLUS / R.2


MCS PLUS / S.2
MCS PLUS / V.2
MCS PLUS / X.1

Tag R1
Tag S1
Tag V1
Tag X1

Trend R1
Trend S1
Trend S1
Trend S1

OIS41 / E.1
OIS41 / F.1
OIS41 / G.3

Tag S1
Tag T1
Tag V1

Trend S1
Trend S1
Trend S1

OAS / E.1
OAS / F.1

Tag S1
Tag T1

Trend S1
Trend S1

OIS25 / E.2
OIS25 / G.2
OIS25 / J.1

Tag S1
Tag V1
Tag X1

Trend S1
Trend S1
Trend S1

OIS40 PLUS / E.1


OIS40 PLUS / F.1
OIS40 PLUS / G.3

Tag S1
Tag T1
Tag V1

Trend S1
Trend S1
Trend S1

OIS42 / F.1
OIS42 / G.1
OIS42 / G.2
OIS42 / G.3

Tag T1
Tag V1
Tag V1
Tag V1

Trend S1
Trend S1
Trend S1
Trend S1

SIG42 / F.1
SIG42 / G.2
SIG42 / G.3

Tag T1
Tag V1
Tag V1

Trend S1
Trend S1
Trend S1

OIS12 / 5.1

Tag S1

Trend Pre R

SIG12 / 5.1

Tag S1

Trend Pre R

OIS4x / H.2
OIS4x / J.1

Tag V1
Tag X1

Trend S1
Trend S1

SIG4x / H.2
SIG4x / J.1

Tag V1
Tag X1

Trend S1
Trend S1

PWC 90

Tag S1

Trend S1

Conductor NT / 1.0
Conductor NT / 2.0
Conductor NT / 2.1

Tag S1
Trend S1
Tag X1
Trend S1
Tag CNT 2.1 Trend S1

Not applicable
Not applicable
ReportPoint

2VAA000812R0001

3. Project Architecture

Import

Table 3-17 Tag, Trend, and Report Point List Revisions (Continued)
HSI Type / Revision

Tag List
Revision

Conductor VMS / 1.0 Tag X1


Conductor VMS / 2.0 Tag X1
Conductor VMS / 3.0 Tag A0

Trend List
Revision
Trend S1
Trend S1
Trend A0

Report Point
List Revision
Not applicable
Not applicable
ReportPoint

Operate IT Process
Portal Harmony
Real Time Data
Server

Not
applicable

Not applicable Not applicable

PGP 4.1

S+ Op 1.0

Not Applicable Not Applicable

S+ Operations 1.0

S+ Op 1.0

Not Applicable Not Applicable

NOTE:
1. Trend list export and import are used to support pre-PCV 5.1 trending. When
using user (Tag
S1U and Tag X2U) tag list export and import, LAN-90 PCV trending is
automatically supported
by including a tag assignment to a historical class.

4.

Select the table to be imported in the Table Name field when importing from a .MDB file.

5.

Enter the name of the list to import in the List Name field. A new list will be created if it does not
already exist in the project or human system interface.

2VAA000812R0001

3-51

Import

3. Project Architecture

6.

Select the appropriate options and click OK. Refer to the following table for an explanation of the
options.

Table 3-18 Import File Options


Option

Description

Add new

Items that exist in the list to be imported but do not exist in the list within
Composer will be added to the Composer list.

Overwrite
existing

Items that exist in the Composer list will be overwritten with values from
the same item in the list to be imported.

Skip empty
fields

All fields in the list to be imported that are empty or blank will be
skipped and the amount of time required to import the list will be
decreased.

Auto generate
indexes

New tag indexes will be assigned to imported tags whose indexes are
already being used. This option is only applicable when importing tag
lists.

Use Maestro
field names

Operate IT Process Portal atom names (as they appear in the


configuration server database) will be used when this option is enabled.
Otherwise, Composer atom names will be used.

Log errors only

Only errors for rejected items will be displayed in the output window.

Log all
operations

A message will be displayed in the output window for each item that is
added, updated, ignored, or rejected.

Include
The engineering unit descriptor (EUD) list will be imported in addition to
engineering unit the selected file. If the selected file is a .TTG file, the EUDSCP.CF file
will be imported. If the selected file is a TAGLST1n.CP file, the
descriptor list
EUDSCP.CP file will be imported. The EUD list must exist in the same
location (drive/directory) as the tag list except when the list resides on
multiple floppy disks and the EUD list is on a different disk than the tag
list. If the selected file is a .MDB file, the engineering unit descriptor
table will be imported. The Add New and Overwrite Existing options
determine if the EUD list is added, updated, or ignored. This option is
only applicable when importing tag lists.
Include logic
The logic state descriptor (LSD) list will be imported in addition to the
state descriptor selected tag list. If the selected file is a .TTG file, the LSDSCP.CF file
list
will be imported. If the selected file is a TAGLST1n.CP file, the
LSDSCP.CP file will be imported. The LSD list must exist in the same
location (drive/directory) as the tag list except when the list resides on
multiple floppy disks and the LSD list is on a different disk than the tag
list. If the selected file is a .MDB file, the logic state descriptor table will
be imported. The Add New and Overwrite Existing options determine if
the LSD list is added, updated, or ignored. This option is only
applicable when importing tag lists.
Include alarm
comment list

The alarm comment list will be imported in addition to the selected tag
list. If the selected file is a .TTG file, the ALRMCMNT.TAC file will be
imported. If the selected file is a TAGLST1n.CP file, the EUDSCP.CP
file will be imported. The alarm comment list must exist in the same
location (drive/directory) as the tag list except when the list resides on
multiple floppy disks and the alarm comment list is on a different disk
than the tag list. If the selected file is a .MDB file, the alarm comment
table will be imported. The Add New and Overwrite Existing options
determine if the alarm comment list is added, updated, or ignored. This
option is only applicable when importing tag lists.

NOTE: Importing a list into a human system interface causes the list to be imported and assigned to the human sys3-52

2VAA000812R0001

3. Project Architecture

Tag List Import Compatibility Issues

tem interface.
To import an engineering unit descriptor, logic state descriptor, or alarm comment list into a project:

1.

Right click the list or List symbol and select Import (from list) or Import > list_name List...
(from List symbol).

2.

Enter the name and full path of the list file being imported or select one from the list provided in the
File field. Engineering unit descriptor lists are named EUDSCP.CF or EUDSCP.CP. Logic state
descriptor lists are named LSDSCP.CF or LSDSCP.CP file extension. Alarm comment lists are
named ALRMCMNT.TAC or ALMCOM11.CP. Lists can also be imported from .MDB files.

3.

Select the appropriate options and click OK.

Versions of LAN-90 PCV prior to 5.4 do not maintain a synchronized alarm comments file between itself and Composer if
there are multiple PCV servers.
When exporting the tag database and alarm comment file from PCV version 5.4 and later, the indices of alarm comments
existing in the alarm comments file are placed in the .TTG file (for formats >= S1) and any new comments configured are
appended to the alarm comments file (alrmcmnt.tac).
When importing alarm comments into PCV version 5.4 and later, the imported alrmcmnt.tac file overwrites the existing file
in the PCV system (and is mirrored on all networked PCV workstations).
When FTP to send tag lists or displays to a workstation using IIS for it's FTP Server, be sure to enable Write access to the
FTP site. This is not enabled by default in IIS.
When importing a compressed tag list with a large number of alarm comments, and if a temporary directory is selected with
less than 1 megabyte of disk space available, an application error is generated. Make sure to select a temporary directory
with more than 1 megabyte of disk space.
If a tag exists in TaglistA, but does not exist in TaglistB, an attempt to import the tag into TaglistB will fail if the table being
used as the source for the import does not contain the TagIndex field. To work around this, make sure that the source table
has the index field (e.g., if it was created by an export, be sure to include the TagIndex field in the export) or copy and paste
the tags from TaglistA to TaglistB before importing the tags into list TaglistB.
If only the compress option and not the split option are selected when a tag or trend list is exported, the file name created
does not have the proper form (Tag.cp or Trend.cp). In order to re-import, rename the file to taglst11.cp or trnlst11.cp
respectively.
If Access 2000 or later is used to edit a file exported from Composer in .MDB format, and if Access is allowed to upgrade
the files format, then Composer will not be able to import the file. Composer can not import Access 2000 or later format
databases. Exported .MDB files are either to be edited with Access 97 or with Access 2000 without the upgrade option
being selected. This will still allow fields to be edited and records to be added, but not structural changes to be made (no
columns or tables can be added or deleted). Access 97 and Access 2000 can coexist on the same machine as long as
Access 97 is installed first, and the user either starts Access 97 via the start menu or reassociates .MDB files with the
Access 97 executable.

3.12.6 Tag List Import Compatibility Issues


The format used to export Maestro tags in Composer 3.0 and later releases differs from that used in Composer 2.0. These
differences make the .MDB files output from Composer 3.0 and greater releases incompatible with the tag importer in
Maestro 3.1, which was designed to run against the Composer 2.0 format. The source of this incompatibility is the change
of data type for the SECTIONDISPLAY and the SECGROUP fields. The data types of these fields were changed because
they are now GUID references into the configuration server lists that Composer 3.0 and later releases now support. The
following procedure can be used to work around this incompatibility.

NOTES:
1. This is not an issue with Operate IT B.0.
2. Microsoft Access must be installed because part of the procedure requires modifying the exported .MDB file.
The steps required to create an .MDB file that is compatible with the Maestro 3.1 tag importer:

1.

Select Tools > Manage Views.

2.

Choose Tag as the data type.

3.

Choose the Maestro Tag system view and click Copy.

4.

Type Maestro Tag Composer 2.0 Format as the name for the new user view and click OK to save it.

5.

Press the Fields control to launch the Fields dialog on this new view.

6.

In the Selected Fields list control, remove the following fields (i.e., move them to Available Fields):

AREA GUID
EQUIPMENT GUID
2VAA000812R0001

3-53

Print

3. Project Architecture

UNIT GUID
HISTORIAN SERVER GUID
HISTORIAN ATOM GROUP GUID
SECURITY GROUP GUID
GROUP DISPLAY GUID
TREND DISPLAY GUID
SECTION DISPLAY GUID
OVERVIEW DISPLAY GUID
7.

In the Available Fields list control, add the following fields (i.e., move them to Selected Fields):

SECURITY GROUP NDX


SECTION DISPLAY NAME
8.

Click OK to save the changes and then Close to dismiss the Manage Views dialog.

9.

Export the desired tag list, selecting the Maestro Tag Composer 2.0 Format in the View drop-down
list box on the Export Tags dialog.

10. Using Microsoft Access, open the exported .MDB file.


11. On the Tables tab, select the Tags table and click Design to open it in design mode.
12. Scroll to and select the SECGROUPNDX field. Change the name of the field to SECGROUP.
13. Change the field size setting from long integer to integer.
14. Select the SECTIONDISPLAYNAME field.
15. Change the name of the field to SECTIONDISPLAY.
16. Change the field size setting from 32 to 8.
17. Acknowledge the Tags table design dialog.
18. Select Yes when prompted to save the changes.
19. Select Yes to the Some data may be lost message. Data will be lost only if the display names exceed
8 characters.
The resulting .MDB file can now be imported into Maestro 3.1.

3.12.7 Print
To print the list displayed in the data browser:

1.

Select Browser > Print. The standard Windows print dialog box appears.

2.

Configure the dialog box options as desired and click OK.

3.12.8 Properties
The properties of a list include:

Name.

Location.

Project name.

Status.

To view or edit the properties of a list, refer to Common Editing Functions for more information.

3.13 Configuration Server


Configuration servers are used in Operate IT Process Portal systems. One configuration can be added to a project and
pointed to the workstation in which it resides. Refer to the Operate IT Process Portal software documentation for information
about these systems.
Instructions on how to create a configuration server follow. The properties a list has are also described. Refer to Common
Editing Functions for information about copying, deleting, moving, and viewing the properties of a configuration server.
The configuration server contains nine lists.

3-54

Areas.

Equipments.
2VAA000812R0001

3. Project Architecture

Create

Units.

Security groups.

Graphic displays.

Trend displays.

Group displays.

Historian servers.

Historian atom collections.

These lists contain all the defined items of the type indicated by the name. Operate IT Process Portal tags can be
configured (through property pages) to use the items in these lists. These lists can be edited at any time. Refer to Tag
Configuration for more information about the individual lists.

3.13.1 Create
To add a configuration server to a project:

1.

Right click the project and select New > Config Server.

2.

Click OK in the dialog box.

3.13.2 Properties
The properties of a configuration server to a project:

Name.

Type.

Location.

Project name.

Status.

Workstation name.

To view the properties of a configuration server, refer to Common Editing Functions for more information.

3.14 Common Editing Functions


It is possible to copy, delete, double-click (open or expand), import a document into, move, rename, and view the properties
of almost all parts of a project. Other commonly used functions are tag synchronizing, transferring tags and specifications,
address changing, and verifying and viewing of configurations. Descriptions of how to execute these functions follow.

3.14.1 Change Address


To change the address of a control network, Harmony control unit, or controller, edit the address fields of the control
network, Harmony control unit, or controller property page.

3.14.2 Create an Entity


It is possible to create many different types of non-Composer entities (documents, databases, files, etc.) and place them
within the project architecture. The types of entities that can be created are:

Bitmap image.

Microsoft Word document.

Adobe FrameMaker document.

Microsoft Access database.

Microsoft Office binder.

Microsoft PowerPoint presentation.

Rich text format document.

Trend document.

Text document.

Microsoft data link.

2VAA000812R0001

3-55

Copy

3. Project Architecture

Wave sound.

Microsoft Excel worksheet.

WinZip file.

To create an entity, right click on the part of the project architecture that will contain the entity and select File > New >
entity_type.

3.14.3 Copy
To copy a part of a project or the project itself, use the standard Windows copy and paste functions. These functions are
available from the edit menu. They are also available in a pop-up menu displayed by right clicking the part.

NOTE: Right click the associated Harmony control unit when trying to copy a Harmony area or sequence of events
controller.
All tag names in a copied component are renamed. On the first renaming of a tag, a Copy(1) is appended to the tag name.
The second time a Copy(2) is appended to the tag name and so on. This prevents unwanted tag links. Copied control logic
document are appended in the same manner. All changes made during the copy operation are logged to the general tab of
the output window within the Composer window.
Logic state descriptors, engineering unit descriptors and alarm comments and Configuration Server items must be correct
in both source and destination projects, and the default console contexts of both projects must be the same, before copying
tags or errors may result. Exporting tags with these ancillary lists from one project and importing them into the destination
project will display more information if errors do occur.

3.14.4 Delete
To delete a part of a project:

1.

Right click the desired part and select Delete.

NOTE: Right click the associated Harmony control unit when trying to delete a Harmony area or sequence of events
controller.
2.

Click Yes in the dialog box.

NOTE: Deleted SEM controllers will still appear in the tree view (with a red X indicating it has been deleted) until the
project is reopened.

3.14.5 Double-Click
Double-clicking a project structure, exchange item, etc. performs the same function as in Windows applications (expands
structures, open files, etc.).

3.14.6 Import a Document


It is possible to copy or move documents of any type to the part of the Composer project they have information about. It is
also possible to place a shortcut to a document outside Composer within the project structure. This functionality allows a
more logical arrangement of project data. To copy, move, or insert a shortcut to a document into a part of a project:

1.

In the system architecture window, right click the desired part and select Import Document...
or Import > Document.....

NOTE: Documents can not be imported into a sequence of events controller.


2.

Specify the file to be imported in the import document dialog box.

3.

Specify if the document is to be copied, moved, or linked into the project.

4.

Click OK.

Imported documents will appear in the right side of the system architecture window when the part of the project containing
the document is selected. Opening an imported document starts up the software used to create the document and opens
the document itself.

3-56

2VAA000812R0001

3. Project Architecture

Move

3.14.7 Move
To move a part of a project or the project itself, use the standard Windows copy and paste functions. These functions are
available from the edit menu. They are also available in a pop-up menu displayed by right clicking the part.

NOTE: Right click the associated Harmony control unit when trying to move a Harmony area or sequence of events
controller.

3.14.8 Rename
To rename a part of a project (excluding configuration files):

1.

Right click the desired part and select Rename.

2.

Enter the new part name.

It is also possible to change the name of a part of a project from the property page of the object.

3.14.9 Tag Synchronize


Tag synchronization consists of linking tags (in the database) to function codes in control logic documents by control
network and Harmony control unit.
To tag synchronize control logic documents contained in a control network or Harmony control unit, right click the control
network or Harmony control unit and select Tag Synchronize.

NOTE: Synchronizing a control network or Harmony control unit will cause all the contained control logic documents
to be tag synchronized.
The output window will detail the status of the operation.

3.14.10Transfer Tags and Specifications


This utility provides two options for the transfer of specification data from one location to another. The Composer database
can be kept in sync with the control logic documents using this utility. Changes to data made at one location can be easily
propagated to the other location using this functionality. All function codes and tags that share specification data are
supported. An output window displays transfer status information.

3.14.10.1 Specification Data To Tags


Specification data of function codes 30, 68, 80, 177, 222, and 223 contained in the control logic documents that reside
within the selected Composer entity (controller or control logic document) is transferred to the Composer database. The
following table details which specification data from the supported function codes will be transferred to the Composer
database.
To transfer specification data to the Composer database, right click the controller or control logic document containing the
specification data and select Synch > Tag from the pop-up menu.
The output window will display status messages detailing the progress of the data transfer.

Table 3-19 Specification Data Transferable to Composer Database


Function
Code
30

68

2VAA000812R0001

Tag Type
Analog

RMSC

Spec #

Data Browser
Field

Description

S2

EUID

Engineering unit identifier

S3

Value zero

Zero value in engineering units

S4

Span

Span value in engineering units

S5

High alarm

High alarm value in engineering units

S6

Low alarm

Low alarm value in engineering units

S1

EUID

Engineering unit identifier

S3

Value zero

Zero value in engineering units

S2 - S3

Span

Span value in engineering units

3-57

Transfer Tags and Specifications

3. Project Architecture

Table 3-19 Specification Data Transferable to Composer Database (Continued)


Function
Code
80

177

177

3-58

Tag Type
Station

Spec #

Description

S7

High alarm

High alarm value in engineering units

S8

Low alarm

Low alarm value in engineering units

S10

Span

Span value in engineering units

S11

Value zero

Zero value in engineering units

S12

EUID

Engineering unit identifier

S14

Set point value Set point zero value in engineering


zero
units

DAAnalog S3

DAANG

Data Browser
Field

Value zero

Zero value in engineering units

S6

EUID

Engineering units identifier

S22

High 3 delta

High 3 alarm difference in engineering


units

S23

High 2 delta

High 2 alarm difference in engineering


units

S24

High alarm

High 1 fixed alarm value in engineering


units

S25

Low alarm

Low 1 fixed alarm value in engineering


units

S26

Low 2 delta

Low 2 alarm difference in engineering


units

S27

Low 3 delta

Low 3 alarm difference in engineering


units

S1 - S3

Span

Span value in engineering units

S24 +
S23

High 2 alarm

High 2 fixed alarm value in engineering


units

S24 +
S23 +
S22

High 3 alarm

High 3 fixed alarm value in engineering


units

S25 - S26 Low 2 alarm

Low 2 fixed alarm value in engineering


units

S25 - S26 Low 3 alarm


- S27

Low 3 fixed alarm value in engineering


units

S3

Value zero

Zero value in engineering units

S6

EUID

Engineering units identifier

S24

High alarm

High 1 fixed alarm value in engineering


units

S25

Low alarm

Low 1 fixed alarm value in engineering


units

S1 - S3

Span

Span value in engineering units

2VAA000812R0001

3. Project Architecture

Transfer Tags and Specifications

Table 3-19 Specification Data Transferable to Composer Database (Continued)


Function
Code
222

223

Tag Type
Analog
Enh/In

Analog
Enh/Out

Spec #

Data Browser
Field

Description

S3

Value zero

Zero value in engineering units

S5

EUID

Engineering units identifier

S6

High alarm

High alarm value in engineering units

S7

Low alarm

Low alarm value in engineering units

S4 - S3

Span

Span value in engineering units

S3

Value zero

Zero value in engineering units

S5

EUID

Engineering units identifier

S7

High alarm

High alarm value in engineering units

S8

Low alarm

Low alarm value in engineering units

S4 - S3

Span

Span value in engineering units

3.14.10.2 Tag Data To Specifications


Specification data of analog (FC 30), RMSC (FC 68), station (FC 80), DAAnalog (FC 177), DAANG (FC 177), enhanced
analog input (FC 222), and enhanced analog output (FC 223) tags contained within the Composer database is transferred
to the appropriate control logic documents contained within the selected Composer entity. The following table details which
specification data from the supported tags will be transferred to control logic documents.
To transfer specification data to control logic documents, right click the controller or control logic document containing the
specification data and select Synch > Spec from the pop-up menu.
The output window will display status messages detailing the progress of the data transfer.

Table 3-20 Specification Data Transferable to Control Logic Documents


Function
Tag Type
Code
30

68

2VAA000812R0001

Analog

RMSC

Spec #

Data Browser
Field

Description

S2

EUID

Engineering unit identifier

S3

Value zero

Zero value in engineering units

S4

Span

Span value in engineering units

S5

High alarm

High alarm point limit value in


engineering units

S6

Low alarm

Low alarm point limit value in


engineering units

S1

EUID

Engineering unit identifier

S2

Span + value
zero

High limit value in engineering units

S3

Value zero

Low limit value in engineering units

3-59

Transfer Tags and Specifications

3. Project Architecture

Table 3-20 Specification Data Transferable to Control Logic Documents (Continued)


Function
Tag Type
Code
80

177

178

3-60

Station

Spec #

Description

S7

High alarm

Process variable high alarm point value


in engineering units

S8

Low alarm

Process variable low alarm point value


in engineering units

S10

Span

Process variable signal span value in


engineering units

S11

Value zero

Process variable zero value in


engineering units

S12

EUID

Process variable engineering unit


identifier

S14

Set point value Set point zero value in engineering


zero
units

DAAnalog S1

DAANG

Data Browser
Field

Span - value
zero

High display reference value in


engineering units

S3

Value zero

Low display reference value in


engineering units

S6

EUID

Engineering units identifier

S22

High 3 alarm - High 3 alarm difference in engineering


high 2 alarm
units

S23

High 2 alarm - High 2 alarm difference in engineering


high alarm
units

S24

High alarm

High 1 fixed alarm value in engineering


units

S25

Low alarm

Low 1 fixed alarm value in engineering


units

S26

Low alarm low 2 alarm

Low 2 alarm difference in engineering


units

S27

Low 2 alarm low 3 alarm

Low 3 alarm difference in engineering


units

S1

Span + value
zero

High display reference in engineering


units

S3

Value zero

Low display reference in engineering


units

S6

EUID

Engineering unit identifier

S24

High alarm

High 1 fixed alarm value in engineering


units

S25

Low alarm

Low 1 fixed alarm value in engineering


units

2VAA000812R0001

3. Project Architecture

View Configuration

Table 3-20 Specification Data Transferable to Control Logic Documents (Continued)


Function
Tag Type
Code
222

223

Analog
Enh/In

Analog
Enh/Out

Spec #

Data Browser
Field

Description

S3

Value zero

Low value in engineering units

S4

Span + value
zero

High value in engineering units

S5

EUID

Engineering unit identifier

S6

High alarm

High alarm value in engineering units

S7

Low alarm

Low alarm value in engineering units

S3

Value zero

Low value in engineering units

S4

Span + value
zero

High value in engineering units

S5

EUID

Engineering unit identifier

S7

High alarm

High alarm value in engineering units

S8

Low alarm

Low alarm value in engineering units

3.14.11View Configuration
It is possible to view the function code configuration of a configuration file located in the project or executing in a controller
using the Configuration Viewer. The function code configuration of a control logic document can also be viewed. In addition
to being viewed, the function codes can be modified, tuned, read, and deleted. New function codes can be added also.

NOTE: Once the configuration viewer is populated through a summary upload, any blocks in the specified range that
are already being shown in the configuration viewer will be added to the displayed list a second time if a read block
range operation is performed. To avoid this condition, exit the configuration viewer and restart it with the targeted
block range selected.

3.14.11.1 Controller Configuration


To view the function code configuration of the configuration file currently executing in a controller:

1.

Verify the Composer application is connected (through the run-time menu) to the actual
control system.

2.

Right click the controller and select Run Time > View Configuration.

3.14.11.2 Configuration File or Control Logic Document


To view the function code configuration of a configuration file located in the Composer project or control logic document,
right click the configuration file or control logic document and select View (for configuration file) or View Configuration (for
control logic documents).

3.14.11.3 Filter Function Codes


Filter the display of function codes in the configuration viewer window by selecting the appropriate column heading. The list
is sorted in alternating ascending and descending orders.

3.14.11.4 Add Function Block


To add a function block to the configuration:

1.

Right click anywhere in the configuration viewer window and select Add Block... from the
pop-up menu.

2.

Enter the function code number in the add function code dialog box.

3.

Enter the function block number and click OK.

3.14.11.5 Read Specific Function Blocks


To read specific function blocks or a range of function blocks and their specifications:
2VAA000812R0001

3-61

View Configuration

3. Project Architecture

1.

Right click the function block or anywhere in the configuration viewer window and select
Read Block Range... from the pop-up menu.

2.

Verify the all blocks option is disabled.

3.

Enter the function block numbers or range of numbers in the read block range dialog box. Separate
numbers or ranges of numbers with commas. Use a hyphen to separate beginning and ending range
numbers.

4.

Click OK.

3.14.11.6 Delete Function Block


To delete a function block from the configuration, right click the function block to be deleted and select Delete Block... from
the pop-up menu.

3.14.11.7 Modify Specifications


To modify the specifications of a function code:

1.

Right click the function block containing the function code to be modified and select Modify
Specs from the pop-up menu.

The spec edit dialog box appears. This dialog box shows the function block number and all the specifications that can be
modified. The specifications for all function codes can be filtered by selecting one of the following filters.
All
Displays all usable specifications.
Inputs
Displays only input specifications.
Internal
Displays only internal specifications.
Tunable
Displays only tunable specifications.
Online Configuration
Displays only online configuration specifications.
Depending on the function code, more filters are available. These filters include:

Analogs
Digitals
Failure Def
Hardware
Input
Input Addrs
Masks
Min/Max
Module
Output
Output Addrs
Port Def
Signal
Simulation
Thermocouple
Times
Tune Params
Z11 - Z15
Z21 - Z25
Z31 - Z35

3-62

2VAA000812R0001

3. Project Architecture

View Properties

Z41 - Z45
Z51 - Z55
2.

Select the specification to be modified.

3.

Edit the value of the specification as desired. The Minimum, Maximum, and Default buttons set the
value to the indicated number. The Default All button sets all the specifications to their default values.

4.

Click OK.

3.14.11.8 Tune Specifications


To tune the specifications of a function code:

1.

Right click the function block containing the function code to be tuned and select Tune
Specs from the pop-up menu.

The dialog box shows the function block number and all the specifications that can be tuned. Use the specification filters
(refer to Modify Specifications) to search for the specification to be tuned.

2.

Select the specification to be tuned.

3.

Tune the value of the specification as desired. The Minimum, Maximum, and Default buttons set the
value to the indicated number. The Default All button sets all the specifications to their default values.

4.

Click OK.

3.14.11.9 Summary Uploads


To instruct the configuration viewer to initially upload just a function code-to-function block map:

1.

Select Tools > Options....

2.

Enable the Allow Summary Uploads option and click OK.

NOTE: Changes made to summary upload data can not be saved as a .CFG file.

3.14.11.10 Save Changes


To save changes made to a function code configuration as the latest revision:

1.

Select File > Save as....

2.

Enter the name of the revision in the save configuration dialog box and click OK.

3.14.12View Properties
To view or edit the properties of a part of a project:

1.

Right click the desired part and select Properties.

2.

View or edit (if the current user has access) the desired properties in the properties dialog box.

3.

If a human system interface was selected, use the FTP tab to view information about any associated
FTP sites. Information presented on the tab consists of:

FTP site number.

FTP site description (optional).

Name or IP address of the workstation containing the site.

User name.

User password (optional).

FTP destination directory.

If necessary, click Add FTP Site and enter the required information to associate a FTP site to this
human system interface. Repeat the procedure as necessary. This information is used when exporting
symbols or displays.
4.

2VAA000812R0001

Click OK.

3-63

Verify

3. Project Architecture

3.14.13Verify
To compare the control logic documents or controller configuration (configuration file) with the same configuration file (same
or different revision) or the configuration file in the controller:

1.

Right click the control logic document, configuration file, or controller containing the items to
be verified and select Run Time > Verify... (controller selected) or Verify... (control logic
document or configuration file selected).

NOTE: Sequence of events controllers can not be verified.

3-64

2.

Select what is to be verified (control logic document or configuration file). The object to be verified is
selected in the source dialog box.

3.

Specify if specifications are to be updated as a result of the verification.

4.

If a configuration file is to be verified, select the revision to be used for comparison.

5.

Click Next.

6.

Select the reference type to compare with the source in the reference dialog box. Selecting Controller
sets the actual controller as the reference. Selecting Configuration sets the configuration file residing
in Composer as the reference.

7.

If a configuration file is the reference, select the revision to be used.

8.

Click Finish.

2VAA000812R0001

4. Tag Configuration

Tag Categories

4. Tag Configuration
The following topics describe how to configure and edit the project tag database through the use of the data browser
functionality. The same methods and procedures described in this section are used when editing lists. With the data
browser view opened, the tags that pertain to any part of the project architecture (except for human system interfaces) can
be filtered out of the whole tag database and viewed by simply selecting that part.
There is one global tag list and any number of user-defined tag lists within a project.
Global Tag List
Contains the tag information that is common to any usage of that tag. The use of a global tag list supports tag linking and
reduces the size of database needed by human system interfaces. Configuration time is reduced since editing of common
information need be performed only once.
User-Defined Tag Lists
Contain the tag information that is unique to a certain human system interface. Within Composer, more than one of these
lists can exist for a human system interface. However, the human system interface can only maintain one user-defined tag
list at a time.
Tags can be defined through the automation architect, added directly into the tag database (data browser functionality), or
imported from another project. Tags added to the project are immediately available for use in lists, displays, and control
logic documents. Changes made to the global tag list are made once and propagated throughout the project.
Whenever a new tag is added, it receives a tag identifier. Tag identifiers are unique to a tag throughout the project and are
used to link the tag to its various points of use. The tag identifier is not editable.
Changes to tags that affect display configurations (specifically tag name, type, or index) are not automatically reflected in
the display configurations that use those tags. There are two ways to update display configurations: 1) opening the display
using the graphic display configuration window or 2) using the tag synchronization function. Opening a large number of files
just to update the tag data may be time consuming and inconvenient. It may be more convenient to update displays using
the tag synchronization function.

4.1

Tag Categories
There are three general categories of tags. One type defines a process control point that is monitored by the human system
interface over the control network. These tags have an associated exception reporting function code that outputs the point
value and alarm conditions of the point. Depending on the function code associated with the tag, the operator may also be
able to control the point.
The second category of tag defines an internal value to be monitored: either from an application processor task or from a
human system interface peripheral. There are no associated function codes and no values are received over the control
network for these tags.
A third tag category receives status information and problem reports from Symphony equipment over the control network. It
does not have an associated function code.
For tags that have an associated function code in the controller configuration, the control network, Harmony control unit,
controller, and block address of the exception reporting function code essentially define the tag. If a tag is defined in the
human system interface data with a corresponding address, then when information from that function code is exception
reported to the control network, the human system interface can receive the value, alarm conditions, and other information
from the function code. The information received and used by the human system interface depends on the function code
and how the tag is configured in the console database. Refer to Field Information Tables for descriptions of each specific
tag type.

4.2

Descriptor Fields
The text descriptor fields that appear in the data browser include the engineering unit descriptor, zero, one, two, and three
state descriptors, feedback descriptors, permissive state descriptors, and alarm comment descriptors. Whether these fields
are applicable depends on the tag type. The descriptor text can be edited but only if the result is a valid descriptor that
exists in the engineering units descriptor, logic state descriptor or alarm comment list. When selecting an engineering unit
descriptor, logic state descriptor, or alarm comment for a tag field, the pull-down list provides details of the available
choices. If a very large number of choices exists, the dialog box can not hold them all so a <MORE> choice is provided.
Selecting <MORE> opens a data browser-like dialog box which allows the viewing of all the available choices. Select one
and click OK.
New engineering unit descriptors, logic state descriptors, and alarm comments can be added in two ways. One method is to
open the appropriate list (engineering unit, logic state, or alarm comment) and enter a new record. This data is now
available throughout the project.
Another method, available while in the data browser, is to:

1.

Click in the tag field requiring a new engineering unit descriptor, logic state descriptor, or
alarm comment.

2.

Select <NEW> from the pull-down list provided.

3.

Enter an index in the Index field.

2VAA000812R0001

4-1

Field Data and Format

4.3

4. Tag Configuration

4.

Enter a descriptor in the Descriptor field.

5.

Click OK.

Field Data and Format


Field data types are either character or numeric, depending on the information the field needs. Fields also have a maximum
number of characters or maximum numeric value range that they will accept. The Format column (Refer to Field
Information Tables.) indicates its width and whether it is character (C) or numeric (N). Some fields have a fixed number of
valid choices. For example, the tag type field accepts only valid tag types. Other fields are indeterminate and accept any
combination of characters and numerals, such as the tag description field. Generally, a pop-up list of valid inputs appears if
an input error is made.

4.4

Field Location
The Location column (Refer to Field Information Tables.) indicates whether a field is global (G) or linked to an engineering
unit descriptor list (E), logic state descriptor list (L), alarm comments list (A), or user-configured tag list (C).

4.5

Field Sources
Data in the tag fields can be sourced and maintained from different Composer windows as follows:

4.6

Fields sourced by the automation architect window are indicated by an M in the Source column of Table 4-8. These
fields are updated by the automation architect and are not editable by the data browser (with one exception).
Network, HCU, Controller, and Block fields are editable until the tag is assigned to a function code by the
automation architect. Additionally, all global fields (G in the Location field) can be updated by the automation
architect and are used by the human system interface.

Fields sourced by the data browser window are indicated by a C in the Source column (Refer to Field Information
Tables.). These fields are used by the human system interface.

Fields sourced by data browser window as information only fields are indicated by an I in the Source column (Refer
to Field Information Tables.). Information only fields provide documentation for tags but are not required for the
system to function.

Fields sourced by the data browser window as automatically generated fields are indicated by an A in the Source
column (Refer to Field Information Tables.). These fields are only used internally by Composer and are not
editable by the data browser.

Engineering Unit Descriptor List


Engineering unit descriptors describe the unit of measurement for a value received from a process; for example, DEG F,
GPM, AMPS, LB/HR. A list of these descriptors is maintained and configured separately from the tag list. A single
engineering unit descriptor (EUD) list serves the whole project. The engineering unit descriptor is entered into the tag list for
reference only. The actual engineering unit descriptor is defined in the controller and when the human system interface
goes online, the controller engineering unit index from the controller is read and the engineering unit descriptor
corresponding to the index is used by the human system interface.
An engineering unit has two parts. Its index number, located in the EU Index column, is one part. Its text description, located
in the EU Descriptor column, is the other. A total of 256 engineering units can be defined in the EUD list. Those descriptors
with indices zero through 15 are predefined and cannot be changed. The remaining descriptors with indices 16 through 255
can be edited.

4.7

Logic State Descriptor List


Logic state descriptors show the current logic state of a device; for example, ON or OFF, ZERO or ONE, RUN or STOP, or
CLOSED or OPEN. A list of these descriptors is maintained and configured separately from the tag list. A single logic state
descriptor (LSD) list serves the whole project. The logic state descriptor is entered into the tag list and, unlike in the case of
engineering units, the human system interface does refer to the tag database for the correct descriptor. The controller does
not report an index number of a logic state descriptor.
A logic state has two parts. Its index number, located in the LS Index column, is one part. Its text description, located in the
LS Descriptor column is the other part. A total of 256 logic states can be defined in the LSD list. Those descriptors with
indices zero through 15 are predefined and cannot be changed. The remaining descriptors with indices 16 through 255 can
be edited.

4.8

Alarm Comments List


Alarms inform the operator of process problems. It is the responsibility of the user to be aware of points that require
monitoring for alarm conditions and to instruct the operator on proper action to take in the event of an alarm.
One way the operator can be assisted in properly responding to an alarm is the use of alarm comments. These are
messages that can be configured by the user to be displayed when specific alarm conditions occur. The messages can
either provide information about the alarm condition, or inform the operator as to the proper action to take: for example,
Turn off pump G12. It is the responsibility of the user to determine the proper alarm comments and to configure the display

4-2

2VAA000812R0001

4. Tag Configuration

Tag Lists

to incorporate each comment. An alarm comment has two parts. Its index number, located in the AC Index column, is one
part. Its text descriptor, located in the AC Descriptor column, is the other part. A total of 20,000 alarm comments can be
defined in the alarm comment list.

4.9

Tag Lists
The global tag list holds all of the tags defined for the whole project. The total number of tags contained in a project is often
so large that a human system interface can not hold them all. For this reason, place only the tags used by a particular
human system interface into a tag list and then assign that list to that human system interface. This tag list will be
downloaded to the human system interface. Adding tags from the global tag list to a user-defined tag list can be done with
the standard Windows copy and paste functionality or the drag and drop functionality.

4.10 Configuration Server Lists


The following nine lists are associated with configuration server (Operate IT Process Portal real-time data server) tags:

Areas.

Equipments.

Units.

Security groups.

Graphic displays.

Trend displays.

Group displays.

Historian servers.

Historian atom collections.

These lists are used to organize the Operate IT Process Portal tags into logical groups if desired. The names of appropriate
items can be added to the corresponding list (Generator 2B to the equipments list, Operators to security groups list, etc.). A
tag is associated with these lists through the Operate IT Process Portal pages of the tag property pages. These pages
provides fields for association to project architecture objects (area, equipment, and unit), security groups, associated views
(trend, group, section, and overview), a text string, and historian definitions (historian server and atom collection). A
graphic, trend, or group display can be defined as a section or overview display.

Data Browser
The data browser function allows the viewing and editing of data records. To enable the data browser view, select View >
Data Browser from the Composer window. Right clicking a list and selecting Open will also enable the data browser view.
The right side of the system architecture window changes to a table displaying the data records that pertain to the selected
part of the project architecture. Select the project to get the most complete (global) tag database listing.
The data browser view consists of a table organized by rows and columns. The rows contain the information that belongs to
a record. Each column identifies a data field that contains a particular item of information. Each of these items of information
is stored as a unique field within the record. The fields that apply to a particular record depend upon the data type of the
selected list and the category of the current record. Blacked out fields do not apply, shaded fields are not editable, and nonshaded fields are fully editable.

NOTE: Only the complete contents of the data browser can be exported. Individual records within the current view
can not be exported.

4.11 Views
Views are ways of looking at data. Composer provides a number of standard views. These views can be edited but not
saved. However, the standard views can be copied, edited, and saved to create a custom view. Custom views can be
created using any valid fields, filter criteria, and sort criteria. Views can be created, modified, saved, selected, and a listing
of valid views can be viewed.

4.11.1 Create
To create a new view:

1.

Select Tools > Manage views.

2.

Select the data type to be used in the new view.

3.

Click New in the manage views dialog box.

2VAA000812R0001

4-3

Copy

4. Tag Configuration

4.

Enter a name for the view in the create view dialog box and click OK. The name of the new view
appears in the list of available views.

To create a new view that is identical to the current view:

1.

Select Browser > Save View As.

2.

Enter a name for the view in the save view as dialog box and click OK.

NOTE: View name can only contain alphanumeric, forward slash, parenthesis, underscore, hyphen, empty space,
and period characters. Using other characters may cause runtime errors when selecting the view for display. If this
error is displayed, delete the view using the Tools > Manage View option.

4.11.2 Copy
To create a new view that is identical to an existing view:

1.

Select Tools > Manage Views.

2.

Select the data type of the view being copied.

3.

Select the view being copied from the list.

4.

Enter a name for the new view in the copy view dialog box and click OK.

4.11.3 View List


To view a list of all the views that apply to a data type:

1.

Select Tools > Manage Views.

2.

Select the appropriate data type.

A list of the views associate with the selected data type is provided in the upper part of the manage view dialog box. The
lower part lists the fields used in the view along with any filter and sort criteria used.

4.11.4 Modify
It is possible to modify the current view to use specific fields, filter criteria, and sort criteria. A standard view for each type of
list is used when the data browser is opened for the first time. The name of this view is listed in the output window and is
considered the current view for that type of list. Save any changes made to the current view using Browser > Save View or
Browser > Save View As or these changes will be lost when the view is closed. If the view was saved, it will be used the
next time a list of same type is opened.
Fields
To specify the fields to contained in the current view:

1.

Select Browser > Modify Current View.

2.

Click Fields in the modify view dialog box.

3.

Move fields from the available fields list to the selected fields list (fields that will be displayed) or vice
versa by selecting the fields and using the appropriate button in the user defined fields dialog box

4.

Arrange the fields in the desired order (top of the list is the left most column and bottom of the list is
the right most column) by selecting the field and using the up and down buttons.

5.

Click OK.

Filters
To specify the filter criteria to be used in the current view:

1.

Select Browser > Modify Current View.

2.

Click Filters in the modify view dialog box.

The filter by dialog box will appear.

4-4

3.

If a relatively simple condition is to be configured, select a field whose value will be used in the filter
criteria and proceed to the next step. If a more complex condition is required, proceed to the next
step. The fields to search list contains all the currently viewable fields.

4.

Click Add Where Cond (for a relatively simple condition) or Add Adv Where (for a more complex
condition).
2VAA000812R0001

4. Tag Configuration

Modify

5.

If the Add Where Cond button was used, proceed to the next step. If the Add Adv Where button was
used, proceed to Step 8.

6.

Select the condition by which the field is true.

NOTE: Some fields have different condition configuration options.


7.

Proceed to Step 12.

8.

Enter an expression in the Expression1 field in the advanced filter builder dialog box. Refer to the first
table for information about the special search characters (standard SQL functionality), second table
for information about the string functions (standard Visual Basic functions), and third table for
information about the math functions (standard Visual Basic functions).

NOTE: Standard SQL syntax, along with standard Visual Basic string and math functions, is used in this dialog box.
9.

Select an operation in the Operation field.

Table 4-1 Special Search Characters (Filter & Find)


Character

Description

Example

Matches any number of alphabetic


characters. It is used as the first or last
character in a string.

wh* finds what, white, etc.

Matches any single alphabetic character.

b?ll finds ball, bell, etc.

[]

Matches any single alphabetic character


within the brackets.

b[ea]ll finds ball and bell but


not bill.

[! ]

Matches any single alphabetic character


not within the brackets.

b[!ae]ll finds bill and bull but not


ball or bell.

Matches any one of a range of alphabetic


characters. the range must be specified in
ascending order (A to E, L to Z, etc.).

b[a-c]d finds bad, bbd, and


bcd.

Matches any single numeric character.

1#3 finds 103, 113, etc.

Notes:
1. Use these special search characters with string or text data types.
2. When searching for an asterisk, question mark, number sign, opening bracket or hyphen, enclose it
in brackets.
3. When searching for a hyphen and other character simultaneously, the hyphen must be before or
after all the other characters
but inside the brackets. However, the hyphen must be placed after an exclamation point (if being
used).
4. Searching for an exclamation point or closing bracket does not require brackets.

Table 4-2 String Functions

Name

Dialog Box
Using
Function

Description

Where,
Replace

Allows entering of a text string or special characters


(wildcards).

Where,
Replace

Concantenates (links) two strings together.

IIf

Where,
Replace

Returns one of two parts, depending on the evaluation of the


expression.
Syntax:

2VAA000812R0001

IIf(expr, truepart, falsepart)

4-5

Modify

4. Tag Configuration

Table 4-2 String Functions (Continued)

Name
InStr

Dialog Box
Using
Function
Where,
Replace

Description
Returns a number specifying the position of the first
occurrence of one string within another.
Syntax1:

LCase

Replace

Returns the specified string converted to lower case.


Syntax:

Left

Where,
Replace
Where,
Replace
Where,
Replace
Where,
Replace
Where,
Replace
Where,
Replace

Str
String

Returns a string consisting of the specified number of spaces.

Where,
Replace

Returns a string representation of a number.

Where,
Replace

Returns a string containing a repeating character string of the


specified length.

Syntax:
Syntax3:

Where,
Replace
Replace

Space(number)
Str(number)

String(number, character)

Returns a string containing the specified string without leading


or trailing spaces.
Syntax:

UCase

RTrim(string)

Where,
Replace

Syntax:
Trim

Right(string, length)

Returns a string containing the specified string without trailing


spaces.
Syntax2:

Space

Mid(string, start[, length])

Returns a string containing the specified number of characters


from the right side of a string.
Syntax:

RTrim

LTrim(string)

Returns a string containing the specified number of characters


from a string.
Syntax:

Right

Len(string)

Returns a string containing the specified string without leading


spaces.
Syntax:

Mid

Left(string, length)

Returns a long containing the number of characters in a


string.
Syntax:

LTrim

LCase(string)

Returns a string containing a specified number of characters


from the left side of a string.
Syntax:

Len

InStr([start, ]string1, string2)

Trim(string)

Returns the specified string converted to upper case.


Syntax:

UCase(string)

NOTES:
1. The compare parameter is not supported.
2. Does not effect Access data but will effect SQL Server data.
3. Adds a leading space for the sign if the number is positive.

4-6

2VAA000812R0001

4. Tag Configuration

Modify

Table 4-3 Math Functions

Name

Dialog Box
Using
Function

Description

Where,
Replace

Multiply

Where,
Replace

Add

Where,
Replace

Subtract

Where,
Replace

Divide

Abs

Where,
Replace

Returns the absolute value of a number in the same type


format as the number.
Syntax:

Abs(number)

number can be any valid numeric expression. If number


contain null, null is returned. If number is an uninitialized
variable, a value of zero is returned.
Int

Where,
Replace

Removes the fractional part of a number and returns the


integer portion of the number.
Syntax:

Int(number)

number can be a double or any valid numeric expression. If


number contain null, null is returned. If number is an
uninitialized variable, a value of zero is returned. If number is
negative, the first negative integer less than or equal to
number is returned (-8.4 is returned as -9).
Round

Where,
Replace

Returns a number rounded to a specified number of decimal


places.
Syntax: Round(number, numdecimalplaces)

Val

Where,
Replace

Returns the numbers contained in the specified string as a


numeric value of the appropriate type.
Syntax:

Val(string)

string can be any valid string expression.


10. Enter an expression in the Expression2 and Expression3 (if the between operation was selected)
fields.
11. Click Validate to have the condition checked for being valid. Correct the condition if necessary.
12. Click OK.
13. Repeat Steps 3 through 12 as required.
NOTE: AND logic operators are automatically placed between field conditions.
14. Edit any field condition by selecting the expression and clicking Modify.
15. Edit the filter logic expression by inserting the cursor at the desired location and selecting the desired
logic operator.
16. Click OK.
Sorts
To change the sort order of one or more fields in the current view:

1.
2VAA000812R0001

Select Browser > Modify Current View.


4-7

Save

4. Tag Configuration

2.

Click Sorts in the modify view dialog box.

3.

Select the field whose order is to be changed in the sort tag by dialog box.

4.

Click Add. The field name is added to the Sort Fields field along with an indication of the present sort
order.

5.

Select the field name.

6.

Click DESC (for descending order) or ASC (for ascending order).

7.

Repeat Steps 3 through 6 for all fields being changed.

8.

Configure the order in which the sorts will take place by selecting a sort field and moving it to the
correct position using the up and down buttons. The top sort field is sorted first, then the sort field
below it, and so on.

9.

Click OK.

4.11.5 Save
To save the current view, select Browser > Save View or Browser > Save View As.

4.11.6 Select
To select a new view:

1.

Select Browser > Select View.

2.

Select the view from the list provided and click OK.

4.12 Tag Information


Conductor VMS, Conductor NT, and Maestro views of the tag database are different. One important difference is the length
of the Tag Name and Tag Description field. Tag names are limited to 32 characters for Conductor VMS, 40 characters for
Conductor NT, and 32 for Maestro. Tag descriptions are limited to 14 characters for Conductor VMS, 16 characters for
Conductor NT, and 64 for Maestro. Tag names and descriptions are unchanged when switching context. However, editing a
tag name or description forces it to adhere to the limits imposed by the current context. When using the data browser, it is
desirable to view the data in the format that pertains to the human system interface being configured. To select the correct
format, select Tools > Options and edit the console tab to reflect the proper context.

4.13 Add Records


There are two methods of adding a record to a list.
To add a record to the selected list (method one):

1.

Fill in the asterisked row of the data table with the record data.

2.

Place the cursor in a field of another row.

The row will automatically receive a number and a new row (with an asterisk) is created.
To add a record to the selected list (method two):

1.

Select Browser > Add new record....


- or Double-click the row header of the asterisked row.
- or Click the tag icon in the Tag Name field of the empty record.

2.

Fill in the data fields of the new record. If the new record is a tag, fill in the Name, Type, Description
(optional), and Customer Tag ID (optional) fields of the tag property dialog box and select OK or
Apply.

NOTE: The tag property dialog box for adding tags can also be displayed by double-clicking the row header of the
asterisked row.
Using OK causes the data to be saved and control is returned to the data browser. Using Apply also causes the data to be
saved but control remains in the tag property dialog box.

4-8

2VAA000812R0001

4. Tag Configuration

Copy Records

4.14 Copy Records


To copy records from one list to another, select the records and use the standard Windows copy and paste functionalities.
This procedure will copy records within the same project and to other projects. When copying tag records from a global list
to a user-defined list, human system interface specific fields are created and set to default values. If the index of a tag to be
copied already exists in the destination list, that tag is not copied and a message stating so is placed in the output window.
If this tag was part of a group of tags being copied, the copy operation would continue after handling the tag as previously
described.
The copying of records from one project to another is handled the same way as internal copying except that a duplicate tag
name error (instead of a message) is placed in the output window when the tag index already exists in the destination. Tag
data fields that can not be updated or changed with the information from the destination project are set to the default value
and this action is logged into the output window.
When pieces of the system architecture of a project (control network, Harmony control units, controllers, and human system
interfaces) are moved or copied, all the components of the piece are also moved or copied. Tag records are one of the
components. Unlike individual tag records, copying system architecture pieces to a destination that already contains the
same tag indexes causes the information in the destination tags to be overwritten. Hardware address information in the
moved or copied tags is changed or updated to reflect the new location.

4.15 Delete Records


To delete one or more records from the list:

1.

Select the record or records to be deleted.

2.

Right click the last (or only) selected record and select Delete Current Row (or depress DELETE).

NOTE: Deleting records from a global tag list that are used in other lists initiates a dialog box that states so and
requires an OK input to continue.

4.16 Edit Records


Non-shaded fields in a selected list can be edited and saved one row at a time or edited and saved at the end of the
session. A session is the editing of a list as a whole which begins with the locking (making uneditable to all others) of all
records in that list and ends with the unlocking of all records in that list. When editing one row at a time, only that row is
locked.
To edit fields in one row at a time:

1.

Edit the fields in one row as desired. The lock symbol will appear in the row header as soon
as the first change is made.

2.

Click in a field in the next row to be edited. The edited row is saved and unlocked.

To edit the list as a whole:

1.

Select Browser > Lock all records. The lock symbol will appear in the row header of all the
rows.

2.

Click Yes when asked if all records are to be locked.

3.

Edit the fields and rows as desired.

4.

Select Browser > Unlock all records.

5.

Click Yes when asked to confirm the saving of changes. The edited rows will be saved and all rows
will be unlocked.

To automatically lock all the records of each list as they are selected, select Browser > AutoLock all Records. Repeat the
procedure to disable this functionality.

4.17 Field Vocabularies


Composer provides the ability to select one of the text or number based fields in the current data browser view and get a
listing of all the unique numbers or words contained in that field for all the records. Also displayed is a count of how many
times each number or word occurs. The listed numbers or words can be edited and that change can be propagated (one
field at a time or all at once) throughout all the records in the view. To use the vocabularies function:

1.

Select Browser > Find/Replace records....

2.

Click Vocabulary List... on the replace tab.

3.

Select the field of interest in the field vocabularies dialog box and click Scan Field.

The selected field in all the records in the view are scanned and a listing is displayed. Column A is the number or word
listing and column B is the number of occurrences.

2VAA000812R0001

4-9

Find Records

4. Tag Configuration

4.

If a listed number or word is to be updated, proceed to the next step. If no updating is required,
proceed to Step 10.

5.

Edit the number or word as required.

6.

Click Find First. The cursor is moved to the first data browser field (starting from the first record) that
contains the unedited number or word.

7.

View the Current Value and Updated Value (displays the resulting value if replace functionality is
used) fields and verify the correct action is to be performed.

8.

Click Replace, Replace All, or Find Next.

9.

If there are multiple occurrences of the number or word, repeat Steps 7 and 8 until all occurrences
are updated.

10. Repeat Steps 3 through 9 for each data browser field of interest.

4.18 Find Records


To find a specific record in the records currently displayed:

1.

Select Browser > Find/Replace records....

2.

Select the find tab.

3.

If a relatively simple condition is to be configured, select a field whose value will be used in the find
criteria and proceed to the next step. If a more complex condition is required, proceed directly to the
next step. The Field to Search list contains all the currently viewable fields of the list.

4.

Click Add Where Condition.... (for a relatively simple condition) or Advanced... (for a more complex
condition).

5.

If the Add Where Cond... button was used, proceed to the next step. If the Advanced... button was
used, proceed to Step 8.

6.

Select the condition by which the field is true.

NOTE: Some fields have slightly different condition configuration options.


7.

Proceed to Step 12.

8.

Enter an expression in the Expression1 field in the advanced filter builder dialog box. Refer to the first
table in the Modify topic for information about the special search characters (standard SQL
functionality), the second table in the Modify topic for information about the string functions (standard
Visual Basic functions), and the third table in the Modify topic for information about the math
functions (standard Visual Basic functions).

NOTES:
1. Standard SQL syntax (with standard Visual Basic string and math functions) is used in this dialog box.
2. Use double quotation marks around string fields
9.

Select an operation in the Operation field.

10. Enter an expression in the Expression2 and Expression3 (if the between operation was selected)
fields.
11. Click Validate to have the condition checked for being valid. Correct the condition if necessary.
12. Click OK.
13. Repeat Steps 3 through 12 for the remaining fields (in left-to-right order).
NOTE: AND operators are automatically placed between field conditions.
14. Edit any field conditions by selecting the expression and selecting Modify.
15. Edit the find logic expression by inserting the cursor at the desired location and selecting the desired
logic operator.
16. If the find filter may be needed again, save it by clicking Save Filter and proceed to the next step. If
the find filter is not being saved, proceed to Step 18.
17. Enter a name for the filter in the save/replace filter dialog box.
4-10

2VAA000812R0001

4. Tag Configuration

Go to Record

18. Click OK.


19. Click the appropriate find button and the cursor will be placed in the record.

4.19 Go to Record
To move the cursor to a specific record in the list:

1.

Select Browser > Go To Row.

2.

Enter the row number in the dialog box and click OK.

4.20 Refresh Records


There are three refresh functions available in the data browser. These functions cause the data browser to reread the
selected records from the project thereby updating these records to reflect the latest record information.
To refresh one or more records:

1.

Select the record or records to be refreshed.

2.

Right click in an editable field in one of the selected records and select:

Refresh Row or Refresh Selected Rows from the pop-up menu.


- or Browser > Refresh Row or Browser > Refresh Selected Rows.
To refresh all the records in the current view, select Browser > Refresh View.

4.21 Reorder Columns


To change the order in which columns are displayed:

1.

Select the column being moved.

2.

Drag the column to a position where a red line indicates the desired insertion point.

The order in which columns are displayed can also be changed while modifying the data browser view from the modify view
dialog box. Refer to Modify for more detailed information.

4.22 Replace Records


To replace the value of a field with another value:

1.

Select Browser > Find/Replace records....

2.

Optionally use the find records functionality to limit the displayed records to only those receiving the
replacement values. Refer to Find Records for more information.

3.

Select the replace tab.

4.

If a relatively simple replace pattern or value is to be configured, select the field whose value is to be
replaced from the list. If a more complex pattern or value is required, proceed to Step 10.

5.

If a previously saved replace filter is to be used, select the name in the saved replace specifiers field
and proceed to Step 23.

6.

Click inside the Pattern to replace field.

7.

Enter the current field value that is going to be replaced.

8.

Enter the desired field value.

9.

Proceed to Step 23.

10. Click Advanced.... The advanced replace pattern builder dialog box appears.
11. Select the field containing the text value being replaced.

2VAA000812R0001

4-11

Replace Records

4. Tag Configuration

12. Enter an expression (limited to text, numbers, and the special search characters) enclosed in double
quotation marks into the Expression To Search For field. Refer to the following table for more
information about the special search characters.

Table 4-4 Special Search Characters (Replace)


Character

Description

^ape finds ape within apes but


not within grapes.
Just[^5-9] finds Just4 or JustA
but not Just8.

^ (caret)

Marks the beginning of the string or


(when following an open bracket)
excludes the remaining characters within
the brackets.

Matches the characters when they are at ick$ finds ick within sick but not
the end of a string.
within sickness.

The alternation symbol allows the


expression on either side of the line to
match the target string.

fe|ty finds fe and ty within


lifestyles.

Matches any character.

.. finds tw, 0-, by, -t, and wo


within two-by-two.
a... finds arke within harken but
nothing within park.

Matches the expression to the left of the


asterisk zero or more times.

a* finds aa and a within


aardvark but nothing in lion.
an* finds ann and a within
cannibal.
a[bcd]*g finds abbg, abg, ag
and abcg.
gh* finds g and g within doggie.
(.*)(h*) finds goat within goat
and father within father.

NOTES:
1. If a* is by itself or if more as will be found, the
empty string (zero as) will not be found.
2. If a* is used by itself, it acts like a+.

NOTE: Placing the same search string


inside brackets changes the definition
from matching a string on either side of
the | to matching the character on either
side of the |. [fe|ty] finds f, e, t, y, and e
within lifestyles.

Matches the expression to the left of the


addition sign one or more times.

a+ finds aa and a within


aardvark.
an+ finds ann within cannibal.
a(abc)+ finds aabc and
aabcabc but not abc.
gh+ and (.+)(h+) finds nothing
within doggie.
(.+) finds goat within goat.

Matches the expression to the left of the


question mark zero or one time.

a? finds aa and a within


aardvark.
an? finds an and a within
cannibal.
gh? finds g and g within doggie.
o?g finds og and g within
doggie.
(.?)(h?) finds g, o, a, and t
within goat.

NOTES:
1. If a? is by itself, a will be found but the empty
string (zero as) will not be found.
2. If a? is by itself, it acts like a+.

4-12

Example

2VAA000812R0001

4. Tag Configuration

Replace Records

Table 4-4 Special Search Characters (Replace) (Continued)


Character
()

Description

Example

Affects the order of pattern evaluation


and serves as a tagged expression. This
tagged expression can be used when
replacing a substring with the expression.

If \0 indicates a tagged
expression representing the
entire substring that was
matched. If the substring that
matched the regular expression
is abcd, a replace expression of
xyz\0xyz will changed it to
xyzabcdxyz. Other tagged
expressions can be represented
by \1, \2 .. \9. Although the
tagged expression \0 is always
defined, tagged expressions 1
through 9 are only defined if the
regular expression used in the
search has enough sets of
parenthesis.
Initial value:
lifestyle
Pattern to replace field value:
(.*)fe(.*)
Replace with field value:
\1\2\2\0
Updated field value:
listylestylelifestyle
NOTE: When using the alteration
character within a tagged expression, the
last match found when parsing from left to
right is used.

Initial value:
lifestyles
Pattern to replace field value:
(.*)(fe|ty)(.*)
Replace with field value:
\1add\3
Updated field value:
lifesaddle
[]

Matches any of the enclosed characters. [gd] finds d, g, and g within


doggie.
[*] finds * and * within #$%**&^.
[**]+ finds ****+ within
#%****+&.

2VAA000812R0001

Matches any of a range of characters


when used within brackets.

[a-e] finds e and a within meat.

4-13

Replace Records

4. Tag Configuration

Table 4-4 Special Search Characters (Replace) (Continued)


Character
\

Description

Example

Matches the specific character to the


\$ finds $ within #$%**&^.
right of the backslash (use the [ ]
\xx\+ finds xxx+ within
characters to replace * and ? characters). #%**xxx+&.
Initial value:
Mr.
Pattern to replace field value:
(Mr)(\.)
Replace with field value:
\1s\2
Updated field value:
Mrs.
Initial value:
abc
Pattern to replace field value:
(a)b(c)
Replace with field value:
&-\1-\2
Updated field value:
abc-a-c
Initial value:
bcd
Pattern to replace field value:
(a|b)c*d)
Replace with field value:
\0-\1
Updated field value:
bcd-b
Initial value:
abcde
Pattern to replace field value:
(.*)c(.*)
Replace with field value:
&-\1-\2
Updated field value:
abcde-ab-de
Initial value:
cde
Pattern to replace field value:
(ab|cd)e
Replace with field value:
&-\1
Updated field value:
cde-cd

NOTE: Regular expression syntax (with standard Visual Basic string and math functions) is used in this dialog box.
NOTE: Advanced replace expressions are case sensitive and support scientific notation. All other expressions used
in Composer are not case sensitive and do not support scientific notation.
13. Enter an expression in the Expression To Replace field. Refer to the following table for information
about the special replace characters, the second table in Modify topic for information about the string
functions (standard Visual Basic functions), and the third table in the Modify topic for information
about the math functions (standard Visual Basic functions).
NOTE: Only plain text, simple numbers, and special replace characters need be enclosed in double quotation marks
in the Expression To Replace With field.
4-14

2VAA000812R0001

4. Tag Configuration

Select Columns

Table 4-5 Special Replace Characters


Character

Description

Identifies tagged expressions 0 through 9. \0 represents


the entire substring.

&

Represents the entire substring.

14. To test the advanced replace criteria (if desired) or just become familiar with advanced replace
criteria in general, click Practice Dialog. If testing or practice is not required, proceed to Step 23.
NOTE: The advanced replace patterns practice dialog box supports only text, numbers, special search characters,
and special replace characters.
15. Enter the whole value of the field containing the text or value to be replaced in the String to Be
Replaced field.
16. Enter the string that is to be replaced in the Search For field.
17. Enter the replacement string in the Replace With field.
18. Click Replace Text. The Resulting String field displays the end result if this operation really
happened.
19. Repeat Steps 15 through 18 as required.
20. Click Exit.
21. Click OK. The replace expression is validated and a dialog box stating the result is displayed.
22. Click OK to complete configuration of the advanced replace criteria (if criteria is valid) or to return to
the advanced replace pattern builder dialog box (if criteria is not valid).
23. Use the Find First, Find Next, Replace, Replace All, and Undo Changes (restores data after a
replace all operation) buttons to control the replacement functionality.
24. If desired and after a successful replace operation, save the replace criteria by selecting Save
Replace. Enter the name and click OK.

4.23 Select Columns


Columns can be selected one at a time, or in contiguous and non-contiguous groups.
To select one column, click the column header. The selected column will be highlighted.
To select multiple consecutive columns:

1.

Click (and hold) the header of the first column.

2.

Drag the cursor to the last column and release the button. The selected columns are highlighted.

To select multiple non-consecutive columns:

1.

Click the header of the first column.

2.

Depress CTRL and click the next column.

3.

Repeat Step 2 for the remaining columns to be selected. The selected columns will be highlighted.

4.24 Select Font


To select the font and associated characteristics used to display text information in the data browser:

1.

View the information in the data browser.

2.

Select Browser > Select Font.

3.

Select the font, font style, and size of the text characters.

4.

Choose if strikeout, underline, or normal (no selection required) characters are to be used.

5.

Select the text character color.

6.

Select the appropriate script (character set) and click OK.

2VAA000812R0001

4-15

Select Records

4. Tag Configuration

4.25 Select Records


Records can be selected one at a time, in contiguous and non-contiguous groups, or all at once.
To select one record, click the row header of the record. The selected record will be highlighted.
To select multiple consecutive records:

1.

Click (and hold) the row header of the first record.

2.

Drag the cursor to the last record and release the button. The selected records are highlighted.

To select multiple non-consecutive records:

1.

Click the row header of the first record.

2.

Depress CTRL and click the next record.

3.

Repeat Step 2 for the remaining records to be selected. The selected records will be highlighted.

To select all the records in the current list, Click the Row header (upper left corner of the table). All records will be
highlighted.

4.26 Sort Records


Records are stored in the order in which they are entered. This order is seldom a logical one as records are usually entered
as data becomes available. It is possible to sort the records in a list in ascending or descending order. To sort records:

1.

Select the columns to sort (10 maximum).

2.

Select Browser > Sort Ascending or Browser > Sort Descending.

The tag data will be displayed in the new sort order.


The order in which records are sorted can also be changed while modifying the data browser view. Refer to Modify for more
detailed information.

4.27 Control Logic Documents


To open the control logic document in which a tag is defined, right click in the row containing the tag and select Go To CLD.
It is also possible to open a control logic document by selecting the icon in the CLD name field.

4.28 Tag Properties


The properties of a tag include:

Type.

Name.

Description.

Custom identifier.

Globally unique identifier.

Time the tag was created.

Time the tag was last modified.

Life cycle status.

Identifier of the last user to modify the tag.

Control network, HCU, controller, and function block address of tag.

Name of control logic document that defines the tag.

Name and number of function code that defines the tag.

Level and group security used by the tag.

Other tag specific information.

To view or edit the properties of a tag:

1.

Right click in the left-most box of the row containing the tag and select Properties.
- or Click the tag icon in the Tag Name field of the tag.
- or Double-click in the row header of the tag.

4-16

2VAA000812R0001

4. Tag Configuration

Field Information Tables

2.

View or edit the desired properties in the properties dialog box.

3.

Click OK or Apply. Using OK causes the data to be saved and control is returned to the data browser.
Using Apply also causes the data to be saved but control remains in the property dialog box.

The specific pages included within the tag property dialog box are determined by the context of the view from which they
are accessed. This context is determined by two factors.
The first factor is the type of item selected in the system architecture window. Selecting the project will display all the fields
of the global tag list. Selecting a user-defined tag list will display the global and human system interface specific fields of the
tag list. Selecting a hardware item (control network, Harmony control unit, controller, or human system interface) will display
a subset of the global list containing the tags used by the item.
The second factor is the current console context setting. Console context refers to the format used to display the tag
information which is used by Conductor VMS, Conductor NT, and Operate IT Process Portal human system interfaces. The
format used by the three types of human system interfaces is different.

4.29 Field Information Tables


The following tables provide information about the tag fields.

Table 4-6 Tag Types


Tag

Description

Function
Code

ANALOG

Acquires an analog exception reported value. Supports the


analog exception report function code.

ANALOG
ENH/IN

Acquires exception reported addressing, startup, run-time, FC 222


override, and failure mode specifications for individual or
redundant pairs of analog input channels on a Harmony I/O
block.

ANALOG Acquires exception reported addressing, startup, run-time,


ENH/OUT override, and failure mode specifications for individual or
redundant pairs of analog output channels on a Harmony
I/O block.

FC 30, FC 47,
FC48, FC 70,
FC 158, FC
222, FC 223

FC 223

FC 21, FC 22,
DAANALG Acquires an analog exception reported value providing
FC 23, FC 80,
enhanced alarm management capabilities. Supports data
acquisition only. It incorporates a DA macro that supports a FC177
control station function code. Also supports the data
acquisition analog function code but does not enable the full
functionality of the function code.

2VAA000812R0001

DADIG

FC 211
Acquires a digital exception reported state providing
enhanced alarm management capabilities. Allows selecting
the input source for the function block in a controller and
writing a user-inserted value to the block. Supports the data
acquisition digital function code.

DADIGTL

FC 129
Acquires a digital exception reported state providing
enhanced alarm management capabilities. Supports data
acquisition only. It incorporates a DA macro that supports a
multistate device driver function code.

DANG

FC 177
Acquires an analog exception reported value providing
enhanced multiple level alarming and deviation and rate
alarming. Allows selecting the input source for the function
block in a controller and writing a user-inserted value to the
block. Supports the data acquisition analog function code.

4-17

Field Information Tables

4. Tag Configuration

Table 4-6 Tag Types (Continued)


Tag
DD

Description

Function
Code

Acquires an exception reported set or reset state for a


FC 123
device while it is in either manual or automatic mode. Allows
initiating manual control. Supports the device driver function
code.

DEVSTAT For internal human system interface use only; no values are Not applicable
received over the control network for this type of tag. Allows
the human system interface to monitor the status of its
peripheral devices: keyboards, annunciator display panels,
monitors, printers, touch screens, and data storage devices.
DIGITAL

Acquires a digital exception reported state. Supports the


digital exception report function code.

FC 45, FC 67,
FC 224, FC
225

DIGITAL
ENH/IN

Acquires exception reported addressing, startup, run-time,


override, and failure mode specifications for individual or
redundant pairs of digital input channels on a Harmony I/O
block.

FC 224

DIGITAL
Acquires exception reported addressing, startup, run-time, FC 225
ENH/OUT override, and failure mode specifications for individual or
redundant pairs of digital output channels on a Harmony I/O
block.
INTANG

For internal human system interface use only; no values are Not applicable
received over the control network for this type of tag. Allows
writing an analog value from an application processor that
can be used throughout human system interface functions.

INTDIG

For internal human system interface use only; no values are Not applicable
received over the control network for this type of tag. Allows
writing a digital value from an application processor that can
be used throughout human system interface functions.
Can also be used for a point being recorded in an SOE log.
Writes descriptive tag information to the log.

MSDD

FC 129
Acquires an exception reported status for a three-state
device while it is in either manual or automatic mode. Allows
initiating manual control. Supports the multistate device
driver function code.

N90STA

Reads detailed status information and problem reports from Not applicable
Symphony equipment over the control network.

PHASEX

Provides execution environment for Batch 90 program that FC 218


is interfaced to the Symphony batch management software.
Actually executes the phase logic.

RCM

Acquires an exception reported set or reset state of a device FC 62, FC 99,


and allows initiating control of the device. Used in this way, FC 210
supports the remote control memory function code.
Also monitors operation of a sequential events recorder and
allows requesting sequence of events summary reports.
Used in this way, supports the sequence of events log and
sequence of events slave function codes.

4-18

2VAA000812R0001

4. Tag Configuration

Field Information Tables

Table 4-6 Tag Types (Continued)


Tag

Function
Code

Description

RMCB

Acquires an exception reported start or stop state of a


device and allows initiating control of the device. Supports
the remote motor control function code.

FC 136

RMSC

Acquires an exception reported constant value and allows


changing the value stored in a PCU module. Supports the
remote manual set constant function code.

FC 68

STATION

Monitors the exception reported variables from a control


station while the station is in either manual or automatic
mode and allows changing the control output, set point, or
ratio index. Supports the M/A station basic, M/A station cascade, M/A station - ratio, and control station function
codes.

FC 21, FC 22,
FC 23, FC 80

TEXT

Acquires an exception reported text selector message. The FC 151


message, generated by the controller, contains a message
number that corresponds to a text string defined on the
human system interface. It also contains a color and blink
option. Supports the text selector function code.
A text string can be defined to describe the good, bad, or
wait condition of a device driver block or a multistate device
driver block. Also, a text string can be defined to describe
the good, alarm, or wait condition reported for a remote
motor control block.

FC 194
TEXTSTR Enables communication between the human system
interface and a C language or batch program running in a
controller to allow transfer of text strings. Supports the userdefined data export function code.

Table 4-7 Required Fields


Tag Types
All

Fields
Tag Index (except global tags), Tag Name, Tag Type

Tags with associated


ControlNetwork, HCU, Controller, Block
exception reporting function
code

2VAA000812R0001

N90STA

Loop, Node, Module, Module/Node Type

DEVSTAT

Device Number, Device sub Type (only if applicable),


Device Type.

4-19

Field Information Tables

4. Tag Configuration

ANALOG
ANALOG ENH/IN
ANALOG ENH/OUT
DAANALG
DADIG
DADIGTL
DANG
DEVSTAT
DD
DIGITAL
DIGITAL ENH/IN
DIGITAL ENH/OUT
INTANG
INTDIG
MSDD
N90STA
PHASEX
RCM
RMCB
RMSC
STATION
TEXT
TEXTSTR

Format2

Source3
Location4

Table 4-8 Tag Database Fields

ADS Keyboard

C C

ADS Lamp

C C

ADS Panel

C C

Fields1

4-20

Alarm Comment Alarm

64C

C A

Alarm Comment Alarm Ndx

C C

Alarm Comment Hardware


Failure

64C

C A

Alarm Comment HdwrFail


Alarm Ndx

C G

Alarm Comment High Alarm

64C

C A

Alarm Comment High Alarm


Ndx

C G

Alarm Comment High2 Alarm

64C

C A

Alarm Comment High2 Alarm


Ndx

C G

Alarm Comment High3 Alarm

64C

C A

Alarm Comment High3 Alarm


Ndx

C G

Alarm Comment High


Deviation

64C

C A

Alarm Comment High Devi


Alarm Ndx

C G

Alarm Comment High Rate of


Change

64C

C A

Alarm Comment High RateChg Ndx

C G

Alarm Comment Low Alarm

64C

C A

Alarm Comment Low Alarm


Ndx

C G

Alarm Comment Low2 Alarm

64C

C A

Alarm Comment Low2 Alarm


Ndx

C G

Alarm Comment Low3 Alarm

64C

C A

Alarm Comment Low3 Alarm


Ndx

C G

Alarm Comment Low Deviation

64C

C A

Alarm Comment LowDevi


Alarm Ndx

C G

2VAA000812R0001

4. Tag Configuration

Field Information Tables

Source3
Location4

Format2

Fields1

ANALOG
ANALOG ENH/IN
ANALOG ENH/OUT
DAANALG
DADIG
DADIGTL
DANG
DEVSTAT
DD
DIGITAL
DIGITAL ENH/IN
DIGITAL ENH/OUT
INTANG
INTDIG
MSDD
N90STA
PHASEX
RCM
RMCB
RMSC
STATION
TEXT
TEXTSTR

Table 4-8 Tag Database Fields (Continued)

Alarm Comment Low Rate of


Change

64C

C A

Alarm Comment Low RateChg


Ndx

C G

Alarm Comment Return to


Normal Alarm

64C

C A

Alarm Comment Return to


Norm Ndx

C C

C G

Alarm Comment System Fault

Alarm Comment System Fault


Ndx

Alarm Comment User Defined


Fault

Alarm Comment User Defined


Fault Ndx

Alarm Comment User Defined


Message

Alarm Comment User Defined


Message Ndx

Alarm Deadband

Alarm Group

C C

Alarm Inhibit State

2C

C C

Alarm Inhibit Tag

C G

Alarm Print Inhibit

C G

C G

C G

Alarm Priority Alarm


Alarm Priority Bad Quality

Alarm Priority Hardware Failure


Alarm Priority High Alarm

Alarm Priority High2 Alarm

C G

Alarm Priority High3 Alarm

C G

Alarm Priority High Deviation

C G

Alarm Priority High Rate of Ch

C G

C G

Alarm Priority Low2 Alarm

C G

Alarm Priority Low3 Alarm

C G

Alarm Priority Low Deviation

C G

Alarm Priority Low Rate of Ch

C G

Alarm Priority Low Alarm

2VAA000812R0001

4-21

Field Information Tables

4. Tag Configuration

ANALOG
ANALOG ENH/IN
ANALOG ENH/OUT
DAANALG
DADIG
DADIGTL
DANG
DEVSTAT
DD
DIGITAL
DIGITAL ENH/IN
DIGITAL ENH/OUT
INTANG
INTDIG
MSDD
N90STA
PHASEX
RCM
RMCB
RMSC
STATION
TEXT
TEXTSTR

Format2

Source3
Location4

Table 4-8 Tag Database Fields (Continued)

C G

Alarm State

C G

Alarm State Ndx

C G

Fields1

Alarm Priority Return to Norm

Alarm Priority System Fault


Alarm Priority User Defined
Fault
Alarm Priority User Defined
Message

Alarm Type

3C

C G

Alarm Type Ndx

C G

Archive

Archive Class

Area GUID

Area Name

Area Ndx

Block

M G
C

Broadcast Alarm Acknowledge

1C

C C

CLD

255C M G

CNet

M G
C

Console Create Timestamp

C C

Console Update Timestamp

C C

1C

C G

Control Enabled

4-22

Creation Time Stamp

A G

Customer Tag ID

32C

C G

Device Number

C G

Device sub Type

16C

C G

Device Type

16C

C G

Equipment GUID

Equipment Name

Equipment Ndx

EU Descriptor

6C

C E

EUD Index

C G

2VAA000812R0001

4. Tag Configuration

Field Information Tables

Format2

Source3
Location4

Fields1

ANALOG
ANALOG ENH/IN
ANALOG ENH/OUT
DAANALG
DADIG
DADIGTL
DANG
DEVSTAT
DD
DIGITAL
DIGITAL ENH/IN
DIGITAL ENH/OUT
INTANG
INTDIG
MSDD
N90STA
PHASEX
RCM
RMCB
RMSC
STATION
TEXT
TEXTSTR

Table 4-8 Tag Database Fields (Continued)

FB1 One State

6C

C L

FB1 One State Ndx

C G

FB2 One State

6C

C L

FB2 One State Ndx

C G

Fast Reporting Max Time

FB3 One State

6C

C L

FB3 One State Ndx

C G

FB4 One State

6C

C L

FB4 One State Ndx

C G

FB1 Zero State

6C

C L

FB1 Zero State Ndx

C G

FB2 Zero State

6C

C L

FB2 Zero State Ndx

C G

FB3 Zero State

6C

C L

FB3 Zero State Ndx

C G

FB4 Zero State

6C

C L

FB4 Zero State Ndx

C G

FC Name

8C

M G

FC Number

M G

Group Display GUID

Group Display Name

Group Display Ndx

C G

Handshaking
High Alarm5

High Var Alarm Tag


High Variable Alarm Tag

2VAA000812R0001

High2 Alarm

C G

High3 Alarm

C G

High2 Delta

C G

High3 Delta

C G

Historian Atom Group GUID

Historian Atom Group Name

4-23

Field Information Tables

4. Tag Configuration

Format2

Source3
Location4

Fields1

ANALOG
ANALOG ENH/IN
ANALOG ENH/OUT
DAANALG
DADIG
DADIGTL
DANG
DEVSTAT
DD
DIGITAL
DIGITAL ENH/IN
DIGITAL ENH/OUT
INTANG
INTDIG
MSDD
N90STA
PHASEX
RCM
RMCB
RMSC
STATION
TEXT
TEXTSTR

Table 4-8 Tag Database Fields (Continued)

Historian Atom Group Ndx

Historian Server GUID

Historian Server Name

Historian Server Ndx

Last User ID

C G

Life Cycle

16C

C G

Life Cycle Ndx

C G

Low Alarm5

C G

C G

Low2 Alarm

C G

Low3 Alarm

C G

Low2 Delta

C G

Low3 Delta

C G

M G
C

Low Var Alarm Tag

Low Variable Alarm Tag

Module

Module/Node Type

16C

C G

Module/Node Type Ndx

C G

Node

M G
C

Node List

C C

Num Decimal PIaces

C G

One State

6C

C L

One State Ndx

C G

C G

Overview Display GUID

Overview Display Name

Overview Display Ndx

PID Block

4-24

PM1 One State

6C

C L

PM1 One State Ndx

C G

PM2 One State

6C

C L

PM2 One State Ndx

C G

PM1 Zero State

6C

C L

2VAA000812R0001

4. Tag Configuration

Field Information Tables

Format2

Source3
Location4

Fields1

ANALOG
ANALOG ENH/IN
ANALOG ENH/OUT
DAANALG
DADIG
DADIGTL
DANG
DEVSTAT
DD
DIGITAL
DIGITAL ENH/IN
DIGITAL ENH/OUT
INTANG
INTDIG
MSDD
N90STA
PHASEX
RCM
RMCB
RMSC
STATION
TEXT
TEXTSTR

Table 4-8 Tag Database Fields (Continued)

PM1 Zero State Ndx

C G

PM2 Zero State

6C

C L

PM2 Zero State Ndx

C G

Port0 Terminal Language

C G

Port1 Terminal Language

C G

Port0 Terminal Type

C G

Port1 Terminal Type

C G

Primary Display

8C

C C

Primary Display CRT

C C

Print Alarm

1C

C C

Print Operator Actions

1C

C C

Print State Change

1C

C C

Save Alarm

1C

C C

Save Operator Actions

1C

C C

Save State Change

1C

C C

Section Display GUID

Section Display Name

Section Display Ndx

Security Group

C C

Security Group GUID

Security Level

C C

Security Group Name

Security Group Ndx

Span

C G

C G

C C

32,
40,
64,C

C G

SP Value Zero

String Length

2VAA000812R0001

Tag Description

Tag Descriptor 1

Tag Descriptor 2

Tag GUID

A G

Tag Index

C C

4-25

Field Information Tables

4. Tag Configuration

Source3
Location4

Format2

Fields1

ANALOG
ANALOG ENH/IN
ANALOG ENH/OUT
DAANALG
DADIG
DADIGTL
DANG
DEVSTAT
DD
DIGITAL
DIGITAL ENH/IN
DIGITAL ENH/OUT
INTANG
INTDIG
MSDD
N90STA
PHASEX
RCM
RMCB
RMSC
STATION
TEXT
TEXTSTR

Table 4-8 Tag Database Fields (Continued)

Tag Name

14,16 C G
, 32,
C

Tag Type

Text Set Number

7C

C G

C G

Three State

6C

C L

Three State Ndx

C G

Transmit Acknowledge

1C

C C

Transmit Silence

1C

C C

Trend Display GUID

Trend Display Name

Trend Display Ndx

Two State

6C

C L

Two State Ndx

C G

A G

C G

Unit GUID

Unit Name

Unit Ndx

Update Time Stamp

User Text

Value Zero

Zero State

6C

C L

Zero State Ndx

C G

NOTES:
1. The attributes applicable to a particular tag type are not necessarily required for every tag of that type.
For example, the alarm
inhibit attribute needs to be configured for only those tags needing the alarm inhibit functionality.
2. N (numeric) = Numbers 0 through 9 only.
C (character) = Alphabetic characters, numbers 0 through 9, and special characters used as
descriptors.
G = Globally unique identifier.
3. M = Must/can be maintained by automation architect.
C = Entered into the tag database by the data browser.
I = Information only field; entered into the tag database by the tag browser.
A = Autogenerated by database.
D = Date.
4. A = Contained in the alarm comments list.
C = Contained in the user-configured tag lists.
E = Contained in the engineering unit descriptor list.
G = Contained in the global tag database.
L = Contained in the logic state descriptor list.
5. For DAANALG tags, this field must/can be maintained by the tag browser.

4-26

2VAA000812R0001

4. Tag Configuration

Field Information Tables

Table 4-9 Field Descriptions


Fields1
ADS Keyboard

ADS Panel

ADP keyboard, panel, and lamp number defining the full address
of the lamp to light when this tag goes into alarm.
Keyboard range is 0 - 8 (0 = all).
Panel range is 0 - 4 (0 = all).
Lamp range is 0 - 64 (0 = no ADP function).

Alarm Comment Alarm

Alarm state comment.

Alarm Comment Alarm Ndx

Alarm state comment index.

Alarm Comment Hardware Failure

Hardware failure alarm comment.

Alarm Comment HdwrFail Alarm Ndx

Hardware failure alarm comment index.

Alarm Comment High Alarm

High alarm comment.

Alarm Comment High Alarm Ndx

High alarm comment index.

Alarm Comment High2 Alarm

2-high alarm comment.

Alarm Comment High2 Alarm Ndx

2-high alarm comment index.

Alarm Comment High3 Alarm

3-high alarm comment.

Alarm Comment High3 Alarm Ndx

3-high alarm comment index.

Alarm Comment High Deviation

High deviation alarm comment.

Alarm Comment HighDevi Alarm Ndx

High deviation alarm comment index.

Alarm Comment High Rate of Change

High rate of change alarm comment.

Alarm Comment High RateChg Ndx

High rate of change alarm comment index.

Alarm Comment Low Alarm

Low alarm comment.

Alarm Comment Low Alarm Ndx

Low alarm comment index.

Alarm Comment Low2 Alarm

2-low alarm comment.

Alarm Comment Low2 Alarm Ndx

2-low alarm comment index.

Alarm Comment Low3 Alarm

3-low alarm comment.

Alarm Comment Low3 Alarm Ndx

3-low alarm comment index.

Alarm Comment Low Deviation

Low deviation alarm comment.

Alarm Comment LowDevi Alarm Ndx

Low deviation alarm comment index.

Alarm Comment Low Rate of Change

Low rate of change alarm comment.

Alarm Comment Low RateChg Ndx

Low rate of change alarm comment index.

Alarm Comment Return to Normal Alarm

Return to normal alarm comment.

Alarm Comment Return to Norm Ndx

Return to normal alarm comment index.

Alarm Comment System Fault

Alarm comment for system fault.

Alarm Comment System Fault Ndx

Alarm comment system fault index.

Alarm Comment User Defined Fault

Alarm comment for user defined fault.

Alarm Comment User Defined Fault Ndx

Alarm comment user defined fault index.

Alarm Comment User Defined Message

Alarm comment for user defined message.

ADS Lamp

2VAA000812R0001

Description

4-27

Field Information Tables

4. Tag Configuration

Table 4-9 Field Descriptions (Continued)


Fields1

4-28

Description

Alarm Comment User Defined Message


Ndx

Alarm comment user defined message index.

Alarm Deadband

Alarm deadband - must be positive number (in EU).

Alarm Group

Alarm group number for this tag. Valid inputs are 0 - 99 (0 is


used for tags, not alarms.

Alarm Inhibit State

Alarm inhibiting state.

Alarm Inhibit Tag

Index of the tag that inhibits alarms.

Alarm Print Inhibit

Alarm print inhibit (Y or N).

Alarm Priority Alarm

Alarm priority (1 - 8).

Alarm Priority Bad Quality

Bad quality priority (1 - 8).

Alarm Priority Hardware Failure

Alarm priority for hardware failure alarm.

Alarm Priority High Alarm

High alarm priority (1 - 8).

Alarm Priority High2 Alarm

2-high alarm priority (1 - 8).

Alarm Priority High3 Alarm

3-high alarm priority (1 - 8)

Alarm Priority High Deviation

High deviation alarm (1 - 8).

Alarm Priority High Rate of Ch

High rate of change priority (1 - 8).

Alarm Priority Low Alarm

Low alarm priority (1 - 8).

Alarm Priority Low2 Alarm

2-low alarm priority (1 - 8).

Alarm Priority Low3 Alarm

3-low alarm priority (1 - 8).

Alarm Priority Low Deviation

Low deviation alarm (1 - 8).

Alarm Priority Low Rate of Ch

Low rate of change priority (1 - 8).

Alarm Priority Return to Norm

Composer: Return to normal priority (1 - 8).


PCV: Alarm priority (0 - 7).

Alarm Priority System Fault

Alarm priority for system fault.

Alarm Priority User Defined Fault

Alarm priority for user defined fault.

Alarm Priority User Defined Message

Alarm priority for user defined message.

Alarm State

Alarm state descriptor.

Alarm State Ndx

Alarm state descriptor index.

Alarm Type

Type of alarming.

Alarm Type Ndx

Alarm type index.

Archive

Archive (Y or N).

Archive Class

Archive class name.

Area GUID

Area GUID.

Area Name

Area name.

Area Ndx

Area index.

Block

Function block address.

Broadcast Alarm Acknowledge

Broadcast alarm acknowledge messages: Y or N.

2VAA000812R0001

4. Tag Configuration

Field Information Tables

Table 4-9 Field Descriptions (Continued)


Fields1

2VAA000812R0001

Description

CLD

Name of the control logic document in which this tag is defined.

CNet

Control network address (0 - 255).

Console Create Timestamp

Date the HSI was created.

Console Update Timestamp

Date the HSI was last edited.

Control Enabled

Control enable; Y or N.

Creation Time Stamp

Date the tag was created.

Customer Tag ID

Additional tag description (optional).

Device Number

Device number.

Device sub Type

Device subtype.

Device Type

Device type.

Equipment GUID

Equipment GUID.

Equipment Name

Equipment name.

Equipment Ndx

Equipment index.

EU Descriptor

Engineering unit descriptor.

EUD Index

Engineering unit descriptor index.

Fast Reporting Max Time

Fast Reporting Maximum Time.

FB1 One State

One state descriptor for feedback input 1.

FB1 One State Ndx

One state descriptor index for feedback input 1.

FB2 One State

One state descriptor for feedback input 2.

FB2 One State Ndx

One state descriptor index for feedback input 2.

FB3 One State

One state descriptor for feedback input 3.

FB3 One State Ndx

One state descriptor index for feedback input 3.

FB4 One State

One state descriptor for feedback input 4.

FB4 One State Ndx

One state descriptor index for feedback input 4.

FB1 Zero State

Zero state descriptor for feedback input 1.

FB1 Zero State Ndx

Zero state descriptor index for feedback input 1.

FB2 Zero State

Zero state descriptor for feedback input 2.

FB2 Zero State Ndx

Zero state descriptor index for feedback input 2.

FB3 Zero State

Zero state descriptor for feedback input 3.

FB3 Zero State Ndx

Zero state descriptor index for feedback input 3.

FB4 Zero State

Zero state descriptor for feedback input 4.

FB4 Zero State Ndx

Zero state descriptor index for feedback input 4.

FC Name

Name of the symbol used by the function code to define this tag.

FC Number

Number of the function code that defines this tag.

Group Display GUID

Group display GUID.

Group Display Name

Group display name.

4-29

Field Information Tables

4. Tag Configuration

Table 4-9 Field Descriptions (Continued)


Fields1

4-30

Description

Group Display Ndx

Group display index.

Handshaking

Handshaking.

High Alarm5

High alarm value (in EU).

High Var Alarm Tag

High variable alarm tag.

High Variable Alarm Tag

High variable alarm inhibit tag.

High2 Alarm

2-high alarm value (in EU).

High3 Alarm

3-high alarm value (in EU).

High2 Delta

Delta value added to the high variable alarm value to give the 2high variable alarm value - must be positive number in EU.

High3 Delta

Delta value added to the high variable alarm value to give the 3high variable alarm value - must be positive number in EU.

Historian Atom Group GUID

Historian atom group GUID.

Historian Atom Group Name

Historian atom group name.

Historian Atom Group Ndx

Historian atom group index.

Historian Server GUID

Historian server GUID.

Historian Server Name

Historian server name.

Historian Server Ndx

Historian server index.

Last User ID

ID of the last user to edit this tag.

Life Cycle

What stage (in the life cycle of a a tag) this tag is presently in.

Life Cycle Ndx

Life cycle index.

Low Alarm5

Low alarm value (in EU).

Low Var Alarm Tag

Low variable alarm tag.

Low Variable Alarm Tag

Low variable alarm inhibit tag.

Low2 Alarm

2-low alarm value (in EU).

Low3 Alarm

3-low alarm value (in EU).

Low2 Delta

Delta value added to the low variable alarm value to give the 2low variable alarm value - must be positive number in EU.

Low3 Delta

Delta value added to the low variable alarm value to give the 3low variable alarm value - must be positive number in EU.

Low Variable Alarm Tag

Low variable alarm tag index. This value of this tag determines
the low variable alarm limit.

Module

Controller address (0 - 31).

Module/Node Type

Controller type and revision level.

Module/Node Type Ndx

Controller type and revision level index.

Node

Harmony control unit address (0 - 255).

Node List

Node list number for broadcasting alarm acknowledgments.


Valid inputs are 0 - 4 (0 selects the node list containing the first
32 N90STA tags in the database that define either a human system interface or workstation).

2VAA000812R0001

4. Tag Configuration

Field Information Tables

Table 4-9 Field Descriptions (Continued)


Fields1

Description

Num Decimal PIaces

Number of decimal places to use displaying the value (0 - 6).

One State

One state descriptor.

One State Ndx

One state descriptor index.

Overview Display GUID

Overview display GUID.

Overview Display Name

Overview display name.

Overview Display Ndx

Overview display index.

PID Block

PID block address for tuning function (11 - 9998). Tuning block
number for CLIF tags (0 or 30 - 9998).

PM1 One State

Permissive state descriptor and associated indices for RMCB tag


types.

PM1 One State Ndx


PM2 One State
PM2 One State Ndx
PM1 Zero State
PM1 Zero State Ndx
PM2 Zero State
PM2 Zero State Ndx
Port0 Terminal Language

Language type for terminal emulation. (0 = USA, 1 = Norwegian)

Port1 Terminal Language


Port0 Terminal Type

Terminal type for terminal emulation mode, NIU port 1 (0 =


terminal not configured, 1 = VT220 terminal, 2 = HP2392).

Port1 Terminal Type

2VAA000812R0001

Primary Display

Name of display called from an alarm summary, or from


operating parameters for this tag.

Primary Display CRT

Primary display CRT.

Print Alarm

Print alarms for this tag in the event log: Y or N.

Print Operator Actions

Print operator actions for this tag in the evnt log: Y or N.

Print State Change

Print state changes for this tag in the event log: Y or N.

Save Alarm

Save alarms for this tag on disk: Y or N.

Save Operator Actions

Save operator actions for this tag on disk: Y or N.

Save State
Change

Save state changes for this tag on disk: Y or N.

Section Display GUID

Section display GUID.

Section Display Name

Section display name.

Section Display Ndx

Section display index.

Security Group

Security group (1 - 16).

Security Group GUID

Security group GUID.

Security Level

Security level (1 - 8).

Security Group Name

Security group name.

4-31

Field Information Tables

4. Tag Configuration

Table 4-9 Field Descriptions (Continued)


Fields1

Description

Security Group Ndx

Security group index.

Span

Span (in EU).

SP Value Zero

0% value on the set point scale in engineering units.

String Length

Human system interface text string length (0 - 80).

Tag Description

Describes the tag, its function, location, etc.

Tag Descriptor 1

First half of tag descriptor.

Tag Descriptor 2

Second half of tag descriptor.

Tag GUID

Unique identifier for tag.

Tag Index

Identifies the tag by number.

Tag Name

Identifies the tag by name.

Tag Type

Tag type name.

Text Set Number

Number of text set used for RMCB (1 - 100).

Three State

Three state descriptor.

Three State Ndx

Three state descriptor index.

Transmit Acknowledge

Transmit alarm acknowledge messages to this node: Y or N.

Transmit Silence

Transmit alarm silence messages to this node: Y or N.

Trend Display GUID

Trend display GUID.

Trend Display Name

Trend display name.

Trend Display Ndx

Trend display index.

Two State

Two state descriptor.

Two State Ndx

Two state descriptor index.

Unit GUID

Unit GUID.

Unit Name

Unit name.

Unit Ndx

Unit index.

Update Time Stamp

Date the tag was updated.

User Text

User text.

Value Zero

0% value in engineering units.

Zero State

Zero state descriptor.

Zero State Ndx

Zero state descriptor index.

NOTE:
1. The attributes applicable to a particular tag type are not necessarily required for every tag of that type.
For example, the alarm
inhibit attribute needs to be configured for only those tags needing the alarm inhibit functionality.

4-32

2VAA000812R0001

4. Tag Configuration

Field Information Tables

Table 4-10 Choices for AlmType Field


Type

Entry

Applicable Attributes

Standard Symphony alarm

Std

High Alarm, Low Alarm

Fixed alarming with HSI


multiple level alarms

Fix

High Alarm, Low Alarm, High2 Alarm, Low2


Alarm, High3 Alarm, Low3 Alarm

Variable HSI alarm limits


with multiple level alarms

Var

High Variable Alarm Tag, Low Variable Alarm


Tag, High2 Delta, Low2 Delta, High3 Delta, Low3
Delta

Table 4-11 Choices for AlmInhStat Field


Alarm Inhibiting State
No alarm inhibiting state

Entry
Blank

Digital (MSDD, DD, RCM, RMCB,


DADIGTL, INTDIG, DADIG, TEXTSTR)
Alarm
Zero
One
Two
Three

A
0
1
2
3

Analog, Station (DAANALG, INTANG)


High
Low

H
L

Station (DAANALG, DANG)


High deviation
Low deviation
Two high
Two low
Three high
Three low

HD
LD
2H
2L
3H
3L

DANG
High rate of change
Low rate of change

HR
LR

Table 4-12 N90STA Tag ModNodeTypeAndRev Field Choices


Entry

2VAA000812R0001

Nomenclature

Description

COMPUTER

N/A

Used to access computers running process


interface software packages (e.g., XRS 90
Data Management, 1090 Process
Management, etc.)

IPT01

INIPT01, NGCM04

INFI-NET to Plant Loop transfer module


(local)

LCM01

NLCM01

Large controller module

LCM02

NLCM02

Large controller module

LCM03

NLCM03

Large controller module

4-33

Field Information Tables

4. Tag Configuration

Table 4-12 N90STA Tag ModNodeTypeAndRev Field Choices (Continued)


Entry

Nomenclature

Description

MFC

IMMFC03/04/05,
NMFC01/02/03/04/05

Multifunction controller module

MFP

IMMFP01/02/03/05

Multifunction processor module

NPM

INNPM01

Network processing module (Controlway)

OIS10

IIOIS10

Operator interface station

OIS40

IIOIS40/IIOIS41/IIOIS42

Operator interface station

SBM

NSBM01

Superloop bus module

SCM

NSCM01,
NNIUO1

Serial communication module


network interface unit

SEM

IMSEM01

Sequence of events logging module

SSM/ICT

INICT01, NSSM01

INFI-NET to computer transfer module

Table 4-13 Choices for ConsDevType, ConsDevNum, and ConsDevSubType Fields


DEV_TYPE

4-34

DEV_NUM

DEVSUBTYPE

Printer

Printer number (1 - 4)

ANSI, IBM Color


ANSI Color, IBM COL 24
ANSI High, IBM B&W 24
IBM

Keyboard

Keyboard number (1 - 4)

MKI
EMKI
EMKI Track

ADP panel

Keyboard number (1 - 4)
ADP panel number (1 - 4)

Not applicable

Touch screen

Touch screen number

Noncal Elograph
Calib Elograph

CIU

Not applicable

Not applicable

CRT

CRT number (1 - 4)

Not applicable

Clock

Not applicable

Battery
Satellite

Storage

Not applicable

SASI Winchester
SCSI Winchester
Floppy
Magtape
Optical Disk

2VAA000812R0001

5. Local Monitoring and Trending

Create Trend Document

5. Local Monitoring and Trending


Composer provides the ability to locally monitor and trend up to 16 function block output values. This trend document can
be placed anywhere in the project architecture and can collect data from function blocks in any controller in the distributed
control system. This document can be saved in various formats for use by other software packages.

5.1

Create Trend Document


To create a new trend document from within the Composer window:
1.

Right click on the item in the project architecture that will contain the trend document.

NOTE: A trend document (no matter where it resides) can access all function blocks in all controllers in the project.
2.
Select New > Trend Document.
A new trend_document.tnd file will be added to the project architecture item.
To create a new trend document from within the trend window:

5.2

1.

Select File > New.

2.

Configure the trend document (optional).

3.

Select File > Save or File > Save As.

4.

Select a destination directory for the trend document.

5.

Enter a name for the trend document and click Save.

Open Trend Document


To open a trend document, right click the trend document and select Open from the pop-up menu.
The file_name.tnd - Trend window will appear.

5.3

Configure Trends
Configure a trend by:

Specifying trend color.

Entering a name for the trend.

Entering the address (control network, control unit, controller, and function block number) of the value being
trended.

Entering the maximum value, minimum value, and units configured in the function block.

Setting the value type desired.

Selecting which trends will be trended.

A maximum of 16 trends can be configured and displayed. It is important to remember that all settings and actions
performed in this window do not effect the actual function blocks in any way.

5.3.1 Color
To select the color of the trend:
1.

Click in the Color field of the trend.

2.

Select the desired color from the standard Windows color window and click OK.

5.3.2 Name
Enter an alphabetic text string (32,768 characters maximum) in the Tagname field. This name is only used in this window.

5.3.3 Function Block Information


To configure the function block related information into the trend:
1.

Configure the function block address by entering the appropriate information in the Control Network, Control
Unit, Controller, and Block fields.

2.

Enter the desired maximum value, minimum value, and engineering units (usually identical to that configured
into the function code) into the Maximum, Minimum, and Units fields.
Function block information is converted to a percentage (using the following formula) before it is trended.
[(actual_value - minimum_value)/(maximum_value - minimum_value)]100

2VAA000812R0001

5-1

Type

5. Local Monitoring and Trending

5.3.4 Type
All values can be trended as integers or real numbers. When trending using a real number type, plotted values will be
connected with a direct line. When trending using an integer type, a combination of horizontal and vertical lines connect
plotter points. To set the type, click in the Type field and select the desired type from the list.

5.3.5 Activation
Use the Scan field to enable or disable a trend.

5.4

Editing Trends
Any of the fields that define a trend can be changed at any time but changes only take affect after trending has been
stopped and restarted. Refer to Trend Window Operation for more information.

5.5

Trend Window Operation


The trend window consists of an upper portion that displays the trends (percent of range vs. time) and a lower portion that
defines and shows the real-time value of each trend. The size of the whole window and each portion of it can be changed
using standard Windows functionality. Menu and toolbar items permit the starting, stopping, pausing, recording, and
panning of the trend. It is also possible to zoom in and out, read trend values for a specific time, copy trend data from trend
document to trend document (within the same document also).

5.5.1 Start
To start trending:
1.

Use the trend on toolbar button to start trending the enabled trends.

2.
Select a logical computer interface when prompted.
All previous data is deleted. The Value field reflects the real-time value of the trend at the most recent data point.

5.5.2 Stop
Use the trend off toolbar button to stop trending and recording (refer to Record) of the data.

5.5.3 Pause
Use the pause toolbar button to pause the collection of data. Use the pause button again to resume data collection. The last
data point collected before pausing and the first data point collected after pause was cancelled will be connected with a line.
Data values that occurred while the display was paused are not collected and can not be displayed or recorded. All data
collected up to the time pause was used is still available when pause is cancelled.

5.5.4 Record
Trend data can be recorded to an ASCII text file for use by other software packages such as Excel. To start the recording of
trend window data:
1.

Click the trend and record on or record on (when trending is already started) toolbar button.

2.

Enter or select a recording file name in the recording dialog box.

3.

Specify the time interval that describes when the data is to be recorded. The available intervals are:

Always - All data collected while recording is on is saved to the file.


From Start Time - The recording of data will start at the specified time but must be stopped
manually.
Before Stop Time - The recording of data must be manually started but will stop at the specified time.
Interval - The recording of data will start and stop at the specified times.

5-2

4.

Click Next.

5.

If the always interval was selected, proceed to Step 7. If the from start time interval was selected, specify a start
time in the dialog box. If the before stop time interval was selected, specify a stop time in the dialog box. If the
interval option was selected, specify a start and stop time in the dialog box.

6.

Click Next.

7.

Enter a comment (optional) in the dialog box and click Finish.

2VAA000812R0001

5. Local Monitoring and Trending

Pan

5.5.5 Pan
The pan left, pan right, pan up, and pan down toolbar buttons allow the display to be panned in all directions. Use the undo
pan button to return to the default view.

5.5.6 Zoom
The zoom in and zoom out toolbar buttons allow the display resolution to be increased or decreased as required. Use the
undo zoom button to return to the default zoom setting.

5.5.7 Line Cursor


A special cursor allows the values of all displayed data points at a specific time to be read. This line cursor is a vertical line
that follows the current cursor. Move the line to the desired time and read the values of the data points in the Value fields.
Use the line cursor toolbar button to enable the line cursor. Click the line cursor button again to disable it.

5.5.8 Properties
There are five properties that affect a trend document. These properties are:

Samples per series.

Sample rate (milliseconds).

Line cursor color.

Y axis maximum.

Y axis minimum.

The properties of the currently opened trend document are accessed by selecting File > Properties.... Changes made to
these properties will be visible the next time the trend document is opened. The properties used when creating a trend
document are accessed by selecting Tools > Options. An explanation of the properties follows.
Samples Per Series
This property sets the maximum number of data points per trend that will be saved in the buffer. When the buffer is full, old
data points are lost to make room for new data points. This property multiplied by the number of active trends determines
the amount of memory needed to support the buffer.

NOTE: Use caution when setting the samples per series property and the number of active trends to prevent the buffer from using unacceptably large quantities of memory space.
Sample Rate (mSecs)
This property sets the rate at which data is collected.
Line Cursor Color
The color of the line cursor is set by this property. To change the color, click on the present color and choose a new color
using the standard Windows dialog box provided.
Y Axis Maximum
The maximum y axis percentage value displayed in the trend window when it is opened is set by this property.
Y Axis Minimum
The minimum y axis percentage value displayed in the trend window when it is opened is set by this property.

5.5.9 Print
To print a trend document:
1.

Select File > Print.

2.

Select a printer type in the print preview dialog box.

3.

Select a paper orientation.

4.

Select the size of the margins.

5.

Select the required level of detail.

6.

Click Print.

2VAA000812R0001

5-3

Print

5-4

5. Local Monitoring and Trending

2VAA000812R0001

6. Logs

Composer Event

6. Logs
The following topics describe how to configure Composer event logs and Conductor VMS custom logs from within
Composer.

6.1

Composer Event
The Composer event log records object actions such as:

Compile.

Add.

Delete.

Copy.

Modify.

Convert.

Export.

Import.

Download.

Save.

Verify.

Open.

Mode changes.

Tune.

Upload.
The event log is controlled by the log administrator and is usually disabled when the project is created. To set the event log
to by (by default) enabled, set:

HKEY_LOCAL_macliessoftware\abbAutomation\Composer\InstalledComposerSettings\EventLogixFaultStatus=1
If necessary, enable the event log using the instructions provided in this section. It is also possible to enable the event log
through the project property pages (advance tab) or while converting a project. The log can be viewed and the view can be
changed by any Composer user but only the log administrator can enable, disable, configure, or archive the log.

NOTE: There can be only one log administrator at a time. Once the current log administrator designates another log
administrator, the newly designated log administrator has sole control of the log.
NOTE: Changing a tag name generates a modify event identified with the new name.
NOTE: Messages generated by the copying and pasting a tag indicate the modified instead of copied.

6.1.1 Enable
To enable the event log after the project has been created:

1.

Select Tools > Options from within the Composer window.

2.

Select the log tab.

3.

Choose to enable or disable the event log.

4.

If the log was enabled, enter the maximum size (in megabytes) of the log and the amount of available
memory space (in percent) being used before a warning message is generated.

5.

Click OK.

6.1.2 View
To view the event log, select View > Event Log from within the Composer window. The following data for each recorded
event is displayed:

Creation time stamp.

Event group ID.

Event action type.

Event object type.

Action object name.

Event user name.

Event message.

Cnet address.

Node address.

Controller ID.

Function block number.

Function code number.


2VAA000812R0001

6-1

Configure

6. Logs

Control logic document name.


The view can be sorted in ascending or descending order by column, by columns, or both. It is also possible to exclude
columns, move columns, and save the view as the event log view.

6.1.2.1 Column Sort


To sort a column in ascending or descending order, right click the column and select Sort Ascending or Sort Descending
from the pop-up menu.

6.1.2.2 Move Column


To rearrange the columns:

1.

Select the heading of the column being moved.

2.

Drag the column on top of the column that will be to the right of and adjacent to the desired position
of the moved column.

6.1.2.3 Save View


If changes have been made to the current view and a user attempts to close the log, a prompt will state that the view has
changed and ask if the changes should be saved. If the changes are being saved, specify a name for the view receiving the
changes and click OK.

6.1.2.4 View Sort


To sort by column and ascending or descending order:

1.

Right click any column heading and select Modify View Sorting from the pop-up menu.

2.

Select a column that is part of the sort criteria from the fields list in the sort event by dialog box. and
click Add.

3.

If necessary, modify the sort order of the column by clicking ASC or DESC.

4.

Repeat Steps 2 through 3 for all the columns in the sort criteria.

5.

Arrange the columns in the desired order of precedence and click OK.

6.1.2.5 Modify Viewed Columns


To control which columns are displayed in the event log:

1.

Right click any column heading and select Modify View Fields from the pop-up menu.

2.

Move the appropriate columns to and from the available fields and selected fields lists until the
selected fields list contains the required columns.

3.

Arrange the columns in the desired order and click OK.

6.1.3 Configure
To specify which actions are to be recorded in the event log:

1.

Select Tools > Options from within the Composer window.

2.

Select the log tab.

3.

Click Log Settings for Actions/Objects pair.

4.

Choose the action for each event object type that is to be recorded (Y) or omitted (N).

5.

Close the window.

NOTE: The project must be closed and reopened before configuration changes take effect.

6.1.4 Archive
To archive the event log:

6-2

1.

Select Tools > Options from within the Composer window.

2.

Select the log tab.

3.

Click Archive Log Data.

2VAA000812R0001

6. Logs

6.2

Conductor VMS Custom

4.

Specify a location and name for the archived event log file in the archive log data dialog box. If the
specified file (any .MDB file) already exists, it will be appended with the new information.

5.

Specify what is to be done with the data in the event log after the log is archived. Possible options
include clearing (deleting) all archived records from the log, only archiving the records (no deletion),
and clearing (no archiving) of the selected records.

6.

Choose the records to archive by filter the log by selected actions and objects, time, user, any
combination of these methods. When filtering by time, be sure to enable the check box to the right of
the time values being used.

7.

Click OK.

Conductor VMS Custom


The Conductor VMS custom log configuration utility facilitates offline configuration of logs for a Conductor VMS human
system interface. Collection of log data is configurable based on either time triggering or event triggering. Printing of log
data is configurable based on time triggering, collection triggering, or event triggering. Refer to the appropriate human
system interface instruction for complete custom log information.

NOTES:
1. Log configurations created with the Composer interface must be converted to the appropriate format on the
human system interface. Refer to the appropriate human system interface for this information. There is no conversion
from human system interface format back to Composer format.
2. This is a DOS utility launched from the Composer interface.
3. Only one copy of the log configuration utility can be running.
4. When creating a log file for a PCV or Conductor VMS console, use the Import Document feature to get quick
access to the log file from the Composer Navigator. To enable this feature, the LOG.EXE program must be associated to .LF files using standard Windows procedures.
5. Log configurations created with WinTools do not get converted to Composer. Manually copy the files to the new
Composer project.

6.3

Log Configuration Utility


To configure a log for a human system interface:

1.

In the Composer window, right click a human system interface and select New > Log....

The log configuration opening screen appears.

2.

6.4

Enter the appropriate human system interface type and press ENTER.

Creating New Logs


To create a new log:

6.5

1.

Press F3 from the log configuration main menu.

2.

At the prompt, type in the log number and press ENTER. The log configuration header screen
appears.

3.

Configure the log. Refer to Editing Existing Logs for more information.

4.

Save the log. Refer to Saving Logs for more information.

Editing Existing Logs


To edit an existing log:

1.

Press F5 from the log configuration main menu.

2.

Enter the log number and press ENTER. The log configuration header screen appears with current
field information for this log.

Log Configuration Header

3.

Fill in the log configuration header fields using the following table as an aid. Refer to Editing
Functions for information about field editing and cursor movement.

The following are general notes to observe when editing the log configuration header:
2VAA000812R0001

6-3

Editing Existing Logs

6. Logs

Not all fields are relevant to all log types. Make entries to only the pertinent fields.

Entry fields for pre-trip and post-trip periods pertain only to trip logs.

Table 6-1 Log Definition Fields


Field

Valid Entries

Description

Log number

1 to 300

Log number.

Log status

Active
Inactive

Used to activate or deactivate the log.

Log name

8-character ASCII text

Valid DOS file name.

Log description

32-character ASCII text

Description of the log.

Log type

Standard
Periodic
Trip

Trend log.
Snapshot log.
Trip log.

Logical printer number

1 to 16

Logical printer number.

Number of columns

1 to 64

Number of columns.

Number of rows

1 to 250

Number of rows.

Number of retentions

0 to 9

Number of outputs of the log saved on disk.

Collection type

Demand
Event
Time

Collect on demand only.


Collect on event.
Collect at certain time.

Print type

Demand
Event
Time
Collect

Print on demand only.


Print on event.
Print at certain time.
Print when collection complete.

Repeat collection cycle

Yes/No

Repeat the collection cycle the log has


completed. Refer to Repeat Collection
Cycle in this section for further explanation.

Collection period (or pretrip) time

Count
Units

Up to 999.
Hours, minutes, seconds.
NOTE: For a periodic log, this time period
elapses before the log collects.
Example: To have a periodic log collect
upon the occurrence of an event, configure
the log to collect upon the trigger event, and
configure the collection period to be zero.

6-4

Pre-trip period time

Count
Units

Up to 999.
Hours, minutes, seconds.

Print trigger time

Time

Time of time-triggered print.

Post-trip period time

Count
Units

Up to 999.
Hours, minutes, seconds.

Collection trigger tag

Valid tag name or index

Tag name or index.

2VAA000812R0001

6. Logs

Editing Existing Logs

Table 6-1 Log Definition Fields (Continued)


Field
Analog collection
trigger conditions
(1 and 2)

Valid Entries
3H
2H
H
N
(blank)
L
2L
3L

Description
Trigger on 3H condition.
Trigger on 2H or 3H.
Trigger on H, 2H, or 3H.
Trigger on return to normal condition.
No trigger.
Trigger on L, 2L, or 3L.
Trigger on 2L or 3L.
Trigger on 3L conditions.
Refer to Analog Collection Trigger Conditions for further explanation.

Boolean collection
trigger conditions states

ZERO, ONE, (blank)

Specify the logic state descriptors to be


recognized as the trigger state. Two fields
are available for specifying up to two
descriptors.
Specify logic state zero as a trigger state,
logic state one as a trigger state, or both or
neither.

Boolean collection
trigger alarm status

ALARM, RTN, (blank)

Alarm status condition for triggering.


Specify an alarm state as a trigger state, the
return to normal as a trigger state or neither.
The alarm status is independent of the logic
state.

Print trigger tag

Tag name or index

Works the same as demanding a log by an


event. Regular log collection does not get
interrupted.
To enable this field, print type should be
event.

Analog print trigger


conditions (1 and 2)

3H
2H
H
N
(blank)
L
2L
3L

Trigger on 3H condition.
Trigger on 2H or 3H.
Trigger on H, 2H, or 3H.
Trigger on return to normal condition.
No trigger.
Trigger on L, 2L, or 3L.
Trigger on 2L or 3L.
Trigger on 3L condition.
Refer to Analog Print Trigger Conditions
for further explanation.

Boolean print trigger


conditions states

ZERO, ONE, (blank)

Specify the logic states to be recognized as


the trigger state. Two fields are available for
specifying up to two descriptors.
Specify the logic state zero as a trigger
state, logic state one as a trigger state, or
both or neither.

Boolean print
trigger alarm status

ALARM, RTN, (blank)

Alarm status condition for triggering.


Specify an alarm state as a trigger state, the
return to normal as a trigger state or neither.
The alarm status is independent of the logic
state.

2VAA000812R0001

6-5

Editing Existing Logs

6. Logs

Table 6-1 Log Definition Fields (Continued)


Field
Log starting time

Valid Entries
Military format
13:00 = 1:00 pm

Description
Time of first collection.
NOTE: For a periodic log, the actual
collection of the first snapshot is the log
starting time minus the length of one
collection period. This field should not be
used for a trip log.
Example: To have a periodic log collect at
1:00 and once an hour thereafter, the log
starting time must be 12:00 and the
collection period must be one hour.

Log completion time

Time

Calculated by the human system interface,


not user-assignable.

Depending upon collection type, entry fields for collection trigger tags and trigger conditions may or may not be
utilized.

Depending upon print type, entry fields for print trigger tags, print times and trigger conditions may or may not be
utilized.

Changing row and column size on existing logs adds and deletes cells as required. Be careful not to inadvertently
delete information from an already created log.

Log configuration does not have access to the tag or trend lists. Therefore, give the tag index when assigning data
to the Collection Trigger Tag and Print Trigger Tag fields; and select the tag type when changing the tag index and
leaving the field. There are a maximum of 25 tag types (not all are valid.) Press + or - until the correct type appears.

During log definition entry, only valid fields for user entries are displayed; invalid fields are blanked out.

At the present time, logs are limited to approximately 12,000 cells (240 rows by 50 columns, or 187 rows by 64
columns.

NOTE: When a log is activated, validity of the log header configuration is checked. If any field is not configured correctly, an error message is displayed and the cursor (input field) appears at the wrong data field to prompt the user for
correction.
Cells

4.

From the log configuration header screen, press F3 to activate the edit cell screen.

5.

Position the cursor on the cell to be edited. Use the following keys to move the cursor about the cell
fields.

6.

Choose the appropriate cell type by making a selection from the menu at the bottom of the cell
configuration screen. This brings up submenus in order to record additional information about the cell
type. Refer to Cell Types for more information.

7.

For fields that the human system interface permits entry of either the tag name or the index, use only
the tag index. Use + and - to scroll through and select from available entries.

8.

Compress the ASCII space. Refer to Compressing ASCII Space for more information.

9.

When log configuration is complete, save the log by returning to the log header configuration display
or the log configuration/help menu.

The edit cell screen also provides cell editing functions such as:
Delete Cell
Position the cursor on the cell and press K.
Define Column Width
Press L. This defines the width of each of the columns of the log. (Columns default to a width of six printable characters.)
Column widths are used to determine the starting point for each column and for justifying values within a column field. ASCII
text, time and date, offset time, and tag configuration data type cells are allowed to cross column boundaries for ease of
definition.
6-6

2VAA000812R0001

6. Logs

Cell Types

Copy Cell
Press M. This copies one cell definition to another. Enter the row and column of the source cell (defaulted to the currently
selected cell) and the row and column of the destination cell (also defaulted to the currently selected cell). Pressing ENTER
performs the function, pressing ESC returns to the cell definition menu without performing the function.
Copy Row
Press N. This copies one entire row to another row. The default destination and source rows are the same as the currently
selected row. The function copies the entire source row of cell definitions to the destination row cell definitions.
Copy Column
Press O. This copies one entire column of cell definitions to another. The default source and destination columns are the
same as the currently selected column.
Copy Log
Press Q. This copies an entire log definition to another log definition file. The source log is the log currently being defined or
reviewed; the destination log must be specified.

6.5.1 Cell Types


The following topics describe each of the cell type definitions called up from the menu in the lower portion of the edit cell
screen.

6.5.1.1 ASCII Text


ASCII text allows entering an ASCII string of up to 80 characters. In addition, special printer controls can be accessed by
typing the % character followed by an escape sequence listed in the following table. To get the character % to print, key in
%%; the escape sequence is ignored. All invalid escape codes are printed as ASCII text (maximum ASCII characters is
5,120).

Table 6-2 Printer Escape Sequences


Sequence

Control Description

New line (carriage return and line feed).

Form feed (top of form and carriage return).

C0

Turn compressed print off.

C1

Turn compressed print on (allows maximum of 200 characters per line). C1 puts the
printer into compressed mode and leaves it in compressed mode. The printer is not
reset to normal mode (132 characters per line) by the printing of another log. To
configure this log only to be printed in compressed mode, use a C0 command as the
last cell printed.

The color in the custom configured logs can be specified through an ASCII cell definition. For example, the escape
sequence %K2 sets the color output to red. This escape sequence does not occupy any character position in the actual
output. Other color escapes are listed in the following table.
The number denoting the color is terminated by any nondigit character. If the nondigit character is %, it is not in the output.
This % character acts as the terminating character for the color, and allows a numeric character to be output immediately
following the color escape sequence.

Table 6-3 Color Escape Sequences


Sequence

2VAA000812R0001

Color

Sequence

Color

%K0

Black

%K6

Magenta

%K2

Red

%K7

Yellow

%K3

Green

%K12

Blue-magenta

%K5

Cyan

6-7

Cell Types

6. Logs

6.5.1.2 Trend Value


Trend value defines strings of trend cells in a given column or row. It may also be used to define a single trend cell. All
trended values must be defined in the console trend configuration. Refer to the following table for an explanation of the
fields.

Table 6-4 Trend Value Cell Fields


Field

Description

Trend index

Index of trend from which this value is to be taken: one to


10000. (Maximum active trends is 4,000 for MCS or
IIOIS25 consoles and 10,000 for 40 series consoles).

Offset time of
first cell

Time relative to starting time of the log for this trend


value. Specified by count (zero to 999) and units
(seconds, minutes, hours).

Resolution

Time difference between consecutive trend cells being


defined. Specified by count (zero to 999) and units
(seconds, minutes, hours).

Number of
Number of consecutive cells to be defined as trend cells.
consecutive cells Must not exceed maximum cells in row or column.
Direction of cells Specifies how consecutive cells are to be defined.
Vertical = down a column.
Horizontal = across a row.
Single or multiple trend cells can be defined. When defining multiple cells, the starting cell is the current cell. When using
the feature # of Consecutive Cells and the Resolution (log generator will then copy trend cells with an offset), log data
values are listed in ascending time order from either the starting time or earliest value of the log. Therefore, it is not possible
for the data in a log to be printed in reverse chronological order using this feature.

6.5.1.3 Configuration Data


Configuration data permits static tag configuration data in the cell. The tag name or index must be specified along with the
type of data requested. The following configuration items for the tag can be specified: name, description, engineering units,
and alarm group.

6.5.1.4 Tag Value


Tag value specifies a tag name or index for this cell so that the tag value (a snapshot value taken at the log collection time)
will be put in the cell. This cell type is intended primarily for periodic logs when getting a snapshot of a tag value at a certain
time. For device driver, multistate device driver, and station type tags, there is a sub tag value type prompt that allows the
selection of the intended value of the tag.

6.5.1.5 Alarm/Quality
Alarm and quality specifies a tag name or index in order to get the alarm and quality status for that tag. This status can only
be associated with tag values (snapshot values), not trended values. Trended values do not carry along a status. In
addition, a status field width of either one or three characters can be specified. A three character field will have two
characters for the alarm status and one character for the quality. It is treated in a similar fashion to the five character alarm
and quality field in the human system interface display subsystem, minus the two characters for the alarm group. A one
character field will have an abbreviated alarm status, overridden by bad quality, similar to a one character alarm and quality
field in the human system interface display subsystem.

6.5.1.6 Formula
Formula defines a cell to be a function of other cells. Specifically, a cell can be defined to be the sum of a row or column, the
average of a row or column, a minimum of the row or column, or the maximum of the row or column.
Formula cells perform calculations on all cells within the row or column of tag value, trend value or constant cell types. If any
one of the cells involved in the calculation is bad quality, it is omitted from the calculation. The resulting formula cell value is
marked with the suspect indicator ?. The suspect indicator is the fourth item choice in the alarm quality configuration text
set. This indicator overwrites the right-most character (least significant digit position) of the formula cell field.

NOTE: The formula includes all values in a given row or column, not just those values above the sum. For example,
if a sum for a column resides above the formula for the average of the same column, the sum will be included in the
average.
6-8

2VAA000812R0001

6. Logs

Cell Types

6.5.1.7 Human System Interface Time and Date


Human system interface time and date generates a time and date for this cell. The time and date can be either the time of
the log output, or the time the log started (starting collection time). In addition, all or part of the normal time and date line can
be printed. The date can be formatted in two ways. The options for time and date are shown in the following table.

Table 6-5 Time and Date Formats


Time/Date
Time

Date

Format

Example

Time

16:32:00

Date

19-JUL-94

Day

Tuesday

Time/date

16:32:00 19-JUL-94

Time/day

16:32:00 Tuesday

Date/day

19-JUL-94 Tuesday

Time/date/day

16:32:00 19-JUL-94 Tuesday

Day-month-year

19-JUL-1994

Month-day-year

JUL-19-1994

Year-month-day

1994-JUL-19

The following describe the log start time for the log types:
Standard (trend) - time that the log starts collecting. Normally, the first trend cell is offset zero from the log start time. In this
case, the log start time is also the time of the first trend cell.
Trip - time of the event.
Periodic (snapshot) - time the snapshot was made.
The following describe the current time for the log types:
Standard - time that collection of the log is complete. This does not include the processing time required to format the log
for printing.
Trip - time that collection of the log is complete, i.e., the time of the latest post-trip data that has been collected. This time
does not include processing.
Periodic - time that collection of the log is complete. This does not include the processing time required to format the log for
printing.

6.5.1.8 Offset Time


Offset time defines one or more cells to be an offset time from the starting time of the log. The offset is defined in units and
count, such as units = sec, count = 60, which would define the cell to be an offset time 60 seconds after the log starting
time. Units can be specified as sec, min, hrs, or day, and a count of up to 9999. The formats that can be used to print the
offset time are shown in the following table.

Table 6-6 Offset Time Formats


Format

Example

HH:MM:SS

12:30:00

HH:MM

12:30

DATE HH:MM

20 12:30

MM:SS

30:00

To configure a log that has 24 trend values and has the offset time shown beside each trend, enter count as one (hour) and
number of cells (24), and select the direction (vertical or horizontal). After pressing ENTER, 24 offset cells with the correct
offset value in each cell are created.

2VAA000812R0001

6-9

Repeat Collection Cycle

6. Logs

6.5.1.9 Constant Value


Constant value permits entering a constant value to be printed in this cell. This constant value can then be used in formulas
in formula type cells. If the value is not to be used in a formula type cell, define the constant as an ASCII text cell type, not
as a constant cell type.

6.5.2 Repeat Collection Cycle


If the Repeat Collection Cycle field is set to NO for any active log, the log automatically deactivates after it completes its
collection cycle. If this field is set to YES, two types of log triggering are possible.
Time Triggered Logs
If the Repeat Collection Cycle field for time triggered logs is set to YES, the log will be rescheduled for collection after its
current collection cycle has completed. The log will always be rescheduled at integral multiple periods (defined by the
collection period parameter) from the last completed cycle.
Example:

log start time - 10:00 am


collection period - 1.5 hours
(final collection time is 11:30 am)

At collection completion for the 11:30 am collection, the log will be rescheduled for final collection at 1:00 pm, if
current time is prior to 1:00 pm.

At collection completion for the 11:30 am collection, if current time is 1:01 pm, then the log will be rescheduled for
final collection at 2:30 pm.

If current time is 3:00 pm, then the log will be rescheduled for final collection at 4:00 pm.

Event Triggered Logs


If the Repeat Collection Cycle field for event triggered logs is set to YES, when trigger occurs all subsequent trigger
occurrences with respect to that log are ignored until the log has completed its collection processing.
Trigger occurs only when the trigger tag has a transition from a non-trigger state to the trigger state. After the log completes
its collection processing, the tag must trigger again (i.e., if the tag is at the trigger state when the log completes, the tag
must have a transition from trigger state to non-trigger state and then from non-trigger state to trigger state to trigger the
log). If the tag is at the non-trigger state, then a transition from non-trigger state to trigger state will trigger the log. Any
trigger occurrence during the collection processing of the log will be ignored. This does not prevent the same tag from
triggering other logs with opposite trigger states nor other logs activated after first trigger event with the same trigger state.
The interval of time the trigger tag is ignored with respect to the triggered log is indeterminate. The factors are: configuration
of the log, the logging system processing time and load, and the human system interface system load.
The time of the trigger represents:
Trip Logs - time of the trip.
Standard Logs - start time of the log; final collection time is time of the trigger plus collection period.
Periodic Logs - start time of the log; final collection time is time of the trigger plus collection period. In this case, collection
period is most likely zero.

6.5.3 Analog Collection Trigger Conditions


Two analog collection trigger conditions can be specified. Each condition is independent of the other.

If 2H is specified, the trigger occurs when the tag goes to the alarm states 2H or 3H from non-2H or non-3H alarm
states.

If 2H and 3H are specified for conditions one and two, the trigger occurs when the tag goes to the alarm states 2H
or 3H from non-2H or non-3H alarm states. The second condition at 3H is redundant.

If H and L are specified, the trigger occurs when the tag goes from normal into alarm (H, 2H, 3H for condition one;
L, 2L, 3L for condition two).

6.5.4 Analog Print Trigger Conditions


Two print trigger conditions can be specified. Each condition is independent of the other.

6-10

If 2H is specified, the trigger occurs when the tag goes to the alarm states 2H or 3H from non-2H or non-3H alarm
states.

If 2H and 3H are specified for conditions one and two, the trigger occurs when the tag goes to the alarm states 2H
or 3H from non-2H or non-3H alarm states. The second condition at 3H is redundant.
2VAA000812R0001

6. Logs

Compressing ASCII Space

6.6

If H and L are specified, the trigger occurs when the tag goes from normal into alarm (H, 2H, 3H for condition one;
L, 2L, 3L for condition two).

Compressing ASCII Space


This function reclaims ASCII space. There is a limit of 2,160 bytes for ASCII data. As ASCII strings are edited, space may
be wasted. Using the compress ASCII function reclaims this space. It is recommended that this be done before saving a
log, or periodically if doing much ASCII editing. To compress ASCII space, press F9 from the log configuration header
screen.

6.7

Saving Logs

NOTE: Before saving a log, be sure to compress ASCII space first. Refer to Compressing ASCII Space.
To save a log from the log configuration main menu, press F7.
To save a log from the log configuration header screen, press F4.

6.8

Editing Functions
Use the following keys and guidelines when editing log fields.
HOME
Goes directly to column one, row one.
Moves the cursor to a specific field for
, , ,
and
editing and to bring off screen cells into
view.
Moves the cursor within a text field or
CTRL-
scrolls through available selections in
and
fields that have a fixed number of
CTRL-
selections.
+ and Scrolls through available selections in
fields that have a fixed number of
selections. These keys are on the
numeric keypad.
Goes to the next or previous group of
PAGE UP
and
eight rows (the column position
PAGE
remains unchanged).
DOWN
In variable fields (Log Name, Description, and Collection Trigger Tag), type in numeric or alphanumeric information. In fields
with system choices (Log Type, Collection Type, Print Type, etc.), use + and - on the numeric keypad to scroll through
available selections.

6.9

Exporting Logs
To transfer a log from one human system interface to another:

1.

Right click the human system interface and select Export > Logs....

2.

Enter the location to receive the exported logs in the export logs dialog box and click OK.

2VAA000812R0001

6-11

Exporting Logs

6-12

6. Logs

2VAA000812R0001

7. Example Configuration

Introduction

7. Example Configuration
7.1

Introduction
This section describes the configuration of a simple project from the Composer window.

7.2

Example Project Data


The simple example project is depicted in Figure 7-1. Refer to this figure during the configuration process.
P R O JE C T P L A N T _O N E
CONTROL NETW ORK
N E T W O R K _O N E

HARMONY
C O NTRO L
U N IT
H C U _O N E

HARM ONY
CONTROL
U N IT
H C U _T W O

C O N D U C TO R V M S
H U M A N S Y S T E M IN T E R FAC E
H S I_O N E

C O N D U C TO R N T
H U M A N S Y S T E M IN T E R FAC E
H S I_T W O

(C O N TA IN S T W O G R O U P S O F
D IS P LAY S A N D O N E TAG LIS T.
G R O U P _O N E C O N TA IN S D IS P LAY S
P U M P _R O O M , C O M P R E S S O R _O N E ,
R E AC TO R _O N E , R E AC TO R _T W O.
G R O U P _T W O C O N TA IN S D IS P LAY
E X H AU S T _M O N ITO R . TAG LIS T
H S I_O N E _TAG S C O N TA IN S T H E
R E Q U IR E D TAG S.)

(C O N TA IN S F U R N AC E _O N E
D IS P LAY S A N D A TAG LIS T.
TAG LIS T H S I_T W O _TAG S
C O N TA IN S T H E R E Q U IR E D TAG S .)

HARM ONY
C O NTRO LLER
C O N T R O L_O N E

HARM ONY
C O N T R O LLE R
C O N T R O L_T W O

(C O N T R O L_O N E IS
C O N F IG U R E D U S IN G
C O N T R O L LO G IC
DOCUM ENTS
C LD _O N E , C LD _TW O,
A N D C LD _T H R E E .)

(C O N T R O L_T W O IS
C O N F IG U R E D U S IN G
C O N T R O L LO G IC
DOCUMENT
C LD _F O U R .)
T 020 38A

Figure 7-1 Example Project

7.3

Configuration Procedure
This procedure is divided into five parts. These parts are:

Creating project PLANT_ONE.

Creating Harmony control unit HCU_ONE.

Creating Harmony control unit HCU_TWO.

Creating human system interface HSI_ONE.

Creating human system interface HSI_TWO.

7.3.1 Project PLANT_ONE


To start the configuration of project PLANT_ONE:

1.

Select Project > New.

2.

Enter the location where the project will be stored in the Location field of the dialog box.

3.

In the Name field, type:

PLANT_ONE
4.

Click OK.

5.

Right-click the project (PLANT_ONE).

2VAA000812R0001

7-1

Harmony Control Unit HCU_ONE

6.

Select New > Control Network....

7.

In the dialog box, type:

7. Example Configuration

NETWORK_ONE
8.

Click OK.

7.3.2 Harmony Control Unit HCU_ONE


To add Harmony control unit HCU_ONE and its component parts:

1.

Right-click the control network (NETWORK_ONE).

2.

Select New > Control Unit....

3.

In the name field, type:

HCU_ONE
4.

Click OK.

5.

Right-click the Harmony control unit (HCU_ONE).

6.

Select New > Controller....

7.

In the name field, type:

CONTROL_ONE
8.

In the Controller field, type:

10
9.

In the Type field, select BRC100 from the list provided.

10. In the Firmware field, select A from the list provided.


11. In the ID field, type:

C1
12. Click OK.
13. Right-click the controller (CONTROL_ONE).
14. Select New > Logic Document....
15. In the name field, type:

CLD_ONE
16. Click OK.
17. Right-click the controller (CONTROL_ONE).
18. Select New > Logic Document....
19. In the name field, type:

CLD_TWO
20. Click OK.
21. Right-click the controller (CONTROL_ONE).
22. Select New > Logic Document....
23. In the name field, type:

CLD_THREE
24. Click OK.

7.3.3 Harmony Control Unit HCU_TWO


To add Harmony control unit HCU_TWO and its component parts:

7-2

1.

Right-click the control network (NETWORK_ONE).

2.

Select New > Control Unit....


2VAA000812R0001

7. Example Configuration

3.

Human System Interface HSI_ONE

In the name field, type:

HCU_TWO
4.

Click OK.

5.

Right-click the Harmony control unit (HCU_TWO).

6.

Select New > Controller....

7.

In the name field, type:

CONTROL_TWO
8.

In the Controller field, type:

8
9.

In the Type field, select BRC100 from the list provided.

10. In the Firmware field, select A from the list provided.


11. In the ID field, type:

C2
12. Click OK.
13. Right-click the controller (CONTROL_TWO).
14. Select New > Logic Document....
15. In the name field, type:

CLD_FOUR
16. Click OK.

7.3.4 Human System Interface HSI_ONE


To add human system interface HSI_ONE and its component parts:

1.

Right-click the lists icon below the project.

2.

Select New > Tag List....

3.

In the name field, type:

HSI_ONE_TAGS
4.

Click OK.

5.

Right-click the control network (NETWORK_ONE).

6.

Select New > Console....

7.

In the name field, type:

HSI_ONE
8.

In the Console field, type:

5
9.

In the HSI Type and Rev field, select Conductor VMS 4.0 from the list provided.

10. In the Tag List field, select HSI_ONE_TAGS from the list provided.
11. Select the FTP settings tab.
12. Click Add FTP Site.
13. In the FTP Site Description field, type:

HSI_ONE WORKSTATION
14. In the Computer Name or IP Address field, type:

HSI_1
15. In the User Name field, type:
2VAA000812R0001

7-3

Human System Interface HSI_ONE

7. Example Configuration

OISENGR
16. In the Password and Retyped Password fields, type:

OISENGR
17. Click OK.
18. Right-click the human system interface (HSI_ONE).
19. Select New > Display Group....
20. In the name field, type:

GROUP_ONE
21. Click OK.
22. Right-click the display group (GROUP_ONE).
23. Select New > Display....
24. In the name field, type:

PUMP_ROOM
25. In the Export File Name field, enter the display file name the human system interface will use to call
this display by typing:

PUMP_RM
26. Click OK.
27. Right-click the display group (GROUP_ONE).
28. Select New > Display....
29. In the name field, type:

COMPRESSOR_ONE
30. In the Export File Name field, enter the display file name the human system interface will use to call
this display by typing:

CMPRSR_1
31. Click OK.
32. Right-click the display group (GROUP_ONE).
33. Select New > Display....
34. In the name field, type:

REACTOR_ONE
35. In the Export File Name field, enter the display file name the human system interface will use to call
this display by typing:

REACTR_1
36. Click OK.
37. Right-click the display group (GROUP_ONE).
38. Select New > Display....
39. In the name field, type:

REACTOR_TWO
40. In the Export File Name field, enter the display file name the human system interface will use to call
this display by typing:

REACTR_2
41. Click OK.
42. Right-click the human system interface (HSI_ONE).
43. Select New > Display Group....
7-4

2VAA000812R0001

7. Example Configuration

Human System Interface HSI_TWO

44. In the name field, type:

GROUP_TWO
45. Right-click the display group (GROUP_TWO).
46. Select New > Display....
47. In the name field, type:

EXHAUST_MONITOR
48. In the Export File Name field, enter the display file name the human system interface will use to call
this display by typing:

XHST_MTR
49. Click OK.

7.3.5 Human System Interface HSI_TWO


To add human system interface HSI_TWO and its component parts:

1.

Right-click the lists icon below the project.

2.

Select New > Tag List....

3.

In the name field, type:

HSI_TWO_TAGS
4.

Click OK.

5.

Right-click the control network (NETWORK_ONE).

6.

Select New > Console....

7.

In the name field, type:

HSI_TWO
8.

In the Console field, type:

15
9.

In the HSI Type and Rev field, select Conductor NT 2.3 from the list provided.

10. In the Tag List field, select HSI_TWO_TAGS from the list provided.
11. In the Server Group field, type:

S2
12. Select the FTP Settings tab.
13. Click Add FTP Site.
14. In the FTP Site Description field, type:

HSI_TWO WORKSTATION
15. In the Computer Name or IP Address field, type:

HSI_2
16. In the User Name field, type:

EXAMPLE_USER
17. In the Password and Retyped Password fields, type:

EXAMPLE
18. In the FTP Destination Directory field, type:

FTP_FILES
19. Click OK.

2VAA000812R0001

7-5

Human System Interface HSI_TWO

7. Example Configuration

Figure 7-2 shows what the Composer window should look like after completing the example project configuration.

TC00979A

Figure 7-2 Completed Example Project Configuration

7-6

2VAA000812R0001

8. Miscellaneous Procedures

Utility to Copy User Views, Filters, and Replace Specifiers

8. Miscellaneous Procedures
The following topics describe the procedures for:

8.1

Copying user views, filters, and replace specifiers.

Converting DOS tools projects.

Connecting to an ICI interface on a remote server.

Utility to Copy User Views, Filters, and Replace Specifiers


A utility is provided which allows user-created browser views, filters, and replace
specifiers to be quickly copied to a different project.
To use:

8.2

1.

Run UserViewCopier from the Composer\bin directory.

2.

Select the project to copy these items from by entering the full path in
the Source Project field or navigating to it via the File button.

3.

Select the destination project by entering its full path in the


Destination Project field or navigating to it via the File button.

4.

Click Display to search the source project for user views, filters, and
replace specifiers which will be listed in the listbox to the left of the
Display button.

5.

Select the items in the listbox that are to be copied and click Copy. A
message box will indicate how many items were copied to the
destination project.

Procedure for Converting DOS Tools Projects


The Composer conversion utility is specifically designed to be backward compatible to
WinTools 2.x. Therefore, when the conversion utility is initiated from Composer, the
program needs a WinTools 2.x project as its source. For installations migrating to
Composer from DOS tools, it is recommended that Wintools be used as an intermediate
step. Wintools will detect many configuration errors that may exist in a users
configuration. Correcting these configuration errors prior to converting to Composer will
provide the most complete conversion. Conversion services are available through a
local ABB service organization.
The conversion process from WinTools to Composer may not render a perfectly converted
project. Please observe all notes logged during the conversion. It is imperative that
converted logic be compiled and that the compiled configuration files be compared to the
actual controller modules using the Runtime...Verify feature to verify correctness.
In order to generate the most accurate conversion and minimize errors, before converting
WinTools projects to Composer, ensure that the WinTools project does not have:
- Improper folder structure
- Improper files in the folder structure
- Improper file names
- Duplicate cross-reference bubbles for communication across the Infinet or Controlway
- Improperly cross-referenced off-page connections
- Missing or corrupt data in console tag lists
- User shapes or macros with the same names as system library shapes
- Inconsistent tag or console data
- Custom display symbol names with the same names as standard symbols
- Duplicate labels on sequence of events channels
- Duplicate cross-reference text, logic state descriptors, or engineering units (note that
Composer does not distinguish between upper and lower case)
The following procedure, which avoids the use of Wintools, can be used to make the
DOS configuration look like a Wintools project structure so that Composer will convert
as much as it can.

8.2.1 Procedure Requirements

2VAA000812R0001

Displays must have been saved in SODG version 5.4 or later.


8-1

Procedure

8. Miscellaneous Procedures

SCAD files are from Cadews version 5.4 or later.

8.2.2 Procedure
1.

Create a PROJECT.PRJ file. The Composer conversion program requires a WinTools 2.x
project file. A dummy project file can be created by completing the following steps.

a. Create a directory for the project. Create an ASCII text file using Microsoft Notepad or WordPad with the extension .prj as shown below:
C:\\aproject\aproject.prj

b. Type or cut and paste the following four lines of text into the project file:
[Main]
Description=Aproject
JHD=
TDT=TDT\Aproject

c.

Save and exit the file.


2.

Create the appropriate directory structure. WinTools 2.x manages the user's configuration in a
directory structure that reflects the hierarchy of the control system. Composer's conversion utility
depends upon this directory structure. The directory structure created here will be used to establish
the system architecture of the Composer project. Once the configurations have been imported, the
hierarchy can be modified in Composer.

a. Create a directory for each control network (INFI-NET or Super-Loop) in the system. Loop directories must be
named as L1, L2 L250. For example:
C:\Aproject\L1

b. Create a directory for each operator console on the project where the number that appears after Cons reflects the
node address of the console on the INFI-NET. Console directories must be named as Cons1, Cons2 Cons250. For
example:
C:\Aproject\L1\Cons1

c. Create a Microsoft Notepad or WordPad ASCI text file document named Console.cfg for each console. For
example:
C:\Aproject\L1\Cons1\Console.cfg

d. Type or cut and paste the following eight lines of text into the Console.cfg file.
[Console]
OIS_TYPE= 43
OIS_REVISION=J1
DRIVE_TYPE= 7
Description=
TagList=
TrendList=
ReportPointList=

NOTE: The console type and revision is not important at this point. The console properties can be modified in Composer after the conversion.
e. Save and exit the file.
8-2

2VAA000812R0001

8. Miscellaneous Procedures

Connecting to ICI on a Remote Server

f. Create a directory for each console symbol group on the project. Console symbols directory names must end with
.dys.
g. Move symbol .dy files to the console symbol directory. For example:
C:\Aproject\L1\Cons1\Symbols1.dys

h. Create a directory for each console display group on the project. Console displays directory names must end with
.drs.
i.

Move display .drs files to the console display directory. For example:
C:\Aproject\L1\Cons1\Displays1.drs

j. Create a directory for each operator PCU on the project. PCU directories must be named as P1, P2 P250. For
example:
C:\Aproject\L1\P2

k.

Move Cadews libraries that are common to all the models in this PCU to this directory.

l. Create a directory for each operator module on the project. Module directories must be named as M1, M2
M30). For example:
C:\Aproject\L1\P2\M5

3.

The tag database must be imported separately.

a. Run Composer Convert to convert the dummy project created in Step 1 into a Composer Project.
b. Use the tag list import feature of Composer to import the tag database.
NOTE: The tag synchronization will not take place until the graphic displays have been opened and saved in Composer.

8.3

Connecting to ICI on a Remote Server


If the ICI connection is configured to reference a remote machine, then Communication/HarmonyAPI drivers must have
been set up on the server machine already when Composer was installed on the server. To correctly set DCOM
permissions on a server:

1.

Run DCOMCNFG.

2.

Select the EBDeviceDriver class and click Properties.

3.

On the General tab, be sure the authentication level is set to Connect.

4.

On the Location tab, check the Run application on this computer checkbox and be sure the other
check boxes are left unchecked.

5.

On the Security tab, select Use custom access permissions and then edit the custom access
permissions by clicking Edit.

6.

Be sure the custom access permissions include everyone with access permission.

7.

On the Security tab, select Use custom launch permissions and then edit the custom launch
permissions by clicking Edit.

8.

Be sure the custom launch permissions include everyone with launch permission.

9.

On the Security tab, select Use custom configuration permissions and then edit the custom
configuration permissions by clicking Edit.

10. Be sure the custom configuration permissions include CREATOR OWNER and SYSTEM with full
control permission. Everyone should have read permission. INTERACTIVE gets special access with
the following options checked:

Query value.

Set value.

Create subkey.

2VAA000812R0001

8-3

Pack and Go Functionality

8. Miscellaneous Procedures

Enumerate subkeys.

Notify.

Delete.

Read control.

11. On the Identity tab, select This User and enter the login id and password of a user with administrator
access to this machine.

8.4

Pack and Go Functionality


The packing and unpacking of control logic documents (CLDs) with Revision Manager to transport them between projects
can be a long and delicate process, especially as Composer projects increase in size and complexity.
Unpacking CLDs writes a lot of data to the project database during the course of the operation. Performing other similar
write operations on the project while another is in progress can result in errors.

It is not recommended to perform multiple unpack, copy, or


import operations at the same time.
i

Composer has the ability to pack or unpack CLDs (tip revisions only) from within the Navigator (Project Explorer) itself.
Packing and unpacking can be done without the time required to start the Revision Manager. It also incorporates optimized
operation that improves performance and stability.
The Revision Manager Power Tool is still available and has not been changed; users can still pack and unpack CLDs using
that tool if desired. Since the Navigator Pack only works on tip revisions, users will need to use the Revision Manager if they
need to pack other revisions of CLDs.

8.4.1 Pack
The pack operation prepares selected CLDs for archiving or transport to another project. To pack the tip (latest) revision of
CLDs:

1.

Right click the project, control network, control unit, or controller node containing the CLDs
and select Pack. A message is displayed and the pack operation is cancelled if no CLDs
exist on the selected node.

2.

Select the CLDs to be packed by placing a check mark in the check box next to the CLD in the Pack
Selection window. Multiple CLDs can be check marked by using standard Windows multi-select
methods, right clicking the selected CLDs, and selecting Check on the context menu. Use the Select
All CLDs to Pack option to check mark all CLDs.

3.

Click Next.

4.

Enter (or select) the path and name of the .epg file created by the pack operation in the Pack Options
window. This file contains information about the packed CLD files. It is recomended that this location
be a new or empty directory.

5.

If desired, enable the Automatically create a revision for each CLD option to create a new revision of
each selected CLD in the source project (as a backup or to document which revision was packed)
before the pack operation takes place. When creating revisions, the Create revision information
option can be used to manually specify revision information. If this option is not enabled, revision
information will be extracted from the tip revision.

6.

Click Pack. A progress window displays the progress of the pack operation. Information about the
operation is also displayed in the Composer Navigator output window. The .epg file and the packed
CLDs are located in the selected location (Step 4) when the pack operation completes. The epg file
and packed CLDs can then be zipped and/or transferred to other Composer workstations for
unpacking.

8.4.2 Unpack
The unpack operation imports CLDs from another project into this project and makes them the tip revision. It is recomended
that the destination project be backed up before unpacking and the unpack take place when no other users are making
changes (copying, importing, unpacking, etc.) to the project. To unpack CLDs:

8-4

1.

Select Tools > Unpack.

2.

Select the .epg file to unpack in the Open window and click Open.

2VAA000812R0001

8. Miscellaneous Procedures

3.

Unpack

Select the CLDs to be unpacked by placing a check mark in the check box next to the CLD in the
UnPack CLD Selection window. Multiple CLDs can be check marked by using standard Windows
multi-select methods, right clicking the selected CLDs, and selecting Check on the context menu.
Use the Select All CLDs to Unpack option to checkmark all CLDs. Composer 5.1 also provides
additional options to select subsets of CLDs listed in the pack file.

NOTE: By default the unpack operation replaces the tip revision of the CLDs unpacked. Making a backup of CLDs
before unpacking is strongly recommended. Backups of the entire project should be made on a regular basis.

4.

If desired, enable the Pack selected CLDs before unpacking from pack file option to save the current
tip revision of these CLDs (the CLDs found in the project receiving the unpacked CLDs) before the
unpack operation is started.

5.

If desired, enable the Create a new revision for each selected CLD before unpacking option to create
a new revision (in the destination project) of each of the CLDs to be unpacked before the tip revision
is replaced.

6.

Click OK.

7.

If either or both of the backup options has been checked, The Unpack Options window is displayed.
If the Pack selected CLDs before unpacking from pack file option was enabled, enter the location and
name of the backup .epg file. If desired, enable the Default Filename option to enter a location for the
backup pack file in the form: <current project directory>\Backup <timestamp>\Backup.epg where
<current project directory> is the drive and path of the project, and <timestamp> is the current date
and time, make the location unique.
If the Create a new revision for each selected CLD before unpacking option was enabled, revision
information can be manually specified or extracted from the tip revision.

8.

Click OK. A progress window displays the progress of the unpack operation. Information about the
operation is also displayed in the Composer Navigator output window.

NOTE: Due to performance enhancements built into theunpack operation, it will continue to completion once OK is
clicked. If this operation is interrupted, restore the backed up or packed CLDs corresponding to the CLDs that
were to be unpacked or restore the destination project from a backup.
The project now contain the CLDs from the pack file as the tip revisions of the CLDs in the project when the unpack
operation completes. Additionally:
If the Pack selected CLDs before unpacking from pack file option was enabled, the backup .epg file is saved to the
specified location.
If the Create a new revision for each selected CLD before unpacking option was enabled, revisions of the selected
CLDs are will be in the history for each CLD.

2VAA000812R0001

8-5

Unpack

8-6

8. Miscellaneous Procedures

2VAA000812R0001

9. Standalone Configuration Viewer

Configuration Files

9. Standalone Configuration Viewer


The following topics describe the standalone configuration viewer utility. This utility performs many of the Configuration
Viewer window functions but does not require installation of the Composer application.

9.1

Configuration Files
Configuration files (.cfg) can be opened, uploaded from a controller, edited, downloaded to a controller, verified, saved, and
printed.

9.1.1 Close
To close a configuration file, select File > Close Configuration.

9.1.2 Download
To load the configuration currently displayed in the Configuration Viewer window to a controller:

1.

Select File > Load to Controller.

2.

Enter the controller address information in the Download Configuration to Controller window and click
OK.

9.1.3 Open
To open a configuration file for viewing, editing, etc.:

1.

Select File > Open Configuration.

2.

Select the desired configuration and click Open in the standard windows browse window.

9.1.4 Print, Save, and Save As


The configuration file information in the Configuration Viewer window can be printed, saved, and saved as using the
standard Windows menu options provided.

9.1.5 Upload
To load the contents of a configuration file from a controller for viewing, editing, etc.:

1.

Select File > UpLoad from Controller.

2.

Enter the controller address information in the Upload Configuration from Controller window.

3.

Choose to upload all the function blocks in the configuration (enable All Blocks option) or just the
specified blocks (single block number, range of block numbers, or a comma-delimited list of block
numbers), and click OK.

9.1.6 Verify
To compare the file information in the Configuration Viewer to the configuration file information in another controller or
configuration file:

1.

Select File > Verify.

2.

Choose to compare the file information in the Configuration Viewer to information in a controller (Use
Other Controller) or another configuration file (Use External Config File) in the Verify window.

3.

If the Use Other Controller option was enabled:

a. Enter the address of the controller in the Separate Controller area and click Test Controller.
b. If Composer has not already connected to the controller, select the appropriate logical ICI and click OK in the
Select Logical ICI Window.
c.

Proceed to Step 5.
4.

If the Use External Config File option was enabled:

a. Select the configuration file in the Choose File area.


b. Proceed to Step 5.
2VAA000812R0001

9-1

Function Blocks and Codes

5.

9.2

9. Standalone Configuration Viewer

Click OK in the Verify window and wait for the comparison results to be displayed in the output
window.

Function Blocks and Codes


Function blocks within the configuration file can be read, added, and deleted. Function code specifications can be tuned
and modified.

9.2.1 Add
To add a function block to the configuration:

1.

Right click anywhere in the configuration viewer window and select Add Block.

2.

Enter the function code number in the add function code dialog box.

3.

Enter the function block number and click OK.

9.2.2 Delete
To delete a function block from the configuration, right click the function block to be deleted and select Delete Block.

9.2.3 Read
To read specific function blocks or a range of function blocks and their specifications:

1.

Right click the function block or anywhere in the configuration viewer window and select
Read Block Range.

2.

Verify the all blocks option is disabled.

3.

Enter the function block numbers or range of numbers in the read block range dialog box and click
OK. Separate numbers or ranges of numbers with commas. Use a hyphen to separate beginning and
ending range numbers.

9.2.4 Modify
To modify the specifications of a function code:

1.

Right click the function block containing the function code to be modified and select Modify
Specs.

The spec edit dialog box appears. This dialog box shows the function block number and all the specifications that can be
modified. The specifications for all function codes can be filtered by selecting one of the following filters.
All
Displays all usable specifications.
Inputs
Displays only input specifications.
Internal
Displays only internal specifications.
Tunable
Displays only tunable specifications.
Online Configuration
Displays only online configuration specifications.
Depending on the function code, more filters are available. These filters include:
Analogs
Digitals
Failure Def
Hardware
Input
Input Addrs
Masks
Min/Max
9-2

2VAA000812R0001

9. Standalone Configuration Viewer

Tune

Module
Output
Output Addrs
Port Def
Signal
Simulation
Thermocouple
Times
Tune Params
Z11 - Z15
Z21 - Z25
Z31 - Z35
Z41 - Z45
Z51 - Z55

2.

Select the specification to be modified.

3.

Edit the value of the specification as desired. The Minimum, Maximum, and Default buttons set the
value to the indicated number. The Default All button sets all the specifications to their default values.

4.

Click OK.

Locking a specification in the control logic document but does not prevent it from being changed in the controller. This
allows for situations where immediate or temporary specification changes are required. As such, the configuration viewer
allows any specification to be changed whether it is locked or not when the source is a CFG file or a controller. However,
when trying to change locked specifications whose source is a CLD or group of CLDs, the Configuration Viewer window will
allow the specification values to be changed on screen only. Click OK and an error is displayed and all of the specifications
will return their previous values. If the user changes one locked specification and one non-locked specification and then
clicks OK, both of the specification values will be returned to their previous state.

9.2.5 Tune
To tune the specifications of a function code:

1.

Right click the function block containing the function code to be tuned and select Tune
Specs.

The dialog box shows the function block number and all the specifications that can be tuned. Use the specification filters
(refer toModify Specifications on page 62 to search for the specification to be tuned.

9.3

2.

Select the specification to be tuned.

3.

Tune the value of the specification as desired. The Minimum, Maximum, and Default buttons set the
value to the indicated number. The Default All button sets all the specifications to their default values.

4.

Click OK.

Computer Interface Modules


Configuration Viewer menu options also control connection through the computer interface module to the controller,
controller mode selection, and display of the current controller mode.

9.3.1 Connect
To connect the Configuration Viewer window to the runtime system (through the Composer server):

1.

Select Runtime > Connect....

2.

Select the logical computer interface module to be used from the list provided in the select logical ICI
dialog box.

3.

Click OK.

The status shown in the lower right corner of the window will change from Not Connected to Connected when a complete
connection to the run-time system has been made. The information transferred across this connection is module status,
module state, etc.

9.3.2 Configure
The first runtime task that must be done is telling the Configuration Viewer window which path to use when connecting to
the Composer server application. This server is in turn connected to the runtime system through a computer interface
module. To configure a Configuration Viewer window for runtime operation:

2VAA000812R0001

9-3

Disconnect

9. Standalone Configuration Viewer

1.

Select Runtime > Configure. This will launch the Harmony System Configuration tool,
hSysCfg.

2.

Select the number of the logical computer interface module (actually a path) being used by the
Composer client in the ICI configuration dialog box.

3.

Enter a brief description of the computer interface module.

4.

Enter the IP address of the Composer server node that will supply the run-time information.

5.

Select the protocol used to communicate between client and server. Local protocol is selected when
client and server are located in the same computer. TCP/IP protocol is selected when the client and
server are located in different computers.

6.

Enter the name or number of the server computer communication port through which the client
communicates. This field is only used when the TCP/IP protocol is used.

7.

Click OK.

9.3.3 Disconnect
To disconnect the Configuration Viewer window from the Composer server (and the runtime system), select Runtime >
Disconnect. The connection status in the lower right corner of the window will change to Not Connected when this operation
is complete.

9.3.4 Restart
To restart the computer interface module used by the Composer server in the path (logical ICI) selected during the
connection process, select Runtime > Restart.

9.3.5 Change Operating Mode


To change the operating mode of the controller containing the configuration displayed in the Configuration Viewer window,
select Runtime > Change Mode and the desired mode (Configure, Execute, Initialize and Restart).
If no configuration is displayed or the displayed configuration is from a file, the controller address must be selected in an
additional window (Choose Controller for Mode Operation) before the mode is changed.

9.3.6 Current Operating Mode


To view the current operating mode of the controller containing the configuration displayed in the Configuration Viewer
window, select Runtime > Display Current Mode.
If no configuration is displayed or the displayed configuration is from a file, the controller address must be selected in an
additional window (Choose Controller for Mode Operation) before the mode is displayed.

9-4

2VAA000812R0001

10. Composer Prelaunch Service

Configuration

10. Composer Prelaunch Service


The following topics describe the Composer prelaunch service which is a program that can start one or more DBServer
(handles tag information for a project) and Automation Architect (handles cross reference database information for a
project) applications when the Composer workstation is started (one DBServer and Automation Architect application per
project). Starting these applications before they are needed allows initial tag and cross reference data to be collected and
ready for use minimizing access times. When Composer starts or opens a project or control logic document, it contacts this
service (instead of opening its own application) which hands off the request to one of the already started applications.
Composer now controls the application.
Composer will function normally and directly open both of these applications for each project if this service has not already
started one or has not been configured.
Prelaunching provides the most benefits when large projects are opened. It is important to log in and wait for the DBServer
and Automation Architect (GMC32.exe) applications of these large projects to fully start before opening the project in order
to realize prelaunch benefits.

10.1 Configuration
The Composer prelaunch service must be configured by the service administrator on each Composer workstation before it
will function on that workstation. All other users will only be able to view the configuration settings. To configure the
Composer prelaunch service on a workstation:

1.

Determine the name and password of the user configuring this service if this was not
already configured during installation. This user must:

a. Have access to all Composer projects to be prelaunched wherever they may be located in the file system or network.
b. Be an administrator on this workstation.
NOTE: Use this account only for configuring the Composer prelaunch service.
NOTE: It is recommended that the 800xAService account be used when installing Composer software on 800xA system workstations.
2.

Select Start > All Programs > ABB > Composer > Composer Prelaunch Service Configuration.

3.

If the prelaunch service administrators name and password were not specified during installation,
enter them in the Configure a Username and Password window and click OK.

4.

Select up to five projects to be prelaunched and click Launch Objects Now on the Projects tab.

5.

A window stating that not all changes will be applied until all logged on users log off or execute the
Composer Prelaunch Logon Agent application (available from the Start menu) is displayed. Select
the appropriate answer when asked if these changes should still be made.

NOTE: If the configuration changes are made, notify all currently logged on users that they need to log off and log
back in (or run the Composer Prelaunch Logon Agent application) in order to utilize the configuration changes.
6.

Enable the Replace Claimed Objects option (on the Options tab) if prelaunched applications are to be
replaced as they are handed off to Composer. The next time Composer opens that project, there is a
prelaunched version ready and waiting. Without this option enabled, only the first time Composer
opens that project will the prelaunched version be available.

7.

Select the History tab and verify the prelaunched process history is as desired. The following table
describes the displayed columns. If necessary, select an application that has not been handed off to
Composer and click Shutdown Selected Object to close the application. The Refresh List button
retrieves the application list from the Composer prelaunch service. The Clear Inactive Objects button
removes all applications that:

a. Have been handed off to Composer.

- or b. Have shut down due to a failure.

- or -

2VAA000812R0001

10-1

Composer Prelaunch Logon Agent

c.

10. Composer Prelaunch Service

Have been shut down using the Shutdown Selected Objects button.

NOTE: If a prelaunched process fails (indicated by a timestamp in the Failure Time column on the History tab), check
the Windows Application Event Log for error messages from DBSPrelaunchSvc for details.

Table 10-1 Prelaunch Process History Columns


Name

Description

Type

Type of process (Automation Architect or


DBServerX).

Project Path

Path to the project associated with this


application.

Owner

Name of the user for which this application is


reserved. this column will be blank for
DBServerX applications because it is utilized by
all users.

Object PID

Process ID of the application as displayed in


the Windows Task Manager.

Composer PID

Process ID of the Composer instance to which


this application was handed off.

Start Time

Date and time the application was started.

Handoff Time

Date and time the application was handed off to


a Composer instance.

Failure Timestamp Date and time the application was closed due
to an error.

10.2 Composer Prelaunch Logon Agent


Execute this application to simulate logging out and then logging back in. This application stops all unclaimed (not being
used by a project) applications prelaunched as a result of the prelaunch service configuration active at logon and
prelaunches all applications specified in the current configuration.

10.3 Change Service Administrator


To change the administrator of the Composer prelaunch service on a workstation (This change only affects this
workstation):

1.

Determine the name and password of the new service administrator. This user must:

a. Have access to all Composer projects to be prelaunched wherever they may be located in the file system or network.
b. Be an administrator on this workstation.
NOTE: Use this account only for configuring the Composer prelaunch service.
NOTE: It is recommended that the 800xAService account be used when installing Composer software on 800xA system workstations.
2.

Select Start > All Programs > ABB > Composer > Composer Prelaunch Service Configuration.

3.

Select the Options tab, enter the desired user name and password, and click OK.

NOTE: If the password for the user account that is the Prelaunch Administrator changes, the password must also be
changed on the Log On tab of the Service Properties of the Prelaunch Service and saved before the Prelaunch Service will use the new password.

10-2

2VAA000812R0001

11. Tag List Structures

11. Tag List Structures


The following table lists the name, type, and width of the fields in the R1, S1, T1, V1, X1, S1U, X1U, and X2U structures.

Table 11-1 Taglist Structures (R1, S1, T1, V1, X1, S1U, X1U, and X2U)
Field
Number
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
2VAA000812R0001

Field Name
TAGINDEX
TAGNAME
TAGDESC
CUSTTAGID
TAGTYPE
EUDESC
EUINDEX
VAL0
SPAN
SETPTVAL0
NUMDECPL
ZEROSTATE
ONESTATE
TWOSTATE
THREESTATE
FB1_0STATE
FB1_1STATE
FB2_0STATE
FB2_1STATE
FB3_0STATE
FB3_1STATE
FB4_0STATE
FB4_1STATE
LOOP
PCU
MODULE
BLOCK
ALMSTATE
ALARMTYPE
HALARM
H2ALARM
H3ALARM
LALARM
L2ALARM
L3ALARM
ALARMDB
HVARALMTAG
H2DELTA
H3DELTA
LVARALMTAG
L2DELTA
L3DELTA
ALMINHTAG
ALMINHST
PRIMDISP

Type

Width

Numeric
Character
Character
Character
Character
Character
Numeric
Numeric
Numeric
Numeric
Character
Character
Character
Character
Character
Character
Character
Character
Character
Character
Character
Character
Character
Numeric
Numeric
Numeric
Numeric
Character
Character
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Character
Character

5
14
32
32
7
6
3
11
11
11
6
6
6
6
6
6
6
6
6
6
6
6
6
3
3
2
4, 51
6
3
11
11
11
11
11
11
11
5
11
11
5
11
11
5
2
8

Tag List
Versions
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
11-1

11. Tag List Structures

Table 11-1 Taglist Structures (R1, S1, T1, V1, X1, S1U, X1U, and X2U) (Continued)
Field
Number
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
11-2

Field Name
ALMGROUP
ALMACKBC
ALMACKNL
ALMACKTR
ALMSILTR
ADSKEYBD
ADSPANEL
ADSLAMP
PR_ALARM
SV_ALARM
PR_STCHNG
SV_STCHNG
PR_OPACT
SV_OPACT
MODTYPE
MODREV
APTASK
APSTATE
TP0TYPE
TP1TYPE
ARCHIVE
TP0LANG
TP1LANG
PM1_0STATE
PM1_1STATE
PM2_0STATE
PM2_1STATE
TEXT_SET
DEV_TYPE
DEV_NUMBER
DEVSUBTYPE
ALRM_PRTY1
ALRM_PRTY2
ALRM_PRTY3
ALRM_PRTY4
ALRM_PRTY5
ALRM_PRTY6
ALRM_PRTY7
ALRM_PRTY8
ALRM_PRTY9
ALRM_PRTYA
ALRM_PRTYB
ALRM_PRTYC
PID_BLOCK
SEC_LEVEL
SEC_GROUP
ALRMCMNT01
ALRMCMNT02

Type

Width

Numeric
Character
Numeric
Character
Character
Numeric
Numeric
Numeric
Character
Character
Character
Character
Character
Character
Character
Character
Character
Character
Numeric
Numeric
Character
Numeric
Numeric
Character
Character
Character
Character
Numeric
Character
Numeric
Character
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric

2
1
2
1
1
2
2
2
1
1
1
1
1
1
8
2
8
2
2
2
1
1
1
6
6
6
6
3
16
1
16
1, 22
1, 22
1, 22
1, 22
1, 22
1, 22
1, 22
1, 22
1, 22
1, 22
1, 22
1, 22
4, 51
2
2
5
5

Tag List
Versions
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
All
2VAA000812R0001

11. Tag List Structures

Table 11-1 Taglist Structures (R1, S1, T1, V1, X1, S1U, X1U, and X2U) (Continued)
Field
Number
94
95
96
97
98
99
100
101
102
103

Type

Width

ALRMCMNT03
ALRMCMNT04
ALRMCMNT05
ALRMCMNT06
ALRMCMNT07
ALRMCMNT08
ALRMCMNT09
ALRMCMNT10
ALRMCMNT11
CNTRLENABL

Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Character

5
5
5
5
5
5
5
5
5
1

104

STR_LENGTH

Numeric

105

PRIMDSPCRT

Numeric

106

ALRM_PRTYD

Numeric

1, 22

107

ALRM_PRTYE

Numeric

1, 22

108

ALRMCMNT12

Numeric

109

ALRMCMNT13

Numeric

110
111

TAGTYPESRC
USER1 (Manual
Inhibit)
USER2 (Alarm
Print Inhibit)
USER3 (Inhibit
Delay)
USER4 (Station
Type)
USER5 (Deviation
Alarm Limit)
USER6 (Switch
Type)
USER7 (Archive
Class Name)
USER8 (Default
Value)

Character
Character

8
4

Tag List
Versions
All
All
All
All
All
All
All
All
All
S1, T1, V1, X1,
S1U, X1U, X2U
S1, T1, V1, X1,
S1U, X1U, X2U
T1, V1, X1,
X1U, X2U
V1, X1, X1U,
X2U
V1, X1, X1U,
X2U
V1, X1, X1U,
X2U
V1, X1, X1U,
X2U
X1, X1U, X2U
S1U, X1U, X2U

Character

S1U, X1U, X2U

Character

S1U, X1U, X2U

Character

S1U, X1U, X2U

Character

12

S1U, X1U, X2U

Character

12

S1U, X1U, X2U

Character

16

S1U, X1U, X2U

Character

16

S1U, X1U, X2U

112
113
114
115
116
117
118

Field Name

NOTES:
1. Tag list structure X2U value.
2. Tag list structure S1U and X1U value.

2VAA000812R0001

11-3

11. Tag List Structures

11-4

2VAA000812R0001

12. Composer Power Tools

Control Logic Editor

12. Composer Power Tools


The following topics describe the Composer Power Tools suite of add-on applications that extend the capabilities of
Composer and reduce the amount of time required to engineer and configure a Harmony system. The included applications
are:

Control Logic Editor.

Revision Manager.

Automatic Drawing Generator.

Advanced Trend.

The Control Logic Editor, Automatic Drawing Generator, and Advanced Trend applications require an additional license
while the Revision Manager does not. Refer to the Introduction and Installation instruction for information about installing
these application.

12.1 Control Logic Editor


This utility contains four tools which are accessed by clicking the appropriate icon located on the left side of the window.
The four tools are Manipulate CLs, Text/Xref Editor, Function Code Editor, and Database Utilities.
The Manipulate CLs tool allows the control logic documents (CLDs) attached to a controller to be placed in a different order,
exploded (individual sheets turned into CLDs), or merged (multiple CLDs turned into one CLD).
The Text/Xref Editor tool allows control logic document text and cross-reference data to be extracted to a user-specific
database (automatically created) where it can be edited. The source CLDs can be updated from this database allowing bulk
updating of text entities and cross references. Information in the user-specific database can be exported to an external
Microsoft Access database. Information in an external Microsoft Access database can be imported into this user-specific
database. How and what information is displayed from this user-specific database is also configurable through the standard
views functionality within Composer.
The Function Code Editor tool allows CLD function code data to be extracted to another user-specific database where it can
be edited. The source control logic documents can be updated from this database. Information in the user-specific database
can be exported to an external Microsoft Access database. Information in an external Microsoft Access database can be
imported into this user-created database. How and what information is displayed is also configurable through the standard
views functionality within Composer.
The Database Utilities tool allows the compacting, deleting, appending, and renaming of user-specific control logic editor
databases.
Miscellaneous Issues
When updating control logic documents after making changes to OREF descriptor text, an ADO Error Condition message
may be displayed in the output window. This error can occur if an update was performed to control logic documents in a
module from the Control Logic editor, the editor was left open while new control logic documents were added to the module,
and then these new control logic documents were extracted, modified and another update performed (all without closing the
Control Logic Editor). Performing a second update will cause the OREF descriptors to be updated correctly. It is strongly
recommended that the Control Logic Editor be closed prior to making changes (adding, deleting, or editing contents) in
control logic document using Composer. Reopen the Control Logic Editor after making these changes and re-extract the
control logic document data.
Another workaround would be to close the Control Logic Editor and reopen it prior to performing the final update in the
aforementioned sequence.
If a CLD is added, deleted, or changed while the Control Logic Editor is open, the project must be refreshed in the CLE
Extract window before trying to extract data from the changed CLD.
Exporting to a database that is open does not update the database. Close the destination database before exporting.

12.1.1 Manipulate CLs Tool


This tool provides the ability to put the control logic documents associated with a controller into a different order, convert a
multisheet control logic document into multiple single sheet control logic documents, merge multiple control logic document
into a single control logic document, and print control logic documents. It is also possible to open and rename control logic
documents.

NOTE: Use the View > Refresh option to update the Manipulate CLs window with the latest data from the Composer
project.

12.1.1.1 Explode CLDs


To convert each sheet of a multisheet control logic document into separate single sheet control logic documents:

1.

Select the control logic document and click Explode CLDs.

2.

Click OK when prompted that the explode operation has completed.

Each new control logic document is given a name of the following format:

2VAA000812R0001

12-1

Manipulate CLs Tool

12. Composer Power Tools

original_cld_name.original_sheet_name
Where:

original_cld_name = Name of the original control logic document being exploded.


original_sheet_name = name of one of the sheets from the original control logic document
that is now contained as the only sheet in the exploded control logic document.
If a control logic document name exceeds 64 characters in length, a prompt will require a new, shorter name be specified for
the control logic document.
The original multisheet control logic document is deleted.
Example:
A control logic document named 3000 (containing sheets named ABC and DEF) is exploded. Control logic documents
3000.ABC and 3000.DEF are created. Control logic document 3000.ABC contains a single sheet named ABC. Control logic
document 3000.DEF contains a single sheet named DEF. Control logic document 3000 is deleted.

12.1.1.2 Merge CLDs


To combine two or more control logic documents into a single control logic document:

1.

Select the control logic documents and click Merge CLDs.

2.

Enter a name for the new control logic document being created and click OK.

3.

Click OK to confirm the completion of the merge operation.

Each sheet in the new control logic document is named using the following format:

original_cld_name.original_sheet_name
Where:

original_cld_name = Name of one of the original control logic document being merged
together.
original_sheet_name = Name of one of the sheets from one of the original control logic
document being merged together.
If a sheet name exceeds 32 characters in length, a prompt will require a new, shorter name be specified for the sheet.
The original control logic documents are deleted.
Example:
Control logic document 3000 (containing sheets named ABC and DEF) and 3001 (containing sheets named GHI and JKL)
are merged together. The resulting control logic document contains four sheets named 3000.ABC, 3000.DEF, 3001.GHI,
and 3001.JKL. Control logic documents 3000 and 3001 are deleted.

12.1.1.3 Print CLDs


To print the selected control logic documents:

12-2

1.

Right click one of the selected control logic documents and select Print.

2.

Enable or disable the auto orientation option in the Print window. When enabled, revisions utilizing a
horizontal border are printed using landscape orientation and revisions utilizing a vertical border are
printed using a portrait orientation.

3.

Select the sheets to be printed (All, Range, or None (Cross-Reference Report Only)). The default To
field value is determined automatically from the CLD when only one CLD is being printed. The default
To field value is 99 when multiple CLDs are being printed. If this field is set to a value greater than the
number of sheets in a CLD being printed, all the sheets will be printed.

4.

Select to export the cross-reference report to a text file, print it along with the CLDs, both, or do
nothing with report.

5.

If necessary, click View to read the report.

6.

Select the desired print quality and number of copies of each revision.

7.

Enable or disable the print to file option as required.

8.

Click Setup to open the standard Windows print setup dialog box. Configure the options as
necessary.

9.

Click Style to configure how the revisions are to be printed.

2VAA000812R0001

12. Composer Power Tools

Text/Xref Editor

10. On the entries tab of the style setup window, select the specifications, tags, symbols, and crossreferences to be printed.
11. On the layers tab, set the layers to be printed.
12. On the layout tab, set the margins, alignment, and scale of the control logic document.
13. On the header/footer tab, configure the header and footer using the codes provided.
14. Click OK.
15. Click OK.

12.1.1.4 Reorder CLDs


To reorder the control logic documents within a controller:

1.

Select one or more control logic documents whose order number is to be changed. Selected
documents do not need to be contiguous.

2.

Drag the control logic documents to a position such that a green arrow is displayed next to the control
logic document ahead of which the moved control logic documents will reside.

3.

Repeat Steps 1 and 2 until all control logic documents are in the desired order.

4.

Click Reorder as Shown.

12.1.1.5 Select/Deselect CLDs


To select or deselect one or more control logic documents, use standard Windows single and multiple selection
functionalities.
To select or deselect all the control logic documents currently being displayed, right click the controller or one of the control
logic documents and select Select All or Select None.
To select all the control logic documents that are currently not selected and deselect all those that are currently selected,
right click one of the selected control logic documents and select Invert Selections.

12.1.1.6 Set Database Warnings


This function allows a warning level for the user database size to be specified. When the user database size exceeds the
size specified, the displayed text will turn red and a warning will be displayed when the tool is exited. This warning function
helps in the management of computer resources but does not affect usability of the data or the control logic editor tool.
To configure a database size level:

1.

Select Tools > DB Warning Options or Operations > Warning Options (Database Utilities).

2.

Configure the appropriate database size warning level and click OK.

12.1.2 Text/Xref Editor


This tool provides the ability to extract text and cross-reference information from control logic documents, edit records, and
update the control logic documents with the edited data. Editing functions consist of adding records, deleting records,
changing record data, importing data from external databases, exporting data to external databases, etc. It is also possible
to configure how and what information is displayed through the use of views and fonts.
The Text/Xref Editor also allows the name of a shape to be changed and keeps the text intact. For example IREF objects
can be changed to inputs from the bus (DI/B, AI/B, etc.) and the same cross-reference descriptor text is maintained. The
ability to change the shape name between text and XREFs also exists. In this case, the XREF function code is either added
or deleted and the text string is either used as the cross-reference descriptor or given the value from the cross-reference
descriptor.
The List ID field is used with list input function codes (FC 46, FC 63, etc.). This field is set to an arbitrary value during the
extract operation. When adding cross-references to an existing list input function code, ensure the List ID data given
matches the data found in this field for other cross-references associated with the target list input function code. Setting the
list ID to a value that does not match the List ID field of any of the other extracted records will cause a new list input function
code to be created. The list ID, in conjunction with the XREF input number (value of 0 through 7), is used to identify all the
inputs for a list input function code.
The information in the Orig Address and Orig Position fields is used to identify a record. Information in the Orig Address field
is in the format:

AAA.BBB.CC.DD
Where:

AAA = Control network address.


BBB = Control unit address.
2VAA000812R0001

12-3

Text/Xref Editor

12. Composer Power Tools

CC = Controller address.
DD = Controller ID.
Information in the Orig Position field is in the format:

EE.FFFF.GGG-HHII
Where:

EE = Controller ID.
FFFF = Control logic document number.
GGG = Sheet number.
HH = Y coordinate of the function code from the border.
II = X coordinate of the function code from the border.

12.1.2.1 Add a Record


The adding of records is independent of the view. Added records are initially shown but may not be shown after the filter (if
used) is reactivated.
To add a record to the user database:

1.

Select Browser > Add New Record.

2.

Fill in the fields and click OK or Apply.

12.1.2.2 Change Fields


To specify the fields to be contained in the current view:

1.

Select Browser > Modify Current View.

2.

Click Fields in the modify view window.

3.

Move fields from the available fields list to the selected fields list (fields that will be displayed) or vice
versa by selecting the fields and using the appropriate button in the user defined fields dialog box

4.

Arrange the fields in the desired order (top of the list is the left most column and bottom of the list is
the right most column) by selecting the field and using the up and down buttons.

5.

Click OK.

12.1.2.3 Change Filter Criteria


To specify the filter criteria to be used in the current view:

1.

Select Browser > Modify Current View.

2.

Click Filters in the modify view window.

3.

If a previously saved filter is to be used, select the filter and proceed to Step 16.

4.

If a relatively simple condition is to be configured, select a field whose value will be used in the filter
criteria and proceed to the next step. If a more complex condition is required, proceed to the next
step. The fields to search list contains all the currently viewable fields.

5.

Click Add Where Cond (for a relatively simple condition) or Add Adv Where (for a more complex
condition).

6.

If the Add Where Cond button was used, proceed to the next step. If the Add Adv Where button was
used, proceed to Step 8.

7.

Select the condition by which the field is true and proceed to Step 12.

8.

Enter an expression in the Expression1 field in the advanced filter builder window. Refer to Special
Search Characters (Filter and Find), String Functions, and String Functions for more
information. Standard SQL syntax (special search characters), along with standard Visual Basic
string and math functions, are used in this dialog box.

9.

Select an operation in the Operator field.

10. Enter an expression in the Expression2 and Expression3 (if the between operation was selected)
fields.
11. Click Validate to have the condition checked for being valid. Correct the condition if necessary.
12. Click OK.
12-4

2VAA000812R0001

12. Composer Power Tools

Text/Xref Editor

13. Repeat Steps 4 through 12 as required. AND logic operators are automatically placed between field
conditions.
14. Edit any field condition by selecting the expression and clicking Modify.
15. Edit the filter logic expression by inserting the cursor at the desired location and selecting the desired
logic operator.
16. Click Close.

12.1.2.4 Change Column Order


To change the order in which columns are displayed (method one), select and drag the column being moved to a position
where a red line indicates the desired insertion point.
To change the order in which columns are displayed (method two):

1.

Select Modify Current View.

2.

Select a field that is to be moved to another location within the record and move the field to the
desired location using the up and down arrow keys.

3.

Repeat Step 2 until the fields are in the correct order.

4.

Click OK and Apply.

12.1.2.5 Change Sort Order


To change the sort order of one or more fields in the current view:

1.

Select Browser > Modify Current View.

2.

Click Sorts in the modify view window.

3.

Select the field whose order is to be changed in the sort tag by window and click Add. The field name
is added to the Sort Fields field along with an indication of the present sort order.

4.

Select the field name and click Descending or Ascending.

5.

Repeat Steps 3 and 4 for all fields being changed.

6.

Configure the order in which the sorts will take place by selecting a sort field and moving it to the
correct position using the up and down buttons. The top sort field is sorted first, then the sort field
below it, and so on.

7.

Click OK.

12.1.2.6 Create New View


To create a new view:

1.

Select Tools > Manage Views.

2.

Select the data type to be used in the new view and click New in the manage views window.

3.

Enter a name for the view in the create view dialog box and click OK. The name of the new view
appears in the list of available views.

To create a new view that is identical to the current view:

1.

Select Browser > Save View As.

2.

Enter a name for the view in the save view as dialog box and click OK.

To create a new view that is identical to an existing view:

1.

Select Tools > Manage Views.

2.

Select the data type of the view being copied.

3.

Select the view being copied from the list and click Copy.

4.

Enter a name for the new view in the copy view window and click OK.

12.1.2.7 Edit Data


Editable fields have a white background. Changes made to these fields are saved only to the user-specific database. The
control logic document is not changed.
Changed fields (different from the original extracted data) have an off-white background.
Uneditable fields have a gray background.
2VAA000812R0001

12-5

Text/Xref Editor

12. Composer Power Tools

Not applicable fields (based on the record shape type, function code number, or extraction option used) are displayed in
solid dark blue.
Records that can not be marked for deletion (because they are locked or a template controls their deletion) have the Shape
Name or Function Code Number field displayed in blue (locked) or red (template deletion controlled) on a gray background.
All other text in the record is displayed in dark green on a gray background.
Records that can not be moved (because they are location locked or a template controls their location) have XY coordinates
and relative XY coordinates displayed in blue (locked) or red (template location controlled) on a gray background.
Specifications that can not be edited (because they are locked or controlled by a template) are displayed in blue (locked) or
red (template location controlled) on a gray background.
Records marked for deletion are displayed with a line through all text.
Records containing an error that occurred during an update are displayed in magenta and the Update Error Text field will
contain error description text. The following table provides a summary of these color conditions.

Table 12-1 Color Condition Summary


Item

Condition

Text
Color

Background
Color

Field

Editable

Black

White

Field

Changed (different from original


extracted data)

Black

Off-white

Field

Uneditable

Black

Gray

Field

Not applicable

Black

Dark blue

Record (whole)

Marked for deletion

Various,
lined
through

White

Record (whole)

Error occurred during an update

Magenta

White

Record (Shape Name Record cannot be marked for deletion


or Function Code
because it is locked
Number field)

Blue

Gray

Record (Shape Name Record cannot be marked for deletion


or Function Code
because a template controls deletion
Number field)

Red

Gray

Record (all remaining Record cannot be marked for deletion


fields)
and Shape Name or Function Code
Number fields are blue or red.

Dark
green

Gray

Specification

Cannot be edited it is locked or


controlled by a template

Blue

Gray

Specification

Cannot be edited because a template


controls its location

Red

Gray

XY and relative XY
coordinates of entity

Cannot be moved because they are


location locked or a template controls
their location

Blue

Gray

XY and relative XY
coordinates of entity

Cannot be moved because a template


controls their location

Red

Gray

12.1.2.8 Export Data


To export data to other Microsoft databases (.mdb file extension):

12-6

1.

Select Tools > Export.

2.

Select the source list name (Cross References And Text when in the text/xref editor and Function
Codes when in the function code editor) in the export to external database window.

3.

Select the name of the external database file and table receiving the exported data.
2VAA000812R0001

12. Composer Power Tools

Text/Xref Editor

4.

Select to export all data fields or just those displayed in a certain view.

5.

If necessary, select the view to be used when exporting data. The exported view must contain the
object name field In order to import changes made in the external database.

6.

Click OK.

12.1.2.9 Extract Data


To extract data from the project database for use by the Text/Xref Editor:

NOTE: Use the extract function to update the Text/Xref Editor with the latest data from the Composer project.

1.

Select Tools > Extract.

2.

Read the extract wizard window and click Next.

3.

Select the type of data to extract and what coordinates to use in the Extract Wizard - Filters window.
Relative coordinates are measured from the border origin.

NOTE: Views only alter the way the extracted information is displayed. They do not supplement or add information.
For example, if OREFs are not extracted, they can not be seen by using a view that shows OREFs.
4.

Click Next.

5.

Select the control logic documents from which to extract the data (select the box to the left of the
control logic document) in the Extract Wizard - Selections window and click Next. If Next is clicked
without anything being selected, the control logic documents that were selected in the Composer
navigator when the control logic editor was started will be automatically selected.

6.

Click Finish in the Extract Wizard - Confirm Selections window.

7.

Click OK when prompted that the extract operation is complete.

To extract data from the project database for use by the Function Code Editor:

NOTE: Use the extract function to update the Function Code Editor with the latest data from the Composer project.

1.

Select Tools > Extract.

2.

Read the Extract Wizard window and click Next.

3.

Select the type of data to extract, coordinates, and the additional options to use in the Extract Wizard
- Filters windows. Relative coordinates are measured from the border origin. Address specifications
are not editable and slow down the extract operation so it not recommended that they be extracted
unless they are needed for reference. If the Extract Ambient Text option is selected, up to three text
strings will be extracted from the upper left corner of a function code in the order found of closeness.
This text must have its origin within a 40x60 grid increment square that has its lower left corner
defined as -20,0 (0,0 is the top left corner). This feature is very useful for removing tag name and
description text placed above a function code in projects converted into Composer. The Extract
Ambient Text option also extracts a text entity placed within a function code. If more than one text
entity exists, the entity closest to the upper left corner of the function code will be extracted.

NOTE: Views only alter the way the extracted information is displayed. They do not supplement or add information.
For example, if OREFs are not extracted, they can not be seen by using a view that shows OREFs.
4.

Click Next.

5.

Select the control logic documents from which to extract the data (select the box to the left of the
control logic document) in the Extract Wizard - Selections window and click Next. If Next is clicked
without anything being selected, the control logic documents that were selected in the Composer
navigator when the control logic editor was started will be automatically selected.

6.

Click Finish in the Extract Wizard - Confirm Selections window.

7.

Click OK when prompted that the extract operation is complete.

12.1.2.10 Find Records


To find a specific record in the records currently displayed:

1.

Select Browser > Find Records.

2.

Select the find tab.

2VAA000812R0001

12-7

Text/Xref Editor

12. Composer Power Tools

3.

If a relatively simple condition is to be configured, select a field whose value will be used in the find
criteria and proceed to the next step. If a more complex condition is required, proceed directly to the
next step. The Field to Search list contains all the currently viewable fields of the list.

4.

Click Add Where Condition (for a relatively simple condition) or Add Adv Where (for a more complex
condition).

5.

If the Add Where Cond button was used, proceed to the next step. If the Add Adv Where button was
used, proceed to Step 8.

6.

Configure the condition by which the field is true and p.

7.

Proceed to Step 12.

8.

Enter an expression in the Expression1 field in the advanced filter builder window. Refer to Special
Search Characters (Filter and Find), String Functions, and Math Functions. Standard SQL
syntax (special search characters), along with standard Visual Basic string and math functions, are
used in this window.

NOTE: This functionality pattern matches an entire field and is case sensitive. The replace functionality searches for
and replaces substrings within a field and is not case sensitive.
9.

Select an operation in the Operator field.

10. Enter an expression in the Expression2 and Expression3 (if the between operation was selected)
fields.
11. Click Validate to have the condition checked for being valid. Correct the condition if necessary.
12. Click OK.
13. Repeat Steps 3 through 12 for the remaining fields. AND operators are automatically placed between
field conditions.
14. Edit any field conditions by selecting the expression and selecting Modify.
15. Edit find logic expression by inserting the cursor at the desired location and selecting the desired
logic operator.
16. If the find filter may be needed again, save it by clicking Save Filter and proceed to the next step. If
the find filter is not being saved, proceed to Step 18.
17. Enter a name for the filter in the save/replace filter window.
18. Click Close.
19. Click the appropriate find button and the cursor will be placed in the record.

12.1.2.11 Go to a Record
To move the cursor to a specific record in the list:

1.

Select Browser > GoTo Row.

2.

Enter the record number in the dialog box and click OK.

12.1.2.12 Import Data


To import data from other Microsoft databases (.mdb file extension):

1.

Select Tools > Import.

2.

Select the name of the database file and table containing the information being imported in the Import
from External Database window.

3.

Select the destination list name (Cross References And Text when in the text/xref editor and Function
Codes when in the function code editor) in the to list name field.

4.

Enable or disable the import new records, overwrite existing records, and ignore empty fields options.

5.

Select to log all operations or only the errors and click OK.

Only changes made to fields that can be edited in the browser view will be imported. The export all fields option must be
used when selecting the export view in order to use the import new records option (to import records created in the external
database).

12-8

2VAA000812R0001

12. Composer Power Tools

Text/Xref Editor

12.1.2.13 Mark/Unmark Records for Deletion


To mark or unmark selected records for deletion from the appropriate control logic documents:

1.

Select the records to be marked or unmarked for deletion.

2.

Select Browser > Mark/Unmark For Delete from CLD.

Marked records become unmarked and unmarked records become marked.

NOTE: Records shown in the current view that are marked for deletion will be removed from the control logic document during the update operation.

12.1.2.14 Refresh Records


To refresh one record:

1.

Select the record to be refreshed.

2.

Select Browser > Refresh Current Row.

To refresh all the records in the current view:

1.

Select Browser > Refresh View.

2.

Click OK when notified that changed records that no longer match the view criteria will not be
displayed in this view.

12.1.2.15 Remove Records


To remove records from view:

1.

Select the records.

2.

Select Browser > Remove Current Row From View.

3.

Click Yes when prompted to confirm the deletion of this row.

This procedure only removes the record from the user database. It does not remove the entity associated with the record
from the control logic document. Records that have been removed from view are not visible in any view until the record is
again extracted from the control logic document or imported from an external database.

12.1.2.16 Replace Records


To replace the value of a field with another value:

1.

Select Browser > Replace Records.

2.

Optionally, use the find records functionality to limit the displayed records to only those receiving the
replacement values.

3.

Select the replace tab.

4.

If a relatively simple replace pattern or value is to be configured, select the field whose value is to be
replaced from the list. If a more complex pattern or value is required, proceed to Step 9.

5.

If a previously saved replace filter is to be used, select the name in the Saved Replace Specifiers
field and proceed to Step 21.

6.

Click inside the Value to replace field and enter the current field value that is going to be replaced.

7.

Enter the desired field value in the Replace with field.

8.

Proceed to Step 21.

9.

Click Advanced. The advanced replace pattern builder window appears.

10. Select the field containing the text value being replaced.
11. Enter an expression (limited to text, numbers, and the special search characters) enclosed in double
quotation marks into the Expression To Search For field. Refer to Special Search Characters
(Replace). Regular expression syntax (with standard Visual Basic string and math functions) is used
in this window.
12. Enter an expression in the Expression To Replace With field. Refer to Special Replace Characters,
String Functions, and Math Functions for more information. Only plain text, simple numbers, and

2VAA000812R0001

12-9

Text/Xref Editor

12. Composer Power Tools

special replace characters need be enclosed in double quotation marks in the Expression To Replace
With field.
NOTE: This functionality searches for and replaces substrings within a field and is not case sensitive. The find functionality pattern matches an entire field and is case sensitive.
13. To test the advanced replace criteria (if desired) or just become familiar with advanced replace
criteria in general, click Practice Reg Expr. If testing or practice is not required, proceed to Step 21.
The advanced replace patterns practice dialog box supports only text, numbers, special search
characters, and special replace characters.
14. Enter the whole value of the field containing the text or value to be replaced in the String To Be
Replaced field.
15. Enter the string that is to be replaced in the Search For field.
16. Enter the replacement string in the Replace With field and click Replace Text. The Resulting String
field displays the end result if this operation really happened.
17. Repeat Steps 14 through 16 as required.
18. Click Exit.
19. Click OK. The replace expression is validated and a dialog box stating the result is displayed.
20. Click OK to complete configuration of the advanced replace criteria (if criteria is valid) or to return to
the advanced replace pattern builder dialog box (if criteria is not valid).
21. Use the Find First, Find Next, Replace, and Replace All buttons to control the replacement
functionality.
22. If desired and after a successful replace operation, save the replace criteria by selecting Save
Replace As. Enter a name and click OK.

12.1.2.17 Restore Data


To make the user-specific database data equal to the originally extracted data:

1.

Select Browser > Restore Original Data.

2.

Click Yes when queried if the restore operation should continue.

Every editable field in the control logic editor has a corresponding original data field. All fields that have been edited (differ
from the original data field) have an off-white background. This feature allows all changes made to the extracted data to be
removed at one time.

12.1.2.18 Save Current View


To save the current view, select Browser > Save or Browser > Save As.

12.1.2.19 Select New View


To select a new view:

1.

Select Browser > Select View.

2.

Select the view from the list provided and click OK.

12.1.2.20 Select Font


To select the font and associated characteristics used to display information:

1.

View the information.

2.

Select Browser > Select Font.

3.

Select the font, font style, and text character size.

4.

Select if strikeout, underline, or normal (no selection required) characters are to be used.

5.

Select the text character color.

6.

Select the appropriate script (character set) and click OK.

12.1.2.21 Select Records and Columns


To select all the records in the current view, click Row in the upper left corner of the table.
12-10

2VAA000812R0001

12. Composer Power Tools

Text/Xref Editor

To select multiple consecutive columns:

1.

Click (and hold) the header of the first column.

2.

Drag the cursor to the last column and release the button.

To select multiple consecutive records:

1.

Click (and hold) the row header of the first record.

2.

Drag the cursor to the last record and release the button.

To select multiple non-consecutive columns:

1.

Click (and hold) the header of the first column.

2.

Depress CTRL and click the next column.

3.

Repeat Step 2 for the remaining columns.

To select multiple non-consecutive records:

1.

Click (and hold) the row header of the first record.

2.

Depress CTRL and click the next record.

3.

Repeat Step 2 for the remaining records.

To select one column, click the column header.


To select one record, click the row header of the record.

12.1.2.22 Set Database Warnings


This function allows a warning level for the user database size to be specified. When the user database size exceeds the
size specified, the displayed text will turn red and a warning will be displayed when the tool is exited. This warning function
helps in the management of computer resources but does not affect usability of the data or the control logic editor tool.
To configure a database size level:

1.

Select Tools > DB Warning Options or Operations > Warning Options (Database Utilities).

2.

Configure the appropriate database size warning level and click OK.

12.1.2.23 Update Control Logic Documents


Control logic documents can be updated with all user-specified database data or just changed user-specific database data.

All User-Specific Database Data. This updates the control logic documents with all of the user-specific database data even if the
editable data matches the original data fields that were extracted from the control logic documents. This is useful in
instances where an extract operation was performed, data was changed, an update was performed, and then a few
changed fields were changed back to match their extracted value. The data in these fields will be written back to the control
logic documents if the Update All Records option is used as opposed to the Update option which only updates control logic
documents with user-specific database data that is different from the original data fields that were extracted from the control
logic documents.
To update the control logic documents with user-specific database data even if the editable fields match the extracted data:

1.

Select a view. Only the records shown in the view will be used to update the control logic
documents.

2.

Select Tools > Update All Records.

3.

Click OK when prompted that the control logic documents will be updated with the values of all
editable fields.

4.

Select the appropriate update options found in the Update Wizard window and click OK. Refer to
Changed User-Specific Database Data for more information about these options.

5.

Click OK when prompted that the update operation is complete.

Changed User-Specific Database Data. To update control logic documents with user-specific database data that is different from
the data that was extracted from the control logic documents originally (using the text/xref editor):

1.

Select a view. Only the records shown in the view will be used to update the control logic
documents.

2.

Select Tools > Update.

3.

Click OK when prompted that control logic documents will be updated from all editable fields (within
the records) that differ from the original extracted data.

2VAA000812R0001

12-11

Text/Xref Editor

12. Composer Power Tools

4.

Enable the appropriate options in the Update Wizard window and click Finish.

The delete signal line options also apply to XREF shapes that were changed to text. The
propagate OREF description changes options are used to rename IREFS that are
associated with the OREF being changed. The display overwrite warning option is used to
notify the user that the extracted data in the original data fields no longer matches the data
in the control logic document for a field that is about to be updated. If the data does not
match, a change has been made to the control logic document since the data was
extracted.
5.

Click OK when prompted that the update operation is complete.

To update control logic documents with user-specific database data that is different from the original data fields that was
extracted from the control logic documents (using the function code editor):

1.

Select a view. Only the records shown in the view will be uses to update the control logic
documents.

2.

Select Tools > Update.

3.

Click OK when prompted that control logic documents will be updated from all editable fields (within
the records) that differ from the original extracted data.

4.

Enable the appropriate options in the Update Wizard window and click Finish.

The delete input signal branches option allows the automatic deletion of all signal line
branches associated with the function codes inputs when a function code is deleted. For
example, assume an IREF is connected to two function codes (A and B). Deleting function
code A (using this option) deletes the function code and only the signal line branches
connected to it. When output signal lines are to be deleted, all the signal lines connecting
other entities to the function code outputs are deleted. The display overwrite warning option
is used to notify the user that the extracted data in the original data field no longer matches
the data in the control logic document for a field that is about to be updated. If the data does
not match, a change has been made to the control logic document since the data was
extracted.
5.

Click OK when prompted that the update operation is complete.

12.1.2.24 View List of Views


To view a list of all the views that apply to a data type:

1.

Select Tools > Manage Views.

2.

Select the appropriate data type.

A list of the views associate with the selected data type is provided in the upper part of the manage view window. The lower
part lists the fields used in the view along with any filter and sort criteria used.

12.1.2.25 View Record Properties


To view or edit the properties of a record:

1.

Select the record.

2.

Select Browser > Properties.

3.

View the desired properties in the properties window and click OK.

12.1.2.26 Vocabulary
It is possible to select one of the text or number based fields in the current view and get a listing of all the unique numbers
or words contained in that field for all the records. Also displayed is a count of how many times each number or word
occurs. The listed numbers or words can be edited and that change can be propagated (one field at a time or all at once)
throughout all the records in the view.
To use the vocabularies function:

12-12

1.

Select Browser > Vocabulary.

2.

Select the field of interest in the field vocabularies window.

3.

Click Scan Field. The word in column is the number or word listing, the change to column lists
replacement data, and the count column lists the number of occurrences.
2VAA000812R0001

12. Composer Power Tools

Function Code Editor

4.

If a listed number or word is to be updated, proceed to the next step. If no updating is required,
proceed to Step 9.

5.

Edit the number or word as required in the change to field and click Find First. The cursor is moved to
the first data browser field (starting from the first record) that contains the unedited number or word.

6.

View the Original Field and Updated Value (displays the resulting value if replace functionality is
used) fields and verify the correct action is to be performed.

7.

Click Replace, Replace All, or Find Next.

8.

If there are multiple occurrences of the number or word, repeat Steps 6 and 7 until all occurrences
are updated.

9.

Repeat Steps 2 through 8 for each text/xref editor field of interest.

12.1.3 Function Code Editor


This tool provides the ability to extract function code information from control logic documents, edit records, and update the
control logic documents with the edited data. Editing functions consist of adding records, deleting records, changing record
data, importing data from external databases, exporting data to external databases, etc. It is also possible to configure how
and what information is displayed through the use of views and fonts. All of the operations that can be performed by the
text/xref editor can also be performed by the function code editor and are listed below:

Add a Record.

Change Fields.

Change Filter Criteria.

Change Column Order.

Change Sort Order.

Create New View.

Edit Data.

Export Data.

Extract Data.

Find Records.

Go to a Record.

Import Data.

Mark/Unmark Records for Deletion.

Refresh Records.

Remove Records.

Replace Records.

Restore Data.

Save Current View.

Select New View.

Select Font.

Select Records and Columns

Set Database Warnings.

Update Control Logic Documents.

View List of Views.

View Record Properties.

Vocabulary.

The Assigned Tag field (in the Function Code Editor window) displays the existing tag that is associated with the function
code. Changing this field value causes a different existing tag to be associated with this function code. This field can not be
used to edit a tag name or create a new tag name (use the tag editor within Composer).

2VAA000812R0001

12-13

Database Utilities

12. Composer Power Tools

The String Spec n fields are used to edit string type specifications because strings can not be entered into the fields Spec 1
through Spec 54. For example (in function code 221), String Spec 1 would represent specification 1 while String Spec 2
would represent specification 30.
The information in the Orig Address and Orig Position fields is used to identify record. Information in the Orig Address field
is in the format:

AAA.BBB.CC.DD
Where:

AAA = Control network address.


BBB = Control unit address.
CC = Controller address.
DD = Controller ID.
Information in the Orig Position field is in the format:

EE.FFFF.GGG-HHII
Where:

EE = Controller ID.
FFFF= Control logic document number.
GGG = Sheet number.
HH = Y coordinate of the function code from the border.
II = X coordinate of the function code from the border.
The database must be closed before it is exported after changes have been made using the Control Logic Editor. The
database table will not be updated if the database is not closed.

12.1.4 Database Utilities


This tool provides the ability to compact, delete, append, and rename databases.
If a database does not already exist for the user, opening the control logic editor causes one to be created with the name
projectname_username. Because of this behavior, a single project may have multiple databases associated with it which
consumes considerable workstation resources. These database utilities can be used to manage these databases.
A user database can be saved (with its currently extracted and edited data) by renaming it. The next time the xref/text or
function code editors are opened, a database with the correct project name and user name will not be found so one will be
created. To use a saved (renamed) database, delete the projectname_username database from within the database utilities
and rename the saved database in the projectname_username format. It is also possible to append data from the saved
database into the current database.

NOTE: If projects are prelaunched on one or more client computers, these must be shut down to release all connections and allow the Database Utilities to have exclusive access to the project database (and perform the requested
function). To shut down a prelaunched project, select the objects for the project on the History tab of the Prelaunch
Configuration Utility and click Shutdown Selected Object.

12.1.4.1 Append User Database


To update the user database with additional information found in the selected database:

1.

Select Operations > Database Utilities > Append Selected Database to User DB.

2.

Select the data types to append (Function Codes, Cross References and Text, or both) and click OK.

3.

Click OK when prompted with completed append operation data.

12.1.4.2 Compact Selected Database


To compact (reduce in memory size) the selected database:

1.

Select the database.

2.

Select Operations > Database Utilities > Project Database Management > Compact Selected
Database.

3.

Click OK when prompted that the compact operation is complete.

12.1.4.3 Compact User Database


To compact (reduce in memory size) the user database:

12-14

1.

Select the user database.

2.

Select Operations > Database Utilities > Compact User DB.


2VAA000812R0001

12. Composer Power Tools

3.

Miscellaneous Topics

Click OK when prompted that the compact operation is complete.

12.1.4.4 Delete Records and Compact Selected Database


To delete specific records from and compact the selected database:

1.

Select the database.

2.

Select Operations > Database Utilities > Project Database Management > Delete Records and
Compact Selected Database.

3.

Select the types of data to be deleted (Function Codes, Cross References and Text, or both) and
click OK.

4.

Click OK when prompted that the delete and compact operation has completed.

12.1.4.5 Delete Records and Compact User Database


To delete specific records from and compact the selected database:

1.

Select the database.

2.

Select Operations > Database Utilities > Delete Records and Compact User DB.

3.

Select the types of data to be deleted (Function Codes, Cross References and Text, or both). and
click OK.

4.

Click OK when prompted that the delete and compact operation has completed.

12.1.4.6 Deleted Selected Database


To delete the selected database:

1.

Select the database.

2.

Select Operations > Database Utilities > Project Database Management > Delete Selected
Database.

12.1.4.7 Delete User Database


To delete the current user database:

1.

Select the database.

2.

Select Operations > Database Utilities > Delete User DB.

12.1.4.8 Rename Selected Database


To rename a user database

1.

Select the database.

2.

Select Operations > Database Utilities > Project Database Management > Rename Selected
Database.

3.

Enter the new name and press Enter.

NOTE: Renaming the currently active user database causes it to become an external user database. A new active
user database is created the next time the function code or text/xref editor is opened.

12.1.5 Miscellaneous Topics


The expression information entered in various filter and find window fields is detailed in the following topics.

2VAA000812R0001

12-15

Miscellaneous Topics

12. Composer Power Tools

12.1.5.1 Special Search Characters (Filter and Find)


The following table lists the special search characters (standard SQL functionality) that can be used in filter and find window
fields.

Table 12-2 Available Special Search Characters (Filter and Find)


Character

Description

Example

Matches any number of characters. It is


"th*" finds this and that but not
used as the first or last character in a string. path or rather.
"*th*" finds this, that, path, and
rather.

Matches any single character.

"b?ll" finds ball, bell, etc.

[]

Matches any single character within the


brackets.

"b[ea]ll" finds ball and bell but


not bill.

[! ]

Matches any single character not within the "b[!ae]ll" finds bill and bull but
brackets.
not ball or bell.

Matches any one of a range of characters.


the range must be specified in ascending
order (A to E, L to Z, etc.).

"b[a-c]d" finds bad, bbd, and


bcd.

Matches any single numeric character.

"1#3" finds 103, 113, etc.

NOTES:
1. Use these special search characters with string or text data types.
2. When searching for an asterisk, question mark, number sign, opening bracket
or hyphen, enclose it in brackets.
3. When searching for a hyphen and other character simultaneously, the hyphen
must be before or after all the other characters but inside the brackets. However, the
hyphen must be placed after an exclamation point (if being used).
4. Searching for an exclamation point or closing bracket does not require brackets.

12.1.5.2 Special Search Characters (Replace)


The following table lists the special search characters that can be used in replace window fields.

Table 12-3 Available Special Search Characters (Replace)


Character

12-16

Description

Example
"^ape" finds ape within apes but not within
grapes.
"Just[^5-9]" finds Just4 or JustA but not
Just8.

^ (caret)

Marks the beginning of the


string or (when following an
open bracket) excludes the
remaining characters within
the brackets.

Matches the characters when "ick$" finds ick within sick but not within
they are at the end of a string. sickness.

2VAA000812R0001

12. Composer Power Tools

Miscellaneous Topics

Table 12-3 Available Special Search Characters (Replace) (Continued)


Character

2VAA000812R0001

Description

Example

The alternation symbol allows "fe|ty" finds fe and ty within lifestyles.


the expression on either side "[fe|ty]" finds f, e, t, y, and e within lifestyles.
of the line to match the target
string. Placing the same
search string inside
brackets changes the
definition from matching a
string on either side of the |
to matching the characters
on either side of the |.

Matches any character.

".." finds bo and at within boat.


"a..." finds arke within harken but nothing
park.

Matches the characters to the


left of the asterisk zero or
more times. If "a*" is by
itself, one or more a's will be
found but the empty string
(zero a's) will not be found.
If "a*" is used by itself, it
acts like "a+".

"a*" finds aa and a within aardvark but


nothing within lion.
"an*" finds ann and a within cannibal.
"a[bcd]*g" finds abbg, ag, abg, and abcg.
"gh*" finds g and g within doggie.
"(.*)(h*)" finds goat within goat and father
within father.

Matches the character to the "a+" finds aa and a within aardvark.


left of the addition sign one or "an+" finds ann within cannibal.
"a(abc)+" finds aabc and aabcabc but not
more times.
abc.
"gh+" and "(.+)(h+)" finds nothing within
doggie.
"(.+)" finds goat within goat.

Matches the character to the


left of the question mark zero
or more times. If "a?" is by
itself, a will be found but the
empty string (zero a's) will
not be found. If "a?" is by
itself, it acts like "a+".

"a?" finds aa and a within aardvark.


"an?" finds an and a within cannibal.
"gh?" finds g and g within doggie.
"o?g" finds og and g within doggie.
"(.?)(h?)" finds g, o, a, and t within goat.

12-17

Miscellaneous Topics

12. Composer Power Tools

Table 12-3 Available Special Search Characters (Replace) (Continued)


Character
()

Description

Example

Affects the order of pattern


evaluation and serves as a
tagged expression. This
tagged expression can be
used when replacing a
substring with the expression.

If "\0" indicates a tagged expression


representing the entire substring that was
matched and the substring that matched the
regular expression is abcd, a replace
expression of "xyz\0xyz" will change it to
xyzabcdxyz. Other tagged expression can
be represented by "\1", "\2" .. "\9". Although
the tagged expression "\0" is always
defined, tagged expressions 1 through 9 are
only defined if the regular expression used
in the search has enough sets of
parenthesis.
Initial value:
lifestyle
Pattern to replace field value:
"(.*)fe(.*)"
Replace with field value:
"\1\2\2\0"
Updated field value:
listylestylelifestyle
When using the alteration character within a
tagged expression, the last match found
when parsing from the left to right is used.
Initial value:
lifestyles
Pattern to replace field value:
"(.*)(fe|ty)(.*)"
Replace with field value:
"\1addd\3"
Updated field value:
lifesaddle

12-18

[]

Matches any of the enclosed


characters.

"[gd]" finds d, g, and g within doggie.

Matches any of a range of


characters. It must be used
within brackets.

"[a-e]" finds e and a within meat.

2VAA000812R0001

12. Composer Power Tools

Miscellaneous Topics

Table 12-3 Available Special Search Characters (Replace) (Continued)


Character
\

Description

Example

Matches the specific character "\+" finds +, + within #$%++&^.


"\+*\$" finds ++++$ within #%++++$&.
to the right of the backslash.
Currently * and ? must be
enclosed in brackets as
opposed to preceded by a
backslash. For example, [*]
finds *,* within #$%**&^ and
[*]*\+ finds ****+ within
#%****+&.

Initial value:
Mr.
Pattern to replace field value:
"(Mr)(\.)"
Replace with field value:
"\1s\2"
Updated field value:
Mrs.
Initial value:
abc
Pattern to replace field value:
"(a)b(c)"
Replace with field value:
"&-\1-\2"
Updated field value:
abc-a-c
Initial value:
bcd
Pattern to replace field value:
"(alb)c*d"
Replace with field value:
"\0-\1"
Updated field value:
bcd-b
Initial value:
abcde
Pattern to replace field value:
"(.*)c(.*)"
Replace with field value:
"&-\1-\2"
Updated field value:
abcde-ab-de

2VAA000812R0001

(continued)

Initial value:
cde
Pattern to replace field value:
"(ablcd)e"
Replace with field value:
"&-\1"
Updated field value:
cde-cd

12-19

Miscellaneous Topics

12. Composer Power Tools

12.1.5.3 Special Replace Characters


The following table lists the special replace characters that can be used.

Table 12-4 Available Special Replace Characters


Character

Description

Identifies tagged expressions 0 through 9. \0 represents


the entire substring.

&

Represents the entire substring.

12.1.5.4 String Functions


The following table lists the standard Visual Basic string functions that can be used.

Table 12-5 Available String Functions


Name

Dialog Box

Description

double
quotation
marks

Where,
Replace

Allows entering of a text string or special characters (wild


cards)1.

Where,
Replace

Concatenates (links) two strings together.1

IIf

Where,
Replace

Returns one of two parts, depending on the evaluation of


the expression.
Syntax: IIf(expr, truepart, falsepart)

InStr

Where,
Replace

Returns a number specifying the position of the first


occurrence of string2 within string1.
Syntax2: InStr([start, ]string1, string2)

LCase3

Replace

Returns the specified string converted to lower case.


Syntax: LCase(string)

Left

Where,
Replace

Returns a string containing a specified number of


characters from the left side of a string.
Syntax: Left(string, length)

Len

Where,
Replace

Returns a long containing the number of characters in a


string.
Syntax4: Len(string)

LTrim

Where,
Replace

Returns a string containing the specified string without


leading spaces.
Syntax: LTrim(string)

Mid

Where,
Replace

Returns a string containing the specified number of


characters from a string.
Syntax: Mid(string, start[, length])

Right

Where,
Replace

Returns a string containing the specified number of


characters from the right side of a string.
Syntax: Right(string, length)

RTrim

Where,
Replace

Returns a string containing the specified string without


trailing spaces.
Syntax5: RTrim(string)

12-20

2VAA000812R0001

12. Composer Power Tools

Miscellaneous Topics

Table 12-5 Available String Functions (Continued)


Name
Space

Dialog Box
Where,
Replace

Description
Returns a string consisting of the specified number of
spaces.
Syntax: Space(number)

Str
String

Where,
Replace

Returns a string representation of a number.

Where,
Replace

Returns a string containing a repeating character string of


the specified length.

Syntax6: Str(number)

Syntax: String(number, character)


Trim

Where,
Replace

Returns a string containing the specified string without


leading or trailing spaces.
Syntax: Trim(string)

UCase3

Replace

Returns the specified string converted to upper case.


Syntax: UCase(string)

NOTES:
1. When multiple string literals are used in the find criteria, wild cards are only
effective in the first element. For example, "*pa" + "s*" would find Bypas* but not
Bypass.
2. The compare parameter is not supported.
3. Does not apply to the Where because it is not case sensitive. Replace is case
sensitive.
4. Len of a null field value returns null (not zero).
5. Does not effect Access data but will effect SQL Server data.
6. Adds a leading space for the sign if the number is positive.

12.1.5.5 Math Functions


The following table lists the standard Visual Basic math functions that can be used.

Table 12-6 Available Math Functions


Name

Dialog Box

Description

Where,
Replace

Multiply

Where,
Replace

Add

Where,
Replace

Subtract

Where,
Replace

Divide

Abs

Where,
Replace

Returns the absolute value of a number in the same type


format as the number.
Syntax: Abs(number)
number can be any valid numeric expression. If number
contain null, null is returned. If number is an uninitialized
variable, a value of zero is returned.

2VAA000812R0001

12-21

Revision Manager

12. Composer Power Tools

Table 12-6 Available Math Functions (Continued)


Name
Int

Dialog Box
Where,
Replace

Description
Removes the fractional part of a number and returns the
integer portion of the number.
Syntax: Int(number)
number can be a double or any valid numeric expression. If
number contain null, null is returned. If number is an
uninitialized variable, a value of zero is returned. If number is
negative, the first negative integer less than or equal to
number is returned (-8.4 is returned as -9).

Round

Where,
Replace

Returns a number rounded to the specified number of decimal


places.
Syntax: Round(number, numdecimalplaces)

Val

Where,
Replace

Returns the numbers contained in the specified string as a


numeric value of the appropriate type.
Syntax: Val(string)
string can be any valid string expression.

12.2 Revision Manager


This utility provides the ability to create, open, print, and delete revisions of one or more control logic documents. The ability
to edit the working version Revision Comment field, make the working version equal to a selected version, swap control
logic document (or template) borders, filter the listing of control logic documents, and set review status of the control logic
document are also included. It is also possible to easily transfer control logic documents from one project to another.
On the toolbar are two fields that determine which revisions and working versions of control logic documents are displayed.
The left field can be set to All Revs and Working Versions (show all), Most Recent Revisions (show just the latest revision),
or Working Versions (show just the working versions). The right field can be set to Use Initial Context or Use Entire Project.
If one or more revisions (of any type) are selected when the revision manager is opened, only these selected revisions can
be accessed and displayed. This condition is the initial context. Select Use Entire Project to have access to all the revisions
in the project.

NOTE: If control logic documents are unpacked into a project and then either these control logic documents or parts
of the project hierarchy containing them (e.g., controller, control unit etc.) are deleted from the Composer project, a
second unpack of these control logic documents will fail to generate any control logic documents in the project. The
revision manager power tool must be closed and then restarted before these control logic documents can be
unpacked a second time.
NOTE: Using the following special characters in CLD names may cause errors (pack and/or unpack) in the Revision
Manager feature:
/ (forward slash)
\ (back slash)
(double quotes)
* (asterisk)
@ (at sign)
- (hyphen)
| (pipe)
: (colon)
< (less than)
> (greater than)
? (question mark)
The pack actually suggests the operation was successful, however, only the pack file (.EPG file) and the CLDs with
valid characters will be exported. The subsequent unpack will report errors on the missing CLDs.

12.2.1 Create New Revision


To create a new revision of the working version of a control logic document:

12-22

2VAA000812R0001

12. Composer Power Tools

Delete Revision History

1.

Select the working versions of the control logic documents from which new revisions will be
created and select Actions > Create New Revision. The Create New Revision window will
appear.

2.

If desired, enter a comment for the new revision in the Revision Comment field.

3.

If desired, select a designer and/or reviewer from the drop-down lists provided.

4.

If desired, select data for the Data1 and Data2 fields from the drop-down lists provided.

5.

Click OK.

NOTE: If the drop-down lists do not contain the desired names or data choice, click Modify PickList and edit the pick
list to contain the desired name or data.

12.2.2 Delete Revision History


To delete all previous versions of a control logic document and make the working version the only version (Revision A),
select any or all versions of the control logic document and select Actions > Re-initialize Revision History.
All information in the Revision, Designer, Data1, and Data2 fields is also deleted.

12.2.3 Delete Revisions


To delete control logic document revisions:

1.

Select the revisions to be deleted and select Actions > Delete Revision.

2.

Click Yes when questioned if the delete operation should continue.

NOTE: The deleted revisions will no longer be shown on borders or in Composer windows. However, revision letter
designators from deleted revisions can not be used again. For example, the working version of a control logic document can not be made equal to a revision that has been deleted. Also, there is no way to delete all the revisions and
then reset all working versions to revision letter A.

12.2.4 Edit Pick List


The pick list allows the specification of an alphanumeric string and the pull-down lists it will appear in. These strings can be
names, data, text, etc. While only the Designer and Reviewer fields are used in the provided standard borders, the Data1
and Data2 fields can be used in custom borders.
To open the pick list, select Actions > Edit Pick List.
To add a name to the pick list:

1.

Click Add and enter the name or text in the Name field.

2.

If desired, enter a description. This field is only used in window.

3.

Select the fields that will be able to use this name (available in the pull-down list).

To delete a name from the pick list, select the line containing the name and click Delete.
To exit the PickList Edit window, click Close.

12.2.5 Edit Working Version Comment


To edit the Revision Comment field of the working version of a control logic document:

1.

Select the working version of a control logic document and select Actions > Edit Working
Version Comment.

2.

Edit the current comment or enter a new comment in the working version comment window and click
OK.

12.2.6 Filter Revision Listing


To filter the displayed list of revisions:

1.

Select View > Filter Criteria. The Modify View to Match The Following Criteria window
appears.

2.

Select the revision data and/or information that must be found in order for a revision to be displayed.

NOTE: Designer ID, requested reviewer, data1 field, and data2 field pull-down lists are created from pick list information.
2VAA000812R0001

12-23

Make Working Version Equal to Selected Revision

12. Composer Power Tools

12.2.7 Make Working Version Equal to Selected Revision


To make the working versions the same as the selected revisions, select the revisions that will overwrite their corresponding
working version (making the working version equal to the selected revision) and select Actions > Make Current.

12.2.8 Print Revisions


To print all the control logic document revisions currently being displayed:

1.

Select File > Print All.

2.

Enable or disable the auto orientation option in the Print window. When enabled, revisions utilizing a
horizontal border are printed using landscape orientation and revisions utilizing a vertical border are
printed using a portrait orientation.

3.

Select the sheets to be printed (All, Range, or None (Cross-Reference Report Only)). The default To
field value is 99 when multiple CLDs are being printed. If this field is set to a value greater than the
number of sheets in a CLD being printed, all the sheets will be printed.

4.

Select to export the cross-reference report to a text file, print it along with the CLDs, both, or do
nothing with report.

5.

If necessary, click View to read the report.

6.

Select the desired print quality and number of copies of each CLD.

7.

Enable or disable the print to file option as required.

8.

Click Setup to open the standard Windows print setup dialog box. Configure the options as
necessary.

9.

Click Style to configure how the revisions are to be printed.

10. On the entries tab of the style setup window, select the specifications, tags, symbols, and crossreferences to be printed.
11. On the layers tab, set the layers to be printed.
12. On the layout tab, set the margins, alignment, and scale of the control logic document.
13. On the header/footer tab, configure the header and footer using the codes provided.
14. Click OK.
15. Click OK.
To print the selected control logic document revisions:

1.

Select File > Print.

2.

Enable or disable the auto orientation option in the Print window. When enabled, revisions utilizing a
horizontal border are printed using landscape orientation and revisions utilizing a vertical border are
printed using a portrait orientation.

3.

Select to export the cross-reference report to a text file, print it along with the CLDs, both, or do
nothing with report.

4.

If necessary, click View to read the report.

5.

Select the desired print quality and number of copies of each revision.

6.

Enable or disable the print to file option as required.

7.

Click Setup and configure the options as necessary.

8.

Click Style to configure how the revisions are to be printed.

9.

On the entries tab of the style setup window, select the specifications, tags, symbols, and crossreferences to be printed.

10. On the layers tab, set the layers to be printed.


11. On the layout tab, set the margins, alignment, and scale of the control logic document.
12. On the header/footer tab, configure the header and footer using the codes provided.
13. Click OK.
14. Click OK.
12-24

2VAA000812R0001

12. Composer Power Tools

Select/Deselect Revisions

12.2.9 Select/Deselect Revisions


To select or deselect one or more control logic document revisions, use standard Windows single and multiple selection
functionalities.
To select or deselect all the control logic document revisions currently being displayed, select Edit > Select All or Edit >
Deselect All.
To select all the control logic document revisions that are currently not selected and deselect all those that are currently
selected, select Edit > Invert Selections.

12.2.10Set Review Status


When creating new revisions of control logic documents from working versions, the creator of the revisions (the designer)
can request that it be reviewed by a person whose name is configured in the pick list. This reviewer can approve or reject
these revisions and add a review comment using the following procedure.

12.2.10.1 Procedure
To specify an approval or rejection review status for revisions:

1.

Select the revisions whose review status is to be set and select Actions > Set Review
Status. The Set Reviewer Information window appears.

2.

Select CLDs OK (to approve) or CLDs Not OK (to reject) the revision.

3.

Select the reviewer from the list provided.

4.

If desired, enter a review comment in the reviewer comment field.

5.

Click OK.

6.

If the reviewer selected in Step 4 is not the reviewer specified by the revision designer, a message
stating this discrepancy is displayed. Click OK to acknowledge this condition and continue. Click
Cancel to abort this procedure.

12.2.10.2 Handling Revisions and Working Versions


Revisions are read-only and can not be corrected if they are rejected. A new revision containing the required changes must
be created.
If the rejected revision is equal to the working version (no changes have been made since the revision was circulated for
review), make the required changes to the working version and make a new revision of it. Circulate this revision for the next
review cycle.
If changes have been made to the working version since the revision was circulated for review but they do not need to be
saved, make the working version equal to the revision and proceed as described in the previous paragraph.
If changes have been made to the working version since the revision was circulated for review and these changes must be
saved for future use, consider the following example:
The working version of a control logic document is D but revision C was circulated for approval. The working version
contains some new logic (added after the revision was circulated) that must be kept for future use. Revision C was rejected
and must be corrected. The corrected revision must be circulated for approval.
To correct and recirculate the appropriate revision:

1.

Make a revision of the working version (D). The working version will now be E and the
revision will be D.

2.

Make the working version (E) equal to the rejected revision (C).

3.

Make the required changes to the working version (E, which is equal to C).

4.

Make a revision of the working version (E). The working version will now be F and the revision will be
E.

5.

Circulate the revision E for approval.

6.

Make the working version (F) equal to revision D. The working version is now in the same condition it
was before starting this procedure.

7.

Delete revision D (temporary storage location of the future use logic).

12.2.11Swap Control Logic Document Borders


To change the borders being used in one or more control logic document working versions:

1.
2VAA000812R0001

Select the working versions whose borders are to be changed and select Actions > Swap
CLD Borders. The Swap Borders window appears.
12-25

Swap Control Logic Template Borders

12. Composer Power Tools

2.

Select a border that is to be changed from the borders found column.

3.

Select the replacement border column heading.

4.

Select the border that will be used in place of the existing border from the pull-down menu.

5.

If desired, offset the new border using the x offset and y offset fields. Offsets are based on the origin
of the current border.

6.

Repeat Steps 2 through 5 for each border being changed.

7.

Click OK.

12.2.12Swap Control Logic Template Borders


The borders used by the control logic templates in the project can be changed using this function. Usage of the template
linking features of Composer will determine when and if this change is propagated to the control logic documents created
from this template.
To change the borders used by templates in the current project:

1.

Select Actions > Swap Template Borders. The Swap Borders window appears.

2.

Select a border that is to be changed from the borders found column.

3.

Select the replacement border column heading.

4.

Select the border that will be used in place of the existing border from the pull-down menu.

5.

If desired, offset the new border using the x offset and y offset fields. Offsets are based on the origin
of the current border.

6.

Repeat Steps 2 through 5 for each border being changed.

7.

Click OK.

12.2.13Transfer Revisions Between Projects


It is possible to transfer control logic document revisions between projects using the pack and unpack features.
The pack feature copies the selected revisions to a specified directory. A revision is made of any selected working version
(if the Automatically Create a New Revision for Each Working Version Being Packed option is enabled) and it is copied to
the specified directory. During the copy operation, the revision names are appended with the following information.

_r_text.cld
Where:

r = Revision level of the revision or working copy.


text = Unique identifier created by the Composer software.
The unpack feature copies the selected revisions into the destination project. If the project contains no revision or working
version of the control logic document, a revision and a working revision (both the same) are created. If the project contains
the control logic document and at least one revision, the unpacked revision replaces the current working version. If multiple
revisions of a control logic document are being unpacked at the same time, all but the most recent revision will be added as
consecutive revisions. The most recent revision will replace the current working version. Enabling the Store Revision of
Current Working Version Before Unpacking option allows the working version to be saved as a revision before the
unpacking operation starts.
Any control logic template linking features utilized by packed revisions will be fully functional in the destination project if it
contains the appropriate copy of the template.
To pack selected revisions and save them outside the project:

1.

Select the revisions and working versions that are being transferred from this project
(source) to another project (destination) and select Actions > Pack Revisions.

2.

Enable or disable the Automatically Create a New Revision for Each Working Version Being Packed
option as appropriate and click OK.

3.

Select a name and location for the pack & go context file (.epg file extension) and click Open. The
directory containing this file is considered the output directory.

To unpack revisions into a project:

12-26

1.

Open the destination project.

2.

Open the revision manager and select Actions > Unpack Revisions.

2VAA000812R0001

12. Composer Power Tools

View Revisions

3.

Select the pack & go context file (.epg file extension) associated with the revisions to be unpacked
and click Open.

4.

Select the revisions to be unpacked in the Select Files to Unpack window.

5.

Enable or disable the Store Revision of Current Working Revision Before Unpacking option as
appropriate and click Unpack.

NOTE: The revision is unpacked into the same location in the destination project. The same project tree structure
that contained the revision or working version in the source project is created in the destination project if it does not
already exist.
NOTE: If the progress indicator of a pack or unpack operation fails to indicate that CLDs are being processed:
1. Terminate the Revision Manager process using the Windows Task Manager.
2. Shut down Composer.
3. Restart the workstation (recommended).
4. Retry the pack or unpack operation.

12.2.14View Revisions
To open or view the selected control logic document revisions, select File > View/Open Selected Documents.
The control logic documents will be displayed in the automation architect window.

12.3 Automatic Drawing Generator


This utility provides the ability to automatically create control logic documents from standardized user-developed control
logic templates and information from an external database. Using functions provided by this utility and template linking, a
single control logic template can be used to create multiple control logic documents with multiple control logic variations.
Control logic documents can be updated to reflect changes made to the control logic template used to create it. Customized
tags, cross-reference, and specification data can be automatically set and updated from an external database. Visual Basic
Scripting Edition (VBScript) and Visual FoxPro syntax procedures can be used to manipulate data.

12.3.1 Create Control Logic Documents


The following information should be available before starting the creation of control logic documents.

A customer database containing the specifications of the control system.

Standardized control logic templates (templates for each type of control logic) contained in a Composer project.
Refer to Attribute Values Syntax for information about the attributes that are placed on the control logic template
layers.

Procedures that control how database information is transferred to the control logic documents.

Knowledge of the organization of the actual control system (control networks, control units, controllers, etc.).

Knowledge of the current (or proposed) control logic. This will enable the selection of the correct control logic
template.

To create a control logic document from a database, control logic template, and procedures:

1.

Create a new Composer project to contain the created template.

2.

Configure the system architecture (of the new project) to match the organization of the actual control
system.

3.

Copy (drag and drop) the standardized control logic templates into the appropriate exchange folder in
the new project.

4.

Create a new generation context file. Refer to Generation Context File for more information.

5.

It is recommended that the template instantiation powertool (TIP) utility be activated and used. Refer
to Template Instantiation Power Tool for more information.

6.

Drag and drop the proper control logic template from the exchange to the appropriate controller.

7.

Process the control logic document by supplying the appropriate information in the control logic
processing window. Refer to Template Instantiation Power Tool for more information.

NOTE: If the template instantiation powertool utility was not activated, manually process the control logic document.
Refer to Manual CLD Processing for more information.
2VAA000812R0001

12-27

Create Control Logic Documents

8.

12. Composer Power Tools

Repeat Step 6 and Step 7 for each control logic document being created.

12.3.1.1 Attribute Values Syntax


Attribute values required by the automatic drawing generator are placed on control logic template layers.
The basic format for these attribute values is:

point_name^expression^language; point_name^expression^language; ...


Each attribute value may contain multiple instructions (separated by semicolons):

point_name. This identifies a record (point) in the database. The expression will use data from this record. If point_name is not used
and a ^ is used (^ProcedureX for example), the first valid record associated with the control logic document will be made the
current record. The expression will use data from this record. If point_name and a ^ are used (ProcedureX for example), no
resetting of the current record will occur. The expression will use data from the current record.

NOTE: The first valid record associated with the control logic document, will be made the current record when a new
entity (function code, text object, etc.) is encountered.
In multiple instruction attribute values, omitting point_name will cause the expression to use data from record specified in
the previous instruction. Consider the following instruction:

Point51^ProcedureA( ); ProcedureB( ); Point_102^ProcedureC; ^ProcedureD;


Point51^Fieldabc;
The record cursor would be at:

Point51 for ProcedureA, ProcedureB, and Fieldabc.


Point_102 for ProcedureC.
The first valid record for ProcedureD.
expression. This specifies a procedure, function, or expression that will be evaluated. The evaluated (return) value of the expression
is a long, integer, string, or nothing (Pt-Advanced attribute), depending on the Attribute Type. The evaluated value is used
by the automatic drawing generator to perform the appropriate action associated with the attribute type (except for PtAdvanced).

language. This specifies the language used to create the expression (Visual FoxPro or VBScript). Use VFP for Visual Foxpro and VB
for VBScript.

If a language is not specified and the first word in the expression is an existing procedure, the expression will be
evaluated in the language used to write the procedure. Consider the following example instruction:
Pointabc^CreateTagName ( ) + "AB"
CreateTagName ( ) + "AB" is the expression and CreateTagName is the first word in the expression. The
CreateTagName procedure (found in one of the listed procedure files) was written using Visual FoxPro. Therefore,
Visual FoxPro will be used when evaluating the CreateTagName ( ) + "AB" expression.

If a language is not specified and the procedure (listed first in the expression) is not found in one of the files listed in
the procedure stack, VBScript will be used when evaluating the expression. Consider the following example
instruction:
Pointabc^CreateTagName ( ) + "AB"
CreateTagName ( ) + "AB" is the expression and CreateTagName is the first word in the expression. The
CreateTagName procedure is not found in any of the listed procedure files. VBScript will be used when evaluating
the CreateTagName ( ) + "AB" expression.

If a language is not specified and the procedure is not listed first in the expression, VBScript will be used when
evaluating the expression. Consider the following example instruction:
Pointabc^"AB" + CreateTagName ( )
"AB" + CreateTagName ( ) is the expression. The CreateTagName procedure (found in one of the listed procedure
files) was written using Visual FoxPro. VBScript will be used when evaluating the "AB" + CreateTagName ( )
expression.

12.3.1.2 Generation Context File


To create a new generation context file:
12-28

2VAA000812R0001

12. Composer Power Tools

Create Control Logic Documents

1.

Select Tools > ADG [Automatic Drawing Generator] in the Composer window.

2.

Select File > New.

3.

Answer Yes if prompted that the current project should be closed.

4.

Enter a name for the generation context.

5.

Select the name of the database containing the data.

6.

Select the name of the table or query (view) containing the data.

7.

Enable or disable the Use Option Fields option. Refer to Layer Options for more information.

NOTE: The Use Option Fields option must be enabled in order to manipulate control logic document layers. All control logic template layers will be created in the control logic document if this option is disabled.
8.

Click OK.

9.

Expand the generation context name in the GC properties subwindow.

10. Double click Address Field Mappings.


11. Click the add a new address mapping set button.
12. In each column select an existing database field whose data matches the column name.
NOTES:
1. A new field can be created by entering the name of the new field in the column and supplying the field type information if requested.
2. A new field can not be created if a query was selected in Step 6.
3. A database field must be specified in the Layer Options column of a point in order to use the Use Option Fields
option later. If the field specified does not currently exist, it will be created. Refer to Layer Options for more information.
13. Click OK.
14. If procedures (scripts that control how database information is presented on the control logic
document) are to be used, proceed to the next step. If no procedures are needed, proceed to Step
23.
15. Double click Procedure Stack.
16. Click the add a procedure file entry button.
17. Use the browse button in the FileName field to specify the Visual Basic or Visual FoxPro file
containing the procedure.
18. Repeat Steps 16 and 17 until all the necessary procedure files have been added.
19. If the same procedure exists in more than one procedure file, use the priority buttons to move the
procedure file containing the procedure that should be used to a lower order number (higher priority)
than the other procedure file containing the same procedure.
20. Click OK.
21. Edit the procedures if necessary. To access a procedure:

Double click the name of the procedure file containing the procedure (listed under procedure stack).

- or

Select the Function View tab of the GC properties subwindow and double click the procedure name.

22. Double click Generic Field Mappings.

This window allows fields used in procedures that are part of this generation context to be
mapped to fields existing in the database. Field names used in procedures must be
declared in special comments in the following format if they are to be displayed in this
window.
*<<FIELDS: name>>
- or 2VAA000812R0001

12-29

Create Control Logic Documents

12. Composer Power Tools

*<<FIELDS: building >>


- or *<<FIELDS: name building>>
Fields not declared may also be added manually to the Mapped Field Name field. Do not
use database or language keywords as field names. It is possible to add new field names to
the Actual Field Name field and the database only if a database table (not query) is used by
the generation context. This is done by typing the name of the field in the Actual Field Name
column.
23. Select an actual field name for each mapped field name listed in the upper portion of the window.
Mapped field names that exactly match existing fields are displayed in the drop down list at the
bottom of the window.
24. Click OK.
25. Save the generation context.

12.3.1.3 Template Instantiation Power Tool


The template instantiation powertool (TIP) utility provides a wizard that assists in making database assignments during the
creation of control logic documents from control logic templates. This utility is installed in a de-activated state on each
workstation. Control logic documents are created in the normal Composer manner when the TIP utility is de-activated.
Control logic documents are created and processed using the TIP wizard when the TIP utility is activated. Activation and
de-activation of the TIP utility affects only this workstation.
To activate (or de-activate) the template instantiation powertool utility:

1.

Select Tools > ADG [Automatic Drawing Generator] in the Composer window.

2.

Select File > Activate Template Instantiation Powertool (or De-Activate Template Instantiation
Powertool).

3.

Click OK when prompted that the utility was successfully activated.

To use the template instantiation powertool utility wizard to process a control logic document:

1.

Enter a name for the control logic document to be created (or accept the default name) and
click Next.

2.

Enable the layers that are to be part of the newly created control logic document and click Next. All
the layer options defined in the control logic template are displayed in this window. Refer to Layer
Options for more information.

3.

Assign points used in the attributes in the control logic template to fields in the database by dragging
and dropping the points from the list of points column to the appropriate point fields. Refer to Point
Associations for more information.

NOTE: It is also possible to assign a point by typing the point name in the appropriate point field.
4.

Click Next.

5.

Assign values to all the prompt fields specified in the procedures that are used by the ADG utility to
generate and process the control logic document. Refer to Prompt Fields for more information.

NOTE: To set the prompt field values to the same values used by the last control logic document produced from this
control logic template during this ADG session, click Apply Last Settings.
6.

Click NextCLD and repeat Steps 1 through 7 to create another control logic document from the same
control logic template (if desired).

7.

Click Next.

8.

Select the automatic drawing generator attributes that are to be processed and click Finish.

12.3.1.4 Manual CLD Processing


To process a control logic document after it has been created (not using the wizard) or after it has been changed:

12-30

1.

Select the control logic document in the Composer window.

2.

Select Tools > ADG Process Control Logics.


2VAA000812R0001

12. Composer Power Tools

3.

Event Handling Procedures

Enable the Process Attributes in Existing Control Logics Only, Regenerate Existing Control Logics, or
Remove Unwanted Layers Only option.

The Process Attributes in Existing Control Logics Only option processes the selected
control logic document and removes any unwanted layers (based on layer option settings)
but does not incorporate any changes made to the control logic template. The Regenerate
Existing Control Logics option deletes the selected control logic document, regenerates it
from the control logic template, removes any unwanted layers (based on layer option
settings), and processes the control logic attributes found. The Remove Unwanted Layers
Only option removes any unwanted layers (based on layer option settings) and does not
process control logic attributes.
4.

Click Next or Finish (if the Remove Unwanted Layers Only option was enabled).

5.

Enable the automatic drawing generator attributes that are to be processed and click Finish.

12.3.2 Event Handling Procedures


The automatic drawing generator supports the following event handler procedure names. Any procedure can be given one
of these names. By giving a procedure one of these names, the time it will start executing is controlled by the event handler.

12.3.2.1 Init_Generation ( )
This procedure is executed at the start of the generation or update processes. The first record in the recordset will be the
current record. Using sorts or filters on the recordset may change which record is listed first in the recordset. Therefore, the
actual record which will be the current record may not always be the same.
These procedures are very useful in setting up and cleaning up flags and variables used in the creation of control logic
documents.

12.3.2.2 End_Generation ( )
This procedure is executed after the entire generation or update process has completed.

12.3.2.3 Init_ControlLogicTemplate ( )
This procedure is executed at the start of the generation or update processes. The first record that contains the template
name will become the current record.

12.3.2.4 End_ControlLogicTemplate ( )
This procedure is executed after all control logic documents have been processed.

12.3.2.5 Init_ControlLogic ( )
This procedure is executed once for each control logic document before its attributes are processed.

12.3.2.6 End_ControlLogic ( )
This procedure is executed once for each control logic document after all of its attributes have been processed.

12.3.3 Modify Database Assignments of a CLD


To modify addresses, layer options, and prompt database field values associated with a control logic document:

1.

Select the control logic document in the Composer window.

2.

Select Tools > ADG-Modify Assignments (Based on Control Logic) or Tools > ADG-Modify
Assignments (Based on Template). Refer to Modify Assignment Options for more information.

3.

If necessary, edit the control logic document name.

4.

Select the layer options icon to access the layer options enabled for the control logic document.
Refer to Layer Options for more information.

5.

Select the point associations icon to access information about how the points have been assigned.
Refer to Point Associations.

6.

Select the field associations icon to access information about prompt field values. Refer to Prompt
Fields.

7.

Click OK when editing is complete.

2VAA000812R0001

12-31

Miscellaneous Topics

12. Composer Power Tools

12.3.4 Miscellaneous Topics


The following topics provide detailed information about various field selections, concepts, and suggested values:

AI Object Properties, Methods, and Common Usage.

Attribute Type.

Layer Options.

Macros.

Modify Assignment Options.

Point Associations.

Prompt Fields.

Using Suggested Values.

12.3.4.1 AI Object Properties, Methods, and Common Usage


The properties and methods of Automation Interface objects are described in the following topics. Common use examples
are also provided.

Attrib.

This property provides the attribute as a string and can be useful when printing to the output window.

AI.Trace "Failed to find valid value while processing " & AI.Attrib
ConstantBlock, FunctionCode, GraphicEntity, Iref, Oref, SignalLine, and HostEntity. These properties apply directly to
the automation interface objects and are typically used for advanced functionality.

ControlLogic. This property provides access to data associated with the control logic document. Examples include the setting of
unique cross-references (based on control logic document name).

PT-XrefDesc 0 AI.ControlLogic.Name + "Interlock"


DBField. This property writes values back to the database.
EBAttribute. This property provides the automation interface object corresponding to the attributes being processed. The type of
attribute being processed, the entire value of the attribute, the occurrence number of the attribute (in the case of a multiple
instruction attribute), etc. are configurable.

FCData.

This property provides access to data associated with a function code and can be useful when setting block numbers.

AI.FCData.SetBlockNumber Block_Num, 1
This property is typically used for advanced functionality because specification and cross-reference descriptors are more
easily set using the PT-XrefDesc, PT-Specs, and PT-AllSpecs attributes.

FieldExists. This property returns a true condition if the specified field exists in the database.
GetEUIdx. This property retrieves the index of the specified EUDesc text string.
IrefData, and OrefData. These properties are typically used for advanced functionality because specification and cross-reference
descriptors are more easily set using the PT-XrefDesc, PT-Specs, and PT-AllSpecs attributes.

IsFieldNull. This property returns a true condition if the specified field is null.
LowerSpecLimit. This property is used in PT-ADVANCED attributes to determine the index of the lowest value specification that can
be set.

LSD.

This property sets the values of logic state descriptors.

AI.LSD ("SelectedState") = LSD


Setting the values of logic states using this property only updates the tag database when it is done within the context of a
PT-LSD attribute.

Point.

This property provides the point as a string and can be useful when printing to the output window.

AI.Trace "Value field was blank for point " & AI.Point
The property can also be used to move the current record position in the database to another point associated with the
same control logic document.

AI.Point = "AI07"
12-32

2VAA000812R0001

12. Composer Power Tools

Miscellaneous Topics

PointFound. This property returns a true condition if the expression is executing after the point specified in the attribute has been
positioned in the database.

ReDimSpecArray and SetError. These methods should not be used.


Sheet.

This property provides access to data associated with the sheet and can be useful when setting sheet names.

AI.Sheet.Name = sName
SpecArray. This property sets multiple specifications for a function code in a single procedure.

AI.SpecArray (SpecNumber) = Value


Setting the values of specifications using this property only updates the control logic document when it is done within the
context of a PT-AllSpecs attribute.

Tag.

This property provides access to data associated with a tag. AI.Tag is equivalent to AI.EBFCData.Tag. Tag data can be set
by using

AI.Tag.AtomValueByName ("AtomName") = Value


Tag whose data has been set must be updated (to write changes to the tag database) by using

AI.Tag.Update
UpperSpecLimit. This property is used in PT-ADVANCED attributes to determine the index of the highest value specification that can
be set.

Common Usage Examples. A listing of useful Automation Interface properties and methods follows.
Write messages to the output window:

AI.Trace "MessageString" & value/field


AI.Trace ( ) {parentheses required by VFP language}
Get the index value for an engineering unit descriptor:

AI.AllSpec (2) = AI.GetEUIdx ("DEG C")


Determine if the point being used in this procedure has been assigned:

If AI.PointFound Then
Determine if the database field currently exists:

If AI.FieldExists ("FieldName")
Determine if the field has a value:

If AI.IsFieldNull (FieldName) Then {this syntax applies VB and VFP languages}


If IsNull (FieldName) Then {this syntax applies to VB language only}
Set the database record to the one associated with a specific point:
This method could be used in a PT-AllSpecs function where some of the specs come from different points such as function
code 149.

AI.Point = "AO01"
AI.SpecArray (18) = Zero
AI.SpecArray (19) = Span
AI.Point = "AO02"
AI.SpecArray (18) = Zero
AI.SpecArray (19) = Span
etc.
Write a value to a database field from within a procedure:

AI.DBField ("fieldname") = new_value

2VAA000812R0001

12-33

Miscellaneous Topics

12. Composer Power Tools

12.3.4.2 Attribute Type


The following table lists the available attribute types.

Table 12-7 Attribute Types

Attribute
Type
PT-SPEC

Applies
To
All
function
codes

Data Type
of
Evaluated
Instruction
Variant
Integer
(1 to 64)

Description of Action

The specification whose index is the second


value returned will be set using the first return
value. The first return value is set to variant to
accommodate specifications of various data
types including string specifications. The second
return value must range from 1 to 64.
Example 1:
POINT1^SpecVal ( ); POINT1^SpecNum ( )
The specification whose index is returned by
POINT1^SpecNum ( ) will be set to the value
returned by POINT1^SpecVal ( ).

PT-SPEC
(continued)

PTALLSPECS

All
function
codes

Variant

Example 2:

Integer
(1 to 64)

POINT1^SpecVal ( ); 1

All
function
codes

None

The index in the variant array will be used as the


specification index. The specification will be set
using the value at that index in the variant array.
Only value specifications can be set in this
manner. If the variant array has values (except
empty) that correspond to specifications that do
not exist for the function code or are address
specifications for the function code, the values
will be treated as if they do not exist. The size of
the array passed into the procedure will
correspond to the highest value specification
index of the associated function code.

(A supplied
array of 64
variants is
available
within any
expression
used in this
attribute.)

Specification 1 will be set to the value returned


by POINT1^SpecVal ( ).

Example:
The following attribute may be placed on a
function code 30 or 68 to set the zero and span
specifications.
POINT1^MyAllSpecSub ( )
The MyAllSpecSub ( ) is:
Sub MyAllSpecSub ( )
if AI.FCData.FCNumber = 30 then
AI.SpecArray (3) = ZeroValField
AI.SpecArray (4) = SpanValField
else AI.FCData.FCNumber = 68 then
AI.SpecArray (3) = ZeroValField
AI.SpecArray (2) = SpanValField
End Sub
Refer to AI Object Properties, Methods, and
Common Usage.

12-34

2VAA000812R0001

12. Composer Power Tools

Miscellaneous Topics

Table 12-7 Attribute Types (Continued)

Attribute
Type
PT-LSD

Applies
To
Exception
reporting
function
codes

Data Type
of
Evaluated
Instruction
None)
(The
supplied
object
contains
properties
correspondi
ng to logic
states the
host
function
code could
have.)

Description of Action

The particular property of this object that


corresponds to that logic state will be set to the
value in that property. This object may be used
by referencing the properties directly or by using
published string keys in the object that will refer
to the particular logic state. The name of the
object visible in the script will be LSD. A
particular LSD may be set in any one of the
following ways.
AI.LSD_ZeroState = "NORMAL"
AI.LSD_ZeroState = 22
AI.LSD("ZeroState") = "NORMAL"
AI.LSD("ZeroState") = 22
If an integer (0 to 255) is used, then the logic
state descriptors list will be searched and (if a
descriptor was found in the list with an index
equal to the integer) that descriptor would be
applied.
If a string (0 to 6 characters) is used, then the
logic state descriptors list would be searched for
the same string. If found, the string would be
applied. Leading and trailing spaces found in
either location will be ignored. "NORMAL" and "
NORMAL " are considered the same value.
Refer to AI Object Properties, Methods, and
Common Usage.

PTADVANCED

All entities None

This function provides advanced functionality.


This attribute is not intended to return any value.
Manipulation of the current control logic
document or current entity using the automation
interface is provided by this function.
Procedures used by this attribute are expected
to use one or more of the following objects or
variables.
ControlLogicDocument
Sheet
One of the following (FunctionCode,
IOFunctionCode,
Iref, Oref, Text, or Signal)
One of the following (FCData, IrefData, or
OrefData)
Point Name
Entire attribute value
Recordset for the current point
All fields in the recordset as individual objects
These objects and variables are available to
other procedures also.
Example
PointAbc^AnAdvancedSub ( )

2VAA000812R0001

12-35

Miscellaneous Topics

12. Composer Power Tools

Table 12-7 Attribute Types (Continued)

Attribute
Type
PT-MACRO

Applies
To

Data Type
of
Evaluated
Instruction

All entities String

Description of Action

This string will be used to locate a macro within


the project exchange. When this macro is found,
it is placed at the drop location (on the control
logic document) specified by the third or fourth
instruction within the expression. All points in
the macro using the name POINT will be
replaced by the point used in the first instruction.
Macros can drop other macros but not any of
the macros used to create it.
Example:
Macro1 can contain a directive attribute to drop
Macro2. Macro2 can contain a directive attribute
to drop Macro3. Macro3 can contain a directive
attribute to drop Macro4 but not Macro1,
Macro2, or Macro3.

Long

All the block addresses of the entities within the


macro will be offset (by the same amount) such
that the lowest block number will be set to this
value.

Integer
(output)

The location of the macro will be offset to the


zero-based output of the function code. If this
attribute is part of an Iref or Oref, the return
value is ignored. If this value is 0, the macro will
be attached to output N. If this value is 1, the
macro will be attached to output N+1 (and so
on). If this value is equal to -1 or is not entered,
this value is ignored.

Integer
(spec
number)

The location of the macro will be offset to the


number of the returned address specification. If
this value is part of an Iref or Oref, the return
value is ignored. If the previous integer value is
present and the value is greater than -1, this
value is ignored.
If both returned integer values are invalid, not
specified, or a value specification, the drop
location of the macro will be offset to the end of
the first function code output. Refer to Macros
for more information.
Using macro attributes on a text entity will result
in the macro being placed at the location of the
text entity.

PT-TAGNAME Exception String


reporting
function
codes

12-36

An existing tag whose name is the return value


will be set as the tag for the function code. If
such a tag does not exist, a new tag is added to
the project tag database. The type of this tag is
determined by the host function code. This
attribute is processed before any other attribute.

2VAA000812R0001

12. Composer Power Tools

Miscellaneous Topics

Table 12-7 Attribute Types (Continued)

Attribute
Type

Applies
To

Data Type
of
Evaluated
Instruction

PT-TAGDESC Exception String


reporting
(if attribute
contains one function
codes
instruction)

Description of Action

The tag description of the tag associated with


the function code will be changed to the value
returned.
Example
POINT1^MyTagDescSub ( )

PT-TAGDESC Exception String


reporting
(if attribute
contains two function
codes
instructions)

The first part of the description (TagDesc1) of


the tag associated with the function code will be
changed to the value returned by the first
instruction. The second part of the description
(TagDesc2) of the tag associated with the
function code will be changed to the value
returned the second instruction.
Example
PNT1^TagDesc1Func ( ); PNT1^TagDesc2Func
()
The evaluated value of the previous function
must return less than 16 characters.

PT-TEXT

Text
entities

String

PTXREFDESC

String
Cross
reference Integer
s and I/O (0 to 7)
function
codes

The text of the text entity will be set to the


evaluated value of the expression.
The string returned from evaluating the first
instruction will be used as the cross-reference
description. The integer returned by evaluating
the second instruction (if present) will be used
as the zero-based index of the cross-reference
description.
Example 1:
PointX^CrossRefFunction ( )
This sets the cross-reference description of the
entity it is placed on to the value returned by the
CrossRefFunction ( ) function.
Example 2:
PointX^AnotherXRefFunction ( ); 5
This sets the sixth cross-reference description of
the entity it is placed on to the value returned by
the AnotherXRefFunction ( ) function.

12.3.4.3 Layer Options


Control logic templates (and control logic documents) can be configured with up to 16 layers. Typically, control logic not
required in all control logic documents created from this control logic template is placed on layers two through 16. These
layers (two through 16) can be individually included or excluded from the control logic document created from the control
logic template if the Use Option Fields option is enabled and the layers contain layer option syntax. Layer option syntax
consists of option groups and options.
Layers not containing layer option syntax (assuming the Use Option Fields option is enabled) will not be seen by the TIP
wizard but will be part of the created control logic document.

Option Groups. Option groups are groupings of one or more options, each located on a different layer. For example, the following
items are placed on layers two, four, and six.

2VAA000812R0001

[OptionGrp Group_Name] Text Description of Option 1 (placed on layer two).

12-37

Miscellaneous Topics

12. Composer Power Tools

[OptionGrp Group_Name Default] Text Description of Option 2 (placed on layer four).

[OptionGrp Group_Name] Text Description of Option 3 (placed on layer six).

During the creation of a control logic document from this control logic template (using the TIP wizard and enabling the Use
Option Fields option), the following selection will be displayed in the layers options window.

Options. Individual options can be placed on a layer using the following format.

[Option] Text Description of Option 4 (placed on layer eight)

[Option Default On] Text Description of Option 5 (placed on layer 10)

The following selections will be displayed in the layers option window.

Database Layer Options Data. The database used by the generation context to create a control logic document may or may not
contain layer information. Layers two through 16 can be individually included or excluded from the control logic document
using the information in the layer information field contained in the database if the Use Option Fields option is enabled.
Layer information consists of a 15 character string of - (dashes) and D (capital letter D) that correspond to layers two
through 16. Dashes indicate inclusion while Ds indicate exclusion.

NOTE: When processing control logic documents, it is important to remember that layers that are not part of the
existing control logic document can not be included. All combinations dashes and Ds are possible when creating and
regenerating control logic documents.
If layer information is contained in the database, the Use Option Fields option is enabled, but no layer option syntax exists in
the control logic template:

Single point control logic templates will use the value in the layer information field corresponding to that point to
create the appropriate layers in the control logic document.

Multiple point control logic templates will determine which control logic document layers to create by resolving the
layer information from all the points as shown in the following example:

(Point A layer information field data) = ---D-DDD-DD--(Point B layer information field data) = -----DDD--D-DD
(Internal resultant value) = -----DDD--D--The internal resultant value is used but not displayed or saved.
If layer information is contained in the database, the Use Option Fields option is enabled, and layer option syntax exists on
one or more layers of the control logic template:

Single point control logic templates will modify the database layer information to reflect the layer option choices
made.

Multiple point control logic templates will determine which control logic document layers to create by resolving the
layer information from all the points with the layer option choices made as shown in the following example:

(Point A layer information field data) = ---D-DDD-DD--(Point B layer information field data) = -----DDD--D-DD
(Internal resultant value) = -----DDD--D--(Layer option syntax on layer three) = disabled
(Layer option syntax on layer eight) = enabled
(Final layer information value) = -D---D-D--D--The final layer information value is saved in the layer information field of point A and B.
If there is no layer information contained in the database, the Use Option Fields option is enabled, but no layer option syntax
exists in the control logic template:

All layers in the control logic template will exist in the control logic document.

Layer information is not saved in the layer information field of the point. It will remain empty.

If there is no layer information contained in the database, the Use Option Fields option is enabled, and layer option syntax
exists on one or more layers of the control logic template:

12-38

The layer information field of the points is assumed to be --------------- (create all layers).

The assumed database layer information is modified to reflect the layer option choices made.
2VAA000812R0001

12. Composer Power Tools

Miscellaneous Topics

The final layer information value is saved to the layer information field of the points.

12.3.4.4 Macros
Example Macro Directives:

1.

PointA^MacroName ( ); PointB^BlockNumber
The block numbers in the macro will be offset by the value (PointB^BlockNumber ( ) - lowest
block number in macro).

2.

PointA^"MyMacro"^VB; 200

In this example, (if the instruction is part of a function code or input reference) the origin of
the macro will be placed on the first output connector of the function code or input reference.
If the instruction is part of an output reference, the origin of the macro will be placed on the
input connector of the output reference. The block numbers in the macro will be offset by the
value (200 - lowest block number in macro).
3.

"MyMacro"^VFP; 200; ; 15

The block numbers in the macro will be offset by the value (200 - lowest block number in
macro). The origin of the macro will be placed on the specification 15 input of the host
function codes. Point names will not be changed because there is no point in the instruction.
4.

"MyMacro"^VFP; 200; -1; 15

The block numbers in the macro will be offset by the value (200 - lowest block number in
macro). The origin of the macro will be placed on the specification 15 input of the host
function codes. Point names will not be changed because there is no point in the instruction.
5.

"MyMacro"^VB; ; 3

Point names will not be changed because there is no point in the instruction. The origin of
the macro will be placed on the third output connector of the host function code.
Points in Entities Contained in Macros
Points (using the keyword POINT) in the entities that are placed on a sheet as part of a macro being placed on a sheet will
be replaced by the point in the first argument of the macro instruction. If a macro contained a function with the following
attributes

PT-SPEC Point^SpecValue ( ); PointInMacro1^SpecIndex


PT-TAGNAME PointInMacro2^GetTagName ( )
and the attribute on the entity that dropped the macro was

PT-MACRO abc^GetMacroName ( )
then the resultant attributes would be

PT-SPEC abc^SpecValue ( ); PointInMacro1^SpecIndex


PT-TAGNAME PointInMacro2^GetTagName ( )

12.3.4.5 Modify Assignment Options


There are two modify assignments menu options that can be utilized. To illustrate the difference between the two options,
consider the following example information.

A control logic document was created from a control logic template that contains 10 layers.
Only five of the layers were selected during control logic document creation. Additionally, a
macro (containing points) was configured on the control logic document.
ADG-Modify Assignments (Based on Control Logic). Selecting this option would display the five layers in the control logic
document and the points used in the macro. This option would typically be used when only processing the attributes of the
selected control logic document.

ADG-Modify Assignments (Based on Template). Selecting this option would display all 10 layers from the template and none
of the points used in the macro. This option would typically be used when regenerating control logic documents to include
changes made to the database.

2VAA000812R0001

12-39

Miscellaneous Topics

12. Composer Power Tools

12.3.4.6 Point Associations


This window allows points (groupings of control logic) used in the control logic template to be assigned to point fields in the
database. The list of points area of the window lists the points used in the control logic template. The left side of the
database view area displays the point fields found in the database. The number of point fields displayed will equal the
number of address field mappings. The right side of the database view area displays the entire database. The bottom of the
window displays all the fields of the assigned points.
Points are assigned by dragging and dropping a point from the list of points area to the appropriate point field or by typing
the point name in the appropriate point field. Points are unassigned by dragging and dropping valid, invalid, and duplicate
point assignment fields (for the current control logic document) from point fields to the list of points area or by deleting the
point name from the appropriate point field.
The color scheme for the list of point area of this window is:

Green and bold text - Assigned point.

Red text - Unassigned point.

Magenta - Erroneously assigned point.

The color scheme for the left side of the database view of this window is:

Green background - Valid point assignment (for current CLD).

Magenta background - Invalid or duplicate point assignment (for current CLD).

Gray background - Valid point assignment (to other CLDs).

The fields that will contain control logic template, control network, control unit, controller, and control logic document
information for each point are populated at the same time as the point field. The names of the database fields are obtained
from the address field mapping for the point field on which the point was dropped. Refer to Generation Context File for
more information about address field mapping.
Multiple field mappings can be used on the same control logic document as long as the following rules and suggestions are
understood.

Two points from the same control logic document can not be assigned to the same database record.

Points can only be assigned once to the database area.

All points do not need to be assigned to the same point field.

Points do not need to be assigned to a point field if the attribute values for that point are configured appropriately.

12.3.4.7 Prompt Fields


Prompt fields are specified as comments in the procedures that are used during the processing of control logic documents.
Prompt fields can be specified with suggested values.

*<<FIELDS: slv_type (P ASI23 DSI41 ASI12) >>


Prompt fields can also be specified with no suggested values.

*<<FIELDS: di_filter (P) >>


The field assignment area of the control logic processing window lists all the prompt fields specified in the procedures.
The presence of a value in the field value column indicates that the value for that field is the same in all the points assigned
to the points fields. An empty field value field indicates that no value has been assigned to that field in all the points. It could
also indicate that the field value is not the same for all the points.
To edit a field value field:

Enter new text or edit the existing text. This will set the field value used by all points.

- or

Select a value from the drop down list which contains the different values that have been used in this field in other
points. This will set the field value used by all points.

- or

Use browse button to choose a value suggested in the procedure (will set the field value used by all points) or set
different values for other points. Refer to Using Suggested Values for more information.

12.3.4.8 Using Suggested Values


To select a suggested value for a prompt field or select different values for other procedures:

1.

12-40

Select the browse button next to the value field in the field assignments area of the control
logic processing window.
2VAA000812R0001

12. Composer Power Tools

Advanced Trend

2.

Select a value from the drop-down list for the field value or enter the desired value. This drop-down
list displays the suggested values from the procedure.

3.

Enable or disable the Use Same Value for all points function. Enabling this function will set the value
of this field used in all points to the value of the first point listed.

4.

Click Assign.

The newly assigned values will not be written to the database until NextCLD is clicked or the TIP utility wizard runs to
completion.

12.4 Advanced Trend


This utility allows the runtime monitoring and tuning of a Symphony control system. The outputs of function code blocks
executing in a Symphony controller can be monitored and the tunable specifications of the blocks can also be adjusted
using this utility. Additionally, (trend) block output values can be charted and recorded to a record file. Recorded values may
then be later imported into applications such as Microsoft Excel for further data analysis.
Additional functions available include the capability to change the mode (configure, execute,) of a controller as well as
modify function code blocks while the controller is in configure mode.
This utility is a component of Composer but it can be executed as a standalone application (Composer Navigator to be
running at the same time).
This utility is accessed from the Composer window (select Tools > Advanced Trend) or the Windows Start menu (select
ABB > Power Tools > Advanced Trend).
The Advanced Trend window is divided into three areas (chart, tunable specifications, and outputs).
The chart area located in the upper left part of the window displays the trended information a a percentage of the range.
This information can be paused, stopped, zoomed into, and panned. This area can be removed or added by selecting View
> Chart or clicking the view chart toolbar button.
The tunable specifications area located in the upper right part of the window displays a combination of user and systemprovided information. The following table lists the information contained in this area. The columns can be sorted and
rearranged using standard Windows methods. This area can be removed or added by selecting View > Tunable Specs or
clicking the view specs toolbar button.

Table 12-8 Tunable Specifications Area Information


Column

2VAA000812R0001

Description

Loop

Loop name.

PCU

Process control unit name.

Controller

Control module number.

Block

Function block number. The specification value


will not be scanned (collected) if this field is set
to 0.

Tunable Spec
Description

Description of the tunable specification.

F.C.

Function code number.

Spec

Number of the specification to be tuned (user


provided).

Value

Current specification value (system provided,


user editable).

ICI Status

Any ICI messages generated for this


specification while scanning (system provided).

12-41

Common Trend Document Operations

12. Composer Power Tools

The outputs area located across the bottom part of the window displays a combination of user and system-provided
information for values that are to be trended in the chart area. The following table lists the information contained in this area.
The columns can be sorted and rearranged using standard Windows methods.

Table 12-9 Outputs Area Information


Column

Description

Trend

Enable this option to trend the value in the chart


area.

Color

Color of the trend line shown in the chart area.

Output Description Description of the output value.


Loop

Loop name.

PCU

Process control unit name.

Controller

Control module number.

Block

Function block number. The value will not be


scanned (collected) if this field is set to 0.

Maximum

Maximum expected value (100%) of the output.


This value is used to calculate range and is only
needed if the point is being trended.

Minimum

Minimum expected value (0%) of the output.


This value is used to calculate range and is only
needed if the point is being trended.

Value

Current value while scanning (system


provided).

Units

Units in which the value is measured.

Type

Data type of the output value.

ICI Status

Any ICI messages generated for this value


while scanning (system provided).

Quality

Current quality of the output (Good, Bad, or


Suspect).

Alarms

Current alarm value of the output (Hi, In Alarm,


or Lo).

12.4.1 Common Trend Document Operations


Trend Documents are created new, opened, saved, saved as a different file, and printed (the chart area only) using
standard Windows File menu functions.

12.4.2 Configure Default and Document Options


To configure the default and document specific options for advanced trend documents:

12-42

1.

Select Options > Default Options (sets default options for new trend documents) or Options
> Document Options (set the options for this trend document only).

2.

Enter the total number of rows displayed in the tunable specifications area (20 or less) in the
Maximum Number of Tunable Specifications field in the Default Options or Document Options
window.

3.

Enter the total number of rows displayed in the outputs area (20 or less) in the Maximum Number of
Outputs field.

4.

Enter the scan period (interval between ICI scans) for monitoring outputs in the ICI Scan Period
(milliseconds) field. A value of 50 milliseconds or greater must be entered.
2VAA000812R0001

12. Composer Power Tools

Configure Outputs

5.

Enter the number of sampled values that will be maintained (accessible to the line cursor) in the chart
for each trended output in the Samples Per Series field. Each output has one series of values.

6.

Select the color of the cursor (vertical line) that is used when playing back values stored in the chart
at runtime. The outputs area indicates the actual values of the trended values at the cursor location.

7.

Enter the maximum value (in percentage) to display along the Y axis of the chart in the Y Axis
Maximum (%) field.

8.

Enter the minimum value (in percentage) to display along the Y axis of the chart in the Y Axis
Minimum (%) field.

9.

Click OK when configuration is complete.

12.4.3 Configure Outputs


Outputs are trended in the chart area. To add outputs:

1.

Click in the appropriate cells of an empty row.

2.

Enter the appropriate information.

3.

Press Enter, click in another cell to save the information.

4.

Save the trend document when configuration is complete.

Refer to the second table in Advanced Trend for a complete description of the columns
Output data is edited in the same manner. One or more cells in a row may be selected and then cut, copied or pasted to the
windows clipboard. To select a complete row, click on the left hand cell of the desired row. A single action Undo facility is
provided to allow the undoing of the last action performed.
The output data may also be sorted and rearranged using standard Windows methods. Additionally, a fill down feature (File
> FillDown) allows all cells in a column that are below the selected cell to filled with the same value as the selected cell. For
instance, if all blocks to be monitored were on the same Loop, you could go to the top cell of the Loop column, type in the
desired loop number, press Enter and then select Edit > FillDown. All other cells in the loop column will then have the same
loop number as the top cell.

12.4.4 Configure Recording Options


To configure the options that control the recording of trended output values:

1.

Select Options > Recording Options.

2.

Enter the name of the file that will contain the trended output values in the Record File Name field in
the Recording Options window. By default, this file has the same name as the trend document but
with a .rcd extension.

3.

Select the time interval (time period the recording takes place) and click OK. Available options are:

Always - All data collected while recording is on is saved to the file.


From Start Time - The recording of data will start at the specified time but must be stopped
manually.
Before Stop Time - The recording of data must be manually started but will stop at the
specified time.
Interval - The recording of data will start and stop at the specified times.

12.4.5 Configure Tunable Specifications


The tunable specifications area contains information about the specifications that are to be tuned.
To add tunable specifications:

1.

Click in the appropriate cells of an empty row.

2.

Enter the appropriate information.

3.

Press Enter, click in another cell to save the information.

4.

Save the trend document when configuration is complete.

Refer to the first table in Advanced Trend for a complete description of the columns
Tunable specification data is edited in the same manner. One or more cells in a row may be selected and then cut, copied
or pasted to the windows clipboard. To select a complete row, click on the left hand cell of the desired row. A single action
Undo facility is provided to allow the undoing of the last action performed.
2VAA000812R0001

12-43

Convert Trend Files

12. Composer Power Tools

The tunable specification data may also be sorted and rearranged using standard Windows methods. Additionally, a fill
down feature (File > FillDown) allows all cells in a column that are below the selected cell to filled with the same value as the
selected cell. For instance, if all blocks to be monitored were on the same Loop, you could go to the top cell of the Loop
column, type in the desired loop number, press Enter, and then select Edit > FillDown. All other cells in the loop column will
then have the same loop number as the top cell.

12.4.6 Convert Trend Files


To convert a Composer trend document (.tnd) to an advanced trend trend document (.tat) or vice versa:

1.

Select File > Convert Trend Files - Composer (.tnd) to Advanced (.tat) Format or File >
Convert Trend Files - Advanced (.tat) to Composer (.tnd) Format.

2.

Select the source file in the standard Windows file selection window and click OK.

The new file has the same name (different file extension) and is created in the same location as the source file.

12.4.7 Pan
The pan left, pan right, pan up, and pan down toolbar buttons allow the chart area to be panned in all directions. Use the
undo pan button to return to the default view.

12.4.8 Scan Loop


This function allows the scanning of a loop for all nodes (or a range of nodes) and controllers currently online. It is also
possible to generate a module status report and module problem report.
To scan a loop:

1.

Select Tools > Scan Loop.

2.

Enter the appropriate loop number, starting node number, and ending node address in the Scan Loop
window.

3.

Click Scan Loop to begin the scan.

To view a report of the status of all the modules in the scan, click Module Status Report.
To view a report of the problems reported by the modules in the scan, click Module Problem Report.

12.4.9 Scanning and Recording Values


The scanning and recording toolbar buttons control the scanning, scanning and recording, and recording functions. The
start scan button causes the application to start scanning for trend values. The start scan and record button starts the
scanning and recording functions. What gets recorded and when are determined by the recording options (refer to
Configure Recording Options).

NOTE: A new record file is created every time recording is started. Previous files with the same name will be overwritten!
The stop scan and record, pause scanning, start record, and stop recording buttons perform the indicated functions.

12.4.10Tune or Edit Function Block Data


This function allows the viewing of all specifications for a function block and either the tuning (if the controller is in execute
mode) or editing (if the controller is in configure mode) of the block specifications. It is also possible to change the mode of
the controller using this function.
To tune or edit function block data:

a.

1.

Select Tools > Tune Block or Tools > Edit Block.

2.

Enter the appropriate address (control network, control unit, and controller) in the Tune/Edit Block
window. A warning message is displayed if the controller is not in execute or configure mode.

3.

If necessary, click the >> button next to the Status field and select the desired controller mode
(execute or configure).

4.

Click Get Configuration to retrieve the current configuration from the controller.

5.

Select the appropriate function block:

Click in the appropriate row in the left side of the window.

- or 12-44

2VAA000812R0001

12. Composer Power Tools

b.

Zoom

Enter the block number in the Block field and click Get Block.
6.

Edit the tunable specifications (appended with a - T). Non-tunable specifications can also be edited
when the controller is in Configure mode. Modified data is sent to the controller immediately.

12.4.11Zoom
The zoom in and zoom out toolbar buttons allow the chart area display resolution to be increased or decreased as required.
Use the undo zoom button to return to the default zoom setting.

2VAA000812R0001

12-45

Zoom

12. Composer Power Tools

12-46

2VAA000812R0001

13. ICI to Computer Interface Setup

Introduction

13. ICI to Computer Interface Setup


13.1 Introduction
In order for a Harmony communication interface module or ICI, (ICI, NCC, IET modules will be generically refered to as ICI
within this section) to communicate with a computer, the communications settings for client applications like Composer or
an HSI must be configured. The Harmony System Configuration (hSysCfg) program is used to configure communications
with Harmony ICI modules. This section explains how to configure the ICI module using the hSysCfg software program.
The program executable, hSysCfg.exe, is located in the C:\Program Files\ABB\Harmony API\EXE (by default - user may
change the location during installation) subdirectory. During the Composer installation process a shortcut to hSysCfg.exe is
created in the Windows Start Menu; Start > Programs > ABB > HarmonyAPI > ABB Harmony System Configuration Utility.
Click on the shortcut or use Windows Explorer to navigate to the hSysCfg.exe executable file (double click on the file) to
start the program.
The hSysCfg program contains product version information that can be found by right-clicking the hSysCfg.exe file,
choosing Properties, and then select the Version tab. The product version information is in the format ww.xx.yyy where:

ww
xx
yyy

Major version
Minor version
Build number

This information may be needed when performing upgrades or reporting issues with hSysCfg.
The following sections explain the configuration using various connection methods (serial, TCP/IP, and SCSI).

13.2 Harmony System Configuration


The hSysCfg program allows users to configure up to twenty "logical ICIs". A Logical ICI is a group of settings that define a
physical connection used to communicate to a physical ICI and the CNet.
Each COM port, SCSI LUN, or TCP/IP:Port can be assigned to a logical ICI that can then be selected by client applications.
Client applications, like Composer, use the logical ICI to select which physical ICI device to use for communication with the
INIET800 or other Harmony modules.
If a logical ICI is configured as a service, then the physical interfaces can be made available to remote clients on a specific
TCP/IP port over an Ethernet network. The computer running these services then acts as a "communications server".
The hSysCfg screen is divided into three areas or frames, the Logical to Physical Connection frame, a Connection Type
frame, and a Command Button frame. Figure 13-1 shows the location of the frames within the hSysCfg dialog box.

2VAA000812R0001

13-1

Logical to Physical Connection Frame

13. ICI to Computer Interface Setup

Figure 13-1 hSysCfg dialog box frames


The following is an explanation of each field found in the hSysCfg frames.

13.2.1 Logical to Physical Connection Frame


The Application Logical ICI field is used to select the logical ICI to be configured. Select a number from the Application
Logical ICI drop down box. The number serves as a map that the client application uses to select a specific physical ICI
connection on a specific node. There are 20 possible computer interface configurations available from the drop down box.
Click the Application Logical ICI arrow to see a listing of logical ICIs. When a previously configured logical ICI is selected,
the hSysCfg program displays all existing settings for that logical ICI.
The Connection Description field is used to associate a text string with the Application Logical ICI number. A separate text
string describing each connection may be entered. Maximum string length is 99 alphanumeric characters.
When the Application Logical ICI dropdown menu is selected, any previously configured logical ICIs will contain the
Connection Description appended to the logical ICI number shown in the dropdown list. The Connection Description helps
to quickly identify the logical ICI requiring configuration.

Information

The description input into this field will appear in the Application Logical ICI
field after clicking Apply > Quit and then restarting the hSysCfg program.

The Physical ICI Device field is used to define the type of physical device to be connected. Click the Physical ICI Device
arrow for a listing of available options.
The Physical Connection Type field is used to define the network communication protocol to be used by client applications
when using the logical ICI. When a COM port is selected for the Physical ICI Device, the Physical Connection Type is set
automatically to SERIAL. Likewise, SCSI devices use a SCSI Physical Connection Type and Ethernet interfaces use
TCP/IP as the Physical Connection Type. More than one logical ICI can be defined to communicate with the same physical
computer interface using different network communication protocols.

Caution

13-2

If different communications parameters are used for the same physical


interface in multiple logical ICIs, communication to the CNet may not work if
these logical ICIs are used simultaneously by two or more applications.

2VAA000812R0001

13. ICI to Computer Interface Setup

Information

Command Buttons

SCSI will ONLY appear in the Physical Connection Type field when an
attached SCSI device is detected or when a SCSI device is added manually
using the SCSI tab in the Connection Type definition frame

13.2.2 Command Buttons


The command buttons provide a number of functions.

The Default button is used to return all configuration fields for the currently selected logical ICI back to their ABB
defaults.

The Restore button is used to return all configuration fields back to their last saved values (last time Apply was
clicked) for the currently selected logical ICI.

The Export button will create a disk file that can be used to transfer settings to another PC.

The Import button is used to import previously exported configuration files.

The Apply button is used to save changes made to the configuration.

The Quit button exits the hSysCfg program without saving. If changes have been made to the configuration,
clicking Quit will prompt the user to save the changes.

The Help button launches a document with hSysCfg help information.

Information

When any part of a configuration is changed, save it by clicking Apply in the


command frame. Click Restore to return to the last saved configuration, and
click Quit to exit the hSysCfg program

13.2.3 Connection Type Definition Frame


In this frame the parameters needed to communicate with the ICI are defined. There are four tabs in this frame: TCP/IP,
Serial, SCSI, and Licensing.

13.2.3.1 TCP/IP Tab


Figure 13-2 shows the dialog box used to configure an INIET800 using an Ethernet interface The TCP/IP tab is used to
configure Network Communication Couplers (NCCs), remote communication servers and INIET800 modules.

Figure 13-2 hSysCfg screen for Ethernet configuration

The IP Address field is used to enter the IP address of the INIET800 node or the NCC, or the name or IP address
of the remote communication server. The INIET800s IP address must be in standard IP dot notation (xx.xx.xx.xx).

Information

2VAA000812R0001

By default the hSysCfg program populates the IP Address field with the local
computers name. When using a name for a remote server, the name of the
remote server must be in a Domain Name Service (DNS), a WINS server, the
LMHOSTS file, or in the computers internal host entry table.
13-3

Connection Type Definition Frame

13. ICI to Computer Interface Setup

The Port field is used to enter a TCP/IP service port number. When TCP/IP network protocol is the physical
connection type between the INIET800 or NCC and the PC, the port number is set to 3000 and the field is disabled.
For remote server applications, enter the port number in the Port box.

The Test Connection button is used to verify communications with a target INIET800. After completing the IP
Address and Port boxes, Click Test Connection to verify communication. Upon successful communication with the
target INIET800 the following message will be displayed:.

Figure 13-3 Test connection dialog for a successful connection test


If communication with the INIET800 can not be made the dialog box shown in Figure 13-4 will be displayed. Check
the IP address, port settings, and local network configuration and re-test the connection.

Figure 13-4 Test connection dialog for a failed connection test

If a valid IP address is entered, but the device is not an IET, or communication or security settings do not match the
settings of the INIET800 module, the following message will be displayed:

Figure 13-5 Test connection dialog for Non-IET device

The IET800 Settings, Security Level radio buttons are used to select the type of security to be used with the
INIET800. When the INIET800 is configured for Ethernet communications both the Basic and Advanced security
level options are available. Selecting the Advanced security radio button enables SSL security. Otherwise Basic
security is used. See the INICI800 users manual for a description of the security scheme used in the INIET800.

NOTE: The security setting defined in the software must match the security setting defined on the module hardware.
See INICI800 users manual for instructions needed to set up the INIET800 module.

The Assign IP button is used to assign or to re-assign the IP address of the INIET800. Enter the desired IP address
into the IP Address field and select Assign IP.

Information

The PC running hSysCfg and the INIET800 must be on the same network
segment in order for Assign IP to function properly. If they are not on the
same segment, then the IP address of the INIET800 must be configured
using the INIET800s serial diagnostic port connector.

Initial IP Assignment Procedure.

13-4

1.

Enter desired IP address

2.

Click Assign IP. An attempt will be made to ping the address. No response should occur.
2VAA000812R0001

13. ICI to Computer Interface Setup

Connection Type Definition Frame

3.

A dialog will appear where INIET800 IP information may be entered.

4.

Enter the desired IP address (again), and the default Ethernet gateway and subnet mask.

5.

Click OK. The hSysCfg program will enter BOOTP mode and then waits for the INIET800 to send a
BOOTP request.

6.

Restart INIET800 module. The INIET800 will send a BOOTP request on restart, and hSysCfg will
then respond by assigning the INIET800 the IP information previously entered. The INIET800 will
then restart and hSysCfg will issue a ping command to the INIET800. The hSysCfg program then
reports a successful IP address assignment.

IP Reassignment Procedure.

1.

Enter the current INIET800s IP address and click Assign IP.

2.

hSysCfg will issue a ping command and report a successful ping.

3.

The INIET800s IP Information appears in a dialog box.

4.

Enter the new IP address and gateway/mask information. Click OK.

5.

hSysCFg will request that the INIET800 enter BOOTP mode.

6.

Restart INIET800 module. The INIET800 will send a BOOTP request on restart, and hSysCfg will
then respond by assigning the INIET800 the IP information previously entered. The INIET800 will
then restart and hSysCfg will issue a ping command to the INIET800. The hSysCfg program then
reports a successful IP address assignment.

NOTE: IP reassignment will take the INIET800 offline and will disrupt any active communication.

The Global Network Adapter Parameter Tuning (IET only) box lists all of the available network adapters on the
workstation. The hSysCfg program will modify communication parameters for the selected adapter in order to
optimize communication with INIET800 module. Select one or more network adapters from this list that will be used
for communication with the INIET800.

13.2.3.2 Serial Tab


Figure 13-6 shows the dialog box used to configure an INIET800 using a serial (RS-232) interface.

Figure 13-6 hSysCfg screen for Serial (RS-232) configuration

The Baud Rate box is used to select the baud rate for the serial connection. Click the Baud Rate arrow to select
from the available options. Baud rate options will vary depending on the Physical ICI Device setting.

The Parity box is used to select the parity to be used for the serial connection. Click the Parity arrow to select from
available options (none, odd, or even).

2VAA000812R0001

13-5

Connection Type Definition Frame

13. ICI to Computer Interface Setup

The Data Bits box is used to enter the number of data bits to be used for the serial connection. Click the Data Bits
arrow to select from available options (7 or 8).

The Stop Bits box is used to enter the number of stop bits to be used for the serial connection. Select the Stop Bits
arrow to select from available options (0, 1, or 2).

The Baud, Parity, Data Bits, and Stop Bit boxes are enabled whenever COM selection is made in the Physical Connection
Type drop down box. The settings selected on this screen must match the INIET800 modules settings. See INICI800 users
manual for instructions on setting up the INIET800 module.

13.2.3.3 SCSI Tab


Figure 13-7 shows the dialog box used to configure a SCSI interface.

Figure 13-7 hSysCfg screen for SCSI interface


SCSI devices are normally automatically detected by the hSysCfg program after the information in the Logical to Physical
Connection Frame has been entered.

13-6

The Bus field is used to select the bus associated with the SCSI device. Select the Bus arrow to select from
available options (0 - 7).

The Controller field is used to select the controller number. Select the Controller arrow to select from available
options (0 or 1).

The LUN or Logical Unit Number field is used to select the SCSI address associated with the SCSI device. Select
the LUN arrow to select from available options (0 - 7).

The TCP/IP Port field is used to identify which port will be used when the ICI is acting as a remote communication
server.

2VAA000812R0001

13. ICI to Computer Interface Setup

Harmony API Server Setup as Windows 7 Service

13.2.3.4 Licensing Tab


Figure 13-8 shows the dialog box used to configure INIET800 licenses.

Figure 13-8 hSysCfg screen for Licensing

The Electronic ID box will display the INIET800s MAC address. After completing all fields on the TCP/IP Tab, click
Read License to update the Electronic ID box. Clicking the Read License button will cause hSysCfg to query the
INIET800 specified by the values assigned in the IP Address and Port setting fields. The hSysCfg program will
attempt to complete the Electronic ID and Device License fields. Blank fields will be returned if the INIET800 cannot
be found or if a valid INIET800 license has not been written to the device. The INIET800 must already have had its
IP address assigned in order to use these functions.

The Write License field is used to enter the INIET800 user license key. See the instructions that came with the
INIET800 on how to obtain an INIET800 license key from ABB. Contact ABB Support for help in obtaining INIET800
license keys.

Clicking the Write License button causes the license string listed in the License Key field to be written to the
INIET800 identified in the Application Logical ICI field. If an incorrect license file is written the hSysCfg program will
return the following error message

Figure 13-9 Incorrect license error message

If the INIET800 already contains a valid license, it will be over written by the new license data.

13.2.4 Harmony API Server Setup as Windows 7 Service


This procedure enables you to create a Harmony Communications Server that can be used by remote client applications
like Composer. This procedure requires the following:

2VAA000812R0001

Installation of the Harmony API software and the configuration of one or more serial logical/physical computer
interfaces using the hSysCfg program.

13-7

Harmony API Server Setup as Windows 7 Service

13. ICI to Computer Interface Setup

Verification that the server system can communicate with the selected physical computer interface. This must be
done by running the application program on the target machine and verifying that it can communicate with the
computer interface.

Login as a member of the Windows 7 administrator group.

NOTE: Only ICI serial interfaces may be setup to run as a Windows service. This section does not apply to Ethernet
interfaces because an Ethernet interface can be accessed from client applications directly without need for a separate communication server.

13.2.4.1 Establishing Services


This section describes how to establish the HarmonyAPI device driver (server) as a service for a specific physical ICI using
a serial interface. One service may be established for each licensed physical ICI device.
The HarmonyAPI Server service is assigned a name and that name is associated with the physical ICI device. HarmonyAPI
Server naming is based on the Physical Connection Type field in the hSysConfig program; the name convention follows the
format:

DD_<connection type>
For example, a physical INIET800 interface connected to the COM1 serial port would have a Harmony API server service
named DD_COM1.The service is installed by running DeviceAsService.exe (from its fully qualified path) with the service

Information

All HarmonyAPI servers that are installed as a service must conform to this
naming convention

name and the -i command line parameter. The following is an example:

C:\Program Files\ABB\HarmonyAPI\EXE\DeviceAsService DD_xxxx -i


Where, _xxxx is com1, com2,...com8 for serial ports. A successful installation will reply with a message that this specific
service was installed as shown in the following example:

DD_COM1 installed
Run the DeviceAsService.exe for each physical ICI that is to be run as a Windows service.

13.2.4.2 Verifying Windows Service


Verify that the service was added using the Services control panel. From the Start icon (Windows 7), select Control Panel
> System and Security > Administrative Tools > Services. Double click on the Services icon. Verify that the service is
listed. See the example below:. Note: in the example, services for physical ICIs DD_COM1 and DD_COM2 were previously

Figure 13-10 Verifying Windows Service


installed.

13.2.4.3 Configuring Services


This procedure will determine how the service will start up.

13-8

1.

After double-clicking the Services icon, highlight the Harmony API server service record
and click Startup.

2.

By default, the Startup Type is set to Manual. The Startup Type option may be set to
Automatic (recommended) to ensure that the service will start automatically every time the
computer is rebooted. Click OK to close the dialog box.

2VAA000812R0001

13. ICI to Computer Interface Setup

Setting the IET800's IP Address via the diagnostic port

13.2.4.4 Starting Services


When services have been established and configured for automatic startup, the service can be started by rebooting the
server; a login is not required. Remote and local clients will now be able to connect to the computer interface.
To diagnose problems encountered during device service startup, consult the application event log.
There are two ways to manually start the service:

From Services in the control panel, select the service and click Start.

Invoke the NET.EXE utility command sequence from the Windows Run dialog box by entering:

net start DD_port


where:
DD_port

Application Logical ICI name

Check the Event Viewer > Application Log to determine if the service has been started correctly. Startup, shutdown, and
diagnostics will also be displayed in this log.

13.2.4.5 Stopping Services


To stop a service (e.g., to upgrade the device driver), follow one of these instructions:

Login to the system and terminate the DeviceAsService.exe program using Windows Task Manager.

From Services in the Windows Control Panel, select the service and click Stop.

From Services in the Windows Control Panel, select the service, click Startup, select either Manual or Disabled,
click OK and reboot the computer.

13.2.4.6 Uninstalling Services


To uninstall the service, run DeviceAsService.exe (from its fully qualified path) with the service name and the -u command
line parameter. Using the Windows Run dialog box open a command window by typing cmd in the Run dialog box, then
select OK. See Figure 13-11 for an example:.

Figure 13-11 Uninstalling DeviceAsService from a command window

13.3 Setting the IET800's IP Address via the diagnostic port


In some situations it may not be possible to set the IP address using the hSysCfg program. In those situations the IET800s
diagnostic port may be used. The following procedure is used:

NOTE: The terminal emulation program must be capable of performing a file transfer using XModem protocol.Third
party terminal emulation software, such as Tera Term, is not supplied by ABB

1.

Connect a PC's serial port to the IET800's DB-9 diagnostic connector, P11, which is located
behind the IET800's front plate. Configure the PC's terminal emulation software (third party
terminal emulation software is not supplied by ABB) for 9,600 baud, 8-bits, 1-stop bit, No
parity.

2.

Set the IET800's SW1 pole-2 to OPEN, SW2 pole-6 to OPEN, SW4 poles-6,7,8 to OPEN. All other
switch poles are set to CLOSED. Install the IET800 into the MMU, along side its NIS21.
The following should appear on the PC terminal emulation software display.

ABB Automation - IET800 Firmware Revision A_0.13


Copyright 1998-2011 by ABB Automation Inc. All Rights Reserved
2VAA000812R0001

13-9

Setting the IET800's IP Address via the diagnostic port

13. ICI to Computer Interface Setup

1-->TALK90
2-->Configure/View callup password
3-->Computer command/reply sequences (off)
4-->Set local time/date
5-->Monitor mode (off)
6-->Real Value Conversion
7-->Port address (-1)
9-->Default Time Sync accuracy (3)
Select option:
Starting up at IP address 0.0.0.0
with IP mask 255.255.255.0
default gateway 0.0.0.0
and security Advanced
MAC0 Address: 00C0C90144B9
MAC1 Address: 00C0C98144B9
Connection established with ICI Type 14 Mode 14
Firmware Revision A_0
Node 21 Loop 1
Not Restarted Off-line
Autostart Completed!
3.

Enter a zero '0' after the above appears. Note: This may take up to 1 minute following a reset, if the
IET800's configuration is set to its default IP address of 0.0.0.0.

4.

Enter a 'P' after the following appears.

IET800 Diagnostic Utilities Revision A_0.13 P


5.

Enter an 'F' after the following appears.

NOTE: set DIAGNOSTIC LEVEL > 0 (option 'L') to get messages


Current PRINT FLAG = 0
error messages = 1
local messages = 2
menus
=4
remote messages = 8
Enter new PRINT FLAG (HEX): F
6.

Enter a '3' after the following appears.

IET800 Diagnostic Utilities Revision A_0.13


1--> LOCAL NIS/LIS REQUEST

2--> REMOTE NIS/LIS REQUEST

3--> LOCAL MODULE UTILITIES

4--> REMOTE MODULE UTILITIES

5--> ERROR MESSAGE MONITOR

7--> READ LOOP TOPOLOGY

B--> BUILD A MESSAGE

T--> SET TERMINAL TYPE

C--> ICI/CIU UTILITIES

P--> PRINT FLAG (=f)

U--> CPU UTILIZATION

Y--> SET YEAR-DATE-TIME

SELECT OPTION: 3
7.

Enter an 'E'' after the following appears.

Local Module Utilities


1--> READ/WRITE MEMORY
2--> EXAMINE BLOCK RECORDS
3--> EXAMINE NODE RECORDS
13-10

2VAA000812R0001

13. ICI to Computer Interface Setup

Setting the IET800's IP Address via the diagnostic port

4--> DIAGNOSTIC COUNTERS


5--> MEMORY UTILIZATION
6--> REAL VALUE CONVERSION
7--> EXCEPTION STATISTICS INITIALIZE
8--> EXCEPTION STATISTICS READ
9--> RED LIGHT HALT ANALYSIS
E--> ELECTRONIC IDS
F--> FAILOVER STATISTICS READ
M--> READ MODULE DETAILS
N--> READ NODE PERFORMANCE STATISTICS
P--> READ REDUNDANCY LINK STATISTICS
R--> ROS TASK STACK USE
S--> TCP/IP UTILITIES MENU
T--> READ TIME SYNC MASTER ID
SELECT OPTION or press ESCAPE to exit: E
8.

Enter a '5' after the following appears.

ELECTRONIC IDS
0--> Read all MicroLAN Electronic IDs
1--> Read License
2--> Enter License
3--> Reset License
4--> Read MAC Address
5--> Read/Enter IP Address/Mask/Gateway
6--> Read License/Security Status
7--> Test License
Enter option: 5
9.

Enter the desired IP address after the following appears.

The current IP address: 0.0.0.0


Enter an IP address ???.???.???.???
IP address: xxx.xxx.xxx.xxx
10. Enter the desired IP mask after the following appears.

The current IP mask: 255.255.255.0


Enter an IP mask ???.???.???.???
IP mask: xxx.xxx.xxx.xxx
11. Enter the desired Gateway address after the following appears.

The current Gateway address: 0.0.0.0


Enter a Gateway address ???.???.???.???
Gateway address: xxx.xxx.xxx.xxx
>>> This module must be restarted for changes to take effect
12. Reset SW2 pole-6 to CLOSED.
13. Restart the IET800 module.

2VAA000812R0001

13-11

Setting the IET800's IP Address via the diagnostic port

13-12

13. ICI to Computer Interface Setup

2VAA000812R0001

INDEX - i

A
Abbreviations 1-1
Add entity (file, database, etc.) 3-55
Advanced trend 12-41
Assign list 3-44
Automatic drawing generator 12-27
B
Binding log 3-8
Binding report 3-8
Branch control logic document 3-20
C
C files
Load 3-13
C program and data files 3-18
Change address 3-55
Change controller mode 3-9
CLD 2-4
CLT 2-4
Communication issues 3-20
Compile controller 3-9
Composer power tools 12-1
Advanced trend 12-41
Automatic drawing generator 12-27
Control logic editor 12-1
Revision manager 12-22
Composer prelaunch service 10-1
Configuration 10-1
Logon agent 10-2
Service administrator 10-2
Compress log 6-11
Configuration file 2-4
Change revision 3-35
Delete 3-56
Delete revision 3-35
History 3-35
Load from controller 3-35
Load to controller 3-35
Move 3-57
Properties 3-35
Rename 3-57
Verify 3-64
View configuration 3-61
Configuration server
Copy 3-56
Delete 3-56
Move 3-57
Control logic document 2-4, 3-22
Branch 3-20
Change address 3-55
Change revision 3-34
Copy 3-56

Create 3-27
Create revision 3-34
Delete 3-56
Delete revision 3-34
Edit 3-27
Export information 3-27
History 3-34
Import information 3-31
Link/unlink 3-20
Move 3-57
Print 3-33
Properties 3-34
Rename 3-57
Restore 3-22
Status 3-34
Tag synchronize 3-57
Upgrade 3-20
Verify 3-64
View configuration 3-61
Control logic editor 12-1
Database utilities 12-14
Function code editor 12-13
Manipulate Cls 12-1
Text/Xref editor 12-3
Control logic template 2-4, 3-20
Create 3-21
Edit 3-21
Properties 3-21
Restore 3-22
Settings 3-20
Upgrade 3-22
Control network 2-3, 3-6
Change address 3-55
Copy 3-56
Create 3-6
Delete 3-56
Import document 3-56
Move 3-57
Properties 3-6
Rename 3-57
Tag synchronize 3-57
Controller 2-4, 3-7
Change address 3-55
Change operating mode 3-9
Compile 3-9
Copy 3-56
Create 3-10
Delete 3-56
Harmony controller firmware 3-12
Harmony firmware 3-12
Harmony I/O device firmware 3-11

INDEX - ii

Edit CSP file 3-11


Format memory 3-12
Import document 3-56
Import Harmony firmware 3-12
Inspect 3-12
Label device 3-12
Move 3-57
Online configuration 3-14
Print 3-16
Properties 3-17
Rename 3-57
Tag synchronize 3-57
Verify 3-64
View configuration 3-61
View files 3-18
View reports 3-18
Convert DOS tools projects 8-1
Copy 3-56
Copy Harmony firmware 3-10
Copy Harmony I/O device firmware 3-10
Copy user
Filters 8-1
Replace specifiers 8-1
Views 8-1
Create
Control logic document 3-27
Control logic template 3-21
Control network 3-6
Controller 3-10
Display 3-41
Display group 3-40
Entity (file, database, etc.) 3-55
Exchange folder 3-5
Harmony control unit 3-7
Human system interface 3-39
List 3-44
Log 6-3
Project 3-3
Custom log 6-3
D
Data browser 4-3
Add records 4-8
Control logic document 4-16
Copy records 4-9
Delete records 4-9
Edit records 4-9
Filter records 4-4
Find records 4-10
Formats 4-8
Go to row x 4-11
Properties 4-16

Refresh records 4-11


Reorder columns 4-11
Replace records 4-11
Select columns 4-15
Select font 4-15
Select records 4-16
Sort records 4-16
Views 4-3
Data files
Load 3-13
Database utilities 12-14
Delete 3-56
Description 2-3
Display 2-4, 3-41
Copy 3-56
Create 3-41
Delete 3-56
Edit 3-41
Export 3-41
Import document 3-56
Move 3-57
Open 3-42
Print 3-42
Properties 3-42
References 3-43
Rename 3-57
Display group 2-4, 3-40
Copy 3-56
Create 3-40
Delete 3-56
Export 3-40
Import document 3-56
Move 3-57
Print 3-40
Properties 3-41
Rename 3-57
DOS tools projects 8-1
E
Edit
Control logic document 3-27
Control logic template 3-21
Display 3-41
List 3-44
Log 6-3
Tag database 4-9
Edit CSP file 3-11
Edit function block data 12-44
Entity
Add 3-55
Create 3-55
Environment 2-3

INDEX - iii

EUD list 2-5


Event log 6-1
Example project configuration 7-1
Exchange 3-5
Exchange folder
Copy 3-56
Create 3-5
Delete 3-56
Move 3-57
Open 3-5
Properties 3-6
Rename 3-57
Shortcut 3-6
Exchange window 2-3
Export
List 3-48
Log 6-11
Export information
Control logic document 3-27
F
Field information tables 4-17
Filter fields 12-15
Filters 8-1
Find fields 12-15
Format controller memory 3-11
Function code editor 12-13
G
Glossary 1-1
H
Harmony API
Server Setup as Windows Service 13-7
Harmony control unit 2-4, 3-6
Copy 3-56
Create 3-7
Delete 3-56
Import document 3-56
Inspect 3-12
Move 3-57
Properties 3-7
Rename 3-57
View reports 3-7
HCU 2-4, 3-6
HSI 2-4, 3-39
Human system interface 2-4, 3-39
Copy 3-56
Create 3-39
Delete 3-56
Import document 3-56
Move 3-57
Properties 3-39
Rename 3-57

I
ICI connection to remote server 8-3
Import
Harmony controller firmware 3-12
Harmony I/O device firmware 3-12
List 3-48
Import document 3-56
Import information
Control logic document 3-31
Inspect 3-12
Intended user 1-1
L
Label device 3-12
Link/unlink CLD 3-20
List 2-5, 3-43
Assign 3-44
Copy 3-56
Create 3-44
Delete 3-56
Edit 3-44
Export 3-48
Import 3-48
Move 3-57
Properties 3-54
Rename 3-57
Load C files 3-13
Load data files 3-13
Load Harmony firmware 3-13
Log 2-4, 6-1
Compress 6-11
Create 6-3
Custom 6-3
Edit 6-3
Event 6-1
Export 6-11
Save 6-11
Log editing functions 6-11
LSD list 2-5
M
Manipulate Cls 12-1
Miscellaneous procedures 8-1
N
Non-system folder 2-3, 3-5
O
Online configuration 3-14
Open
Display 3-42
Exchange folder 3-5
Project 3-3
Output window 2-3
Overview 1-1

INDEX - iv

P
Print
Control logic document 3-33
Controller 3-16
Display 3-42
Display group 3-40
Problem reports 3-18
Program file
Change revision 3-35
Delete revision 3-35
History 3-35
Project 2-3, 3-1
Architecture 2-3
Auto open 3-1
Compact 3-2
Convert 3-2
Copy 3-56
Create 3-3
Development 2-5
Import document 3-56
Open 3-3
Properties 3-4
Repair 3-4
Run time functions 3-4
Save as 3-5
Properties
Configuration file 3-35
Control logic document 3-34
Control logic template 3-21
Control network 3-6
Controller 3-17
Display 3-42
Display group 3-41
Exchange folder 3-6
Harmony control unit 3-7
Human system interface 3-39
List 3-54
Project 3-4
R
Refresh system architecture 3-4
Rename 3-57
Replace fields 12-20
Replace specifiers 8-1
Report (binding) 3-8
Restore
Control logic document 3-22
Control logic template 3-22
Revision manager 12-22
Revisions 3-34, 3-35
Run-time functions 3-4
Always prompt on connect 3-5

Configure 3-5
Connect 3-5
Disconnect 3-5
Never prompt on connect 3-5
Restart 3-5
S
Save log 6-11
Scan loop 12-44
Shortcut 3-6
Standalone configuration viewer 9-1
Computer interface modules 9-3
Configuration files 9-1
Function blocks and codes 9-2
Status reports 3-18
System architecture window 2-3
System folder 3-5
System folders 2-3
T
Tag
Database 2-4
Edit 4-9
Overview 4-1
Fields 4-1
Synchronize 3-57
Types 4-1
Tag list structures 11-1
Terms 1-1
Text/Xref editor 12-3
Tune function block data 12-44
U
Upgrade
Control logic document 3-20
Control logic template 3-22
V
Verify 3-64
View
Configuration 3-61
Harmony control unit reports 3-7
Properties 3-63
Views 4-3, 8-1
Copy 4-4
Create 4-3
Modify 4-4
Save 4-8
Select 4-8
View list 4-4

Notice
The information in this document is subject to change
without notice and should not be construed as a commitment by ABB. ABB assumes no responsibility for
any errors that may appear in this document.
In no event shall ABB 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 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,
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.
This product meets the requirements specified in EMC
Directive 89/336/EEC and in Low Voltage Directive 72/
23/EEC.

Document Number: 2VAA000812R0001

ABB Ltd.
Business Unit Power Generation
P.O. BOX 8131
8050 Zrich
SWITZERLAND
Phone: +41 (0) 43 317-5380
Fax: +41 (0) 43 317-5382
www.abb.com/powergeneration

Copyright 2011by ABB.


All rights reserved.
Release: April 2011

2VAA000812R0001

S-ar putea să vă placă și