名前

tmloadcf−UBBCONFIG ファイルを解析し、バイナリ版の TUXCONFIG コンフィギュレーション・ファイルをロード

形式

tmloadcf [-n] [-y] [-c] [-b blocks] {UBBCONFIG_file | -}

機能説明

tmloadcf は、UBBCONFIG の構文に従った形式のファイルあるいは標準入力を読み取り、その構文をチェックし、指定に応じてバイナリ版の TUXCONFIG コンフィギュレーション・ファイルをロードします。環境変数 TUXCONFIG と TUXOFFSET (省略可能) は、それぞれ該当情報を格納する TUXCONFIG ファイルとオフセットを示します。tmloadcf は、UBBCONFIG ファイルの RESOURCES セクションに定義されている MASTER マシン上でしか実行できません。ただし、-c あるいは -n オプションが指定されている場合を除きます。

tmloadcf を実行するユーザの実効ユーザ識別子は、UBBCONFIG ファイルの RESOURCES セクションに記述されている UID と同じでなければなりません (指定がある場合)。

tmloadcf にオプション -c を付けると、プログラムはこの構成に必要とされる最小の IPC リソースを表示します。プロセッサごとに異なるリソース要求条件が、構成に含まれる各プロセッサごとに表示されます。TUXCONFIG ファイルは更新されません。

tmloadcf で -n オプションを使用すると、プログラムは UBBCONFIG (コンフィグレーション・ファイルのテキスト・バージョン) の構文チェックだけを行い、TUXCONFIG ファイルの実際の更新は行いません。

構文チェックの後、tmloadcf は、TUXCONFIG が参照するファイルが存在するかどうか、存在する場合はそのファイルが有効な BEA Tuxedo システムのファイルシステムかどうか、および TUXCONFIG テーブルを含んでいるかどうかを調べます。これらの条件が満たされていない場合、tmloadcf は、TUXCONFIG の作成および初期化を行うかどうかを確認するプロンプトを表示します。

Initialize TUXCONFIG file:path [y, q]?

標準入力あるいは標準出力が端末でない場合、あるいはコマンド行で -y オプションが指定された場合には、このプロンプトは出されません。"y" または "Y" 以外の応答をすると、tmloadcf はコンフィギュレーション・ファイルを作成せずに終了します。

TUXCONFIG ファイルが正しく初期化されていない場合、処理を先に進めるよう指示すると、tmloadcf は BEA Tuxedo システムのファイルシステムを作成し、TUXCONFIG テーブルを作成します。コマンド行に -b オプションを指定すると、BEA Tuxedo システムのファイルシステムの作成時にそのデバイスのブロック数を引数として使用します。-b オプションの値が、新しい TUXCONFIG テーブルを収容できる大きさである場合、tmloadcf は指定された値を使用して新しいファイルシステムを作成します。それだけの大きさがない場合には、エラー・メッセージを出力して終了します。-b オプションを指定しないと、tmloadcf は、TUXCONFIG テーブルを収容できる大きさのファイルシステムを新たに作成します。ファイルシステムが既に存在している場合は、-b オプションが無視されます。

TUXCONFIG が raw 型装置 (初期化されていない) であり、その raw 型装置上のブロック数を設定する必要がある場合には、-b オプションをできるだけ使用するようにしてください。TUXCONFIG が通常の UNIX ファイルである場合には、-b オプションは使用しないようにしてください。

TUXCONFIG ファイルが既に初期化されていると判断される場合、tmloadcf はその TUXCONFIG ファイルに記述されているシステムが稼働状態にないことを確認します。そのシステムが稼働状態にあると、tmloadcf はエラー・メッセージを出して終了します。

システムが非稼働状態にあり、TUXCONFIG ファイルが既に存在している場合は、ファイルを上書きするかどうかを確認するプロンプトが表示されます。

Really overwrite TUXCONFIG file [y, q]? 

標準入力あるいは標準出力が端末でない場合、あるいはコマンド行で -y オプションが指定された場合には、このプロンプトは出されません。"y" または "Y" 以外の応答を行うと、tmloadcf は終了して、ファイルの書き換えは行われません。

コンフィギュレーション・ファイルの RESOURCES セクションに SECURITY パラメータが指定されていると、tmloadcf は標準入力をフラッシュし、端末エコー機能をオフにして、ユーザにアプリケーション・パスワードの入力を求めます。

Enter Application Password?
Reenter Application Password? 

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

エラーがないと仮定して、すべてのチェックの結果が正常であった場合、tmloadcf は UBBCONFIG ファイルを TUXCONFIG ファイルにロードします。このとき、TUXCONFIG テーブルにある既存の情報はすべて書き換えられます。

ロード中に丸められて、アンロードされたときに一致しない値もありますので、注意してください。そのような値には MAXRFT および MAXRTDATA がありますが、それだけではありません。

相互運用性

tmloadcf はマスタ・ノード上で実行しなければなりません。相互運用アプリケーションでは、マスタ・ノードは最新のリリースでなければなりません。

移植性

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

環境変数

環境変数 APP_PW は、SECURITY パラメータが指定され、かつ標準入力として端末以外のものを使用して tmloadcf を実行するアプリケーションに対して設定しなければなりません。

使用例

UBBCONFIG ファイル BB.shm からコンフィギュレーション・ファイルをロードするには、次のようにデバイスを 2000 ブロックに初期化します。

tmloadcf -b2000 -y BB.shm

診断

入力にエラーが検出されると、エラーの原因となった行が、問題を指摘するメッセージと共に、標準エラーに出力されます。また、UBBCONFIG ファイルに構文エラーがあったり、システムがその時点で稼働中であると、TUXCONFIG ファイル内の情報はいっさい更新されず、tmloadcf は終了して、終了コード 1 を返します。

UBBCONFIG ファイルに指定されている UID と一致しない実効ユーザ識別子を持つユーザが tmloadcf を実行すると、次のようなエラー・メッセージが表示されます。

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

tmloadcf を非マスタ・ノード上で実行すると、次のようなエラー・メッセージが表示されます。

tmloadcf cannot run on a non-master node.

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

tmloadcf cannot run on an active node.

tmloadcf は正常に処理を完了すると、終了コード 0 を返して終了します。TUXCONFIG ファイルが更新された場合には、userlog メッセージが生成されてこのイベントが記録されます。

関連項目

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