Anda di halaman 1dari 174

Entis XL

System Operation

Copyright © 2004 Enraf Ltd Page 1 of 174


Contents
Section Description Page

0.0 Legal 9

0.1 Copyright 9

0.2 Disclaimer 9

0.3 Safety Notice 9

1.0 Introduction 10

2.0 Home Page 11

2.1 Tank View 12

2.2 The Basic Tank View Window 13

2.2.1 Data Display In Manual Mode 13

2.2.2 Shortcut Access To Manual Data Entry 14

2.2.3 Shortcut Access To Single Tank Overview 14

2.2.4 Tank In Alarm 14

2.2.5 Identifying The Alarm After It Has Occurred 15

2.2.6 Identifying Moving Tanks 16

2.3 Pop-up Menu Options 17

2.3.1 Offline 17

2.3.2 Manual 18

2.3.3 Flow Display 19

2.3.4 Gauge Commands 19

2.3.4.1 Servo Check 20

2.3.4.2 Stow 20

2.3.4.3 Unstow 20

2.3.4.4 Freeze 20

2.3.4.5 Unfreeze 20

2.3.4.6 Water Dip 20

Copyright © 2004 Enraf Ltd Page 2 of 174


2.3.4.7 Density Dip 20

2.3.4.8 Minimise All Tanks 20

3.0 Single Tank Overview 21

3.1 Tank In Alarm 22

3.2 Viewing The Temperature Profile 24

3.3 Viewing The Density Profile 25

4.0 Logging On To Entis XL - Administrative 26


Login

4.1 Logout from Entis XL 27

4.2 Logging on to Entis XL as a non Administrative 27


User

4.3 Configuring New User Accounts 28

5.0 Acknowledging Alarms And Events 29

5.1 Acknowledging Single Alarms 29

5.2 Acknowledging Multiple Alarms 30

5.3 Record Count 31

5.4 Refreshing the Events Window 31

5.5 Printing the Events and Alarms List 32

5.5.1 Printing the Events List 32

5.5.2 Print Preview 33

5.5.3 Exiting the Alarm Summary Module 35

6.0 Reports 36

6.1 Loading The Reports Module 37

6.2 Printing By Product Group 38

6.3 Printing By Tank Group 39

6.4 Standard Inventory Report 40

6.5 Standard Summary Report 41

6.6 Gauge Configuration Report 42

6.7 Tank Configuration Report 43

Copyright © 2004 Enraf Ltd Page 3 of 174


6.8 Level Alarm Configuration 44

7.0 Grid View 45

7.1 Launching The GridView Module 46

7.2 Selecting Data Views 47

7.3 Selecting Ta nk Groups 48

7.4 Finding A Specific Tank 49

7.5 Tanks In Alarm 49

7.6 Configuring A New Data View 50

8.0 Gauge Commands 52

8.1 Launching Gauge Commands 53

8.2 Sending a Command 54

8.2.1 Dipping Functions 56

8.2.2 Displacement Functions 57

8.2.3 Test Gauge Alarm Functions 58

8.2.4 Maintenance 59

8.2.5 Gauge Items 60

8.2.5.1 Reading Gauge Items 61

8.2.5.2 Writing Gauge Items 62

8.2.5.3 Writing Gauge Commands in Different 66


Dimensions

8.3 Multi Gauge Support 68

9.0 Tank Grouping 69

9.1 Configuring And Using A Static Group 70

9.1.1 Editing An Existing Static Group 71

9.1.2 Deleting an Existing Static Group 72

9.2 Product Grouping 73

9.2.1 Using A Product Group 73

9.2.2 Product Total Window 74

Copyright © 2004 Enraf Ltd Page 4 of 174


9.3 Dynamic Grouping 75

9.3.1 Using A Dynamic Group 76

9.4 Set Tanks to Watch 77

9.5 Product Group Totalisation 79

9.5.1 Viewing Product Group Totalisation 79

10.0 Change Dimensions 80

10.1 Changing Dimensions of Display/Data Entry 81

10.2 Data Entry In Different Dimensions 84

10.3 Returning to Default Dimensions 86

11.0 DC Host 87

11.1 Starting DC Host 88

11.2 Stopping the DC Host 90

11.3 The DC Host Display Window 91

11.4 Viewing Communications 91

11.4.1 Viewing a Specific Tank 92

12.0 Help And Diagnostics 93

12.1 Diagnostics 93

12.1.1 Launching The Diagnostics Module 94

12.1.2 Pre-viewing The Diagnostics List 95

12.1.3 Printing The Diagnostic List 96

12.1.4 Launching The Recommended Action File 97

12.2 Versions 98

12.2.1 Launching the Versions Module 99

12.2.2 Pre-Viewing A Report Of The Module Versions 100

12.2.3 Printing A Report Of The Module Versions 101

12.3 About 102

12.3.1 Launching the About Module 102

Copyright © 2004 Enraf Ltd Page 5 of 174


13.0 Trending 103

13.1 Trending And Data Logging 104

13.2 Trend Logger 105

13.2.1 Launching The Trend Logger Application 105

13.3 Real-time Trending 107

13.3.1 Starting up Real-time Trending 107

13.3.2 Configuring the Real-time Trending Display 108

13.3.3 Using The Real-time Trend View Display 110

13.3.4 Finding A Value On A Trend 110

13.3.5 Zooming In To More Detail 112

13.3.6 Zooming Out To Default View 112

13.4 Historical Trending 113

13.4.1 Starting up Historical Trending 113

13.4.2 Configuring The Historical Trending Display 114

13.4.3 Using The Historical Trend View Display 116

13.4.4 Finding A Value On A Trend 116

13.4.5 Zooming In To More Detail 118

13.4.6 Zoom Out To Default View 118

14.0 Inventory Calculator 119

14.1 Launching The Inventory Calculator Application 120

14.2 Tank Calculator 121

14.2.1 Viewing Cur rent Tank Data 121

14.2.2 Entering The User Defined Criteria 122

14.3 Movement Calculator 123

14.3.1 Simulating a Receipt Of Product 124

14.4 Interpolation 125

14.5 Unit Conversion 126

Copyright © 2004 Enraf Ltd Page 6 of 174


15.0 Entis XL Movements - Introduction 128

15.1 Loading the Movement Module 130

15.2 Configuration of Movements 135

15.3 Monitoring Movements 139

15.4 Planned Movements 139

15.4.1 Opening 139

15.4.2 Closing 140

15.4.3 Suspending 142

15.4.4 Re-opening 142

15.4.5 Cancelling 142

15.5 Movement Warnings and Alarms 143

15.6 Viewing Movement Summaries 144

15.7 Movement Reports 145

15.7.1 Printing/Viewing the Standard Movement Report 145

15.8 Summary of Open Movements 14

15.9 Movement Log 147

15.9.1 Viewing/Printing the Movement Log 147

15.10 Movement Settings 149

15.10.1 Defaults 149

15.10.2 Changing the Movement Settings 149

15.11 Unauthorised Movement Detection 150

15.11.1 Configuring Unauthorised Movement Detection 151

15.11.2 Configuring the Leak Theshold 152

Copyright © 2004 Enraf Ltd Page 7 of 174


16.0 Gauge Command Scheduler 153

16.1 Launching the Gauge Command Scheduler 154

16.2 General Operation of the Gauge Command 155


Scheduler

16.3 Viewing Scheduled Commands 156

16.4 Adding Commands to the Schedule 157

16.5 Deleting Commands from the Schedule 158

17.0 Report Scheduler 159

17.1 Launching the Report Scheduler 159

17.2 General Operation of the Report Scheduler 160

17.3 Viewing Scheduled Reports 161

17.4 Adding Reports to the Schedule 162

17.5 Deleting Reports from the Schedule 165

18.0 Manual Density Entry 166

18.1 Launching the Manual Density Entry Module 167

18.2 Entering Manual Density Data 168

18.3 Printing or Previewing the Current Density for 169


each Tank

18.4 Viewing the Density History for a specific Tank 170

18.5 Printing or Previewing the Density History for a 171


Tank

19.0 Pipeline Configuration 172

19.1 Launching Pipeline Configuration 172

19.2 Entering Pipeline Details 173

19.3 Editing Existing Pipeline Details 173

19.4 Deleting Existing Pipeline Details 173

19.5 Viewing Pipeline History 174

Copyright © 2004 Enraf Ltd Page 8 of 174


0.0, Legal

0.1, Copyright Notice

This material contains information of proprietary interest to Enraf Ltd. It has


been supplied in confidence and the recipient, by accepting this material,
agrees that the subject matter will not be copied or reproduced, in whole or in
part, nor its contents revealed in any manner or to any person except to meet
the purposes for which it was delivered.

0.2, Disclaimer

The information in this document has been checked and is believed to be


entirely reliable, however no responsibility is assumed for inaccuracies. Enraf
Ltd reserves the right to make changes and/or improvements in both the
product and the product documentation without notice. Enraf Ltd does not
assume any liability arising out of the application or use of any product
described herein; neither does it convey any licence under its patent rights or
the rights of others.

0.3, Safety Notice

The Entis XL system has not been designed to operate as a Safety critical
system. It is provided as a means of monitoring only and should not be used
as a safety system.

The Entis XL system must be used alongside a proven independent safety


system.

Although, the Entis XL system provides a number of alarms to warn of current


or impending situations regarding the movement of tank levels, or the health
of level devices, appropriate independent means must be provided to verify
and validate the integrity of measurements and dynamic data at regular
intervals.

Indeed, it is recommended that in order to have a high confidence in the


system the programmable alarms provided by the system are tried and tested
at regular intervals along with other process critical functions.

Copyright © 2004 Enraf Ltd Page 9 of 174


1.0, Introduction

Entis XL is the latest in a long line of successful tank inventory systems from
Enraf.

Entis XL harnesses the latest software technologies to produce a reliable and


scalable application suited to small terminals and depots to large refineries.

Its fundamental architecture is based upon an n-tier client server model


utilising standard core ODBC compliant database technology, coupled with
distributed component technology, to provide from single integrated operator
stations to large scale multi-user systems.

A major new enhancement to the Entis XL system is its ability to seamlessly


integrate a wide range of gauging technologies and other instruments
applicable to monitoring of bulk storage and control of product movement.

This ability is provided by an advanced Data Communications and Protocol


conversion unit called the DATACON.

Technically the DATACON is a serial data concentrator and protocol


converter which can take care of the differing electrical interfacing
requirements as well as the software/protocol differences amongst the
different manufacturers gauging systems.

The DATACON itself is modular in concept and can be scaled to meet the
demands of very large refineries.

When only one manufacturers gauge type is in use, and the number of
gauges is typically less than 50, EntisXL can be directly connected to the field
equipment without the need for the Datacon. This capability is currently limited
to Enraf and Whessoe gauges.

A wide range of communication drivers and interfaces currently exist and


more are being developed all of the time.

This manual details the operational aspects of the Entis XL modules.

Copyright © 2004 Enraf Ltd Page 10 of 174


2.0, Home Page

When Entis XL is started the first view of the application is its Home Page.

The Home Page is central to the operation of the whole application.

Tank View is the default view of individual tanks as displayed in the home
page.

Each tank configured into the Entis XL database has its own Tank View
window.

The Home Page is typical of many other Windows applications; it has a menu
bar, a tool bar, an application work space and a status bar at the bottom of the
Window.

The Entis XL application by default starts with the Home Page maximized and
with all Tank View windows open.

Depending on the setup of the system, the Datacon Communications may or


may not start automatically. If the system is a standalone system the Datacon
Communications would normally be programmed to start automatically. If the
system is a remote network client it will not attempt to start the Datacon
Communications (this would be the responsibility of the server).

Access to the frequently used functions is provided from the applications tool
bar. Less frequently used functions are accessed through the menu bar.

A number of menu’s only become visible when logged on as an Administrator.

The following sections detail the operator tools and features in more depth
and detail.

Copyright © 2004 Enraf Ltd Page 11 of 174


2.1, Tank View

Tank View is the default view of individual tanks as displayed in the home
page.

Each tank configured into the Entis XL database can be viewed through the
Tank View window.

See the following illustration as an example of the Tank View.

The tank view is probably one of the main views used by Entis XL users to
capture an overall picture of tank farm operations.

Each Tank View window is fixed in its general appearance and size. They are
not scalable. When multiple Tank View Windows are open they will be tiled to
the available area of the homepage window. When there are more wi ndows
open than available space, scroll bars will automatically appear down the right
hand side of the parent window.

The Tank View Window has been equipped with a number of short-cut links to
other display features, and pop-up menu functions to gain quick access to
common operational commands and functions.

Each of these will be discussed in the next few sections.

Copyright © 2004 Enraf Ltd Page 12 of 174


2.2, The Basic Tank View Window

The Tank View window shows:-

The tank number of the tank,

A graphical representation of the tank denoting the tank type e.g. cone
roof, floating roof etc.,

The product allocated to the tank,

The current fill level as a percentage of the tank height represented as


a bar graph,

Numeric displays of Product Level, Product Temperature, Gross


Volume and Flow Rate in units defined by the Change Dimensions
module.

Whether an alarm is currently active for the tank,

Whether the numeric data is in manual or automatic mode where


relevant,

The movement status of the tank i.e. static, filling, emptying.

2.2.1, Data Display In Manual Mode

Any data value in manual mode is denoted as such by being displayed as


green foreground on a black background.

The following tank view window indicates that the product level is in manual
mode.

The data is therefore updated by using the Manual Data Entry facility. Please
refer to the Section on Manual Data Entry for further details.

Copyright © 2004 Enraf Ltd Page 13 of 174


2.2.2, Shortcut Access to Manual Data Entry

When a numeric value is in Manual Mode within the Tank View window, the
user can gain quick access to the manual data entry display by double-
clicking the data item.

This will launch the Manual Data Entry module.

2.2.3, Shortcut Access to Single Tank Overview

The Single Tank Overview module can be loaded from within the Tank View
Window by double clicking the tank graphic. This launches the Single Tank
Overview module and initialises it to display the data of the selected tank.

See the section on the Single Tank Overview module for a complete
description.

This shortcut allows the user to quickly zoom in to more detail on a particular
tank. Access to Single Tank Overview is also available from the appropriate
tool bar button.

2.2.4,Tank in Alarm

When a tank has any active alarm it is denoted as such by the display of an
“alarm horn” on the tank graphic.

Refer to the following illustration showing a tank with an active alarm.

When an alarm occurs several other events occur in addition to the placement
of the horn within the Tank View Window. See the section on Alarms for a
complete description.

Copyright © 2004 Enraf Ltd Page 14 of 174


2.2.5, Identifying the Alarm After it has Occurred

When an alarm first occurs, an event is generated, a horn appears on the


tank, an audible warning is sounded, and an optional voice message can be
played.

After all of these actions ha ve been dealt with the remaining evidence of the
alarm within the Tank View is the picture of the horn.

To identify which alarms are still active:-

Double click the tank graphic to launch Single Tank Overview.

Double click the horn on the tank graphic within Single Tank Overview.

The Alarm Summary module will be loaded. See illustration below.

The Alarm Summary module will show each of the alarms that are active. An
active alarm will have its corresponding check box ticked.

Copyright © 2004 Enraf Ltd Page 15 of 174


2.2.6, Identifying Moving Tanks

The Tank View window identifies moving tanks in several ways:-

By displaying a fill direction indicator i.e. an arrow pointing up or down


dependent on the direction of movement.

By the magnitude and sign of the Flow Rate displayed as a numeric


value in the Dimensions selected. A positive flow rate represents filling,
a negative flow rate represents emptying.

Finally, depending on whether it is configured, the colour of the product


in the tank can be used to represent movement status. For example,
blue represents filling, brown represents emptying, and green
represents static. See the System Settings module for how to enable
this feature.

See the illustration below, which shows moving and static tanks.

In the first tank the flow rate is negative, the colour is brown and the fill
direction indicator has a downward pointing arrow.

The second tank is static, the colour is green, and there is no direction arrow.

In the third tank the flow rate is positive, the colour is blue and the fill direction
indicator has an upward pointing arrow.

Copyright © 2004 Enraf Ltd Page 16 of 174


2.3, Pop-up Menu Options

A pop-up menu is available to all Tank View Windows. Simply right mouse
click within any Tank View Window and the pop-up menu will appear.

See the illustration below for example.

Some of the options within the pop-up menu are sensitive to the configuration
of the tank. These will be discussed in the remainder of this chapter.

Use of the pop-up menu options is governed by the system security defined in
User Manager.

2.3.1, Offline

To put a tank offline will remove the tank from scan i.e. the data will no longer
be collected from the gauging instrument. This would normally be used when
a tank is taken out of service.

Right click on the tank you want to take offline and click Offline as shown in
the following diagram.

Copyright © 2004 Enraf Ltd Page 17 of 174


2.3.2, Manual

Manual mode selection option.

The Manual mode menu item has a further sub-menu indicated by the small
right pointing arrowhead.

Selecting this menu item will reveal the sub-menu, which contains all of the
available manual mode options.

This menu will also reveal which, if any, of the parameters are currently in
manual mode. Any value in manual mode will be highlighted by an adjacent
tick mark.

See the illustration below.

This indicates that the Water Level, Vapour Temperature, Product and Vapour
Pressure and Density parameters are all working from manual data.

Copyright © 2004 Enraf Ltd Page 18 of 174


2.3.3, Flow Display

Flow Display selection option. The Flow Display menu item has a further sub-
menu indicated by the small right pointing arrowhead.

Selecting this menu item will reveal the sub-menu, which contains all of the
available flow display mode options.

This menu will also reveal which of the flow display modes is currently in use.

The selected flow display mode will be highlighted by an adjacent tick mark.

See the illustration below.

2.3.4, Gauge Commands

The gauge commands menu item has a further sub-menu indicated by the
small right pointing arrowhead.

Selecting this menu item will reveal the sub-menu, which contains all of the
available gauge commands within this context. See the illustration below.

The available commands are discussed and detailed as follows.

Copyright © 2004 Enraf Ltd Page 19 of 174


2.3.4.1, Servo Check

Perform a repeatability check on a servo based gauging instrument. This


command will attempt to raise the displacer by at least 300 mm and then
return it to the product level. The level prior to raising the sensor is compared
to the level after the sensor has returned to the product surface. If both are
within the defi ned tolerance the servo check function is considered to have
passed.

2.3.4.2, Stow

Stow the sensor of the gauging instrument to the locked or top stop position.
This command is only available to servo based gauging instruments.

2.3.4.3, Unstow

Cancel the Stow command and return the sensor to the product level. The
Unstow command can also be used to Cancel any of the other commands as
well.

2.3.4.4, Freeze

Causes the displacer to remain at it’s current level.

2.3.4.5, Unfreeze

Releases the last Freeze command and allows the displacer to return to the
product level.

2.3.4.6, Water Dip

This option will instruct the displacer to search for the water level in the tank
and return to the product level.

2.3.4.7, Density Dip

If this option is fitted to the gauge then a density reading will be taken.

If a gauge command is selected that is outside the operational capabilities of


the fitted gauge then an error message will appear to inform the user. See
illustration below.

2.3.4.8, Minimise All Tanks

Selecting this option will minimise all Tank View windows currently open.

Copyright © 2004 Enraf Ltd Page 20 of 174


3.0, Single Tank Overview

The Single Tank Overview module provides a detailed display of all data for a
single tank.

The Single Tank Overview module can be launched in two ways:-

By double clicking a Tank View Window,

By clicking the Single Tank Overview tool bar button.

The following screen will be loaded.

Once the Single Tank Overview module has been loaded, further tanks can
be viewed by selecting them from the drop down list provided. Use the scroll
bar on the left hand side to reveal more tanks. See the diagram below.

The data on display is organised into logical groups; Primary Gauging data,
Flow Rates, Inventory Data, and Alarm Settings.

The tank graphic displayed in the Single Tank Overview module represents
the type of tank.

Any data values in manual mode will be displayed in a green foreground and
black background.

Any data values unavailable for any reason will be replaced by a diagnostic
number.

Copyright © 2004 Enraf Ltd Page 21 of 174


Tool tips are used throughout to provide further information to the user on
each of the data display fields. These are displayed as follows.

For a full description and definition of each of the fields please refer to the
section on Definitions.

3.1, Tank in Alarm

If the selected tank has an active alarm, a horn will be displayed on the tank.
The detail of which alarms are active can be determined by double clicking
the horn to launch the Alarm Summary Display.

The alarm summary will show a tick mark against each alarm that is currently
active.

See the illustration below.

Copyright © 2004 Enraf Ltd Page 22 of 174


Alarm Definitions

Gauge Alarms

HH Gauge High High


HA Gauge High
LA Gauge Low
LL Gauge Low Low

TH Temperature High
TL Temperature Low

DH Density High
DL Density Low

Programmable Alarms

LAHH Programmable Level Alarm High High


LAH Programmable Level Alarm High
LAL Programmable Level Alarm Low
LALL Programmable Level Alarm Low Low

TAH Programmable Temperature Alarm High


TAL Programmable Temperature Alarm Low

DAH Programmable Density Alarm High


DAL Programmable Density Alarm Low

TDA Programmable Temperature Deviance Alarm


DDA Programmable Density Deviance Alarm

WAH Programmable Water Alarm High


WAL Programmable Water Alarm Low

VA Programmable Variable Alarm


FRA Programmable Floating Roof Alarm

HFA Programmable High Flow Alarm


LFA Programmable Low Flow Alarm

UMA Programmable Unauthorised Movement Alarm


DA Programmable Difference Alarm

Copyright © 2004 Enraf Ltd Page 23 of 174


3.2, Viewing the Temperature Profile

Some tank gauges have the capability of measuring multiple temperature


points from special temperature measurement devices.
These are commonly referred to as Averaging Thermometers, Multi-spot
Temperature probes etc.
For those gauges that have the capability of making multiple temperature
measurement from one of these devices, and assuming the gauge can also
transmit those temperature measurements, each temperature point can be
displayed by Entis XL on the Temperature Profile display.
Entis XL calculates and displays the average value of the available
temperature points. The available points are displayed in the table, the
remaining points will be displayed in error.
If any of the points deviate from the average by more than 10% the point will
be marked in the table with a red background. It serves only as a simple
warning.
This data will be updated periodically by a low priority background task, only if
the Average Temp Fitted check box has been checked in gauge configuration
and correctly downloaded to the Datacon.
Press the Temperature Profile button to load the profile module.
The following display is typical: -

If the data is available the temperature values will be displayed in the table,
and also plotted onto the accompanying graph.

Copyright © 2004 Enraf Ltd Page 24 of 174


3.3, Viewing the Density Profile

Some tank gauges have the capability of measuring multiple density points
from special sensors or as an integrated function of the primary measurement
device.

For those gauges that have the capability of making multiple density
measurements, and assuming the gauge can also transmit those density
measurements, each density point can be displayed by Entis XL on the
Density Profile display.

Entis XL calculates and displays the average value of the available density
points. The available points are displayed in the table, the remaining points
will be displayed in error.

If any of the points deviate from the average by more than 10% the point will
be marked in the table with a red background. It serves only as a simple
warning.

This data is only updated after a successful density dip has been performed.

Press the Density Profile button to load the profile module.

The following display is typical: -

If the data is available the density values will be displayed in the table, and
also plotted onto the accompanying graph.

Copyright © 2004 Enraf Ltd Page 25 of 174


4.0, Logging on to Entis XL - Administrative Login

Select the Login option from the toolbar menu.

Selecting this will bring up the following screen.

There will no data in either of the fields available. Enter the necessary
username and password.

When complete several things will change on the display,

An additional ADMIN menu will appear on the tool bar if you log on as
an Administrative user.

The Initials used in the security set-up will appear in the bottom left of
the screen.

Copyright © 2004 Enraf Ltd Page 26 of 174


4.1, Logout from Entis XL

Select the Logout option from the toolbar menu.

This will log you out of Entis XL

The system will immediately log out the currently logged on user.

You will notice that the leftmost panel of the status bar will return to “-----“.

This will prevent access to all functions requiring a logon.

4.2, Logging on to Entis XL as a non Administrative User

Select the Login option from the main menu bar.

A login prompt will appear.

Enter the necessary username and password.

The details will be checked against entries in the Entis XL database.

If the entries exist the user will be logged on at their designated access level.

Many features within Entis XL require that the user be logged on. Each user
account has a designated level of access to each feature so even if a user is
logged on it does not necessarily mean that they have access to all functions.
A users level of access is determined by the rights assigned to them by the
Entis XL System Administrator.

When a user is logged in to the system, the username is displayed in the left
most panel of the status bar.

Copyright © 2004 Enraf Ltd Page 27 of 174


4.3, Configuring New User Accounts

Please refer to Security Configuration section of the System Administrators


manual for further information.

NOTE: consideration should be given to new users access rights. Not all
users should be given the highest level of access. The System Administrator
should be responsible for determining who has what rights.

We recommend that most casual users be given minimal rights to start with.

They can always be adjusted later as users become more familiar with the
operation of the system.

Copyright © 2004 Enraf Ltd Page 28 of 174


5.0, Acknowledging Alarms and Events

Acknowledgement of Alarms and Events is probably one of the most common


operator actions. Two techniques have been provided to acknowledge alarms.

Single alarms can be acknowledged by clicking the Acknowledge tool bar


button.

Alternatively, multiple alarms can be acknowledged simultaneously from the


alarm summary view.

In either case the user has to be logged on.

The tool bar of the home page display incorporates an alarm window. When
there are no unacknowledged alarms this window will be blank, see diagram
below.

When a new alarm is detected its description will be displayed in this window
until acknowledged by the user.

5.1, Acknowledging Single Alarms

When an alarm or event is displayed as follows.

The Colour in the display window will alternate between red and black.

Click the acknowledge button. This will remove the alarm from the window
and time stamp the acknowledge date/time field of the alarm record in the
database.

If there are any other unacknowledged alarms in the queue the oldest
unacknowledged one of the remaining alarms will be displayed.

Copyright © 2004 Enraf Ltd Page 29 of 174


5.2, Acknowledging Multiple Alarms

Load the Alarm Summary module by double clicking the alarm window on the
tool bar. The following screen appear.

The acknowledged alarms are those having a green tick mark at the start of
each row.

The unacknowledged alarms are those having a red cross mark at the start of
each row.

Multiple alarms can be acknowledged simultaneously by loading the alarm


summary list and using the Ack All function. This feature will prompt the user
for their username and password.

Enter your User Name and Password, if you have the appropriate rights, all
unacknowledged alarms will be acknowledged.

Copyright © 2004 Enraf Ltd Page 30 of 174


If so required, individual alarms can be acknowledged in this window by
double clicking the crossed button.

5.3, Record Count

Located in the bottom left of the Events window is a Record Count field.

The blue number In the field is a count of how many events or alarms can be
viewed using the Events window.

5.4, Refreshing the Events Window

When using the scroll bar to view events further down the list, by clicking the
Refresh button you will be taken back to the top of the list displaying the last
event or alarm.

Alternatively if you have acknowledged an event or alarm and then continued


to view other events or alarms by using the scroll bar, by clicking the Refresh
button you will taken to that last acknowledged event or alarm with the event
or alarm being displayed at the top of the page.

Copyright © 2004 Enraf Ltd Page 31 of 174


