-ALTER GROUPBUFFERPOOL コマンド ( )Db2

略称 -ALTER GROUPBUFFERPOOL

-ALT GBPOOL

環境 -ALTER GROUPBUFFERPOOL

このコマンドは、 z/OS® コンソール、TSO下のDSNセッション、 DB2I パネル（ DB2 COMMANDS）、 IMS または CICS® 端末、または計装機能インターフェース（IFI）を使用するプログラムから発行することができます。

データ共有範囲 ：グループ

承認 -ALTER GROUPBUFFERPOOL

ログオンしている z/OS コンソールまたは TSO SDSF から発行された Db2 コマンドは、1 次および 2 次許可 ID を使用して Db2 許可によって検査することができます。 z/OS でログインしたユーザーIDは、 または同様のセキュリティサーバーで定義されている必要があります。 RACF

オプションの説明 -ALTER GROUPBUFFERPOOL

(gbpname )

変更する Db2 グループバッファプールを指定します。

• 4-KB グループ・バッファー・プールは、GBP0 から GBP49 までの名前が付けられます。
• 8-KB グループ・バッファー・プールは、GBP8K0 から GBP8K9 までの名前が付けられます。
• 16-KB グループ・バッファー・プールは、GBP16K0 から GBP16K9 までの名前が付けられます。
• 32-KB グループ・バッファー・プールは、GBP32K0 から GBP32K9 までの名前が付けられます。

(structure-name )

グループ・バッファー・プールのカップリング・ファシリティー構造を指定します。 カップリング・ファシリティー構造名は、groupname_gbpname という形式です。

groupname は Db2 のデータ共有グループ名であり、アンダースコア（_） はgroupname と gbpname を区切ります。

GBPCACHE

gbpname をデータのキャッシングと相互無効化の両方に 使用するか、または相互無効化だけに使用するかを指定します。

(YES)

gbpname がデータ・キャッシングと相互無効化に使用されることを示しています。

ページ・セットまたはグループ・バッファー・プールのレベルで指定された、すべての「データ・キャッシングなし」の属性が、 キャッシングの指定より優先します。 以下の表に、データ・キャッシングなしの指定の優先順位を示します。

表 1. データ・キャッシングなしの指定の優先順位

グループ・バッファー・プールの指定	ページ・セットの指定	優先される属性
GBPCACHE(NO)	GBPCACHE CHANGED GBPCACHE ALL	GBPCACHE(NO)
GBPCACHE(YES)	GBPCACHE NONE	GBPCACHE NONE

(NO)

gbpname が相互無効化にのみ使用されることを示しています。 このグループ・バッファー・プールにはデータ項目は含まれません。 このグループ・バッファー・プールを使用する表スペースまたは 索引スペースの GBPCACHE オプションは無視されます。

AUTOREC

構造体の故障が発生した場合、またはグループの全メンバーのグループバッファプールへの接続が失われた場合に、 Db2 による自動復旧が行われるかどうかを指定します。

(YES)

Db2 が、ステータスがグループバッファプールRECOVER保留中（GRECP）であり、論理ページリストにページが存在するページセットとパーティションを自動的に回復できるようにします。

(NO)

自動リカバリー機能を使用不可にします。 状況が GRECP で論理ページ・リストにページ が存在するページ・セットとパーティションをリカバリーするためには、START DATABASE コマンドを発行します。

比率（ratio ）

グループ・バッファー・プール 内のデータ・ページ数に対するディレクトリー項目数の比率 (つまり、各データ・ページにいくつの ディレクトリー項目が存在するか) を変更します。

比率は、 から1024までの小数点以下を含む数値とすることができます。 1.0 なお、小数点第 2 位 以下の桁はすべて無視されます。例えば、5.67 は 5.6 として処理されます。 ratio が 25 を 超えると、小数点以下の桁はすべて無視されます。例えば、25.98 は 25 として処理されます。 グループバッファプールは、デフォルトで10の比率で定義されています。 （APAR PH13045 が Db2 12 に適用される前に定義されたグループバッファプールは、デフォルトの比率5で定義されていました。）

割り振られるディレクトリー項目とデータ・ページの実際の数は 構造のサイズにより異なります。これは、カップリング・ファシリティー・ポリシーの定義 (CFRM ポリシー) で指定されます。

CLASST (class-threshold1,class-threshold2)

クラス・キャストアウト・キュー内のデータをディスクにキャストアウトするしきい値を変更します。

class-threshold1 データエントリーの数に対する割合であり、0～90の範囲の整数（0～90を含む）です。 デフォルトの class-threshold1 グループバッファプールが定義された場合のデフォルト値は5です。

例えば、CLASST(10,0) の場合、対象クラスのページ数がグループ・バッファー・プールのページ容量の 10% に等しくなった時点でクラス・キャストアウトが開始されます。

