UPDATE DATABASE MANAGER CONFIGURATION コマンド (ADMIN_CMD プロシージャーを使用)

UPDATE DATABASE MANAGER CONFIGURATION コマンドは、現在接続されているデータベースを含むインスタンスについて、データベース・マネージャーの構成ファイルの中の個々の項目を修正します。

許可

以下のいずれかです。

SYSADM
ローカル管理者グループのメンバー (Windows オペレーティング・システムの場合)
インスタンス所有者 (UNIX または Linux オペレーティング・システムの場合)

必要な接続

データベース

コマンド構文

コマンド・パラメーター

MEMBER member-number: MEMBER 節では、変更適用の対象にするメンバーを指定します。この節を省略すると、結果としてすべてのメンバーに対して変更が適用されることになります。
USING config-keyword value: 更新するデータベース・マネージャー構成パラメーターを指定します。構成パラメーターのリストは、構成パラメーターのサマリーを参照してください。 value は、パラメーターに割り当てる値を指定します。
AUTOMATIC: いくつかの構成パラメーターは AUTOMATIC に設定できます。それにより、Db2® が自動的にこれらのパラメーターを調整し、現行のリソース要件を反映します。 AUTOMATIC キーワードをサポートする構成パラメーターのリストは、構成パラメーターのサマリーを参照してください。 AUTOMATIC キーワードと一緒に値を指定すると、自動計算に影響する可能性があります。この動作の具体的な詳細については、構成パラメーターの資料を参照してください。
注: federated_async データベース・マネージャー構成パラメーターは、コマンド行プロセッサーを使用することによってのみ AUTOMATIC に設定できます。
MANUAL: 構成パラメーターの自動チューニングを使用不可にします。パラメーターはその現行の内部値に設定され、自動的な更新は行われなくなります。
DEFERRED: 構成ファイルでのみ変更を行います。したがって、加えられた変更は、インスタンスの再始動時に有効になります。これはデフォルトです。
これは、CLPPlus インターフェースで操作する場合のデフォルトの節です。 DEFERRED は、CLPPlus プロセッサーの使用時に呼び出す必要はありません。

例

データベース・マネージャー構成の診断レベルを 1 に更新します。

CALL SYSPROC.ADMIN_CMD('db2 update dbm cfg using DIAGLEVEL 1')

使用上の注意

データベース・マネージャー構成パラメーターのリストを表示または印刷するには、SYSIBMADM.DBMCFG 管理ビューを使用してください。データベース・マネージャー構成パラメーターを推奨されているデータベース・マネージャーのデフォルトにリセットするには、ADMIN_CMD プロシージャーを通じて RESET DATABASE MANAGER CONFIGURATION コマンドを使用してください。データベース・マネージャーの構成パラメーターと、構成されている各種データベース・ノード (サーバー、クライアント、またはリモート・クライアントを持つサーバー) に適したこれらのパラメーターの値については、個々の構成パラメーターの説明を参照してください。

すべてのパラメーターを更新できるわけではありません。

データベース・マネージャー構成ファイルへの変更の一部は、ファイルがメモリーにロードされた後にのみ有効になります。オンラインで構成できるパラメーターと構成できないパラメーターについては、構成パラメーターの一覧をご覧ください。即時にリセットされないサーバー構成パラメーターは、 db2start の実行中にリセットされます。クライアント構成パラメーターの場合、パラメーターは次にアプリケーションを開始するときにリセットされます。クライアントがコマンド行プロセッサーである場合は、TERMINATE を呼び出すことが必要です。

エラーが発生した場合、データベース・マネージャー構成ファイルは変更されません。

チェックサムが無効な場合、データベース・マネージャー構成ファイルは更新できません。このような状況は、データベース・マネージャー構成ファイルが変更されて、適切なコマンドが使用されていない場合に起こります。チェックサムが無効な場合は、データベース・マネージャーを再インストールして、データベース・マネージャー構成ファイルをリセットする必要があります。

現行のインスタンスの SVCENAME、または TPNAME データベース・マネージャー構成パラメーターを更新するとき、LDAP サポートを使用することができて、このインスタンスに LDAP サーバーが登録されている場合は、LDAP サーバーが新しい値に更新されます。

コマンドの実行状況は、CALL ステートメントからの結果である SQLCA で戻されます。

更新は、接続されているデータベースが含まれているデータベース・インスタンスに対してのみ可能です。

動的更新がサポートされているパラメーターの場合、IMMEDIATE キーワードが指定されていなくても、それを動的に更新することが試みられます。使用される許可は現在の SYSTEM_USER ID です。