New Application Properties Dialog

New or Existing.  The topic, Steps to Create a New Application, provided detailed instructions for creating new applications. This reference topic describes each elements of the dialog that is used to configure VTS applications.

The New Application Properties dialog and the Application Properties dialog for standard applications are nearly identical in appearance. The only difference is that some of the elements that can be configured when created a new application cannot be changed in an existing application, and therefore are either disabled in or missing from the Application Properties version.

The New Application Properties dialog is shown in the following image:

 

The elements of the dialog are defined as follows:

Name

The Name field is used to define the title of the application as it will appear in the VAM's Available Applications list.

Path

Cannot be changed when editing the properties of an existing application.

 The Path field indicates the name of the application directory for this application. This path name is normally relative to the VTS product or installation directory, but may be provided as an absolute path.

The Path field automatically defaults to the title you enter in the Name field, with any invalid characters and spaces removed. You may enter a custom path for the application, but you must use valid characters (see Valid Application Path Characters).

Type

Cannot be changed when editing the properties of an existing application.

The Type drop-down list enables you to choose the type for the new application (see "VTS Application Types for further information on application types).

The type can be one of:

      Standard Application (based on the core VTS layer),

      Script Application (not based on the core VTS layer and created using the VTS scripting language)

      Layered Application (based on a custom OEM layer, which is in turn based on the core VTS layer)

AutoStart Application

 

When selected, the Auto Start Application checkbox sets this application to automatically run when the VTS program is run.

Further information on auto-starting applications can be found in Controlling Closure of VTS and VTS Applications.

Generate Debug Symbols

 

When selected, the Generate Debug Symbols checkbox specifies that symbolic reference files should be generated at runtime to allow the VTS Source Debugger to map in-memory modules to source code.

Scripting is beyond the scope of this guide. Please refer to "VTS Programmer's Guide: Source Debugger" for further information.

Page Title

 

Not available when editing the properties of an existing application.

The Page Title field is used to define the title of the initial graphics page for this application.  The default is OVERVIEW, but you may use any title you like.

Information on valid page title characters can be found in Valid Page Title Characters.

Page File Name

 

Not available when editing the properties of an existing application.

The Page File Name field is the name of the initial graphic page's source code file. (The source code for pages is stored in the Pages directory within your application directory. Each has the extension ".src".)

The Page File Name field automatically defaults to the title you enter in the Page Title field, with any invalid characters and spaces removed. You may enter a custom file name for the page, but you must use valid characters.

Configuration Server Choices

 

 

 

 

 

 

 

 

The Configuration Server Choices list is a list of workstations running VTS that will serve as the primary configuration server and backup servers for the new application.

The first workstation referenced at the top of the Configuration Server Choices list is the primary configuration server; all subsequent servers identified in the list are backup servers. In the event that the primary configuration server is unavailable, these backup servers will be called upon in the order in which they appear to enable the application to run until the primary configuration server becomes available.

When the OK button of the New Application Properties dialog is clicked, the application is created, and the workstations specified in the Configuration Server Choices list are saved in two separate locations:

[Configuration-Servers] section of the Sync.wif text file

[RPCManager-Servers] section of the Config.ini configuration file

The Sync.wif text file holds the configuration server information for a remote application. When workstations have been added to the Configuration Server Choices list, they are automatically added to the Sync.wif text file. If the workstations are later modified in the Configuration Server Choices list of the Application Properties dialog, the modification is automatically updated in the Sync.wif text file.

The [RPCManager-Servers] list within the Config.ini file is NOT the same as the [Configuration-Servers] list in the Sync.wif file, although the two sections initially contain identical lists of workstations. The [RPCManager-Servers] section of the Config.ini configuration file contains the default server list for all VTS services, such as the RPC Manager, Alarm Manager, Log Manager, and Security Manager.

The [RPCManager-Servers] section is created once - when the OK button on the New Application Properties dialog is clicked. In other words, if you wish to modify the servers designated for VTS services, you must manually edit the Config.ini configuration file; changes to the Configuration Server Choices list once the application has been created do not affect the [RPCManager-Servers] list.

You may manually modify your application's Config.ini file to change the servers that have been specified for all VTS services, or to add additional sections to the Config.ini configuration file to set up separate servers to manage different VTS services.

Detailed information on remote applications can be found in Introduction to Remote Applications.

Information on modifying the server list for VTS services can be found in "VTS Programmer's Guide: Configure Separate Servers for Separate Services".

Add

 

The Add button enables you to add workstations to the Configuration Server Choices list.

When you click the Add button, the Add Server dialog opens and enables you to select a workstation on the network from a drop-down list, or by entering the workstation's name or IP address. You may use the Add Server dialog to add servers that do not currently belong to the same network as the local workstation to the Configuration Server Choices list in the event that you will later be deploying the application at another site.

Delete 

The Delete button enables you to remove selected workstations from the Configuration Server Choices list.

This Machine is Primary Server

The This Machine is Primary Server checkbox sets the local workstation as the primary configuration server for this application by adding it to the top of the Configuration Server Choices list.

Move Selected

 

The Move Selected arrow buttons enable you to change the position of a selected workstation in the Configuration Server Choices list by moving it up or down the list.

The order in which the workstations appear in the Configuration Server Choices list is relevant; please refer to the Configuration Server Choices description above for further information.

OK

The OK button commands VTS to save the settings you’ve configured in this dialog, generating a new application if this is the New Applications dialog.

Cancel

The Cancel button closes the dialog and discards the settings you've configured.