buildclient(1)


	BEA ホーム \| イベント \| ソリューション \| パートナ \| 製品 \| サービス \| ダウンロード \| ディベロッパ・センタ \| WebSUPPORT
	e-docs \| サイトマップ \| 検索 \| PDF版 \| お問い合わせ \| 用語集

Tuxedo ホーム \| BEA Tuxedo コマンド・リファレンス \| 先頭へ \| 前へ \| 次へ \| 目次

buildclient(1)

名前

buildclient-BEA Tuxedo ATMI クライアント・モジュールを構築

形式

buildclient [ -C ] [ -v ] [ {-r rmname | -w } ] [ -o name] 
[ -f firstfiles] [ -l lastfiles]

機能説明

buildclient は、BEA Tuxedo ATMI クライアント・モジュールを作成するときに使用します。このコマンドでは、-f オプションと -l オプションによって提供されるファイルと標準の BEA Tuxedo ATMI ライブラリを組み合わせて、1 つのロード・モジュールを形成します。このロード・モジュールは、使用しているオペレーティング・システム用に定義されたデフォルトの C 言語コンパイル・コマンドを使用し、buildclient によって作成されます。UNIX システム用のデフォルトの C 言語コンパイル・コマンドは cc (1) コマンドです (UNIX システムのリファレンス・マニュアルを参照してください)。

-v

buildclient を冗長モードで機能させます。特に、cc コマンドをその標準出力に書き出します。

-w

クライアントはワークステーション・ライブラリを使用して作成されます。デフォルトの設定では、ネイティブ・モードおよびワークステーション・モード両方のライブラリがある場合には、ネイティブ・クライアントが作成されます。このオプションは、-r オプションとともには使用できません。

-r rmname

rmname:rmstructure_name:library_names

(詳細はbuildtms(1) を参照してください) rmname の値を使用することにより、$TUXDIR/udataobj/RMにあるエントリは、リソース・マネージャに関連したライブラリを自動的に含み、トランザクション・マネージャとリソース・マネージャ間のインターフェイスを正しく設定するのに使用されます。ほかの値は、リソース・マネージャのテーブルに追加されているものを指定できます。-r オプションが指定されない場合のデフォルト設定では、クライアントはリソース・マネージャに関連しません。UBBCONFIG(5) マニュアルを参照してください。

-o

出力ロード・モジュールのファイル名を指定します。このオプションの指定がない場合は、a.outという名前になります。

-f

buildclient のリンク段階の最初に 1 つ以上のファイルを組み込み、次に BEA Tuxedo ライブラリを組み込みます。複数のファイルを指定する場合は、各ファイル名を空白で区切り、リスト全体を引用符で囲まれなければなりません。このオプションは何回指定してもかまいません。コンパイラ・オプションおよび引数を含む場合は、以下に説明する CFLAGS および ALTCFLAGS 環境変数を使用します。

-l

BEA Tuxedo ライブラリの後、buildclientのリンク段階の最後に 1 つ以上のユーザ・ファイルを組み込むよう指定します。複数のファイルを指定する場合は、各ファイル名を空白で区切り、リスト全体を引用符で囲まれなければなりません。このオプションは何回指定してもかまいません。

-C

COBOL のコンパイルを指定します。

環境変数

TUXDIR

buildclient は、環境変数 TUXDIR を使用して、クライアント・プロセスのコンパイル時に使用する BEA Tuxedo ATMI ライブラリとインクルード・ファイルを検索します。

buildclient は通常、デフォルトの C 言語コンパイル・コマンドを使用してクライアント実行可能コードを生成します。デフォルトの C 言語コンパイル・コマンドは、サポートされている各オペレーティング・システムごとに定義されており、UNIX システムの場合は cc (1) です。代替コンパイラを指定できるようにするため、buildclient は環境変数 CC が存在するかどうかを調べます。CCが buildclient の環境に存在しない場合、あるいは環境変数が文字列 "" である場合、buildclient はデフォルトの C 言語コンパイラを使用します。環境内に CC が存在する場合、 CC の値が実行されるコンパイラの名前となります。

CFLAGS

環境変数 CFLAGS は、コンパイラ・コマンド行の一部として引き渡される一群の引数を指定するときに使用します。この変数は、コマンド行オプション "-I${TUXDIR}/include" とともに buildclient により自動的に引き渡されます。CFLAGS が buildclient の環境に存在しない場合、あるいはこれが文字列 "" である場合には、buildclient はコンパイラ・コマンド行の引数を何も追加しません。

ALTCC

-C オプションを使って COBOL のコンパイルを指定すると、buildclient は通常、BEA Tuxedo のシェル cobcc を使用して cob を呼び出し、クライアント実行可能コードを生成します。buildclient は、別のコンパイラを指定する ALTCC という環境変数の有無をチェックします。ALTCC が buildclient 環境に存在しないか、文字列"" である場合は、buildclient は cobcc を使用します。環境に ALTCC が存在する場合は、その値をとって実行するコンパイラ・コマンドとします。

注記 Windows システムでは、環境変数 ALTCC と ALTCFLAGS は使用できません。これらの変数を設定すると、予想外の結果が生じます。まず COBOL コンパイラを使用してアプリケーションをコンパイルし、次に生成されたオブジェクト・ファイルを buildclient(1) コマンドに渡す必要があります。

ALTCFLAGS

環境変数 ALTCFLAGS には、-C オプションを指定した場合に、COBOL コンパイラ・コマンドの一部として渡す追加の引数を指定します。コマンド行オプションに対する追加です。

"-I${TUXDIR}/include"

このオプションはbuildclient によって自動的に渡されます。-C オプションを使用する場合、コンパイラ・オプションやその引数を buildclient -f オプションで指定するとエラーが発生するため、ALTCFLAGS を使用する必要があります。設定しなかった場合は、上記の CFLAGS と同じ値に設定されます。

注記 ALTCC 環境変数についての下の注記を参照してください。

COBOPT

環境変数 COBOPT には、-C オプションを指定した場合に、COBOL コンパイラが使用する追加の引数を指定します。

COBCPY

環境変数 COBCPY には、-C オプションを指定した場合に、COBOL コンパイラが使用する COBOL コピー・ファイルが存在するディレクトリを指定します。

LD_LIBRARY_PATH (Unix システム)

環境変数 LD_LIBRARY_PATH には、BEA Tuxedo システムの共有オブジェクトに加えて、COBOL コンパイラが使用する共有オブジェクトが存在するディレクトリを指定します。一部の Unix システムでは、別の環境変数が必要となる場合もあります。HP-UX システムでは SHLIB_PATH 環境変数を使用します。AIX システムでは LIBPATH 環境変数を使用します。

LIB (Windows NT システム)

ライブラリを検索するディレクトリのリストを指定します。各ディレクトリはセミコロン (;) で区切ります。

移植性

buildclient コンパイル・ツールは、以下のプラットフォームで使用できます。

BEA Tuxedo ATMI サーバ環境がサポートされているプラットフォーム
32 ビット Windows オペレーティング・システムを実行するワークステーション・プラットフォーム

buildclient コマンド行で指定するファイル名は、お使いのオペレーティング・システムの構文と指定方法に従ってください。

使用例

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"