Remote Automation Solutions Manual: Bristol ACCOL Workbench User Manual Manuals & Guides

sto

abcock

ACCOL Workbench

User Manual

Bri

Version: 8.3 D4051 – September, 2004

l B

NOTICE

The information in this document is subject to change without notice.
Every effort has been made to supply complete and accurate information.
However, Bristol Babcock assumes no responsibility for any errors that
may appear in this document.

Bristol Babcock does not guarantee the accuracy, sufficiency or suitability
of the software delivered herewith. The Customer shall inspect and test
such software and other material s to his/her satisfaction before u sing them
with important data.

There are no warranties, expressed or implied, including those of
merchantability and fitness for a particular purpose, concerning the
software and other materials delivered herewith.

Additional copies of instruction manuals may be ordered from the address
below per attention of the Sales Order Processing Department. List the
instruction book numbers or give the complete mod el, serial or software
version number. Furnish a return add ress that includes the name of the
person who will receive the material. Billing for extra copies will be
according to current pricing schedules.

ACCOL is a trademark and Bristol is a registered trademark of Bristol
Babcock. Other trademarks or copyrighted products mentioned in this
document are for information only, and belong to their respective
companies, or trademark holders.

Copyright (c) 2004, Bristol Babcock, 1100 Buckingham St., Watertown,
CT 06795. No part of this manual may be reproduced in any form without
the express written permission of Bristol Babcock.

SECTION 2 – ODD HEADER

A Few Words About Bristol Babcock

For over 100 years, Bristol has been pro viding innovative solutions for the measurement and
control industry. Our product lines range from simple analog chart recor der s, to so phisticated
digital remote process contr ollers and flow computers, all the way to turnkey SCADA systems.
Over the years, we have become a leading supplier to t he electro nic gas measurement, water
purification, and wastewat er treatment industries.

On off-shore oil platforms, on natural gas pipelines, and maybe even at yo ur local water company,
there are Bristo l Babcock instruments, cont r ollers, and systems running year-in and year-out to
provide accurate and timely data to our customers.

Getting Additional Information

In addition to the info r mation contained in this manual, you may receive additional assistance in
using t his product from the following sources:

Help Files / Release Notes

Many Bristo l Babcock softwar e pr oducts incorporate help screens. In addit ion, t he so ftwar e
t ypically include s a ‘read me ’r elease note s file detailing ne w fe ature s in the p rod uct, as well as
o th er info rma tion which w as available too late for inclusio n in the manual.

Contacting Bristol Babcock Directly

The address for our world headquarters is:

Bristol Babcock
1100 Buckingham Street
Watertown, Connecticut 06795 USA

Our main phone numbers are: [phone]

[phone] (FAX)

Regular office hours are Monday through Friday, 8:00AM to 4:30PM Eastern Time, excluding
holidays, and scheduled facto r y shutdowns. Dur ing other ho ur s, callers may leave messages using
Bristol's voic e mail system.

Telephone / E-Mail Support - Technical Questions

During regular business hours, Bristol Babcock's Application Suppor t Group can provide
telephone/e-mail support for your technical questions.

i

2/2004

SECTION 2 – EVEN HEADER

Please refer t o the table, below, for a list of products, and their associated technical support
contact information:

Product Support Phone

Number(s):

Contr olWave series (hardware a nd software) [phone]

[phone]
Network 3000 hardware except for TeleFl ow
series

TeleFlow series (3530-xx) [phone].

ACCOL, Open BSI, U OI, all other software
except for ControlWave and OE.

OpenEnterprise (OE) software [phone]

Radio telemetry services (interfacing Bristol
Babcock hardware to radios)

[phone]

[phone]

[phone]

[phone].

E-Mail Address:

[e-mail]

[e-mail]

[e-mail]

[e-mail]

[e-mail]

[e-mail]

The Application Support Group also maintains an area for registered users of our web site that
includes technical support information. Go to: www.bristolbabcock.com/services/

Telephone / E-Mail Support - Non-Technical Questions, Product Orders, etc.

Questions of a non-technical nature (p r oduct o r der s, literature r equests, price and delivery
information, etc.) should be directed to t he nearest sales office (listed on the back cover of this
manual) or to your Bristol-aut ho r ized sales representative. Please call the main Bristol Babcock
number (860-945-2200) if you ar e unsure which office covers your particular area.

Visit our Site on the World Wide Web

For general information about Bristol Babcock and its products, please visit our site on the World
Wide Web a t: www.bristolbabcock.com

Tra ining Courses

Bristol Babco ck ’s Tr aining D epar tment offers a wide variety of co urse s in B ris tol hardware and
software at our Watertown, Connecticut headquarters, and at selected Bristol regional offices,
throughout the year. Contact o ur T r aining Department at [phone] for cour se information,
enrollme nt , pricing, and sche du les.

2/2004 ii

Who Should Read This Manual?

This manual is intended for the ACCOL programmer, who will be using ACCOL
Workbench to create an ACCOL source file.

It assumes familiarity with the following subjects:

!

!

!

