Client Administration Guide - Assign a Head Number to a Window Container (Startup Configuration File)

Assign a Head Number to a Window Container

Some of Geo SCADA Expert's functions and properties use the legacy term 'head' to identify a particular monitor in a multi-monitor setup. To enable these functions to operate as intended, you need to allocate head numbers to the Window Containers that are included in the Startup Configuration File. This will allow a Window Container to emulate the role of a head.

If a function uses a head number that does not correspond to a Window Container, the associated script will return a diagnostic message.

The functions and properties that use the term 'head' are:

App.Head (a property of the Application script object)
App.OpenWindowOnHead (a function of the Application script object)
App.NavigateOnHead (a function of the Application script object)
HEAD (an expressions function).

If any of these are implemented in your Geo SCADA Expert system, you need to determine how the head definitions are used. Then you need to assign matching head numbers to the Window Containers that are configured in the Startup Configuration File.

To specify a head number for a Window Container, use the LegacyHead attribute.

Example:

The following line of script uses the App.OpenWindowOnHead function to display a Mimic on head 2.

App.OpenWindowOnHead (2,"SCX:////CMimic/.System Overview")

To enable this function to work correctly on a system using Window Containers, you would need to set the LegacyHead attribute to 2 for the appropriate Window Container.

Likewise with this Startup Configuration file from a system that has been upgraded from ClearSCADA 2017 R3 or earlier:

Attention: If a head number is not specified for a Window Container, the system will automatically assign a number based on the order in which the Window Containers are defined in the Startup Configuration File. This may produce unexpected results. To avoid this situation, you should manually assign head numbers to Window Containers.

NOTICE

unexpected behavior OF APPLICATION

Startup Configuration files are intended only for use on ViewX clients that are required to launch Geo SCADA Expert on a Multi-Monitor setup, and/or have customized Window Container behavior.

Do not use Startup Configuration files on Virtual ViewX clients, as these clients only support a single monitor setup, and do not support the same customized behavior. Using a Startup Configuration file on such a client could result in unexpected behavior. (Startup Configuration files are not supported, and are ignored, on Original WebX clients.)

Failure to follow these instructions can result in inoperable equipment.

Further Information

Creating a Hyperlink to a ViewX ‘Document’ on Another Monitor.