コマンド・リファレンス

セクション1 - コマンド

Oracle Tuxedoコマンドの紹介

説明

『Oracle Tuxedoコマンド・リファレンス』<Default ?Font>は、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ライブラリを組み合せて、ロード・モジュールを作成します。ロード・モジュールは、使用しているオペレーティング・システム用に定義されたデフォルトのC言語コンパイル・コマンドを使用し、buildclientによって構築されます。UNIXシステム用のデフォルトのC言語コンパイル・コマンドは、UNIXシステムのリファレンス・マニュアルで説明されているcc(1)コマンドです。

-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

IBMCOBOL

LD_LIBRARY_PATH (UNIXシステムの場合)

LIB (Windows NTシステム)

移植性

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

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

サンプル

リスト1に、一般的なCOBOLコンパイラの例を示します。

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" 

リスト2に、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

リスト3に、IBMCOBOLコンパイラの例を示します。

TUXDIR=/opt/tuxedo10.0
TM_COB_STATIC=no
COB=IBMCobol
IBMCOBOL=/usr/lpp/cobol
COBCPY=$TUXDIR/cobinclude
COBOPT="-Ca -v -w -Ga  -Dw64 -Dl8 -Da8"  LD_LIBRARY_PATH=$IBMCOBOL/lib:$TUXDIR/lib
export TUXDIR TM_COB_STATIC COB COBCPY COBOPT IBMCOBOL 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][-c] [-t]

説明

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とのやり取りに使用します。詳細は、Oracle MQ Adapter for Tuxedo 11gR1ユーザーズ・ガイドを参照してください。

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

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

あらかじめリンクされたオブジェクトではなく、buildmqadapterを使用してMQ Adapterサーバー・ファイルを作成することで、Tuxedo管理者は次を構成できます。

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

オプション

v

-r rm_name

-c

-t

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#コンパイラを呼び出す別のコマンドラインを作成し、実行可能アプリケーションをビルドします。

たとえば、[buildnetclient -o t1.exe, t1.cs]は、Windowsシステム上では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ワークステーション・クライアント・アプリケーションの作成に関する項<Default ?Font>

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環境変数を使用すると、コンパイラに渡すオプションを指定できます。CPPFLAGSの値は、CFLAGSを定義していない状態でbuildobjclientが呼び出された場合に使用されます。

オプション

-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コマンドを使用して、<Default ?Font>CORBAサーバー・アプリケーションを構築できます。このコマンドは、メイン・ルーチンで-fおよび-lオプションによって指定されるファイルと標準の<Default ?Font>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コマンドは、クライアントのみの<Default ?Font>CORBAシステムではサポートされません。

例

次の例では、emp_s.cppおよびemp_i.cppファイルを使用して、UNIXシステム上で<Default ?Font>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] [-M] [-s services[:func[()]]][-v] [-o outfile] [-f firstfiles] [-l lastfiles] [{-r|-g} rmname] [-E envlabel] [-t] [-z]

説明

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

-v

-o outfile

-f firstfiles

-l lastfiles

-M

-r rmname

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

-C

-k

-t

-z

環境変数

TUXDIR

CC

CFLAGS

ALTCC

ALTCFLAGS

COBOPT

COBCPY

TM_COB_STATIC

COB

TM_COB_VERSION

TM_COB_CC_FILES

ACUCOBOL

IBMCOBOL

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

リスト4に、一般的な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

リスト5に、ACUCOBOLコンパイラの例を示します。

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

リスト6に、IBMCOBOLコンパイラの例を示します。

TUXDIR=/opt/tuxedo10.0
TM_COB_STATIC=no
COB=IBMCobol
IBMCOBOL=/usr/lpp/cobol
COBCPY=$TUXDIR/cobinclude
COBOPT="-Ca -v -w -Ga  -Dw64 -Dl8 -Da8"
LD_LIBRARY_PATH=$IBMCOBOL/lib:$TUXDIR/lib
export TUXDIR TM_COB_STATIC COB COBCPY COBOPT IBMCOBOL 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)(1) - TM_MQOサーバーをリンク

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

形式

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

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