The ACCOL II programming language. See An Introduction to ACCOL
(document# D4056) and the ACCOL II Referen ce Manua l (document# D4044)
for details.

Use of personal computers, the DOS operating system, and the Windows™
user-environment. Users should be familiar with how to point and click with
a mouse, how to dou ble-cli ck, how to en ter data i n dia log box es, and how to
use scroll bars, list boxes, pull down menus, etc. See your Windows™
documentation fo r details o n these subjects.

Open BSI Utilities software, which is necessary for downloading, and on-line
communication. See the Open BSI Utilities Manual (document# D5081) for
details.

Variations between Windows™ Versions

The screens presented in this manual may appear slightly different
depending upon which version of Microsoft® Windows™ you are using. For
example:

1) Titles, and names in title bars, may appear centered,
instead of left justified.

2) Certain Windows dialog boxes for opening files, etc. may
have slightly different names, and may have different
labels on push buttons, for example [OK] instead of
[Open].

There may be other minor variations; in general, the differences should be
self-explanatory.

iii

BLANK PAGE

Table of Contents

Chapter 1 - Introduction - W ha t is ACCOL Wor k b enc h?........................................................1-1

What is a n ACCO L Sour c e F il e?..................................................................................1-1

Summary of F i l es G ener a ted By ACCOL Wor kbench......................................1-2

Chapter 2 - Ins talling ACCOL Workb enc h on the PC.............................................................2-1

Chapter 3 - Starting ACCO L W or k b enc h................................................................................3-1

Methods For Cr ea ting An ACCOL Sourc e F i le............................................................3-2

Chapter 4 - Quickstart For Experienced Users.......................................................................4-1

Chapter 5 - Cr ea ting, Editing, and Sa vi ng A N ew ACCO L Sour c e F il e..................................5-1

ACCOL Source Fil e Sec t i ons........................................................................................5-2

Editing the Source Code Directly.....................................................................5-3

Typing In New Text .........................................................................................5-4

Cutting, Copying, and Pasting Text.................................................................5-4

Finding and/or Replacing Text.........................................................................5-5

Editing the Properties of the Section...............................................................5-6

Saving the N ew ACCO L Sour c e Fi l e ...........................................................................5-7

Saving Subsequent Changes........................................................................................5-8

Deleting A Sec tion of the ACCOL Sour c e F il e .............................................................5-8

Opening An Exis ting ACCOL Sourc e F il e ...................................................................5-8

Closing An ACCOL Sour c e F i le a nd Ex i ting ACCOL Workbench ...............................5-9

Chapter 6 - Specifying the Target Node Type (*TARGET section).........................................6-1

Editing the *TARGET section properties (Edit Properties Mode) ...............................6-1

Editing the Source Code Directly (Edit Code Mode)....................................................6-1

Chapter 7 - Defining Passwords (*SECURITY-CODES section) ............................................7-1

Password Encryption...................................................................................................7-2

Changing Passwords in Edit Properties Mode ............................................................7-3

Chapter 8 - Defining Communication Ports (*COMMUNICATIONS Section) .......................8-1

General Instruc tions for Editing the Properties of the *COMMUN ICATIONS Sect ion

(Edit Properties Mode).....................................................................................8-1

Editing the Source Code Directly (Edit Code Mode)....................................................8-2

Defining A Master Port In Edit Properties Mode........................................................8-3

Defining A Master Port in Edit Code Mode.................................................................8-4

Defining An Expanded Addressing Master Port in Edit Properties Mode ..................8-5

Defining An Expanded Addressing Master Port in Edit Code Mode...........................8-6

Defining A Serial CFE Port in Edit Properties Mode .................................................8-8

Defining A Serial CFE Port in Edit Code Mode...........................................................8-8

Defining A Slave, Pseudo-Slav e, or Pseudo- Slave with Al arms Port in Edit P roperties

Mode.................................................................................................................8-9

Defining A Slave, Pseudo-Slave, or Pseudo-Slave with Alarms Port in Edit

Code Mode........................................................................................................8-9

Defining A VSAT Slave Port...................................................................................... 8-11

Defining A VSAT Slave Port in Edit Code Mode.......................................................8-11

Defining An RIOR Port in Edit Properties Mode.......................................................8-12

Defining An RIOR Port in Edit Code Mode ...............................................................8-13

v

Defining A Logger Port in Edit Properties Mode.......................................................8-14

Defining A Logger Port in Edit Code Mode ...............................................................8-14

Defining A Custom Port in Edit Properties Mode.....................................................8-16

Defining A Custom Port in Edit Code Mode..............................................................8-16

Defining An Optional Comm (TANO) Port in Edit Properties Mode......................... 8-18

Defining An Optional Comm (TANO) Port in Edit Code Mode.................................8-18

Defining A Columbia Natural Gas Port in Edit Properties Mode.............................8-19

Defining A Columbia Natural Gas Port in Edit Code Mode......................................8-19

Defining An Internet Protocol (IP) Port in Edit Properties Mode.............................8-21

Defining An Internet Protocol (IP) Port in Edit Code Mode......................................8-21

Defining Additional Buffers in Edit Properties Mode................................................8-22

