名前

tmshutdown−BEA Tuxedo サーバをシャットダウン

形式

tmshutdown [options]

機能説明

オプションなしの場合、tmshutdown はすべての管理サーバ、TMS、ゲートウェイ・サーバ、および TUXCONFIG 環境変数に指定されているコンフィギュレーション・ファイルの SERVERS セクションに記述されているサーバを停止させ、それらの関連 IPC リソースを除去します。各グループごとに、SERVERS セクションの全サーバ、関連するゲートウェイ・サーバ (外部グループの)、および TMS サーバがこの順序でシャットダウンされます。管理サーバは最後にシャットダウンされます。

SEQUENCE パラメータの指定がないアプリケーション・サーバは、コンフィギュレーション・ファイル内のサーバ・エントリの順序とは逆に最初にシャットダウンされ、SEQUENCE パラメータの指定されたアプリケーション・サーバはその後、順序番号の大きいものから順にシャットダウンされます。コンフィギュレーション・ファイルの SERVERS セクションの複数のサーバに同じ SEQUENCE パラメータが設定されている場合、tmshutdown はこれらのサーバを同時にシャットダウンします。SERVERS セクションの各エントリには、任意に MIN および MAX パラメータを指定することができます。tmshutdown は、-i オプションが指定されていない限り、各サーバ・エントリごとにそのサーバの全オカレンス (MAX 個まで) をシャットダウンします。-i オプションを使用すると、個々のオカレンスをシャットダウンできます。

-l、-g、-s および -T オプションを使用すると、TMS サーバがシャットダウンされます。また、-l、-g および -s オプションを使用すると、ゲートウェイ・サーバがシャットダウンされます。-l、-g、-i、-s、-o および -S オプションはアプリケーション・サーバに適用されます。-A、-M および -B オプションは、管理プロセスにのみ適用されます。-l、-g、-i、-o および -s オプションを組み合わせて使用すると、指定された修飾条件をすべて満たすサーバのみがシャットダウンされます。

サーバのシャットダウン時にグローバル・トランザクションが稼働しているといったような分散トランザクション処理機能を使用する場合には、プリコミット後のコミットが記録される場所まで処理が進んでいなかったトランザクションは、アボートします。一方、コミット点まで進んでいたトランザクションは、サーバ (たとえば、TMS) が再度ブートされた時点で処理が完了します。

相互運用性

tmshutdown はマスタ・ノード上で実行しなければなりません。相互運用アプリケーションでは、マスタ・ノードは最新のリリースでなければなりません。tmshutdown は、リリース 4.1 サイトでリリース 4.2 管理サーバをシャットダウンさせることにつながるコンフィギュレーション・ファイル内の条件を検出し報告します。

移植性

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

診断

tmshutdown は、サーバのシャットダウンに失敗した場合や致命的エラーが発生した場合には、終了コード 1 を返して終了します。詳細については、ユーザ・ログを調べてください。正常に実行できた場合には、終了コード 0 で終了します。

tmshutdown が、マスタ・ノードでないアクティブ・ノード上で実行されると、次のような致命的エラー・メッセージが表示されます。

tmshutdown cannot run on a non acting-master node in an active application.

プロセスをシャットダウンすることでアクティブ・プロセスが DBBL から分断されると、次のような致命的エラー・メッセージが表示されます。

cannot shutdown, causes partitioning.

サーバが異常終了した場合には、次のようなメッセージが出されます。

CMDTUX_CAT:947 Cannot shutdown server GRPID

使用例

システム全体をシャットダウンして、BEA Tuxedo の IPC リソースをすべて削除するには、次のコマンドを実行します。30 秒経過しても確認が得られないと強制的に実行されます。

tmshutdown -w 30

lmid の値が CS1 に設定されているマシン上のサーバだけをシャットダウンするには、次のコマンドを入力します。

tmshutdown -l CS1

-l オプションは SERVERS セクションにリストされているサーバのみにアクションを制限するものであるため、CS1 上の BBL はシャットダウンされません。

注意事項

tmshutdown コマンドは、ハングアップ・シグナル (SIGHUP) を無視します。シャットダウン中にシグナルが検出されても、プロセスは継続します。

関連項目

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