5.5, Printing the Events and Alarms List

5.5.1, Printing the Events List.

It is possible to print the contents of the events window or sections of if


required. To do this select File option from the menu bar.

To print the entire contents of the events window click Print.

During the printing of the file the following screen will appear.

To cancel the print job click the Cancel button.

Copyright © 2004 Enraf Ltd Page 32 of 174


5.5.2, Print Preview

To preview the print before actual printing select Print Preview from the File
menu.

This will bring the following screen.

It is possible to view different pages of the print, this can be done in two ways.

By using the step buttons as shown below.

Or by using the menu options from the tool bar.

Copyright © 2004 Enraf Ltd Page 33 of 174


When you have selected the page you want to view it is possible to change
the zoom at which you can preview the document. Again, this can be done in
either two ways.

By using the tool bar buttons.

Or by using the menu options from the tool bar.

Having now previewed the events list if so required you can now print the list.
By selecting File from the tool bar you will receive several options for printing.

To print the entire list select Print from the File menu.

Or by using the tool bar button.

To print a selection of pages select Print some pages.

Copyright © 2004 Enraf Ltd Page 34 of 174


To enter the range of page numbers use either a space between the pages as
below.

Or use a comma between page numbers.

If you only want to print the page you are viewing select Print current page.

5.5.3, Exiting the Alarm Summary Module

It is possible to exit the Alarm summary module in four ways.

By clicking the Exit button.

By clicking the close window button in the top right of the window.

By Selecting Exit from the menu.

Copyright © 2004 Enraf Ltd Page 35 of 174


6.0, Reports

Entis XL comes with a standard set of tank gauging and inventory reports.

Entis XL uses the well known Seagate Crystal Reports.

It enables the user to print a report of all tanks, tanks by product group or
tanks by tank group.

The report files are stored in the Entis XL Target folder.

Inventory.rpt.
Summary.rpt
ProductGroup.rpt
TankGroup.rpt
GaugeConfiguration.rpt
TankConfig.rpt
LevelAlarmConfiguration.rpt

These report files are supplied with the Entis XL package. No provision is
made for modifying the reports.

Copyright © 2004 Enraf Ltd Page 36 of 174


6.1, Loading the reports module

Select the File Menu.

Select the Print sub-menu.

The Report module will be loaded.

Select the type of report.

Press the Print button to send the report to the printer.

Press the Print Preview button to Preview the report prior to printing.

Press the Exit button to unload the Report module.

Copyright © 2004 Enraf Ltd Page 37 of 174


6.2, Printing by Product

The Report module contains a product selection list. This list will contain all
products that have been configured into the Entis XL database.

Select the product of interest from the list.

Select the Product Selection option button.

Press the Print button.

A report on all tanks containing the selected product will be printed.

The following illustration shows a typical product group report.

Copyright © 2004 Enraf Ltd Page 38 of 174


6.3, Printing By Tank Group

The Report module contains a Tank Group selection list. This list contains all
the Tank Groups configured with the Static Group Configuration utility.

Select the Group of interest.

Select the Group Selection option button.

Press the Print button.

A report all tanks in the selected Tank Group will be printed.

Copyright © 2004 Enraf Ltd Page 39 of 174


6.4, Standard Inventory Report

The following picture shows the content of a typical inventory report.

To print the Standard Inventory Report: -

Select the Standard Inventory Report option button.

Press the Print button.

Copyright © 2004 Enraf Ltd Page 40 of 174


6.5, Standard Summary Report

The following picture shows the content of a typical Standard Product


Summary report.

To print the Standard Summary Report: -

Select the Standard Summary Report option button.

Press the Print button.

Copyright © 2004 Enraf Ltd Page 41 of 174


6.6 Gauge Configuration Report

The following picture shows the content of a typical Gauge Configuration


report.

To print the Gauge Configuration Report: -

Select the Gauge Configuration Report option button.

Press the Print button.

Copyright © 2004 Enraf Ltd Page 42 of 174


6.7 Tank Configuration Report

The following picture shows the content of a typical Tank Configuration report.

To print the Tank Configuration Report: -

Select the Tank Configuration Report option button.

Press the Print button.

Copyright © 2004 Enraf Ltd Page 43 of 174


6.8 Level Alarm Configuration Report

The following picture shows the content of a typical Level Alarm Configuration
report.

To print the Level Alarm Configuration Report: -

Select the Level Alarm Configuration Report option button.

Press the Print button.

Copyright © 2004 Enraf Ltd Page 44 of 174


7.0, Grid View

GridView is the traditiona l tabular view of tank data.

GridView has been designed to provide the user with a large degree of
flexibility when it comes to data presentation.

The GridView application supports dynamic text sizing, dynamic column


moving and column sorting, together with all of the usual tank and product
grouping features.

The GridView application also incorporates a pop-up menu for sending the
common gauge commands. Indeed the GridView allows the user to send
commands to multiple gauges simultaneously.

Within the GridView module the user can create their own data views and
combine them with the standard tank grouping features to completely
customise data presentation.

The GridView module is a standalone application module that can be


launched from Entis XL or run as a completely separate application.

GridView is launched from Entis XL by clicking the appropriate tool bar button.

The GridView module also supports the static tank grouping function of the
Tank View displays.

Where the number of columns or number of tanks will not fit on the available
area on the display scroll bars will be displayed.

The GridView module is live in that it is being refreshed with data all the time
such that any tank changes are recorded by GridView as they happen.

Copyright © 2004 Enraf Ltd Page 45 of 174


7.1, Launching the GridView Module

Press the GridView tool bar button or alternatively run the GridView.exe
application from the Entis XL target folder.

The GridView module will be loaded.

The illustration below is typical.

The data being displayed will depend on whether the GridView has been
previously loaded. The default data view at first start up is Tank Gauging view,
however, the GridView module will subsequently display the data the last time
the module was used.

Copyright © 2004 Enraf Ltd Page 46 of 174


7.2, Selecting Data Views

Grid View comes as standard with several pre-defined data views.

Within the context of this section a data view simply means the columns of
data displayed within the grid.

The available data views are listed in the drop down list on the tool bar.

See the illustration below for information.


Drop down list of Data Views

The fixed views are: -

Tank Gauging
Tank Inventory
Tank Status

Each view contains different columns of information.

Any other views listed will be user defined views.

Further views can be configured by the user.

Copyright © 2004 Enraf Ltd Page 47 of 174


7.3, Selecting Tank Groups

By default the GridView module displays all tanks configured in the tank
database.

Grid View allows the user to choose one of the pre-configured tank groups
therefore filtering the tank list and only displaying those tanks that appear in
the tank group.

The available groups are listed in the drop down list on the tool bar.

See the illustration below for information.

Drop down list of Group Views

If no groups have been configured the list will be empty other than the fixed
All Tanks group.

Copyright © 2004 Enraf Ltd Page 48 of 174


7.4, Finding a Specific Tank

GridView allows the user to locate a tank within the tank list. If the tank
identity is known it can be typed directly into the box provided; the grid rows
will be scrolled until the chosen tank is found. Alternatively the tank can be
selected from the drop down list and similarly the grid will be scrolled to
display the selected tank.

7.5, Tanks in Alarm

A number of tool bar buttons are provided to quickly summarise tanks that
have an active gauge alarm.

Change Dimensions

All Tanks in Alarm

View All
All Tanks in High Alarm Tanks Lock/Unlock Grid

All Tanks in Low Alarm

Copyright © 2004 Enraf Ltd Page 49 of 174


7.6, Configuring a New Data View

Drop down the Options menu.

Select the Define Query option.

The Define Query display will be loaded as illustrated below.

Enter the name of the new query or view.

Select the columns required to build the new view by: -

Click on the required parameter in the list.

Press the -> button to transfer it to the new view.

Repeat the above steps until all columns have been specified for the
new view.

See the illustration below for example.

Press the OK button to save the view.

Copyright © 2004 Enraf Ltd Page 50 of 174


Drop down the View List on the tool bar of the GridView application.

The new view should be listed.


New View

Click on the new View in the list to use it.

Copyright © 2004 Enraf Ltd Page 51 of 174


8.0, Gauge Commands

The Gauge Commands module is a separate executable module that is


normally launched from the Entis XL application.

Many of the available features are gauge specific and therefore dependent on
the gauge type. For any given type of gauge, a number of the commands may
be disabled.

The Gauge Command module is a multi-tabbed display where each of the


available functions have been logically grouped into the available tabs.

The currently available tabs are denoted:-

Dipping
Displacement
Test Gauge Alarm
Maintenance
Gauge Items

Dipping provides the various interface measurement modes such as Find


Water Interface, Find Product Interface, and Density Dipping features.

Displacement provides gauge displacer control functions.

Test Gauge Alarm provides the ability to auto-test the alarm set points of the
873 radar gauge.

Maintenance allows the user to set the reference level of the gauge.

Gauge Items is a general tool allowing the user to read or write any of the
gauge items and view the returned data and or responses.

The Gauge Commands module also supports the use of the Change
Dimensions Module.

Copyright © 2004 Enraf Ltd Page 52 of 174


8.1, Launching Gauge Commands

Drop down the Tools menu.

Select the Gauge Command option.

The Gauge Command module will be loaded.

Copyright © 2004 Enraf Ltd Page 53 of 174


8.2, Sending a Command

Select a tank from the drop down list.

The table will be populated with the Gauge Number, Gauge Type, Gauge
Duty, Gauge Address and CIU Address. If there were more than one gauge
on the tank multiple rows would be displayed one for each gauge.

The commands supported by the gauge will be enabled. All other commands
will be disabled.

Select the appropriate command tab.

Select the row in the table corresponding to the required Gauge. Point and
click at the left hand end of the row. The background colour of the row will
change blue.

Point and
click here

Set any required parameters and click the Apply button. The selected
command will be sent to the selected gauge.

In the example below, a Lock Gauge at Level (5000mm) with Auto Unlock has
been selected.

Copyright © 2004 Enraf Ltd Page 54 of 174


Copyright © 2004 Enraf Ltd Page 55 of 174
8.2.1, Dipping Functions

These functions generally apply to the Enraf 854 series of servo operated
tank gauges.

Product Measurement Mode

Sends the I1 gauge item.

Displays the status of the gauge throughout.

The gauge will remain at I1 until the user commands the gauge
otherwise.

Density Dip

Sends the TP or IP gauge items. Relies upon the user having set other
related gauge items first.

Water Measurement Mode

Sends the I3 gauge item.

Displays the status of the gauge throughout.

The gauge will remain at I3 until the user commands the gauge
otherwise.

Copyright © 2004 Enraf Ltd Page 56 of 174


8.2.2, Displacement Functions

Lock

Lock the displacer at a specified level.

The user must provide the level at which the displacer will be locked.

The gauge will remain in the locked position until told to do otherwise
by the user. Alternatively the user can specify an Automatic Unlock.

Verify Calibration

Verifies the calibration of the instrument. The displacer will be raised


into the calibration chamber of the gauge.

Uses the CA gauge item.

The gauge will remain in the calibrate mode until told to do otherwise
by the user.

Stores and displays start level.

Displays the various state changes that occur.

Press the unlock button the have the displacer return to Product
Measurement Mode.

Unlock

Unlocks the gauge from the locked or calibrate position.

Sends the UN gauge item.


Copyright © 2004 Enraf Ltd Page 57 of 174
8.2.3, Test Gauge Alarm Functions

The Test Gauge Alarm tab provides an Alarm Test function specifically designed for the Enraf
873 Radar gauge.

Set which of the four available gauge alarms are to be tested.

HiHi High High Gauge alarm


Hi High Gauge alarm
Lo Low Gauge alarm
LoLo Low Low Gauge alarm

This function uses the AT gauge item.

Any combination of alarms can be tested, either individually or all


simultaneously.

For each alarm test requested, the corresponding alarm should be detected
and generated within the Entis XL system.

Copyright © 2004 Enraf Ltd Page 58 of 174


8.2.4, Maintenance

The Maintenance tab function allows the user to set the Gauge to a new dip.

The user needs to enter the Gauge Password and the new gauge dip.

This function uses a whole sequence of gauge items as follows:-

Set the password level to Level 2 using W2 gauge item.

Set the reference level using the RL gauge item.

Accept the reference level using the AR gauge item.

Exit and re-initialise the gauge using the EX gauge item.

When this feature is initiated the status of each transaction should be


displayed.

When the EX command is finally issued the gauge data may disappear for a
short time while the gauge re-initialises itself. After re-initialisation the gauge
level should read the new value.

Copyright © 2004 Enraf Ltd Page 59 of 174


8.2.5, Gauge Items

The Gauge Items tab allows the user to send adhoc requests to the selected gauge for
specific data. The requests can be to both read and write data. This feature would normally
be used as a maintenance and diagnostic tool.

The use of this feature would normally require a reasonable knowledge of the
appropriate gauging equipment and it is recommended that it is only used by
competent persons only.

Copyright © 2004 Enraf Ltd Page 60 of 174


8.2.5.1, Reading Gauge Items

Select the gauge to send the item to.

Enter a valid gauge item.

Press the Apply button.

The Gauge Item and associated data (if any) will be despatched to the
Datacon which will process the request the next time it talks to the specified
gauge. When the answer becomes available the Gauge Commands window
will be updated.

If any error occurs in reading or writing to the gauge items an appropriate


error message will be displayed in the answer field.

The above example shows a request for Gauge Item HH from an Enraf
gauge. HH is Gauge High High alarm set point. The command is processed
and the response is +1839 i.e. 1839mm.

Copyright © 2004 Enraf Ltd Page 61 of 174


8.2.5.2, Writing Gauge Items

Select the gauge to send the item to.

Enter a valid gauge item.

