FairCom RTG COBOL Edition User's Guide

Creating a New File (Basic)

The Basic Configuration wizard allows you to configure your system in a hurry. This wizard will help you create a configuration file for a system that connects to a single FairCom RTG server. It offers a rich set of options, so it may be all you need to get going.

If your system is more advanced, for example if it connects to multiple FairCom RTG servers, you can start with the Basic Configuration wizard and then edit the results in the RTG Config tree window (or you can simply start with New File (Advanced)). If you created a basic configuration file when you migrated your data with the RTG Migrate tool, you can skip the Basic Configuration wizard and edit the resulting file as described in Editing a Configuration File.

To create a new configuration file using the Basic Configuration wizard:

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

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

   The Basic Configuration wizard will appear:

   

2. Fill in the fields listed in this dialog. The first tab, called Create Instance, is where you define your connection to the FairCom RTG server.

   Instance - These fields define how you log onto the FairCom RTG server:

   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.

   Instance Global Options - These fields define attributes that apply to this entire connection to the FairCom RTG server. Many options are available, including transaction processing, encryption, compression, logging, and file name suffixes. The options provided here correspond to the configuration Settings Elements defined later in this manual.

3. The Files / Directories Maps tab allows you to enter more information about the location of your files.

   Notice that these fields accept wildcards. See Wildcard File Matching Rules and File Matching Precedence.

   
   
   

4. Click Create to save your file. 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 later sections, Editing a Configuration File.