Tuxedo コマンド リファレンス

セクション 1 - コマンド

Oracle Tuxedo コマンドについて

説明

『Tuxedo コマンド リファレンス』では、Oracle Tuxedo ソフトウェアで提供されるシェル レベルのコマンドについてアルファベット順に説明します。

リファレンス ページのコマンド構文

特に指定がない限り、リファレンス ページの形式で説明されているコマンドは、下記の構文に従ってオプションや引数を受け付け、次に説明するように解釈されます。

name [ -option .. . ] [cmdarg . . . ]

noargletter

optarg

cmdarg

-

--

[ ]

{ }

. . .

bldc_dce(1)

名前

bldc_dce - OSF/DCE を介して呼び出すことができる Oracle Tuxedo ATMI クライアントを作成

形式

bldc_dce [-o output_file] [-i idl_options] [-f firstfiles] 
[-l lastfiles] [idl_file . . .]

説明

bldc_dce は、すべての入力 IDL ソース ファイルおよび関連する ACF ソース ファイルを解析し、それらを C のソース ファイルとオブジェクト ファイル、および OSF/DCE ライブラリと組み合わせて、Oracle Tuxedo ATMI クライアントを生成します。この生成された Oracle Tuxedo ATMI クライアントは、DCE RPC (つまり DCE RPC クライアント) を介して呼び出すことができます。

コマンドライン引数には、入力 IDL ソース ファイルと、IDL コンパイラの動作を制御するオプションを指定します。使用できるオプションは次のとおりです。

-o output_file

-i idl_options

-f firstfiles

-l lastfiles

blds_dce(1)

名前

blds_dce - OSF/DCE を呼び出す Oracle Tuxedo ATMI サーバを作成

形式

blds_dce [-o output_file] [-i idl_options] [-f firstfiles] 
[-l lastfiles] [-s service] [idl_file . . .] 

説明

blds_dce は、すべての入力 IDL ソース ファイルおよび関連 ACF ソース ファイルを解析し、それらを C ソース ファイルと C オブジェクト ファイル、および OSF/DCE ライブラリと組み合わせて、DCE RPC 呼び出しを作成できる Oracle Tuxedo ATMI サーバを生成します。このコマンドの主な使用目的は、Oracle Tuxedo システムから OSF/DCE へのゲートウェイ プロセスを作成することです。

コマンドライン引数には、入力 IDL ソース ファイルと、IDL コンパイラの動作を制御するオプションを指定します。使用できるオプションは次のとおりです。

-o output_file

-i idl_options

-f firstfiles

-l lastfiles

-s service[,service . . .]

buildclient(1)

名前

buildclient - Oracle Tuxedo ATMI クライアント モジュールを作成

形式

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

説明

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

-v

-w

-r rmname

-o

-f

-l

-C

-k

環境変数

TUXDIR

CC

CFLAGS

ALTCC

ALTCFLAGS

COBOPT

COBCPY

TM_COB_STATIC

COB

TM_COB_VERSION

TM_COB_CC_FILES

ACUCOBOL

LD_LIBRARY_PATH (UNIX システムの場合)

LIB (Windows NT システム)

移植性

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

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" 

次の例は、ACUCOBOL のコンパイルです。

TUXDIR=/opt/tuxedo10.0
TM_COB_STATIC=no
COB=AcuCobol
COBCPY=$TUXDIR/cobinclude
COBOPT="-Ca -v -w -Ga  -Dw64 -Dl8 -Da8"
TM_COB_VERSION=7.2
ACUCOBOL=/opt/AcuCobol-7.2.1
TM_COB_CC_FILES="-lruncbl -lclnt -lacvt -lfsi -laregex -lacuterm -lextfh -laxml -lexpat -lvision -lesql -lacme -lz -lm"
LD_LIBRARY_PATH=$ACUCOBOL/lib:$TUXDIR/lib
export TUXDIR TM_COB_STATIC COB COBCPY COBOPT TM_COB_VERSION ACUCOBOL TM_COB_CC_FILES LD_LIBRARY_PATH
buildclient -C -o CSIMPCL -f CSIMPCL.cbl

関連項目

buildserver(1)、buildtms(1)、compilation(5)
UNIX システムのリファレンス マニュアルの cc(1)、ld(1)

buildmqadapter(1)

名前

buildmqadapter - TM_MQI、TM_MQO、および TMQUEUE_MQM サーバをリンク

形式

buildmqadapter [-v] [-r rmname]

説明

buildmqadapter は TM_MQI、TM_MQO、および TMQUEUE_MQM サーバを作成し、これらのサーバを $TUXDIR/bin/TM_MQI、$TUXDIR/bin/TM_MQO、および $TUXDIR/bin/TMQUEUE_MQM にインストールします。

buildmqadapter によって作成されるサーバは、Tuxedo MQ Adapter が IBM WebSphere MQ とのやり取りに使用します。詳細については『MQ Adapter』を参照してください。

ユーザは、MQ Adapter サーバ ファイルを作成または上書きするためのパーミッションを持つ必要があります。

buildmqadapter は buildserver コマンドを呼び出してそれぞれの MQ Adapter サーバを作成します。

事前リンクされたオブジェクトを配布する代わりに MQ Adapter サーバ ファイルを buildmqadapter で作成すると、Tuxedo 管理者は以下の内容をコンフィグレーションできます。

buildmqadapter では、MQ リソース マネージャの TMS サーバが作成されないため、Tuxedo 管理者はある時点で buildtms を実行して WebSphere MQ TMS サーバを作成する必要があります。

オプション

v

-r rm_name

buildmqadapter は buildserver コマンドを使用して出力ファイルを生成します。buildserver は、コンパイラおよびコンパイラ フラグに関してそれぞれ CC および CFLAGS 環境変数を使用します (設定されている場合)。詳細については、「buildserver(1)」を参照してください。

例

buildmqadapter -v

関連項目

buildnetclient(1)

名前

buildnetclient — Oracle Tuxedo .NET ワークステーション クライアント モジュールを作成

形式

buildnetclient [-v] [-o outfile] [-csflag flagstring] [.cs source files] [.dll assembly files] [.netmodule module files]

説明

buildnetclient は、Tuxedo .NET ワークステーション クライアント アプリケーションを作成するために使用するユーティリティです。このコマンドでは、引数で指定するソース ファイル (.cs)、アセンブリ ファイル (.dll)、モジュール ファイル (.netmodule) を Tuxedo .NET ワークステーション クライアント ラッパーのライブラリと組み合わせて、クライアント アプリケーションを作成します。この後、Microsoft .NET Framework 環境の C# コンパイラ (csc.exe) を使用して、クライアント アプリケーションをビルドします。

csflag オプションを設定すると、C# コンパイラに渡すオプションを指定できます。

オプション

-v

-o outfile

-csflag flagstring

.cs source files

.dll assembly files

.netmodule module files

注意

buildnetclient は、コマンドラインから渡された引数を解析して、C# コンパイラを呼び出す別のコマンドラインを作成し、実行可能アプリケーションをビルドします。

たとえば、Windows システムでは、[buildnetclient -o t1.exe, t1.cs] は buildnetclient によって csc /out:t1.exe /t:exe /r:%TUXDIR%¥bin¥libwscdnet.dll t1.cs に変換されます。

例

次の例では、2 つの C# ソース ファイル、t1.cs、t2.cs と、モジュール ファイル t3.netmodule を指定して、実行可能アセンブリ first.exe をビルドする場合を示しています。この例では、t1.cs から、これらのファイルと同じディレクトリにあるライブラリ アセンブリ func.dll が提供するメソッドを呼び出しています。

[buildnetclient -o first.exe func.dll t1.cs t3.netmodule t2.cs]

関連項目

『Tuxedo .NET ワークステーション クライアント』の「Tuxedo .NET ワークステーション クライアント アプリケーションの作成」

buildobjclient(1)

名前

buildobjclient - CORBA クライアント アプリケーションを作成

形式

buildobjclient [-v][-o name] [-f firstfile-syntax] 
                [-l lastfile-syntax] -P

説明

buildobjclient コマンドを使用して、CORBA クライアント アプリケーションを構築できます。このコマンドは、-f および -l オプションで指定されるファイルと標準の CORBA ライブラリを組み合わせて、クライアント アプリケーションを形成します。クライアント アプリケーションは、使用しているオペレーティング システム用に定義されたデフォルトの C++ 言語コンパイル コマンドによって作成されます。