Defining Additional Buffers in Edit Code Mode ........................................................8-22

Defining Parameters For An IP Custom Protocol in Edit Properties Mode .............. 8-23

Defining Parameters For An IP Custom Protocol in Edit Code Mode.......................8-25

Chapter 9 - Specifying Memory Requirements (*MEMORY section)......................................9-1

Specifying Mem or y i n Ed i t Properties Mode
Specifying Mem or y i n Ed i t Properties Mode

(386EX Protected Mode Units ONLY).............9-1

(186 & 386EX Real Mode U nits ONLY)...........9-3

Specifying Memory in Edit Code Mode ( 386EX Protected Mod e Units ONLY) .....................9-5

Specifying Memory in Edit Code Mode ( 186 & 386EX Real Mode Units ONLY )...................9-8

Chapter 10 - Declaring Process I/O Boards (*PROCESS-I/O Section).................................. 10-1

Declaring Process-I/O Boards in Edit Properties Mode.............................................10-1

Declaring Process I/O Boards in Edit Code Mode......................................................10-2

Chapter 1 1 - D ef ini ng Low - L ev el Boa r d Inputs ( *LO W - L EVEL Sec tion).............................11-1

Creating the *Low-Level Section...............................................................................11-1

Chapter 12 - Creating ACCOL Signals (*SIGNALS section) ...............................................12-1

Signal Names.............................................................................................................12-1

Signal Characteristics...............................................................................................12-2

Defining New ACCO L Sig na ls...................................................................................12-2

Settings for Logical Signals ...........................................................................12-3

Settings for Logical Alarm Signals................................................................12-6

Settings for Analog Signals ...........................................................................12-8

Settings for Analog Alarm Signals .............................................................. 12-10

Settings for String Signals ..........................................................................12-13

Editing Signal Characteristics.................................................................................12-15

Creating New Signals From Existing Signals.........................................................12-16

Deleting An ACCOL Si gna l .....................................................................................12-16

Defining Base Name Text For Signals.....................................................................12-18

Chapter 13 - Defining Signal Lists........................................................................................13-1

Chapter 1 4 - Cr ea ting An ACCOL Tas k (*TASK Sect i on) ....................................................14-1

Editing the Task Characteristics Line (Edit Properties Mode).................................14-1

Editing the Task Characteristics Line (Edit Code Mode)..........................................14-1

Inserting Modules In The Task .................................................................................14-3

Entering Signal Names..............................................................................................14-4

Getting Help on Configuring A Particular Module....................................................14-5

Customizing the Module Menu to Include Frequently Used Modules.......................14-6

Re-sequencing the Line Numbers For Modules in the Task...................................... 14-7

vi

Going to a Particular Line of the File........................................................................14-8

Searching for Items Throughout the Entire Source File............................................14-8

Undoing the Last Keystroke(s)..................................................................................14-9

Deleting Text From the Current Cursor Position to the End of the Line................14-10

Removing Unused Module Terminals...................................................................... 14-10

Defining A Signal’s Type From Within A Module or Task (Check-in Feature) .......14-11

Chapter 1 5 - D ef i ning D a ta Arrays ( *A- ARRAY and *L-ARRAY sections)...........................15-1

Read Write Arrays..................................................................................................... 15-2

Read-Only Arrays......................................................................................................15-2

Example 1 - Initializing An Entire Read-Only Array...............................................15-3

Example 2 - Initializing Individual Cells In A Read-Only Array.............................15-4

Modifying Arrays In Edit Code Mode........................................................................15-4

Chapter 16 - Defining Communication FORMATS (*FORMAT Section)..............................16-1

Chapter 1 7 - D ef ini ng Ar c hiv e F il es ( *ARCHIVE Sec tion).................................................... 17-1

Archive Definition in 3305 and 386EX PM Units......................................................17-1

Archive Definition in 3530-series Units.....................................................................17-4

Archive Calculation Formulas...................................................................................17-7

Chapter 18 - Using the BUILD Command to Generate ACO and ACL Files ....................... 18-1

Using the Batch Build Feature..................................................................................18-3

Chapter 19 - Using the DOCUMENT Command to Generate an LST File .......................... 19-1

Signal Cross-Reference..............................................................................................19-1

Load Statistics...........................................................................................................19-1

Memory Usage and Memory Map..............................................................................19-2

Chapter 20 - Rever s e Com p iling a n ACO F ile to Get an ACC File .......................................20-1

Performing A Batch Reverse.....................................................................................20-1

Chapter 2 1 - O perating ACCO L W or kbench in On-L i ne Mod e............................................21-1

Activating the Downloader........................................................................................21-2

Starting Debug Mode.................................................................................................21-2

Exiting Debug Mode..................................................................................................21-2

Determining the Ed iting Capabilities F or the Current ACCOL Loa d.......................21-3

Summary of Debugging Techniques..........................................................................21-3

Using Deb ug gi ng F la g s i n a n ACCO L T a s k ..............................................................21-6

Accessing the ACCOL Tas k ............................................................................21-7

Setting a Breakpoint......................................................................................21-8

Setting an Abort.............................................................................................21-9

Setting a Skip...............................................................................................21-10

Using Step Mode..........................................................................................21-11

Clearing All Debug Flags in a Task.............................................................21-12

Viewing, Setting, and Clearing Debug Flags...............................................21-12

Viewing the Error Array Window............................................................................21-14

Viewing and Changing Data On-Line.....................................................................21-16

Methods for Changing Data.........................................................................21-16

Using the Watch Window.............................................................................21-17

Using the Change Signal Value Dialog Box.................................................21-20

Toggling Signal Inhibit/Enable Bits............................................................. 21-20

Conducting A Signal Search.........................................................................21-21

vii

Using the Signal Detail Window..................................................................21-21

Changing Values in a Read/Write Data Array .............................................21-22

Changing the Floating Point Format of Data ..............................................21-23

Toggling t he F i r s t Column of an Arr a y Between Analog and

Timestamp Data ...............................................................................21-23

Keeping Column 1 Visible While Scrolling Through an Array.....................21-23

Editing ACCO L Loa d Struct ur es O n- L ine..............................................................21-24

Changing Values in a Read-Only Data Array.............................................21-25

Editing Titles and Signals in an Archive Definition....................................21-26

Editing A Format......................................................................................... 21-27

Editing A Signal List....................................................................................21-28

Editing Module Terminals and Calculator Equations in a Task ................. 21-29

Updating Initia l Val ues i n Your ACCOL Source F il e ..................................21-30

Saving Changes to the Source File on the Hard Disk..................................21-30

Appendix A - Upgrad ing ACCO L Sour c e F il es f r om P r ev i ous Ver s i ons

or Using Files in different CPU Platforms......................................................A-1

Appendix B - L i s ting of ACCOL Mod ules & Control Statements ..........................................B-1

Appendix C - Keyboard Shortcuts ..........................................................................................C-1

Appendix D - Customizing the User Environment.................................................................D-1

Viewing Open BSI Setup Parameters.........................................................................D-1

Turning On/Off the Tool Bar ......................................................................................D-1

Turning On/Off the Status Bar................................................................................... D-1

Opening/Closing the Output Window.........................................................................D-1

Opening/Closing the Watch Window..........................................................................D-2

Re-Arranging the Windows on the Desktop................................................................D-2

Using the Workspace Settings Dialog Box.................................................................D-2

Setting File and Backup Parameters..............................................................D-2

Setting the Line Numb er s i n ACCO L Ta sks...................................................D-4

Specifying Parameters For On-Line Operation..............................................D-5

Specifying Refresh Rates For On-Line Windows............................................D-6

Changing the F onts Used i n ACCO L Wor kbench Code Windows...................D-7

Choosing Which Warning Messages Should Be Displayed .............................D-8

Using Filters To Limit Which Signals Are Displayed in Signals Window................D-10

Sorting Signals Alphabetically in the Signals Window............................................D-12

Turning ON/OFF Signal Filtering............................................................................D-12

Restoring A Backup File...........................................................................................D-12

Appendix E - Using Initial Value Scan - Valscan...................................................................E-1

Appendix F - *DEFINE and *INCLUDE Statements............................................................F-1

Text Substitution Using *DEFINE.............................................................................F-3

Text Insertion Using *INCLUDE............................................................................... F-4

Glossary.................................................................................................................................. G-1

viii

Notational Conventions In Syntax Boxes

This manual includes numerous syntax boxes which define the syntax rules for
editing particular sections of the ACCOL source file. The notational conventions
within syntax boxes are different from those in the rest of the text.

Syntax Rules - *PROCESS-I/O Section

Within the syntax box, the following notational conventions apply:

bold text should be entered exactly as shown
italic text indicates a place where the ACCOL programmer must

substitute a particular value, or entry. Possible entries for
this value are then listed.

[text in brackets] indicates optional fields, which need not be entered,

unless that particular option is required. DO NOT type
the brackets.

ix

Chapter 1 - Introduction: What is ACCOL Workbench?

ACCOL Workbench is a Windows™-based software tool that allows you to create,
modify, and document an ACCOL source file, and to build an ACCOL lo ad file . If
your Network 3000-series controller model supports it, you can also perform on-line
operations through ACCOL Workbench includin g downloading, deb ugging, and on­line changes to d ata and ACCOL structures.

What is an ACCOL Source File?

The ACCOL source file defines the programming instructions which will be used by
a Bristol Babcock Network 3000-series remote process controller.

The ACCOL programmer chooses whichever specific programming instructions
(ACCOL modules, signals, control statements, etc.) are necessary for the intended
user application, and enters them in the ACCOL source file, using ACCOL
Workbench, or any ASCII text editor.

The source file, when completed, is
compiled and linked using the ACCOL
Workbench "Build" command.

The build process translates the
programmer's instructions into an
intermediate ACCOL Object File and a
final ACCOL Load File. The ACCOL
Load File contains the original
programming instructions in a machine­readable format which can be executed by
the Network 3000-series controller. In
order for the controller to execute the
instructions, however, the ACCOL Load
File must be downloaded into the
controller's memory using the Open BSI
Downloader.

Any errors detected during the build process are reported, within ACCOL
Workbench, and in a listing fi le. ACCOL Workbench allows the programmer to go
directly to the line which caused the error. Once the p rogrammer has corrected the
errors, the "Build" command can be initiated again.

ACCOL Workbench User Manual Introduction1-1

A summary of the diff erent types of f iles used by ACCOL Workbench is presen ted
in the table below. The f iles created by ACCOL Workbench use the file extensions
listed in the table.

Summary of Files Gene rated By ACCOL Workbench

File

Description
Extension
.ACC

This extension indicates an ACCOL s ource file. An ACCOL source

file is in ASCII format, and may be edited, according to pre-defined

syntax rules, by any ASCII text editor, or by ACCOL Workbench.

The ACCOL programmer defines, within the ACC file, the ACCOL

modules, signals, statements, and structures which will be used to

program the Network 3000-series controller for its intended

application. The ACC file cannot be used directly by the Network

3000 controller, therefore, it must be compiled and linked to

generate an ACCOL Object file, and an ACCOL Load fi le.

Backups of ACCOL source f iles, when the Backup feature has been

activated through the Workspace Settings dialog box, are named

using the file base name, with the add ition of an underscore ’ _’ a nd

a 3 digit version number. The same file extension (.ACC) is used . For

example, if there is an ACC file named MYFILE.ACC, its first

backup file would be named MYFILE_001.ACC.

NOTE: These backup files are for previous versions of the source fi le.

Users should always save a cop y of thei r curren t ACCOL source fi les

on a separate diskette to guard against a hard disk failure.
.ACO

This extension indicates an ACCOL object file. An ACO file is

created when a "Build" command is issued from within ACCOL

Workbench, and is an intermediate step in the creation of an

ACCOL load file. The ACO file is used by the Open BSI Utilities for

various purposes, and shares the same file base name as the ACC

file it was created from.
.ACL

This extension indicates an ACCOL load file. It contains, in a

machine-readable format, the ACCOL modules, statements, and

structures defined in the ACC file. The ACL fil e is the final output of

the "Build" command. It is downloaded into the memory of the

Network 3000-series controller using the Open BSI Downloader.

Once in memory, the modules and statements in the ACL file are

executed by the Network 3000-series controller.
.LIS This extension indicates a listing file. The listing file contains any

error or status messages which occur as a result of executing the

"Build" command. If the listing option is active, this file may also

include a tabulated listing of the ACCOL source file (.ACC). If the

cross-reference option is active, this file may also include a simple

cross-reference of the signals used in the file.

Introduction ACCOL Workbench User Manual1-2

File

Description
Extension
.LST This extension indicates a documentation file, which contains a

complete listing of the ACCOL source, as well as a signal cross

reference, and various load statistics. It is crea ted by executing the

"Document" command.

ACCOL Workbench User Manual Introduction1-3

BLANK PAGE

Chapter 2 - Installing ACCOL Workbench on the PC

