18.2 Customizing Applications Using Config.ini Variables

 

The tutorial application should still be stopped from the last exercise.

 

1.  Start the text editor of your choice (such as Notepad, WordPad, or UltraEdit).

2.  Open the "Config.ini" configuration file in the text editor.

You will find the "Config.ini" file in the "Tutorial" application directory within the VTS product directory. The contents of your "Config.ini" file should appear similar to the example shown below.

[System]

  Page                    = BoosterStation

  SimulateIO              = 0

  RPCExternalConfig       = 0

  AlarmExternalConfig     = 1

  CallOutPriority         = 2

  DialerLocation          = The VTS System

  CallOutDelay1           = 300

  CallOutDelay2           = 900

  RosterDelay             = 0

  EMailServer             =

  FromEMailAddress        =

  EchoPhoneThroughSpeaker = 0

  UseOldSpeechEngine      = 0

   

As you can see from the example above, the "Page" variable is set to "BoosterStation", indicating that the Booster Station application page will be the first to load when you start the tutorial application. (This is the page's file name, not the title; therefore it contains no spaces).

Let's change the setting of the Page variable so that the Chlorination Unit page is the first page to open when the application is run.

3.  Enter "ChlorinationUnit" (no spaces) after the equals sign for the "Page" variable. The "Config.ini" configuration file should now begin similar to the example shown below.

[System]

  Page               = ChlorinationUnit 
  SimulateIO         = 0 
  RPCExternalConfig  = 0 

4.  Save the "Config.ini" file.

5.  Close the file.

6.  Return to the VAM.

7.  Select the "Tutorial" application in the Available Applications drop-down list.

8.  Click the Run button.

Be ready for the low level alarm to start. You will need to log in before you can acknowledge this alarm.

 

Note that the Chlorination Unit application page opens, rather than the Booster Station application page.

 

The page variable can also be set via a configuration dialog:

9.  Logon using either the Manager1 account or your personal user account.

10. Click the Configure button to open the Configuration Toolbox.

11. Click the Page Manager button.

12. Select "Booster Station" from the Pages list of the Page Manager.

13. Click the Select button. "Booster Station" now appears in the First Page field.

14. Close the Page Manager.

15. Return to the VAM.

16. Click the Stop button to close the tutorial application.

17. Open the "Config.ini" configuration file. The settings should now begin similar to those shown below.

[System]

  Page              = BoosterStation 
  SimulateIO        = 0 
  RPCExternalConfig = 0 

On the next occasion you run the tutorial application, the Booster Station application page will open first.