The Startup Configuration File is an XML file that you can use to launch ClearSCADA on a Multi-Monitor setup (see Configure a Multi-Monitor Setup).
A set of XML Elements is used to define the settings in the Startup Configuration File. You can create and configure the file in any standard XML editing tool.
You can use the Startup Configuration File to:
Define Primary and Secondary Window Containers
You can specify the attributes that are associated with the Primary and Secondary Window Containers, for example, specifying the monitor on which each Window Container appears, whether the Alarm Banner appears in each container or whether containers are displayed in Full Screen mode.
Example:
The following XML code is from a Startup Configuration File for a Multi-Monitor setup with three monitors.
<Startup>
<WindowContainers>
<PrimaryWindowContainer Monitor="1" DisplayMode="FullScreen"/>
<SecondaryWindowContainer Name="Left" Monitor="2" DisplayMode="Restored" />
<SecondaryWindowContainer Name="Right" Monitor="3" DisplayMode="Restored" />
</WindowContainers>
</Startup>
The section within the WindowContainer tags specifies that there is one Primary Window Container (named "Primary" by default), and two Secondary Window Containers (named "Left" and "Right"). The Monitor element uses a number to assign each container to one of the monitors detected by the operating system.
Define how one of more Alarm Banners are displayed
You can define how many Alarm Banners are displayed in multiple containers and their position within the container.
Example:
The following XML code is from a Startup Configuration File for a Multi-Monitor setup with three monitors and illustrates the three types of Alarm Banner that can be displayed in each.
<Startup>
<WindowContainers>
<PrimaryWindowContainer Monitor="1" DisplayMode="FullScreen" AlarmBannerPersistSettings="true" AlarmBannerDisplayState="DockedTop" />
<SecondaryWindowContainer Name="Left" Monitor="2" DisplayMode="Restored" AlarmBannerDisplayState="DockedBottom" />
<SecondaryWindowContainer Name="Right" Monitor="3" DisplayMode="Restored" AlarmBannerDisplayState="Fill" OpenInWindow="Left" />
</WindowContainers>
</Startup>
The AlarmBannerDisplayState attribute within the WindowContainer tags specifies that there is an Alarm Banner in the Primary Window Container (named "Primary" by default) docked at the top of the container.
The two Secondary Window Containers (named "Left" and "Right") contain an Alarm Banner docked at the bottom in the 'Left' container and filling the complete container in the 'Right' container.
You need to add the OpenInWindow element, so that documents (such as the Events list) will display in a different Window Container if opened from the Alarm Banner.
Define the display of Documents
You can specify whether any documents are to display automatically when anyone starts the ViewX client
(including the Window Container in which each document window is to appear)
Example:
The following XML code is from a Startup Configuration File for a Multi-Monitor setup with three monitors.
<Startup>
<WindowContainers>
<PrimaryWindowContainer Monitor="1" DisplayMode="FullScreen"/>
<SecondaryWindowContainer Name="Left" Monitor="2" DisplayMode="Restored" />
<SecondaryWindowContainer Name="Right" Monitor="3" DisplayMode="Restored" />
</WindowContainers>
<InitialDocuments>
<Document Window="Primary" Type="Object" System="MySystem1">Eastern Region.Regional Overview</Document>
<Document Window="Left" Type="Object" System="MySystem1">Eastern Region.Zone 1.Plant Overview</Document>
<Document Window="Right" Type="Object" System="MySystem1">Eastern Region.Zone 2.Plant Overview</Document>
</InitialDocuments>
</Startup>
The section within the InitialDocuments tags specifies the documents that display in each Window Container when the ViewX Client launches.
Define the number of Document windows
You can restrict the maximum number of document windows that can be displayed simultaneously across the suite of Window Containers.
Example:
The following XML code is from a Startup Configuration File for a Multi-Monitor setup with three monitors.
<Startup>
<WindowContainers MaximumDocumentWindows="6">
<PrimaryWindowContainer Monitor="1" DisplayMode="FullScreen"/>
<SecondaryWindowContainer Name="Left" Monitor="2" DisplayMode="Restored" />
<SecondaryWindowContainer Name="Right" Monitor="3" DisplayMode="Restored" />
</WindowContainers>
</Startup>
The section within the WindowContainer tags specifies that there is one Primary Window Container (named "Primary" by default), and two Secondary Window Containers (named "Left" and "Right"). The MaximumDocumentWindows attribute limits the total number of documents that can be opened across all three containers to six.
If the XML in the Startup Configuration File is not valid, a diagnostic message will appear when you launch the ViewX Client (see Resolve an Invalid Startup Configuration File).
Further Information