Professional Documents
Culture Documents
Release Notes - 3BDS007582D101 - Application Builder
Release Notes - 3BDS007582D101 - Application Builder
Release Notes - 3BDS007582D101 - Application Builder
Release Notes
3BDS 007 582D101
Use of DANGER, WARNING, CAUTION, and NOTE
This publication includes, DANGER, WARNING, CAUTION, and NOTE information where appropriate to point out safety
related or other important information.
DANGER Hazards which could result in severe personal injury or death
WARNING Hazards which could result in personal injury
CAUTION Hazards which could result in equipment or property damage
NOTE Alerts user to pertinent facts and conditions
Although DANGER and WARNING hazards are related to personal injury, and CAUTION hazards are associated with
equipment or property damage, it should be understood that operation of damaged equipment could, under certain operational
conditions, result in degraded process performance leading to personal injury or death. Therefore, comply fully with all
DANGER, WARNING, and CAUTION notices.
TRADEMARKS
Adobe and Acrobat are trademarks of Adobe Systems Incorporated.
Advant, AdvaCommand, AdvaInform, and AdvaBuild are registered trademarks of ABB Asea Brown Boveri Ltd., Switzerland.
ABB Master, MasterPiece, MasterGate, MasterFieldbus, MasterNet, and MasterView are registered trademarks of ABB Asea
Brown Boveri Ltd., Switzerland.
AdvaSoft, Advant Station, AdvaBuild On-line Builder, Advant Controller, and Advant Fieldbus are trademarks of ABB Asea
Brown Boveri Ltd., Switzerland.
IBM and all IBM-products mentioned in this publication are registered trademarks of International Business Machines Corp.
Microsoft, MS-DOS, Windows, Windows NT and Windows 2000 are registered trademarks of Microsoft Corporation.
NOTICE
The information in this document is subject to change without notice and should not be construed as a commitment by ABB
Automation Products GmbH. ABB Automation Products GmbH assumes no responsibility for any errors that may appear in this
document.
In no event shall ABB Automation Products GmbH 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 Automation Products GmbH 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 ABB Automation Products GmbH’s written
permission, and the contents thereof must not be imparted to a third party nor be used for any unauthorized purpose.
The software 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.
Template: 3BSE001286/E
TABLE OF CONTENTS
Chapter 1 - Introduction
1.1 Executive Summary................................................................................................. 1-1
1.2 How to Use This Document..................................................................................... 1-1
1.3 Version Designation................................................................................................. 1-1
1.4 Revision Record....................................................................................................... 1-2
1.5 Compatibility ........................................................................................................... 1-3
1.6 Restrictions .............................................................................................................. 1-4
1.7 Related Documentation............................................................................................ 1-4
Chapter 2 - Functionality
2.1 New Functions ......................................................................................................... 2-1
2.1.1 Stand alone and Integrated...................................................................... 2-1
2.2 Discontinued and Replaced Functions and Units .................................................... 2-3
2.3 Fixed Problems ........................................................................................................ 2-3
2.3.1 Stand alone.............................................................................................. 2-3
2.3.1.1 Attach of existing Node, TC or CI ................................... 2-3
2.3.2 Integrated in Industrial IT ....................................................................... 2-3
2.3.2.1 Update FCB Version does not work for Node/CI/TC
if no ODB exist ................................................................ 2-3
2.3.2.2 APB loops in special situation after Modify Tool Version
with automatic Update Version ........................................ 2-4
2.3.2.3 Name of copied Node, TC or CI is not added to .DAT
file .................................................................................... 2-4
2.4 Known Problems and Work Arounds ...................................................................... 2-4
2.4.1 Stand alone.............................................................................................. 2-4
2.4.1.1 Editing .TIX or .TBX files with AS100-EDIT ................ 2-4
2.4.1.2 Update FCB Data of Nodes Containing Only DB or Only PC
Part ................................................................................... 2-4
2.4.2 Integrated in Industrial IT ....................................................................... 2-5
2.4.2.1 Unexpected Termination of Plant Explorer...................... 2-5
2.4.3 Integrated in Advant Engineering Workplace......................................... 2-5
2.4.3.1 Generate Source in Generate DB or Update Parameter with
View Function Chart ........................................................ 2-5
2.4.3.2 Print / Print to File on Type Circuit and Circuit Aspect... 2-6
2.4.3.3 Terminate Structure Builder / Application Builder Stays in
Memory ............................................................................ 2-6
2.4.3.4 Generate DB / Function Chart Builder Stays in Memory 2-6
2.4.3.5 Progress Indication for Generate DB, Update Parameter and
Initialize ........................................................................... 2-6
Chapter 3 - Installation
3.1 Installation ............................................................................................................... 3-1
3.2 Upgrading ................................................................................................................ 3-1
3.3 Backup and Restore ................................................................................................. 3-2
3.4 Un-install ................................................................................................................. 3-2
Chapter 4 - Miscellaneous
4.1 System Specification................................................................................................ 4-1
Chapter 1 Introduction
1.5 Compatibility
Application Builder 4.1/0 supports:
• Function Chart Builder <= 6.1/0
• Bus Configuration Builder 3.0/0
• On-line Builder 3.0/0
Application Builder 4.1/0 requires Eingineering Studio 1.1/0 when running integrated in
Industrial IT.
Application Builder 4.1/0 requires Structure Builder 3.2/0 when running in integrated in Advant
Engineering Workplace.
Application Builder 4.1/0 is compatible with earlier versions of Application Builder when
working stand alone. Older versions of Function Chart Builder, Bus Configuration Builder, and
On-line Builder are also supported by this Application Builder version.
Application Builder 4.1/0, more exactly Bus Configuration Interface 3.0/1, automatically
converts and upgrades any Bus Configuration Database generated by Application Builder >=
2.6/0, Bus Configuration Builder >= 2.5/2, and Function Chart Builder >= 4.5/2.
• ACC 1.5/2 components (BCB 2.5/2, FCB 4.5/2) create BCD version 1.0.
• ACC 1.6/1 components (APB 2.6/0, BCB/BCI 2.6/0, FCB 4.6/1) create BCD version 1.1.
• ACC 1.7/0 components (APB 2.7/0, BCB/BCI 2.7/0, FCB 4.7/0) create BCD version 1.2.
• ACC 2.0/0 components (APB 3.0/0, BCB/BCI 3.0/0, FCB 5.0/0) create BCD version 1.2.
• CBA 1.0/0 components (APB 4.0/0, BCB/BCI 3.0/0, FCB 6.0/0) create BCD version 1.2.
• CBA 1.1/0 components (APB 4.0/0, BCB 3.0/0/BCI 3.0/1, FCB 6.0/0) create BCD version
1.2.
As a consequence, if the Bus Configuration Database and/or the project is located on a network
drive and accessed by different client PCs, for example, an CBA 1.0/0 client, an ACC 1.6/1
client, and an Advant OPC Server for Advant Fieldbus 100 1.0 or 1.1 client, you may get
“Invalid BCD version” message after upgrading the BCD by access of APB, BCB, or FCB of
CBA 1.0, more exactly by access via Bus Configuration Interface 3.0/0 (BCI 3.0/0).
The reason for the error message is that ACC 1.6/1 and Advant OPC Server for Advant Fieldbus
100 1.0 and 1.1 use an older BCI and an older BCD version. So you have to upgrade also the
client PCs running ACC 1.6/1 and Advant OPC Server for Advant Fieldbus 100 1.0 and 1.1:
• Install CBA 1.1/0, but at least BCB 3.0/0 on them. This is the easy way.
• Or install at least BCI 3.0/1 on them.
At the same time, no upgrade of FCB 4.6/1, FCB 4.7/0, FCB 5.0/0 or FCB 6.0/0 nodes is
necessary to FCB 6.1/0: The Bus Configuration Database can contain bus configuration data
(nodes) generated by FCB 4.6/1, FCB 4.7/0, FCB 5.0/0, FCB 6.0/0 and FCB 6.1/0.
1.6 Restrictions
Not applicable.
Chapter 2 Functionality
2.3.2.1 Update FCB Version does not work for Node/CI/TC if no ODB exist
In case File > Update FCB data > Project.. or File > Update FCB data > Selected is
performed for Node/CI/TC this action don’t work if no ODB exists. The INI file is not changed
not changed.
The action will terminate is terminated with the message “successful, no errors no warnings”
but when you now check the INI files, the OLD FCB version is still stored there. Thus, when
you start FCB on this node you will the following message from APB:
“Starting Node/Circuit/TC was processed with FCB version, newer version available”
The error is independent whether the older FCB version is installed or not, and is independent
whether source code exists already or not.
Normally you will have ODB files for Node, Circuit and Type Circuit but for the CBA Object
Type Library only the TCS files and the INI files will be delivered. Thus, when you need to
upgrade the FCB version for an existing EngineerIT system you will run into trouble.
This can be circumvented by selecting "Modify Tool Version ..." for each Node/CI/TC and
select the new FCB version.
2.3.2.2 APB loops in special station after Modify Tool Version with automatic Update
Version
APB loops when started out of CBA Interface to automatic update the FCB Version of a
Node/Circuit/TypeCircuit within the "More..." Dialog.
Situation when the problem occurs:
• Create object with Circuit Aspect in EngineerIT
• Select Circuit Aspect and Attach a Circuit
• Select Expert Page
• Press Summary Form --> More... -->Tool Versions --> Select FCB version
• --> Check Automatic Update of FCB Data --> OK --> OK ==> LOOP
This has been corrected.
Table 2-1.
Work Around
Upgrade manually, see Application Builder User’s Guide.
Or create a dummy PC or DB section, respectively, in Function Chart Builder before choosing
File | Update FCB Data | … command.
2.4.3.1 Generate Source in Generate DB or Update Parameter with View Function Chart
Generate circuit source code included into Generate DB or Update Parameter with view
Function Chart does not work if Function Chart Builder is started interactively via Open on
view Function Chart.
Work Around
Either use File | Generate Source in Function Chart Builder or use Options | Preferences |
Generate Source Code on Exit in Function Chart Builder, or perform the commands without
having started Function Chart Builder interactively before.
2.4.3.5 Progress Indication for Generate DB, Update Parameter and Initialize
The commands Generate DB, Update Parameter and Initialize regularly show a begin query
message and a final success message. In between only the wait cursor is shown.
Work Around
Perform these commands with Function Chart Builder started up and the corresponding
Function Chart Builder window opened. Then you can see that actions are going on. Further you
see in Function Chart Builder’s status bar that it processes OLE operations.
2.4.3.6 Unnecessary Type Circuit Copies if Copying Objects Between Projects (SR0058)
If you copy or import an Advant object having a Type Circuit aspect from a library project to a
work project, then the type circuit file of the corresponding aspect in the library project will be
copied instead of being referenced. In case that you copy or import such an Advant object a lot
of times you will get a lot of unnecessary type circuit file copies with new file names in the
project local TC-directory of the work project. Furthermore you become decoupled from type
circuit changes in the library project.
Work Around: None
2.5 Recommendations
2.5.1 Installation
TC$LEV1=L:\DATA\LIB11R0\NODES\PR_TC\TCDATA
If you want to reference type circuits in a second library project, set TC$LEV2 accordingly as a
system variable written in uppercase letters.
Example:
TC$LEV2=L:\DATA\EX_LIB2\NODES\PR_TC\TCDATA
2.5.4.4 Logfile / Unattended Operation for Update Parameter, Generate DB, Initialize,
Locate Circuit
To trace results of parameter references and to control unattended operation of the Update
Parameter, Generate DB, Locate Circuit and the Initialize command and the Update
Parameter sequence included into Drag & Drop, two options can be switched on or off by
editing the apb.ini file stored in the ADVABLDENV directory:
...
[SetApbMessage]
PrintLogFile=1 (to write logfile information for one command execution)
or
PrintLogFile=2 (to append logfile information for all following command
executions)
or
PrintLogFile=0 (to switch off)
The logfile is named parfcb.log and was stored in the ADVABLDENV directory in former
versions of APB, beginning with APB 2.7 it is stored on the TEMP directory.
In case of errors the commands show intermediate error message boxes that pause operation as
they have to be confirmed.
To switch off these messages the option
BatchMode=1 has to be set.
To switch off batch mode set BatchMode=0
Beginning with APB 2.7, the options are set by default as follows:
PrintLogFile=2
BatchMode=1
So in most cases there is no need to edit the file.
Make sure that the actual values of symbols are supplied either by default values or by
parameter references.(Actual values supplied during instantiation into the circuit or by
editing symbol values in the TC instances will get lost in Drop and Update Parameter).
For symbol controlled default connections of output terminals to DB element terminals
make sure that the = sign is outside of any symbol used in the default connection
specification.
2. Configure the circuit aspect.
a. Introduce the circuit instance symbol finstance
b. Begin the circuit of this aspect with a FUNCM (or another structure element) and
give this element an instance name defined by the circuit’s instance symbol finstance
(INAME <finstance>).
c. Into the circuit below the structure element instantiate the type circuit(s). Make sure
before you instantiate that the symbol substitution in Function Chart Builder circuit
mode is switched off.
Note that the TC instances do not need to get an instance name. Instance names are given to the
TC instances below the structure element automatically.
Note that the declaration length of the finstance symbol must fit to the length of its contents
generated from basic property name of category Customer ID concatenated with _ (underscore)
and the aspect description of the Circuit aspect.
Note that you can also configure a circuit without using a structure element. Then only one TC
instance is allowed and this TC instance has to get the instance name <finstance>.
If the process object shall be used with the Locate Circuit command, then it must be placed in
the OCS Structure below the node object it will be inserted into, and the relative reference
designation entry in the OCS Structure aspect of the process object must contain the PC item
designation of the insertion point PC element in the node.
2.5.4.6 Configuring an Object for a Library to Create DB Elements by Drag and Drop or
Locate Circuit
1. Configure the DB type circuit. For rules, except the connection-related ones (DB and PC
connections), see Section 2.5.4.5, Configuring a Process Object for a Library.
2. Configure the Circuit aspect.
a. Introduce the circuit instance symbol finstance.
b. Instantiate the DB type circuit into the circuit using an instance name defined by the
circuit’s instance symbol finstance (INAME <finstance>).
Note that only one DB type circuit instance is supported regarding parameter update.
Function Chart, so that Function Chart Builder recognizes the new items. Or, you can use the
Function Chart Builder menu item File | Rebuild Element Types before starting to insert.
Otherwise error messages like “Symbol context for circuit ... cannot be built. Make sure that a
correct circuit file exists.” occur.
Generate DB can be used without having started Function Chart Builder interactively before, as
Function Chart Builder is started invisibly and ended automatically by this command.
2.5.4.15 Drag and Drop or Locate Circuit for Objects with DB Circuit Aspects
Besides drag and drop for circuits that have a PC part, drag and drop for circuits that have a DB
part only is supported, too.
Parameter update for such circuits is supported if they have one DB type circuit instance that
gets its instance name via a circuit symbol named finstance (INAME <finstance>).
Allowed drop destination for DB circuits currently is a PC element in the Tree or the Function
Chart window of Function Chart Builder.
If the object shall be used with the Locate Circuit command, then it must be placed in the OCS
Structure below the node object it will be inserted into, and the relative reference designation
entry in the OCS Structure aspect of the process object must contain a PC item designation of a
PC element of the node.
Note that
• symbol values entered during type circuit instantiation into the circuit,
• edited symbol values of the instantiated type circuit,
• values of symbols that have parameter references that cannot be executed,
• values of symbols that have parameter references that point to empty attributes of
parameter aspects
are overwritten during update via the Update Parameter command.
See Section 2.5.4.18, Switch off Symbol Substitution in Function Chart Builder Circuit Mode
for a possibility to switch off update dependent symbols.
2.5.4.18 Switch off Symbol Substitution in Function Chart Builder Circuit Mode
If you check Substitute Symbols in Default Connections of TC/CI Terminals via the
Function Chart Builder’s Options | Preferences menu command, the symbol substitution for
type circuit instantiation in circuit mode is switched off. This enables the configuration of
circuits especially for library objects without the need to re-introduce the original symbol values
of instantiated type circuits in circuits.
2.5.4.23 Procedure for Alternating Use of Cooperating Mode and Independent Mode
(SR 0075)
Documents describing integration of ACC 1.7/0, ACC 2.0/0 and CBA 1.0 into AEW 1.2
are:
• AMPL Control Configuration Commands for Structure Builder Version 2.7 User’s Guide
3BSE 013 931R301.
• AMPL Control Configuration Commands for Structure Builder Version 3.0 User’s Guide
3BDS 100498R101.
• Control Builder A Commands for Structure Builder Version 1.0 User’s Guide
3BDS 100498R201.
In contrast to the latter, the first document does not describe the application procedures to
be followed on the client PCs of an engineering system configuration for alternating use
of
• the cooperating mode while working with an AEW client PC connected to an
AEW server PC and
• the independent mode while working with the same AEW client PC disconnected
from the AEW server PC.
This scenario applies if you have an inhouse engineering system configuration with AEW and
ACC resp. CBA and you want to extract the ACC resp. CBA part of your project to work with
your AEW client PC disconnected from the AEW server PC out in the plant with ACC resp.
CBA in independent mode for commissioning tasks.
4. Copy your ACC resp. CBA sub-project from the project root on the AEW server PC to the
local ACC resp. CBA project root on the AEW client PC by using the APB menu
command File | Copy … and its Copy dialog with the scope projects.
Figure 2-2. Copy ACC resp. CBA Project From Server Project Root to Local Client Project
Root
After you have selected scope, “From”- project root, - project name, and “To”-project root
and entered “To”-project name, you press the OK button or the arrow button to perform
the copy operation.
5. If you have used project local type circuits, these are already copied by step 4.
If you have used type circuits stored on a directory pointed to by the system environment
variables TC$LEV1 or TC$LEV2, then you have to take care to make them available also
for work with ACC resp. CBA in independent mode disconnected from the AEW server
PC.
Copy the type circuits with the Windows NT Explorer from the corresponding directory on
the AEW server PC to a local directory on your AEW client PC and set the corresponding
system environment variable on the AEW client PC to that directory using the Start |
Settings | Control Panel | System | Environment tab.
6. On the AEW client PC disconnect the mapped network drives mapped to the shares
abtool1 and advabld1, typically drives J: and L: .
CAUTION
Make sure that regarding changes you have an agreement with the project
members that might still work at the AEW project inhouse while you do
commissioning either to do no changes to the ACC resp. CBA -part or that
changes are logged carefully and in detail in a list of changes.
It is highly recommended to define the proceeding in a project team for all typical
change cases inhouse and out in the plant before doing the commissioning work.
Remark
For extracting only parts of the ACC resp. CBA project for commissioning (for example, a
node) the same steps apply, except the following:
• A local project on the AEW client PC has to be created as container for the parts.
• The parts have to be copied into this project using the APB Copy dialog on each part using
the corresponding scope (nodes, circuits, or type circuits).
Make sure that all your changes are logged carefully and in detail in a list of changes.
Depending on the changes done there will be some additional effort to bring back the
commissioned project into AEW cooperating mode.
In any case use the File | Copy (for project, nodes, type circuits, and circuits) command of APB
and back-up/restore functionality of Windows NT to save project data before changing.
Depending on the changes you have made during commissioning the next steps differ:
2. Now the node objects in the original AEW project contain the changes of the
commissioned project and you can work on in the AEW project.
Chapter 3 Installation
3.1 Installation
NOTES
Every locally installed Application Builder requires one license.
The complete Application Builder setup is described in the Control Builder A Release Notes.
Application Builder 4.1/0 needs BCI (Bus Configuration Interface) >= 3.0/1. It will silently
install BCI 3.0/1. In due case, if BCI exceptions, like “Invalid BCD version” occur, you can
manually install BCI 3.0/1 there, for example, by opening the installation disk CD1 by the
Windows NT Explorer, and double-clicking on the \AdvaBld\apb\40r0\bci\disk1\setup.exe
file, and confirming the dialog boxes appropriately. You can check installation of BCI by
a. Searching for files ..\program files\common files\advabld shared\bci.dll and
bci30.dll
b. Checking its properties and its version. Version should >= 3.0/1.
BCI needs Data Access Object utility (DAO 3.5). It will silently install the newest DAO 3.5.
In due case, if DAO exceptions occur, you can install DAO 3.5 manually, see Control Builder A
Release Notes.
3.2 Upgrading
If you have older versions of Application Builder installed, the new version will be installed in
parallel.
Projects created with the 16-bit version of Application Builder may contain a file named
foot001.tpx. The file applies to the 16-bit version of Application Builder. The file you have
selected in the File | New | Project dialog will be copied from the ADVABLDENV directory to
the project as foot001.tpx during creation of a project. If you want to print out data of projects
created with the 16-bit version of Application Builder, copy the foot001.tpx file from the
ADVABLDENV directory to the project.
If you do not copy the new file to the project created with the 16-bit version of Application
Builder it may happen, that the logo is missing, or is drawn in an extraordinary size. If you
created your own logo file, you may need to modify your own *.tpx and *.wmf file, so that your
logo is drawn correctly.
3.4 Un-install
Un-install is provided via the Add/Remove Programs icon in the Control Panel. To uninstall
Application Builder, select the Install/Uninstall tab, select the Application Builder version you
want to uninstall, e.g. Application Builder 3.0/0, and click Add/Remove to uninstall it.
If you performed a server installation, the entry is called e.g. Application Builder 3.0/0 Server.
During Un-install you may be asked a question like the following:
NOTE
Be sure to answer the question with NO for the following files:
MFC42.DLL
MFC42U.DLL
MSVCIRT.DLL
MSVCRT.DLL
MSVCRT20.DLL
MSVCRT40.DLL
ATL.DLL
These file are core components needed by Windows NT to run properly. Other
files may be deleted as they are used by Control Builder A components.
Chapter 4 Miscellaneous