tank master net website manual

8/3/2019 Tank Master Net Website Manual

1/82

Users GuideRef. no: 303040EThird Edition, February 2007

Rosemount TankMaster.netWebsite

www.rosemount-tg.com


2/82


3/82

Rosemount TankMaster.net Website

UsersGuideThirdEdition

Copyright 2001-2007 Rosemount Tank Radar AB

Rosemount TankMaster.net 3Third Edition, February 2007


4/82

Copyright 2001 - 2007 Rosemount Tank Radar AB, Sweden,

Copyright law and international treaties protect this program. Unauthorized

reproduction, distribution of this program or any portion of it may result in severe civiland criminal penalties, and will be prosecuted to the maximum extent possible underthe law.

4 Rosemount TankMaster.netThird Edition, February 2007


5/82

Overview of Manuals

Overview of Manuals

TMn2Installation.pdf

This manual describes the procedure for installing TankMaster.net on Windows

2000 Server, Windows XP Pro and Windows 2003 Server with Internet

Information Services (IIS). Before installing TankMaster.net Server, minimum

system requirements have to be met that are mentioned in this manual. The

manual also presents the minimum system requirements for installing

TankMaster.net.

TMn2Config.pdf

This manual describes the procedure for configuring the TankMaster.net

Server. The information that is viewed on the TankMaster.net Website/WAP

website is set by the Administrator using the TankMaster.net Configuration

application. The manual describes how the Administrator can create, edit,

delete and assign rights to the Users and Groups for viewing tanks.

TMn2DataCollector.pdf

This manual describes the DataCollector application, which displays the Live

and Static data of the tanks polled with the current date and time. The manual

also explains how to start and end the application manually or automatically.

The data collected by this application is displayed on the TankMaster.netWebsite/WAP websites.

TMn2Website.pdf

This manual provides a detailed description of various menus, products,

information etc which are viewed by the user on the website. The user can

change limited details of his profile, view details of all products, individual tanks,

view graphs and download tank information in Excel format.

TMn2UserStatus.pdf

This manual gives a detailed description of the information that is available on

users who are logged on to the TMn2Web website. It also displays the current

page being viewed by the user, the session Id assigned, session start time and

session expiry time. Only the Administrator can access this website.



6/82

Overview of Manuals

TMn2Wapsite.pdf

This manual describes how the TankMaster.net WAP website works using an

Internet browser. It also describes how to view details of individual tanks and

product groups.



7/82

Contents

Contents

1.0 Folder names and conventions used throughout this document.......82.0 Introduction........................................................................................9

2.1 Overview of TankMaster.net website.............................................9

2.1.1 TankMaster.net Login page.....................................................92.1.2 TankMaster.net Post Login Page ..........................................10

3.0 Login................................................................................................134.0 Change Profile.................................................................................155.0 Help .................................................................................................17

5.1 Help..............................................................................................175.2 Glossary .......................................................................................17

6.0 Tank Inventory.................................................................................187.0 Overview .........................................................................................19

7.1 All Products..................................................................................197.2 All Tanks ......................................................................................217.3 Schematic ....................................................................................227.4 Error Indications...........................................................................23

8.0 History Graphs ................................................................................259.0 Download ........................................................................................3010.0 Auto Refresh .................................................................................3211.0 Logout ...........................................................................................3512.0 Add/Modify a Language to theTankMaster.net website................36

12.1 To change the default language of the TankMaster.net website

...........................................................................................................36 12.2 To add a language to the TankMaster.net website....................3712.3 To modify a Language for the TankMaster.net website.............39

13.0 Description of .ini files for TankMaster.net website......................4713.1 Colors.ini ....................................................................................4913.2 Current.ini...................................................................................5113.3 DownloadUnicode.ini .................................................................5713.4 Format_Html.ini and Format_Win.ini .........................................6013.5 History.ini and HistoryUnicode.ini ..............................................6713.6 Language.ini ..............................................................................6913.7 Login.ini......................................................................................7513.8 PieChartUnicode.ini ...................................................................7513.9 Schematic.ini..............................................................................76

14.0 Troubleshooting.............................................................................78

Rosemount TankMaster.netSecond Edition, February 2007

7


8/82

Folder names and conventions used throughout this document

1.0 Folder names and conventions usedthroughout this document

In this document we will need to refer to some folders regularly. With a view to

make such references easier and shorter we will use the followingconventions:

TMnData will refer to the folder that by default resides in:

C:\Program Files\Saab\TankMasternet\TMnData

TMn2Web will refer to the folder that by default resides in:

C:\Program Files\Saab\TankMasternet\TMn2Web

TMn2WebHelp will refer to the folder that by default resides in:

C:\Program Files\Saab\TankMasternet\TMn2Web\WebHelp

Language Folder will refer to a subfolder of TMnData with the

LanguageName, Example: The English folder will refer to the folder that

resides in:

C:\Program Files\Saab\TankMasternet\TMnData\English.

There is also a Language subfolder that resides in:

C:\Program Files\Saab\TankMasternet\TMn2Web\WebHelp.



9/82

Introduction

2.0 Introduction

2.1 Overview of TankMaster.net website

The main aim of TankMaster.net is to make data of the tanks andproducts available to users all over the world from offices, residences orWAP phones. This data is available to users who are assigned aUsername and Password by the administrator. Users can only read thedata available on the website and view/download data in the form of Excelspreadsheets for editing. The configuration of TankMaster.net is achievedwith the help of the TankMaster.net Configuration and TankMaster.netDataCollector applications.

To access the Tankmaster.net website open the Internet browser, in theaddress field enter http://servername/tankmasternet. The servernameshould be replaced by the internet name of the TankMaster Server or its

