STOP DATABASE MANAGER コマンド
STOP DATABASE MANAGER コマンドは、ターゲット・メンバーまたはすべてのメンバーで、データベース・マネージャーを停止します。 Db2® pureScale® 環境では、 クラスター・キャッシング・ファシリティー (CF) を停止するためにも使用されます。
範囲
Db2 pureScale 環境またはパーティション・データベース環境では、 DBPARTITIONNUM、 MEMBER、または CF のいずれかのパラメーターが指定されていない限り、このコマンドは db2nodes.cfg ファイルにリストされているすべてのメンバーに影響を与えます。
アクティブ・データベース接続が存在する場合には、このコマンドはメンバーのシャットダウンを行いません。 アクティブ・データベース接続がないものの、インスタンス接続がある場合には、まずインスタンス接続が強制的にオフにされてから、メンバーが停止されます。 また、メンバーを停止させる前に、処理中のデータベースの活動を非アクティブ化します。 このコマンドを使用して、特定のホスト上のインスタンス・サービスを停止することもできます。
このコマンドはクライアントでは無効です。
許可
- SYSADM
- SYSCTRL
- SYSMAINT
必要な接続
なし
コマンド構文
コマンド・パラメーター
- INSTANCE ON hostname
- 保守操作のために、 Db2 pureScale インスタンスの特定のホスト上の Db2 インスタンスを停止することを指定します。 このコマンドは、グローバル db2start コマンドによってホストが再始動されることを一時的に回避します。 ホストは、restart light 状態のゲスト・ホストとしては機能できなくなります。
- identifier
- DBPARTITIONNUM、MEMBER、CFパラメーターを指定せずに数値 ID を指定します。
- DBPARTITIONNUM identifier
- このパラメーター・オプションは、パーティション・データベース環境でのみ有効です。 停止するメンバーを指定します。 有効な値は、0 から 999 (0 および 999 を含む) です。注: このパラメーターを指定せずに FORCE オプションを使用すると、すべてのデータベース・パーティションが停止する前に、すべてのデータベース・パーティション上のすべてのアプリケーションが強制的に実行されます。注: identifier 値は、インスタンス所有者の db2nodes.cfg ファイルに存在している必要があります。 データベース・パーティション番号が指定されていない場合、 構成ファイルで定義されているすべてのデータベース・パーティションが停止されます。
- MEMBER identifier
- 停止するメンバーを指定します。 Db2 pureScale 環境では、有効な値は 0 から 127 (両端を含む) です。
- CF identifier
- このパラメーター・オプションは、 Db2 pureScale 環境でのみ有効です。 停止する クラスター・キャッシング・ファシリティー (CF) を指定します。 有効な値は 128 および 129 です。 Db2 pureScaleの外部で使用すると、 SQL1695N エラーが戻されます。
- PROFILE profile
- このパラメーター・オプションは、パーティション・データベース環境でのみ有効です。 開始されたデータベース・パーティション用に Db2 環境を定義するために、 始動時に実行されたプロファイル・ファイル名を指定します。 START DATABASE MANAGER コマンドのプロファイルを指定した場合は、ここで同じプロファイルを指定する必要があります。 プロファイル・ファイルは、インスタンス所有者のsqllibディレクトリーになければなりません。
- DROP DBPARTITIONNUM identifier
- このパラメーター・オプションは、パーティション・データベース環境でのみ有効です。 db2nodes.cfg 構成ファイルからドロップするデータベース・パーティションを指定します。注: DROP DBPARTITIONNUM パラメーターを使用する前に、 DROP DBPARTITIONNUM VERIFY コマンドを実行して、このデータベース・パーティション環境にユーザー・データが存在しないことを確認してください。
- FORCE
- 各データベース・パーティションで データベース・マネージャー を停止するときに FORCE APPLICATION ALL を使用することを指定します。
- QUIESCE minutes
- このパラメーター・オプションは、 Db2 pureScale 環境でのみ有効で、 MEMBER パラメーター節でのみ有効です。 これは、特定のメンバーがシャットダウンされる前に、そのメンバー上のアクティブなワークロードを停止するために使用されます ( クラスター・キャッシング・ファシリティーに対して使用することはできません)。 アクティブ・アプリケーションが即座に中断される db2stop FORCE コマンドとは異なり、QUIESCE は、メンバー上のすべてのアプリケーションがそれぞれのアクティブ・トランザクションを完了するまで待機することにより、アクティブ・アプリケーションが正常終了するための余裕を与えます。 オプションの minutes パラメーター値は、特定のメンバーから切断することをアプリケーションに通知する前にコマンドが待機する時間の長さを指定します。 このタイムアウトに達すると、その時点で残っているアクティブな作業単位があれば、すべて中断されます。 タイムアウトが指定されていなければ、コマンドは、メンバーのシャットダウンを進める前に、すべてのアクティブ・アプリケーションがそれぞれの作業単位を終了するまで、無期限に待機します。重要: メンバーをオンラインに戻すには、メンバーに対して db2start コマンドを発行する必要があります。
minutes パラメーター値の有効な値は、-1 から 1440 まで (両端を含む) です。 デフォルト値は -1 で、すべてのアクティブ・ワークロードが終了するまで、指定されたメンバーが無期限に待機することを意味します。 0 の値が指定された場合には、アクティブ・アプリケーションが即座に中断され、それらが終了すると、メンバーがシャットダウンされます。
注: db2stop QUIESCE コマンドは割り込み可能ではありません。 そのコマンドを発行した後には、さらに Db2 コマンドをそのメンバーに対して直接実行することはできません。 静止されたメンバーに関する情報を照会したい場合には、別のアクティブ・メンバーから LIST APPLICATIONS GLOBAL SHOW DETAIL コマンドを発行する必要があります。 静止したメンバー上で実行中のアプリケーションを停止する場合は、別のアクティブ・メンバーから FORCE APPLICATION '(< app handle>)' コマンドを発行する必要があります。
例
04-07-1997 10:32:53 10 0 SQL1064N DB2STOP processing was successful.
04-07-1997 10:32:54 20 0 SQL1064N DB2STOP processing was successful.
04-07-1997 10:32:55 30 0 SQL1064N DB2STOP processing was successful.
SQL1064N DB2STOP processing was successful.
使用上の注意
UNIX オペレーティング・システムでは、複数メンバーの Db2 インスタンスの start_stop_time 構成パラメーターには、特定のメンバーをローカルで停止するために必要な時間のみが含まれます。 これには、 rsh
または ssh
を介してリモート・メンバーに停止要求を送信するために必要な時間は含まれません。
Microsoft Windowsでは、完全な管理者特権で実行している Db2 コマンド・ウィンドウからこのコマンドを実行する必要があります。
このコマンドをクライアント・ノードで発行しない場合もあります。 古いクライアントとの互換性のために提供されていますが、 データベース・マネージャーには影響しません。
開始されると、 データベース・マネージャー ・インスタンスは、それを使用していたすべてのアプリケーション・プログラムが終了しても、ユーザーが停止するまで実行されます。
データベース・マネージャー が停止すると、正常終了メッセージが標準出力装置に送られます。 エラーが発生すると、処理は停止され、エラー・メッセージが標準出力装置に送られます。
アプリケーション・プログラムがまだデータベースに接続されているために データベース・マネージャー を停止できない場合は、最初に FORCE APPLICATION コマンドを使用してすべてのユーザーを切断するか、 FORCE オプションを指定して STOP DATABASE MANAGER コマンドを再発行してください。
- パラメーターを指定しない場合、構成ファイルにリストされている各データベース・パーティションで データベース・マネージャー が停止します。 管理通知ログには、他のデータベース・パーティションが遮断されていることを示すメッセージが含まれています。
- 前の STOP DATABASE MANAGER コマンドが発行されてからパーティション・データベース環境に追加されたデータベース・パーティションは、db2nodes.cfg ファイル内で更新されます。
- UNIX オペレーティング・システムでは、 start_stop_time データベース・マネージャー 構成パラメーターに指定された値に達すると、進行中のすべての停止が中断され、中断された各データベース・パーティションから $HOME/sqllib/log/db2stop.timestamp.log エラー・ログ・ファイルにメッセージ SQL6037N が返されます。 既に停止しているデータベース・パーティションには影響がありません。
- db2cshrc ファイルはサポートされていないため、PROFILE パラメーターの値として指定できません。