buildTMQUEUE_MQM [-v] [-r rmname] [-c] [-t] [-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とのやり取りに使用します(Oracle MQ Adapter for Tuxedo 10.0ユーザー・ガイドで説明されています)。

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

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

あらかじめリンクされたオブジェクトではなく、これらのコマンドを使用してMQ Adapterサーバー・ファイルを作成することで、Tuxedo管理者は次を構成できます。

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

オプション

-v

-r rm_name

-c

-t

-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 [-z]

説明

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

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

-z

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 # TMS for XYZ resource manager

関連項目

buildserver(1)、UBBCONFIG(5)

buildwsh(1)

名前

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

形式

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

説明

buildwshは、カスタマイズしたOracle Tuxedo ATMIワークステーション・ハンドラ・モジュールを構築するために使用されます。呼出し側によって組み込まれるファイルは、アプリケーション・バッファ型スイッチと必要なサポート・ルーチンのみを含む必要があります。このコマンドは、-fオプションで指定されるファイルと、必要な標準Oracle Tuxedo ATMIライブラリを組み合せて、ワークステーション・ハンドラ・ロード・モジュールを作成します。ロード・モジュールは、buildwshが呼び出すcc(1)コマンドによって構築されます(コマンドの説明はUNIXシステム・リファレンス・マニュアルを参照)。buildwshコマンドには、以下のオプションがあります。

-v

-o name

-f firstfiles

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

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

移植性

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コンパイラに対するインタフェース・シェルとして使用します。それは、-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—<Default ?Font>Oracle Tuxedoドメイン管理コマンド・インタプリタ。

形式

dmadmin [ -c ]

説明

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

dmadminには、管理モードと構成モードの2つのモードがあります。

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

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

dmadminでは、BDMCONFIGファイルの管理にDomains管理サーバー(DMADM)を、アクティブなDOMAINゲートウェイ・グループの再構成にゲートウェイ管理サーバー(GWADM)を使用する必要があります。Domains構成で起動される各<Default ?Font>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}]

advertiseevent (advevt) -d local_domain_name_[{-all | event}]

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}]

unadvertiseevent (unadvevt) -d local_domain_name_[{-all | event}]

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

	 20) EVENTS_IN        21) EVENTS_OUT
	  q) QUIT
Enter Section [1]:

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

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

Operations:
        1) FIRST        2) NEXT
        3) RETRIEVE     4) ADD
        5) UPDATE       6) DELETE
        7) NEW_SECTION  8) QUIT
Enter Operation [1]:

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

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

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

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

Enter editor to add/modify fields [n]?

値yを入力すると、入力バッファが一時ファイルに変換され、テキスト・エディタが実行されます。環境変数EDITORを使用して、使用するエディタを決定します。デフォルト値はed (UNIXテキスト・エディタ)です。入力フォーマットは、一連のフィールド名とフィールド値の組合せです。「構成入力フォーマット」を参照してください。その後の項の表に、各DMCONFIGセクションに関連付けられているフィールド名を示します。フィールドのセマンティクスと、関連する範囲、デフォルト値、制限などは、DMCONFIG(5)およびDM_MIB(5)に関する項目を参照してください。多くの場合、フィールド名はDMCONFIGファイルのKEYWORDと同じで、接頭辞として「TA_」が付いています。ユーザーが入力バッファの編集を完了すると、dmadminはその内容を読み取ります。特定のフィールド名に対して複数の行がある場合、最初の行が使用され、他の行は無視されます。何らかのエラーが発生すると、構文エラー・メッセージが表示され、その問題の訂正のためにファイルを編集するかどうかを確認するプロンプトが表示されます。

Enter editor to correct?

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

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

Perform operation [y]?

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

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

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

Unload BDMCONFIG file into ASCII backup [y]?

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

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

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

構成入力フォーマット

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

fldname fldval

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

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

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

表示できない文字をフィールド値に入力したり、タブをフィールド値の先頭に付けたりするには、バックスラッシュを入力し、その後に必要な文字を2文字の16進表現で入力します(UNIXリファレンス・マニュアルでASCII(5)の項を参照)。たとえば、空白は「\20」として入力データに入力できます。バックスラッシュそのものは、2つのバックスラッシュ記号を使用して入力できます。dmadminでは、このフォーマットのすべての入力が認識されます。このフォーマットは表示できない文字の場合に最も役立ちます。

