A420750-2 Advanced Topics

ODYSSEY - SCADA 2000 HMI REL. 1

ADVANCED TOPICS

Sept. 2002 CESCUT DATE

ESTABLISHED

TECHNOLOGY

CHECKED

Confidentiality Category DISTRIBUTION

CONFIDENTIAL. All rights reserved. ALSTOM

Restricted

Normal

APPROVED Control Category

Controlled

Not Controlled

Passing on and copying of this document, use and communication of its content are not permitted without prior written authorization.

Centre de Meudon-la-Forêt ALSTOM Technologies , 23-25, avenue Morane Saulnier 92364 Meudon-la-Forêt Cedex - France

Y3-55 A420750-2

Lang. fr

N.Shts 14 CMF 001N

-2-

REVISIONS Version

Date

Page / Paragraph

Comments

(fr : jj mois. aaaa)

CONFIDENTIAL. All rights reserved. ALSTOM. Passing on and copying of this document, use and communication of its contents are not permitted without prior written authorization.

(en : dd Month. yyyy)

1

June 2002

First draft. Corresponds to the first delivery.

2

Sept. 2002

Added the SQL historian configuration

ODYSSEY SCADA 2000 HMI REL.1 ADVANCED TOPICS

Y3-55 A420750-2 30 September 2002

-3-

CONTENTS

CONFIDENTIAL. All rights reserved. ALSTOM. Passing on and copying of this document, use and communication of its contents are not permitted without prior written authorization.

1. INTRODUCTION ................................................................................................... 4 2. TRACING FOR FACTORY LINK S2K....................................................................... 5 2.1.

TRACES PARAMETERS LOCATION ........................................................................... 5

2.2.

TRACES RESULTS LOCATION................................................................................... 5

2.3.

TRACES DEFAULT PARAMETERS .............................................................................. 5

2.4.

TYPICAL TRACE SESSIONS ...................................................................................... 6

3. TRACING FOR PACIS OI UCA2 MODULE .............................................................. 7 4. CREATION OF THE HISTORIAN DATABASE .......................................................... 8 5. CUSTOMIZATION OF THE PACIS OI TOOLS ....................................................... 11 5.1.

TOOL.INI FILE STRUCTURE..................................................................................... 11

5.2.

TOOLS.INI DEFAULT VALUES................................................................................ 12

6. CUSTOMIZATION OF PREDEFINED VIEWS ......................................................... 13 7. HOW TO CUSTOMIZE THE HELP ........................................................................ 14

ODYSSEY SCADA 2000 HMI REL.1 ADVANCED TOPICS

Y3-55 A420750-2 30 September 2002

-4-

CONFIDENTIAL. All rights reserved. ALSTOM. Passing on and copying of this document, use and communication of its contents are not permitted without prior written authorization.

1.

INTRODUCTION This document tackles different topics for an advanced use of PACiS OI : - tracing for Factory Link S2K - tracing for PACiS OI UCA2 module - creation of the Historian database - customization of the PACiS OI tools - customization of predefined views - how to customise the Help - (To Be Completed)

ODYSSEY SCADA 2000 HMI REL.1 ADVANCED TOPICS

Y3-55 A420750-2 30 September 2002

-5-

CONFIDENTIAL. All rights reserved. ALSTOM. Passing on and copying of this document, use and communication of its contents are not permitted without prior written authorization.

2.

TRACING FOR FACTORY LINK S2K Important : ƒ The trace mechanism described here must be used carefully because large amount of data could be registered in huge files so that the PACiS OI may hang. ƒ The trace mechanism must be used only in case of problem investigations, when the advanced user is working close to the PACiS OI host PC. ƒ Once the investigations are done, the trace parameters must be reset to the default ones, and the files containing the traces must be deleted. The PACiS OI must be restarted. The information given here must be completed, reading the Factory Link S2K user documentation. Once PACiS OI has been installed, the trace mechanism is set so that only severe errors are logged. When changing the trace parameters, the new setting are taken in account by Factory Link S2K only at the next restart.

2.1.

TRACES PARAMETERS LOCATION The trace mechanism parameters are set in a specific file “S2KTraceConf.xml“ in the XML format. It is located in the folder pointed by the following registry key : [HKEY_LOCAL_MACHINE\SOFTWARE\Alstom\Odyssey\Configuration] "TraceConf"="OdcS2KTraceConf.xml"

2.2.

TRACES RESULTS LOCATION The trace results are registered in a file which the name is : “ScadaTrace” current date and time ”.txt” example : ScadaTrace_01_15_2002_15_43_38.txt

2.3.

