FairCom RTG COBOL Edition User's Guide

Creating a New File (Advanced)

To create a new configuration file:

1. Select File > New (Advanced) or click the New File (Advanced) hot button:

   If you have unsaved changes in the configuration shown in the tree, you will be prompted to save them.

   A new configuration will be created in the tree with a single root element, <config>.

   

2. Each configuration file requires at least one <instance> element. You will need one instance for each connection to a FairCom RTG server.

   To add a new instance, right-click on the <config> root element and select Add New Element > Instance. The New Instance dialog appears so you can enter the basic information needed for specifying the FairCom RTG server.

   

   Note: If your environment includes more than one FairCom RTG server, you will need to create an instance for each one. Each instance will be directly under the root <config> element. To add another instance, right-click the <config> element and select Add New Element > Instance.

3. Fill in the fields listed in this dialog:

   Server - Specifies the server name and the host name of the FairCom RTG to connect to. The format can be one of the following syntaxes:
   servername
   servername@hostname
   servername@IPaddress
   If the host name or the IP address is omitted, host name defaults to localhost.

   User - Specifies the FairCom RTG user name.

   Password - Specifies the FairCom RTG user password.

   Connect - Choose the desired setting to indicate whether to connect to FairCom RTG at runtime initialization or wait for the first OPEN operation.

   • Not Set - Use the default value.
   • Yes - Connect at runtime initialization.
   • No - Connect during the first OPEN operation. This is the default value.

   Versioncheck - Choose the desired setting to indicate whether to check that the FairCom RTG version matches the FairCom RTG version.

   • Not Set - Use the default value.
   • Yes - Turn on version matching check. Versions must match exactly otherwise an error is returned at runtime initialization.
   • No - Turn off version matching check. This is the default value.
4. A file dialog will allow you to select a folder and file name for the configuration file.

The new configuration file will be displayed in the RTG Config showing the instance you created. You may now add elements as described in the subsequent sections, Editing a Configuration File.