指定された .c ファイルおよび .cpp ファイルはすべて、使用しているオペレーティング システムのコンパイル システムを 1 回だけ呼び出してコンパイルされます。ユーザは、CC 環境変数にコンパイラ名を指定することにより、使用するコンパイラを指定できます。CC 環境変数が定義されていない場合に buildobjclient が呼び出されると、.c ファイルと .cpp ファイルをコンパイルするために、オペレーティング システムのデフォルトの C++ 言語コンパイル コマンドが呼び出されます。

ユーザは、環境変数 CFLAGS または CPPFLAGS を設定することにより、コンパイラに渡すオプションを指定できます。CFLAGS が定義されていない場合に buildobjclient が呼び出されると、buildobjclient コマンドは CPPFLAGS の値 (定義されている場合) を使用します。

オプション

-v

-o name

-f firstfile-syntax

-l lastfile-syntax

-P

-h または -?

環境変数

TUXDIR

CC

CFLAGS

CPPFLAGS

LD_LIBRARY_PATH (UNIX システムの場合)

LIB (Windows システムの場合)

移植性

buildobjclient コマンドは、クライアントのみの CORBA システムではサポートされません。

例

次の例では、Windows システム上で CORBA クライアント アプリケーションを作成します。

set CPPFLAGS=-I%APPDIR%¥include
buildobjclient -o empclient.exe -f emp_c.cpp -l userlib1.lib

次の例では、c シェルを使用する UNIX システム上で CORBA クライアント アプリケーションを作成します。

setenv CPPFLAGS=$APPDIR/include
buildobjclient -o empclient -f emp_c.cpp -l userlib1.a

buildobjserver(1)

名前

buildobjserver - CORBA サーバ アプリケーションを構築

形式

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

説明

buildobjserver コマンドを使用して、CORBA サーバ アプリケーションを構築できます。このコマンドは、メイン ルーチンで -f および -l オプションによって指定されるファイルと標準の CORBA ライブラリを組み合わせて、サーバ アプリケーションを形成します。サーバ アプリケーションは、プラットフォームのデフォルトの C++ コンパイラによって作成されます。

指定された .c ファイルおよび .cpp ファイルはすべて、使用しているオペレーティング システムのコンパイル システムを 1 回だけ呼び出してコンパイルされます。ユーザは、CC 環境変数にコンパイラ名を指定することにより、使用するコンパイラを指定できます。CC 環境変数が定義されていない場合に buildobjserver が呼び出されると、.c および .cpp ファイルをコンパイルするために、オペレーティング システムのデフォルトの C++ 言語コンパイル コマンドが呼び出されます。

ユーザは、環境変数 CFLAGS または CPPFLAGS を設定することにより、コンパイラに渡すオプションを指定できます。buildobjserver の呼び出し時に、CFLAGS は定義されていないが、CPPFLAGS が定義されている場合、このコマンドは CPPFLAGS の値を使用します。

オプション

-v

-o name

-f firstfile-syntax

-l lastfile-syntax

-r rmname

-h または -?

-t

環境変数

TUXDIR

CC

CFLAGS

CPPFLAGS

LD_LIBRARY_PATH (UNIX システムの場合)

LIB (Windows NT システム)

移植性

buildobjserver コマンドは、クライアントのみの CORBA システムではサポートされません。

例

次の例では、emp_s.cpp および emp_i.cpp ファイルを使用して、UNIX システム上で CORBA サーバ アプリケーションを作成します。

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

次の例は、buildobjserver コマンドで環境変数 CC および CFLAGS を使用する方法を示しています。また、-f および -lm オプションを使用して、Bourne または Korn シェルで数学ライブラリをリンクする方法も示しています (UNIX システム)。

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

次の例は、リソース マネージャを指定せずに UNIX システム上で buildobjserver コマンドを使用する方法を示しています。

buildobjserver -o PRINTER -f PRINTER.o

RM ファイルの例

以下では、サポートされている各オペレーティング システム プラットフォーム用の RM ファイルの例を示します。

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

buildserver(1)

名前

buildserver - Oracle Tuxedo ATMI のサーバのロード モジュールを構築

形式

buildserver [-C] [-s { @filename | service[,service .. . ]
[:func]| :func } ] [-v] [-o outfile] [-f firstfiles] 
[-l lastfiles] [{-r|-g} rmname] [-k] [-t]

説明

buildserver は、Oracle Tuxedo ATMI のサーバのロード モジュールを構築するときに使用します。このコマンドは、-f および -l オプションで指定されるファイルと標準のサーバのメイン ルーチンおよび標準 Oracle Tuxedo ATMI ライブラリを組み合わせて、ロード モジュールを作成します。このロード モジュールは、buildserver が呼び出す cc(1) コマンドによって作成されます (UNIX システムのリファレンス マニュアルの cc(1) を参照してください)。buildserver のオプションにはそれぞれ、次のような意味があります。

-v

-o outfile

-f firstfiles

-l lastfiles

-r rmname

-s { @filename | service[,service...][:func] | :func } ]

-C

-k

-t

環境変数

TUXDIR

CC

CFLAGS

ALTCC

ALTCFLAGS

COBOPT

COBCPY

TM_COB_STATIC

COB

TM_COB_VERSION

TM_COB_CC_FILES

ACUCOBOL

LD_LIBRARY_PATH (UNIX システムの場合)

LIB (Windows NT システム)

互換性

以前のリリースでは、sql つまり database の genoption を指定するのに -g オプションを使用できました。上位互換性を保持するため、このオプションは -r オプションの同義語になっています。

移植性

buildserver コンパイル ツールは、Oracle Tuxedo ATMI サーバ環境がサポートされるプラットフォームで使用できます。RM XA ライブラリは、Windows プラットフォームではサポートされていません。

注意事項

コンパイル システムによっては、main() へのコードの追加が必要になる場合があります。たとえば、C++ でコンストラクタを初期化したり、COBOL 用のライブラリを初期化するような場合です。サーバの main() のすべての変数宣言の直後で、すべての実行文の前に、アプリケーションのコードをインクルードするための全般的な機構が用意されています。これによって、アプリケーションは変数の宣言と文の実行を 1 ブロックのコードで行うことができます。アプリケーション exit は、#ifdef TMMAINEXIT #include "mainexit.h" #endif のように定義できます。この機能を使用するためには、環境変数 ALTCFLAGS (COBOL の場合) または CFLAGS (C の場合) に "-DTMMAINEXIT" を指定し、カレント ディレクトリに mainexit.h を置く (または -I インクルード オプションを使用して他のディレクトリからインクルードする) 必要があります。

たとえば、Micro Focus Cobol V3.2.x で PRN 番号の最後の数字が 11.03 より大きい場合、共有ライブラリの使用時には、main() のすべての COBOL ルーチンの前で (おそらく関数プロトタイプ宣言の後で) cobinit() を呼び出す必要があります。これを行うには、cobinit() の呼び出しが入った mainexit.h を作成し、上記の手順に従ってください。

ACUCOBOL コンパイラでコンパイルするサーバに関しては、servopts(5) が特別な意味を持ちます。サーバ CLOPT パラメータの uargs ('--' の後に指定する値) は、ACUCOBOL CVM を起動するために、引数として acu_initv() サブルーチンに渡されます。

例

次の例は、リソース マネージャ (-r TUXEDO/SQL) ライブラリを buildserver コマンドラインで指定する方法を示しています。

buildserver -r TUXEDO/SQL -s OPEN_ACCT -s CLOSE_ACCT  -o ACCT 
-f ACCT.o -f appinit.o -f util.o 

次の例は、buildserver に変数 CC および CFLAGS 変数を与える方法、および -f を使用して CC 行への -lm オプションを指定して数学ライブラリをリンクする方法を示したものです。

CFLAGS=-g CC=/bin/cc  buildserver -r TUXEDO/SQL -s DEPOSIT 
-s WITHDRAWAL -s INQUIRY  -o TLR -f TLR.o -f util.o -f -lm 

次の例は、リソース マネージャを指定せずに buildserver コマンドを使用する方法です。

buildserver -s PRINTER -o PRINTER -f PRINTER.o

次の例は、COBOL のコンパイルです。

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
export COBOPT COBCPY COBDIR LD_LIBRARY_PATH
buildserver -C -r TUXEDO/SQL -s OPEN_ACCT -s CLOSE_ACCT  -o ACCT -f ACCT.o -f appinit.o -f util.o

次の例は、ACUCOBOL のコンパイルです。

