This chapter describes limitations in BEA TUXEDO Release 6.4 and suggests workarounds for them where appropriate. An MR (modification request) or CR (change request) number is also listed for each problem, for convenience in tracking its resolution.
Note: For the latest list of known limitations, click the What's New icon in the Release Notes included in the online BEA TUXEDO documentation set.
The limitations listed in this chapter apply to one of three categories:
If sufficient user licenses are unavailable, subsequent tmadmins come up in boot mode and display the following message: No BBL exists, entering boot mode.
Configure the required number of licenses.
If a server is not restartable, group migration fails.
Make the server restartable.
The XA implementation in Microsoft SQL/Server has the following restriction: a process can enlist in only one transaction at a time. Any other attempt to enlist (either with TRUE or FALSE) blocks until the transaction that was registered, commits or aborts.
A BEA TUXEDO service must use ODBC Connection Pools, which is a new feature in SQL server. That is, instead of just connecting to the DBMS and then calling ODBC's dbenlistxatrans(), which binds a transaction to a connection until the transaction completes, one must instead establish a new connection every time a service routine is invoked before calling dbenlistxatrans( ).
You cannot display information about XA by running: TMTRACE=*:ulog:dye.
Run TMTRACE=atmi+iatmi+xa:ulog:dye
You cannot specify TxRPC pointer types in idl files on AS/400 platforms.
None
The tidl compiler may generate output lines that exceed the default tuxsrc record length of 240. These lines will be truncated.
Create the tuxsrc file with an appropriate record length in a library; then use the '-out' option to specify that library.
When you specify RESTART=Y for a server in the SERVER section of the UBBCONFIG file and the server is killed, for example, by a KILL signal, the server does not restart.
General Limitations in Release 6.4
Error Message Displayed from Secondary tmadmin.(lc97- 07017)
PROBLEM:
WORKAROUND:
Group Migration Fails (lc97-09003)
PROBLEM:
WORKAROUND:
Microsoft SQL Server XA Limitation (lc97-13501)
PROBLEM:
WORKAROUND:
Trace * Does Not Display XA Information (lc97-14001)
PROBLEM:
WORKAROUND:
TxRPC Pointer Types Do Not Work on AS/400 Platforms (lc97-16705)
PROBLEM:
WORKAROUND:
TIDL Fails on AS/400 Platforms (lc97-16706)
PROBLEM:
WORKAROUND:
Server Doesn't Restart on AS/400 Platforms (CR011566)
PROBLEM:
WORKAROUND:
If a client subscribes to an event and exits without unsubscribing, a tppost()from a server fails with TPESVCFAIL if that client runs again before the sanity scan takes place.
The client should call tpunsubscribe before exiting.
During tpinit, the .SysClientState event for tmadmin identifies the process as "sysclient". During tpterm, the .SysClientState event for tmadmin identifies the process as tmadmin. This is inconsistent.
None
During the installation of BEA TUXEDO /WS for Windows, extra spaces are included in the environment variables in the autoexec.bat file. These extra spaces are positioned before and after the "=" sign character in the assignments.
Remove any spaces from the values of environment variables.
If a transaction is started with infinite time-out, involves more than one machine, and is eventually aborted, it remains in the transaction table.
Transactions should specify a finite timeout. If the transaction table gets full, you must shut down and restart the application.
When running with Domains using transactions under heavy loads, the dmadmin pt command does not work. The command hangs and then returns to the prompt with no message.
None
The LIBTUX message catalogs are currently missing from BEA TUXEDO /WS for 16-bit Windows.
If a message is provided, refer to the BEA TUXEDO System Message Manual for the complete message text.
If an invalid BRIDGE address is specified for a nonmaster machine, the BBL does not get started at the master machine. At the nonmaster machine, the BBL and BSBRIDGE get started.
Terminate the BBL and BSBRIDGE on the nonmaster machine, correct the BRIDGE address, and retry tmboot.
The operating system may take several minutes to report a network failure to the BRIDGE.
If the BBLQUERY timer expires before the operating system reports the failure, the machine is partitioned. The machine will be automatically unpartitioned when the BRIDGE connects on an alternate address.
Configure the system such that BBLQUERY * SCANUNIT (default 30 seconds * 10) is greater than the operating system setting (typically 700 seconds).
BuildTuxedo does not create the default include_me.h file.
Always specify the include filename for BuildTuxedo.
Support for AEW* functions is limited to 16-bit Microsoft Windows clients.
None
A tpconnect will succeed even if a remote service is unavailable. Any subsequent tpsend or tprecv will time out.
None
RUNME.sh fails to build bankapp with the following error message:
Unable to Create $(APPDIR)/ENVFILE
Perform one of the following actions:
The bank.flds file is missing from TUXDIR/apps/bankapp.
Copy the bankflds file from any one of your BEA TUXEDO servers to TUXDIR/apps/bankapp on the client. Rename the file as bank.flds.
With compression enabled, GWTDOMAIN -k dumps core if the remote domain is BEA TUXEDO v5.x.
A software patch is available. Contact the Support Center at one of the following telephone numbers or at the email address listed below:
Client Unable to Build bankapp on Mac Platforms (lc97-)
PROBLEM:
WORKAROUND:
GWTDOMAIN -k Fails (CR011018)
PROBLEM:
WORKAROUND:
If you attempt to shut down GWTDOMAIN while there is an active conversation, GWTDOMAIN will terminate abnormally.
A software patch is available. Contact the Support Center at one of the following telephone numbers or at the email address listed below:
GWTDOMAIN Shutdown Fails during Conversation (CR011033)
PROBLEM:
WORKAROUND:
buildclient produces many extraneous warning messages on SGI IRIX v6.4. These warnings are usually turned off by buildclient on other IRIX platforms.
Pass the '-w' option to the C compiler via '-f ' option to buildclient as in '-f "-w"'.
buildclient fails for Cobol on SCO 5.0. The -belf option passed to cobcc is not handled properly by the cob command.
A software patch is available. Contact the Support Center at one of the following telephone numbers or at the email address listed below:
Extraneous Warnings from buildclient on SGI IRIX v6.4 Platform (CR010922)
PROBLEM:
WORKAROUND:
buildclient Fails for COBOL on SCO OpenServer 5 Platform (CR011532)
PROBLEM:
WORKAROUND:
When TMQFORWARD is started with a low idle time (for example, -i 1), it may block and fail to dequeue from its message queue.
A software patch is available. Contact the Support Center at one of the following telephone numbers or at the email address listed below:
TMQFORWARD May Block (CR010792)
PROBLEM:
WORKAROUND:
The incoming domain connection is rejected if the TDOM section is not configured.
A software patch is available. Contact the Support Center at one of the following telephone numbers or at the email address listed below:
Incoming Domain Connections Rejected (CR011471)
PROBLEM:
WORKAROUND:
Data dependent routing over a conversational connection fails across domains.
A software patch is available. Contact the Support Center at one of the following telephone numbers or at the email address listed below:
Data Dependent Routing Failure (CR011510)
PROBLEM:
WORKAROUND:
During recovery from a failed connection, GWTDOMAIN may exit if GWCTIMEOUT is set.
A software patch is available. Contact the Support Center at one of the following telephone numbers or at the email address listed below:
GWTDOMAIN Exits Unexpectedly (CR011543)
PROBLEM:
WORKAROUND:
The buffer typeswitch index is not maintained correctly across domains.
A software patch is available. Contact the Support Center at one of the following telephone numbers or at the email address listed below:
Inconsistent Buffer Typeswitch Index (CR011775)
PROBLEM:
WORKAROUND:
A tpcall() to the .TMIB service from a /WS client can succeed. Although it returns a failure. This happens only if NOTIFY is set to IGNORE in the configuration file or there is no unsolicited message handler set up for the client.
A software patch is available. Contact the Support Center at one of the following telephone numbers or at the email address listed below:
tpcall() to MIB Returns Failure Although Request Succeeds (lc97-31506)
PROBLEM:
WORKAROUND:
During the processing of VIEW32 buffers, if a tprealloc() is done, the magic number may not be reset correctly.
A software patch is available. Contact the Support Center at one of the following telephone numbers or at the email address listed below:
Magic Number May Not Be Correct for VIEW32 Buffer (lc97-32207)
PROBLEM:
WORKAROUND:
On the Alpha NT platform, context sensitive help button (labeled with a "?" icon) is not working for the "BEA TUXEDO" applet. When you click and drag the "?" button and drop it on a field, nothing happens.
Click the right mouse button to display, "What's this?" Then use this to access help.
When BEA TUXEDO is installed on the Windows NT platform, an incorrect pathname for ULOGPREFIX is set. Consequently, all user log output will be directed to the root of the user's C drive.
Reset ULOGPREFIX correctly.
On Windows NT, wlisten fails connections on ports that specify the NADDR in //machine-name:port-name. A Connection failed message is displayed.
Specify NADRR using the //machine-name:port-number syntax.
If either the DOMAINID or LMID contains a hyphen (-) in the ubbconfig file, tmloadcf fails with the following message: CMDTUX_CAT:1615: Identifier or number must be followed by white space or punctuation.
Do not include a hyphen in the value of DOMAINID or LMID.
While installing BEA TUXEDO /WS (16-bit Windows) on an NT machine, the user is prompted to stop all BEA TUXEDO services running on the NT machine.
Ignore this message. The installation of /WS on the machine will not interfere with the server installation.
During installation on NT platforms, the following error messages are displayed:
Cannot update MSVC DLL's because:
mfc42.dll - FILE_IS_LOCKED
msvcrt.dll - FILE_IS_LOCKED
Click OK. The installation will succeed.
When stopping the tlisten service on Windows NT, the following error message is displayed: The service is not responding to the control function.
Click OK to clear the message; the tlisten process is stopped.
Any partial tmboot, either -l, -T, or -g, does not boot the TMSs in the appropriate groups.
Do a full tmboot, or use tmboot -S -g.
On NT, when you run some BEA TUXEDO administrative server processes, console windows are displayed.
Ignore them.
The log file is always created in the current directory with the WB prefix.
None
When requested through the Web GUI, abort transaction operations fail. An appropriate message: ABORT failed is displayed.
Use the tmadmin command to abort transactions.
If the tlisten password (same password used for the Web GUI) is enabled, you receive the following message after typing your password in the Login screen of the Web GUI.
Password incorrect. Try again.
If your tlisten password is disabled, the password for the Web GUI works.
A software patch is available. Contact the Support Center at one of the following telephone numbers or at the email address listed below: