Specifying Application Settings

There are a number of settings in several categories that you can use to control the behavior of the C++ Expert during logon and development:


 

Logon Settings

The values you specify on this window are automatically entered into the fields of the Logon window when it is displayed.

To set logon defaults:

  1. Choose Settings->Logon from the main menu to open the Logon Settings window.

  2. Enter values for the fields you wish to have a default value during logon. For more information about all these fields, refer to the description of the Logon window in the Windows and Dialogs Reference section.

  3. Click OK.

    Figure 3-4 Logon Settings

For more information about fields on this window, refer to the Logon window, Logon Settings window, and Logging On task description.
 

Generate Settings

You can modify the type of code generated and where generated files are saved by changing the values for the fields on this window.

To set generation defaults:

  1. Choose Settings->Generate from the main menu to open the Generate Settings window.

  2. Change the values of the fields you wish to modify. (Each of these fields is described below.)

  3. Click OK.

    Figure 3-5 Generate Settings

The C++ Expert uses the Project Root Directory as the top of the directory structure where sub-directories are created for the project and generated files are placed. Generated files associated with each module are placed in a sub-directory named for that module. The complete organization of these directories is described in the Directory Structure section.

The Template Directory field contains the location of files used by the C++ Expert when application files are generated. The contents of this field is specified when BEA TUXEDO Builder is installed. If you have a customized version of the C++ Expert templates, you can put their location in the Template Directory field to use them instead of the templates provided with the C++ Expert.

Warning: If the Template Directory field indicates a directory that does not contain the C++ Expert templates, the C++ Expert will not be able to generate sample application code.

The FML Table File Name field is used by the C++ Expert when you generate an FML field table file, described in the Generating FML Field Tables section. When this file is generated, it is placed in the directory specified by the Project Root Directory field and given the name specified in this field with .fml appended. For example, if the Project Root Directory is set to: C:\TUXBldr\CPPExpert\output and the FML Field Table File Name is set to FMLFieldTableFile, the C++ Expert will put the generated FML field table in a file called:

C:\TUXBldr\CPPExpert\output\FMLFieldTableFile.fml

The Generate for FML Buffer Type field can be used to ensure that all the FML buffers used in all the services of a module match the selected buffer type. A dialog box will be displayed when a module fails this check (as shown in Figure 3-6) and those modules will not be shown in the Contract Repository tree view. When you change this field, the C++ Expert will remind you to refresh the current content of the C++ Expert repository tree view from the Contract Repository.

Figure 3-6 FML Buffer Type Mis-match Warning

In order to resolve a FML buffer type mis-match, you can:

When the Generate Server Test Client checkbox is enabled, the C++ Expert will generate a command-line test client application that can be used to connect to the generated server and test each service.

When the Generate Service Test Logic checkbox is enabled, code generated by the C++ Expert include simple test logic for each service.

For more information on how to compile and use the command line test client, refer to the Testing Default Service Implementations section.

For more information about fields on this window, refer to the Generate Settings window description.
 

Makefile Settings

You can modify the contents of the make file the C++ Expert generates by changing the default values for the fields on this window.

To set make file defaults:

  1. Choose Settings->Makefile from the main menu to open the Makefile Settings window.

  2. Change the values of the fields you wish to modify. (Each of these fields is described below.)

  3. Click OK.

    Figure 3-7 Makefile Settings

The contents of the Target Platform field is specified in a comment in each of the generated files. When you change the value of this field, value of the C++ Compiler field is changed to the default C++ compiler from this table:

Table 3-1 Supported Compilers

Platform OS Compiler

HP 9000

HP-UX

CC

INTEL

Windows NT

cl

SPARC

Solaris

CC

After you have selected a target platform, you can enter a different value in the C++ Compiler field but, if the Target Platform field is changed, the C++ compiler will be changed back to the default from Table 3-1

The contents of the TUXEDO Directory field is assigned to the TUXDIR variable in the generated make file. You will need to specify the contents of this field.

The contents of the Resource Manager field is assigned to the RM_NAME variable in the generated make file.

For more information about fields on this window, refer to the Makefile Settings window description.
 

Sample Code Settings

You can modify type, style and display of sample code the C++ Expert generates by changing the default values for the fields on this window.

To set sample code defaults:

  1. Choose Settings->Sample Code from the main menu to open the Sample Code Settings window.

  2. Change the values of the fields you wish to modify. (Each of these fields is described below.)

  3. Click OK.

    Figure 3-8 Sample Code Settings

When the Generate Sample Code checkbox is enabled, the C++ Expert will generate sample application code and display it in the Sample Application Code window of the Main Window. (If the Automatic Paste to Clipboard checkbox is enabled, it is also copied to the system clipboard, allowing you to paste the sample code directly into your development environment.) If the checkbox is disabled, you cannot change the settings of any of the other fields on this window, the Sample Application Code window is not displayed on the Main Window and nothing is copied to the system clipboard.

When the Generate Transaction Code checkbox is enabled, the C++ Expert will put transaction code before and after each service that could participate in a transaction. This allows you to use the C++ Expert to generate sample code in both modes, as required by your application.

Each of the Parameter Name Prefix fields can be used to customize how variables are named in the generated source code. Each parameter listed will have the contents of the corresponding field prepended to the name of the parameter. Each of these fields can contain only letters, numbers and the underscore (_) character, and may contain no more than five characters.

For more information about fields on this window, refer to the Sample Code Settings window description.