The WinForm Container operates through the WinForm Container executable file, and is controlled by an XML configuration file. The WinForm Container executable is run from a shortcut, or from the command line with the name of the XML file appended as a parameter. The XML file is read by the WinForm Container and the instructions in the XML file to direct the WinForm Container to the correct location and system. If the shortcut does not specify an XML configuration file, the WinForm Container executable returns an error message, “Unable to find a CLSID for corresponding to the system name”.

The Agile Business Suite Developer installation includes a default XML file called config.xml which is located in the bin folder of the installation path, along with the WinForm Container executable. Also, a pre-configured XML file called ispec.xml is generated when each system is built by Builder. This file is located in your systems installation Bin folder.

A different XML configuration file can be specified by entering a path or URI after the 'WinForm Container.exe from a command line, or in a shortcut.

For example, "WinForm Container.exe" c:\AgileBusinessSuite\payroll.xml

If you specify a URI, the WinForm Container accesses the configuration file from a central location.

For example, "WinForm Container.exe" http://tardis/payroll.xml   

You can setup a different shortcut for each system you might access, and for users who are required to access certain ispecs, reports and commands.

If you only access one system at a time, the configuration file should only have one 'system' defined in it. If you access multiple systems via the SWITCH.TO command, you must include all systems that you might switch between in the one configuration file.