Enter the appropriate data to be written with the item. The data needs to be
prefixed with an equals (=) character.

NOTE: it is important that the correct Dimensions are set before using the
write feature.

Press the Apply button.

The Gauge Item and associated data (if any) will be despatched to the
Datacon which will process the request the next time it talks to the specified
gauge. When the answer becomes available the Gauge Commands window
will be updated.

If any error occurs in reading or writing to the gauge items an appropriate


error message will be displayed in the answer field.

NOTE: When writing Gauge Items it is normally necessary to set the correct
protection level first.

The followi ng example shows the sequence of actions the user must take in
order to set item HH.

Initially item W2 is sent with the correct password to enter the correct
protection mode before item HH will be accepted.

We will assume for the purposes of this exercise that the Level Dimensions
are in mm.

Copyright © 2004 Enraf Ltd Page 62 of 174


Enter the Gauge Item as W2.

Enter the Gauge Item Data as =ENRAF2

Press the Apply button.

The Answer will say “Waiting for Answer”.

After several seconds the Answer should be cleared.

It is usually good practice to request the current value of the item before it is
set to the new value. This also gives an example of the required formatting of
the data.

Enter a Gauge Item of HH.


Press the Apply button and wait for the answer.

Copyright © 2004 Enraf Ltd Page 63 of 174


The current setting is 1839mm.

Lets assume we want to set the new value to 2000mm.

Now enter Gauge Item as HH.

Enter the gauge Item Data as =+2000

Press the Apply button.

Copyright © 2004 Enraf Ltd Page 64 of 174


When the Answer is displayed it should repeat the value +2000 as
acknowledgment of receipt.

Now send the EX command to exit the protection level and re-initialise the
gauge.

Copyright © 2004 Enraf Ltd Page 65 of 174


8.2.5.3, Writing Gauge Commands in Different Dimensions

Lets assume that the Gauge Dimensions for Level are feet, inches and
sixteenths (f-i-s).

Set the Dimensions in the Gauge Command module the same.

Using the previous example request gauge item HH.

The level will now be displayed formatted in f-i-s.

Set HH to a new value of 07’10”00.

Leading zeroes must be provided.

Copyright © 2004 Enraf Ltd Page 66 of 174


Now send the EX command to exit the protection level and re-initialise the
gauge.

For other dimensions follow the same procedure.

Copyright © 2004 Enraf Ltd Page 67 of 174


8.3, Multi Gauge Support

When a Tank has more than one gauge, there will be one row for each gauge
in the table. The example below shows two gauges on one tank. The first
gauge is an 854 Servo Gauge, the second gauge is an 873 Radar.

Select the gauge to send the command and or request to.

Enter the appropriate data and press the Apply button.

The command will be sent to the selected gauge.

Copyright © 2004 Enraf Ltd Page 68 of 174


9.0, Tank Grouping

Entis XL provides a comprehensive range of tools and utilities for the


organisation and grouping of tanks to users requirements.

All the tank grouping functions are generally available from the Tank Grouping
module.

Grouping is generally organised into static and dynamic groups.

Static groups can be organised by: -

Product

Product group

User defined Tank Group

Dynamic Groups are those that are automatically defined by Entis XL.

The Tank Grouping module display comprises a multi-tabbed dialogue.

Access to certain of the Tank Grouping functions is password protected. You


will be requested where necessary to login.

Copyright © 2004 Enraf Ltd Page 69 of 174


9.1, Configuring and using a Static Group

Load the Tank Grouping module by clicking the appropriate tool bar button.

Click on the Static Group Config Tab.

Click the Edit button. Click the Add button.

Type in the name of the new group.

Select the tanks required for the group as follows:-

Highlight a tank in the tank list by pointing and clicking the left mouse
button.

Press the > button to transfer it to the tank group list. The < button
does the opposite, i.e. removes the highlighted tank from the tank
group list.

Repeat the above for all tanks required in the group.

The >> button can be used to transfer all tanks in a single key stroke to
the tank group list. The << button does the opposite, i.e. removes all
tanks from the tank group list.

Press the Apply button to store the group details to the database.

Press the OK button to use the group.

In the home page the tanks in the selected group will be displayed.

Further the selected Group Name will be displayed in the status bar.

Copyright © 2004 Enraf Ltd Page 70 of 174


9.1.1, Editing an Existing Static Group

Load the tank grouping module by clicking the appropriate tool bar button.

Click on the Static Group Config Tab.

Press the Edit button.

Select the tank group to be modified from the group list.

If you want to add further tanks:-

Select the tanks required for the group as follows:-

Highlight a tank in the tank list by pointing and clicking the left
mouse button.

Press the -> button to transfer it to the tank group list.

Repeat the above for all tanks required in the group.

If you want to remove existing tanks:-

Select the tank to be removed from the group as follows:-

Highlight a tank in the tank group list by pointing and clicking the
left mouse button.

Press the <- button to transfer it to the tank list.

Repeat the above for all tanks that need removing from the
group.

Press the Apply button to store the modifications to the database.

Press the OK button to use the modified group.

In the home page the tanks in the selected group will be displayed.

Further the selected Group Name will be displayed in the status bar.

Copyright © 2004 Enraf Ltd Page 71 of 174


9.1.2, Deleting an Existing Static Group

Load the tank grouping module by clicking the appropriate tool bar button.

Click on the Static Group Config Tab.

Click the Edit button.

Select the tank group to be deleted from the group list.

Click the Delete button.

Copyright © 2004 Enraf Ltd Page 72 of 174


9.2, Product Grouping

Entis XL provides the user with the ability to view tanks containing a particular
product.

In addition the Product Grouping feature provides totalisation of volumes for


the selected product.

9.2.1, Using a Product Group

Load the tank grouping module by clicking the appropriate tool bar button.

Click on the Product Grouping Tab.

See the illustration below for the available display options and operator
controls.

The list of available products will be displayed. If there are a lot of products
you may need to use the scroll bars to locate the product of interest.

Select the Product of interest from the list.

The tanks currently containing that product will be listed.

Press the Apply button to display the tanks.

Press the Cancel button to exit Tank Grouping.

If the Apply button is used to display the tanks with the selected product, an
additional display window is loaded showing the totalized volumes for the
selected product.

Copyright © 2004 Enraf Ltd Page 73 of 174


9.2.2, Product Total Window

The Product Total Window is only displayed when the Product Grouping
feature is in use.

The Product Total Window displays some totalized volumes for the selected
product.

Further any tanks not able to be included within the total due to any error or
fault are listed in the display.

See the illustration below for details.

Copyright © 2004 Enraf Ltd Page 74 of 174


9.3, Dynamic Grouping

Entis XL currently provides a basic dynamic grouping function which allows


the user to view tanks that conform to certain dynamic criteria e.g. moving
tanks.

When a dynamic group is use, as tanks no longer conform to the criteria they
will be removed form display.

The number of available dynamic groups is currently fixed.

These groups are automatically defined by the system.

Copyright © 2004 Enraf Ltd Page 75 of 174


9.3.1, Using a Dynamic Group

Load the tank grouping module by clicking the appropriate tool bar button.

Click on the Dynamic Groups Tab.

See the illustration below for the available display options and operator
controls.

The list of available dynamic groups will be displayed.

Select the Dynamic Group of interest from the list.

Press the Ok button to use the dynamic group.

Press the Cancel button to exit Tank Grouping.

The tanks conforming to the criteria for the specified dynamic group will be
displayed. For example, Moving Tanks is any tank that is moving in any
direction, Filling tanks are those tanks currently being filled.

Copyright © 2004 Enraf Ltd Page 76 of 174


9.4, Set Tanks to Watch

Click on the appropriate toolbar button and the following form will be
displayed.

Select the tanks of interest by pointing and clicking. When first selected the
tank will be highlighted in blue. If selected again the tank will be de-selected.

Press the OK button to display the selected tanks.

To select all tanks simultaneously press the Select All button followed by the
OK button to display all tanks.

To de-select all ta nks simultaneously press the Deselect All button followed
by the OK button to minimise all the tanks.

Alternatively, the Set Tanks to Watch feature is available under the Tank
Grouping module.

Load the tank grouping module by clicking the appropriate tool bar button.

Click on the Set Tanks to Watch Tab.

Copyright © 2004 Enraf Ltd Page 77 of 174


See the illustration below for the available display options and operator
controls.

To select all tanks simultaneously press the Select All button followed by the
OK button to display all tanks.

To de-select all tanks simultaneously press the Deselect All button followed
by the OK button to minimise all the tanks.

Copyright © 2004 Enraf Ltd Page 78 of 174


9.5, Product Group Totalisation

The Product group Totalisation module allows the user to totalise product
volumes by the Product Group assigned to them.

This feature can be used in a variety of ways to produce inventory summaries


of similar products.

Product Group names are entered through the Product Group Configuration
module. See the Config menu of the main menu bar of the Entis XL home
page.

Product names are entered through the Product Configuration module. See
the Config menu of the main menu bar of the Entis XL home page.

9.5.1, Viewing Product Group Totalisation

From the View menu select the Product Group Totals option.

The following module will be loaded.

Select a Group from the drop down list.

The Group Ullage and Group Usable Volumes will be calculated and
displayed.

In addition each tank belonging to the group and contributing to the total will
also be displayed.

Copyright © 2004 Enraf Ltd Page 79 of 174


10.0, Change Dimensions

In the global economy of today, and with the inter-trading of petroleum


products between different countries, the ability to view data in different
dimensions, at the press of a button has become a very desirable feature.

For example, a ship arrives to discharge it cargo with imperial measurements,


but the site receiving the product works in metric measurements, and the ship
requires documentation in imperial measurements.

Entis XL has been designed to simplify these issues by incorporating a real-


time on-line Change Dimensions module that allows the user of the system to
view, enter and edit data in dimensions of their choice.

Many of the screens within the Entis XL application incorporate the ability to
view numeric data in a variety of different Dimensions or Engineering Units.

The picture below shows the Change Dimensions Display.

Copyright © 2004 Enraf Ltd Page 80 of 174


10.1, Changing the Dimensions of Display/Data Entry

Any screen or application module displaying the above tool bar button has the
ability to Change Dimensions.

Within the home page of Entis XL each tank window displays numeric
information about each tank. The main application tool bar has a Change
Dimensions button. This Change Dimensions button affects the display of
data within the home page.

The Alarm Configuration module incorporates a Change Dimensions button.


In this case the Change Dimensions module affects the data entry and display
of all numeric fields within the alarm Configuration Module.

All other modules displa ying, and providing numeric data entry capability, will
also contain the Change Dimensions button.

This means that each module containing the Change Dimensions feature can
display, or accept data entry in different Dimensions to all other modules
having the Change Dimensions feature.

Lets consider the home page as an example.

Initially the Product Level dimensions are set to millimetres.

The illustration shows one of the tank views displaying product level in
millimetres.

Change the level dimension to Feet Inches and Sixteenths (f-i-s).

Press the Change Dimensions button.

The Change Dimensions module will be loaded.

Copyright © 2004 Enraf Ltd Page 81 of 174


The current settings of the dimensions will be displayed for the selected
display.

Each parameter group has a drop down list containing the available
dimensions for display and data entry.

Click on the list for Level.

Select the feet inches and sixteenths option.

Press the OK button.

The Product level will now be displayed as feet inches and sixteenths.

The display affected, in this case the home page, will re-display the numeric
data in the new dimension.

The illustration now shows the product level in feet inches and sixteenths.

Copyright © 2004 Enraf Ltd Page 82 of 174


NOTE: that changes to the Dimensions for level affects all Level parameters
such as Water Level, Oil Depth etc etc. Further changes to the Volume
Dimension will affect all Volume parameters etc.

Copyright © 2004 Enraf Ltd Page 83 of 174


10.2, Data Entry in Different Dimensions

Whenever the Change Dimensions module is used to display parameters in


different dimensions this also affects the data entry as well.

This is best understood by considering an example.

Lest consider the entry of alarm configuration data in imperial units.

When the Change Dimensions module has selected Level to be displayed in


either feet inches and tenths or feet inches and sixteenths a special edit field
is used to accept the entry of the data.

Load the Alarm Configuration module.

Select the Change Dimensions button.

Modify the Level dimension to feet inches and sixteenths (f-i-s).

The data will be re-displayed in f-i-s.

Select a tank from the list.

Select the Programmable Alarms tab.

Enter edit mode.

Press the Edit button.

You may be required to logon with the correct access rights if you are not
already logged on.

Select the High High Alarm level field.

Delete the current data completely.

You will see the field change to __’__”__.

See the illustration overleaf.

Copyright © 2004 Enraf Ltd Page 84 of 174


The __ represent spaces. Two spaces each are reserved for the feet, inches
and sixteenths parts respectively.

The ‘ denotes feet.

The “ denotes inches.

No character is used to denote the sixteenths part. This is implied by the Units
being displayed.

Type in a new number.

You will see that each part of the required field is filled as the numbers are
typed.

The values of each part of the field are validated at the point the user attempts
to save the data to the database.

So for example, the user could enter

20’13”11

20 feet, 13 inches, 11 sixteenths.

Clearly the 13 inches is an illegal value.

When the user attempts to save this value it will be rejected as invalid.

Copyright © 2004 Enraf Ltd Page 85 of 174


10.3, Returning to Default Dimensions

The Entis XL default dimensions are metric units.

The Default button within the Change Dimensions module will restore the
default settings for the module in which it was loaded.

It does not return all modules to default units.

In order to return to defaults for the whole application the user would have to
visit all modules and restore defaults using the Change Dimensions module.

The default units are displayed in the following display.

Copyright © 2004 Enraf Ltd Page 86 of 174


11.0, DC Host

The DC Host module is required for both standalone and client server
configurations.