TUXDIR=/opt/tuxedo10.0
TM_COB_STATIC=no
COB=AcuCobol
COBCPY=$TUXDIR/cobinclude
COBOPT="-Ca -v -w -Ga  -Dw64 -Dl8 -Da8"
TM_COB_VERSION=7.2
ACUCOBOL=/opt/AcuCobol-7.2.1
TM_COB_CC_FILES="-lruncbl -lclnt -lacvt -lfsi -laregex -lacuterm -lextfh -laxml -lexpat -lvision -lesql -lacme -lz -lm"
LD_LIBRARY_PATH=$ACUCOBOL/lib:$TUXDIR/lib
export TUXDIR TM_COB_STATIC COB COBCPY COBOPT TM_COB_VERSION ACUCOBOL TM_COB_CC_FILES LD_LIBRARY_PATH
buildserver -C -sTOUPPER -sTOLOWER -o CSIMPSRV -f CTOUPPER.cbl -f CLOWER.cbl -f TPSVRINIT.cbl

関連項目

buildtms(1)、servopts(5)、UBBCONFIG(5)

お使いのオペレーティング システムのリファレンス マニュアルで説明する C コンパイラとリンカに関する記述

buildTM_MQI(1)、buildTM_MQO(1)、buildTMQUEUE_MQM(1)

名前

buildTM_MQI(1) - TM_MQI サーバをリンク

buildTM_MQO(1) - TM_MQO サーバをリンク

buildTMQUEUE_MQM(1) - TMQUEUE_MQM サーバをリンク

形式

buildTM_MQI [-v] [-r rmname] [-o outfile]

buildTM_MQO [-v] [-r rmname] [-o outfile]

buildTMQUEUE_MQM [-v] [-r rmname] [-o outfile]

説明

これらのコマンドはそれぞれ TM_MQI、TM_MQO、または TMQUEUE_MQM サーバを作成します。デフォルトの出力場所は $TUXDIR/bin/TM_MQI、$TUXDIR/bin/TM_MQO、または $TUXDIR/bin/TMQUEUE_MQM です。この場所は -o オプションで変更できます。

これらのコマンドで作成されるサーバは、Tuxedo MQ Adapter が IBM WebSphere MQ とのやり取りに使用します。詳細については『MQ Adapter』を参照してください。

ユーザは、サーバ出力ファイルを作成または上書きするためのパーミッションを持つ必要があります。

これらのコマンドは buildserver を呼び出して適切な MQ Adapter サーバを作成します。

事前リンクされたオブジェクトを配布する代わりにこれらのコマンドを使用して MQ Adapter サーバ ファイルを作成すると、Tuxedo 管理者は以下の内容をコンフィグレーションできます。

システム管理者は MQ Adapter サーバの作成に加え、ある時点で buildtms を実行し、WebSphere MQ TMS サーバを作成する必要があります。

オプション

-v

-r rm_name

-o outfile

例

buildTM_MQI -v -o $TUXDIR/bin/TM_MQI

buildTM_MQO -v -o $TUXDIR/bin/TM_MQO

buildTMQUEUE_MQM -v -o $TUXDIR/bin/TMQUEUE_MQM

関連項目

buildtms(1)

名前

buildtms - トランザクション マネージャ サーバのロード モジュールを構築

形式

buildtms [ -v ] -o name -r rm_name

説明

buildtms はトランザクション マネージャのロード モジュールを構築するときに使用します。

Oracle Tuxedo システムではいくつかの TM サーバが一緒に提供されますが、分散トランザクション処理用に Oracle Tuxedo システムとともに使用する新しいリソース マネージャを提供することもできます。このようなリソース マネージャは、X/Open の XA インタフェースに準拠していなければなりません。リソース マネージャ ベンダは、次の 4 つの項目を提供しなければなりません。1) リソース マネージャの名前、リソース マネージャの機能を示すフラグ、および実際の XA の関数ポインタを収める xa_switch_t 型の構造体の名前、2) xa_switch_t 構造体の name 要素に格納されるリソース マネージャの名前、3) XA インタフェースのサービスを提供しソフトウェアをサポートするオブジェクト ファイルの名前、そして 4) UBBCONFIG コンフィグレーション ファイルのパラメータ OPENINFO および CLOSEINFO に提供される情報文字列の形式、の 4 項目です。「UBBCONFIG(5)」を参照してください。

新しいリソース マネージャを Oracle Tuxedo システムに統合化する際には、ファイル $TUXDIR/udataobj/RM を更新して、そのリソース マネージャに関する情報を組み込むようにしなければなりません。このファイルの形式は次のとおりです。

rm_name:rm_structure_name:library_names 