構成の制限事項

次に動的Domainsを再構成する機能についての全般的な制限事項を示します。

Domains関連の新しい用語

<Default ?Font>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セクションの構成

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

DM_REMOTEセクションの構成

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

DM_TDOMAINセクションの構成

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

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

DM_OSITPセクションの構成

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

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

DM_OSITPXセクションの構成

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

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

DM_EXPORTセクションの構成

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

DM_IMPORTセクションの構成

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

DM_EVT_INセクションの構成

表11に、DM_EVT_INセクションのフィールドを示します。

DM_EVT_OUTセクションの構成

表12に、DM_EVT_OUTセクションのフィールドを示します。

DM_ROUTINGセクションの構成

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

DM_ACCESS_CONTROLセクションの構成

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

DM_PASSWORDSセクションの構成

表15に、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
Sections:
         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
Enter Section [1]:
Enter Section [1]: 2
Operations:
        1) FIRST        2) NEXT
        3) RETRIEVE     4) ADD
        5) UPDATE       6) DELETE
        7) NEW_SECTION  8) QUIT
Enter Operation [1]: 4
Enter editor to add/modify fields [n]? y
a
TA_RDOM         B05
TA_DOMAINID     BA.BANK05
TA_TYPE         TDOMAIN
.
w
53
q
Perform operation [y]? <return>
Return value TAUPDATED
Buffer contents:
TA_OPERATION    4
TA_SECTION      2
TA_DOMAINID     BA.BANK05
TA_RDOM B05
TA_TYPE TDOMAIN
TA_STATUS       Update completed successfully
Operations:
        1) FIRST        2) NEXT
        3) RETRIEVE     4) ADD
        5) UPDATE       6) DELETE
        7) NEW_SECTION  8) QUIT
Enter Operation [4]: 7
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) QUIT
Enter Section [1]: 9
Operations:
        1) FIRST        2) NEXT
        3) RETRIEVE     4) ADD
        5) UPDATE       6) DELETE
        7) NEW_SECTION  8) QUIT
Enter Operation [6]: 4
Enter editor to add/modify fields [n]? y
a
TA_RDOM         B05
TA_NWADDR       0x00020401c0066d05
TA_NWDEVICE     /dev/tcp
.
w
55
q
Perform operation [y]? <return>
Return value TAUPDATED
Buffer contents:
TA_OPERATION    4
TA_SECTION      8
TA_RDOM         B05
TA_NWADDR       0x00020401c0066d05
TA_NWDEVICE     /dev/tcp
TA_STATUS       Update completed successfully
Operations:
        1) FIRST        2) NEXT
        3) RETRIEVE     4) ADD
        5) UPDATE       6) DELETE
        7) NEW_SECTION  8) QUIT