In a standalone environment the DC Host module is run on the same P.C as


the Entis XL client modules.

In a client server environment the DC Host module is run on the P.C


dedicated as the database server.

The DC Host module is responsible for collecting data from the Datacon,
calculating Tank Inventory, originating alarms and events, and processing
command requests from the Entis XL client.

The connection between the DC Host module and the Datacon is normally by
means of a physical hard wired serial interface connection.

The DC Host has the responsibility of determining the status of all gauge and
system alarms. Furthermore the DC Host module writes to the Events
database.

Copyright © 2004 Enraf Ltd Page 87 of 174


11.1, Starting DC Host

DC Host runs as a service therefore when the PC is restarted DC host


automatically starts.

In the system tray you will see the icon for DC Host.

Double Click the DC host icon in Control Panel, this will bring up the following
screen: -

Copyright © 2004 Enraf Ltd Page 88 of 174


Click on the Comms tab within DC Host and select the port assigned to it,
check the “In Use” box to enable the port and make sure the communication
settings are correct. DC Host will open a connection to the database, and load
all the relevant tank data from the database to enable it to start polling the
Datacon.

If the Datacon is not present an appropriate alarm will be generated at


EntisXL.

If Entis XL is polling for gauges that are not present appropriate alarms will be
generated.

If gauges are connected at the time DC Host is started, and assuming the
Datacon has been correctly installed and configured, real gauge data should
be displayed in the DC Host monitor window.

The DC Host module will also update the database with tank data. This is
done by change only. For example, if no data has changed from the last write
no data will be written.

Copyright © 2004 Enraf Ltd Page 89 of 174


11.2 Stopping the DC Host.

Double Click the DC host icon in Control Panel, this will bring up the following
screen: -

To stop the DC Host click on the Stop Services button.

See the screen below to show that DC Host has stopped

You will see the three Service Details have changed to Stopped the button will
change to Start Services and the icon in the system tray will have
disappeared.

To start the DC Host again simply click the Start Services button.

Copyright © 2004 Enraf Ltd Page 90 of 174


11.3, The DC Host Display Window

To view the DC Host Modcon Monitor double click the DC Host icon in the
System Tray, this will bring up the following screen; -

11.4, Viewing Communications

The DC Host module allows the user to view the data communications that
occurs between the P.C and the Datacon.

From the drop down list select the COM port you chose for communication,
e.g. Com 1.

In here you will see the list of tanks being polled by the datacon.

Viewing data in the DC Host Modcon Comms Monitor is only really useful for
maintenance and diagnostic reasons.

For general operations we do not recommend using the DC Host Modcon


Monitor.

Copyright © 2004 Enraf Ltd Page 91 of 174


11.4.1, Watching a Specific Tank

Sometimes it is useful to watch a specific tanks data.

Click on the Tank number you wish to view, e.g. Tank 1: -

Each time the Entis XL polls the Datacon for that tank the response and data
will be captured and displayed.

The transmitted data from the Datacon can then be analysed.

A detailed knowledge of the Datacon protocol is required for this.

Copyright © 2004 Enraf Ltd Page 92 of 174


12.0, Help and Diagnostics

Entis XL contains a comprehensive help and diagnostics system to aid the


user.

Much of the help appears under the Help menu of the main application tool
bar.

This should be used in conjunction with your user documentation as a first


source of information for assistance.

Following that if a problem persists or you are unable to find a solution to your
requirement please contact your nearest distributor.

The options available under the Help menu are detailed in the following
sections.

12.1, Diagnostics

The Help menu on the main home page menu bar contains a selection called
Diagnostics.

When selected this menu item will load a display module showing a list of the
Diagnostic codes and a corresponding brief description and or definition of the
diagnostic.

Copyright © 2004 Enraf Ltd Page 93 of 174


12.1.1, Launching the Diagnostics Module

Select the Diagnostics option from the Help menu on the main home page
menu bar.

The following type of display will be loaded: -

The first column lists the diagnostic code, the second column contains a brief
definition, and the final column references a file name that contains more
detailed information on the potential causes of the Diagnostic and
recommended action to identify and fix any associated problem.

Press the Exit button to unload the module.

Copyright © 2004 Enraf Ltd Page 94 of 174


12.1.2, Pre-viewing the Diagnostic List

Select the Print Preview option from the File menu.

The following type of display will be loaded.

Press the Printer icon to send the report to the Windows default printer.

Copyright © 2004 Enraf Ltd Page 95 of 174


12.1.3, Printing the Diagnostic List

Select the Page Setup option from the File menu

The following type of display will be loaded.

Choose the required printer properties and page orientation.

Select the Printer button to select an alternate printer.

Press the OK button to save page setup.

Select the Print option from the File menu to print the Diagnostics List.

Copyright © 2004 Enraf Ltd Page 96 of 174


12.1.4, Launching the Recommended Action File

Double click the row of interest.

This will launch Windows Notepad and open the Recommended Action File.

See the illus tration below for a typical example.

Copyright © 2004 Enraf Ltd Page 97 of 174


12.2, Versions

The Help menu on the main home page menu bar contains a selection called
Versions.

When selected this menu item will load a display module showing the
versions of each of the modules of the Entis XL application. Further it will also
show the modified date for each of the modules as well.

This information is invaluable to any technical support calls made to your


supplier.

One of the first questions on any support call will inevitably be what version of
the module in question is installed on your machine.

Indeed the full list of modules and their corresponding versions and modified
dates can be printed.

Copyright © 2004 Enraf Ltd Page 98 of 174


12.2.1, Launching the Versions Module

Select the Versions option from the Help menu on the main home page menu
bar.

The following type of display will be loaded:-

Use the scroll bars to view the details of each of the files listed.

Press the Exit button to unload the module.

Copyright © 2004 Enraf Ltd Page 99 of 174


12.2.2, Pre-viewing a Report of the Module Versions

Select the Print Preview option from the File menu.

The following type of display will be loaded.

Press the Printer icon to send the report to the Windows default printer.

Copyright © 2004 Enraf Ltd Page 100 of 174


12.2.3, Printing a Report of the Module Versions

Select the Print option from the File menu.

The following type of display will be loaded.

Choose the required printer properties and page orientation.

Select the Printer button to select an alternate printer.

Press the OK button to send the report to the default Windows printer.

Copyright © 2004 Enraf Ltd Page 101 of 174


12.3, About

The Help menu on the main home page menu bar contains a selection called
About.

When selected this menu item will load a display module showing the overall
version number of your application, the licence details and the
person/Company the Entis XL application is registered to, including a
statement on copyright.

This information is invaluable to any technical support calls made to your


supplier.

One of the first questions on any support call will inevitably be who the
registered user is and the license/build number of the complete application.

12.3.1, Launching the About Module

Select the About option from the Help menu on the main home page menu
bar.

The following type of display will be loaded:-

Press the OK button to unload the module.

Copyright © 2004 Enraf Ltd Page 102 of 174


13.0, Trending

Key Features

* Up to six simultaneous trends on one graph

* Independent axes for each process variable

* Display grid for better reading

* Data cursor for reading trend values

* Supports dynamic multi-dimensions

* Drill down into data with Zoom function

* Scroll backwards and forwards in time

* Operator programmable Y axis extents

* Operator programmable time base

Copyright © 2004 Enraf Ltd Page 103 of 174


13.1, Trending and Data Logging

Entis XL comes as standard with a comprehensive trending package.

Trending comprises three main application modules:-

1. TrendLogger.exe
2. RealtimeTrending.exe
3. HistoricalTrending.exe

TrendLogger.exe must be run at all times. In a Client-Server architecture the


TrendLogger component will be installed and run server side as part of the
Entis XL server installation. In a standalone installation the TrendLogger
component will be run on the same machine as all other components.

RealtimeTrending and HistoricalTrending are the trend display modules and


are the users view on the trend data being produced by the trend logger
application.

RealtimeTrending and HistoricalTrending can be launched as required by the


user.

Copyright © 2004 Enraf Ltd Page 104 of 174


13.2 Trend Logger

The TrendLogger application module is responsible for logging trend data to


files located on a hard drive.

In a standalone installation of Entis XL the trend files will be located on the


local hard drive of the P.C.

On multi-station systems and full client server applications, trend files may be
located centrally at a file or database server.

TrendLogger is programmed to log changes in data rather than continuously


logging data at some fixed interval. Therefore, the size of each log file is
determined by the rate at which a tank’s data changes.

Trend data is stored in daily log files. A log file exists for every tank in the
system database. At midnight each day, a new trend log file is created. The
filenames of the log files are generally of the form:-

TK123ddmmyyyy.txt

TK123 represents the tank identity, and ddmmyyyy represents the day, month
and year.

13.2.1 Launching the Trend Logger Application

The TrendLogger module is normally launched automatically after starting up


the P.C that it is installed on.

In a Client-Server installation the server would normally be configured to


launch the TrendLogger module automatically on startup.

In a standalone installation the Entis XL Client module can be configured to


automatically start the TrendLogger module at startup. See the System
Settings module.

Whilst running, the TrendLogger module has a very basic and simple display
interface illustrated below.

It comprises File, Login and Logout menu options.

The Event window and status bar display diagnostic information associated
with the TrendLogger module.

Copyright © 2004 Enraf Ltd Page 105 of 174


The TrendLogger module can only be shutdown by those users who have
administrative privileges.

To shutdown the TrendLogger module:-

Login with an administrative account.

Select the Login menu.

Enter a username and password.

Select the File ->Exit menu option.

The TrendLogger module will be unloaded.

NOTE: whilst the TrendLogger module is not running no data will be recorded
for any tank. Consequently this will cause loss of data and may affect the
performance of the Trend view applications.

Copyright © 2004 Enraf Ltd Page 106 of 174


13.3 Real-time Trending

The real-time trending function combines the ability to review up to the last 24
hours worth of historical trend data with current real-time data.

13.3.1 Starting up Real-time Trending

Click the real-time trending tool bar button.

The real-time trend display will be loaded.

It will be loaded without any trend data.

See the illustration below for a typical example.

Copyright © 2004 Enraf Ltd Page 107 of 174


13.3.2 Configuring the Real-time Trending Display

Click the real-time trending tool bar button in the real-trending display.

The real-time trend configuration module will be loaded.

See the illustration below for a typical example.

Select trend

Up to six tanks can be configured to display either live or calculated


information as a trend.

Select a Tank from the drop down list.

Select the process variable for the tank to be trended.

You may also enter an optional maximum and minimum value for the y axis.
The smaller the range between the minimum and maximum values the more
detail that can be seen.

Enter an interval of time in hours that equates to the amount of history you
want displayed along with the new real-time data. The real-time data will
simply be appended to the history.

Click the OK button.

The trend display will be configured to display the data requested.

Copyright © 2004 Enraf Ltd Page 108 of 174


There may be a short delay loading the historical portion of the data. This will
be dependent on how many hours have been specified, the number of trends,
the location of the trend files, and the quantity of trend data.

The progress of loading the data will be reported through the status bar of the
configuration form.

The trend configuration module will be unloaded.

See the illustration below showing example trend data.

Copyright © 2004 Enraf Ltd Page 109 of 174


13.3.3 Using the Real-time Trend View Display

Once the trend configuration is complete and the trend view display has been
configured, the display of real-time trend data will commence immediately.

The trend scrolls right to left. The right hand side being current time.

New data will be appended to the right hand side of the display.

The number of process variables selected will determine the number of Y


Axes plotted on the view, and therefore the number of trends displayed.

Each trend will be displayed in a unique colour.

13.3.4 Finding a Value on a Trend

A data cursor is provided to allow the user to find individual sample values on
the trends.

You will notice in the top left hand corner of the display there are two numeric
fields that are refreshed as the mouse pointer is moved within the graph area.

The mouse pointer can be used to view the value of a plotted process variable
at any point by pointing at it and reading the values of the two fields. The first
value will be the time, the second value the actual trend reading.

Alternatively, if the mouse is pointed at a trend and moved along the trend
until the mouse pointer resembles a “hand”, this signifies that a data point has
been found. At this point press the left mouse button and a data cursor will
appear. The data cursor can now be moved horizontally along the trend using
the left and right arrow keys.

At each data point the time stamp and value will be displayed in the top left
area of the display as described above.

If more than one trend is currently on display the up and down arrow keys can
be used to transfer the data cursor to adjacent trends.

Copyright © 2004 Enraf Ltd Page 110 of 174


See the annotated illustration below for information.

Trend Selection

Change Dimensions

Time and Date Stamp for Data Point

Real Time Trend

Data
Cursor

Print

Copyright © 2004 Enraf Ltd Page 111 of 174


13.3.5 Zooming In to More Detail

The trend module allows the user to drill down into the trend data and view
trends in more detail.

Identify the area of the trend where you require more detail.

Using the mouse, draw a box around the area of interest by pointing and
clicking the left mouse button. While holding the left mouse button down drag
the mouse pointer to the right or left and you will see a sizable box appear.
Extend this box around the area of interest and release the mouse button.

The system will zoom in to the area selected. You will notice that a horizontal
scroll bar appears allowing you to move backwards and forwards across the
data at the current zoom level.

You can zoom in further as required using the same technique.

13.3.6 Zoom Out to Default View

You can zoom back out to the initial default view as follows.

Right mouse click anywhere on the trend graph. A popup menu will appear.

Select the Undo Zoom option.

Copyright © 2004 Enraf Ltd Page 112 of 174


13.4 Historical Trending

The historical trending function allows the user to view historic trend data over
a time span for which data exists. Clearly the longer a system has been in
service the more trend data there will be.

The trend data files are generally relatively small but there size is a function of
the frequency of data change.

Modern P.C’s have large hard drives and consequently have the capability of
storing a lot of data. In most circumstances a typical P.C’s hard drive will
accommodate several years worth of trend data, however this does depend
on the number of tanks and the rate of data change.