ここで、rm_name はリソース マネージャの名前、rm_structure_name は xa_switch_t 構造体の名前、および library_names はリソース マネージャのオブジェクト ファイルのリストです。空白類 (タブまたはスペース) は各値の前後で使用でき、library_names の中に挿入することもできます。値の中にコロン (:) を含めることはできません。また、シャープ (#) で始まる行はコメントとして扱われ、無視されます。

新しいリソース マネージャのトランザクション マネージャ サーバは buildtms を使用して構築し、$TUXDIR/bin にインストールしなければなりません。buildtms は buildserver(1) コマンドを使用して a.out を生成します。buildtms コマンドには、以下のオプションがあります。

-v

-o name

-r rm_name

buildtms は、buildserver コマンドを使用して a.out を生成します。buildserver は、コンパイラおよびコンパイラ フラグに関してそれぞれ CC および CFLAGS 環境変数を使用します (設定されている場合)。詳細については、「buildserver(1)」を参照してください。

移植性

buildtms は、Oracle Tuxedo ATMI または CORBA サーバ環境をサポートするすべてのプラットフォームで、Oracle Tuxedo システム提供のコンパイル ツールとしてサポートされています。RM XA ライブラリは、Windows プラットフォームではサポートされていません。

例

buildtms -o $TUXDIR/bin/TMS_XYZ -r XYZ/SQL # XYZ リソース マネージャの TMS

関連項目

buildserver(1)、UBBCONFIG(5)

buildwsh(1)

名前

buildwsh - カスタマイズされたワークステーション ハンドラ プロセスの構築

形式

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

説明

buildwsh は、カスタマイズされた Oracle Tuxedo ATMI ワークステーション ハンドラ モジュールを作成するために使用されます。そのファイルには、アプリケーション バッファ タイプ スイッチと必要なサポート ルーチンだけを含むようにします。このコマンドは、-f オプションで指定されるファイルと、ワークステーション ハンドラ ロード モジュールを形成するために必要な標準の Oracle Tuxedo ATMI ライブラリを組み合わせます。このロード モジュールは UNIX システムのリファレンス マニュアルの cc(1) コマンドによって構築されます。この cc コマンドは、buildwsh によって実行されます。このコマンドのオプションは、次のとおりです。

-v

-o name

-f firstfiles

buildwsh は通常、cc コマンドを使用して a.out を生成します。代替コンパイラを指定できるようにするために、buildwsh はシェル変数 CC が存在するかどうかを調べます。CC が buildwsh の環境に存在しない場合、またはこの変数が文字列 "" である場合、buildwsh は cc をコンパイラとして使用します。環境内に CC が存在する場合、実行されるコンパイラの名前が CC の値となります。同様に、シェル変数 CFLAGS も、コンパイラへ渡す一連のパラメータを取り込むためにチェックされます。

アプリケーションが共有ライブラリを使用する場合は、ここで説明したコンパイルとリンクの作業をする必要はありません。詳細については、『C 言語を使用した Oracle Tuxedo アプリケーションのプログラミング』の「型付きバッファの管理」を参照してください。

移植性

buildwsh コンパイル ツールは、Oracle Tuxedo ATMI サーバ環境がサポートされるプラットフォームで使用できます。

例

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

関連項目

buildclient(1)、WSL(5)

UNIX システムのリファレンス マニュアルの cc(1)、ld(1)

cobcc(1)

名前

cobcc - COBOL コンパイル インタフェース

形式

cobcc [option .. . ] filename . . .

説明

cobcc は、COBOL コンパイラに対するインタフェース シェルとして使用します。cobcc は、-C (COBOL) オプションを指定して buildclient(1) または buildserver(1) が実行された場合にはデフォルトで呼び出されます。ALTCC 環境変数を指定するとオーバーライドできます。

以下に cobcc で指定可能なオプションを示します。これらのオプションを使用するには、buildclient や buildserver を実行する際に、環境変数 ALTCFLAGS を cobcc が認識できるオプション文字列に設定します。各オプションの詳細については、COBOL と C コンパイラのドキュメントを参照してください。

cc や cob とは異なり cobcc では、すべてのオプションはファイル名の前に置かれなければなりません。

-c

-p -g -r -O

-l argument

-L argument

-o output_file

-E -P -S

-A -C -H -f -G

-w

-D argument

{-T -Y -U -I -B -X -F -q} argument

-V -v

-a -s

-u argument

-W argument

オプションと引数、およびファイル名は該当するオプションと共に COBOL コンパイラに渡され、適切な情報が COBOL コンパイラ、C コンパイラ、あるいはローダで処理されます。COBOL コンパイラの名前は "cob" と想定されており、PATH で定義されています。

関連項目

buildclient(1)、buildserver(1)

UNIX システムのリファレンス マニュアルの cc(1)

『Micro Focus COBOL/2 Operating Guide』 Micro Focus Ltd.

dmadmin(1)

名前

dmadmin - Oracle Tuxedo Domains 管理プログラムのコマンド インタプリタ

形式

dmadmin [ -c ]

説明

dmadmin は対話型のコマンド インタプリタで、Domains コンフィグレーションで呼び出される特定の Oracle Tuxedo アプリケーション用に定義されたドメイン ゲートウェイ グループを管理するために使用します。ここでは、Oracle Tuxedo Domains コンポーネントの TDomain ゲートウェイ、SNA Gateway (SNAX)、および OSI TP ゲートウェイで dmadmin を使用する方法について説明します。Oracle Tuxedo Domains コンポーネントについては、『Oracle Tuxedo Domains コンポーネント』を参照してください。

dmadmin には、管理モードとコンフィグレーション モードの 2 つのモードがあります。

dmadmin をパラメータなしで呼び出すと管理モードになります。デフォルトのモードは管理モードです。このモードでは、dmadmin をアクティブなアプリケーション内のアクティブなノード (ワークステーションを除く) 上で実行できます。アプリケーション管理者は、このモードを使用して、アクティブなドメイン ゲートウェイ グループのパラメータを取得または変更できます。また、アプリケーション管理者は、このモードを使用して、特定のローカル ドメイン アクセス ポイント用の Domains トランザクション ログを作成、破棄、または再初期化できます。このケースでは、そのローカル ドメイン アクセス ポイントに関連付けられたドメイン ゲートウェイ グループをアクティブにしてはなりません。また、dmadmin は対応するゲートウェイ グループに割り当てられたマシン上で実行する必要があります。

dmadmin は、-c オプション付きで呼び出されるか、config サブコマンドが呼び出されたときにコンフィグレーション モードになります。アプリケーション管理者は、このモードを使用して Domains コンフィグレーション ファイル (BDMCONFIG) のバイナリ バージョンのコンフィグレーション情報を更新したり、新しいコンフィグレーション情報を追加できます。

dmadmin では、BDMCONFIG ファイルの管理に Domains 管理サーバ (DMADM) を、アクティブな DOMAIN ゲートウェイ グループの再コンフィグレーションにゲートウェイ管理サーバ (GWADM) を使用する必要があります。Domains コンフィグレーションで起動される各 Oracle Tuxedo アプリケーションに 1 つの DMADM プロセスが、各ドメイン ゲートウェイ グループに 1 つの GWADM プロセスが実行されます。

管理モード コマンド

dmadmin が起動すると、プロンプト (「>」) に次の形式でコマンドを入力できます。

command [arguments] 

共通して出現するいくつかの引数には、default コマンドを使用してデフォルト値が与えられます。default コマンドによって設定されたパラメータを受け付けるコマンドは、default に値が設定されているかどうかを調べます。値が設定されていない場合は、エラー メッセージが返されます。

一度設定したデフォルト値は、default コマンドで変更しない限り、セッション終了まで有効です。このデフォルト値は、コマンドラインで明示的に値を入力してオーバーライドするか、値 * (アスタリスク) を入力して設定解除します。オーバーライドの効果は、コマンドの単一のインスタンスの間有効です。

dmadmin コマンドからの出力は、使用しているページ別表示コマンドに従ってページ別に表示されます (後述の paginate サブコマンドを参照してください)。

コマンドの入力形式には、完全な名前でも省略形でも使用でき、該当する引数はコマンドの後に付きます。この後の一覧では、完全な名前の後の丸括弧内に省略形を示しています。角括弧 [ ] で囲まれた引数は省略可能です。中括弧 { } で囲まれた引数は相互に排他的な選択肢を示します。多くの場合、local_domain_access_point_name は必須の引数であり、これは default コマンドを使用して設定することができます。

以下のコマンドは、管理モードで使用できます。

advertise (adv) -d local_domain_access_point_name [{service}]

audit (audit) -d local_domain_access_point_name [{off | on}]

chbktime (chbt) -d local_domain_access_point_name -t bktime

config (config)

connect (co) -d local_domain_access_point_name
   [-R remote_domain_access_point_name]

crdmlog (crdlog)[-d local_domain_access_point_name]

default (d) [-d local_domain_access_point_name]

disconnect (dco) -d local_domain_access_point_name
   [-R remote_domain_access_point_name]

dsdmlog (dsdlg) -d local_domain_access_point_name [ -y ]

echo (e) [{off | on}]

forgettrans (ft) -d local_domain_access_point_name [ -t tran_id]

help (h) [command]

indmlog (indlg) -d local_domain_access_point_name [ -y ]

paginate (page) [{off | on}]

passwd (passwd) [ -r ] local_domain_access_point_name
remote_domain_access_point_name

printdomain (pd) -d local_domain_access_point_name

printstats (pstats) -d local_domain_access_point_name

printtrans (pt) -d local_domain_access_point_name

quit (q)

resume (res) -d local_domain_access_point_name [{ -all | service}]

stats (stats) -d local_domain_access_point_name [{ off | on | reset }]

suspend (susp) -d local_domain_access_point_name [{ -all | service}]

topendpasswd (tepasswd) [ -r ]

unadvertise (unadv) -d local_domain_access_point_name [{ -all |
service}]

verbose (v) [{off | on}]

! shellcommand

!!

# [text]

<CR>

コンフィグレーション モードのコマンド

dmadmin コマンドは、-c オプション付きで実行するか、config サブコマンドを使用したときにコンフィグレーション モードになります。このモードで dmadmin を使用すると、BDMCONFIG ファイルの実行時の更新が可能になります。dmadmin は、追加あるいは取り出す入力フィールド値を含むバッファを管理し、各操作が完了した後で出力フィールド値およびステータスを表示します。ユーザは、利用可能なテキスト エディタを使用して入力バッファを更新できます。

dmadmin はまず希望のセクションを求めるプロンプトを表示し、次に希望の操作を求めるプロンプトを表示します。

BDMCONFIG ファイルのセクションを求めるプロンプトは次のとおりです。

Section:
         1) RESOURCES         2) LOCAL_DOMAINS
         3) REMOTE_DOMAINS    4) LOCAL_SERVICES
         5) REMOTE_SERVICES   6) ROUTING
         7) ACCESS_CONTROL    8) PASSWORDS
         9) TDOMAINS         10) OSITPS
        11) SNADOMS          12) LOCAL_REMOTE_USER
        13) REMOTE_USERS     14) SNACRMS
        15) SNASTACKS        16) SNALINKS
	19) OSITPX
	  q) 終了
セクションを入力してください [1]:

デフォルト セクションの番号は、プロンプトの終わりに角括弧内に表示されます。デフォルトの値を受け入れるときは、〔RETURN〕または〔Enter〕を押します。別のセクションを選択するときは、その番号を入力して〔RETURN〕または〔Enter〕を押します。

次に dmadmin は、希望の操作を求めるプロンプトを表示します。

操作:
        1) 最初        2) 継続
        3) 照会        4) 追加
        5) 更新        6) 削除
        7) 新セクション 8) 終了
操作を入力してください [1]:

デフォルトの操作番号がプロンプトの終わりの角括弧内に表示されます。〔RETURN〕または〔Enter〕を押してこのオプションを選択します。別の操作を選択するときは、その番号を入力して〔RETURN〕または〔Enter〕を押します。

現在サポートされている操作は次のとおりです。

コンフィグレーション操作を行う場合は、有効なユーザ識別子は、このプログラムが実行されるマシンの Oracle Tuxedo 管理者ユーザ識別子 (UID) と一致している必要があります。レコードの更新や追加を行う場合には、dmloadcf(1) が使用する妥当性検査機能とすべてのデフォルト値が有効になります。

dmadmin は次に、入力バッファを編集するかどうかをたずねるプロンプトを表示します。

フィールドを追加/修正するために、エディタを使用しますか ? [n]

