Corporate Info  |  News  |  Solutions  |  Products  |  Partners  |  Services  |  Events  |  Download  |  How To Buy
	http://www.oracle.com/technology/documentation/index.html   |   Site Map   |   Search   |   PDF Files   |   Contact   |   Glossary
Tuxedo Doc Home   |   Platforms   |   Topic List   |   Previous   |   Next   |   Contents

   Using the BEA Tuxedo System on Windows NT

Before you can build your BEA Tuxedo application in an IDE, you must set the following fundamental parameters in your environment:

• Build type

• Header file

• Filename of the C or C++ file to be created and maintained by BuildTuxedo

• Function names

• Service names

To provide this information, access the BuildTuxedo Project dialog box in the msdev GUI.

To specify the build type, header file, and filename:

1. From the BuildTuxedo dialog box, select the Build tab.

   Build Page

   

2. In the Build Types field, click the down arrow and choose one of the following:

   • Server

   • Native client or Workstation client

     Note: Windows 95 and Windows 98 users can select Workstation Client type only.

     If you Select. . .	Then, After Your Selection. . .
     Server	Enter information in the Initialization, Cleanup, and Entry Point fields. Proceed to Step 3.
     Native Client or Workstation Client	Proceed to Step 3.

     The Initialization and Cleanup options allow you to override the default init/exit functions by specifying valid function names. The Entry Point option allows you to specify the name of the function that BuildTuxedo generates. You can then call this function from anywhere in the application.

3. In the Header File field, enter stdafx.h.

4. In the File Name field, enter the name of the C or C++ file to be generated and maintained by BuildTuxedo.

In the header file, BuildTuxedo adds the necessary pragma statements to build the current BEA Tuxedo project correctly. BuildTuxedo opens the file specified in the Header File field of the Build page, if the file is present; otherwise, it creates a new one. A section starting with //Begin Tuxedo Section*****DO NOT EDIT***** and ending with //End Tuxedo Section designates the area in the header file that BuildTuxedo maintains and into which pragma statements are written. If BuildTuxedo does not locate this section in the file, it appends it to the end of the header file. Because all other text within the file remains unchanged, you can specify stdafx.h as the header file.

Note: If your project is new, and you select OK or Apply, you must select Files into Project from the msdev Insert menu. You then add the file generated by BuildTuxedo to the current project. You need to do this only for a new project or when you change the name of the C/C++ output file.

Select the Services tab to specify function and service names. The following figure illustrates the Services page.

Two lists are used to maintain the service dispatch table.

• Function Names is a user-maintained list of functions that you can associate with a service.

• Service Names is a user-maintained list of the associated services.

  Note: To scroll up and down either list, use the arrow keys.

Generally, the service and the function that performs the service are represented by the same name. For example, function x performs service x. In some cases, the function may have a different name from the service it performs. For example, in one case, function abc performs services x, y, and z. In another case, the service name may not be known until run time.

You must specify any function associated with a service when you build the server. For any function associated with a service, you must specify the service, the appropriate prototype, a C linkage, a void return, and a single TPSVCINFO pointer parameter. To specify a function to which a service name can be mapped, you must add the function to the Function Name list. This information is required for the service dispatch table. (If you are using the buildserver(1) command, you can provide this information with the -s option. Refer to Programming a BEA Tuxedo Application Using C or Programming a BEA Tuxedo Application Using COBOL for more information on the -s option.)

To add or edit names on the Function Names list:

1. In the Services folder, choose one of the following actions.

   To	Action
   Add an item	Click New (broken box with twinkle in the upper left corner). Click Insert, or select a blank area on the list (that is, a dotted lined box). Type the name of the new function.
   Modify an existing name	Highlight the name, and type over it.
   Delete a name	Highlight the name on the list and click the X icon or click Delete.

2. When complete, click Enter to save your changes and exit. (To exit without saving your changes, click Esc or Tab.)

To specify a resource manager:

1. Select the Resources tab from the BuildTuxedo menu to display the Resources page, as shown in the following figure.

   Resources Page

   

2. In the Tuxedo Resource Manager field, type the entire path name of the resource manager for your application.

   Note: The Tuxedo Resource Manager field contains a list of BEA Tuxedo resource managers available on the system as defined in the %TUXDIR%\udataobj\RM file. If the file is not present, a default (NONE) is displayed.