13.4.1 Starting up Historical Trending

Click the historical trending tool bar button.

The historical trend display will be loaded.

It will be loaded without any trend data.

See the illustration below for a typical example.

Copyright © 2004 Enraf Ltd Page 113 of 174


13.4.2 Configuring the Historical Trending Display

Click the historical trending tool bar button in the historical trending display.

The historical trend configuration module will be loaded.

See the illustration below for a typical example.

Select data for Historical Trending


Date and time selection

Up to six tanks can be configured to display either live or calculated


information as a trend.

Select a Tank from the drop down list.

Select the process variable for the tank to be trended.

You may also enter an optional maximum and minimum value for the y axis.
The smaller the range between the minimum and maximum values the more
detail that can be seen.

The Start and End dates will be set to the current system date. The Start Time
will be one hour prior to the current system time and the End Time will be the
current system time.

Set the Start Date/Time and End Date/Time. The historical trend data will be
loaded for the specified period.

Click the OK button.

The trend display will be configured to display the data requested.

Copyright © 2004 Enraf Ltd Page 114 of 174


There may be a short delay loading the historical data. This will be dependent
on length of time specified, the number of trends, size of the trend files, and
the location of the trend files.

The progress of loading the data will be reported through the status bar of the
configuration form.

The trend configuration module will be unloaded.

See the illustration below showing example trend data.

Copyright © 2004 Enraf Ltd Page 115 of 174


13.4.3 Using the Historical Trend View Display

The historical trend data display supports the data zoom feature allowing the
user to initially take an overview of trend data and then drill down into the
detail for closer analysis.

The number of process variables selected will determine the number of Y


Axes plotted on the view, and therefore the number of trends displayed.

Each trend will be displayed in a unique colour.

13.4.4 Finding a Value on a Trend

A data cursor is provided to allow the user to find individual sample values on
the trends.

You will notice in the top left hand corner of the display there are two numeric
fields that are refreshed as the mouse pointer is moved within the graph area.

The mouse pointer can be used to view the value of a plotted process variable
at any point by pointing at it and reading the values of the two fields. The first
value will be the time, the second value the actual trend reading.

Alternatively, if the mouse is pointed at a trend and moved along the trend
until the mouse pointer resembles a “hand”, this signifies that a data point has
been found. At this point press the left mouse button and a data cursor will
appear. The data cursor can now be moved horizontally along the trend using
the left and right arrow keys.

At each data point the time stamp and value will be displayed in the top left
area of the display as described above.

If more than one trend is currently on display the up and down arrow keys can
be used to transfer the data cursor to adjacent trends.

Copyright © 2004 Enraf Ltd Page 116 of 174


See the annotated illustration below for information.

Trend Selection
Change Dimensions

Time and Date Stamp for Data Point

Historical Trend

Data Cursor

Print

Copyright © 2004 Enraf Ltd Page 117 of 174


13.4.5 Zooming In to More Detail

The trend module allows the user to drill down into the trend data and view
trends in more detail.

Identify the area of the trend where you require more detail.

Using the mouse draw a box around the area of interest by pointing and
clicking the left mouse button. While holding the left mouse button down drag
the mouse pointer to the right or left and you will see a sizable box appear.
Extend this box around the area of interest and release the mouse button.

The system will zoom in to the area selected. You will notice that a horizontal
scroll bar appears allowing you to move backwards and forwards across the
data at the current zoom level.

You can zoom in further as required using the same technique.

13.4.6 Zoom Out to Default View

You can zoom back out to the initial default view as follows.

Right mouse click anywhere on the trend graph. A popup menu will appear.

Select the Undo Zoom option.

Copyright © 2004 Enraf Ltd Page 118 of 174


14.0, Inventory Calculator

Entis XL comes as standard with an Inventory Calculator.

The primary purpose of the Inventory Calculator is to provide the user with a
means of calculating tank inventory for conditions that do not currently exist.

For example, it could be used as a “what happens if” calculator, if a tank were
to receive or load X litres of product what would the final tank conditions be.

It may be used as a simple planning tool prior to the loading and/or receipt of
product.

Copyright © 2004 Enraf Ltd Page 119 of 174


14.1, Launching the Inventory Calculator Application

Press the Inventory Calculator tool bar button.

The Inventory Calculator module will be loaded. See the illustration below for
a typical example.

The Inventory Calculator is a multi-tabbed display comprising the


straightforward tank calculator, the loading/receipt movement calculator, a
linear interpolation calculator, and a Unit/Dimension conversion utility.

The Change Dimensions module has been integrated with the Inventory
Calculator such that the user can view and enter data in dimensions of choice.

Copyright © 2004 Enraf Ltd Page 120 of 174


14.2, Tank Calculator

The tank calculator provides the user with the facility of calculating tank
inventory at user specified conditions.

14.2.1, Viewing Current Tank Data

Select a tank from the drop down list.

The current tank gauging and inventory data will be displayed for the selected
tank along with the API/ASTM table currently configured for the tank.

Copyright © 2004 Enraf Ltd Page 121 of 174


14.2.2, Entering User Defined Criteria

The user can enter the following data:-

Product Level
Product Temperature
Product Density
Water Level
Pressure
Molecular Mass
Temperature Coefficient
Density Correction Factor
API Table

Some of the data fields are not always applicable to the API Table selected.

The fields that can be edited are clearly marked on the display in a white
background.

Modify one of the editable fields.

For example, to view the tank inventory at a different product level, simply
delete or over type the current level reading with the new one and press the
Calculate button.

The Inventory parameters will be re-calculated for the new data.

The user configurable data will be validated prior to doing the calculations.

For example, if the level goes beyond the operating extents of the tank a
warning will be generated in the status bar along with an audible sound. The
description of the warning should be sufficient to determine the error. In most
cases the maximum or minimum limit will be displayed where applicable.

Copyright © 2004 Enraf Ltd Page 122 of 174


14.3, Movement Calculator

The movement calculator provides the user with the facility of simulating a
receipt or load of product to from the tank.

Prior to entering the movement details select a tank from the list. The current
tank conditions will be displayed.

The movement can be specified as a direct level change, a load/receipt by


volume, or a load/receipt by mass.

Further the user needs to specify whether it is a load (movement out) or


receipt (movement in) in order that the final conditions can be calculated
correctly.

Finally, the user enters the quantity to be loaded or received.

When all data has been provided press the Calculate button to see the tanks
final values.

Copyright © 2004 Enraf Ltd Page 123 of 174


14.3.1, Simulating a Receipt of Product

Select the receipt tank from the list.

Click on the Receipt option button.

Select the appropriate option for Measurement i.e. by Volume, Weight of


Level.

For example, lets assume we are going to receive a known volume from a
pipeline. Select the Volume option.

Enter the Quantity as the volume to be received.

The units by which the volume will be interpreted are those set in the Change
Dimensions module.

Let’s assume the volume dimensions are set to litres.

Press the Calculate button.

The Inventory Calculator will go to the Tank Calibration data for the selected
tank and determine the change in level for the given volume. The change in
level will be applied to the tanks current conditions to determine the final
conditions.

Therefore the calculated level, and inventory data will be those conditions
expected after the completion of the movement of product.

The calculation of the final conditions will be checked against the tank
operating limits and should any of the normal working limits be violated, an
error will occur and the user will be warned with a detailed message.

Copyright © 2004 Enraf Ltd Page 124 of 174


14.4, Interpolation

The tab marked interpolation is a very simple linear interpolation calculation


tool. Its purpose is to allow the user to enter data directly from a set of tank
calibration charts and calculate the volume at an unknown level by simple
linear interpolation.

Copyright © 2004 Enraf Ltd Page 125 of 174


14.5, Unit Conversion

The Definitions tab contains a simple means of converting from one


dimension to another dimension e.g. converting a level in mm to a level in feet
inches and sixteenths.

Select the parameter to convert by clicking the appropriate option button e.g.
level, temperature etc.

Select the dimensions to convert from and enter the value to be converted.

Select the dimensions to convert to.

Copyright © 2004 Enraf Ltd Page 126 of 174


Click the Calculate button and the new value will be displayed in the
Dimensions selected.

Copyright © 2004 Enraf Ltd Page 127 of 174


15.0 Movements - Introduction

Entis XL can be provided with a comprehensive suite of tools for the


monitoring and partial automation of bulk liquid movements. They have been
designed to provide the user with a set of tools to monitor the loading and
unloading of liquids to and from a variety of vessels and where possible
provide alarms and warnings of planned and unplanned events.

In general the most critical point of loading and unloading product is the
approach to the target condition. For example for a Receipt the critical time is
as the tank approaches the maximum working level. Clearly, in order to
prevent over filling a tank the user has to switch off pumps and close valves at
the correct time.

The Entis XL movement module has been designed with these issues in
mind.

All common movement types supported:-

Load
Receipt
Transfer
Unit feed
Unit rundown
Drain off
Unauthorised

Loads, Receipts and Transfers are the most common satisfying most users’
requirements.

Unit feed and run down are more specialised movements and are generally
used by refineries. Unit Feed represents a tank feeding the process units. Unit
Run down represents the process unit feeding a tank with finished or
intermediate product.

Drain off movements generally relate to a Water drain off or a Roof drain off.

Unauthorised movements are automatically generated by the system. If the


tank is STATIC, as defined by a user, the system will monitor the tank for any
unauthorised movement. Should movement be detected outside of a pre-
programmed threshold, an unauthorised movement is created and opened to
capture details of the movement.

Each movement type is further sub-divided into classes. For example, the
commonly used classes of a Load type movement are Road, Rail, Pipeline,
Ship etc. This means Loading product from a Tank to a Road Tanker, Rail
Tanker, Pipeline or Ship.

For each type of movement, the data required to configure the movement
varies.

For each class of movement, the data required to configure the movement
varies.

Copyright © 2004 Enraf Ltd Page 128 of 174


All product movements configured and executed are stored providing a full
historical log of all product transactions.

Every movement is allocated a unique reference number for traceability.

The operator controls for monitoring movements are:-

Open
Close
Suspend
Re-open

Opening a movement is the process of changing its state from Planned to


Open, such that all of the tanks opening conditions, including the date and
time, are stored.

Opening a movement also triggers the monitoring and detection of movement


warnings and alarms for that tank, as well as tracking and displaying the live
data values.

Closing a movement changes the movement’s state from Open to Closed,


such that all of the tanks closing conditions, including the date and time, are
stored.

Suspending a movement freezes the current tank conditions and disables


monitoring, perhaps until some other operational procedure is completed, and
then the movement can be Re-opened which will commence monitoring
again. During the time that a movement is suspended no warnings will be
generated.

Multiple movements can be monitored simultaneously.

The Movement module supports fully scalable client server architectures, and
allows multiple users to simultaneously configure, open, monitor, and close
movements.

Each user will see the actions of all other users.

Copyright © 2004 Enraf Ltd Page 129 of 174


15.1 Loading the Movement Module

Normally provision will have been made to load the Movement module from
the Windows Start Menu or from a tool bar button on the tool bar of the host
application such as Entis XL.

Select the appropriate tool bar button to load the movement module.
Alternatively, select View > Movements from the main Entis XL application
window.

The movement display client will be loaded. Initially no movement data will be
displayed.

Existing movements are selected by first choosing the tank they affect, in the
case of transfer movements between tanks, either the source or destination
can be used. The Movement ID and Movement Name drop downs are then
populated with a list of movements for that tank, sorted in reverse Movement
ID order.

Drop down the appropriate list to see the available movements.

Copyright © 2004 Enraf Ltd Page 130 of 174


The Movement display module comprises a multi-tabbed display, including
menu bar and context sensitive pop-up menu.

Each tab contains data relevant to the selected movement.

The leftmost tab contains a graphical illustration of the tank or tanks involved
in the movement, with associated numerical data used to monitor the
progress of the movement. In the case of a transfer movement both the
source and receipt tanks will be displayed.

The numerical data displayed are:-

Product Level

The most recent Product Level supplied by the Tank Gauge

Product Temperature

The most recent Product Temperature supplied by the Tank


Gauge

Product Name

The Product Name/Description previously entered by the user


for the selected tank.

Ullage/Drawable

For a Loading movement the Drawable volume is displayed i.e.


how much product can be delivered before reaching the Tank
minimum. For a Receipt movement the Ullage or Available
Room is displayed.

Flow Rate

The most recently calculated Flow Rate. The Flow Rate can be
selected to be instantaneous or an average. Further the flow
rates can be selected to show level, volume of mass flow.

Target Level

This is an estimate of the product level the tank is expected to


achieve after the movement is complete. It is a guide figure only.

Remaining

The most recently calculated remaining quantity to achieve the


Target condition. The user can select this field to be displayed
as either Volume or Mass.

Actual

The most recently calculated Actual quantity moved since the


movement was opened. The user can select this field to be displayed
as either Volume or Mass.
Copyright © 2004 Enraf Ltd Page 131 of 174
Remaining Time

The estimated time remaining to achieve the target conditions


based upon the remaining quantity and the most recent flow
rate. It is a guide figure only.

ETF

The Estimated Time of Finishing based upon Remaining Time


and the Current Time. It is a guide figure only.

Additionally a red ‘X’ will be super-imposed over the data in the tank mimic
when the levels shown there are not live. This is to prevent operators
inadvertently looking at the level information on the screen, when the
information displayed is for a closed or suspended movement.

The middle tab contains most of the “static” configuration data associated with
the movement.

The rightmost tab contains the opening or current/closing data for the
movement. In the Planned state this tab will contain no data.