ここで、y を入力すると、入力バッファは一時ファイルにコピーされ、テキスト エディタが起動されます。どのエディタを使用するかは、環境変数 EDITOR で指定できます。デフォルトでは UNIX のテキスト エディタの ed が使用されます。入力形式は、フィールド名とフィールド値のペアで、「コンフィグレーション入力フォーマット」で記述しています。各 DMCONFIG セクションに関連するフィールド名は、以下のサブセクションの表にリストします。フィールドのセマンティクスと関連範囲、デフォルト値、制約事項などについては、「DMCONFIG(5)」および「DM_MIB(5)」を参照してください。ほとんどのケースでは、フィールド名は DMCONFIG ファイル内の KEYWORD と同じです (接頭辞として "TA_" が付いています)。ユーザが入力バッファの編集を終えると、dmadmin がそれを読み込みます。ある特定のフィールド名が複数行に現れる場合、最初のものだけが使用され、残りは無視されます。エラーが発生した場合は、構文エラーが表示され、問題を訂正するかどうかをたずねるプロンプトが表示されます。

修正のためにエディタを実行しますか?

問題を訂正しない場合 (応答 n) は、入力バッファにフィールドは含まれません。問題を訂正する場合は、エディタが再度実行されます。

最後に、操作を行うかどうかをたずねるプロンプトが表示されます。

実行しますか ? [y]

操作が完了すると、dmadmin は戻り値を「戻り値 TAOK」内に表示し、その後に出力バッファ フィールドが続きます。次に、プロセスが再開され、セクションを求めるプロンプトが表示されます。すべての出力バッファ フィールドは、バッファがクリアされない限り、入力バッファ内で利用できます。

いつでもブレークを入力して、セクションを求めるプロンプトでの対話を再開できます。

"QUIT" を選択すると、テキスト バージョンのコンフィグレーション ファイルのバックアップを作成する認可を求めるプロンプトが表示されます。

BDMCONFIG ファイルを ASCII ファイルにバックアップしますか [y]?

バックアップを選択した場合、ファイル名の入力を求めるプロンプトが表示されます。

バックアップ・ファイル名 [DMCONFIG]?

成功時にはバックアップが作成されたことが示され、失敗時にはエラーが表示されます。

コンフィグレーション入力フォーマット

入力パケットは、次のようにフォーマットされた行で構成されます。

fldname fldval

フィールド名は、1 つまたは複数のタブ (または空白) によってフィールド値と区別されます。

長いフィールド値は、1 つまたは複数のタブ (dmadmin に再度読み込まれたときに破棄されます) で始まる継続行を使用することで、次の行に継続できます。

改行文字だけで構成される空の行は無視されます。

表示できない文字をフィールド値に入力したり、タブからフィールド値を開始するには、円マークを使用し、その後に希望する文字を 2 文字の 16 進数表現で使用します (UNIX システムのリファレンス マニュアルの ASCII(5) を参照してください)。たとえば、スペースは ¥20 と入力データに入力できます。円マークは 2 回書くことで 1 つの円マークを入力できます。dmadmin は、このフォーマットの入力をすべて認識しますが、最も役に立つのは表示できない文字の場合です。

コンフィグレーションの制限事項

次に動的 Domains を再コンフィグレーションする機能についての全般的な制限事項を示します。

Domains 関連の新しい用語

Oracle Tuxedo のリリース 7.1 以降では、Domains 用の MIB で、ローカル ドメインとリモート ドメインとの相互作用を記述するため、クラスと属性の用語が改善されています。新しい用語は、DM_MIB のリファレンス ページ、クラス、エラー メッセージ、および DMCONFIG のリファレンス ページ、セクション名、パラメータ名、およびエラー メッセージで使用されています。新しい用語は dmadmin のユーザ インタフェースには適用されていませんが、dmadmin は DMCONFIG の従来の用語と新しい用語の両方を認識します。

旧バージョンとの互換性のため、Oracle Tuxedo 7.1 より前に使用された DMCONFIG 用語と、新しい Domains 用の MIB 用語との間にエリアスが提供されています。Oracle Tuxedo リリース 7.1 以降の dmadmin では、両方のバージョンの DMCONFIG 用語を使用できます。詳細については、DM_MIB(5) リファレンス ページの「Domains 関連の新しい用語」を参照してください。

コンフィグレーション フィールド識別子/更新に関する制限事項

次のセクションは、各 DMCONFIG について、どのフィールド識別子が各 DMCONFIG フィールドに関連しているか、識別子のフィールド タイプは何か、およびいつフィールドを更新できるかを説明しています。適用可能なフィールド値はすべて、取り出し操作によって返されます。レコードを追加できるフィールド、またはレコードを追加するために必要なフィールドについては、「DMCONFIG(5)」および「DM_MIB(5)」で説明します。以下にキーとして示すフィールドは、セクション内のレコードをユニークに識別するために使用するキー フィールドです。これらのキー フィールドは、更新を行うとき入力バッファ内になければなりません。また、これらのキー フィールドを動的に更新することはできません。「更新」列は、どのようなときにフィールドを更新できるかを示しています。可能な値は次のとおりです。

DM_LOCAL セクションのコンフィグレーション

次の表に、DM_LOCAL セクション (DM_LOCAL_DOMAINS セクション) のフィールド一覧を示します。dmadmin 操作のプロンプトでこのセクションにアクセスするには、2 (LOCAL_DOMAINS) を入力します。

DM_REMOTE セクションのコンフィグレーション

次の表に、DM_REMOTE セクション (DM_REMOTE_DOMAINS セクション) のフィールドの一覧を示します。dmadmin 操作のプロンプトでこのセクションにアクセスするには、3 (REMOTE_DOMAINS) を入力します。

DM_TDOMAIN セクションのコンフィグレーション

DM_TDOMAIN セクションには、TDOMAIN タイプ ドメインが必要とするネットワーク アドレッシング パラメータが含まれています。次の表に、このセクションのフィールドの一覧を示します。

ローカル ドメイン アクセス ポイント識別子 (TA_LDOM) の場合、TA_NWADDR フィールドおよび TA_NWDEVICE フィールドは、そのローカル ドメイン アクセス ポイントに関連付けられたゲートウェイ グループが実行中でないときに更新できます。

DM_OSITP セクションのコンフィグレーション

DM_OSITP セクションには、OSITP タイプ ドメインが必要とする OSI TP 1.3 対応のネットワーク アドレッシング パラメータが含まれています。次の表に、このセクションのフィールドの一覧を示します。

ローカル ドメイン アクセス ポイント識別子 (TA_LDOM) の場合、この表に記載されていないフィールドは、そのローカル ドメイン アクセス ポイントに関連付けられたゲートウェイ グループが実行中でないときに更新できます。

DM_OSITPX セクションのコンフィグレーション

DM_OSITPX セクションには、OSITPX タイプ ドメインが必要とする OSI TP 4.0 以降対応のネットワーク アドレッシング パラメータが含まれています。次の表に、このセクションのフィールドの一覧を示します。

ローカル ドメイン アクセス ポイント識別子 (TA_LDOM) の場合、この表に記載されていないフィールドは、そのローカル ドメイン アクセス ポイントに関連付けられたゲートウェイ グループが実行中でないときに更新できます。

DM_EXPORT セクションのコンフィグレーション

次の表に、DM_EXPORT (DM_LOCAL_SERVICES) セクションのフィールドの一覧を示します。dmadmin 操作のプロンプトでこのセクションにアクセスするには、4 (LOCAL_SERVICES) を入力します。

DM_IMPORT セクションのコンフィグレーション

次の表に、DM_IMPORT セクション (DM_REMOTE_SERVICES セクション) のフィールドの一覧を示します。dmadmin 操作のプロンプトでこのセクションにアクセスするには、5 (REMOTE_SERVICES) を入力します。

DM_ROUTING セクションのコンフィグレーション

次の表に、DM_ROUTING セクションのフィールドの一覧を示します。

DM_ACCESS_CONTROL セクションのコンフィグレーション

次の表に、DM_ACCESS_CONTROL セクションのフィールドの一覧を示します。

DM_PASSWORDS セクションのコンフィグレーション

次の表に、DM_PASSWORDS セクションのフィールドの一覧を示します。このセクションは、TDomain ゲートウェイにのみ適用されます。

TA_LPWD および TA_RPWD は、ローカル ドメイン アクセス ポイントまたはリモート ドメイン アクセス ポイント (あるいはその両方) について定義済みのパスワードがあるかどうかを示します。パスワードは表示されません。UPDATE 操作を選択した場合は、対応するフィールドの値を U に設定する必要があります。この場合、エコーがオフになり、対応するパスワードの入力を求めるプロンプトが表示されます。

