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   |   Programming   |   Topic List   |   Previous   |   Next   |   Contents

   Programming a BEA Tuxedo Application Using TxRPC

The interface for the IDL compiler is not specified in any X/OPEN specification.

For DCE application portability, the BEA Tuxedo system IDL compiler has a similar interface to the DCE IDL compiler, with the following exceptions:

• The command name is tidl instead of idl so an application can easily reference either when both appear in the same environment.

• The -bug option, which generates buggy behavior for interoperability with earlier versions of the software, has no effect. The -no_bug option also has no effect.

• The -space_opt option, which optimizes the code for space, is ignored. Space is always optimized.

• A new option, -use_const, is supported. -use_const generates ANSI C const statements instead of #define statements for constant definitions. This gets around an annoying problem where a constant defined in the IDL file collides with another name in the file using a C-preprocessor definition, but is properly in another name space when defined as a C constant. Use of this feature will limit portability of the IDL file.

• On DOS and OS/2, the -keep object option is not supported and the -keep all option will generate C source code only. By default, the IDL compiler generates C source code for the stubs and then compiles them automatically. The automatic compilation of the stubs is not done on DOS and OS/2 (the equivalent of -keep c_source due to memory limitations on these platforms. Also, only the client stub is generated; server stub generation is not supported on DOS and OS/2 (to reduce the size of the tidl executable).

• By default, /lib/cpp, /usr/ccs/lib/cpp, or /usr/lib/cpp (whichever is found first) is the command used to preprocess the input IDL and ACF files. On DOS and OS/2, the default is to not pre-process IDL and ACS files.

By default, the IDL compiler takes an input IDL file and generates the client and server stub object files. The -keep c_source option generates only the C source files, and the -keep all option keeps both the C source and object files. The sample RPC application, listed in A Sample Application, uses the -keep object option to generate the object files.

By default, at most 50 errors are printed by tidl. If you want to see them all (and have more than 50 errors), use the -error all option. The error output is normally printed to the stderr, but is printed on the standard output on DOS and OS/2 platforms (since there is no standard mechanism to redirect the standard error on these platforms).

See tidl(1) in BEA Tuxedo Command Reference for details on the many other options that are available.