PURPOSE

buildwsh - build customized workstation handler process

SYNOPSIS

buildwsh
[ -v ]
[ -o name]
[ -f files]

DESCRIPTION

buildwsh is used to construct a customized TUXEDO System/T workstation handler module. The files included by the caller should include only the application buffer type switch and any required supporting routines. The command combines the files supplied by the -f option with the standard TUXEDO System/T libraries necessary to form a workstation handler load module. The load module is built by the cc(1) command described in UNIX System reference manuals, which buildwsh invokes. The options to buildwsh have the following meaning:

-v

specifies that buildwsh should work in verbose mode. In particular, it writes the cc command to its standard output.

-o name

specifies the file name of the output workstation handler load module. The name specified here must also be specified with the -w WSHname option of the WSL(5) server in the SERVER section of the configuration file. If not supplied, the load module is named WSH.

-f firstfiles

specifies one or more user files to be included in the compilation and/or link edit phases of buildwsh. Source files are compiled using the either the cc command or the compilation command specified through the CC environment variable. Object files resulting from compilation of source files and object files specified directly as arguments to the -f option are included after all object files necessary to build a base workstation handler process and before the System/T libraries. If more than one file is specified, file names must be separated by white space and the entire list must be enclosed in quotation marks. This option can be specified multiple times.

buildwsh normally uses the cc command to produce the a.out. In order to allow for the specification of an alternate compiler, buildwsh checks for the existence of a shell variable named CC. If CC does not exist in buildwsh 's environment, or if it is the string "", buildwsh will use cc as the compiler. If CC does exist in the environment, its value is taken to be the name of the compiler to be executed. Likewise, the shell variable CFLAGS is taken to contain a set of parameters to be passed to the compiler.

If your application uses shared libraries, it is not necessary to go through this compile and link process. See the description in the "Buffers" chapter of the BEA TUXEDO Administrator's Guide.

PORTABILITY

buildwsh is supported as a TUXEDO System/T-supplied compilation tool on UNIX operating systems only.

EXAMPLES

CC=ncc CFLAGS="-I $TUXDIR/include"; export CC CFLAGS
buildwsh -o APPWSH -f apptypsw.o

SEE ALSO

buildclient(1),
cc(1), ld(1) in UNIX System reference manuals