コンフィグレーション モードでの診断

dmadmin は、FML 型付きバッファを割り当てできない場合、ユーザの /etc/passwd エントリを判別できない場合、または環境変数 FIELDTBLS または FLDTBLDIR を再設定できない場合に失敗します。

各操作の完了後、dmadmin によって表示される戻り値は、要求された操作のステータスを示します。戻り値には 3 つのクラスがあります。

次の戻り値は、パーミッションに関する問題または Oracle Tuxedo の通信エラーを示しています。戻り値は、操作が正常に完了しなかったことを示しています。

[TAEPERM]

[TAESYSTEM]

[TAEOS]

[TAETIME]

次の戻り値は、操作を行うこと自体の問題を示します。一般的には、入力バッファ内のアプリケーション データに関するセマンティクスの問題です。文字列フィールド TA_STATUS は出力バッファ内で設定され、問題を記述する短いテキストを含んでいます。文字列フィールド TA_BADFLDNAME は問題 (エラーは 1 つのフィールドが原因で発生すると想定しています) の原因となる値を含むフィールドのフィールド名に設定されます。

[TAECONFIG]

[TAEDUPLICATE]

[TAEINCONSIS]

[TAENOTFOUND]

[TAENOSPACE]

[TAERANGE]

[TAEREQUIRED]

[TAESIZE]

[TAEUPDATE]

次の戻り値は、操作が成功したことを示します。

[TAOK]

[TAUPDATED]

dmunloadcf を使用してコンフィグレーションのエントリを表示するとき、オプションのフィールド値は、値が設定されていない (文字列の場合) か 0 (整数の場合) の場合には表示されません。これらのフィールドは、dmadmin を使用するときに、出力バッファ内に常に表示されます。この方法で、管理者がエントリを取り出しやすくし、また以前に設定されていないフィールドを更新しやすくします。エントリには、フィールド名が含まれ、タブが後に続きますが、フィールド値はありません。

コンフィグレーションの例

次の例では、dmadmin を使用して新しいリモート ドメイン アクセス ポイントを追加します。ed(1) がエディタとして使用されます。

$ EDITOR=ed dmadmin
> config
セクション:
         1) RESOURCES         2) LOCAL_DOMAINS
         3) REMOTE_DOMAINS    4) LOCAL_SERVICES
         5) REMOTE_SERVICES   6) ROUTING
         7) ACCESS_CONTROL    8) PASSWORDS
         9) TDOMAINS         10) OSITPS
        11) SNADOMS          12) LOCAL_REMOTE_USER
        13) REMOTE_USERS     14) SNACRMS
        15) SNASTACKS        16) SNALINKS
	19) OSITPX
         q) QUIT
セクションを入力してください [1]:
セクションを入力してください [1]: 2
操作:
         1) 最初        2) 継続
         3) 照会        4) 追加
         5) 更新        6) 削除
         7) 新セクション 8) 終了
操作を入力してください [1]: 4
フィールドを追加/修正するために、エディタを使用しますか? [n]: y
a
TA_RDOM         B05
TA_DOMAINID     BA.BANK05
TA_TYPE         TDOMAIN
.
w
53
q
実行しますか [y]?<return>
戻り値 TAUPDATED
バッファの値:
TA_OPERATION    4
TA_SECTION      2
TA_DOMAINID     BA.BANK05
TA_RDOM B05
TA_TYPE TDOMAIN
TA_STATUS       更新は正常終了しました。
操作:
         1) 最初        2) 継続
         3) 照会        4) 追加
         5) 更新        6) 削除
         7) 新セクション 8) 終了
操作を入力してください [4]: 7
セクション:
         1) RESOURCES         2) LOCAL_DOMAINS
         3) REMOTE_DOMAINS    4) LOCAL_SERVICES
         5) REMOTE_SERVICES   6) ROUTING
         7) ACCESS_CONTROL    8) PASSWORDS
         9) TDOMAINS         10) OSITPS
        11) SNADOMS          12) LOCAL_REMOTE_USER
        13) REMOTE_USERS     14) SNACRMS
        15) SNASTACKS        16) SNALINKS
	19) OSITPX
         q) 終了
セクションを入力してください [1]:9
操作:
         1) 最初        2) 継続
         3) 照会        4) 追加
         5) 更新        6) 削除
         7) 新セクション 8) 終了
操作を入力してください [6]:4
フィールドを追加/修正するために、エディタを使用しますか ? [n]: y
a
TA_RDOM         B05
TA_NWADDR       0x00020401c0066d05
TA_NWDEVICE     /dev/tcp
.
w
55
q
実行しますか [y]?<return>
戻り値 TAUPDATED
バッファの値:
TA_OPERATION    4
TA_SECTION      8
TA_RDOM         B05
TA_NWADDR       0x00020401c0066d05
TA_NWDEVICE     /dev/tcp
TA_STATUS       更新は正常終了しました。
操作:
         1) 最初        2) 継続
         3) 照会        4) 追加
         5) 更新        6) 削除
         7) 新セクション 8) 終了
操作を入力してください [4]: 8
> quit

dmadmin プログラムが終了します。

セキュリティ

dmadmin がアプリケーション管理者の UID を使用して実行された場合、信頼性のあるユーザであると想定され、セキュリティはバイパスされます。dmadmin が別のユーザ ID で実行された場合、およびセキュリティ オプションが TUXCONFIG ファイル内で使用可能になっている場合は、dmadmin プログラムを開始するための対応するアプリケーション パスワードが必要です。標準入力が端末である場合、dmadmin はエコーをオフの状態でユーザにパスワードの入力を求めます。標準入力が端末でない場合は、パスワードは環境変数 APP_PW から取り出されます。この環境変数が指定されていないときに、アプリケーション パスワードが必要な場合は、dmadmin を開始できません。

別のユーザ ID (管理者の UID 以外) で実行中の場合、制限されたセットのコマンドしか使用できません。

環境変数

dmadmin は環境変数 FIELDTBLS および FLDTBLDIR を再設定して、${TUXDIR}/udataobj/dmadmin フィールド テーブルをピックアップします。このため、TUXDIR 環境変数は適切に設定する必要があります。

アプリケーションでセキュリティが必要なときに、dmadmin への標準入力が端末からではない場合、APP_PW 環境変数は対応するアプリケーション パスワードに設定する必要があります。

TUXCONFIG 環境変数は、Oracle Tuxedo コンフィグレーション ファイルのパス名に設定する必要があります。

全般的な診断

dmadmin コマンドをシステムがブートする前に入力すると、次のメッセージが表示されます。

掲示板がありません。ロギング・コマンドのみ使用できます。

すると、dmadmin は対応するコマンドの入力を求めます。

正しくないアプリケーション パスワードが入力されるか、環境を通してシェル スクリプトで利用できない場合、ログ メッセージが生成され、次のメッセージが表示されてコマンドが終了します。無効なパスワードが入力されました。

相互運用性

dmadmin は、Oracle Tuxedo リリース 5.0 以降にインストールする必要があります。リリース 5.0 ゲートウェイが存在する同じドメイン内の他のノードは、Oracle Tuxedo リリース 4.1 またはそれ以降でもかまいません。

移植性

dmadmin 管理ツールは、Oracle Tuxedo サーバ環境がサポートされるプラットフォームで使用できます。

関連項目

dmloadcf(1)、tmadmin(1)、DMADM(5)、DMCONFIG(5)

『Oracle Tuxedo Domains コンポーネント』

『ATMI アプリケーションでの Oracle Tuxedo TOP END Domain Gateway の使用』

dmloadcf(1)

名前

dmloadcf - DMCONFIG ファイルを解析し、バイナリの BDMCONFIG コンフィグレーション ファイルをロード

形式

dmloadcf [-c] [-n] [-y] [-b blocks] {DMCONFIG_file | - }

説明

dmloadcf は、ファイルまたは DMCONFIG 構文による標準入力を読み取り、構文をチェックして、オプションでバイナリの BDMCONFIG コンフィグレーション ファイルをロードします。BDMCONFIG 環境変数は、情報の格納先となる BDMCONFIG ファイルのパス名を指しています。

dmloadcf は、DMCONFIG ファイルの必要なセクションがないことを検出すると、エラー メッセージをプリントします。入力ファイルを構文解析しているときに構文エラーを検出すると、dmloadcf は BDMCONFIG ファイルを更新せずに終了します。

dmloadcf を使用する場合は、$TUXDIR/udataobj/DMTYPE ファイルが存在していなければなりません。このファイルは有効なドメイン タイプを定義します。このファイルが存在しないと、dmloadcf は BDMCONFIG ファイルを更新せずに終了します。

