セクション 1 - コマンド

ドキュメントのダウンロード

サイトマップ

用語集

検索

e-docs > Tuxedo > Tuxedo コマンド・リファレンス > セクション 1 - コマンド

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

-l

buildclient のリンク段階の最後で、BEA Tuxedo ライブラリの後に取り込む 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 は、コンパイラ・コマンド行の一部として引き渡される引数のセットを指定するときに使用します。この変数は、コマンド行オプション &dlq;-I“DIR}/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"