Enter Operation [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コマンドをシステムがブートする前に入力すると、次のメッセージが表示されます。

No bulletin board exists. Only logging commands are available.

次に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 Oracle Tuxedo Domainsコンポーネントの使用』<Default ?Font>

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

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ファイルが正しく初期化されない場合、BDMCONFIGファイルを初期化しますかというプロンプトの後でユーザーがyを入力すると、dmloadcfはOracle Tuxedoファイル・システムを作成し、BDMCONFIG表を作成します。-bオプションがコマンドラインに指定されると、その引数により、Oracle Tuxedoファイル・システムの作成時にデバイスのブロック数が定義されます。-bオプションの値が新しいBDMCONFIG表を収容できるほど大きい場合、dmloadcfは、指定された値を使用して新しいファイル・システムを作成します。それ以外の場合、dmloadcfはエラー・メッセージを出力して終了します。-bオプションが指定されない場合、dmloadcfは、BDMCONFIGを収容できるだけ大きい新しいファイル・システムを作成します。ファイル・システムがすでに存在している場合、-bオプションは無視されます。BDMCONFIGがrawデバイス(初期化されていないデバイス)の場合は、-bオプションを強く推奨します。その場合、rawデバイスのブロック数を設定するために-bを使用してください。BDMCONFIGが通常のUNIXファイルである場合には、-bオプションは使用しないようにしてください。

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

“Really overwrite BDMCONFIG file [y, q]?”

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

SECURITYパラメータがTUXCONFIGファイルのRESOURCESセクションに指定されると、dmloadcfは、標準入力をフラッシュし、端末エコーをオフにし、ユーザーにアプリケーション・パスワードの入力を求めます(「アプリケーション・パスワードを入力してください」)。パスワードは30文字までに制限されています。ファイルではなく標準入力を介してテキスト形式のDMCONFIGファイルをロードするオプションは、このSECURITYパラメータがオンのときには使用できません。標準入力が端末でない場合、つまり、ユーザーにパスワードの入力を求めることができない場合(たとえば、hereファイルの場合)、アプリケーション・パスワードの設定のために環境変数APP_PWが参照されます。APP_PW環境変数が設定されておらず、標準入力が端末でない場合には、dmloadcfはエラー・メッセージを出し、ログ・メッセージを生成して、BDMCONFIGファイルのロードに失敗します。

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

Domains関連の新しい用語

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

後方互換性のため、Oracle Tuxedo 7.1より前に使用されていたDMCONFIG用語と<Default ?Font>Domains用のMIBの新しい用語との間で別名が提供されています。<Default ?Font>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 cannot run on an active node ***

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

*** UID is not effective user ID ***

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

関連項目

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

『Oracle Tuxedo Oracle Tuxedoアプリケーション実行時の管理』<Default ?Font>

『Oracle Tuxedo Oracle Tuxedo Domainsコンポーネントの使用』<Default ?Font>

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

dmunloadcf(1)

名前

dmunloadcf - バイナリのBDMCONFIG Domains構成ファイルをアンロード

形式

dmunloadcf [-c]

説明

dmunloadcfは、BDMCONFIG構成ファイルをバイナリ表現からテキストに変換します。この変換処理は、バイト・オーダーが異なるマシン間でファイルを簡潔に移送したり、ファイルのバックアップ・コピーを簡潔に作成して信頼性を高める場合に役立ちます。テキスト形式については、DMCONFIG(5)で説明した内容と同じです。

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

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

Domains関連の新しい用語

<Default ?Font>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 Oracle Tuxedo Domainsコンポーネントの使用』<Default ?Font>

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

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ファイルが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)

名前

mkfldcs、mkfldcs32 - フィールド表からC#のヘッダー・ファイルを作成

形式

mkfldcs [-d outdir] [ field_table... ]

mkfldcs32 [-d outdir] [ field_table... ]

説明

mkfldcsはmkfldhdrに似ていますが、出力されるファイルがC#のソース・ファイルの生成に使用されることが異なります。このソース・ファイルには、入力ファイルで与えられた各FMLフィールドIDの定義などのパブリック・クラスが含まれます。

mkfldcsコマンドライン・オプションは、mkfldhdr、mkfldhdr32(1)と同じです。mkfldcs32は32ビットFMLで使用します。

関連項目

『Tuxedo .NETワークステーション・クライアントの使用』のTuxedo .NETワークステーション・クライアント・アプリケーションの作成に関する項<Default ?Font>

mkfldhdr、mkfldhdr32(1)

名前

mkfldhdr、mkfldhdr32 - フィールド表からヘッダー・ファイルを作成

形式

mkfldhdr [-d outdir] [ field_table... ] 
mkfldhdr32 [-d outdir] [ field_table... ]

説明

mkfldhdrは、各フィールド表をCプログラムにおける組込みに適するヘッダー・ファイルに変換します。結果として得られたヘッダー・ファイルからは、フィールド名からフィールドIDへの変換を行うための#defineマクロが得られます。ヘッダー・ファイルの名前は、変換する各ファイルのファイル名に.hを付けることによって得られます。

フィールド表名は、コマンドラインで指定してもかまいません。また、各ファイルは対応するヘッダー・ファイルに変換されます。

フィールド表名をコマンドラインで指定しなかった場合には、プログラムは変換するフィールド表のリストとしてFIELDTBLS環境変数を、またファイルの検索に使用するディレクトリのリストとしてFLDTBLDIR環境変数を使用します。FIELDTBLSは、フィールド表ファイル名の、カンマで区切られたリストを指定します。FIELDTBLSに値がない場合、(唯一の)フィールド表ファイルの名前としてfld.tblが使用されます(この場合、結果として得られるヘッダー・ファイルはfld.tbl.hになります)。

FLDTBLDIR環境変数は、コロンで区切られたディレクトリのリストで、この中から名前が絶対パス名でないフィールド表が検索されます。フィールド表の検索は、UNIXシステムのPATH変数を使用した実行可能コマンドの検索と非常によく似ています。FLDTBLDIRが定義されない場合は、現在のディレクトリのみが検索されます。このため、コマンドラインにフィールド表名が指定されず、FIELDTBLSとFLDTBLDIRが設定されない場合は、mkfldhdrによって、現在のディレクトリのフィールド表fld.tblがヘッダー・ファイルfld.tbl.hに変換されます。

mkfldhdr32は、32ビットのFMLで使用します。環境変数FIELDTBLS32およびFLDTBLDIR32を使用します。

オプション

-d

エラー

フィールド表のロードに失敗した場合、あるいは出力ファイルを生成できなかった場合には、エラー・メッセージが出力されます。

サンプル

FLDTBLDIR=/project/fldtbls
FIELDTBLS=maskftbl,DBftbl,miscftbl,
export FLDTBLDIR FIELDTBLS

この例では、ディレクトリ/project/fldtblsのファイルmaskftbl、DBftblおよびmiscftblを処理することにより、mkfldhdrは、#includeファイルmaskftbl.h、DBftbl.hおよびmiscftbl.hをカレント・ディレクトリに作成します。

上記の例のように環境変数を設定すると、コマンドmkfldhdr -d$FLDTBLDIRは同じ入力フィールド表ファイルを処理して、同じ出力ファイルを生成しますが、それらのファイルは環境変数FLDTBLDIRの値で示されるディレクトリに格納されます。

また、コマンドmkfldhdr myfieldsは、入力ファイルmyfieldsを処理して、カレント・ディレクトリにmyfields.hを生成します。

関連項目

『Oracle Tuxedo ATMI FML関数リファレンス』のFML関数の概要に関する項<Default ?Font>、「field_tables(5)」

mklanginfo(1)

名前

mklanginfo - ロケールの言語情報定数をコンパイル

形式

mklanginfo [fname]

説明

このプログラムは引数として指定されたファイルを取り込み、その入力を$TUXDIR/locale/xx/LANGINFOに配置するのに適したファイルに変換します(xxは特定のロケール)。ファイルの引数が指定されていない場合は、標準入力が使用されます。この言語値は、setlocale(3c)、strftime(3c)およびnl_langinfo(3c)で使用されます。

mklanginfoは入力行を読み取ります。このとき、空白または「#」で始まる行は無視されます。値入力行は次の形式で指定する必要があります。

<token> = “value” 

トークン(token)と二重引用符で囲んだ値との間の文字は、二重引用符以外の任意の文字にすることができます(トークンの後に空白がある場合)。valueがnull文字列であると、その行は無視されます。そうでなければ、トークンは1から48までの任意の整数とするか、以下に示す文字列のいずれかとする必要があります。

Integer String  Value 1
 