dmloadcf を使用するユーザの実効ユーザ識別子は、TUXCONFIG ファイルの RESOURCES セクションの UID と一致していなければなりません。

dmloadcf に -c オプションを付けると、プログラムはこのコンフィグレーションの各ローカル ドメイン (ゲートウェイ グループ) に必要な最小の IPC リソースをプリントします。BDMCONFIG ファイルは更新されません。

dmloadcf に -n オプションを付けると、プログラムはテキスト形式の DMCONFIG ファイルの構文チェックだけを行い、BDMCONFIG ファイルの更新は行いません。

構文チェックの後、dmloadcf は、環境変数 BDMCONFIG が参照するファイルが存在するかどうか、存在する場合はそのファイルが有効な Oracle Tuxedo ファイルであるかどうか、および BDMCONFIG テーブルを含んでいるかどうかを調べます。これらの条件が真でなかった場合、そのユーザにはファイルを作成して初期化するよう、次のような指示が出されます。

BDMCONFIG ファイルを初期化しますか:path [y, q]?

path は、BDMCONFIG ファイルの完全なファイル名です。標準入力および標準出力が端末に送られない場合、またはコマンドラインで -y オプションが指定されている場合は、このプロンプトは表示されません。このプロンプトに対して「y」または「Y」以外で答えると、dmloadcf はバイナリのコンフィグレーション ファイルを作成せずに終了します。

BDMCONFIG ファイルが正しく初期化されていない場合、Initialize BDMCONFIG file プロンプトの後に y を入力すると、dmloadcf は Oracle Tuxedo ファイル システムを作成し、BDMCONFIG テーブルを作成します。-b オプションをコマンドラインで指定すると、Oracle Tuxedo システムのファイル システムを作成するときに、-b オプションの引数がデバイスのブロック数として使用されます。-b オプションの値が、新しい BDMCONFIG テーブルを収容できる大きさである場合、dmloadcf は指定された値を使用して新しいファイル システムを作成します。それだけの大きさがない場合には、エラー メッセージを出力して終了します。-b オプションを指定しないと、dmloadcf は、BDMCONFIG テーブルを収容できる大きさのファイル システムを新たに作成します。ファイル システムが既に存在している場合は、-b オプションが無視されます。BDMCONFIG が raw デバイス (初期化されていない) である場合には、-b オプションを使用することを強くお勧めします。この場合、-b オプションを使用して、raw デバイスのブロック数を設定しなければなりません。BDMCONFIG が通常の UNIX ファイル システムである場合は、-b オプションを使用しないようお勧めします。

BDMCONFIG ファイルがすでに初期化されていることが分かると、dmloadcf は、BDMCONFIG ファイルで記述されているローカル ドメインが動作していないことを確認します。ローカル ドメインが動作している場合は、dmloadcf がエラー メッセージをプリントして終了します。ローカル ドメインが動作していない場合、dmloadcf は次のプロンプトを表示して、BDMCONFIG ファイルを上書きするかどうかを確認します。

"BDMCONFIG ファイルを更新しますか: [y, q]?"

標準入力または標準出力が端末でない場合、または -y オプションをコマンドラインで指定した場合、このプロンプトは表示されません。このプロンプトに対して「y」または「Y」以外で答えると、dmloadcf はファイルを上書きせずに終了します。

TUXCONFIG ファイルの RESOURCES セクションに SECURITY パラメータが指定されていると、dmloadcf は標準入力をフラッシュし、端末エコー機能をオフにして、次のようにユーザにアプリケーション パスワードの入力を求めます。「アプリケーション・パスワードを入力してください:」。パスワードは、30 文字以内の長さで入力できます。この SECURITY パラメータがオンになっているときは、(ファイル以外の) 標準入力を介してテキスト形式の DMCONFIG ファイルをロードすることはできません。標準入力が端末でない場合、つまりパスワードの入力を促すプロンプトが (たとえば here ファイルを使って) 表示されない場合、dmloadcf は環境変数 APP_PW にアクセスしてアプリケーション パスワードを設定します。選択したパスワードが長すぎたり、環境変数 APP_PW を端末以外の標準入力で設定していない場合、dmloadcf はエラー メッセージをプリントし、ログ メッセージを生成し、BDMCONFIG ファイルをロードできません。

エラーが発生せず、チェックの結果がすべて条件を満たしていると、dmloadcf は DMCONFIG ファイルを BDMCONFIG ファイルにロードします。BDMCONFIG テーブル内に存在するすべての情報は上書きされます。

Domains 関連の新しい用語

Oracle Tuxedo のリリース 7.1 以降では、Domains 用の MIB で、ローカル ドメインとリモート ドメインとの相互作用を記述するため、クラスと属性の用語が改善されています。新しい用語は、DM_MIB のリファレンス ページ、クラス、エラー メッセージ、および DMCONFIG のリファレンス ページ、セクション名、パラメータ名、およびエラー メッセージで使用されています。詳細については、DM_MIB(5) リファレンス ページの「Domains 関連の新しい用語」を参照してください。

旧バージョンとの互換性のため、Oracle Tuxedo 7.1 より前に使用された DMCONFIG 用語と、新しい Domains 用の MIB 用語との間にエリアスが提供されています。Oracle Tuxedo 7.1 以降の dmloadcf では、DMCONFIG の両方のバージョンの用語を使用できます。デフォルトでは、dmunloadcf は、新しいドメイン関連の用語を使用する DMCONFIG ファイルを生成します。以前のドメイン関連の用語を使用する DMCONFIG ファイルを生成するには、dmunloadcf の -c オプションを使用します。

移植性

dmloadcf 管理ツールは、Oracle Tuxedo サーバ環境がサポートされるプラットフォームで使用できます。

環境変数

BDMCONFIG 環境変数は、BDMCONFIG ファイルを指していなければなりません。

例

次の例は、バイナリのコンフィグレーション ファイルを、テキスト形式ファイルの bank.dmconfig からロードする方法を示しています。ブロック数が 2000 の BDMCONFIG デバイスが作成 (または初期化) されます。

dmloadcf -b 2000 bank.dmconfig

診断

入力にエラーが検出されると、エラーの原因となった行が、問題を指摘するメッセージとともに、標準エラーにプリントされます。DMCONFIG ファイルに構文エラーが見つかったり、システムが稼働中の場合は、BDMCONFIG ファイルの情報は更新されず、dmloadcf は終了コード 1 で終了します。

dmloadcf をアクティブなノード上で実行すると、次のエラー メッセージが表示されます。

*** dmloadcf はアクティブなノード上では実行できません。***

dmloadcf を実行するユーザの実効ユーザ識別子が、TUXCONFIG ファイルで指定された UID と一致しない場合は、次のエラー メッセージが表示されます。

*** UID は実効ユーザ ID ではありません。 ***

dmloadcf が正しく完了すると、終了コード 0 で終了します。BDMCONFIG ファイルが更新されると、このイベントを記録するための userlog メッセージが生成されます。

関連項目

dmunloadcf(1)、DMCONFIG(5)、UBBCONFIG(5)

『Oracle Tuxedo アプリケーション実行時の管理』

『Oracle Tuxedo Domains コンポーネント』

『ATMI アプリケーションでの Oracle Tuxedo TOP END Domain Gateway の使用』

dmunloadcf(1)

名前

dmunloadcf - バイナリの BDMCONFIG Domains コンフィグレーション ファイルをアンロード

形式

dmunloadcf [-c]

説明

dmunloadcf は、BDMCONFIG コンフィグレーション ファイルをバイナリ表現からテキスト表現に変換します。この変換は、バイト配列が異なるマシン間で簡単にファイルをやり取りできるようにしたり、ファイルのコピーをコンパクトにかつ信頼性をもってバックアップするときに役立ちます。テキスト形式は、DMCONFIG(5) で説明されている形式と同じです。

dmunloadcf は、BDMCONFIG 環境変数が参照する BDMCONFIG ファイルから値を読み取り、その値を標準出力に書き込みます。

Oracle Tuxedo リリース 7.1 以降では、dmunloadcf は、デフォルトで新しいドメイン関連の用語を使用する DMCONFIG ファイルを生成します。詳細については、次の「Domains 関連の新しい用語」を参照してください。以前のドメイン関連の用語を使用する DMCONFIG ファイルを生成するには、-c オプションを使用します。

Domains 関連の新しい用語

