bea ホーム | 製品 | dev2dev | support | askBEA |
![]() |
![]() |
|
![]() |
e-docs > Tuxedo > Tuxedo コマンド・リファレンス > セクション 1 - コマンド |
Tuxedo コマンド・リファレンス
|
名前
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 が参照するファイルが存在するかどうか、存在する場合はそのファイルが有効な BEA Tuxedo ファイルであるかどうか、および BDMCONFIG テーブルを含んでいるかどうかを調べます。これらの条件が真でなかった場合、そのユーザにはファイルを作成して初期化するよう、次のような指示が出されます。
Initialize BDMCONFIG file:path [y, q]?
path は、BDMCONFIG ファイルの完全なファイル名です。標準入力および標準出力が端末に送られない場合、またはコマンド行で -y オプションが指定されている場合は、このプロンプトは表示されません。このプロンプトに対して &“&”または &dl“rq; 以外で答えると、dmloadcf はバイナリのコンフィギュレーション・ファイルを作成せずに終了します。
BDMCONFIG ファイルが正しく初期化されていない場合、Initialize BDMCONFIG file プロンプトの後に y を入力すると、dmloadcf は BEA Tuxedo ファイルシステムを作成し、BDMCONFIG テーブルを作成します。-b オプションをコマンド行で指定すると、BEA 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 オプションをコマンド行で指定した場合、このプロンプトは表示されません。このプロンプトに対して &dl“rq; または &dl“rq; 以外で答えると、dmloadcf はファイルを上書きせずに終了します。
TUXCONFIG ファイルの RESOURCES セクションで SECURITY パラメータを指定すると、dmloadcf は標準入力をフラッシュし、端末のエコーをオフにして、次のプロンプトでアプリケーション・パスワードの入力を促します。Enter Application Password?パスワードは、8 文字以内の長さで入力できます。この SECURITY パラメータがオンになっているときは、(ファイル以外の) 標準入力を介してテキスト形式の DMCONFIG ファイルをロードすることはできません。標準入力が端末でない場合、すなわちパスワードの入力を促すプロンプトが (たとえば here ファイルを使って)表示されない場合、dmloadcf は環境変数 APP_PW にアクセスしてアプリケーション・パスワードを設定します。選択したパスワードが長すぎたり、環境変数 APP_PW を端末以外の標準入力で設定していない場合、dmloadcf はエラー・メッセージをプリントし、ログ・メッセージを生成し、BDMCONFIG ファイルをロードできません。
エラーが発生せず、チェックの結果がすべて条件を満たしていると、dmloadcf は DMCONFIG ファイルを BDMCONFIG ファイルにロードします。BDMCONFIG テーブル内に存在するすべての情報は上書きされます。
Domains 関連の新しい用語
BEA Tuxedo のリリース 7.1 以降では、Domains 用の MIB で、ローカル・ドメインとリモート・ドメインとの相互作用を記述するため、クラスと属性の用語が改善されています。新しい用語は、DM_MIB のリファレンス・ページ、クラス、エラー・メッセージ、および DMCONFIG のリファレンス・ページ、セクション名、パラメータ名、およびエラー・メッセージで使用されています。詳細については、DM_MIB(5) リファレンス・ページの「Domains 関連の新しい用語」を参照してください。
旧バージョンとの互換性のため、BEA Tuxedo 7.1 より以前に使用された DMCONFIG 用語と、新しい Domains 用の MIB 用語との間にエイリアスが提供されています。BEA Tuxedo 7.1 以降の dmloadcf では、DMCONFIG の両方のバージョンの用語を使用できます。デフォルトでは、dmunloadcf は、新しいドメイン関連の用語を使用する DMCONFIG ファイルを生成します。以前のドメイン関連の用語を使用する DMCONFIG ファイルを生成するには、dmunloadcf の -c オプションを使用します。
移植性
dmloadcf 管理ツールは、BEA 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)、DMCONFIG for GWTOPEND(5)、UBBCONFIG(5)
『BEA Tuxedo アプリケーション実行時の管理』
『BEA Tuxedo Domains コンポーネント』
『ATMI アプリケーションでの BEA Tuxedo TOP END Domain Gateway の使用』
![]() |
![]() |
![]() |
![]() |
||
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |