Command Reference
buildclient
—Constructs a BEA Tuxedo ATMI client module.
buildclient [ -C ] [ -v ] [ {-r
rmname
| -w } ] [ -oname
]
[ -ffirstfiles
] [ -llastfiles
]
buildclient
is used to construct a BEA Tuxedo ATMI client module. The command combines the files supplied by the -f
and -l
options with the standard BEA Tuxedo ATMI libraries to form a load module. The load module is built by buildclient
using the default C language compilation command defined for the operating system in use. The default C language compilation command for the UNIX system is the cc
(1) command described in UNIX system reference manuals.
Specifies that buildclient
should work in verbose mode. In particular, it writes the compilation command to its standard output.
Specifies that the client is to be built using the workstation libraries. The default is to build a native client if both native mode and workstation mode libraries are available. This option cannot be used with the -r
option.
Specifies the resource manager associated with this client. The value rmname
must appear in the resource manager table located in $TUXDIR/udataobj/RM
. Each line in this file is of the form:
(See buildtms(1)
for further details.) Using the rmname
value, the entry in $TUXDIR/udataobj/RM
is used to include the associated libraries for the resource manager automatically and to set up the interface between the transaction manager and resource manager properly. Other values can be specified as they are added to the resource manager table. If the -r
option is not specified, the default is that the client is not associated with a resource manager. Refer to the UBBCONFIG(5) reference page.
Specifies one or more user files to be included in the compilation and link edit phases of buildclient
first, before the BEA Tuxedo ATMI libraries. If more than one file is specified, filenames must be separated by white space and the entire list must be enclosed in quotation marks. This option may be specified multiple times. The CFLAGS
and ALTCFLAGS
environment variables, described below, should be used to include any compiler options and their arguments.
Specifies one or more user files to be included in the compilation and link edit phases of buildclient
last, after the BEA Tuxedo ATMI libraries. If more than one file is specified, filenames must be separated by white space and the entire list must be enclosed in quotation marks. This option may be specified multiple times.
buildclient
uses the environment variable TUXDIR
to find the BEA Tuxedo ATMI libraries and include
files to use during compilation of the client process.
buildclient
normally uses the default C language compilation command to produce the client executable. The default C language compilation command is defined for each supported operating system platform and is defined as cc
(1) for UNIX system. In order to allow for the specification of an alternate compiler, buildclient
checks for the existence of an environment variable named CC
. If CC
does not exist in buildclient
's environment, or if it is the string ""
, buildclient
will use the default C language compiler. If CC
does exist in the environment, its value is taken to be the name of the compiler to be executed.
The environment variable CFLAGS
is taken to contain a set of arguments to be passed as part of the compiler command line. This is in addition to the command line option "-I${TUXDIR}/include
" passed automatically by buildclient
. If CFLAGS
does not exist in buildclient
's environment, or if it is the string ""
, no compiler command line arguments are added by buildclient
.
When the -C
option is specified for COBOL compilation, buildclient
normally uses the BEA Tuxedo shell cobcc
which in turn calls cob
to produce the client executable. In order to allow for the specification of an alternate compiler, buildclient
checks for the existence of an environment variable named ALTCC
. If ALTCC
does not exist in buildclient
's environment, or if it is the string ""
, buildclient
uses cobcc
. If ALTCC
does exist in the environment, its value is taken to be the name of the compiler command to be executed.
Note: On a Windows system, the ALTCC
and ALTCFLAGS
environment variables are not applicable and setting them will produce unexpected results. You must compile your application first using a COBOL compiler and then pass the resulting object file to the buildclient(1)
command.
The environment variable ALTCFLAGS
is taken to contain a set of additional arguments to be passed as part of the COBOL compiler command line when the -C
option is specified. This is in addition to the command line option:
This option is passed automatically by buildclient
. When the -C
option is used, putting compiler options and their arguments in the buildclient -f
option generates errors; they must be put in ALTCFLAGS
. If not set, the value is set to the same value used for CFLAGS
, as specified above.
Note: See the note under the description of the ALTCC
environment variable.
The environment variable COBOPT
is taken to contain a set of additional arguments to be used by the COBOL compiler, when the -C
option is specified.
The environment variable COBCPY
indicates which directories contain a set of COBOL copy files to be used by the COBOL compiler, when the -C
option is specified.
The environment variable LD_LIBRARY_PATH
indicates which directories contain shared objects to be used by the COBOL compiler, in addition to the BEA Tuxedo system shared objects. Some UNIX systems require different environment variables: for HP-UX systems, use the SHLIB_PATH
environment variable; for AIX, use LIBPATH
.
The buildclient
compilation tool is supported on the following platforms:
Filenames specified in the buildclient
command line must conform to the syntax and semantics of the resident operating system.
CC=ncc CFLAGS="-I /APPDIR/include"; export CC CFLAGS
buildclient -o empclient -f emp.c -f "userlib1.a userlib2.a"
COBCPY=$TUXDIR/cobinclude
COBOPT="-C ANS85 -C ALIGN=8 -C NOIBMCOMP -C TRUNC=ANSI -C OSEXT=cbl"
COBDIR=/usr/lib/cobol LD_LIBRARY_PATH=$COBDIR/coblib:$TUXDIR/lib
export COBOPT COBCPY COBDIR LD_LIBRARY_PATH
buildclient -C -o empclient -f name.cbl -f "userlib1.a userlib2.a"
buildserver(1)
, buildtms(1)
, compilation(5) cc
(1), ld
(1) in a UNIX system reference manual