Oracle Tuxedo のリリース 7.1 以降では、Domains 用の MIB で、ローカル ドメインとリモート ドメインとの相互作用を記述するため、クラスと属性の用語が改善されています。新しい用語は、DM_MIB のリファレンス ページ、クラス、エラー メッセージ、および DMCONFIG のリファレンス ページ、セクション名、パラメータ名、およびエラー メッセージで使用されています。詳細については、DM_MIB(5) リファレンス ページの「Domains 関連の新しい用語」を参照してください。

下位互換性のため、Oracle Tuxedo 7.1 より前に使用された DMCONFIG 用語と、新しい Domains 用の MIB 用語との間にエリアスが提供されています。Oracle Tuxedo 7.1 以降の dmloadcf では、DMCONFIG の両方のバージョンの用語を使用できます。デフォルトでは、dmunloadcf は、新しいドメイン関連の用語を使用する DMCONFIG ファイルを生成します。以前のドメイン関連の用語を使用する DMCONFIG ファイルを生成するには、dmunloadcf の -c オプションを使用します。

移植性

dmunloadcf コマンドは、Oracle Tuxedo サーバ環境がサポートされるプラットフォームで実行できます。

例

次の例は、/usr/tuxedo/BDMCONFIG のコンフィグレーションを、bdmconfig.backup ファイルにアンロードする方法を示しています。

BDMCONFIG=/usr/tuxedo/BDMCONFIG dmunloadcf > bdmconfig.backup

診断

dmunloadcf は、BDMCONFIG 環境変数が指すファイルが存在しているかどうか、そのファイルが Oracle Tuxedo システムの有効なファイル システムであるかどうか、そしてそのファイルに BDMCONFIG テーブルが入っているかどうかをチェックします。これらの条件が 1 つでも満たされないと、dmunloadcf はエラー メッセージをプリントして、エラー コード 1 で終了します。dmunloadcf が正しく完了すると、終了コード 0 で終了します。

関連項目

dmloadcf(1)、DMCONFIG(5)

『Oracle Tuxedo Domains コンポーネント』

『ATMI アプリケーションでの Oracle Tuxedo TOP END Domain Gateway の使用』

gencat(1)

名前

gencat - フォーマットされたメッセージ カタログを生成

形式

gencat [-m] catfile msgfile  . . .

説明

gencat ユーティリティは、メッセージ テキストのソース ファイル msgfile をフォーマットされたメッセージ データベース catfile にマージします。このデータベースがなければ、データベース catfile が作成されます。catfile が存在する場合には、そのメッセージが新しい catfile に組み込まれます。セット番号とメッセージ番号が矛盾する場合には、msgfile に定義されている新しいメッセージ テキストが catfile に現在格納されている古いメッセージ テキストと置き換わります。gencat に入力されるメッセージ テキストのソース ファイルには、セット番号とメッセージ番号、あるいはメッセージ番号のみ (この場合、セット NL_SETD (「nl_types(5)」を参照) が想定されます) のいずれかを収めることができます。

メッセージ テキストのソース ファイルの形式は、次のように定義されています。ただし、メッセージ テキストのソース行のフィールドは 1 つの ASCII の空白またはタブ文字で区切ります。その他の ASCII の空白やタブは、次のフィールドの一部とみなされます。

$set n comment

$delset n comment

$ comment

m message_text

$quote c

エスケープ シーケンス ¥ddd は、円マークとそれに続く 1、2 または 3 桁の 8 進数からなり、目的の文字の値を指定します。円マークに続く文字が指定されたものの 1 つでない場合には、円マークは無視されます。

円マークの次に ASCII の改行文字を使用して、文字列を次の行に継続させることもできます。たとえば、次の 2 行は 1 つのメッセージ文字列を表しています。

1 This line continues ¥ 
to the next line

上記のメッセージは下のメッセージと同じです。

1 This line continues to the next line

移植性

gencat は、Oracle Tuxedo サーバ環境がサポートされるプラットフォームで実行できます。

注意事項

このバージョンの gencat は、実行時に、malloc によって割り当てられた領域に読み取られるカタログを生成します。gencat のいくつかのバージョンで利用できる共有カタログはこのバージョンでは利用できません。一部のシステムでは、malloc で割り当てられたカタログの生成には -m オプションの指定が必要とされます。このオプションはコマンドラインで指定することもできますが、その場合は何も機能しません。malloc で割り当てられたカタログがデフォルトの設定です。-m オプションは互換性を保持する目的でのみサポートされています。

このコマンドで生成されるカタログ ファイルのサイズは 64K までに限定されています。それ以上のサイズになるような場合には、このコマンドからエラーが報告され、カタログ ファイルは生成されません。

関連項目

nl_types(5)

genicf(1)

名前

genicf - 実装コンフィグレーション ファイル (ICF) を生成

形式

genicf [options] idl-filename...

説明

idl-filename(s) を指定すると、ICF ファイルが生成されます。この ICF ファイルは、コード生成プロセスに、実装のポリシーに関する追加情報、および実装と実装されるインタフェースとの関係を示す情報を提供するファイルです。ICF ファイルを idl コマンドへの入力として指定すると、idl コマンドは ICF ファイルに指定された実装とインタフェースのペアに対してのみサーバ コードを生成します。

生成される ICF ファイルのファイル名は、コマンドラインで指定する最初の idl-filename と同じですが、拡張子は .icf になります。

間違った OMG IDL 構文で idl-filename(s) を指定すると、それに応じたエラーが返されます。

オプション

-D identifier=[definition]

-I pathname

-h および -?

例

次のコマンドは、emp.icf ファイルを作成します。genicf emp.idl

関連項目

idl(1)

idl(1)

名前

idl - Object Management Group (OMG) のインタフェース定義語ファイルをコンパイルし、インタフェースに必要なファイルを生成

形式

idl [-i] [-D identifier[=value]] [-I pathname][-h] [-P] [-T]
idl-filename...[ icf-filename...]

説明

提供されている idl-filename() ファイルおよびオプションの icf-filename() ファイルを指定すると、idl コマンドは以下のファイルを生成します。

idl-filename_c.cpp

idl-filename_c.h

idl-filename_s.cpp

idl-filename_s.h

idl-filename_i.cpp

idl-filename_i.h

IDL コンパイラは、生成するクライアント スタブの情報を filename_c.cpp ファイルおよび filename_c.h ファイルに格納します。生成されたサーバ スケルトンの情報は、filename_s.cpp ファイルおよび filename_s.h ファイルに格納されます。

不明なオプションがこのコマンドに渡されると、そのオプションおよび使用方法を通知するメッセージがユーザに表示され、コンパイルは実行されません。

パラメータ

idl filename

オプション

-D identifier[=definition]

-I pathname

-i

-P

-T

-h または -?

例

idl emp.idl
idl emp.idl emp.icf

関連項目

genicf(1)

idl2ir(1)

名前

idl2ir - インタフェース リポジトリを作成し、インタフェース リポジトリにインタフェース定義をロード

形式

idl2ir [options] definition-filename-list

オプション

使用できるオプションは次のとおりです。

[-f repository-name] [-c]
[-D identifier[=definition]]
[-I pathname [-I pathname] [...]] [-N{i|e}]

説明

このコマンドを使用すると、インタフェース リポジトリを作成し、そのインタフェース リポジトリにインタフェース定義をロードできます。リポジトリ ファイルがない場合は作成されます。リポジトリ ファイルが存在する場合は、指定されたインタフェース定義がそのファイルにロードされ、その結果、ファイルが更新されます。

このコマンドを使用すると、新しいインタフェース リポジトリ データベース ファイルが作成されます。

パラメータ

definition-filename-list

-f repository-name

-c

-D identifier[=definition]

-I pathname

ir2idl(1)

名前

インタフェース リポジトリの内容を表示

形式

ir2idl [options] [interface-name]

オプション

使用できるオプションは次のとおりです。

[-f repository-name] [-n]
[-t interface-type] [-o filename]

説明

このコマンドはインタフェース リポジトリの内容を表示します。-o オプションを使用して出力をファイルに送れば、リポジトリから OMG IDL ファイルを抽出できます。デフォルトでは、リポジトリ ファイルは repository.ifr です。

パラメータ

interface-name

-f repository-name

-n

-t interface-type

-o filename

irdel(1)

名前

指定されたオブジェクトをインタフェース リポジトリから削除

形式

 irdel [-f repository-name]  [-i id] object-name

説明

このコマンドは、指定されたインタフェースをリポジトリから削除します。削除できるのは、ほかのインタフェースから参照されていないインタフェースだけです。デフォルトでは、リポジトリ ファイルは repository.ifr です。

パラメータ

-f repository-name

-i id

object-name

mkfldcs、mkfldcs32(1)