-ACCESS DATABASE コマンド ( )Db2

-ACCESS DATABASE コマンドは、テーブルスペース、インデックススペース、またはパーティションの物理的なオープンを強制的に行ったり、テーブルスペース、インデックススペース、またはパーティションのGBP依存ステータスを削除したり、インメモリブロックから適切なカタログテーブルにリアルタイム統計およびオプティマイザ統計の推奨値を外部化したりします。 MODEキーワードは、希望するアクションを指定します。

省略形: -ACC

環境 -ACCESS DATABASE

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

データ共有の範囲: グループまたはメンバー

承認 -ACCESS DATABASE

このコマンドを実行するには、次の権限のいずれかを含む処理の特権セットを使用する必 要があります。
  • STARTDB 特権
  • DBMAINT 権限
  • DBCTRL 権限
  • DBADM 権限
  • SYSCTRL 権限
  • SYSADM 権限
  • システム DBADM 権限
指定したデータベースに対するSTARTDB権限を含まない権限セットを使用している場合、 Db2 はエラーメッセージを表示し、ACCESSコマンドは失敗します。

STARTDB 特権がこの処理の特権セットに含まれているすべての指定データベースが開始されます。

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

データ定義制御がアクティブであれば、データベース、 表スペース、あるいは登録表や索引を含む索引スペース を開始するのに、インストール SYSOPR またはインストール SYSADM 権限 が必要です。

構文 -ACCESS DATABASE

構文図を読むビジュアルシンタックスダイアグラムをスキップするACCESSDATABASE(,database-name*dbname1: dbname2dbname**dbname*dbname**dbstring1*dbstring2*)SPACENAM( ,スペース名*spacename1: spacename2spacename**spacename*spacename**spacestring1*spacestring2* )PART(,整数integer1: integer2)MODE( OPENNGBPDEPSTATS )

オプションの説明 -ACCESS DATABASE

DATABASE (データベース名,…)
アクセスするデータベースの名前、またはアクセスする表スペースあるいは索引スペースを含むデータベースの名前を 指定します。

省略形: DB

database-name
アクセスする 1 つ以上のデータベースの名前。 以下のバリエーションが受け入れられます。
(データベース名,...)
1 つ以上のデータベース名をコンマまたはブランクで区切って指定します。
(*)
プロセスの特権セットに必要な許可がある Db2 サブシステムに定義されている、すべてのデータベース。
( dbname 1: dbname2 )
名前が UNICODE で、dbname1dbname2 の間 (両方を含む) にあるすべてのデータベース。
(dbname*)
dbnameという文字列で始まる名前で、1~7文字のデータベース。
(*dbname)
dbnameという文字列で終わる名前で、1~7文字のデータベース。
(*dbname*)
dbnameという文字列を含むすべてのデータベース。dbnameは 1~6文字で構成される。
(* dbstring1 * dbstring2 *)
名前に文字列を含むすべてのデータベース dbstring1dbstring2 合わせて2文字から5文字の文字列を含むすべてのデータベース。
SPACENAM (space-name, …)
指定されたデータベース内のアクセスする表スペースまたは索引の名前を示します。
省略形: SPACE、SP
スペース名
アクセスする 1 つ以上の表スペースまたは索引スペースの名前。 以下のバリエーションが受け入れられます。
(spacename, ...)
コンマまたはブランクで区切られた 1 つ以上の索引スペース名。
(*)
プロセスの特権セットに必要な許可がある Db2 サブシステムに定義されている、すべての表スペースまたは索引スペース。
(スペース名1 :スペース名2 )
名前が UNICODE で、spacename1spacename2 の間 (両方を含む) にあるすべての表スペースまたは索引スペース
(spacename*)
1~7文字の文字列 spacename で始まる名前を持つすべてのテーブル空間またはインデックス空間。
(*spacename)
1~7文字の文字列 spacename で終わる名前を持つすべてのテーブル空間またはインデックス空間。
(*spacename*)
名前に1~6文字の文字列spacename を含むすべてのテーブル空間またはインデックス空間。
(* スペース文字列1 * スペース文字列2 *)
名前に文字列を含むすべてのテーブル空間またはインデックス空間 spacestring1spacestring2 合計2~5文字を含むもの。
PART(integer,)
指定された表スペースまたは索引内の、アクセスする 1 つ以上のパーティションのパーティション番号を指定します。

指定する integer 値は、対応するスペース名およびデータベース名 の有効なパーティション番号を識別するものでなければなりません。 指定したパーティション番号が無効な場合、無効な番号ごとにエラー・メッセージが出されますが、指定したパーティションのうち有効なものはすべてアクセスされます。

以下のいずれかのように指定して、integer をコーディングできます。
  • 1 つ以上のパーティションのリスト。
  • 照合順序が integer-1 以上で integer-2 以下のすべてのパーティション番号の範囲。
  • リストと範囲の組み合わせ。