In the Open state the Opening data values will be representative of the tanks
start condition at the instant the user issued/selected the Open command, and
the Current values will be the most recent data collected and calculated by the
gauge communications module. In the Closed state the Close values will be
representative of the tanks finish conditions at the instant the user
issued/selected the Close command
Copyright © 2004 Enraf Ltd Page 132 of 174
Copyright © 2004 Enraf Ltd Page 133 of 174
A context sensitive pop-up menu provides the entire operator interface
controls for each movement, though most options are repeated on the main
window menu.

The main pop-up menu has sub-menu’s as shown in the illustration above.

NOTE: Before using the Movement Module use the Change Dimensions
Module to set the Dimensions of data items. Remember the dimensions are
independently set for each of the main modules.

Copyright © 2004 Enraf Ltd Page 134 of 174


15.2 Configuration of Movements

Movements are configured with the aid of the Movement Wizard. The Wizard
is a simple step by step guide prompting the user to enter the required
information in order to successfully configure a movement of the selected type
and class.

Not all data fields are mandatory.

All mandatory fields have to be provided before the configuration of a


movement can be completed.

Select the Configure option from the pop-up menu or main menu.

Make sure the dimensions are set correctly before proceeding.

The first step allows you to configure a new movement from nothing or
alternatively copy the configuration from a previous movement. If you are
configuring multiple movement with similar characteristics the copy option
may save some time.

The following steps assume that a new blank movement will be defined.

The second step asks the user to enter a movement name, type and class
these fields are all mandatory. Also the user is able to enter any notes
specific to the movement.

The Movement Name and Notes fields require the user to enter text.
Copyright © 2004 Enraf Ltd Page 135 of 174
The Movement Type and Movement Class fields are pre-configured selection
lists.

The Movement Name field is optional, the system will automatically generate
a name if one is not provided.

The third step is dependant upon the movement type and class previously
selected. The example shown is a Load this will mean that the source is a
tank hence a Tank Id must be selected from the drop down list. A Destination
must also be given, this is dependant up on the class. In this case it is a Load
to Ship which means that a ship name is asked for.

Copyright © 2004 Enraf Ltd Page 136 of 174


The next step allows the user to choose whether they wish to specify a stop
gauge or just fill or empty the tank. A requirement for the operator to take a
sample of the product can also be flagged on this step. Note that the fill and
empty options availability is dependant on the type of movement that is being
configured.

Filling a tank is defined as moving the product level in the tank to the
configured maximum operating level, emptying a tank is defined as moving
the product level to the tank’s configured minimum operating level, not to strip
the tank.

The next step requires the user to enter a stop gauge or planned quantity.
This can either be given as a level, volume or mass. From this, the Target
Level, Planned Volume and Planned Mass can be calculated as appropriate.
The default setting is by volume.

This step will be skipped if the Fill or Empty option was chosen on the
previous screen.

Depending on the type of Movement , the user will be given fields in which to
enter the Owner, Customer and Nomination number.

Copyright © 2004 Enraf Ltd Page 137 of 174


The next step asks the user to select the type of report, the flow rate to be
used, and whether a movement log is required.

Finally a summary of the movement configuration is shown, at this point the


changes to the configuration data are possible. Press the Finish to create the
movement.

Copyright © 2004 Enraf Ltd Page 138 of 174


15.3 Monitoring Movements

The control and monitoring of movements is a user responsibility. For


example the decision of when to open a movement is the users’.

In order to correctly capture the detail of a product movement the user must
therefore plan, open and close movements at the correct times. For example,
for a receipt of product from a ship, the user must open the movement prior to
any cargo being discharged into the tank.

However, the opening and closing figures for any movement can be modified
to reflect the true conditions both before and after a movement.

15.4 Planned Movements

15.4.1 Opening

Select the movement to be opened.

Right mouse click the tank. Select the Open option from the menu.

Prior to opening a number of safety/validity checks will be made e.g. will the
target level be greater than the max operating level. If they all pass the open
request will be executed.

The opening actions will be performed and the status will change to opened.

The opening/current tank conditions can be viewed in the Movement Data tab.

Only a planned movement can be Opened, all other options will be


unavailable.
Copyright © 2004 Enraf Ltd Page 139 of 174
15.4.2 Closing

Select the movement to be closed.

Right mouse click the tank.

Select the Close option from the menu.

The closing actions will be performed and the status will change to closed.

The closing tank conditions can be viewed in the Movement Data tab.

Copyright © 2004 Enraf Ltd Page 140 of 174


Only open/re-open/suspended movements can be Closed, all other options
will be unavailable.

Copyright © 2004 Enraf Ltd Page 141 of 174


15.4.3 Suspending

Select the movement to be suspended.

Right mouse click the tank.

Select the Suspend option from the menu.

The suspend actions will be performed and the status will change to
suspended.

Only open/re-open movements can be suspended, this option is unavailable


for movements in other statuses. There is no limit to the number of times a
movement can be suspended and re-opened.

15.4.4 Re-opening

Select the movement to be re-opened.

Right mouse click the tank.

Select the Re-Open option from the menu.

The re-opening actions will be performed and the status will change to re-
opened. Note that the target conditions are recalculated to negate any
changes to level or temperature which occur in the tank between the time it
was suspended and the time it was re-opened.

If the movement was by volume or mass, the target level will be adjusted so
that the remaining volume when the movement was suspended and when it is
re-opened will be consistent. If the movement is by level, then the planned
volume will be adjusted to reflect the changes in tank conditions, to attain the
target level.

Only a Suspended movement can be Re-opened, this option will be


unavailable to movements in other statuses.

15.4.5 Cancelling

Select the Movement to be cancelled.

Right mouse click the tank.

Select the Cancel option from the menu.

The cancel actions will be performed and the status will change to cancelled.

Only a Planned Movement can be cancelled, this option is unavailable to movements in other
statuses.

Copyright © 2004 Enraf Ltd Page 142 of 174


15.5 Movement Warnings and Alarms

The Movement module provides a comprehensive range of integrated


warnings and alarms.

The Entis XL movement module allows generally two types of “early warning”
to be generated; a warning as a function of time remaining to achieve the
target level, and secondly, a warning based upon the level remaining to
achieve the target level. Clearly the time remaining is based upon the
estimated current flow rate and the calculated remaining quantity; the level
remaining is based upon the current known level and the calculated target
level.

The Entis XL movement module can also provide two warnings based upon a
user defined high and low flow rate.

Finally, for Transfer movements only, two additional warnings are provided; a
warning will occur if the flow rate of the source and receipt tanks varies
beyond a pre-programmed tolerance, or the difference in volume moved
between the source and receipt tanks exceed a pre-programmed tolerance.
Clearly, the flow rate tolerance will be detected whilst the movement is open
and the difference in volumes is determined when the transfer is closed.

All of the above have significant dependency on:-

Accurate flow rates

Accurate levels

Accurate strapping tables

The difficulty in achieving accurate flow rates and levels is related to where
the parameters are measured/calculated and the time lag in presenting the
data to the unit that makes the decisions.

In a real situation the time lags can be quite significant.

Each installation will be different generally dependant on numbers and types


of gauges and communications speed and integrity.

NOTE: these warnings are intended to be used as a guide only and


should not form part of a safety system.

Copyright © 2004 Enraf Ltd Page 143 of 174


15.6 Viewing Movement Summaries

Select View > Summary Of Movements

The time and date range defaults to midnight and the date/time the display
was loaded; consequently any movements for that period will be displayed.

Modify the time and date range as required. As the time and date is varied the
list of movements will change dynamically to suit the new criteria.

When the window opens no movements are displayed until some criteria are
specified. Initially the Movement Ref. criteria are disabled until the check box
that accompanies their use is selected. The criteria can be combined, for
instance it is possible to display all open transfers using both the Movement
Type and Movement Status criteria.

Double-clicking on the rows in the result grid will cause the selected
movement to be displayed on the main movement window.

Copyright © 2004 Enraf Ltd Page 144 of 174


15.7 Movement Reports

A range of reports can be provided. As standard the movement module


comes with a report summarising the important details of the tank movement;
this generally includes the opening and closing conditions, the calculated
transfer values, and some of the configuration data.

The reports can be customised to meet individual customer requirements.

15.7.1 Printing/Viewing the Standard Movement Report

Select the required movement.

Select the Print or Print Preview option from the menu.

Copyright © 2004 Enraf Ltd Page 145 of 174


15.8 Summary of Open Movements

The movement module provides a quick and easy means of viewing a


summary of all movements that are open. On large sites where there are
many simultaneous movements this is very useful.

Select the View->Open Movements menu.

The following display will be loaded.

Copyright © 2004 Enraf Ltd Page 146 of 174


15.9 Movement Log

The Movement Log provides the user with a profile of a tank movement by
regularly logging Product Level, Product Temp, Flow Rate throughout the full
duration of a tank movement.

The Movement Log is optional in that the user determines whether it is


required during the movement configuration procedure. The Default is no
logging.

Data in the Movement Log can be viewed by tank over a selectable date and
time range.

The interval at which the data is logged is a choice by the user. The available
choices are on the minute or on the hour.

15.9.1 Viewing/Printing the Movement Log

Select the View > Movement Log menu.

The following display will be loaded.

To view the movement log data for a particular Tank and date and time, make
the appropriate selections in the start/stop Date selectors and Tank List.

Copyright © 2004 Enraf Ltd Page 147 of 174


From the File menu select the Print/Preview options to view or print the
selected data.

Copyright © 2004 Enraf Ltd Page 148 of 174


15.10 Movement Settings

Movements settings apply to each movement.

Therefore movement settings can only be set for a particular movement.

Select the Movement Settings option from the Actions menu or the pop-up
menu.

Movement settings can be configured prior to opening a movement or whilst


the movement is open and being monitored.

15.10.1 Defaults

The defa ult values when Entis XL is first installed for each field are: -

The First Time Alarm – 0 min


The Second Time Alarm – 0 min

The Level Alarm – 0 mm from target

The High Flow Alarm –0 mm/min


The Low Flow Alarm – 0 mm/min

The alarms are also disabled by default. The defaults are engineer
configurable, you should speak to your site administrator to have them
reconfigured.

15.10.2 Changing the Movement Settings

Press the Edit button.

The user must be logged on with the correct privileges.

Edit the required fields. Press the Save button.

The new settings will take effect immediately for the selected movement.

Copyright © 2004 Enraf Ltd Page 149 of 174


15.11 Unauthorised Movement Detection

Unauthorised Movement Detection works in a similar manner to the Leak


Alarms (see Section 5.6) however instead of simply raising an event for the
operators, it creates an unauthorised movement.

It is a feature of the system that use of the Leak Alarms, is not compatible with
Unauthorised Movement Detection, since one automates the actions required
to be performed by the other. Sites should therefore consider which way they
want to manage unplanned changes in tank conditions, and opt for one
method or the other.

When movements are opened or re-opened on a tank the tank’s status is


automatically set to “Moving” as long as the movement will result in a change
of level in the tank. It should be noted that transfer movements, which specify
the same tank as both source and destination, specifically, do not result in the
tank becoming “Moving”. When all movements on a tank are suspended or
closed the tank’s status is automatically set to “Static”.

During the normal course of its operation the DCC comms monitors the Gross
Standard Volume of Static tanks, when Unauthorised Movement Detection is
enabled and when a change occurs that is in excess of the user configurable
tolerance for the tank an Unauthorised Movement is created and opened.

The opening of the Unauthorised Movement causes the tank status to


become “Moving” and prevents the creation of further Unautho rised
Movements. The operators must provide an explanation for the Unauthorised
Movement in the movement’s notes field; before it can be closed.

It should also be noted that Unauthorised Movements, by definition cannot


have a stop gauge. They therefore do not generate any other events, once
they have been created.

Copyright © 2004 Enraf Ltd Page 150 of 174


15.11.1 Configuring Unauthorised Movement Detection

Unauthorised Movement Detection is enabled/disabled from the Entis XL


system settings window. Log in to Entis XL as an Administrator, and choose
Admin > System Settings.

Click ‘Edit’

Change the ‘Automatically generate unauthorised movements’ setting.

Click ‘Apply’

Copyright © 2004 Enraf Ltd Page 151 of 174


15.11.2 Configuring the Leak Threshold

The threshold for the creation of unauthorised movements is controlled from


the Alarm Configuration window.

Click

Select the tank you wish to configure the leak threshold for.

Select the ‘Movement Alarms’ tab.

Click ‘Edit’

Edit the ‘Threshold’ value.

DO NOT ALTER THE ‘Enabled’ SETTING. Doing so may reset the leak start
value stored in the system, against which the current gross standard volume
is compared to determine when the alarm becomes active. You only need
alter this setting if you are NOT using unauthorised movement detection.

Copyright © 2004 Enraf Ltd Page 152 of 174


16.0, Gauge Command Scheduler

The Gauge Command Scheduler is an optional Entis XL feature.

The Gauge Command Scheduler is a standalone application that can be


configured to send gauge commands at a specific time of day on a recurring
basis.

The Gauge Commands can be sent to a Single Tank, all Tanks, or a group of
tanks generally specified by Gauge Type or Tank Group.

Care should be exercised when scheduling gauge commands, particularly


those that affect a gauges primary measuring capability, as the tank may be
involved in some sort of critical operation such as receiving product from a
ship or similar.

Copyright © 2004 Enraf Ltd Page 153 of 174


16.1, Launching the Gauge Command Scheduler

The Gauge Command Scheduler can be launched by:-

Selecting the Gauge Command Scheduler option from the Programs


menu

Double clicking the GaugeCommandScheduler.exe file normally


resident in the Entis XL target folder.

Double clicking a short-cut to the GaugeCommandScheduler.exe file


on the desktop.

Alternatively, the Gauge Command Scheduler could be launched when a user


logs in to Windows by placing a shortcut into the Start menu of the All Users
profile or using the Automatic start-up module provided by Entis XL.

When launched the Gauge Command Scheduler display will be minimized


and shown on the Windows tool bar. It will appear as a small icon in the
System Tray. If you hover over the icon a tool tip will be displayed indicating
that it is the gauge command scheduler.

If you right mouse click on the icon and select the Restore option from the
pop-up menu the Gauge Command Scheduler display will be loaded onto the
desktop as shown in the following illustration.

NOTE: The Gauge Command Scheduler must be running at all times


otherwise scheduled commands will not be sent at the prescribed times.

Copyright © 2004 Enraf Ltd Page 154 of 174


16.2, General Operation of the Gauge Command Scheduler

When the Gauge Command Scheduler is launched it looks to the Entis XL


database to retrieve the details of any configured schedules, if any.

If there are any commands configured, the Scheduler will determine if any are
due or not; those that are due will be processed, and the next Command due
will be calculated and displayed in the Scheduler window.

Each time a Command becomes due it will be sent to the appropriate devices
and for the recurring commands the due date will be advanced by one day.
The next due Command will be calculated and displayed.

Copyright © 2004 Enraf Ltd Page 155 of 174


16.3, Viewing Scheduled Commands

From the Gauge Command Scheduler module select the Scheduler


Configuration option from the Command Scheduler menu.

The following display module will be loaded:-

This module lists all the currently configured commands and there due date
and time.

The Edit and Exit buttons should be highlighted.

The Delete and Save buttons will become highlighted when in Edit mode.

In order to enter Edit mode you must be logged in as a user with sufficient
access rights to modify data.

Copyright © 2004 Enraf Ltd Page 156 of 174


16.4, Adding Commands to the Schedule

From the Scheduler Configuration module press the Edit button.

If you are not currently logged on as a user with sufficient rights you will be
prompted to log on.

When your login credentials have been accepted the Save and Delete
buttons will be highlighted and an extra edit row will be appended to the list.

Click on the Date and Time field and enter the Date and Time the command
should be executed.

Click on the Tank Id field; this field allows a number of different types of
selections detailed as follows:-

Gauge Type – allows the user to send a command to all gauges of a


specific type. For example, a Servo Check could be sent to all Enraf
854 Servo Gauges. The Parameters field is used to specify the type of
tank gauge.

All Tanks – allows the user to send a command to all tanks in the
system. This is generally not recommended for large sites.

Tank Group - allows the user to send a command to a pre-configured


Tank Group. The Tank Group can contain any selection of tanks as
defined by the user. The Parameters field is used to specify name of
the Tank Group.

Single Tank – allows the user to select a single tank from the drop
down list.

Click on the Parameters field, if enabled, and provide the additional


information required generally as detailed in the above descriptions of the
Tank Id field.

Click on the Gauge Commands field and select the required command from
the drop down list. This command will be sent to all Tanks specified in the
Tank Id and Parameters fields at the prescribed time.

Select the Recurring check box if you require the command to occur at the
same time every day.

When all of the required entries have been made press the Save button to
save the changes to the database.

The next Command due will be calculated and displayed in the Command
Scheduler module.

Copyright © 2004 Enraf Ltd Page 157 of 174


16.5, Deleting Commands from the Schedule

From the Scheduler Configuration module press the Edit button.

If you are no t currently logged on as a user with sufficient rights you will be
prompted to log on.

When your login credentials have been accepted the Save and Delete buttons
will be highlighted and an extra edit row will be appended to the list as shown.

Highlight the Command to be deleted by selecting the corresponding row in


the grid by pointing and clicking on the left hand side of the row.

This will be indicated by the arrow head on the left hand side of the row, and
the row being highlighted in blue.

Press the Delete button followed by the Save button. The Command will be
removed from the grid and the Entis XL database.

Copyright © 2004 Enraf Ltd Page 158 of 174


17.0, Report Scheduler

The Report Scheduler is an optional Entis XL feature.

The Report Scheduler is a standalone application that can be configured to


provide reports at a specific time of day on a recurring basis.

17.1, Launching the Report Scheduler

The Report Scheduler can be launched by: -

Selecting the Report Scheduler option from the Programs menu

Double clicking the ReportScheduler.exe file normally resident in the


Entis XL target folder.

Double clicking a short-cut to the ReportScheduler.exe file on the


desktop.

Alternatively, the Report Scheduler could be launched when a user logs in to


Windows by placing a shortcut into the Start menu of the All Users profile or
using the Automatic start-up module provided by Entis XL.

When launched the Report Scheduler display will be minimized and shown on
the Windows tool bar. It will appear as a small icon in the System Tray. If you
hover over the icon a tool tip will be displayed indicating that it is the report
scheduler.

If you right mouse click on the icon and select the Restore option from the
pop-up menu the Report Scheduler display will be loaded onto the desktop as
shown in the following illustration.

NOTE: The Report Scheduler must be running at all times otherwise reports
will not be spooled.

Copyright © 2004 Enraf Ltd Page 159 of 174


17.2, General Operation of the Report Scheduler

When the Report Scheduler is launched it looks to the Entis XL database to


retrieve the details of any configured schedules, if any.

If there are any reports configured, the Report Scheduler will determine if any
are due or not; those that are due will be spooled to the current Windows
default printer, and the next report due will be calculated and displayed in the
Report Scheduler window.

Each time a report becomes due it will be spooled to the default Windows
printer and the due date will be advanced by one day. The next due report will
be calculated and displayed.

Therefore, once a report is entered into the scheduler it will remain there as a
recurring report until removed by the user.

Copyright © 2004 Enraf Ltd Page 160 of 174


17.3, Viewing Scheduled Reports

From the Report Scheduler module select the Scheduler Configuration


option from the Report Scheduler menu.

The following display module will be loaded:-

This module lists all the currently configured reports and there next due date
and time.

The Edit and Exit buttons should be highlighted.

The Delete and Save buttons will become highlighted when in Edit mode.

In order to enter Edit mode you must be logged in as a user with sufficient
access rights to modify data.

Copyright © 2004 Enraf Ltd Page 161 of 174


17.4, Adding Reports to the Schedule

From the Scheduler Configuration module press the Edit button.

If you are not currently logged on as a user with sufficient rights you will be
prompted to log on.

When your login credentials have been accepted the Save and Delete buttons
will be highlighted and an extra edit row will be appended to the list as shown.

Click on the Date and Time field and enter the Date and Time the report
should be printed.

Copyright © 2004 Enraf Ltd Page 162 of 174


Click on the Report Name field and select the report to be printed at the
specified time.

Some of the reports require additional parameters to be supplied. The


additional parameters when required will appear in a drop down list in the
Parameters field.

For example when the Product Group Report is selected, a Product Name
needs to be supplied.

Copyright © 2004 Enraf Ltd Page 163 of 174


See the following illustration.

Select the required product from the list.

Press the Save button to commit the changes to the database.

The next report due will be calculated and displayed in the Report Scheduler
module.

Copyright © 2004 Enraf Ltd Page 164 of 174


17.5, Deleting Reports from the Schedule

From the Scheduler Configuration module press the Edit button.

If you are not currently logged on as a user with sufficient rights you will be
prompted to log on.

When your login credentials have been accepted the Save and Delete buttons
will be highlighted and an extra edit row will be appended to the list as shown.

Highlight the report to be deleted by selecting the corresponding row in the


grid by pointing and clicking on the left hand side of the row.

This will be indicated by the arrow head on the left hand side of the row, and
the row being highlighted in blue.

Press the Delete button followed by the Save button. The report will be
removed from the grid and the Entis XL database.

Press the Exit button.

Copyright © 2004 Enraf Ltd Page 165 of 174


18.0 Manual Density Entry

Density measurement is normally performed in a laboratory from samples of


product taken from tanks.

It is quite common after a receipt of product to have the density measured by


submitting a representative sample of the product to a laboratory.

The density is normally measured and converted to a Standard Density.

Although some gauging instruments can provide on-line and automatic


density measurement it is not normally accurate enough for custody transfer
and normal stock accounting.

Therefore the density parameter is often set to manual mode and entered
manually.

It is quite common for density data to be entered by operations personnel,


however from time to time a data entry screen may be provided at the
laboratory where the data can be entered at source.

The Manual Density Entry module can be run as a standalone application for
this type of environment.

As the density parameter is very important to product quality and inventory


calculations all changes are logged to an audit trail in the database.

Entis XL has an optional Manual Density Entry module for tracking cha nges to
manually entered Density figures.

Copyright © 2004 Enraf Ltd Page 166 of 174


18.1 Launching the Manual Density Entry Module

Select the Manual Density option from the Config menu.

The following display is typical of what will be loaded.

It generally comprises a list of tanks, the required manual density data entry
fields, and operator buttons denoted Print, Preview, Edit, Cancel, and Exit.

Copyright © 2004 Enraf Ltd Page 167 of 174


18.2 Entering Manual Density Data

In order to enter manual density data values you must be logged on with the
correct access rights.

If you are unable to modify the data please check with your Entis XL system
administrator.

It is necessary to provide your logon credentials each time a change is made.

The editable fields are highlighted in a yellow colour. In this case the Density
and Remarks fields are editable.

Select the required tank from the list.

Press the Edit button.

Entis XL will prompt you to log on.

Supply your username and password and press OK.

Select the data field to be edited by clicking the mouse in the data field. A
flashing cursor should appear.

Replace the existing data with the new data value. When the first character is
typed a pencil icon will appear in the first cell of the selected grid row. This
indicates that you are currently editing the row.

After all required data has been entered, move the cursor off the row to
commit the changes to the database.

Any problems in writing the data to the database will be reported to the user
via the Status bar of the display.

Edit mode will be terminated.

To make other changes move to another tank and press the Edit button and
repeat as above.

Press the Exit button to unload the manual data entry module.

Copyright © 2004 Enraf Ltd Page 168 of 174


18.3 Printing or Previewing the Current Density for each Tank

Launch the Manual Density E ntry Module.

Press the Print button to send the report to the currently selected printer.

Press the Preview button to send the report to the screen for pre-viewing.

The illustration below is typical of the report to be printed.

Copyright © 2004 Enraf Ltd Page 169 of 174


18.4 Viewing the Density History for a Specific Tank

Press the View Density History tool bar button.

The Density History display will be loaded. No data will be displayed.

See the illustration below for a typical example.

Select a tank from the drop down list.

Select the date(s) and time(s) over which you want to view the history.

The grid will be populated with a full list of all recorded changes between the
selected time and date range.

Alternatively, point and double-click the required row in the Manual Density
Entry display grid. This will launch the Density History display and pre-load
the changes to the density data for the selected tank for today.

To view the history for another tank simply select another tank from the drop
down list.

To view the changes over a different time period adjust the start and finish
dates / times.

Copyright © 2004 Enraf Ltd Page 170 of 174


18.5 Printing or Previewing the Density History for a Tank

Launch the Manual Density Entry Module.

Double click the row containing the tank of interest. Set the required date and
time ranges.

Press the Print button to send the report to the currently selected printer, or
press the Preview button to send the report to the screen for pre-viewing.

The illustration below is typical of the report to be printed.

Copyright © 2004 Enraf Ltd Page 171 of 174


19.0 Pipeline Configuration

Entis XL provides the ability to manually keep track of pipeline product


changes and contents. In addition some of its features have the ability to take
account of the pipeline contents in calculations.

The Pipeline Configuration module allows the user to enter and maintain this
data.

When Entis XL is first installed no pipeline information will be available.

It is the responsibility of the installation engineer or other responsible person


to set-up the pipeline details initially. It may well become the responsibility of
the operators thereafter.

Pipeline Configuration is normally carried out after the installation set-up


wizard has been completed and all the tanks have been created.

Pipeline Configuration can be launched at any time in order to edit and modify
existing pipeline details as well as add new pipelines or delete existing
pipelines.

19.1 Launching Pipeline Configuration

Select the Pipeline Configuration option from the Config menu.

The Pipeline Configuration module will be loaded.

See the illustration below for a typical display.

The module provides for the entry of the Pipeline Name, Pipeline Capacity,
Product in the pipeline and Product batch or quality information.

The module also provides tool bar button access to the Change Dimensions
module and the Pipeline Contents History module.

Copyright © 2004 Enraf Ltd Page 172 of 174


19.2 Entering Pipeline Details

To enter the details of a new pipeline: -

Launch the Pipeline Configuration module.

Press the Add button.

Enter a pipeline name.

Enter the pipeline capacity.

Select the product from the drop down list.

Select the Tank ID, if relevant, from the drop down list.

Enter a batch number or other relevant traceability number.

Press the Apply button.

NOTE The product, tank id and batch number fields are optional.

19.3 Editing Existing Pipeline Details

To edit the details of an existing pipeline:-

Launch the Pipeline Configuration module.

Scroll to the pipeline to be edited.

Press the Edit button.

Modify the data fields as necessary.

Press the Apply button.

The changes will be saved to the database. The data prior to the
changes will also be recorded in the history file therefore maintaining a
full audit trail of all changes.

19.4 Deleting Existing Pipeline Details

To delete an e xisting pipeline:-

Launch the Pipeline Configuration module.

Scroll to the pipeline to be deleted.

Press the Delete button.

The pipeline record will be deleted.

Copyright © 2004 Enraf Ltd Page 173 of 174


19.5 Viewing Pipeline History

Press the Pipeline History tool bar button.

The Pipeline Configuration History module will be loaded.

The illustration below shows a typical display.

To view the history of changes to a pipeline:-

Set the required start and finish date/time ranges.

Select the pipeline name from the drop down list.

The available history for the specified date and time range will be
displayed in the grid.

Copyright © 2004 Enraf Ltd Page 174 of 174

Anda mungkin juga menyukai