コマンド・リファレンス

セクション1 - コマンド

Oracle Tuxedoコマンドについて

説明

『Oracle 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ライブラリを組み合せて、ロード・モジュールを作成します。ロード・モジュールは、使用しているオペレーティング・システム用に定義されたデフォルトの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]

説明

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

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ワークステーション・クライアント・アプリケーションの作成」

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コマンドを使用して、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] [-M] [-s services[:func[()]]][-v] [-o outfile] [-f firstfiles] [-l lastfiles] [{-r|-g} rmname] [{-r|-g} rmid:rmname] [-E envlabel] [-t]

説明

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

環境変数

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] [-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 # 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ライブラリを組み合せます。このロード・モジュールは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 ATMIアプリケーションのプログラミング』の「型付きバッファの管理」を参照してください。

移植性

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サブコマンドが呼び出されると、configurationモードに入ります。アプリケーション管理者は、このモードを使用して、新しい構成情報を更新したり、ドメイン構成ファイル(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) 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で指定できます。デフォルトではUNIXのテキスト・エディタのedが使用されます。入力形式は、フィールド名とフィールド値のペアで、「構成入力フォーマット」で記述しています。各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関連の新しい用語

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

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

DM_ACCESS_CONTROLセクションの構成

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

DM_PASSWORDSセクションの構成

表13に、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 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ファイルを上書きするかどうかを確認します。

“Really overwrite BDMCONFIG file [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 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 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)

名前

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ワークステーション・クライアント・アプリケーションの作成」

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関数の紹介」、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ロケールのデフォルトの値(U.S. English)を使用します。

コマンドラインにファイル名が指定されていると、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]キーを押すと、コマンドからの出力を終了でき、新しいコマンドを入力するように求められます。コマンドの入力を求められた際に[Enter]キーを押すと、[Break]キーを押した後を除き、直前のコマンドが繰り返し実行されます。

一度[Enter]キーを押してしまったコマンドを完全に取り消す方法はありません。[Break]キーを押しても、それはコマンドからの出力があればその出力を終了させるだけです。したがって、必ず正確にコマンドをタイプ入力してから、[Enter]キーを押すようにしてください。

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]

qcreate (qcr) [-d persist|nonpersist] [-n nhigh,nlow,ncmd]
[-e default_relative_expiration_time]
[queue_name [qorder [out-of-order [retries [delay
[high [low [cmd]]]]]]]]

qdeletemsg (qdltm) [-y]

qdestroy (qds) [{ -p | -f }] [-y] [queue_name]

qinfo [queue_name]

qlist (ql)

qopen [queue_space_name]

qprinttrans (qpt)

qscan [{ [-t time1[-time2]] [-p priority1[-priority2]] [-m msgid]
[-i corrid][-d delivery_mode] [-e time1[-time2]] | none }]

qset [queue_name]

qsize [-A actions] [-H handles] [-C cursors] [ -O owners] [-Q tmp_queues]
[-f filter_memory] [-n nonpersistent_msg_memory[b,B]] [-o overflow_memory][pages [queues [transactions [processes [messages]]]]]

qspacechange (qspch) [-A actions] [-H handles] [-C cursors] [ -O owners]
[-Q tmp_queues] [-f filter_memory] [-n nonpersistent_msg_memory[b,B]]
[-o overflow_memory][queue_space_name [ipckey [trans [procs [messages [errorq [inityn [blocking]]]]]]]]

qspacecreate (qspc) [-A actions] [-n nonpersistent_msg_memory[b,B]]
[-o overflow_memory][queue_space_name [ipckey [pages [queues [trans
[procs [messages [errorq [inityn [blocking]]]]]]]]]]