ACCOL Workbench software is installed as part of the standard Open BSI Utilities
installation. Select the "ACCOL Workbench" option when running the installer
from the Open BSI CD ROM. See Chapter 2 of the Open BSI Utilities Manual
(document# D5081) for details.

NOTE: ACCOL Workbench is generally NOT backward-compatible, i.e. once you

edit an .ACC file in a given version of ACCOL Workbench, structures may
change such that it CANNOT be readily edited within an earlier version of
ACCOL Workbench.

ACCOL Workbench User Manual Installation

2-1

BLANK PAGE

Chapter 3 - Starting ACCOL Workbench

L



1

To start ACCOL Workbench, click as follows:

StartÅ ProgramsÅ OpenBSI T oolsÅ Workbench.

Once started, a window, with the words ’Accol Workbench’ in the title bar, will
appear on the screen.

7

WOHEDU

0HQXEDU

7RROEDU

6WDWXV

EDU

IMPORTANT: If this is the very first time ACCOL Workbench has been
started on this particular computer, you will be prompted to register the
software. Otherwise, the software can only be used for a maximum of 30
days. For m ore information on t he registration process, see Chapter 2 of
the Open BSI Utilities Manual (document# D5081).

ACCOL Workbench fu nctions can be activated by clickin g on the menu bar items,
and selecting choices from pull-down menus. Some items are also accessible by
clicking the right mouse button, and choosing from p op-up menus.

In addi tion to access f rom the me nus, certain opti ons may also be selected from the

1

If you are using Open BSI 3.0 (or newer), you can also start ACCOL workbench by clicking on the icon
for a particular RTU in NetView, pressing the right mouse button, and choosing “RTU” and then
“Workbench” from the pop-up menus.

ACCOL Workbench User Manual Starting ACCOL Workbench3-1

tool bar. Positioning the mouse over a particular tool bar icon will cause a label to
be displayed, indicating the function of that tool bar icon. Click on the icon to
activa te the function.

Finally, keyboard shortcuts are available for th e most common fu nction s. Th ese are
discussed in Appendix C.

ACCOL Workbench status messages appear, pe riodically, in the Status Ba r.

2

ACCOL Workbench allows you to have mul tip le windows open, allowing you to view
different sections of the same ACCOL source file, or more than one ACCOL source
file, simultaneously, and to switch between them quickly.

Methods For Creating An ACCOL Source File

There are two basic methods availab le to create an ACCOL source file.
Method 1: Open an existing ACCOL source (ACC) file, and save it under a

different na me. Then edit the ACCOL source fil e to fit your particular
application, either with ACCOL Workbench, or with any ASCII text
editor.

NOTE: If you intend to modify an ACC file from an earlier version of ACCOL Tools
(Version 5.13 or earlier), this may generate syntax or parsi ng errors when brough t
into ACCOL Workbench. Please review the instructions in ’Appendix A - Upgrading
Old ACCOL Source Files’ for details.

Method 2: Create an all n ew ACCOL source file using ACCOL Workbench . This

process is discussed in detail in the sections that follow. Experienced
ACCOL programmers may wish to read the ’Quickstart For
Experienced Users’ (Chapter 4) which provides a quick overview of
using ACCOL Workbench. Other users who are unfamiliar with the
syntax rules for ACCOL source files should start with ’Creating,
Editing, and Saving A New ACCOL Source File’ (Chapter 5). That
chapter, and the chap ters that follow i t, describe in detail the synta x
rules for each p art of the ACCOL Source File.

IMPORTANT NOTE FOR EITHER METHOD

The output files (.ACO, .ACC) created by ACCOL Workbench ARE
INCOMPATIBLE with DOS-based version s of the ACCOL Tools (AIC5, ABC5,
REV5, etc.)

2

If desired, either the Tool Bar, Status Bar, or both, may be removed from the screen by de-selecting
them on the View pull down menu.

Starting ACCOL Workbench ACCOL Workbench User Manual3-2

Chapter 4 - Quickstart For Experienced Users

This section assumes that ACCOL Workbench software, and Open BSI standard
utilities software, have already been installed on the PC Workstation.

The next few pages a re in tend ed to g et you started ; if you run i nto p robl ems wi th a
particular step, refer to other sections of the manual for more detailed explanations.

As you navigate through the ACCOL Workbench software, you can
access on-line help via the "Help" menu bar item. There is also
context-sensitive help, in which you point at the item for which you
need help. Context-sensitive help is accessible through the icon shown
at left. You can also obtain context-sensitive help, for the currently
selected item or dialog box, by pressing the [F1] key.

Step 1 - Start ACCOL Workbench

Click on StartÅProgramsÅOpenBSI T oolsÅWorkbench

1

Step 2 - Open A New ACCOL Source File

Click on FileÅNew, -OR- click on the new file icon, shown at left.

A dialog box will appear which
requires you to choose whether your
Network 3000-series controller is a
Real Mode unit, or a Protected Mode
unit. (This depends upon the type of
CPU board installed in the controller.)
Choose the appropriate controller
type, and click on [OK], and a new
ACCOL source file will be opened.

1

For information on installation of ACCOL Workbench, see Chapter 2. For information about Open BSI
Utilitie s software, see the Open BSI Utilities Manual (docu m ent# D5081).

ACCOL Workbench User Manual Quickstart for Experienced Users4-1

The new file will be called ACCOL.ACC and will include either a ’PM’ for Protected
Mode, or an ’RM’ for Rea l Mode in the ti tle bar. (You sh ould rename it later, wh en
you save the file.)

You’ll noti ce that the file comes with certain sections pre- defined, each of whi ch is
represented by an icon. There are icons for the target node type, memory,
communication ports, security codes, process I/O, signals, base names, and Task 0.
Additional sections for tasks, low-level I/O, formats, archive files, data arrays, and
signal lists can be added as necessary. (We will discuss this in step 5).

In general, a section can be edited in one of two ways:
a) double-click on the icon for the section; this will call up a dialog box, or a

window, in which you can make selections or enter data for the section. This
is called ’editing the properties’ of the section.

b) click on the icon for the section; then click on EditÅCode. This calls up a

window with the actual ACCOL source code for th e section. This source code
follows a strict set of syntax rules which are discussed later in this manual.
This method of editing is called ’editing the code’ of the section.

NOTE: You also have the option of clicking on ce on the icon for a section, and then
pressing the right mouse key. A pop-up menu will allow you to choose whether you
want to edit the code, or the properties, of the selected section.

IMPORTANT

Whichever of these editing methods you use, it is important to remember that ACCOL

Workbench DOES N OT VALIDATE the source cod e you create; it on ly checks f or basic

syntactic errors. Other errors may only be detected during a "Build" operation.

Quickstart for Experienced Users ACCOL Workbench User Manual4-2

Step 3 - Define Communication Ports, Memory, and Process-I/O Boards

Each of these sections are accessed
by double-clicking on the
appropriate icon, and entering
values in dialog boxes or windows.
For purposes of this explanation we
will show how to define process I/O
boards; the basic methods for
defining communication ports and
memory are similar.

Double-click on the Process I/O icon, shown at left. The dialog box
shown above will appear.

Next, select the kind of board which resides in the f irst slot from the " Boa rd Type "
list box.

Click on the [Insert] push button, and the board will be added to the list of boards.
Repeat this process for each and every board. Boards should be defined in

ascending order based on their slot number in the Network 3000 controller.
To change the definition of a board in the list, click on the board en try in the list,

make any n ecessa ry cha ng es to th e "Board ID" and "Board Ty pe" fields, and click
on the [Modify] pu sh button.

To delete a board def inition, cl ick on the bo ard entry in the list, th en click on the
[Remove] push button. You will be prompted to confirm deletion of the board
definition. Click on [Yes] to proceed, or [No] to cancel the deletion request.

When you are finished editing, click on [OK] to exit the dialog box.
If desired, the resulting source code may be viewed and edited by clicking on the

’Process-I/O’ icon, then clicking on Edit Å Code, -OR- by clicking on the ’Edit Code’
icon (the pencil).

ACCOL Workbench User Manual Quickstart for Experienced Users4-3

The actual source code for the *PROCESS-I/O section, as currently defined, will
appear on the screen, and may be directly edited accord ing to ACCOL syntax rules,
defined elsewhere in this manual.

*PROCESS-I/O

1 8DI
24AI
32AO
48DO

Close the window, when finished editing.

Step 4 - Create ACCOL Signals

It is recommended that signals either be explicitly defined first in the *SIGNALS
section, before they are used in signal lists or module templates, or that they be
‘checked in’ when entered in a module or task through the Check-in feature (see
Chapter 1 4.) This i s becau se si gnal s ente red in modu le templa tes ( see Step 5) or in
signal lists, are assigned their signal type (logical, logical alarm, analog, analog
alarm, or string) during the "Build" process based on the context in which the
signal is used. If the type of signal required cannot be determined by its usage, it
will be defined as a logical signal, which may not be the desired signal type for your
particular application. An advantage of defining signals first in the *SIGNALS
section is that they may be dragged from the *SIGNALS window, directly to a
module terminal, or signal list, thereby reducing the need to re-type signal names.

To create a new ACCOL signal,
double-click on the signals icon.
The Specify Signal Filter window
will appear.

Click on [OK], an empty signal
window will appear.

Quickstart for Experienced Users ACCOL Workbench User Manual4-4

Next, click on Edit Å Insert (Or press the right mouse bu tton, and select "Add
Signal" from the pop-up menu.) In either case, the Signal Properties dialog box

will appear.
Type the signal base name in

the "Base Name" field, the
signal extension (if used) in
the "Extension" field, and the
signal attribute (if used) in
the "Attribute" field.

The type of signal (analog,
analog alarm, logical, logical
alarm, or string) is selected
from the "Type" list box.

To specify a different security
level for operator read access
to this si gnal, en ter a number
(from 1 to 4) in the "Read
Security" field.

To specify a di fferent security leve l for operator access to cha nge (i.e write to) thi s
signal, enter a number (from 1 to 4) in the "Write Security" field.

To manually enable the signal, the "Manual Enable" check box must be selected
(which is the d ef au lt ch oi ce) . To man u al ly in h ib it th e sig na l , th is ch e ck b ox mus t be
de-selected.

To control enable the signal, the "Control Enable" check box must be selected
(which i s the default choi ce). To control inhibi t the signal, this ch eck box must be
de-selected.

Click on the "Settings" tab to specify other characteristics of the signal, such as its
initial value, units or ON/OFF text, etc. The settings required vary somewhat
depending upon the type of signal being defined.

When finished defining the signal, click on [OK] to exit the Signal Properties di alog
box.

If multipl e sig na ls are to b e d ef in ed wh i ch sh are the sa me ch ara cteri sti cs, the y ma y
be created using the Duplicate feature, which is available via the Edit pull down
menu.

ACCOL Workbench User Manual Quickstart for Experienced Users4-5

Step 5 - Insert New Sections For Tasks, Lists, Arrays, etc.

To insert a new section, close the section
you are currently editing first. New
sections must be explicitly created for each
data array, archive file, signal list, task,
format, or low-level board. For purposes of
illustration, we will show how to add a new
ACCOL task to the source file. New
sections are added by clicking on Edit

Å

Insert. In the list box, select ’Task’ as the
type of section to be added, and click on
[OK].

A Configure Task dialog box will be
displayed which allows you to
configure the first line of the task.
Specify a task rate, priority, and, if
applicable, a redundancy frequency.
Click on [OK].

The Task Window will now be opened,
showing the first line, as you just
configured it.

To insert ACCOL modules into the task, p osition the cursor on the lin e where you
would like to add the module.

Click on ModulesÅInsert. The Select Module dialog box will appear.
Use the scroll bar to view the different

module names. Click on the name of the
module you would like to insert. If you are
choosing an I/O module with interleaved
terminals such as INPUT 1, INPUT 2
INPUT 3, etc. enter the number of sets of
interleaved terminals in the “N umber of
Terminals” field.

Quickstart for Experienced Users ACCOL Workbench User Manual4-6

(For detailed information on individual modules, consult the ACCOL II Reference
Manual (document# D4044).)

Click on [OK]. A template for the module will be inserted at the current line of the
source file.

The module name will be preceded by the next sequential line number for this task.
(Task line numbers must be in ascending order).

The modu le temp late i nclu des th e mod ule te rmina ls, wi th de scripti ons o f th e l ike ly
signal type required for each terminal. If the module includes interleaved
terminals, the number of terminal sets you specified in the Select Module dialog box
will be created. The descriptions must be replaced with the actual signal names or
constants which will be used by the module.

There are two ways to enter the signal names, you can either:

1) Manually type the signal names in place of the existing descriptions.

-OR-

2) Drag the signal name from the *SIGNALS section to the desired module

terminal. To do this, open a Signal window, as described in Step 4. With the
window for the Task also in view, position the cursor on the desired signal.
Depress and HOLD the left mouse key. While continuing to hold the left
mouse key, move the cursor to the desired module terminal in the other
window; an outline box of the signal being copied will appear to help you
position it correctly. When you are on the proper terminal, release the mouse
key. The signal name will now appear on the terminal in the module
template. This method is called drag and drop, and greatly reduces the

2

amount of typing required.

This method only works, of course, if you had

previously defined the desired signals, as recommended in Step 4.

2

This same ’drag and drop’ method may be used in the creation of signal lists.

ACCOL Workbench User Manual Quickstart for Experienced Users4-7

In the figure, below, a copy of the signal name STATION1.HUMID.PCNT is
dragged from the *SIGNALS se ction to the INPUT terminal of an ANIN module.

Use either of these methods to define signals, as required, for each module
terminal.

Call up the Select Module dialog box, as previously described, and repeat the entire
process for each module to be added to the task. If you copy and paste modules in
different locations, make sure task lines are in ascending order. When finished,
close the window. A new icon will appear for this task.

Step 6 - Save the ACCOL Source File

When you have fin ished making ed its, click on the Save icon, -OR- click
on FileÅSave or FileÅSave As from the menu bar. The File Save As
dialog box will appear. Select a drive, directory and file name (other
than ACCOLn) and use the extension of (.ACC). Click on [OK].

Quickstart for Experienced Users ACCOL Workbench User Manual4-8

Step 7 - Issue a "Build" Command

To initiate a "Build" command on the curren tly open ACCOL source file,
click on the "Build" icon (the hammer, shown at left), - OR - click on
ActionsÅBuild. ACCOL Workbench will commence building an
ACCOL Object (.ACO) file, and an ACCOL Load (.ACL) file. As the
building operation proceeds, various messages will appear on the status
line, indicating the progress of the build.

If the operation is successful, a message similar to the one below will be displayed.
Skip to Step 9.

If errors are detected du ring the build p rocess, they must be corrected. Correcting
errors is discussed in Step 8.

Step 8 - Correct Any Errors and Re-Build

Unless the ACCOL source file is syntactically perfect, some errors will be detected.
In the figure, below, there are two errors which need to be corrected.

ACCOL Workbench User Manual Quickstart for Experienced Users4-9

In some cases, if the location of the error is identifiable, you can double-click on the
error line, and go d irectly to the sou rce of th e error. Dou ble -cli ckin g on Error 61, for
example, calls up a source code window for the task showing the location where
ACCOL Workbench first id entified there was an error.

In this case, both errors were caused by an improper line number in a Calculator
Module; the line "135 :ENDIF" should have a line number greater than 140 and
less than 160, instead of 135.

You can make corrections right in th e source code window, then save the changes,
and issue a "Build" command again (see Step 7). If there are numerous errors in
the file, you can jump from error to error by clicking from the menu bar on
ViewÅNext Error or ViewÅPrevious Error. Repeat the building and error
correcting process un til no errors occur, an d the ’Compil ation S uccessfu l’ and ’Link
Successful’ messages are generated. These messages mean that .ACO and .ACL
files have been successfully created.

Step 9 - Download the Completed File Using the Downloader

Once an ACCOL load file has been successfully created, it can be
downloaded into the Network 3000-series controller. There, the ACCOL
programming instructions in the load file are executed, in order to
measure and/or control the particular user process.

For users with firmware and ACCOL Workbench versions which support on-line
Workbench operation, the Open BSI Downloader can be activated from within
Workbench by clicking on the icon (shown above) or by clicking on
ActionsÅDownload. For users with older Workbench versions which do NOT
support on-line operation, the Downloader must be started from within Open BSI
Utilities. For instructions on starting Open BSI communications, and downloading,
see the Open BSI Utilities Manual (document# D5081).

Step 10 - Perform Debugging, Make On-Line Edits
(ONLY FOR Versions of ACCOL Workbench which support On-line operation)

If errors exist, debugging, and on-line editing may be performed by
activating Debug Mode. This is done by clicking on the Debug icon.

ACCOL Tasks may be viewed, along with the signal values associated with each
module in the task. Signals may also be edited via the Change Signal Value dialog
box.

Quickstart for Experienced Users ACCOL Workbench User Manual4-10