DAY_1     Day 1 of the week, for example, Sunday 2
DAY_2     Day 2 of the week, for example, Monday 3
DAY_3     Day 3 of the week, for example, Tuesday 4
DAY_4     Day 4 of the week, for example, Wednesday 5
DAY_5     Day 5 of the week, for example, Thursday 6
DAY_6     Day 6 of the week, for example, Friday 7
DAY_7     Day 7 of the week, for example, Saturday 8
ABDAY_1   Abbreviated day 1 of the week, for example, Sun 9
ABDAY_2   Abbreviated day 2 of the week, for example, Mon 10
ABDAY_3   Abbreviated day 3 of the week, for example, Tue 11
ABDAY_4   Abbreviated day 4 of the week, for example, Wed 12
ABDAY_5   Abbreviated day 5 of the week, for example, Thu 13
ABDAY_6   Abbreviated day 6 of the week, for example, Fri 14
ABDAY_7   Abbreviated day 7 of the week, for example, Sat 15
MON_1     Month 1 of the year, for example, January 16
MON_2     Month 2 of the year, for example, February 17
MON_3     Month 3 of the year, for example, March 18
MON_4     Month 4 of the year, for example, April 19
MON_5     Month 5 of the year, for example, May 20
MON_6     Month 6 of the year, for example, June 21
MON_7     Month 7 of the year, for example, July 22
MON_8     Month 8 of the year, for example, August 23
MON_9     Month 9 of the year, for example, September 24
MON_10    Month 10 of the year, for example, October 25
MON_11    Month 11 of the year, for example, November 26
MON_12    Month 12 of the year, for example, December 27
ABMON_1   Abbreviated month 1 of the year, for example, Jan 28
ABMON_2   Abbreviated month 2 of the year, for example, Feb 29
ABMON_3   Abbreviated month 3 of the year, for example, Mar 30
ABMON_4   Abbreviated month 4 of the year, for example, Apr 31
ABMON_5   Abbreviated month 5 of the year, for example, May 32
ABMON_6   Abbreviated month 6 of the year, for example, Jun 33
ABMON_7   Abbreviated month 7 of the year, for example, Jul 34
ABMON_8   Abbreviated month 8 of the year, for example, Aug 35
ABMON_9   Abbreviated month 9 of the year, for example, Sep 36
ABMON_10 Abbreviated month 10 of the year, for example, Oct 37
ABMON_11 Abbreviated month 11 of the year, for example, Nov 38
ABMON_12 Abbreviated month 12 of the year, for example, Dec 39
RADIXCHAR Radix character, for example, '.' 40
THOUSEP   Separator for thousands 41
YESSTR    Affirmative response string, for example, yes 42
NOSTR     Negative response string, for example, no 43
CRNCYSTR Currency symbol 44
D_T_FMT   string for formatting date and time, for example, “%a%b%d%H:%M:0Y” 45
D_FMT     string for formatting date, for example, “%m/%d/%y” 46
T_FMT     string for formatting time, for example, “H:%M:%S” 47
AM_FMT    Ante Meridian affix, for example, AM 48
PM_FMT    Post Meridian affix, for example, PM

入力行は任意の順序で表示される可能性があります。入力行が同じ値に対して複数回表示される場合、その値の最後の行が使用されます。

mklanginfoは、ファイルを処理すると、前のコード・リストに示した各言語情報定数の文字列名と文字列値を、リストの順に標準エラーに出力します。指定されていない言語情報定数の値としてNULL文字列が使用されます。nl_langinfoは、このような未設定定数についてCロケールのデフォルト値(米国向け英語)を使用します。

コマンドラインにファイル名が指定されていると、mklanginfoはコンパイルされた出力をfname.outに出力します。指定されていない場合は標準出力に出力します。形式は、NULLで終わる文字列値のみのリストです(改行文字は入りません)。

診断

ファイルの読取りエラーや構文エラーがあると、エラー・メッセージが標準エラー出力に書き出された後、終了コード1でプログラムは終了します。成功時には、プログラムは終了コード0で終了します。

サンプル

Oracle Tuxedoシステム(Cロケール)のデフォルトは、$TUXDIR/locale/C/lang.textに格納されています。フランス語の値を入力するには、(UNIXシステムプラットフォーム上で)管理者が次の操作を行います。

mkdir $TUXDIR/locale/french
cd $TUXDIR/locale/french
cp $TUXDIR/locale/C/lang.text .
ed lang.text
フランス語に翻訳
w
q
mklanginfo lang.text > LANGINFO

ファイル

$TUXDIR/locale/C/lang.text - Cロケールのデフォルト値
$TUXDIR/locale/C/LANGINFO - Cロケールの「コンパイル済」ファイル
$TUXDIR/locale/xx/LANGINFO - xxロケールの「コンパイル済」ファイル

注意事項

mklanginfoコマンドと、その実行結果として得られるLANGINFOファイルは、setlocale()、strftime()、あるいはnl_langinfo()のOracle Tuxedoシステムの互換関数を使用する場合にのみ必要となります。UNIXで提供される関数は、別のファイル・セットおよびファイル形式を使用します。

関連項目