class-threshold2 はページの絶対数です。 class-threshold2 大規模なグループバッファプールに対して比較的低めのしきい値が必要な場合に使用できますが、 class-threshold1 0と1の値の間の必要な精度が得られない class-threshold1 0と1の間の値の必要な粒度が得られません。 class-threshold2 0～32767 の範囲の整数（両端値を含む）です。 デフォルトの class-threshold2 グループバッファプールが定義された場合のデフォルト値は0です。

例えば、CLASST(0,2500) の場合、対象クラスのページ数が 2500 に達するとクラス・キャストアウトが開始されます。

class-threshold2 の値は、class-threshold1 が 0 の場合にのみ使用されます。 class-threshold1 の値がゼロ以外の場合、class-threshold2 の値は無視されます。 class-threshold1 と class-threshold2 のどちらも 0 の場合、class-threshold1 値 0 が使用されます。

GBPOOLT (integer )

グループ・バッファー・プールのデータをディスクにキャストアウトするしきい値を変更します。

整数はデータエントリーの数に対するパーセンテージで表され、0～90の範囲で変動します。 グループバッファプールのデフォルト値は30です。

例えば、GBPOOLT(55) であればのページ数がグループ・バッファー・プールのページ容量の 55 % に等しくなると、 データをキャストアウトします。

GBPCHKPT (整数 )

あるチェックポイントから後続のグループ・バッファー・プールのチェックポイントまでの時間間隔 (分単位) を変更 します。 integer の範囲は 1 から 999999 です。 グループバッファプールが定義された場合のデフォルト値は4分です。

チェックポイントの回数を増やすと、カップリング・ファシリティーに障害が生じた場合のグループ・バッファー・プールのリカバリーにかかる時間はそれだけ少なくなります。

使用上の注意事項 -ALTER GROUPBUFFERPOOL

変更されていないグループバッファプールのデフォルト値

ALTER GROUPBUFFERPOOLコマンドを発行した際、明示的に指定しなかったオプションは変更されません。 つまり、デフォルトでは値は変更されません。

変更されていないグループバッファプールは、ALTER GROUPBUFFERPOOLコマンドで変更できる属性について、以下の表に示す値を持っています。

オプション	値
GBPCACHE	はい
RATIO	10
CLASST	5、0
GBPOOLT	30（%）
GBPCHKPT	4（分）

新しい値が有効になるタイミング

ALTER GROUPBUFFERPOOLコマンドを発行すると、一部のオプション指定は、グループバッファプールの次の割り当て時にのみ有効になります。 以下の表に、新しい値が有効になる時点、および GBPCACHE(NO) と指定されたグループ・バッファー・プールにオプションを適用できるかどうかを示します。

キーワード	新しい値が有効になる時	GBPCACHE(NO) の場合、適用されるか
GBPCACHE	次の割り振り時	該当なし
AUTOREC	即時に	いいえ
RATIO	次の割り当てで 2	3番なし
CLASST	即時に	3番なし
GBPOOLT	即時に	3番なし
GBPCHKPT	即時に	3番なし

注:

1. グループバッファプールが二重化されていない場合は、 z/OS コマンドSETXCF START,REBUILDを使用して変更を有効にすることができます。 グループ・バッファー・プールが 二重になっており、GBPCACHE(NO) に変更したい場合は、まずシンプレックス・モード に戻って、作成し直します。 GBPCACHE(NO) は、二重化されたグループ・バッファー・プールには指定できません。
2. グループバッファプールが二重化されていない場合は、 z/OS コマンドSETXCF START,REBUILDを使用して変更を有効にすることができます。 グループ・バッファー・プールが二重になっている場合は、 まずシンプレックス・モードに戻って、作成し直し、その後 オプションとして二重モードに戻します。 グループ・バッファー・プールが二重化されている場合、 その二重化されているグループ・バッファー・プールの両方のインスタンスは、同じ RATIO 値を使用します。
3. Db2 このオプションを GBPCACHE(NO) グループバッファプールに対して指定すると、 というメッセージが発行されます。 DSNB761 これらの設定は、GBPCACHE 属性が YES に変更された後でのみ有効になります。

データ共有メンバーのトレース情報

グループスコープを持つこのコマンドが Db2 のデータ共有メンバーで発行されると、他のすべてのアクティブなメンバーでも実行されます。 他のグループメンバーのIFICID 090トレースレコードでは、元のコマンドが発行されたメンバーからのトレースレコードに加えて、 016.TLPKN5F の相関IDからSYSOPR権限IDによって同じコマンドが発行されたことが示されます。 Db2 のデータ共有におけるコマンドの適用範囲を参照してください。