Remote Automation Solutions Guide: OpenEnterprise NW3000 Poll List Builder Reference Guide Manuals & Guides

Reference Guide

D301508X412
April 2012

OpenEnterprise NW3000 Poll List
Builder Reference Guide (V2.83)

Remote Automation Solutions

Website: www.EmersonProcess.com/Remote

Reference Guide

r

D301508X412
April 2012

NW3000 Poll List Builde

Contents

1 NW3000 Poll List Builder........................................................................................................1

1.1 Command Line....................................................................................................................1

1.1.1.1 -m...........................................................................................................................1

1.1.1.2 -a............................................................................................................................1

1.1.1.3 -i <rtu....>................................................................................................................1

1.1.1.4 -s<dataservice>......................................................................................................1

1.1.1.5 -a............................................................................................................................1

1.1.1.6 -i <rtu,....>...............................................................................................................1

1.2 Command Line Worked Examples .....................................................................................1

1.2.1.1 Example 1:.............................................................................................................1

1.2.1.2 Example 2:.............................................................................................................2

1.2.1.3 Example 3:.............................................................................................................2

1.2.1.4 Example 4:.............................................................................................................2

1.3 Build Templates Dialog.......................................................................................................2

1.3.1 Build All Button.............................................................................................................3

1.3.2 Build Button..................................................................................................................3

1.3.3 Start Monitor Button......................................................................................................3

1.3.4 Help Button...................................................................................................................3

1.3.5 Close Button.................................................................................................................3

1.3.6 Collecting Signal Alarm Data........................................................................................3

1.3.6.1.1 Alarm state data................................................................................................3

1.3.6.1.2 Alarm priority data.............................................................................................3

1.3.6.2 Enabling Collection of Signal Alarm Data..............................................................4

1.3.6.2.1 RDI3000 Task...................................................................................................4

1.3.6.2.2 Template Poll List Builder (TPB) Task..............................................................4

1.3.7 Monitor Mode................................................................................................................4

1.3.8 MSD Version.................................................................................................................4

1.3.9 RTU Being Built............................................................................................................4

1.3.10 RTU List ....................................................................................................................4

1.3.11 Status Section...........................................................................................................4

1.3.12 Template List.............................................................................................................4

1.3.13 Total Templates Built ................................................................................................4

1.3.14 Templates Formed....................................................................................................5

1.3.15 TPB State..................................................................................................................5

2 Index .........................................................................................................................................6

- i -

Reference Guide

r

D301508X412
April 2012

NW3000 Poll List Builde

1 NW3000 Poll List Builder

The Poll List Builder is a utility that is used for building data collection templates for Bristol devices. A
template is a list of signals, that will be periodically collected for each device. The frequency of the
collection is controlled by the template's associated schedule.

The Poll List Builder runs in two different ways:

• Monitor mode - Poll List Builder detects ACCOL MSD load version changes and automatically
rebuilds the templates.

• Manually - User requests to build templates.

Note: Poll List Builder can run either interactively by using the Poll List Builder dialog box, or in
background or batch mode by using Command Line Switches.

1.1 Command Line

The Poll List Builder can be activated from the command line using special switches that control its
behaviour. The command line options are as follows:-

TPB <switches>
Where <switches> is one of the following:

1.1.1.1 -m

Enter Monito

1.1.1.2 -a

Build Templat

1.1.1.3 -i <rtu....>

Build Templat

1.1.1.4 -s<dataservice>

Servic
Note: TPB will exit when it has finished building templates when invoked with the following switches:

r Mode. This is the default when the program is started as an invisible window.

es for all devices.

es for the specified device(s).

e to connect to (defaults to rtrdb1).

1.1.1.5 -a

1.1.1.6 -i <rtu,....>

1.2 Command Line Worked Examples

1.2.1.1 Example 1:

TPB -i RTU1 RTU2
TPB will build templates for devices RTU1 and RTU2 and will then exit.

- 1 -

Reference Guide

r

D301508X412
April 2012

1.2.1.2 Example 2:

TPB -m -a

NW3000 Poll List Builde

TPB will enter monitor m
mode has been specified, TPB will not exit.

1.2.1.3 Example 3:

TPB -i RTU
TPB will build templates for device RTU1, and then enter monitor mode. Since monitor mode has

been specified, TPB will not exit.

1.2.1.4 Example 4:

TPB ­TPB will connect to service RTRDB1, it will enter monitor mode and will not exit.

1 -m

sRTRDB1 -m

ode and it will build templates for all the devices in the system. Since monitor

1.3 Build Templates Dialog

The NW3000 Poll List Builder dialog allows the user to manually build templates for all devices or a
selected device. The dialog provides status information on the template build.

- 2 -

Reference Guide

r

D301508X412
April 2012

NW3000 Poll List Builde

1.3.1 Build All Button

Selecting the Build All button will build templates for all devices.

1.3.2 Build Button

Selecting the Build button will build templates for the devices currently selected within the device list
defined within the OpenBSI network definition file.

1.3.3 Start Monitor Button

Places the Poll List Builder into monitor mode. When in monitor mode, templates will be automatically
rebuilt following a load version change.

1.3.4 Help Button

Selection of this button opens this context sensitive help file.

1.3.5 Close Button

Stops the Poll List Builder, and shuts down the template building process.

1.3.6 Collecting Signal Alarm Data

OpenEnterprise can be configured to collect signal alarm data from Bristol RTUs. Signal alarm data
may be classified into two types:-

1.3.6.1.1 Alarm state data

The followi
collected from an RTU. A description is provided, mapping the values collected from the RTU with
those which will be written to the database.

Cleared (InAlarm) Set to TRUE when the signal is currently out of alarm,

