---

2. Differences Between Using the BEA TUXEDO System on UNIX and on Windows NT

---

This chapter highlights information on the following differences between using the BEA TUXEDO system on UNIX and on Windows NT:

• Platform considerations

• Configuration issues

• Specifying machine type and user ID numbers

• Using network drives

• Updating TxRPC

• Using the Bankapp driver

• Starting BEA TUXEDO applications automatically when booting up your system

Reference Materials

Refer to the following guides for information on the BEA TUXEDO system:

• BEA TUXEDO Product Overview

• BEA TUXEDO Workstation Guide for changes needed in the UBBCONFIG file

• BEA TUXEDO Reference Manual (Section 5)

• Administering the BEA TUXEDO System

• BEA TUXEDO Application Development Guide for an overview of the bankapp program

• BEA TUXEDO TxRPC Guide for information on configuration and operation of TxRPC

Windows NT Platform Considerations

• When you specify pathnames, use a back slash ("\"), not a forward slash ("/") to delimit file and directory names on an NT node. We recommend a drive letter ("C:") for all fully qualified paths.

• The .exe suffix for executable files is always implied for the BEA TUXEDO system for Windows NT.

• Filenames follow Windows NT naming conventions. For instance, files ending in .dll identify dynamically linked libraries; files ending in .lib identify statically linked and import libraries; files ending in .cmd identify command scripts. (All BEA TUXEDO system executables, command scripts, and dynamically linked libraries are located in %TUXDIR%\bin. Statically linked libraries are located in %TUXDIR%\lib.)

Configuration Issues

• Two or more versions of BEA TUXEDO software cannot be installed on the same machine.

• Server names are case sensitive.

• Windows NT machine names specified in BEA TUXEDO application files should always be upper case.

• The OPENINFO string in the BEA TUXEDO configuration file must be in the following format:

  OPENINFO="<resource managers>:<resource(s)>"

  For example,

  OPENINFO="TUXEDO/SQL:APPDIR1\bankdl3;bankdb;readwrite"

  Note: The first separator in the preceding string is a colon; subsequent separators are semicolons.

Specifying Machine Type and User ID Numbers

In the MACHINES page of the configuration file, include the following three entries that are different from the BEA TUXEDO system on a UNIX system platform:

• TYPE="WinNT"

• UID=0

• GID=0

Whenever you create a configuration file for a mixed NT-UNIX configuration, include these entries in the MACHINES page for every Windows NT node in your configuration.

Using Network Drives

For reliability purposes, we recommend that you do not use network drives. If, however, you attempt to start up the BEA TUXEDO system on an NT machine that has the TUXCONFIG file on a network drive, you must set the following permissions correctly:

• The network drive must be connected as administrator.

• The administrator must use the same password on the local and remote systems.

• In the tuxipc service startup options, ENTRY must have administrator set for Log On As This Account; the password must be the same as the administrator's so that the tuxipc service has full administrator access rights.

Updating TxRPC

When the BEA TUXEDO system interoperates with OSF/DCE, you must update the environment file to include the following PATH variable for the application, allowing BEA TUXEDO programs to find the OSF/DCE DLLs whenever needed. Review the bldc_dce and blds_dce reference pages for information pertaining to using these commands on the Windows NT platform:

• The bldc_dce command is used to build a BEA TUXEDO system client that can be called via OSF/DCE RPC.

• The blds_dce command is used to build a BEA TUXEDO system server that calls OSF/DCE.

Using the Bankapp Driver

The bankapp program is a small example application bundled with the BEA TUXEDO system for Windows NT. Besides demonstrating the operation of the BEA TUXEDO system and providing an example of BEA TUXEDO application code, the %APPDIR%\UBB file generated by the bankapp driver (driver.exe is located in %TUXDIR%\APPS\bankapp\NT\driver) and can act as a template for configurations for any new applications.

Starting BEA TUXEDO Applications Automatically

When the BEA TUXEDO system is installed on Windows NT as a server, it may be useful to configure the machine to start a BEA TUXEDO application automatically when booting up your system. Microsoft's© Resource Kit for Windows NT contains a utility program named srvany.exe to do this. Refer to srvany.wri and rktools.hlp for instructions on this procedure.

To ensure proper operation of BEA TUXEDO programs that start automatically when booting up, you must set the BEA TUXEDO environment variables %TUXDIR% and %NLSPATH%. Set these variables using the conventional Windows NT method or by using the BEA TUXEDO control panel. (See "Modifying Environment Variables" in Chapter 3, "Configuring the BEA TUXEDO System for Windows NT.")

---

---