nl_langinfo(3c)、setlocale(3c)、strftime(3c)、langinfo(5)

qmadmin(1)

名前

qmadmin - キュー・マネージャ管理プログラム

形式

[QMCONFIG=<device>] qmadmin [<device>]

説明

qmadminは、次の一覧で示す各種コマンドを使用することにより、メッセージ・キューの作成、検査および変更を行います。汎用デバイス・リスト(UDL)は、Oracle Tuxedo ATMIシステムが稼働するマシンに物理ストレージ・スペースをマップします。UDLのエントリは、キューとキュー・スペースのメッセージが格納される、ディスク空間を指定します。キュー・スペースのための汎用デバイス・リストが存在する(または存在することになる)デバイス(ファイル)名は、コマンドライン引数として指定することも、環境変数QMCONFIGを介して指定することもできます。この両方で指定された場合には、コマンド・オプションが使用されます。

qmadminはシステム付属のサーバーとして、通常の初期化プロセスを行わないため、UBBCONFIGファイルからULOGPFXの値を参照しません。その結果、qmadminコマンドによって生成されたすべてのログ・エントリが、現在の作業ディレクトリに書き込まれます。これに対処するには、ULOGPFX環境変数をユーザー・ログのあるディレクトリのパス名に設定して、エクスポートします。

qmadminは、プロンプトとして不等号(>)を使用します。引数はタブまたは空白(あるいは両方)で区切って入力します。空白を含む引数は二重引用符で囲むこともできます。二重引用符で囲んだ引数に二重引用符が含まれる場合は、含まれる二重引用符の前にバックスラッシュを付ける必要があります。必要な情報がコマンドラインに指定されない場合は、コマンドによって情報の入力を求められます。必須の引数が入力されないと、警告メッセージが表示され、プロンプトが再び表示されます。オプションのパラメータに関する情報に対してはプロンプトは表示されません。

ユーザーは、コマンドの入力を求められた際にqまたは<CTRL-d>と入力するとプログラムを終了できます。[Break]キーを押すと、コマンドからの出力を終了でき、新しいコマンドを入力するように求められます。コマンドの入力を求められた際に[Return]キーを押すと、[Break]キーを押した後を除き、直前のコマンドが繰り返し実行されます。

[Return]を押した後でコマンドを取り消す方法はありません。[Break]を押してもコマンドの出力(ある場合)が終了するだけです。したがって、[Return]を押す前にコマンドを正しく入力したことを確認してください。

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

qmadminを初めて入力するときは、開いているキュー・スペースはありません。キュー・スペースを作成するにはqspacecreateを実行します。このキュー・スペースを開くには、qopenを実行します。qaborttrans、qclose、qchangeprio、qchangequeue、qchangetime、qchangeexptime、qcommittrans、qchange、qcreate、qdeletemsg、qinfo、qlist、qprinttrans、およびqsetは、キュー・スペースが開いているときのみ実行できます。

次の表は、機能タイプ別にグループ化したqmadminコマンドをリストしています。

qmadminコマンド

コマンドの形式は、完全名でも省略形でも(省略形がある場合は、完全名の後にカッコで示されます)入力することができ、該当する引数がその後に付きます。大カッコ[ ]で囲まれている引数は省略可能で、中カッコ{ }で囲まれている引数は、相互に排他的な選択肢を示します。

chdl [dlindex [newdevice]]

crdl [device [offset [size]]]

dsdl [-y] [dlindex]

echo (e) [{off | on}]

help (h) [{command | all}]

ipcrm [-f] [-y] [queue_space_name]

ipcs [queue_space_name]

lidl [dlindex]

livtoc

paginate (page) [{off|on}]

qaborttrans (qabort) [-y] [tranindex]

qaddext [queue_space_name [pages]]

qchange [-d persist|nonpersist] [-n nhigh,nlow,ncmd]
[-e default_relative_expiration_time]
[queue_name [out-of-order [retries [delay [high [low [cmd]]]]]]]

qchangeexp (qce) -y [newtime]

qchangeprio (qcp) [-y] [newpriority]

qchangequeue (qcq) [-y] [newqueue]

qchangetime (qct) [-y] [newtime]

qclose

qcommittrans (qcommit) [-y] [tranindex]