TRACES DEFAULT PARAMETERS The OdcS2KtraceConf.xml file contains the following default parameters : 1

ODYSSEY SCADA 2000 HMI REL.1 ADVANCED TOPICS

Y3-55 A420750-2 30 September 2002

-6-

CONFIDENTIAL. All rights reserved. ALSTOM. Passing on and copying of this document, use and communication of its contents are not permitted without prior written authorization.

0

Be sure that the bold value are set after an investigation. 2.4.

TYPICAL TRACE SESSIONS Tracing the Factory Link S2K start phase. This session is useful to explore in detail the Factory Link S2K activity when starting : ƒ Set this line as follow 1 ƒ Restart PACiS OI (refer to Getting Started ref – A420746) ƒ When the application has started (the current view is refreshed), stop PACiS OI ƒ Reset the trace parameters to the default ones. The advanced user may control : - the number of object created class by class (search for “Creates class instances”) - the start duration (search for “End of start-up phase”) - some duration steps (search for “step”) Be careful in the explanation of the duration, because a lot of environment conditions must be taken in account (processor, memory usage, process running, …) (To Be Completed)

ODYSSEY SCADA 2000 HMI REL.1 ADVANCED TOPICS

Y3-55 A420750-2 30 September 2002

-7-

CONFIDENTIAL. All rights reserved. ALSTOM. Passing on and copying of this document, use and communication of its contents are not permitted without prior written authorization.

3.

TRACING FOR PACIS OI UCA2 MODULE The advanced user may have a look on the UCA2 module activity and especially when some problems occurs as wrong animations on mimics or bad values on the event viewer. This mechanism can be activated even if PACiS OI is already running. No specific parameterization is required. The UCA2 module detects if the real-time window process is running and sends it a set of messages. The messages interpretation must be done with the help of the PACiS technical support. The real-time window too is named DbWin32.exe and can be launched from a shortcut in the PACiS folder of the Windows Start menu. It can be cleared using the “Del” key of the keyboard.

ODYSSEY SCADA 2000 HMI REL.1 ADVANCED TOPICS

Y3-55 A420750-2 30 September 2002

-8-

4.

CREATION OF THE HISTORIAN DATABASE

CONFIDENTIAL. All rights reserved. ALSTOM. Passing on and copying of this document, use and communication of its contents are not permitted without prior written authorization.

Normally, the database Historian is created by SCADA 2000 (launched by PACis OI Server). If the user wants to create this Database, he has to follow the procedure: Select “Enterprise Manager” from menu Start/Programs/Microsoft SQL Server Click on Database , right click on new Data Base

Enter Historian as the database Name

ODYSSEY SCADA 2000 HMI REL.1 ADVANCED TOPICS

Y3-55 A420750-2 30 September 2002

CONFIDENTIAL. All rights reserved. ALSTOM. Passing on and copying of this document, use and communication of its contents are not permitted without prior written authorization.

-9-

Select Data Files tab

ODYSSEY SCADA 2000 HMI REL.1 ADVANCED TOPICS

Y3-55 A420750-2 30 September 2002

CONFIDENTIAL. All rights reserved. ALSTOM. Passing on and copying of this document, use and communication of its contents are not permitted without prior written authorization.

- 10 -

Select Automatically grow file : the data files automatically increase in size by the amount indicated in the following options (megabytes or percent): Select Restrict filegrowth (MB) : specify the size in Mbytes to which a restricted data file can grow Click on OK to validate and create the database Nota : If the Database has been created by SCADA 2000, the user has to open “Enterprise Manager” to modify the 2 last option. MSSQL DB 90% or 100% full message To update HistSt of HMIDIAG brick (** to be completed : not yet available, will be treated with the Archive module **), it must read : 1 – AlarmDatabase1 from S2KHistEvent Site, if this info is set to 1 (means size problem), then read the reason in AlarmInfoDatabase1 (string) which indicates the reason : "Only 10% of space left" or "99% of space used". 2 – Idem for AlarmDatabase2

ODYSSEY SCADA 2000 HMI REL.1 ADVANCED TOPICS

Y3-55 A420750-2 30 September 2002

- 11 -

5.

CUSTOMIZATION OF THE PACIS OI TOOLS The Tools and the SMT functions accessible via the General Functions banner: their parameters are located in the Tools.ini file.

CONFIDENTIAL. All rights reserved. ALSTOM. Passing on and copying of this document, use and communication of its contents are not permitted without prior written authorization.

The Tools.ini file is initialized at installation time. It is then used to parameterize the functions of the Tools and SMT menus (accessible via the General Functions banner). This file is located in the Config Files sub-folder of the Template folder, itself located in the sub-directory that contains the configuration files produced by SCE for PACiS OI. The Tools.ini file can be opened using the Notepad tool. When PACiS OI is launched, the Tools.ini file is read and the list of tools accessible with the Tools button is updated with each found. 5.1.