IP address. (E.g. http://mpix191/tankmasternet orhttp://59.181.101.23/tankmasternet). The TCP port 80 (HTTP) is neededto be enabled in the firewall/router settings for TankMaster.net to beaccessible on Internet.

If the TankMaster Server does not have a hardware lock, theDataCollector and the website will run in DEMO MODE. A user by thename of DEMO is created by default during the TankMaster.netinstallation. If the application is working in DEMO MODE, only the user bythe name DEMO will be allowed to login to the website. To overcome thismode, connect the hardware lock to the parallel/USB port of theTankMaster Server.

2.1.1 TankMaster.net Login page

The Login page is the default page of the TankMaster.net website.

This page allows a valid user to Login, Change Profile and

change Language. It also provides Help for items on the Login

page.

Language Selection

The website can be configured to be viewed in different languages.

The default language is English. The administrators can add/modify

a language. The language configuration files are located in

TMnData and TMn2Web\WebHelp folders.

Note! For adding/modifying a language the Operating System should supportthe desired language.

http://servername/tankmasternethttp://mpix191/tankmasternethttp://59.181.101.23/tankmasternethttp://59.181.101.23/tankmasternethttp://mpix191/tankmasternethttp://servername/tankmasternet


10/82

Introduction

Login

The Login option allows a valid user to login into the website.

Change Profile

The Change Profile option allows the user to change their profile

according to the rights assigned by the administrator.

To change the user profile, click the Change Profile option on the

Login page. The administrator can add/remove the fields of the

Change Profile window, by editing the Login.ini file located in the

TMnData\Language directory.

Help option

The Help option has two submenus, Help and Glossary.

Help

The Help submenu provides help on items of the Login page.

Glossary

The Glossary submenu displays the details of the terms used

on the TankMaster.net website.

After the user logs in, the default page as set by the administrator is

displayed.

2.1.2 TankMaster.net Post Login Page

The navigation bar of this website contains: Tank List, Overview,

History, Download, Help and Logout.

Tank List

This option displays the list of available tanks mapped to the local

computer. Individual tank inventory can be viewed by clicking on a

tank in the Tank List.

Overview option

The Overview option has sub menus: All Products, All Tanks andSchematic.



11/82

Introduction

All Products

The All Products submenu will display the details of all products

in a pie chart. It also displays the aggregate of the tank values in

the product group. The administrator can control the fieldsdisplayed by editing the Current.ini file, located in the TMnData

directory.

All Tanks

The All Tanks submenu will display the details of all tanks as a

bar graph. It also displays available values of each tank. The

administrator can control the fields displayed by editing the

Current.ini file, located in the TMnData directory.

Schematic

The Schematic submenu will display the layout of the Tank

Farm. The Schematic web page has links (hotspot) to the Tank

Inventory page. The web user can click on the hotspot of the

tank that is visible on the schematic image to view the details of

the selected tank. The administrator can control the hotspots

displayed on the schematic diagram by editing the

Schematic.ini file, located in the TMnData\Language folders.This file contains the tank name and the co-ordinates that are

used to control the size and the location of the tank in the

schematic diagram.

History option

The History option will display the past data of the OPC items in a

graphical format. The History page allows the user to view the

graphs of the tanks, by selecting the OPC items and setting the

date/time period. Tanks are identified by using different colors set

by the administrator. Changes can be made by editing theHistory.ini and HistoryUnicode.ini files located in

TMnData\Language folders. This file allows the administrator to

set/change the default Refresh Rate for the history page, items to

be viewed under OPC items and the history period (in time) for the

graph to be displayed.

Download option

The Download option allows the user to download Live and Static

data in the form of an Excel workbook. The data contains Inventory

data of All Tanks and All Products.



12/82

Introduction

When the Download option is clicked during browsing the History

page, the data downloaded, will be the History data. If any other

page is being browsed, and the user clicks on the Download

option, the data downloaded is the Current data.

The administrator can control the fields that can be downloaded by

the user through a file DownloadUnicode.ini. This file is in theTMnData\Language directory. The Excel workbook will display the

Current and History data.

Help option

The Help option has two submenus: Help and Glossary.

Help

The Help submenu displays the help file of the current webpage.

Glossary

The Glossary submenu displays the details of the terms used

on the TankMaster.net website.

Logout

The Logout option exits the users from the TankMaster.net websiteand displays the Login page.



13/82

Login

3.0 Login

To access the Tankmaster.net website open the Internet browser, and in the

address field enter http://servername/tankmasternet. The servername should

be replaced by the internet name of the TankMaster Server or its IP address.

(E.g. http://mpix191/tankmasternet or http://59.181.101.23/tankmasternet

Select the Login button. This allows TankMaster.net web users to login to the

website. Only those web users who have a valid LoginID and Password

assigned by the administrator will be able to login to this website.

To Login to the TankMaster.net website the user will have to do the following:

The default language of the Login page is English. The user can changethe language, by selecting a language on the language bar.

Select the Login option from the navigation bar, to allow the user to loginto the website

A Login window will be displayed with fields for LoginID and Password.

The valid LoginID and Password should be entered in these fields.

If an incorrect LoginID or Password is entered, an error messageAuthentication error. Please try again will appear.

Note! A hardware lock should be connected on the TankMaster Server. If thehardware lock is not found, the user will have to login to the website with

http://servername/tankmasternethttp://mpix191/tankmasternethttp://59.181.101.23/tankmasternethttp://59.181.101.23/tankmasternethttp://mpix191/tankmasternethttp://servername/tankmasternet


14/82

Login

a LoginID and Password as demo. In DEMO MODE a maximum of fiveDemo users are allowed. The number of concurrent users will dependupon the hardware lock connected to the machine.



15/82

Change Profile

4.0 Change Profile

The user can change his profile by selecting the Change Profile option on the

navigation bar of the Login page, according to the rights assigned by the

administrator.

To Change Profile

The Change Profile window is displayed below.

The user will have to click on the Change Profile option on the navigationbar of the Login page.

Note! The user is allowed to change his profile if the administrator hasassigned rights to the user in the TankMaster.net Configurationapplication.

The user should enter the LoginID, Old Password, New Password andConfirm Password in the fields provided. All fields are mandatory.

To change the password, the user should enter the LoginID in the fieldprovided for the LoginID. The old password (which at present is thecurrent password) is to be provided in Old Password field. The NewPassword is to be entered in the field for New Password. This passwordwill be retyped in the field provided for Confirm Password.



16/82

Change Profile

The user should click on the button to submit the information. After

clicking the button, the user data will be saved.

If the user does not want to change his profile, he should select any other

option available on the Login page of the navigation bar or click on theChange Profile option to exit from the Change Profile menu.

Note! If for any reason the user is not able to change his profile, he will have toask for the administrators assistance. After the password is changed, the userwill login to the website with the new password. The administrator can addfields in the Change Profile menu by making changes in the Login.ini filelocated in the TMnData\Language directories. A user cannot change his profilein DEMO MODE.

16 Rosemount TankMaster.netThird Edition, October2004


17/82

Help

5.0 Help

The Help option is available on the navigation bar of the Login Page.

The Help menu contains two submenus, Help and Glossary. The Help

submenu contains the help on various pages on the website and the

Glossary submenu contains the definitions of terms used in the

TankMaster.net website.

5.1 Help

If the user clicks on the Help option before logging into theTankMaster.net website, he will be able to view help on Login andChange Profile.

If the user clicks on the Help option after logging into the TankMaster.net

website, he will be able to view help on the section that he is currentlyviewing.

5.2 Glossary

To access the Glossary section the user will have to click on the Helpoption on the navigation bar and click on Glossary.

The Glossary page will contain definitions of the terms used in theTankMaster.net website.



18/82

Tank Inventory

6.0 Tank Inventory

To view a single tanks inventory, either select a tank from the Tank List

option in the navigation bar, or select the tank from the Tree view.

The single tank inventory window is as displayed below.

The Tree view will display Available Tanks. These tanks can be viewed

under All Tanks and under the respective product category to which they

belong.

All Tanks will display a list of all available tanks of all products. Click on the +

button to view all tanks.

To view tanks of a particular product, click on the + button under the product

group.

To view a single tanks inventory, click on an individual tank name from AllTanks or the product group.

The rate of change in the levels of the product in the tank is shown by the up

and down arrows on the image of the tank. The up arrow signifies that the rate

of change is increasing and the down arrow signifies that the rate of change is

decreasing. If a red cross is visible in place of the arrow it signifies that it is an

Invalid Tank.

Note! For details on Error Indications in OPC value of a tank, refer tosection7.4



19/82

Overview

7.0 Overview

The Overview option on the navigation bar has three submenus, All

Products, All Tanks and Schematic.

7.1 All Products

Overview of All Products

The All Products submenu allows the user to view details of all theproducts that are available. The pie chart displays the aggregate of TotalLevel Available, Total Level Utilized and the Free Water Level, by theproduct available in the tanks in percentage value.The net aggregate values as set up by the administrator are displayedbelow the pie charts.

The image shown below, displays the Overview of all products.



20/82

Overview

If the user clicks on the pie chart of a product it will link to a page wherehe will be able to view all the tanks that are listed under the particularproduct.

The Overview of All Products will show the products with their levelsand other details. The rates of change in levels of the product in the tankare shown by the up and down arrows. The Up arrow signifies that therate of change is increasing and the Down arrow signifies that the rate of

change is decreasing.

The Refresh Rate window appears below the Product tree view. Thedefault Refresh Rate is set as 90 seconds. This setting can be changedby entering the Refresh Rate in seconds and clicking on the Set Ratebutton.If the Refresh Rate is set to zero, it means that the data will not berefreshed. Do not set the Refresh Rate below 30 seconds.




21/82

Overview

7.2 All Tanks

Overview of All Tanks

The All Tanks submenu allows the user to view details of all the tanks

that are available.

The tanks are displayed as a bar graph showing the Free Water Level atthe bottom of the tank and the product contained in it in a different color.All Products are depicted in different colors.

If the user clicks on the arrow near a particular tank or the tank name, itwill display the tanks inventory.

The Overview of all tanks will show all the tanks with their levels andother details. The rate of change of the levels of the product in the tank isshown by the up and down arrows. The Up arrow signifies that the rate ofchange is increasing and the Down arrow signifies that the rate of changeis decreasing.





22/82

Overview

7.3 Schematic

Thisoption displays the Schematic diagram of the Tank Farm.

The image shown below is a sample of the schematic diagram.

Setting up the Schematic diagram

To set up the Schematic diagram of the Tank farm:

Take an image of your tank farm. Re-scale that image to 838 pixels x 527pixels and save as Schematic.gif in the TMn2Web\Images directory.

The outline of a tank can be defined as a circle, rectangle or a polygon.

If a circle is a suitable definition for the tank, determine the center

point in pixels and the radius in pixels.

If a rectangle is a suitable definition for the tank, determine the left-

x, top-y, right-x, bottom-y co-ordinates of the rectangle.

If a polygon is a suitable definition for the tank, determine the x1,

y1, x2, y2, ..., xN, yN co-ordinates.

Determine a suitable place to place the legend (short name) of the tankand note down the co-ordinates.

With the above information the Schematic.ini file can be edited.



23/82

Overview

To view the Schematic diagram:

Select the Schematic submenu under the Overview option on thenavigation bar.

The Schematic web page has links (hotspot) to the Tank Inventory page.The web user can click on the hotspot of the tank that is visible on theschematic image to view the details of the selected tank.

7.4 Error Indications

Significance of the red cross x and black cross X

If a red cross x is visible in place of the arrow it signifies that the datapertaining to the status is invalid.

If a black cross X is visible in the center of the tank it signifies that thedata pertaining to the tank is invalid.

The image shown below is a sample of a tank having an invalid Level.

Significance of ?

? displayed in a table indicates that the OPC_Quality is bad.

The image shown below is a sample of a tank having a bad OPC Quality.

Significance of !

! displayed against a value of an OPC item it signifies that the value isan Invalid Value.

The image shown below is a sample of OPC item having an invalid value



24/82

Overview

Significance of Man

Man displayed as a prefix to a value signifies that the value of the OPCitem is manually set by the administrator.

The image shown below is a sample of a tank entry entered manually

Significance of date and time displayed in red

If the date and time is displayed in red with a warning message (warning:last known data is used!) then the data displayed is past data. Thiserror can be due to data collector service not started or data collection hasstalled

The image shown below is a sample of past data displayed.



25/82

History Graphs

8.0 History Graphs

The History option shows a graphical representation of the past data of the

OPC items of a product. The user will be able to view the graphs of only those

OPC items that are setup by the administrator on the TankMaster Server. The

administrator will have to set the OPC items on the TankMaster Server so that

the user can view the history graphs on the TankMaster.net website.

The following steps should be taken to setup the OPC Items history on

TankMaster Servers:

Open the WinOPI application by double clicking the icon on the desktop.

Login using the Username and Password. The Username is Supervisorand the Password is Super by default. For security reasons, you areadvised to change the password at the earliest.

Select the View>Historical Graph option on the Menu bar. A window titledHistorical View will be displayed.



26/82

History Graphs

Click on the Sample Setup button. The Sample Setup window will bedisplayed.

Click on the Select Blocks for all Tanks button. The Multiple blockselection window will be displayed as shown below.

From the list, select the OPC items to be viewed in the history graph. Clickon the OK button to add them.

The selected items will be displayed in the list under Used blocks.

Click on the Apply button to save changes.

Click on the OK button to exit from the current window.



27/82

History Graphs

The light in the Sample Settings section will turn from red to green. Thiswill indicate that the data sampling for the History items has started.

The items selected in Sample Setup will be the only items whose historydata can be viewed on the TankMaster.net website.

The graph that you will be able to view will be as shown below.



28/82

History Graphs

To view the graphical history records of a product or a tank, the user willhave to do the following:

Select the History option from the navigation bar. By default this willdisplay the graph for the first product group in the Tree view list.

For selecting a product or a tank, the user will click on the Tree view of theproducts on the left side of the page under Available Tanks. The name ofthe product will appear on top of the graph with a caption Graph ofGroup/Tank (name of the product group or tank) as on (Current date andTime).

The user can select the number of days or months option to view the datafrom the drop down menu, with a caption For. The user can select thetime period to view the history data for a minimum of 4 hours to amaximum of 1 year. By default, the time period is set to 4 hours.

The user can also set the end date along with the time in the box providedwith the caption set the End Date/Time. The user can view the data up tothe current time and date. For selecting this option, check the boxAutoset to Now. This option will set the date and time to the systemscurrent date and time.

The user can select the required OPC item to be graphed by selecting anitem from the drop down list under Graph this item. The items displayedin the drop down list are the items which were selected during the WinOPIsetup.

After making the proper selections, the user can click on the Graph It

button to see the graphical representation of the item for the period thatwas selected.

Example:

If the user selects the date as 17-09-2004 03:45 PM in the date box andthe period as 3 days then the data that will be displayed will be from 14-09-2004 03:45 PM.

On the graph, different tanks are depicted by different colors. The colorthat stands for a particular tank is stated below the graph. Along with thenames of the tanks, the numbers displayed in the bracket states theminimum and the maximum levels. These levels will be displayed on theY-axis. The minimum level will be at the bottom and the maximum levelwill be at the top of the graph. The first number displayed in the bracket isthe minimum level and the second number is the maximum level. Thedate and time are displayed on the X-axis. Level (m) indicates the level inmeters. ? indicates unavailable data.



29/82

History Graphs


Note! The set the end Date/Timewill show the current Date and Time bydefault. The period, for which the graph can be viewed, will be a minimumof 4 hours and maximum of 1 Year. The administrator can change thesesettings by making changes in History.ini and HistoryUnicode.ini files.These files contain settings for the History page



30/82

Download

9.0 Download

To download data as an Excel spreadsheet, the user should click on the

Download optionon the navigation bar.

If the user is viewing All Products, All Tanks or Tank Inventory pages and

clicks on the Download option, the data downloaded will be Current data. If

user is viewing the History graphs and clicks on the Download option, the

data downloaded will be the past data.

After clicking Download, the user will be able to see a window, which will give

options, Open this file from its current location or Save this file to disk. If

the user does not want to save the data and view the data in the Excel

workbook, he should click on the Open this file from its current location

option. If the user wants to save data to a certain folder he will have to click on

the Save this file to disk option. This will save the Excel workbook on theusers hard disk for viewing/editing.

The screen that appears after clicking on the Download option is shown

below.

Select the desired option and click on Ok. It will open/save an Excel workbook

as per option selected.

The Excel workbook will contain separate sheets for each product and it will

show all tanks with their details.

The user can view the details of various product groups, by selecting the

desired worksheet displayed at the bottom of the page. Each worksheet is

named with the product description.



31/82

Download

The image shown above is the sample image of an Excel workbook when

saved/opened, when the Download option is selected.



32/82

Auto Refresh

10.0 Auto Refresh

The auto refresh rates are found in Current and History data sections.

In the Current data section the Refresh Rate window appears below the

Product tree view. The default Refresh Rate is set as 90 seconds. This

setting can be changed by the user by entering the Refresh Rate in seconds

and clicking on the Set Rate button. If the Refresh Rate is set to zero, it

means that the data will not be refreshed. Do not set the Refresh Rate below

30 seconds.

In the History data section the Refresh Rate window appears below the

Product tree view. The default Refresh Rate is set as 300 seconds. This

setting can be changed by the user by entering the Refresh Rate in seconds

and clicking on the Set Rate button. If the Refresh Rate is set to zero, it

means that the data will not be refreshed. Do not set the Refresh Rate below90 seconds.

The default Refresh Rate and Auto Refresh values can be changed by editing

the Current.ini and the History.ini files under TMnData\Language directory

General section of the Current.ini file is shown below

[General]

; s=second, n=minute, h=hour, d=day

; 60n = 60 minutes

WarnOldValuesTime=60n

;RefreshRate is in seconds

RefreshRate=90

;Consider Auto-Refresh as Usage

; Not Usage = 0

; Usage = Not Zero

AutoRefreshIsUsage=1

; Set the first page after login; AGOVW = All Products overview - Default

; GOVW = All Tanks overview

; TNK = Single Tank inventory

StartPage=GOVW

General section of the History.ini file is shown below

[General]

; Number of data points for graphs.

NoOfDataPoints=200



33/82

Auto Refresh

;RefreshRate is in seconds

RefreshRate=300


; Not Usage = 0; Usage = Not Zero

AutoRefreshIsUsage=1

The value of AutoRefreshIsUsage in Current.ini and History.ini is defined by

the values 0 and 1.

The value 0 indicates that the auto refreshed pages will not be counted as

usage, and the user will be logged out in 20 minutes.

The value 1 indicates that the user will not be logged off at all if the pages are

being refreshed periodically.

The administrator can disable the Refresh Rate table displayed on the

TankMaster.net website by modifying the TMnWebTanks.htm file in the

TMnData\Language directory.

The TMnWebTanks.htm file is shown below

Set Refresh Rate

seconds.



34/82

Auto Refresh

Delete the highlighted section displayed above and save the file.

The screen without the refresh rate is as shown below.

The Refresh Rate section table will not be viewed on the TankMaster.net

website and the user will not be allowed to change the refresh rate which has

been set as default by the administrator.

If the RefreshRate (as mentioned above) is set to zero, then there would be

no Auto Refresh on the site



35/82

Logout

11.0 Logout

To logout of the TankMaster.net website, the user should click on the Logout

button on the navigation bar.

To Logout of the website:

The Logout option will allow the user to sign out of the website. Once theuser logs out, the login page of the TankMaster.net website will bedisplayed. If the user, after logout, wants to view the TankMater.net data,he will need to re-login to the website using his valid LoginID andPassword.

If the user closes the Internet Explorer browser window without clicking onthe Logout option, he will not be considered as logged out of theTankMaster.net website (i.e. The UserStaus website will display that this

user is still logged in to the TankMaster.net website). After 20 minutes ofinactivity or once the session timeout period is reached, the web user willbe automatically logged out (i.e. The UserStatus web page will delete thisuser from the user/login list).

Rosemount TankMaster.net 35Second Edition, February 2007


36/82

Add/Modify a Language to the TankMaster.net website

12.0 Add/Modify a Language to theTankMaster.netwebsite

12.1 To change the default language of the TankMaster.net

website

The default language of the website is English. The administrator canadd/modify the language as per the requirements. Note: To add anylanguage the Operating System should support the desired language.

For example, assume two languages are loaded on the TankMaster.netwebsite (English and French). To change the default language fromEnglish to French, edit the TankMasternet.ini file, which exists in thedefault Windows directory [for Windows 2000, the default windowsdirectory is C:\WinNT; for Windows XP and Windows 2003 the defaultwindows directory is C:\Windows]. The Tankmasternet.ini file can beedited in any plain text editor like Notepad.

To change the default website language from English to French, editthe Tankmasternet.ini file and locate the header section [Data].

Locate the line LanguageFolder= English and change the wordEnglish to French. Save the file and exit.

When the TankMaster.net website is opened it will observed, that thedefault language set for viewing the Login page is changed to French.



37/82


12.2 To add a language to the TankMaster.net website

To add a language, the following steps should be observed (Example,To add Italian language)

If the Italian language is to be added to the website, it is necessary thatthe Windows Operating System should support the Italian language.

Create an image file in Gif format with a height of 16 pixels, which canbe used as an icon flag for the new language (Italian). Save the imagefile as FlagItaly.gif and save it in the TMn2Web\Images andTMn2Web\WebHelp\Images folders.

A sample flag is shown below.

Copy the entire English subdirectory of the TMnData folder and pasteit in the same directory. It will be named as Copy of English. Renamethis folder to Italian.

To switch/change languages, the user will make changes in theTMn2WebLogin.htm file that is located in TMnData\Languagedirectories. (This file is to be edited in all Language folders)

The file TMn2WebLogin.htm can be edited in a plain text editor likeNotepad. Changes to be made are as follows:

Go to the LanguageBar section and copy the first line as shownbelow.

English

Paste this line as the last line of the LanguageBar. Edit the last

LanguageBar line by replacing the word English to Italian and

rename FlagUK.gif to FlagItaly.gif. The line after editing will

appear as follows.

Italian

Note! FlagItaly.gif is an independent file that is created to be viewed as anItalian flag on the website.



38/82


The above edited line is to be copied to all Language folders inTMn2WebLogin.htm file.

The changes mentioned below have to be made in theTMnData\Italian\TMn2WebLogin.htm file.

Locate the line with the LanguageMessage that is the next line afterLanguageBar. Edit the line by replacing the word English with Italian.The edited line will read as follows.

Current Language is Italian

After adding the Italian language, the Login page will appear as shownbelow.

This completes adding a language to the TankMaster.net website.



39/82


12.3 To modify a Language for the TankMaster.net website

To modify a Language on the TankMaster.net website, .ini and .htm filesneed to be edited. These files should be edited using a plain text editorlike Notepad. The files are located in the TMnData\Language

directories. In this section we shall explain the changes required to beincorporated to modify the language, Italian, (assuming that the ItalianLanguage has been added using the procedure described in the Addinga Language section).

Note! Before making any modifications it is advised to take a backup of allTMnData/Language folders.

The files to be modified are:

Current.ini DownloadUnicode.ini Format_Html.ini and Format_Win.ini History.ini and HistoryUnicode.ini Language.ini Login.ini PieChartUnicode.ini TMn2WebLogin.htm TMn2WebTanks.htm

These files are located in the TMnData\Italian directory.

Note! In all .ini files, the lines beginning with a semicolon ; are remark

statements and should not be translated in languages.Do not change or alter any information available within the HTML tags.HTML tags are displayed with symbols < >. Text between < > tagsshould not be translated in languages.



40/82


Current.ini

Note! This file is to be saved in UTF-8 format.

In each of the sections, [All Products], [Products],

[Level&Temp], [S&W], [Volumes], [Vapour], [Product] and[Roof], each line beginning with LineN where N is a number needs

to have the characters between the = and the first | character

translated in the required language.

Example of a small section of the Current.ini file under section [All

Products].

[AllProducts]

MaxTanksPerRow=6

Line1=$||1

Line2=Level||4

Line3=Net Standard Volume|NSV.CV|2

Line4=Weight in Air|WIA.CV|2

Line5=Available Room|AVRM.CV|2

Line6=Free Water Level|FWL.CV|2

Line7=Avg. Temperature|AT.CV|8

To modify the language as in the above example, everything

highlighted in yellow needs to be translated and then saved.

This file has sections for modification which will be viewed on the

TankMaster.net WAP website. The sections are [WapProduct],

[WapUnkProduct], [WapTank], [WapTank2] and [WapUnkTank].

Note! For detailed description on Current.ini file for TankMaster.net websiterefer to section 13.2

DownloadUnicode.ini

Note! This file is to be saved in UNICODE format

In the [Download] section, each line beginning with LangN, where

N is a number, needs to have the characters after = till the end of

the line translated in the required language.



41/82


Example of a small section of the DownloadUnicode.ini file under

section [Download].

[Download]

; Excel sheet titles

Lang1=All Products Overview as on Lang2=Product Overview of as on

Lang3=Inventory details of all tanks as on

Lang4=Product History of for in

()

Lang5=History details of All Tanks for in

()

In the [All Groups], [Groups] and [TankInventory] sections, each

line beginning with LineN where N is a number, needs to have the

characters between the = and the first | character translated in

the required language.

Example of a small section of the DownloadUnicode.ini file under

section [All Groups].

[AllGroups]

Line1=Max level|LL.MX|1

Line2=Level|LL.CV|2

Line3=Net Standard Volume|NSV.CV|2

Line4=Weight in Air|WIA.CV|2Line5=Available Room|AVRM.CV|2

Line6=Free Water Level|FWL.CV|2

Line7=Avg. Temperature|AT.CV|10

To modify the language as in the above examples, everything


Note! For detailed description on DownloadUnicode.ini file for TankMaster.netwebsiterefer to section 13.3

Format_Html.ini and Format_Win.ini

Note! The file, Format_HTML.ini is to be saved in UTF-8 format and the fileFormat_Win.ini is to be saved in UNICODE format

In the [RoofState], [RoofSplState], [RoofPosition], [TankType],

[UnitOfMeasurement] and [Quality] sections, each line beginning

with LangN, where N is a number, needs to have the characters

after = till the end of the line translated in the required language.



42/82


Example of a small section of the Format_Html.ini file under

section [RoofState].

[RoofState]

; ROOF_RESTING_ON_LEG

Lang1=Roof resting on leg; ROOF_PARTLY_FLOATING

Lang2=Roof partly floating

; ROOF_FREELY_FLOATING

Lang3=Roof freely floating

; Else

Lang4=Not valid



Note! For detailed description on Format_Html.ini and Format_Win.ini files forTankMaster.net websiterefer to section 13.4

History.ini and HistoryUnicode.ini

Note! The file, History.ini is to be saved in UTF-8 format and the fileHistoryUnicode.ini is to be saved in UNICODE format

In the section, [HistoryItems] each line beginning with LineN,where N is a number, needs to have the characters after | till the

end of the line translated in the required language.

Example of a small section of the History.ini file under section

[HistoryItems].

[HistoryItems]

Line1=LL.CV|Level

Line2=TOV.CV|Total Observed Volume.

Line3=GSV.CV|Gross Standard Volume.

Line4=NSV.CV|Net Standard Volume.Line5=AT.CV|Average Temperature.

In the [HistoryPeriods] section, each line beginning with LineN,

where N is a number, needs to have the characters after = and

before the | to be translated in the required language.

[HistoryPeriods]

Line1=4 hours|4h

Line2=6 hours|6h

Line3=8 hours|8h

Line4=1 day|1d



43/82


Line5=3 days|3d

Line6=7 days|7d

Line7=1 month|1m

Line8=3 months|3m

Line9=1 year|1y



Note! For detailed description on History.ini and HistoryUnicode.ini files forTankMaster.net websiterefer to section 13.5

Language.ini

Note! This file is to be saved in UTF-8 format

In the [Common], [Login], [Current] and [History] sections, each

line beginning with LangN, where N is a number, needs to have

the characters after = till the end of the line translated in the

required language.

Example of a small section of the Language.ini file under section

[Common]

[Common]; Login Menu

Lang1=Login

; Login Menu tip

Lang2=You need to Login to use this site.

; Change password Menu

Lang3=Change Profile

; Change password Menu tip

Lang4=Change Name, Password etc.

; Help (Top Level) Menu and tip

To modify the language as in the above example, everythinghighlighted in yellow needs to be translated and then saved.

This file has a section [UserStatus] for modification which will be

viewed on the TankMaster.net UserStatus website.

Note! For detailed description on Language.ini file for TankMaster.net websiterefer to section 13.6



44/82


Login.ini


In the [ChangePassword] section, lines beginning with ItemN,

where N is a number, need to have the characters after = till theend of the line translated in the required language.

Example of the Login.ini file

[ChangePassword]

Item1=EmailID

Item2=FullName



Note! For detailed description on Login.ini file for TankMaster.net websitereferto section 13.7

PieChartUnicode.ini


In the [PieChart] section, each line beginning with LangN, where

N is a number, needs to have the characters after = and before

% translated in the required language.

Example of PieChartUnicode.ini file.

[PieChart]

; Free Water Level

Lang1=FWater %

; Product level

Lang2=Utilized %

; Available roomLang3=Available %

; Invalid quality

Lang4=Quality Bad


highlighted in yellow needs to be translated and then saved. The

spaces between the highlighted text and the HTML tags should be

maintained as is.

Note! For detailed description on PiechartUnicode.ini file for TankMaster.net

websiterefer to section 13.8



45/82


TMn2WebLogin.htm

Edit this file in a plain text editor like Notepad.

Locate the line shown below.

Current Language is English

To modify the language in the above example, everything


Locate the lines shown below.

This is a restricted area.

LoginID

Password




This is a restricted area.

LoginID

Old

Password

NewPassword

Confirm

Password





46/82


TMn2WebTanks.htm

Edit this file in a plain text editor like Notepad.


Set Refresh Rate

seconds.



This completes modifying the language for TankMaster.net website.



47/82

Description of .ini files for TankMaster.net website

13.0 Description of .ini files for TankMaster.netwebsite

The administrator can make changes to the TankMaster.net website by

editing the .ini and .htm files. These files are located in theTMnData\Language folders. The .ini files must be saved in the encoding

standard specified. A brief description of encoding standards is given below.

Encoding Standards

Saving a file in Unicode, UTF-8 or ANSI format

To save a file in any of the above formats, open the file in NotePad and click

on File>Save As. Under the Encoding field, select the type of encoding

required as shown below.

About Unicode

The Unicode Standard is the universal character-encoding standard used for

representation of text for computer processing. Unicode provides a consistent

way of encoding multilingual plain text and brings order to a chaotic state of

affairs that has made it difficult to exchange text files internationally. The

character sets of many existing international, national and corporate

standards are incorporated within the Unicode Standard. For example, its first

256 characters are taken from the widely used Latin-1 character set.

Duplicate encoding of characters is avoided by unifying characters within

scripts across languages; characters that are equivalent in form are given a



48/82


single code. Chinese/Japanese/Korean (CJK) consolidation is achieved by

assigning a single code for each ideograph that is common to more than one

of these languages. This is instead of providing a separate code for the

ideograph each time it appears in a different language. (These three

languages share many thousands of identical characters because their

ideograph sets evolved from the same source.)

The Unicode Standard specifies an algorithm for the presentation of text with

bi-directional behavior, for example, Arabic and English. Characters are

stored in logical order. The Unicode Standard includes characters to specify

changes in direction when scripts of different directionality are mixed. For all

scripts Unicode text is in logical order within the memory representation,

corresponding to the order in which text is typed on the keyboard.

About UTF-8

Character encoding standards define not only the identity of each character

and its numeric value, or code point, but also how this value is represented in

bits.

The Unicode Standard defines three encoding forms that allow the same data

to be transmitted in a byte, word or double word oriented format (i.e. in 8, 16

or 32-bits per code unit). All three encoding forms encode the samecommon

character repertoire and can be efficiently transformed into one another

without loss of data. The Unicode Consortium fully endorses the use of any of

these encoding forms as a conformant way of implementing the Unicode

Standard.

UTF-8 is popular for HTML and similar protocols. UTF-8 is a way oftransforming all Unicode characters into a variable length encoding of bytes.

It has the advantages that the Unicode characters corresponding to the

familiar ASCII set have the same byte values as ASCII, and that Unicode

characters transformed into UTF-8 can be used with much existing software

without extensive software rewrites.

About ANSI

Stands for "American National Standards Institute." ANSI does not itself

develop standards or conduct tests; rather it facilitates this work by

"accrediting" (i.e., recognizing) qualified groups with appropriate expertise.The Institute is the official U.S. representative to the International

Organization for Standardization (ISO) and the International Electrotechnical

Commission (IEC). ANSI works within the industries to coordinate and set

standards in the US. ASCII is one of the ANSI standards.

Note! In all .ini files, the lines beginning with a semicolon ; are remarkstatements.Do not change or alter any information available within the HTML tags.HTML tags are displayed with symbols < >.



49/82


The detailed description of the .ini files, which exist in the TMnData\Language

directories, is as follows:

13.1 Colors.ini

Note! This file is to be saved in ANSI format

This file will display the different colors in the History section in thegraph and the Product table.

Colors.ini

; Product Color Table

[ProductColors]Product1=RGB(0,0,0)Product2=RGB(128,0,0)Product3=RGB(0,128,0)Product4=RGB(0,0,128)Product5=RGB(0,128,128)Product6=RGB(128,0,128)Product7=RGB(128,128,0)Product8=RGB(128,128,128)Product9=RGB(255,0,0)Product10=RGB(0,255,0)

Product11=RGB(0,0,255)Product12=RGB(0,255,255)Product13=RGB(255,0,255)Product14=RGB(255,255,0)Product15=RGB(255,128,128)Product16=RGB(128,255,128)Product17=RGB(128,128,255)Product18=RGB(128,255,255)Product19=RGB(255,128,255)Product20=RGB(255,255,128)

; History Graph / Chart Line Colors

[SeriesColors]Series1=RGB(0,0,255)Series2=RGB(0,255,0)Series3=RGB(255,0,0)Series4=RGB(0,255,255)Series5=RGB(255,0,255)Series6=RGB(128,128,0)Series7=RGB(0,0,128)Series8=RGB(0,128,0)Series9=RGB(128,0,0)Series10=RGB(0,128,128)

Series11=RGB(128,0,128)Series12=RGB(128,128,0)



50/82


The data in the colors.ini can be understood as follows.

The data under [ProductColors] section sets the color for differentproducts. The color value should be put in the RGB format (Red value,Green value, Blue value).

The data under [SeriesColors] section will set the colors of the linerepresenting a tank in the graph. Series1 will hold the color for the firsttank that is displayed in the History graph and so on. By default colorsfor 12 tanks have been set.



51/82


13.2 Current.ini


Sections highlighted in gray are relevant to the TankMaster.net WAP

section, which are explained in the TMn2Wap.pdf file.

[General]; s=second, n=minute, h=hour, d=day; 60n = 60 minutesWarnOldValuesTime=60n

;RefreshRate is in secondsRefreshRate=90


; Not Usage = 0; Usage = Not ZeroAutoRefreshIsUsage=1

; Set the first page after login; AGOVW = All Products overview - Default; GOVW = All Tanks overview; TNK = Single Tank inventoryStartPage=GOVW

[AllProducts]MaxTanksPerRow=6

Line1=$||1Line2=Level||4Line3=Net Standard Volume|NSV.CV|2Line4=Weight in Air|WIA.CV|2Line5=Available Room|AVRM.CV|2Line6=Free Water Level|FWL.CV|2Line7=Avg. Temperature|AT.CV|8

[Products]MaxTanksPerRow=6Line1=$||1

Line2=Level||4Line3=Flow Rate|FR.CV|2Line4=Net Standard Volume|NSV.CV|2Line5=Weight in Air|WIA.CV|2Line6=Available Room|AVRM.CV|2Line7=Free Water Level|FWL.CV|2Line8=Avg. Temperature|AT.CV|2Line9=Liquid Level|LL.CV|2

[Horizontal LPG]TankTables=Level&Temp, S&W, Volumes, Vapour, Product,TankImageTablesInLHS=4WapTankTables=WapTank2



52/82


WapUnkTankTables=WapUnkTank

[Spherical LPG]TankTables=Level&Temp, S&W, Volumes, Vapour, Product,TankImage

TablesInLHS=4WapTankTables=WapTankWapUnkTankTables=WapUnkTank

[Floating roof]TankTables=Level&Temp, S&W, Volumes, Roof, Product, TankImageTablesInLHS=4WapTankTables=WapTank2WapUnkTankTables=WapUnkTank

[Fixed roof]TankTables=Level&Temp, S&W, Volumes, Product, TankImage

TablesInLHS=3WapTankTables=WapTankWapUnkTankTables=WapUnkTank

[Spherical]TankTables=Level&Temp, S&W, Volumes, Vapour, Product,TankImageTablesInLHS=4WapTankTables=WapTankWapUnkTankTables=WapUnkTank

[Horizontal]TankTables=Level&Temp, S&W,Volumes, Vapour, Product, TankImageTablesInLHS=3WapTankTables=WapTank2WapUnkTankTables=WapUnkTank

[Level&Temp]Line1=$||0Line2=Level|LL.CV|2Line3=Flow Rate|FR.CV|2Line4=Avg. Temperature|AT.CV|2Line5=Vapor Temperature|VT.CV|2

[S&W]Line1=$|Sediment and Water|1Line2=Sediment and Water|SW.CV|2Line3=Free Water level|FWL.CV|2Line4=Free Water Volume|FWV.CV|2

[Volumes]Line1=$|Volumes|1Line2=Max Volume|MXV.CV|1Line3=Pumpable|PV.CV|2

Line4=Total Observed Volume|TOV.CV|2Line5=Gross Observed Volume|GOV.CV|2



53/82


Line6=Gross Standard Volume|GSV.CV|2Line7=Net Standard Volume|NSV.CV|2Line8=Available Room|AVRM.CV|2Line9=Weight in Air|WIA.CV|2Line10=Pipeline|PC.CV|1

Line11=% Utilization|TOV.CV|10

[Vapour]Line1=$|Vapor|1Line2=Liquid Equivalent of Vapor|LEV.CV|2Line3=Vapor Mass|VM.CV|2

[Product]Line1=$||1Line2=Product Name|PROD.DC|1Line3=Volume Table|VCT.CV|1Line4=Vapor Pressure|VP.CV|2

Line5=Liquid Pressure|LP.CV|2Line6=Observed Density|DOBS.CV|2Line7=Reference Density|DREF.CV|1Line8=TEC of Liquid|TECL.CV|1Line9=Volume Correction Factor|VCF.CV|1

[TankImage]Line1=$||1Line2=||4

[Roof]

Line1=$|Roof|1Line2=Roof Position|ROOF.CP|2Line3=Roof State|ROOF.RS|2

[WapProduct]Line1=$||1Line2=TOV|TOV.CV|2Line3=NSV|NSV.CV|2Line4=WIA|WIA.CV|2Line5=Avl.Room|AVRM.CV|2Line6=% Utilization|TOV.CV|10Line7=Level||4

[WapUnkProduct]Line1=$||1Line2=TOV|TOV.CV|2Line3=NSV|NSV.CV|2Line4=WIA|WIA.CV|2Line5=Avl.Room|AVRM.CV|2Line6=% Util|TOV.CV|10Line7=Level||4

[WapTank]

Line1=$||1Line2=Product|PROD.DC|1



54/82


Line3=L Level|LL.CV|2Line4=Avg.Temp.|AT.CV|2Line5=Flow Rate|FR.CV|2Line6=TOV|TOV.CV|2Line7=Volume Table|VCT.CV|1

Line8=Level||4

[WapTank2]Line1=$||1Line2=Product|PROD.DC|1Line3=L Level|LL.CV|2Line4=Avg.Temp.|AT.CV|2Line5=Flow Rate|FR.CV|2Line6=TOV|TOV.CV|2Line7=Volume Table|VCT.CV|1Line8=Level||16

[WapUnkTank]Line1=$||1Line2=Product|PROD.DC|1Line3=L Level|LL.CV|2Line4=Avg.Temp.|AT.CV|2Line5=Flow Rate|FR.CV|2Line6=TOV|TOV.CV|2Line7=Volume Table|VCT.CV|1Line8=% Util|TOV.CV|10Line9=Level||16

The data under the [General] section is understood as below.

When WarnOldValuesTime=60n is set, a warning message (warning:last known data is used) will be displayed 60 minutesafter theTankMaster Data Collector stops polling data. This warning messagewill be displayed at the top of the web page, next to the time displayed.The administrator can set this time period to display this message inseconds, minutes, hours and days. To change the unit of time, replacen with s for seconds, h for hours and d for days.For example, for 60 seconds, replace 60n to 60s, for 60 minutes set thevalue to 60n, for 60 hours set the value to 60h and for 60 days to 60d.

The Refresh Rate in seconds for the current data can be set by editingthe line, RefreshRate=90. By default, the Refresh Rate is set to 90seconds.

The value of AutoRefreshIsUsage is defined by the values 0 and 1. Thevalue 0 indicates that the auto refreshed pages will not be counted asusage, and the user will be logged out in 20 minutes. The value 1indicates that the user will not be logged off at all if the pages are beingrefreshed periodically.

The data under ; Set the first page after login is to set the first page

that will be displayed when a user logs in to the website. Theexplanation is as follows:



55/82


AGOVWis the ID used for the overview of All Products page.GOVWis the ID used for All Tanks Overview.TNKis the ID used for Single Tank Inventory page.The ID against the StartPage will be the default start up page when theuser logs in to the website.

The data under the [AllProducts] section allows the administrator tocustomize the OPC items to be displayed in the All Products section inthe TankMaster.net website.

The data under the [Products] section is for the All Tanks andProducts tank options on the site.

The information contained in the [Products] and [All Products] sectionis as follows.

.The MaxTanksPerRow=6 indicates the maximum number of tanks a

row can accommodate. The administrator can change this value.

The lines indicate each row. The first line Line1=$| |1 can beunderstood as follows.

The $ indicates that this is the first row in the table.The space between | and | shows that there is no heading for thetable. If required, the heading can be inserted by putting it in betweenthe two |. The number 1 at the end indicates that the table shouldhave a border of size=1.

The data after the key name (Line2=) is the name of the OPC itemsused as the description of each row and the data after | indicates theOPC ID.

All numbers that are displayed at the end of each statement havedifferent meanings.0 = Displays as the Title.1 = Display from fixed data.2 = Display from live data.4 = Display as image (different sections show different types ofimages).8 = Display as average (Total Value / No. of tanks).10 = Display as percentage (TOV /MXV).16 = Create Bargraph as an image (used in the Wap site).

The data under [Horizontal LPG], [Spherical LPG], [Fixed roof],[Floating roof], [Spherical], [Horizontal] allows customization of theTank Inventory depending on the type of tank.

If a user clicks on a type of tank that is a Horizontal LPG, then the datathat will be displayed to the user will be from the tables mentioned forthe Horizontal LPG under [Horizontal LPG] section againstTankTables.



56/82


The TankTables=Level&Temp, S&W, Volumes, Vapour, Product,TankImage indicates that the details of the items given under[Level&Temp], [S&W] etc. will be displayed when the single tanksinformation is displayed. The administrator can alter details of the tanksfrom the TankTable. The details for a particular table are given in the

respective sections.

In the [Level&Temp], [S&W], [Volumes], [Vapour], [Product] and[TankImage] sections.

The first line Line1=$| |0 can be understood as follows:The $ indicates that this is the first row in the table.The space after | shows that there is no heading for the table. If theadministrator wants to put a heading then he can do so by putting theheading in between the two |. The number 0 after the pipes indicatesthat the table has no border.The subsequent rows can be understood as follows:

The data after the key name (Line2=) is the name of the OPC itemsused as the description of each row and the data after | indicates theOPC ID.All numbers that are displayed at the end of each statement have adifferent meaning:0 = Displays as the Title.1 = Display from fixed data.2 = Display from live data.4 = Display as image (different sections show different types of

images).8 = Display as average (Total Value / No. of tanks).

10 = Display as percentage (TOV /MXV).16 = Create Bargraph as an image (used in the Wap site).

Note! For description of the sections relevant to the TankMaster.net WAPwebsite of the Current.ini file refer to section 5.1 in file TMn2WapSite.pdf



57/82


13.3 DownloadUnicode.ini

Note! This file is to be saved in UNICODE format

This file will display the values that will be viewed in the Excel

workbook.

[Download]; Excel sheet titlesLang1=All Products Overview as on Lang2=Product Overview of as onLang3=Inventory details of all tanks as on Lang4=Product History of for in()Lang5=History details of All Tanks for in(); Excel Sheet names - Current - AllProducts-Overview, AllTanks-Inventory; These must match with sheet names in the Current Template file.Lang6=AllGroupsLang7=TankInv; Excel Sheet names - History - AllTanks; This must match with sheet name in the History Template file.Lang8=All Tanks; Other items Tank ID, ProductLang9=Tank IDLang10=Product

; Date-time, ValueLang11=Date-TimeLang12=Value

[CurrentGeneral]xlTemplateFile=TMNCurrent.xlt; = RowNo, ColNoSheetTitleCoordinates=1|2SheetTableCoordinates=2|2xlFileFormat=Excel9

[HistoryGeneral]xlTemplateFile=TMNHistory.xlt; = RowNo, ColNoSheetTitleCoordinates=1|2SheetTableCoordinates=2|2xlFileFormat=Excel9NoOfDataPoints=20

[AllGroups]Line1=Max level|LL.MX|1Line2=Level|LL.CV|2Line3=Net Standard Volume|NSV.CV|2

Line4=Weight in Air|WIA.CV|2Line5=Available Room|AVRM.CV|2



58/82


Line6=Free Water Level|FWL.CV|2Line7=Avg. Temperature|AT.CV|10

[Groups]Line1=Product|PROD.DC|1

Line2=Max level|LL.MX|1Line3=Level|LL.CV|2Line4=Net Standard Volume|NSV.CV|2Line5=Weight in Air|WIA.CV|2Line6=Available Room|AVRM.CV|2Line7=Free Water Level|FWL.CV|2Line8=Avg. Temperature|AT.CV|10

[TankInventory]Line1=Product Type|PROD.DC|1Line2=Level|LL.CV|2Line3=Avg Temperature|AT.CV|2

Line4=Vapor Temperature|VT.CV|2Line5=$|Sediment and Water|1Line6=Sediment and Water|SW.CV|2Line7=Free Water level|FWL.CV|2Line8=Free Water Volume|FWV.CV|2

Line9=$|Volumes|1Line10=Pumpable|PV.CV|2Line11=Total Observed Volume|TOV.CV|2Line12=Gross Observed Volume|GOV.CV|2Line13=Gross Standard Volume|GSV.CV|2

Line14=Net Standard Volume|NSV.CV|2Line15=Available Room|AVRM.CV|2Line16=Weight in Air|WIA.CV|2Line17=Pipeline|PC.CV|1Line18=$|Vapor|1Line19=Liquid Equivalent of Vapor|LEV.CV|2Line20=Vapor Mass|VM.CV|2

Line21=$||1Line22=Product Type|PROD.DC|1Line23=Volume Table|VCT.CV|1Line24=Vapor Pressure|VP.CV|2Line25=Liquid Pressure|LP.CV|2Line26=Observed Density|DOBS.CV|2Line27=Reference Density|DREF.CV|1Line28=TEC Liquid|TECL.CV|1Line29=Volume Correction Factor|VCF.CV|1

The data under the [CurrentGeneral] section is for the Excelspreadsheet that is downloaded for current data and the data under[HistoryGeneral] is for the Excel spreadsheet that is downloaded forpast data. The line XLFileFormat=Excel9 is used to specify theversion of Excel spread sheet to be used. The versions that can be

used are Excel 2000 and above.The number against NoOfDataPointswill be the number of rows used in the History Excel spread sheet.



59/82


SheetTitleCordinates= 1|2 will insert the title of the page in the first cellof the first row. SheetTableCordinates= 2|2 will set the start points ofthe data in the Excel spreadsheet. For this file the data will start fromthe second cell of the second column.

The data under [AllGroups] section allows the administrator tocustomize the All Products option in the Excel spreadsheet.The data under [Groups] section is for the All Tanks option in theExcel spreadsheet. The data under [TankInventory] section is tocustomize the single tank's information.

In the [AllGroups], [Groups] and [TankInventory] sections:

In each group the number of lines indicates the keys. The $ indicatesthat this is the first row in the table. The space after | shows that thereis no heading for the table. If the administrator wants to put a heading,he can do so by putting the heading in between the two |. The number

1 after the pipes indicates that the table has a border of size 1.

The data after Line1= is the name of the OPC items used as thedescription of each row and the data after | indicates the OPC ID.The number 1 indicates that it is Static Data, number 2 indicatesthat it is Current Data. The number 10 indicates that the data in thefield is an average of all the data present for that parameter.



60/82


13.4 Format_Html.ini and Format_Win.ini

Note! The file Format_Html.ini is to be saved in UTF-8 format, while the fileFormat_Win.ini is to be saved in UNICODE format.

Both these files have the same function; the Format_Html.ini file isused to view data on the website and the file Format_Win.ini is used toview data in Windows format.

[RoofState]; ROOF_RESTING_ON_LEGLang1=Roof resting on leg; ROOF_PARTLY_FLOATINGLang2=Roof partly floating; ROOF_FREELY_FLOATINGLang3=Roof freely floating; ElseLang4=Not valid

[RoofSplState]; *Lang1=State for volume value; @Lang2=Roof resting on leg; Lang3=Roof partly floating; =Lang4=Roof freely floating or pressure sensor in liquid

; ?Lang5=Pressure sensor above liquid; ElseLang6=Not valid

[RoofPosition]; ROOF_POS_OPERATIONALLang1=Operational; ROOF_POS_MAINTENANCELang2=Maintenance; ROOF_POS_NOT_VALID

Lang3=Not valid

[TankType]; TT_CYLINDERLang1=Fixed Roof; TT_FLOATINGROOFLang2=Floating roof; TT_SPHERELang3=Spherical; TT_HORIZONTALLang4=Horizontal; TT_SPHERELPG

Lang5=Spherical LPG; TT_HORIZONTALLPG



61/82


Lang6=Horizontal LPG; TT_HTG_FIXED_ROOFLang7=HTG Fixed Roof; TT_HTG_FLOATING_ROOFLang8=HTG Floating Roof

; TT_HTG_FLOATING_BLANKETLang9=HTG Floating Blanket; TT_CARGOLang10=Cargo; TT_BALLASTLnag11=Ballast; TT_MISCLang12=Misc; TT_CARGO_SPHERE_LNGLang13=LNG Sphere; TT_CARGO_MEMBRANE_LNGLang14=LNG Membrane

; TT_CARGO_SPHERE_LPGLang15=LPG Sphere

[UnitOfMeasurement]; 100 = metersLang1=m; 101 = feetLang2=f; 102 = inchesLang3=in.; 110 = meters per hour

Lang4=m/h; 111 = feet per hourLang5=f/h; 120 degrees CentigradeLang6=C; 121 degrees FarenhiteLang7=F; 130 barGLang8=barG; 131 barALang9=barA; 132 psiGLang10=psiG; 133 psiALang11=psiA; 134 PaLang12=Pa; 135 kPaLang13=kPa; 136 Kg per square cm.Lang14=Kg/cm2; 140 cubic meterLang15=m3

; 141 bblLang16=bbl



62/82


; 142 gallons USLang17=gal (US);143 cubic DmLang18=Dm3; 150 Kilogram per cubic meter

Lang19=Kg/m3; 151 degree APILang20=API; 152 60/60 oFLang21=60/60 oF; 153 pounds per gallon USLang22=lb/gal (US); 160 cubic meter /hLang23=m3/h; 161 bbl/hLang24=bbl/h; 162 gal/h

Lang25=gal (US)/h; 163 cubic Dm per hourLang26=Dm3/h; 170 metric tonneLang27=ton (m); 171 ton sLang28=ton (s); 172 ton lLang29=ton (l); 173 KilogramLang30=Kg

; 174 PoundLang31=lb; 1000 digital OnOffLang32=Digital; 1001 RTG StatusLang33=Status; 1002 PercentLang34=%; 1003 per degreeLang35=/; 1004 ppm per degreeLang36=E-6/o; 1005 NoUnitLang37=; 1006 tenth of a secondLang38=1/10 s; 1007 milli VoltLang39=mV; 1008 milli AmpereLang40=mA; 1009 CustomLang41=Custom; 1010 Unit

Lang42=Unit; 1011 Hertz



63/82


Lang43=Hz; 1012 SecondsLang44=s; 1013 pH valueLang45=pH

; 1014 Feet, Inches and 1/16 inchLang46=Ft; 1015 LEDLang47=LED; 1016 DegreesLang48=; 1017 VoltLang49=V; 1018 Alarm StatusLang50=; 0 nullLang51=

; ElseLang52=Unknown #

[Quality]; x0 BadLang1=Bad; x4 Config ErrorLang2=?; x8 Not ConnectedLang3=; xC Device Failure

Lang4=?; x10 Sensor FailureLang5=?; x14 Last KnownLang6=?; x18 Comm FailureLang7=CommFailure; x1C Out Of ServiceLang8=?; x20 Invalid valueLang9=?; x24 Last Known Before FailureLang10=?; x40 UncertainLang11=Uncertain; x44 Last UseableLang12=Last Useable; x50 Sensor CalLang13=Sensor Cal; x54 EGU ExceededLang14=EGUExceeded; x58 Sub NormalLang15=SubNormal

; xC0 GoodQualityLang16=Good Quality



64/82


; xD8 ManualLang17=Man; ElseLang18=Quality #

[VolumeCorrectionTable]; VCT_54Lang1=54; VCT_54_ALang2=54A; VCT_54_BLang3=54B; VCT_54_CLang4=54C; VCT_54_DLang5=54D; VCT_RT_54_A

Lang6=RT 54A; VCT_RT_54_BLang7=RT 54B; VCT_RT_54_CLang8=RT 54C; VCT_RT_54_DLang9=RT 54D; VCT_6_ALang10=6A; VCT_6_BLang11=6B

; VCT_6_CLang12=6C; VCT_6_DLang13=6D; VCT_RT_6_ALang14=RT 6A; VCT_RT_6_BLang15=RT 6B; VCT_RT_6_CLang16=RT 6C; VCT_RT_6_DLang17=RT 6D; VCT_60_ALang18=60A; VCT_60_BLang19=60B; VCT_60_CLang20=60C; VCT_60_DLang21=60D; VCT_24_ALang22=24A; VCT_24_B

Lang23=24B; VCT_24_C



65/82


Lang24=24C; VCT_24_DLang25=24D; VCT_D4311Lang26=D4311

; VCT_CHEMLang27=CHEM; VCT_LINEARLang28=LINEAR; VCT_CUSTOMLang29=Custom; VCT_SPARE_1Lang30=Not Used; VCT_USER1Lang31=USER1; VCT_USER2Lang32=USER2

; VCT_USER3Lang33=USER3; VCT_USER4Lang34=USER4; VCT_USER5Lang35=USER5; VCT_USER6Lang36=USER6; VCT_USER7Lang37=USER7; VCT_USER8

Lang38=USER8; VCT_USER9Lang39=USER9; VCT_USER10Lang40=USER10

The items under the [RoofState], [RoofSplState] and [RoofPosition]sections are displayed while viewing a single tank in the Roof headertable.

The [TankType] section is used to describe the type of tank beingused. There are different types of tanks in which materials are stored.They are Fixed Roof, Floating Roof, Spherical, Horizontal, SphericalLPG, Horizontal LPG etc.

The [UnitOfMeasurement] section describes the units ofmeasurements for different type of items stored in the tanks. Examplesof Units of measurements are:meters = m (Used for measuring Levels).cubic meter = m3 (Unit for measuring volumes).

The [Quality] section comes into effect when the OPC quality of thedata is not acceptable (i.e. Bad, Config error, device failure, Sensor

failure etc.).



66/82


The [VolumeCorrectionTable] section displays measurement unitsthat are universal. All tank containers are not the same. Each containermay have dents, bumps, curvatures etc. (The containers are notuniform). To get an accurate value from these tanks is difficult. Hence amean/average reading has to be taken. For this reason, the Volume

Correction Table comes into effect. This standard is a universalmeasurement and is accepted worldwide.The different types of units used in the Volume Correction Table are 54,54A, 54B, 54C etc. On the TankMaster.net website these values areseen against the values for Volume Table, Vapor Pressure and LiquidPressure.



67/82


13.5 History.ini and HistoryUnicode.ini

Note! The file History.ini is to be saved in UTF-8 format, while the fileHistoryUnicode.ini is to be saved in UNICODE format.

Both these files have the same function. The file History.ini is used toview data in windows format while the HistoryUnicode.ini file is usedto view data on the website.

These files contain the minimum and maximum number of days ahistory graph should be displayed, the name of the OPC items whosedata can be displayed and the color of the lines that will represent atank.

These files are located in the TMnData\Language directories

[General; Number of data points for graphs.NoOfDataPoints=200

;RefreshRate is in secondsRefreshRate=300

;Consider Auto-Refresh as Usage; Not Usage = 0; Usage = Not ZeroAutoRefreshIsUsage=1

[HistoryItems]Line1=LL.CV|LevelLine2=TOV.CV|Total Observed Volume.Line3=GSV.CV|Gross Standard Volume.Line4=NSV.CV|Net Standard Volume.Line5=AT.CV|Average Temperature.

[HistoryPeriods]Line1=4 hours|4hLine2=6 hours|6hLine3=8 hours|8h

Line4=1 day|1dLine5=3 days|3dLine6=7 days|7dLine7=1 month|1mLine8=3 months|3mLine9=1 year|1y

The data under the [General] section is used to set the default refreshrate (in seconds) and AutoRefreshIsUsage for the History page.

The data under the [HistoryItems] section indicates the OPC itemswhose graphical data will be displayed on the site when the History

option is selected. The Line arranges the OPC items in the given



68/82


order. The item between the = and the | is the OPC ID and the itemafter | is the description of the OPC item.

The data under the [History Periods] section stores the options for thehours/days/months/year to be displayed on the history graphs available

for selection and the data seen after | is the unit ID.

The administrator can also change the color of the lines that will bedisplayed on the graph representing different tanks. This can bedisplayed by setting the color changes in the Colors.ini file. For detailson changing the color settings refer to section 13.1



69/82


13.6 Language.ini


This is the main file for making language changes. The translations

made in this file will be reflected on the TankMaster.net and UserStatuswebsites.

The details for the language.ini file are as follows.

Sections highlighted in gray are relevant to the TankMaster.netUserStaus section, which are explained in the TMn2UserStatus.pdf file.

[Common]; Login MenuLang1=Login

; Login Menu tipLang2=You need to Login to use this site.; Change password MenuLang3=Change Profile; Change password Menu tipLang4=Change Name, Password etc.; Help (Top Level) Menu and tipLang5=HelpLang6=Click for help.; Help Menu Second Level - 1 and tipLang7=HelpLang8=Context Help.

; Help Menu Second Level -2 and tipLang9=GlossaryLang10=Glossary of terms.; Logout Menu and tipLang11=LogoutLang12=Click to Logout.; Tank List Menu and tipLang13=Tank ListLang14=List of available tanks.; Overview Menu and tipLang15=Overview

Lang16=Overview.; Overview Menu Second Level - 1 and tipLang17=All ProductsLang18=All Products Overview.; Overview Menu Second Level - 2 and tipLang19=All TanksLang20=All Tanks Overview.; Overview Menu Second Level - 3 and tipLang21=SchematicLang22=Schematic diagram of the tank farm.; History Menu and tipLang23=History

Lang24=Graphs of Historical data; Download Menu and tip



70/82


Lang25=DownloadLang26=Download Microsoft Excel workbook of current data.; Welcome message before Login / after LoginLang27=Welcome toLang28=Welcome

; Postscript on left hand sideLang29=For support contact:
Lang30=Email:
Lang31=Tel:
Lang32=Fax:
; Postscript on right hand sideLang33=Powered by Rosemount TankMaster and RosemountTankMaster.netLang34=Too many users.Lang35=In DEMO mode. Password not changed.

; the Word Tank in TankListLang36=Tank; All Tanks and Available tanks in LHS pane (folding list of tanks)Lang37=All tanksLang38=Available Tanks

[Login]; Page titleLang1=Rosemount Tankfarm monitoring system.; Messages Authentication, TooManyUsers, DemoMode,ProfileChanged.

Lang2=Authentication error. Please try again.Lang3=User profile has been changed. Please login.

[Current]; PageTitles, PageHeader, ErrorPageHeader for TankInventoryLang1=Inventory of tank Lang2=Inventory of tank as on Lang3=Inventory of tank as on (warning: last known data isused!); PageTitles, PageHeader, ErrorPageHeader for ProductGroupLang4=Overview of Lang5=Overview of as on Lang6=Overview of as on (warning: last known data isused!); PageTitles, PageHeader, ErrorPageHeader for AllProductsLang7=Overview of all productsLang8=Overview of all products as on Lang9=Overview of all products as on (warning: last known data isused!); PageTitles, PageHeader, ErrorPageHeader for AllTanks.

Lang10=Overview of all tanksLang11=Overview of all tanks as on



71/82

Description of .ini files

tank master net website manual

Documents