ViewX Command Line Arguments

You can use the /register ViewX command to restore registry settings. This is useful if the Windows’ registry editor (regedit) has been used to alter registry settings incorrectly (which may cause ‘Class Not Registered’ errors if you are using the Automation interface). You may be able to correct the errors using /register.

When you use /register, Geo SCADA Expert is able to repair many (but not all) incorrect registry settings relating to Geo SCADA Expert.

To use /register:

If required, you can run multiple instances of the ViewX client application on a single client machine.

You might want to use this setup, for example, if you want to run multiple instances of a ViewX client on a single machine and want each of those ViewX instances to access a different Geo SCADA Expert serverand database. (If you want to have a distributed arrangement where different components and documents from the same ViewX client are hosted on different monitors, consider using a Multi-Monitor setup, rather than a Multiple Instance setup, see Multi-Monitor Setup.)

To configure ViewX to run multiple instances on a single client:

1. Log on to the client PC.
2. Using Windows Explorer, browse to the location of the ViewX application. The default location is::

   "C:\Program Files (x86)\Schneider Electric\ClearSCADA"

3. Locate the SE.Scada.ViewX.exe file and right-click on it to display a context-sensitive menu.
4. Select the Create Shortcut option to create a shortcut to ViewX. The shortcut item is added to the list of files in the ClearSCADA folder.
5. Right-click on the shortcut item and select the Properties option from the context-sensitive menu.
   The Shortcut Properties dialog box is displayed.
6. Modify the Target field by adding the following string to the link:

   /instance:<number>

   Where <number> is the number of the instance of ViewX that runs when you run it from the shortcut. Do not enter the angle brackets <>.

   For example, the target should be similar to:

   "C:\Program Files (x86)\Schneider Electric\ClearSCADA\SE.Scada.ViewX.exe" /instance:2"

7. Select the OK button to confirm the target and close the dialog box.
8. In Windows Explorer, double click on the shortcut and verify that ViewX runs as expected.
9. Repeat this procedure for each instance as required.

You can use the /bellsilenced ViewX command to silence the alarm bell on a ViewX client When the command is used, the alarm bell will not sound, no matter what other alarm bell configuration options are set for the ViewX client or for the Users that might log on to Geo SCADA Expert using that ViewX client. This command is useful, for example:

• To disable the bell on most (but not all) ViewX clients when Multiple Instances of ViewX are used to connect to the same database(s) and those ViewX instances are placed in close proximity to each other. Rather than having the bell ring on all of the ViewX instances, you can use the command to silence the bell on all but a few of those ViewX instances. (Also see Use a ViewX Command to Run Multiple Instances of the ViewX client.)
• To disable the bell on a ViewX client that purely hosts a system overview on a large display screen in a control room, if the bell is not required to sound on that particular client machine. The command is useful for situations in which the alarm bell is only required to sound on the other ViewX clients in the control room (those that are intended to provide individual user access to Geo SCADA Expert via computer monitors).

WARNING

LACK OF AUDIBLE ALARM NOTIFICATION

Use the /bellsilenced ViewX command with care. Ensure that the command is NOT used on at least one ViewX client in a Multiple Instance setup in which the clients connect to the same database. Also ensure that the Alarm Banner is displayed on the ViewX clients on which the command is NOT used (as the audible alarm can only sound on ViewX clients on which the Alarm Banner is displayed).

Before using the command, we strongly recommend that you perform a risk analysis to ensure that the lack of an audible alarm bell will not pose a danger to people or equipment when alarms are raised. Ensure that users are aware of the ViewX clients on which the audible alarm will and will not sound, and that they can access the relevant clients to respond to the alarm and/or silence the alarm bell, as required. Also that the users should rely on other means of notification when alarms are raised on the ViewX clients on which the audible alarm will not sound.

Failure to follow these instructions can result in death, serious injury, or equipment damage.

Be aware that with a ViewX client on which the /bellsilenced ViewX command is used, the command overrides other alarm bell configuration options set elsewhere on the ViewX client and the accounts of Users that might use that ViewX client.

To use the /bellsilenced ViewX command:

1. In Microsoft Windows, run the Command Prompt.
2. When the prompt is displayed, use the change directory command to locate your ViewX application. For example, if your command prompt shows Documents and Settings\<Your Windows ID> when you first display it, you need to enter:

   cd <the location of your ViewX application>
   

Do not include the angle brackets. For example:

cd C:\Program Files (x86)\Schneider Electric\ClearSCADA


3. Press the Enter key. The command prompt should change to show the location of your ViewX application.
4. When the prompt shows the location of your ViewX application, enter:

   SE.Scada.ViewX.exe /bellsilenced

5. Press the Enter key.
   Geo SCADA Expert will disable the audible alarm bell on the ViewX client.

You can use the /Startup command to associate a ViewX client with a Startup Configuration File. You can use a Startup Configuration File to Launch a ViewX Client on a Multi-Monitor Setup, and/or configure the ViewX client to have customized Window Container behavior.

For more information, see Define an Alternate Startup Configuration File .

To disable any script execution when starting ViewX (see Disable Script Execution).

You can use the /openobject:DatabaseObjectName command to open the display for a named database item when ViewX is loaded. The display is shown when the user logs on (provided that their User Account has permission to access the specified database item). You might opt to use this command as an alternative to configuring a Home Page for each User Account (see Define the Home Page Settings for a User). If you use this command when a Home Page is configured on any User Accounts, the display specified by this command will take precedence over that Home Page.

The type of display that is shown varies, depending on the type of database item and the permissions of the logged on user. For example, the command might display a Properties Form, or a 'document' such as a Logic program or a Mimic, and so on.

To use the command:

1. Log on to the client PC.
2. Using Windows Explorer, browse to the location of the ViewX application. The default location is:

   "C:\Program Files (x86)\Schneider Electric\ClearSCADA"

3. Locate the SE.Scada.ViewX.exe file and right-click on it to display a context-sensitive menu.
4. Select the Create Shortcut option to create a shortcut to ViewX. The shortcut item is added to the list of files in the ClearSCADA folder.
5. Right-click on the shortcut item and select the Properties option from the context-sensitive menu.
   The Shortcut Properties dialog box is displayed.
6. Modify the Target field by adding the following string to the link:

   /openobject:<DatabaseObjectName>

   Where <DatabaseObjectName> is the full path of the database item that ViewX is to display whenever ViewX is launched from the shortcut. Do not enter the angle brackets <>.

7. Select the OK button to confirm the changes and close the dialog box.
8. In Windows Explorer, double-click on the shortcut and verify that ViewX runs as expected and loads the required display on logon.

You can use the /openobject:SystemName:DatabaseObjectName command to open the display for a named database item on a particular Geo SCADA Expert or Virtual ViewX server when ViewX is loaded.

The type of display that is shown varies, depending on the type of database item. For example, a Properties Form, a 'document' such as a Logic program or a Mimic, and so on.

Use this command in the same way as the /openobject:DatabaseObjectName command (see above).