PART は、パーティション化表スペース、パーティション化索引、およびパーティション化表スペースの非パーティション化タイプ 2 索引について有効です。 以下のオブジェクト・タイプでPARTを指定すると、 Db2 、エラー・メッセージが表示され、そのオブジェクトにはアクセスできません。

  • パーティションで区切られていないテーブルスペース
  • パーティショニングされていないタイプ1インデックス
  • パーティショニングされたテーブル・スペースに定義されていないタイプ2インデックス
  • 変更の開始ワークファイル・データベースにおけるパーティション・バイ・グロース(PBG)テーブル・スペース変更の終わり

論理パーティションがアクセスされていると、 その索引はクローズされません。 索引をクローズするには、PART を使用せずに非パーティション索引にアクセスする必要があります。

モード (モード値
コマンドの処置を指定します。ここで、mode-value は以下のいずれかの値です。
OPEN
そのローカル・メンバー のページ・セットまたはパーティションの物理的なオープンを強制します。 これは、物理的なオープンによるオーバーヘッドを SQL スレッドからコマンド・スレッドに移動します。 これにより、指定されたページ・セットまたはパーティションの参照に対する最初の SQL スレッドの トランザクション・レートが向上します。

MODE(OPEN)が指定された場合、 Db2 は以下の特徴を持つオブジェクトを処理しません

  • DEFINE NO を指定して定義されているオブジェクト。
  • 物理データ・セットが作成されていないオブジェクト。
NGBPDEP
変更の開始指定されたページ・セットまたはパーティションからグループ・バッファー・プールの従属関係を除去します。 これは、データ共用環境で特定のページ・セットまたはパーティションに対して大規模なバッチ処理を実行する前に、パフォーマンスを向上させるために使用します。 このコマンドは、バッチ・プロセスを実行するメンバーと同じメンバー上でのみ発行してください。 このキーワードを指定すると、ページ・セットまたはパーティションはドレーンされます。変更の終わり
STATS
メモリー内のリアルタイム統計と最適化プログラム統計の推奨事項を適切なカタログ表に外部化します。 データ共用環境では、メモリー内の統計はすべてのメンバーに関して外部化されます。 このモードでは、ページ・セットが物理的にオープンされることも、ページ・セットの状態が変更されることもありません。

MODE (STATS) オプションを指定する場合、database-name 値と space-name 値の特定の組み合わせのみが推奨されています。

使用上の注意事項 -ACCESS DATABASE

以下に、ACCESS DATABASE コマンドの使用方法について詳しく説明します。

ACCESS DATABASE がエラー・メッセージ DSNI045I を返した場合の処置
データ共用グループの複数のメンバーに対して同時に ACCESS DATABASE MODE(OPEN) を発行すると、リソース競合が原因で、エラー・メッセージ DSNI045I と理由コード 00C90090 が出される場合があります。 このエラーが発生した場合は、ACCESS DATABASE MODE(OPEN) コマンドを再発行して、コマンドが影響するすべてのオブジェクトをオープンします。 エラーを回避するには、同時に複数のデータ共用グループ・メンバーに対して ACCESS DATABASE MODE(OPEN) を発行しないでください。
グループスコープで発行されたコマンドのトレース情報
Db2 のデータ共有メンバーでグループスコープを指定するオプションとともにこのコマンドが発行された場合、他のすべてのアクティブなメンバーでも実行されます。 他のグループメンバーのIFICID 090トレースレコードでは、元のコマンドが発行されたメンバーからのトレースレコードに加えて、 016.TLPKN5F の相関IDからSYSOPR権限IDによって同じコマンドが発行されたことが示されています。 Db2 のデータ共有におけるコマンドの適用範囲を参照してください。

-ACCESS DATABASE

例: パーティションを物理的にオープンする
次のコマンドは、データベース DSN9001 の表スペース DSN9002 のパーティション 1 と 3 を物理的にオープンします。
-ACCESS DATABASE(DSN9001) SPACENAM(DSN9002) PART(1,3) MODE(OPEN)
例: 非パーティション表スペースを物理的にクローズする
次のコマンドは、データベース DSN9001 の非パーティション表スペース DSN9003 全体を物理的にクローズし、非グループ・バッファー・プール従属にします。
-ACCESS DATABASE(DSN9001) SPACENAM(DSN9003) MODE(NGBPDEP)

次のような出力により、コマンドが正常に終了したことが示されます。

  -DSNTDDIS 'ACCESS DATABASE' NORMAL COMPLETION 
例: すべてのメモリー内統計をリアルタイム統計表に外部化する
以下のコマンドは、現在システムに保持されているすべてのメモリ内統計およびオプティマイザ推奨統計をリアルタイム統計テーブルに外部化します。
-ACCESS DB(*) SP(*) MODE(STATS)