MON_FORMAT_LOCK_NAME 表関数 - 内部ロック名をフォーマットし、詳細を返す

MON_FORMAT_LOCK_NAME 表関数は、内部ロック名をフォーマットし、ロックに関する詳細を行ベースのフォーマットで戻します。

戻される各行は、その特定のロックに関する key-value の組で構成されます。

ロックに関する情報を取得するには、SNAPLOCKWAIT 管理ビューと SNAP_GET_LOCKWAIT 表関数、SNAPLOCK 管理ビューと SNAP_GET_LOCK 表関数の代わりに、MON_FORMAT_LOCK_NAME、MON_GET_LOCKS、および MON_GET_APPL_LOCKWAIT 表関数を使用します。これらは、バージョン 9.7 では推奨されません。

許可

このルーチンを実行するには、以下のいずれかの権限が必要です。

ルーチンに対する EXECUTE 特権
DATAACCESS 権限
DBADM 権限
SQLADM 権限

デフォルトの PUBLIC 特権

なし

構文

スキーマは SYSPROC です。

表関数のパラメーター

lockname: フォーマット設定されるロックの内部バイナリー名を指定する、タイプ VARCHAR (32) の入力引数。 NULL 値を指定した場合、結果としてエラー SQL0171N が戻されます。

戻される情報

表 1. MON_FORMAT_LOCK_NAME 表関数によって戻される情報
列名	データ・タイプ	説明
名前	可変長文字 (VARCHAR) 型 (256)	ロック名のエレメント。詳しくは、下記の表を参照してください。
価値	VARCHAR(1024)	エレメントの値。

指定されたロック名を構成するすべてのエレメントが戻されるわけではありません。関連のある key-value の組だけが戻されます。

戻される可能性のあるエレメントは次のとおりです。

表 2. 戻される可能性のあるモニター・エレメント
エレメント名	説明	可能な値またはモニター・エレメント
LOCK_OBJECT_TYPE	lock_object_type - 待機中のロック対象タイプ : モニター・エレメント	lock_object_type ロック対象タイプ可能な値については、lock_object_type - モニター・エレメントで待機中のロック対象タイプを参照してください。
DATA_PARTITION_ID	data_partition_id - データ・パーティション ID : モニター・エレメント	data_partition_id - データ・パーティション ID
TBSP_NAME	表スペースの名前	tablespace_name 表スペース名
TABSCHEMA	table_schema - 表スキーマ名 : モニター・エレメント	table_schema 表スキーマ名
TABNAME	table_name - 表名 : モニター・エレメント	table_name 表名
ROWID	表の行 ID	-
PAGEID	ページ ID	-
WORKLOAD_NAME	workload_name ワークロード名 : モニター・エレメント	workload_name ワークロード名
STORAGE_GRP_ID	ストレージ・グループ ID	-
BUFFERPOOL_NAME	バッファー・プールの名前	-
FED_SERVER_NAME	フェデレーション・サーバーの名前	-
FED_USER_NAME	フェデレーション・ユーザー・マッピングの名前	-
SEQ_OPERATION	シーケンス・ロックを要求している操作	可能な値は以下のとおりです。 AUDIT_DDL AUTONOMIC_POLICIES CATALOG_ARRAY CATALOG_COL_DICT_STATE DESCRIBE 初期監査 INIT_EVMON INIT_PACKAGE INIT_ROLE_ID INIT_ROUTINE_ID INIT_TRUSTED_CTX PACKAGE_CREATION STATIC_STMT TEMP_TBSPACE TRUSTED_CTX USER_TEMP_TBSPACE VERSION_TIMES WLM
CONTAINER_ID	container_id - コンテナー ID : モニター・エレメント	-
STMT_UID	ステートメント ID	-
PACKAGE_TOKEN	パッケージ・トークン	-
INTERNAL	内部使用のために予約済み	-

例

内部ロック名は、db2diag ログ・ファイルへの書き込み、lock_name モニター・エレメントの値などのさまざまな状況で戻されます。以下の例は、MON_FORMAT_LOCK_NAME 表関数を使ってロックについての詳細情報を検出する方法を示しています。この場合はロック名 0000000E00000000000B00C152 を使用します。

SELECT SUBSTR(NAME,1,20) AS NAME,
       SUBSTR(VALUE,1,50) AS VALUE
       FROM
       TABLE( MON_FORMAT_LOCK_NAME('0000000E00000000000B00C152')) as LOCK

以下の出力が戻されます。

NAME                 VALUE
-------------------- -------------
LOCK_OBJECT_TYPE     ROW
ROWID                0
DATA_PARTITION_ID    49408
PAGEID               184549376
TBSP_NAME            SYSCATSPACE

  5 record(s) selected.