System Operation
0.0 Legal 9
0.1 Copyright 9
0.2 Disclaimer 9
1.0 Introduction 10
2.3.1 Offline 17
2.3.2 Manual 18
2.3.4.2 Stow 20
2.3.4.3 Unstow 20
2.3.4.4 Freeze 20
2.3.4.5 Unfreeze 20
6.0 Reports 36
8.2.4 Maintenance 59
11.0 DC Host 87
12.1 Diagnostics 93
12.2 Versions 98
0.2, Disclaimer
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.
Entis XL is the latest in a long line of successful tank inventory systems from
Enraf.
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.
When Entis XL is started the first view of the application is its Home Page.
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.
Access to the frequently used functions is provided from the applications tool
bar. Less frequently used functions are accessed through the menu bar.
The following sections detail the operator tools and features in more depth
and detail.
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.
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.
A graphical representation of the tank denoting the tank type e.g. cone
roof, floating roof etc.,
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.
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.
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.
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.
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.
Double click the horn on the tank graphic within Single Tank Overview.
The Alarm Summary module will show each of the alarms that are active. An
active alarm will have its corresponding check box ticked.
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.
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.
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.
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.
This indicates that the Water Level, Vapour Temperature, Product and Vapour
Pressure and Density parameters are all working from manual data.
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.
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.
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
2.3.4.5, Unfreeze
Releases the last Freeze command and allows the displacer to return to the
product level.
This option will instruct the displacer to search for the water level in the tank
and return to the product level.
If this option is fitted to the gauge then a density reading will be taken.
Selecting this option will minimise all Tank View windows currently open.
The Single Tank Overview module provides a detailed display of all data for a
single tank.
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.
For a full description and definition of each of the fields please refer to the
section on Definitions.
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.
Gauge Alarms
TH Temperature High
TL Temperature Low
DH Density High
DL Density Low
Programmable Alarms
If the data is available the temperature values will be displayed in the table,
and also plotted onto the accompanying graph.
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.
If the data is available the density values will be displayed in the table, and
also plotted onto the accompanying graph.
There will no data in either of the fields available. Enter the necessary
username and password.
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.
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 “-----“.
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.
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.
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.
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.
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.
Enter your User Name and Password, if you have the appropriate rights, all
unacknowledged alarms will be acknowledged.
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.
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.
During the printing of the file the following screen will appear.
To preview the print before actual printing select Print Preview from the File
menu.
It is possible to view different pages of the print, this can be done in two ways.
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.
If you only want to print the page you are viewing select Print current page.
By clicking the close window button in the top right of the window.
Entis XL comes with a standard set of tank gauging and inventory reports.
It enables the user to print a report of all tanks, tanks by product group or
tanks by tank group.
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.
Press the Print Preview button to Preview the report prior to printing.
The Report module contains a product selection list. This list will contain all
products that have been configured into the Entis XL database.
The Report module contains a Tank Group selection list. This list contains all
the Tank Groups configured with the Static Group Configuration utility.
The following picture shows the content of a typical Tank Configuration report.
The following picture shows the content of a typical Level Alarm Configuration
report.
GridView has been designed to provide the user with a large degree of
flexibility when it comes to data presentation.
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.
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.
Press the GridView tool bar button or alternatively run the GridView.exe
application from the Entis XL target folder.
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.
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.
Tank Gauging
Tank Inventory
Tank Status
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.
If no groups have been configured the list will be empty other than the fixed
All Tanks group.
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.
A number of tool bar buttons are provided to quickly summarise tanks that
have an active gauge alarm.
Change Dimensions
View All
All Tanks in High Alarm Tanks Lock/Unlock Grid
Repeat the above steps until all columns have been specified for the
new view.
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.
Dipping
Displacement
Test Gauge Alarm
Maintenance
Gauge Items
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.
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 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.
These functions generally apply to the Enraf 854 series of servo operated
tank gauges.
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.
The gauge will remain at I3 until the user commands the gauge
otherwise.
Lock
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
The gauge will remain in the calibrate mode until told to do otherwise
by the user.
Press the unlock button the have the displacer return to Product
Measurement Mode.
Unlock
The Test Gauge Alarm tab provides an Alarm Test function specifically designed for the Enraf
873 Radar gauge.
For each alarm test requested, the corresponding alarm should be detected
and generated within the Entis XL system.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Now send the EX command to exit the protection level and re-initialise the
gauge.
Lets assume that the Gauge Dimensions for Level are feet, inches and
sixteenths (f-i-s).
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.
All the tank grouping functions are generally available from the Tank Grouping
module.
Product
Product group
Dynamic Groups are those that are automatically defined by Entis XL.
Load the Tank Grouping module by clicking the appropriate tool bar button.
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.
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.
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.
Load the tank grouping module by clicking the appropriate tool bar button.
Highlight a tank in the tank list by pointing and clicking the left
mouse button.
Highlight a tank in the tank group list by pointing and clicking the
left mouse button.
Repeat the above for all tanks that need removing from 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.
Load the tank grouping module by clicking the appropriate tool bar button.
Entis XL provides the user with the ability to view tanks containing a particular
product.
Load the tank grouping module by clicking the appropriate tool bar button.
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.
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.
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.
When a dynamic group is use, as tanks no longer conform to the criteria they
will be removed form display.
Load the tank grouping module by clicking the appropriate tool bar button.
See the illustration below for the available display options and operator
controls.
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.
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.
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.
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.
The Product group Totalisation module allows the user to totalise product
volumes by the Product Group assigned to them.
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.
From the View menu select the Product Group Totals option.
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.
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.
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.
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.
The illustration shows one of the tank views displaying product level in
millimetres.
Each parameter group has a drop down list containing the available
dimensions for display and data entry.
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.
You may be required to logon with the correct access rights if you are not
already logged on.
No character is used to denote the sixteenths part. This is implied by the Units
being displayed.
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.
20’13”11
When the user attempts to save this value it will be rejected as invalid.
The Default button within the Change Dimensions module will restore the
default settings for the module in which it was loaded.
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 DC Host module is required for both standalone and client server
configurations.
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.
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: -
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.
Double Click the DC host icon in Control Panel, this will bring up the following
screen: -
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.
To view the DC Host Modcon Monitor double click the DC Host icon in the
System Tray, this will bring up the following screen; -
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.
Each time the Entis XL polls the Datacon for that tank the response and data
will be captured and displayed.
Much of the help appears under the Help menu of the main application tool
bar.
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.
Select the Diagnostics option from the Help menu on the main home page
menu bar.
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 Printer icon to send the report to the Windows default printer.
Select the Print option from the File menu to print the Diagnostics List.
This will launch Windows Notepad and open the Recommended Action File.
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.
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.
Select the Versions option from the Help menu on the main home page menu
bar.
Use the scroll bars to view the details of each of the files listed.
Press the Printer icon to send the report to the Windows default printer.
Press the OK button to send the report to the default Windows printer.
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.
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.
Select the About option from the Help menu on the main home page menu
bar.
Key Features
1. TrendLogger.exe
2. RealtimeTrending.exe
3. HistoricalTrending.exe
On multi-station systems and full client server applications, trend files may be
located centrally at a file or database server.
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.
Whilst running, the TrendLogger module has a very basic and simple display
interface illustrated below.
The Event window and status bar display diagnostic information associated
with the TrendLogger module.
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.
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.
Click the real-time trending tool bar button in the real-trending display.
Select trend
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.
The progress of loading the data will be reported through the status bar of the
configuration form.
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.
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.
Trend Selection
Change Dimensions
Data
Cursor
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 back out to the initial default view as follows.
Right mouse click anywhere on the trend graph. A popup menu will appear.
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.
Click the historical trending tool bar button in the historical trending display.
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.
The progress of loading the data will be reported through the status bar of the
configuration form.
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.
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.
Trend Selection
Change Dimensions
Historical Trend
Data Cursor
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 back out to the initial default view as follows.
Right mouse click anywhere on the trend graph. A popup menu will appear.
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.
The Inventory Calculator module will be loaded. See the illustration below for
a typical example.
The Change Dimensions module has been integrated with the Inventory
Calculator such that the user can view and enter data in dimensions of choice.
The tank calculator provides the user with the facility of calculating tank
inventory at user specified conditions.
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.
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.
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 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.
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.
When all data has been provided press the Calculate button to see the tanks
final values.
For example, lets assume we are going to receive a known volume from a
pipeline. Select the Volume option.
The units by which the volume will be interpreted are those set in the Change
Dimensions module.
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.
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.
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.
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.
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.
Open
Close
Suspend
Re-open
The Movement module supports fully scalable client server architectures, and
allows multiple users to simultaneously configure, open, monitor, and close
movements.
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.
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.
Product Level
Product Temperature
Product Name
Ullage/Drawable
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
Remaining
Actual
ETF
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.
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.
Select the Configure option from the pop-up menu or main menu.
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.
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.
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.1 Opening
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.
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.
The suspend actions will be performed and the status will change to
suspended.
15.4.4 Re-opening
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.
15.4.5 Cancelling
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.
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.
Accurate levels
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.
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.
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.
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.
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.
Select the Movement Settings option from the Actions menu or the pop-up
menu.
15.10.1 Defaults
The defa ult values when Entis XL is first installed for each field are: -
The alarms are also disabled by default. The defaults are engineer
configurable, you should speak to your site administrator to have them
reconfigured.
The new settings will take effect immediately for the selected 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.
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.
Click ‘Edit’
Click ‘Apply’
Click
Select the tank you wish to configure the leak threshold for.
Click ‘Edit’
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.
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.
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.
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.
This module lists all the currently configured commands and there due date
and time.
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.
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:-
All Tanks – allows the user to send a command to all tanks in the
system. This is generally not recommended for large sites.
Single Tank – allows the user to select a single tank from the drop
down list.
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.
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.
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.
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.
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.
This module lists all the currently configured reports and there next due date
and time.
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.
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.
For example when the Product Group Report is selected, a Product Name
needs to be supplied.
The next report due will be calculated and displayed in the Report Scheduler
module.
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.
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.
Therefore the density parameter is often set to manual mode and entered
manually.
The Manual Density Entry module can be run as a standalone application for
this type of environment.
Entis XL has an optional Manual Density Entry module for tracking cha nges to
manually entered Density figures.
It generally comprises a list of tanks, the required manual density data entry
fields, and operator buttons denoted Print, Preview, Edit, Cancel, and Exit.
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.
The editable fields are highlighted in a yellow colour. In this case the Density
and Remarks fields are editable.
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.
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.
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.
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.
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 Pipeline Configuration module allows the user to enter and maintain this
data.
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.
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.
Select the Tank ID, if relevant, from the drop down list.
NOTE The product, tank id and batch number fields are optional.
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.
The available history for the specified date and time range will be
displayed in the grid.