buildobjserver(1)


	BEA Home \| Events \| Solutions \| Partners \| Products \| Services \| Download \| Developer Center \| WebSUPPORT
	http://www.oracle.com/technology/documentation/index.html \| Site Map \| Search \| PDF Files \| Contact \| Glossary

Tuxedo Documentation \| Command Reference \| Local Topics \| Previous Topic \| Next Topic \| Contents

buildobjserver(1)

Name

buildobjserver—Constructs a CORBA server application.

Synopsis

buildobjserver [-v] [-o name] [-f firstfile-syntax] 
       [-l lastfile-syntax] [-r rmname]

Description

Use the buildobjserver command to construct a CORBA server application. The command combines the files specified in the -f and -l options with the main routine and the standard CORBA libraries to form a server application. The server application is built using the default C++ compiler provided for the platform.

All specified .c and .cpp files are compiled in one invocation of the compilation system for the operating system in use. Users may specify the compiler to invoke by setting the CC environment variable to the name of the compiler. If the CC environment variable is not defined when buildobjserver is invoked, the default C++ language compile command for the operating system in use will be invoked to compile all .c and .cpp files.

Users may specify options to be passed to the compiler by setting the CFLAGS or the CPPFLAGS environment variables. If CFLAGS is not defined when buildobjserver is invoked, the buildobjserver command uses the value of CPPFLAGS if that variable is defined.

Options

-v

Specifies that the buildobjserver command should work in verbose mode. In particular, it writes the compile command to its standard output.

-o name

Specifies the name of the server application generated by this command. If the name is not supplied, the application file is named server<.type>, where type is the extension that is dependent on the operating system for an application (for example, on UNIX systems, there would not be a type; on Windows NT systems, the type would be .EXE).

-f firstfile-syntax

Specifies a file to be included first in the compile and link phases of the buildobjserver command. The specified file is included before the CORBA libraries are included. For a description of the three ways to specify a file or files, see Table 2, Specifying the First Filename(s).

-l lastfile-syntax

Specifies a file to be included last in the compile and link phases of the buildobjserver command. The specified file is included after the CORBA libraries are included. For a description of the three ways to specify a file or files, see Table 3, Specifying the Last Filename(s).

-r rmname

Specifies the resource manager associated with this server. The value rmname must appear in the resource manager table located in $TUXDIR/udataobj/RM on UNIX systems or %TUXDIR%\udataobj\RM on Windows NT systems.

Each entry in this file is of the form:

 rmname:rmstructure_name:library_names.

Using the rmname value, the entry in $TUXDIR/udataobj/RM or %TUXDIR%\udataobj\RM automatically includes the associated libraries for the resource manager and properly sets up the interface between the transaction manager and the resource manager. The value TUXEDO/SQL includes the libraries for the BEA Tuxedo System/SQL resource manager. Other values can be specified as they are added to the resource manager table. If the -r option is not specified, the default is to use the null resource manager.

-h or -?

Provides help that explains the usage of the buildobjserver command. No other action results.

Environment
Variables

TUXDIR

Finds the CORBA libraries and include files to use when compiling the server application.

Indicates the compiler to use to compile all files with .c or .cpp file extensions that are passed in through the -l or -f options.

CFLAGS

Specifies any arguments that are passed as part of the compiler command line for any files with .c or .cpp file extensions. If CFLAGS does not exist in the buildobjserver command environment, the buildobjserver command checks for the CPPFLAGS environment variable.

CPPFLAGS

Note: Arguments passed by the CFLAGS environment variable take priority over the CPPFLAGS environment variable.

Contains a set of arguments that are passed as part of the compiler command line for any files with a .c or .cpp file extensions.This is in addition to the command line option -I$(TUXDIR)/include for UNIX systems or the command line option /I%TUXDIR%\include for Windows NT systems, which is passed automatically by the buildobjserver command. If CPPFLAGS does not exist in the buildobjserver command environment, no compiler commands are added.

LD_LIBRARY_PATH (UNIX systems)

Indicates which directories contain shared objects to be used by the compiler, in addition to the CORBA shared objects. A colon (:) is used to separate the list of directories. Some Unix systems require different environment variables. For HP-UX systems, use the SHLIB_PATH environment variable. FOR AIX systems, use the LIBPATH environment variable.

LIB (Windows NT systems)

Indicates a list of directories within which to find libraries. A semicolon (;) is used to separate the list of directories.

Portability

The buildobjserver command is not supported on client-only CORBA systems.

Examples

The following example builds a CORBA server application on a UNIX system using the emp_s.cpp and emp_i.cpp files:

buildobjserver -r TUXEDO/SQL -o unobserved 
                -f "emp_s.cpp  emp_i.cpp"

The following example shows how to use the CC and CFLAGS environment variables with the buildobjserver command. The example also shows how to link in the math library on UNIX systems using the Bourne or Korn shells using the -f and -lm options:

CFLAGS=-g CC=/bin/cc \
buildobjserver -r TUXEDO/SQL -o TLR -f TLR.o -f util.o -l -lm

The following example shows how to use the buildobjserver command on UNIX systems with no resource manager specified:

buildobjserver -o PRINTER -f PRINTER.o

Sample RM Files

The following are sample RM files for all the supported operating system platforms:

Windows NT

Oracle_XA;xaosw;C:\Orant\rdbms73\xa\xa73.lib
    C:\Orant\pro22\lib\msvc\sqllib18.lib

UNIX

Oracle_XA:xaosw:-L$ORACLE_HOME/rdbms/lib
    -L$ORACLE_HOME/precomp/lib -lc
    -L/home4/m01/app/oracle/product/7.3.2/lib -lsql -lclntsh         
    -lsqlnet -lncr -lcommon -lgeneric -lepc -lnlsrtl3 -lc3v6 
    -lcore3 -lsocket -lnsl -lm -ldl -lthread

Digital UNIX

Oracle_XA:xaosw:-L${ORACLE_HOME}/lib -lxa
    ${ORACLE_HOME}/lib/libsql.a -lsqlnet -lncr -lsqlnet
    ${ORACLE_HOME}/lib/libclient.a -lcommon -lgeneric -lsqlnet
    -lncr -lsqlnet ${ORACLE_HOME}/lib/libclient.a -lcommon
    -lgeneric -lepc -lepcpt 	-lnlsrtl3 -lc3v6 -lcore3     
    -lnlsrtl3 -lcore3 -lnlsrtl3 -lm

AIX

Oracle_XA:xaosw:-L${ORACLE_HOME}/lib -lxa -lsql -lsqlnet 
    -lncr -lclient -lcommon -lgeneric -lepc -lnlsrtl3 -lc3v6 
    -lcore3 -lm -lld

HP-UX : Oracle 8.04

    Oracle_XA:xaosw:-L${ORACLE_HOME}/lib -lclntsh