Acknowledged Set to TRUE when the signal is acknowledged, FALSE when
AlarmType The current alarm type. For analog signals this will be set to

1.3.6.1.2 Alarm priority data

The following table lists the database signal attribute that will be updated with alarm priority data
collected from an RTU. A description is provided, mapping the values collected from the RTU with
those which will be written to the database.

ng table lists the database signal attributes that will be updated with alarm state data

Database Attribute Description

FALSE when in-alarm. InAlarm will be set to the inverse
value of Cleared.

the signal is unacknowledged.
0 – Low, 1 – High, 2 – Low-Low, 3 – High-High or 8 –

Normal. For digital signals this will be set to 5 – OnFalse, 6 –
OnTrue, 7 – Change-of-state or 8 – Normal.

Database Attribute Description

AlarmPriority The alarm priority if the signal is currently in-alarm. This will

be set to 0 – Event, 1 – Operator Guide, 2 – Non-Critical or 3
– Critical.

Select any combination of the 'Analogs' or 'Digitals' check boxes to enable collection of Alarm States
and/or Alarm Priorities for each type of signal.

- 3 -

Reference Guide

r

D301508X412
April 2012

Note:
It is not recommended that remote alarm collection is mixed with alarm data template

collection on the same OpenEnterprise Server. Alarm data collection by template is intended
for use with OpenEnterprise Servers that cannot receive remote alarm reports.

1.3.6.2 Enabling Collection of Signal Alarm Data

NW3000 Poll List Builde

This group of check boxes will not be visible on the Build Templates from Database dial
alarm data will not be collected by template unless polled collection of signal alarm data has been
enabled. It is enabled by setting the following values in the OpenEnterprise Settings file. This is done
by using the OpenEnterprise Settings Editor: -

1.3.6.2.1 RDI3000 Task

Key: OpenEnterprise\Tasks\RDI3000

Value: EnableQuietAlarms = 1

1.3.6.2.2 Template Poll List Builder (TPB) Task

Key: OpenEnterprise\Tasks\TPB

Value: EnableCollectAlmPriorities = 1

Value: EnableCollectAlmStates = 1

og, and signal

1.3.7 Monitor Mode

Indicates if monitor mode is active or inactive.

1.3.8 MSD Version

The device's load version number used to construct the template.

1.3.9 RTU Being Built

Name of the device for which templates are currently being built.

1.3.10 RTU List

List box containing the names of all the configured Bristol devices. The user can select one or more
devices for which templates are to be built.

1.3.11 Status Section

This is a list box which contains the most recent status messages from the Template Building
Process. The most recent message is at the top.

1.3.12 Template List

This is a report of the last template build. The report includes the name of each formed template, the
template's type, the template's timeclass, the number of signals in each template, and the status of
each template's build.

1.3.13 Total Templates Built

Total number of templates built and stored within the database.

- 4 -

Reference Guide

r

D301508X412
April 2012

NW3000 Poll List Builde

1.3.14 Templates Formed

Total number of templates formed by the Template Build task.

1.3.15 TPB State

The current state of the Poll List Builder. Possible states are: 'Building' and 'Idle'.

- 5 -

Reference Guide

r

D301508X412
April 2012

2 Index

1

B

Build All Button................................................... 5

Build Button........................................................ 5

C

Close Button....................................................... 5

Collecting Signal Alarm Data ............................. 5

Command Line................................................... 3

Command Line Worked Examples .................... 3

M

Monitor Mode..................................................... 6

MSD Version...................................................... 6

P

Poll List Builder Overview .................................. 3

NW3000 Poll List Builde

R

RTU Being Built ..................................................6

RTU List..............................................................6

S

Start Monitor Button............................................5

Status Section.....................................................6

T

Template List ......................................................6

Templates Built...................................................6

Templates Formed..............................................6

TPB State............................................................7

- 6 -

Reference Guide

D301508X412
April 2012

DISCLAIMER

Bristol, Inc., Bristol Babcock Ltd, Bristol Canada, BBI SA de CV and the Flow Computer Division , are wholly owned subsidiaries of Emerson Electric Co. doing business
as Remote Automation Solutions (“RAS”), a division of Emerson Process Management. ROC, FloBoss, ROCLINK, Bristol, Bristol Babcock, ControlWave, TeleFlow and
Helicoid are trademarks of RAS. AMS, PlantWeb and the PlantWeb logo are marks of Emerson Electric Co. The Emerson logo is a trademark and service mark of the
Emerson Electric Co. All other marks are property of their respective owners.

The contents of this publication are presented for informational purposes only. While every effort has been made to ensure informational accuracy, they are not to be
construed as warranties or guarantees, express or implied, regarding the products or services described herein or their use or applicability. RAS reserves the right to
modify or improve the designs or specifications of such products at any time without notice. All sales are governed by RAS’ terms and conditions which are available upon
request. RAS does not assume responsibility for the selection, use or maintenance of any product. Responsibility for proper selection, use and mai nt en ance of any RAS
product remains solely with the purchaser and end-user.

Engineered and supported by:

Remote Automation Solutions,
Blackpole Road, Worcester, WR3 8YB, UK
Registered office: Meridian East, Leicester, LE19 1UX

Registered in England and Wales, Registration No. 00671801

VAT Reg No. GB 705 353 652

Emerson Process Management
Remote Automation Solutions

1100 Buckingham St
Watertown, CT 06795
T 1 [phone]
F 1 [phone]
www.EmersonProcess.com/Remote
[e-mail]

© 2001-2012 Remote Automation Solutions, division of Emerson Process Management. All rights
reserved.

Emerson Process Management
Remote Automation Solutions

Blackpole Road
Worcester, WR3 8YB
T 44 (0) 1905 856848
F 44 (0) 1905 856930
www.EmersonProcess.com/Remote
[e-mail]