TOOL.INI FILE STRUCTURE The structure of the Tools.ini file must be as follows: [SMT] CmdLine= ToolFullPath= WorkingDirectory= Arguments= Admin= [TOOLS] NumberOfTools= Tool= [] CmdLine= ToolFullPath= WorkingDirectory= Arguments= Admin= Definitions: and are strings without quote, describing the full path of the executable program; these strings are set during the installation procedure and are required to configure PACiS OI Client. is a string specifying whether the tool uses a specific working directory; this string is not mandatory for PACiS OI Client. is a string used to transmit additional parameters to the tool; this string is not mandatory for PACiS OI Client. is an integer among the range [1,64], used to limit access according to the operator's rights. is an integer among the range [0,255] used only by the file generator; it represents the total number of tools configured in the "Tools" mimic. The value 0 means that no other tool than SMT is installed. is the number of the tool currently described; it is an integer comprised between 1 and .

ODYSSEY SCADA 2000 HMI REL.1 ADVANCED TOPICS

Y3-55 A420750-2 30 September 2002

- 12 -

is the name of the tool as it will be displayed in the "Tools" mimic. 5.2.

TOOLS.INI DEFAULT VALUES

CONFIDENTIAL. All rights reserved. ALSTOM. Passing on and copying of this document, use and communication of its contents are not permitted without prior written authorization.

By default, two tools are configured for the "Tools" mimic: Notepad and Explorer. [SMT] CmdLine= ToolFullPath=C:\WINNT\NOTEPAD.EXE WorkingDirectory=C:\ Arguments= Admin=62 [TOOLS] NumberOfTools=2 Tool1=Notepad Tool2=Explorer [Notepad] CmdLine= ToolFullPath=C:\WINNT\NOTEPAD.EXE WorkingDirectory=C:\ Arguments= Admin=0 [Explorer] CmdLine= ToolFullPath=C:\WINNT\explorer.exe WorkingDirectory= Arguments=D:\ITS\Projets\Projets FrontVue\HMIS2K\Mimic Files Admin=0

ODYSSEY SCADA 2000 HMI REL.1 ADVANCED TOPICS

Y3-55 A420750-2 30 September 2002

- 13 -

6.

CUSTOMIZATION OF PREDEFINED VIEWS (To Be Completed)

CONFIDENTIAL. All rights reserved. ALSTOM. Passing on and copying of this document, use and communication of its contents are not permitted without prior written authorization.

Some modifications can be done to customize PACiS Operator Interface. The concerned files are located in the Template folder, which is itself located in the subdirectory that contains the configuration files produced by SCE for PACiS OI. The list of configurable elements is : - The homepage mimic - The default user (user name, profile and rights) - Some typical times and the Parameter option: these data are defined in the Template.fvp file. -

The General Information banner: its parameters are located in the odStdTitleBanner file.

ODYSSEY SCADA 2000 HMI REL.1 ADVANCED TOPICS

Y3-55 A420750-2 30 September 2002

- 14 -

7.

HOW TO CUSTOMIZE THE HELP (To Be Completed)

CONFIDENTIAL. All rights reserved. ALSTOM. Passing on and copying of this document, use and communication of its contents are not permitted without prior written authorization.

Empty HTML page, which can be replaced by your customized help, providing that your heading page has the same file name as the current one (CustomizedHelp.htm). ƒ Changing the background color The common online help can be customized by changing the background color of its left panel. It can be done by entering the RVB color code, in hexadecimal format, in the following line of the hh_index.htm and hh_toc.htm files by editing them with the Notepad application (for instance #FFFFCC is yellow, and #CEDBDE is blue/grey/green): ƒ Adding HTML pages To create your customized HTML pages, you can use the tool you wish. The only constraint is that the extension for the files must be .htm. As described before, your heading HTML page must have the same name as the reserved one, i.e. customizedhelp.htm. It can contain as many links with other HTML pages as you wish. To fully integrate your pages in the PACiS OI online help, you can edit the following files: ƒ OdysseyHMI.hhc using the HTML Help Workshop (this file is the one file called by the hh_toc.htm file), ƒ OdysseyHMI.hhk using the HTML Help Workshop (this file is the one file called by the hh_index.htm file). The online help can be launched in standalone mode by opening the hh_start.htm file in the HTML page browser.

ODYSSEY SCADA 2000 HMI REL.1 ADVANCED TOPICS

Y3-55 A420750-2 30 September 2002